public.dhe.ibm.compublic.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… ·...
TRANSCRIPT
IBM Cognos Business Intelligence PowerPlay
Versão 10.1.0
Guia de instalação e configuração
Informações do ProdutoEste documento aplica-se a IBM Cognos Business Intelligence Versão 10.1.0 e pode aplicar-se também a releases subsequentes. Para verificarversões mais novas deste documento, visite os Centros de Informações IBM Cognos(http://publib.boulder.ibm.com/infocenter/cogic/v1r0m0/index.jsp).
CopyrightMateriais licenciados - Propriedade da IBM© Copyright IBM Corp. 2005, 2010.
Direitos restritos dos usuários do governo dos EUA – Uso, duplicação ou divulgação restritos pelo GSA ADP Schedule Contract com a IBM Corp.IBM, o logotipo da IBM, ibm.com PowerPlay, Impromptu, ReportNet, e Cognos são marcas ou marcas registradas da International BusinessMachines Corp., em muitas jurisdições no mundo todo. Outros nomes de produtos e serviços podem ser marcas registradas da IBM ou outrasempresas. Uma lista atualizada das marcas registradas IBM está disponível na Web em www.ibm.com/legal/copytrade.shtml.Adobe, o logotipo Adobe, PostScript e o logotipo PostScript são marcas ou marcas registradas da Adobe Systems Incorporated nos EUA e/ouem outros países.Microsoft, Windows, Windows NT e o logotipo Windows são marcas registradas da Microsoft Corporation nos Estados Unidos e/ou em outrospaíses.
Linux é marca registrada de Linus Torvalds nos Estados Unidos e/ou em outros países.
UNIX é marca registrada do The Open Group nos Estados Unidos e/ou em outros países.Java e todas as marcas registradas e logotipos baseados em Java são marcas registradas da Sun Microsystems, Inc. nos Estados Unidos e/ouem outros países.
Sumário
Introdução 13
Componente 1: IBM Cognos 8 PowerPlay
Capítulo 1: O que há de novo? 15Novos recursos na versão 10.1.0 15
Acesso ao guia de instalação e de configuração do Software Development Kit 15Recursos alterados na versão 10.1.0 15
Local de instalação padrão e alias web 15PowerPlay Batch Administration 16União do IBM Cognos Go! Dashboard com recursos do IBM Cognos Viewer em uma única
interface do usuário 16Suporte aprimorado para autenticação usando o provedor RACF 16Acesso seguro ao monitorar as métricas do sistema externamente 16
Recursos removidos na versão 10.1.0 16Gerenciamento de memória para o serviço do IBM Cognos 17
Novos recursos na versão 8.4 17Suporte de idiomas adicional 17Suporte para o driver universal do DB2 para bancos de dados de armazenamento de
conteúdo, notificação e log 17DB2 em z/OS como armazenamento de conteúdo, banco de dados de log ou de
notificação 18Suporte para endereços IP IPv6 18Suporte para aplicativos de servidor de 64 bits 18Ocultação do namespace dos usuários durante o login 19
Recursos alterados na versão 8.4 19Instalação do Supplementary Languages Documentation necessário para a documentação
do produto traduzida 19Conexão padrão a um armazenamento de conteúdo IBM DB2 substitui o Microsoft SQL
Server 19O IBM Java Runtime Environment (JRE) substitui o Sun Java Runtime Environment 19
Recursos substituídos na versão 8,4 20Suporte para driver DB2 JDBC tipo 2 para bancos de dados de armazenamento de conteúdo,
notificação e log em Linux, UNIX e Windows (db2java.zip) 20Recursos removidos na versão 8.4 20
Interface de usuário baseada em texto para instalação no UNIX e no Linux 20Suporte ao idioma para texto e mensagens da interface de usuário do IBM Cognos 8
Supplementary Languages para a instalação do IBM Cognos 8 Server 20
Capítulo 2: Componentes usados pelo IBM PowerPlay 21Componentes do servidor 21
Comunicação web - gateway 21Application Tier Components 21Gerenciamento de dados de aplicativos - Content Manager 22Componentes opcionais do servidor 22
Licensed Materials – Property of IBM3© Copyright IBM Corp. 2005, 2010.
Componentes de migração 23Componentes do cliente 24Outros componentes 24
Componente 2: Planejamento da instalação
Capítulo 3: Opções de distribuição para o IBM Cognos PowerPlay 27
Distribuição de componentes do IBM Cognos PowerPlay Server 27Todos os componentes em um computador 28Gateways em computadores separados 29Application Tier Components e Content Managers em computadores separados 29Instalação do IBM Cognos PowerPlay com outros componentes do IBM Cognos BI em um
sistema de 64 bits 31Acesso da documentação do produto em um ambiente integrado 32
IBM Cognos PowerPlay com outros produtos IBM Cognos 33Produtos IBM Cognos Series 7 que podem ser migrados para o IBM Cognos PowerPlay 33Produtos IBM Cognos que operam conjuntamente com o IBM Cognos PowerPlay 34Conteúdo do IBM Cognos Series 7 que pode ser recriado no IBM Cognos BI 37
Capítulo 4: Preparação para a instalação 39
Revisão das notas de versão antes da instalação 39Revisão de ambientes suportados 40Verificação das exigências do sistema 40Análise das configurações padrão de porta para o IBM Cognos Business Intelligence 42Diretrizes para criar o armazenamento de conteúdo 44
Configurações sugeridas para criar o armazenamento de conteúdo no DB2 no Linux,Windows e UNIX 45
Configurações sugeridas para criar um armazenamento de conteúdo no DB2 em z/OS 48Configurações sugeridas para criar o armazenamento de conteúdo no Oracle 48Configurações sugeridas para criar o armazenamento de conteúdo no Microsoft SQL
Server 49Configurações sugeridas para criar o armazenamento de conteúdo no IBM Informix Dynamic
Server Database 50Configurações sugeridas para criar o armazenamento de conteúdo no Sybase 51
Configuração de contas de usuário ou contas de serviço de rede no IBM Cognos BusinessIntelligence 52
Configuração de navegadores web 53
Componente 3: Instalação e configuração
Capítulo 5: Atualização para o IBM Cognos PowerPlay 57
Planejamento da atualização 58Revisão da documentação 60Recomendação - Avaliação dos aplicativos no ambiente de origem 61Recomendação - Realização de uma atualização experimental 62Criação do ambiente de teste 63Planejamento da implantação 63Criação de especificações de implantação de exportação 65Cópia da especificação da implantação no ambiente de teste 67
4 IBM Cognos Business Intelligence PowerPlay
Sumário
Inclusão de objetos de configuração na importação de todo o armazenamento de conteúdo68
Importação para o ambiente de teste 68Teste do conteúdo implantado 70Recomendação - Testar o conteúdo atualizado 70Mover para o ambiente de produção 71
Atualização de uma versão anterior do IBM Cognos PowerPlay 72Atualização do IBM Cognos PowerPlay 74Atualização do armazenamento de conteúdo DB2 em um sistema operacional System z 79Instalação ou atualização de outros produtos 80Execução de várias versões ou instâncias do IBM Cognos BI ao mesmo tempo 81
Capítulo 6: Instalação e configuração do IBM Cognos PowerPlay em um computador 85
Instalação do IBM Cognos PowerPlay 86Instalação de pacotes de correções 90Criação de bancos de dados para o armazenamento de conteúdo DB2 em Linux com um
script 93Criação de tablespaces para um armazenamento de conteúdo DB2 em z/OS 94Opções de driver JDBC para usar o banco de dados DB2 como armazenamento de conteúdo 96Configuração da conectividade de banco de dados para o banco de dados de armazenamento
de conteúdo 97Atualização do ambiente Java 99Configuração do IBM Cognos PowerPlay 100
Configurar propriedades de ambiente no IBM Cognos Configuration 101Ativação da segurança 101Definição de propriedades de conexão do banco de dados para o armazenamento de
conteúdo 102Especificar uma conexão para uma conta do servidor de e-mail 106Configuração de namespaces do IBM Cognos Series 7 no IBM Cognos BI 107
Configuração do servidor web 109Inicie os serviços do IBM Cognos 111Teste da instalação e da configuração 112Instalação e configuração de migração nos computadores com IBM Cognos Series 7 113
Instalação do IBM Cognos Series 7 Migration Components 113Configuração do serviço de migração do IBM Cognos Series 7 para migrações do Upfront
em instalações distribuídas do IBM Cognos Series 7 114Início do IBM Cognos Series 7 Migration Service 115
Desinstalação do IBM Cognos BI 116Desinstalação do IBM Cognos Business Intelligence no UNIX ou Linux 116Desinstalação do IBM Cognos Business Intelligence no Windows 117Desinstalação do Banco de dados de conteúdo do Cognos 118Desinstalação dos componentes de migração 119
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em
computadores diferentes 121Seqüência de instalação para componentes do servidor 123Recomendação - instale e configure a instalação básica para instalações distribuídas 123Instalação e configuração do Content Manager 124
Componentes ativo e em espera do Content Manager 125
Guia de instalação e configuração 5
Sumário
Instalação dos componentes do Content Manager 126Instalação do Banco de dados de conteúdo do Cognos em um servidor diferente 130Instalação de pacotes de correções 131Criação de bancos de dados para o armazenamento de conteúdo DB2 em Linux com um
script 133Criação de tablespaces para um armazenamento de conteúdo DB2 em z/OS 134Atualização do ambiente Java 136Configuração da conectividade de banco de dados para o banco de dados de armazenamento
de conteúdo 137Início do IBM Cognos Configuration 139Definição de propriedades de conexão do banco de dados para o armazenamento de
conteúdo 140Configuração de propriedades do ambiente para computadores com Content Manager 145Especificação de uma conexão para uma conta do servidor de e-mail 147Ativação da segurança 148Configuração de namespaces do IBM Cognos Series 7 no IBM Cognos BI 148Início do Content Manager 150Teste da instalação do Content Manager 151
Instalação e configuração dos componentes da camada de aplicativos 151Instalação dos componentes da camada de aplicativos 152Instalação de pacotes de correções 156Início do IBM Cognos Configuration 158Configuração de propriedades do ambiente para computadores com componentes da
camada de aplicativos 159Instalação do componentes da camada de aplicativos 161Teste do Application Tier Components 161Teste do serviço do IBM Cognos Migration 162
Instalação e configuração do componente do gateway 162Instalação de componentes do gateway 163Instalação de pacotes de correções 166Início do IBM Cognos Configuration 169Configuração de propriedades de ambiente e de segurança para computadores de
gateway 170Configuração do servidor web 171Teste do gateway 174
Instalação e configuração de migração nos computadores com IBM Cognos Series 7 174Instalação do IBM Cognos Series 7 Migration Components 174Configuração do serviço de migração do IBM Cognos Series 7 para migrações do Upfront
em instalações distribuídas do IBM Cognos Series 7 176Início do IBM Cognos Series 7 Migration Service 177
Desinstalação do IBM Cognos BI 177Desinstalação do IBM Cognos BI no UNIX ou Linux 178Desinstalação do IBM Cognos BI no Windows 178Desinstalação do Banco de dados de conteúdo do Cognos 179
Capítulo 8: Instalação e configuração de componentes opcionais 181
Amostras do PowerPlay 181Instalação de amostras do IBM Cognos BI 182Configuração das amostras do IBM Cognos PowerPlay 183
6 IBM Cognos Business Intelligence PowerPlay
Sumário
Instalação da documentação do produto traduzida 188Instalação e configuração de fontes de idiomas adicionais 189
Configuração de suporte para caracteres do iene japonês e do won coreano 190
Componente 4: Personalização do IBM Cognos PowerPlay em seu ambiente
Capítulo 9: Configuração de componentes do IBMCognos para utilizar provedores de autenticação 193
Desativação do acesso anônimo 194Restrição de acesso do usuário ao namespace Cognos 195Configuração de componentes do IBM Cognos para uso do Active Directory Server 195
Configurar namespaces do Active Directory 196Disponibilização das propriedades personalizadas de usuário do Active Directory para os
componentes do IBM Cognos 197Ativação da comunicação segura para o Servidor do Active Directory 198Inclusão ou exclusão de domínios utilizando Propriedades avançadas 199Ativação do signon único entre o Active Directory Server e os componentes do IBM
Cognos 200Configuração do IBM Cognos para utilizar o namespace do IBM Cognos Series 7 201
Configuração de namespaces do IBM Cognos Series 7 202Ativação da comunicação segura para o servidor de diretório utilizado pelo namespace do
IBM Cognos Series 7 203Ativação do signon único entre o IBM Cognos Series 7 e o IBM Cognos 203Namespaces do IBM Cognos Series 7 e plug-in de signon confiável do IBM Cognos
Series 7 203Configuração do IBM Cognos para utilizar provedores de autenticação personalizada 206
Configuração de namespaces de autenticação personalizada 206Ocultação do namespace dos usuários durante o login 207
Configuração de componentes do IBM Cognos para utilizar LDAP 207Mapeamento LDAP 208Configuração de namespaces LDAP 208Configuração de namespaces LDAP para o servidor do Active Directory 210Configuração de namespaces LDAP para IBM Directory Server 213Configuração de namespaces LDAP para Novell Directory Server 215Configuração de namespaces LDAP para Sun Java System Directory Server 217Disponibilização das propriedades personalizadas de usuário para LDAP disponíveis para
os componentes do IBM Cognos 219Ativação da comunicação segura com o servidor LDAP 220Ativação do signon único entre o LDAP e os componentes do IBM Cognos 222Operação de substituição 222
Configuração de componentes do IBM Cognos para utilizar eTrust SiteMinder 223Configuração de namespaces do Netegrity SiteMinder 224Ativação da comunicação segura para o diretório de usuário do eTrust SiteMinder 226Ativação do signon único entre o eTrust SiteMinder e o IBM Cognos 226Proteção do alias de web do IBM Cognos 226Ocultação do namespace dos usuários durante o login 226
Configuração de componentes do IBM Cognos para utilizar um namespace NTLM 227Configuração de namespaces NTLM 227Ativação do signon único entre o NTLM e os componentes do IBM Cognos 228
Configuração do IBM Cognos para utilizar provedores de autenticação 228Configuração de namespace RACF 229
Guia de instalação e configuração 7
Sumário
Ativação do signon único entre o RACF e o IBM Cognos 230Exclusão de provedores de autenticação 231
Capítulo 10: Opções de configuração 233
Iniciar o IBM Cognos Configuration 234Alteração de definições de configuração padrão 234
Alteração do usuário e senha padrão do Banco de dados de conteúdo do Cognos 235Alteração de uma configuração de porta ou de URI 237Configuração de definições criptográficas 239Configuração dos componentes do IBM Cognos para uso no IBM Cognos Application
Firewall 244Criptografia de propriedades de arquivo temporário 246Configuração do gateway para usar um namespace 247Ativação e desativação de serviços 247Configuração de fontes 248Considerações sobre o suporte ao chinês simplificado 250Atualização das entradas de registro para os vínculos da fonte do Windows 251Alteração da fonte padrão para relatórios em PDF 251Configuração de fontes incorporadas a relatórios em PDF 252Saída de relatório salvo 253Alterando o Local da Saída de Relatórios Temporários 255
Alteração do banco de dados de notificação 255Configurações sugeridas para criar um banco de dados de notificação para DB2 em z/OS 256Criação de tablespaces para o banco de dados de notificação DB2 em z/OS 256Alteração das propriedades de conexão para o banco de dados de notificação 257
Criação de um novo armazenamento de conteúdo utilizando o banco de dados de conteúdodo Cognos 258
Configuração do protocolo SSL 259Configure o SSL para os componentes do IBM Cognos 260Configuração de confiança compartilhada entre os servidores do IBM Cognos e outros
servidores 262Seleção e classificação de conjuntos de codificação para SSL 263Ativação do SSL no servidor web 264
Configurando um Repositório para Mensagens de Log 265Diretrizes para a criação de um banco de dados de log 267Criação de tablespaces para o banco de dados de log DB2 em z/OS 267Configuração da conectividade do banco de dados para o banco de dados de log 268Repositórios de mensagens de log 271Especificação do repositório de mensagens de log 272Ativação de conexão específica do usuário 277
Alteração de definições globais 279Personalização do suporte de idioma na interface de usuário 280Personalização do suporte de moeda 280Personalização do suporte da localidade do conteúdo 281Mapeamento de localidades do conteúdo 282Mapeamento de localidades do produto 284Personalização do fuso horário do servidor 285Alteração da codificação de mensagens de e-mail 285Personalização de configurações de cookies 287
8 IBM Cognos Business Intelligence PowerPlay
Sumário
Alteração do gateway 288Configuração do gateway no módulo do servidor web Apache no IBM Cognos 288Configuração do gateway de servlet 294
Alteração da versão do endereço IP 295Configuração do roteador para testar a disponibilidade do distribuidor 297Atualização de propriedades de locais do arquivo no Windows Vista 297Alteração das definições de configuração para o serviço de migração do IBM Cognos Series 7 298Atribuição de uma conta de usuário ao PowerPlay e aos serviços de migração para a
migração 299
Capítulo 11: Configuração do Portal Services 301
Especificação da localização do arquivo applications.xml 301Configuração da segurança para o Portal Services 302
Desativação do acesso anônimo aos componentes do IBM Cognos 303Ativação de signon único com Shared secret 303Ativação do signon único para o portal WebSphere usando o servidor de aplicativos 307Ativação de signon único para o portal Oracle WebCenter Interaction Portal usando
autenticação básica 308Ativação de signon único para o portal Oracle WebCenter Interaction Portal usando o
SiteMinder 308
Capítulo 12: Configuração do IBM Cognos BI para servidores de aplicativos diferentes do Tomcat 311
Criação de instâncias JVM separadas 312Criação de perfis adicionais para distribuir componentes do IBM Cognos BI para o Linux no
System z 313Verificação das configurações de componentes do IBM Cognos 314Backup de informações do IBM Cognos existentes 314Definição de variáveis de ambiente 316Ajuste do tempo limite de conexão padrão para o IBM Cognos BI 317Configuração dos componentes do IBM Cognos para serem executados no servidor de
aplicativos 318Identificação do JDK para WebLogic 9 no AIX 320Alteração do script de inicialização do servidor de aplicativos 320Configuração de propriedades do servidor de aplicativos e implantação do IBM Cognos 8 322Ativação do SSL 328Configuração da comunicação web 329
Configuração do servidor web 329Configuração de um diretório virtual para SAP NetWeaver no Windows 331
Remoção do registro de distribuidores 332Importação de dados do armazenamento de conteúdo 332Atualização do IBM Cognos BI em um ambiente do servidor de aplicativos 333
Capítulo 13: Opções avançadas de configuração 335
Alteração de versão do Java Runtime Environment utilizado pelos componentes do IBM CognosBI 335Backup de informações do IBM Cognos existentes 336Atualização do ambiente Java 337Importação de dados do armazenamento de conteúdo 338
Configuração dos componentes do IBM Cognos BI para utilizar outra autoridade decertificação 339
Guia de instalação e configuração 9
Sumário
Geração de chaves e solicitações de assinatura de certificado 339Configuração de componentes do IBM Cognos BI para execução em outra autoridade de
certificação 343
Capítulo 14: Configuração de instalações e configurações autônomas 345
Configuração de instalações autônomas 345Definição de configurações autônomas 348Configuração de desinstalações autônomas 350
Componente 5: Manutenção
Capítulo 15: Manutenção do desempenho 353
Métricas de desempenho do sistema 353Monitoramento das métricas do sistema externamente 353
Ativação apenas de serviços obrigatórios 354Ajuste do Armazenamento de conteúdo do DB2 359Ajuste dos recursos da memória para o IBM Cognos Service 359Ajuste das configurações do Apache Tomcat 360Aumento da capacidade de tratamento de solicitações para o Banco de dados de conteúdo do
Cognos 360Melhoria do desempenho do banco de dados de armazenamento de métricas 361Redução do tempo de entrega para relatórios em uma rede 361Aumento do limite de tempo assíncrono em ambiente de carregamento de uso intenso 362
Componente 6: Anexos
Apêndice A: Configuração manual do IBM Cognos BI 363
Configuração manual do IBM Cognos BI no UNIX e no Linux 363Alteração manual das definições de configuração padrão em computadores com UNIX e
Linux 364Alteração manual das configurações globais em computadores com UNIX e Linux 367Início e interrupção do IBM Cognos BI em modo silencioso nos computadores com UNIX
e Linux 369Criação manual de arquivos de aplicativo do IBM Cognos 369
Apêndice B: Solução de problemas 375
Arquivos de log 375Problemas ao iniciar o IBM Cognos Business Intelligence 377
CFG-ERR-0106 Erro ao iniciar o serviço do IBM Cognos no IBM Cognos Configuration 378Erro de criptografia ao iniciar o IBM Cognos BI 379Não foi possível iniciar o serviço do IBM Cognos porque a porta já está sendo usada por
outro processo 380O serviço do IBM Cognos não inicia ou há falha após a inicialização 381Falha na inicialização do servidor IBM Cognos BI sem retorno de mensagem de erro 381Servidor IBM Cognos BI indisponível ao iniciar o IBM Cognos BI 381Não é possível fazer logon em um namespace usando o IBM Cognos Connection 386Os serviços do IBM Cognos falham ao reiniciar após uma falha de rede 386Não há avisos de que instalar uma versão posterior do IBM Cognos BI atualiza
automaticamente a versão anterior do armazenamento de conteúdo 386Falha no download de recursos 387DB2 retorna o erro SQL1224N ao conectar ao AIX 387
10 IBM Cognos Business Intelligence PowerPlay
Sumário
Erro do Content Manager ao iniciar o IBM Cognos BI 387O Content Manager falha ao iniciar ou demora muito para iniciar 388DPR-ERR-2014 Erro exibido no arquivo de log no computador do Content Manager 389Caracteres não ASCII no diretório de instalação causam erros de execução 389Não é possível abrir um Cubo MS ou um PowerCube 389A página não foi encontrada ao iniciar o IBM Cognos BI no Windows 2003 390A página não é exibida ao abrir um portal após a instalação do IBM Cognos BI 390DPR-ERR-2058 Aparece um erro no navegador web ao iniciar o IBM Cognos BI 391DPR-ERR-2022 Aparece um erro no navegador web ao iniciar o IBM Cognos BI 393Caracteres corrompidos em alguns idiomas durante a instalação no Linux 393Não foi possível fazer o download do arquivo cognos.xts 394O script de inicialização do servidor de aplicativos falhou 394Falha do IBM Cognos BI ao executar no WebLogic Application Server no AIX 394A implantação do IBM Cognos BI em um servidor de aplicativos Oracle ou IBM WebSphere
falha 394Erro de impossibilidade de remover a série do atributo de contexto ao implementar o
arquivo p2pd.war ao WebLogic 395Erro exibido após atualização do IBM Cognos BI em um servidor de aplicativos
WebLogic 395Caracteres chineses, japoneses ou coreanos ficam diferentes após atualização 396Caracteres de dois bytes ou acentuados podem não ser exibidos corretamente ao instalar
o IBM Cognos BI no Linux 396RSV-SRV-0066 Foi retornada uma falha de soap ou RQP-DEF-0114 O usuário cancelou
a solicitação Aparecem erros no ambiente de carga de usuário alta 397Problemas ao configurar o IBM Cognos Business Intelligence 397
Os valores de devolução da ferramenta de configuração cogconfig.sh não são compatíveiscom os valores de devolução do UNIX convencional 397
Execução de scripts de limpeza de índice e de banco de dados 397Erro ao tentar criptografar informações ao salvar as configurações 401Problemas ao gerar as chaves de criptografia no IBM Cognos Configuration 402CAM-CRP-1315 Erro ao salvar as configurações 402CAM-CRP-0221 Erro ao fazer login no portal 403Alteração manual do nome do diretório de instalação afeta as instalação em execução no
servidor de aplicativos 403A configuração dos dados está bloqueada por outra instância do IBM Cognos
Configuration 404Não foi possível sair de uma seqüência Tab usando a navegação apenas por teclado no
IBM Cognos Configuration 404Não é possível salvar suas configurações 404Erro de Java ao iniciar o IBM Cognos Configuration 405Erro de criptografia ao iniciar o IBM Cognos Configuration 405As configurações atuais não foram aplicadas no computador 405CM-CFG-029 Erro ao tentar salvar uma configuração que especifica um armazenamento
de conteúdo do Microsoft SQL Serve 406Erro de DB2 não encontrado no Linux para Sistema Z 406DPR-ERR-2079 Quando o Content Manager está configurado para Failover 407Falha ao importar um grande armazenamento de conteúdo no Solaris usando JRE 1.5 407Importar uma implantação muito grande no Windows faz a máquina virtual Java parar 407As credenciais para o Active Directory são solicitadas ao usuário 407
Guia de instalação e configuração 11
Sumário
A fonte não foi encontrada no UNIX ao iniciar o IBM Cognos Configuration 408Não é possível detectar o ESSBASEPATH 408Falhas na consulta ao usar o servidor Oracle Essbase 409Os membros do grupo estão ausentes no namespace do Active Directory 410Erros exibidos ao implantar no servidor de aplicativos Oracle 10G 411Erro de limite de tempo CGI enquanto conectado aos componentes do IBM Cognos BI por
meio de um navegador web 411Falha ao carregar a classe de servlet no Weblogic 412Os ícones da área de trabalho ou a janela do IBM Cognos Configuration tremem no
Windows 413A migração não funciona 413
Apêndice C: Atalhos de teclado do assistente de instalação 415
Glossário 417
Índice 421
12 IBM Cognos Business Intelligence PowerPlay
Sumário
Introdução
Este guia contém instruções sobre instalação, configuração e teste do IBM® Cognos® PowerPlay®.
Para obter informações sobre migração e sobre as diferenças entre o IBM Cognos Series 7 PowerPlay
e o IBM Cognos PowerPlay, consulte o Guia de migração e administração do PowerPlay.
Público-alvo
Para utilizar esse guia, é preciso estar familiarizado com
● IBM Cognos Series 7 PowerPlay.
● Instalação de software em computadores Microsoft® Windows® e UNIX®.
● Sua tecnologia da informação e infra-estrutura de segurança.
● Administração de banco de dados, servidor de diretórios e servidor de aplicativos.
Localização de informações
Para encontrar a documentação dos produtos IBM® Cognos® na Internet, incluindo toda a
documentação traduzida, acesse um dos IBM Cognos Information Centers em http://publib.boulder.
ibm.com/infocenter/cogic/v1r0m0/index.jsp. As atualizações das Notas de versão são publicadas
diretamente nos Information Centers.
Também é possível ler versões PDF das notas sobre a versão do produto e de guias de instalação
diretamente dos CDs dos produtos IBM Cognos.
Uso dos tours rápidos
Os Tours rápidos são tutoriais on-line resumidos que ilustram os recursos essenciais dos componentes
dos produtos IBM Cognos. Para visualizar um tour rápido, inicie o IBM Cognos Connection e
clique no link Tour rápido disponível no canto inferior direito da página Bem-vindo. Também há
Tours Rápidos disponíveis nos IBM Cognos Information Centers.
Recursos de acessibilidade
Os recursos de acessibilidade ajudam usuários portadores de alguma deficiência, como mobilidade
restrita ou visão limitada, a utilizar produtos de tecnologia da informação. Este produto possui
recursos de acessibilidade. Para obter informações sobre esses recursos, consulte "Atalhos de teclado
do assistente de instalação" (p. 415 ).
Instruções prospectivas
Esta documentação descreve a funcionalidade atual do produto. Pode-se incluir referências aos itens
que não estão disponíveis no momento. Não se deve inferir nenhuma implicação de qualquer
disponibilidade futura. Tais referências não são um compromisso, uma promessa, ou uma obrigação
legal de entregar qualquer material, código ou funcionalidade. O desenvolvimento, a versão e o
tempo dos recursos ou funcionalidades permanecem a critério exclusivo da IBM.
Licensed Materials – Property of IBM13© Copyright IBM Corp. 2005, 2010.
Termo de responsabilidade referente às amostras
A Companhia das Grandes Aventuras, Vendas GA, qualquer variação do nome Grandes Aventuras
e Amostra de planejamento representam operações de negócios fictícias com dados de amostra
usados para desenvolver aplicativos de amostra para a IBM e seus clientes. Esses registros fictícios
incluem dados de amostra para transações de vendas, distribuição de produtos, e recursos humanos
e financeiros. Qualquer semelhança com nomes, endereço, números de contato ou valores de
transações reais é mera coincidência. Outros arquivos de amostra podem conter dados fictícios
gerados manualmente ou por máquinas, dados factuais compilados a partir de fontes acadêmicas
ou públicas ou dados usados com a permissão do proprietário dos direitos autorais, para uso em
dados de amostra a fim de desenvolver os aplicativos de amostra. Os nomes dos produtos
referenciados podem ser marcas comerciais de seus respectivos proprietários. A cópia não autorizada
é proibida.
14 IBM Cognos Business Intelligence PowerPlay
Introdução
Capítulo 1: O que há de novo?
Esta seção contém uma lista de recursos novos, alterados e removidos para esta versão. Ela auxiliará
no planejamento de estratégias de implantação de aplicativos e atualizações, e de solicitações de
treinamento dos usuários.
Para conhecer as mudanças realizadas nas versões anteriores, consulte:
● Novos recursos na versão 8.4
● Recursos alterados na versão 8.4
● Recursos substituídos na versão 8,4
● Recursos removidos na versão 8.4
Para ver uma lista atualizada dos ambientes compatíveis com os produtos IBM® Cognos® Business
Intelligence, como sistemas operacionais, patches, navegadores, servidores Web, servidores de
diretórios, servidores de banco de dados e servidores de aplicativos, visite o site IBM Cognos
Customer Center (http://www.ibm.com/software/data/support/cognos_crc.html).
Novos recursos na versão 10.1.0Abaixo estão listados os recursos novos desde a última versão. Foram incluídos links para os tópicos
diretamente relacionados.
Acesso ao guia de instalação e de configuração do Software Development KitNa versão 10.1.0, o IBM® Cognos® Software Development Kit Installation and Configuration
Guide está disponível a partir do IBM Cognos Information Center, em http://publib.boulder.ibm.
com/infocenter/cbi/v10r1m0/.
Recursos alterados na versão 10.1.0Abaixo estão listadas as alterações dos recursos desde a última versão. Foram incluídos links para
os tópicos diretamente relacionados.
Local de instalação padrão e alias webO caminho para o diretório de instalação padrão foi alterado no IBM® Cognos® Business Intelligence
versão 10.1.0. O local padrão, representado por local_c10 neste guia, é o seguinte:
● Sistema operacional Microsoft® Windows®
C:\Program Files\IBM\cognos\c10
● Sistemas operacionais UNIX® e Linux®
/usr/IBM/cognos/c10
Licensed Materials – Property of IBM15© Copyright IBM Corp. 2005, 2010.
O alias web padrão do IBM Cognos Configuration foi alterado de cognos8 para ibmcognos.
PowerPlay Batch AdministrationNa versão anterior, o utilitário IBM® Cognos® PowerPlay® Batch Administration estava disponível
somente como um download separado. Nesta versão, o utilitário foi incluído na instalação do
PowerPlay. Para obter mais informações sobre o utilitário, consulte o Guia de migração e
administração do PowerPlay.
União do IBM Cognos Go! Dashboard com recursos do IBM Cognos Viewer emuma única interface do usuário
Nas versões antigas, um aplicativo do painel de controle interativo estava disponível ao se instalar
o IBM® Cognos® Go! Dashboard com o produto do servidor do IBM Cognos BI. Além disso, o
IBM Cognos Viewer disponibilizou a experiência básica de consumo de relatórios.
O IBM Cognos Go! Dashboard e os recursos do IBM Cognos Viewer agora estão unidos em uma
única interface do usuário. Isso traz o consumo de informação para a linha de frente da experiência,
em vez da exibição e da abertura de pastas. No entanto, o IBM Cognos Viewer ainda está disponível
e foi mantido nessa versão.
Suporte aprimorado para autenticação usando o provedor RACFNas versões anteriores, se quisesse usar um fornecedor Resource Access Control Facility (RACF)
para autenticação com o servidor do IBM® Cognos® BI, era necessário criar um provedor JavaTM
personalizado e configurar seu namespace no IBM Cognos Configuration para usá-lo. No servidor
do IBM Cognos BI versão 10.1.0, é possível configurar um namespace RACF diretamente no IBM
Cognos Configuration nos sistemas operacionais UNIX® AIX® ou Linux® para System Z. Para
obter mais informações, consulte "Configuração do IBM Cognos para utilizar provedores de
autenticação" (p. 228 ).
Acesso seguro ao monitorar as métricas do sistema externamenteNas versões anteriores, era possível monitorar externamente as métricas de sistema para o IBM®
Cognos® Administration usando o JavaTM Management Extensions (JMX), uma tecnologia que
fornece ferramentas para gerenciar e monitorar aplicativos e redes orientadas a serviços. No servidor
do IBM Cognos BI, versão 10.1.0, o IBM Cognos Configuration oferece duas novas propriedades
que podem ser usadas para ativar o acesso seguro às métricas no ambiente Java. Para obter mais
informações, consulte "Monitoramento das métricas do sistema externamente" (p. 353 ).
Recursos removidos na versão 10.1.0Abaixo estão listados os recursos removidos desde a última versão. Foram incluídos links para os
tópicos diretamente relacionados.
16 IBM Cognos Business Intelligence PowerPlay
Capítulo 1: O que há de novo?
Gerenciamento de memória para o serviço do IBM CognosNas versões anteriores, havia duas opções no IBM® Cognos® Configuration para configurar a
quantidade máxima de memória para o serviço IBM Cognos. Era possível ajustar o valor da
propriedade Memória máxima em MB ou excluir o serviço Cognos e selecionar o novo serviço,
que usava um modelo de configuração pequeno, médio ou grande. No servidor do IBM Cognos
BI, versão 10.1.0, só há a opção de ajustar o valor da propriedade Memória máxima em MB. Para
obter mais informações, consulte "Ajuste dos recursos da memória para o IBM Cognos
Service" (p. 359 ).
Novos recursos na versão 8.4Listados abaixo estão os recursos mais recentes desde a última versão. Foram incluídos links para
os tópicos diretamente relacionados.
Suporte de idiomas adicionalAlém do japonês, do alemão e do francês, a documentação de instalação, a interface do usuário
para o programa de instalação e o IBM® Cognos® Configuration estão disponíveis nos seguintes
idiomas:
● Chinês (simplificado)
● Chinês (tradicional)
● Coreano
● Italiano
● Espanhol
● Português (Brasil)
Durante a instalação é possível selecionar o idioma para usar da primeira página do assistente de
instalação. Isto determina o idioma da interface de usuário do assistente de instalação e do IBM
Cognos Configuration.
Entretanto, é necessário configurar o IBM Cognos 8 para usar os idiomas adicionais. Para obter
mais informações, consulte "Personalização do suporte de idioma na interface de usuário" (p. 280
).
Suporte para o driver universal do DB2 para bancos de dados de armazenamentode conteúdo, notificação e log
O DB2 introduziu um driver JDBC universal que contém suporte aos drivers JDBC tipo 2 e tipo 4.
O IBM Cognos 8 pode se conectar a bancos de dados de armazenamento de conteúdo, notificação
ou log do DB2 usando qualquer tipo de conectividade JDBC, mas primeiro é necessário copiar dois
arquivos JAR para o diretório de instalação do IBM Cognos 8. Se estiver atualizando, é possível
continuar a usar a conectividade JDBC tipo 2 sem alterar as propriedades de conexão do
armazenamento de conteúdo do DB2.
Guia de instalação e configuração 17
Capítulo 1: O que há de novo?
Para obter mais informações sobre as propriedades de conexão do armazenamento de conteúdo,
consulte "Definição de propriedades de conexão do banco de dados para o armazenamento de
conteúdo" (p. 102 ).
Os dois arquivos JAR que devem ser copiados para o diretório de instalação do IBM Cognos 8 são
os seguintes:
● O arquivo de licença, por exemplo db2jcc_license_cisuz.jar ou db2jcc_license_cu.jar.
● Um arquivo de driver, db2jcc.jar.
Para obter informações sobre como copiar esses arquivos, consulte "Configuração da conectividade
de banco de dados para o banco de dados de armazenamento de conteúdo" (p. 97 ).
DB2 em z/OS como armazenamento de conteúdo, banco de dados de log ou denotificação
É possível usar o DB2 em z/OS como o armazenamento de conteúdo, banco de dados de log ou de
notificação.
As configurações de conexão para DB2 em z/OS são similares àquelas para DB2 em Linux®, UNIX®
e Microsoft® Windows®. Entretanto, configurações avançadas adicionais devem ser definidas.
Para obter mais informações sobre as definições de configuração, consulte "Configurações sugeridas
para criar um armazenamento de conteúdo no DB2 em z/OS" (p. 48 ), "Configurações sugeridas
para criar um banco de dados de notificação para DB2 em z/OS" (p. 256 ) e "Configurações sugeridas
para criar um banco de dados de log DB2 em z/OS" (p. 267 ).
É necessário executar scripts para criar tablespaces para armazenar objetos grandes (LOBs). Para
obter mais informações, consulte "Criação de tablespaces para um armazenamento de conteúdo
DB2 em z/OS" (p. 94 ), "Criação de tablespaces para o banco de dados de log DB2 em z/OS " (p. 267
) e "Criação de tablespaces para o banco de dados de notificação DB2 em z/OS" (p. 256 ).
Suporte para endereços IP IPv6O IBM Cognos 8 suporta agora dois protocolos de endereços IP: IPv4 e IPv6. O IPv4 usa endereços
IP de 32 bits e o IPv6 usa endereços IP de 128 bits. O padrão é IPv4.
Para o IBM Cognos Configuration aceitar endereços IPv6 nas propriedades do URI local, inicie o
IBM Cognos Configuration com a opção -ipv6. É possível especificar a opção sempre que se abre
o IBM Cognos Configuration da linha de comandos.
No Microsoft® Windows®, é possível definir a opção permanentemente, adicionando-a ao atalho
do menu Iniciar.
Para obter mais informações, consulte "Alteração da versão do endereço IP" (p. 295 ).
Suporte para aplicativos de servidor de 64 bitsOs produtos IBM Cognos 8 Business Intelligence agora estão disponíveis com suporte para servidores
de aplicativos de 64 bits.
Para obter mais informações sobre servidores de aplicativos compatíveis, consulte o IBM Cognos
Customer Center ( http://www.ibm.com/software/data/support/cognos_crc.html).
18 IBM Cognos Business Intelligence PowerPlay
Capítulo 1: O que há de novo?
Para obter mais informações, consulte o Guia de instalação e configuração do IBM Cognos 8.
Ocultação do namespace dos usuários durante o loginÉ possível agora ocultar namespaces de usuários durante o login. Isso permite ter namespaces de
signon confiável sem exibi-los na lista de seleção de namespace que é apresentada aos usuários
durante o logon. Para mais informações, consulte "Ocultação do namespace dos usuários durante
o login" (p. 207 ).
Recursos alterados na versão 8.4Listados abaixo estão os recursos introduzidos na última versão. Foram incluídos links para os
tópicos diretamente relacionados.
Instalação do Supplementary Languages Documentation necessário para adocumentação do produto traduzida
É necessário instalar o Supplementary Languages Documentation para acessar a documentação do
produto em idiomas diferentes do inglês. Para obter mais informações, consulte "Instalação da
documentação do produto traduzida" (p. 188 ).
Por padrão, ao instalar o componente de gateway do IBM® Cognos® 8, a documentação de instalação,
que inclui o Guia de instalação e configuração, o Guia rápido de instalação e configuração e as
Notas de versão, é instalada em todos os idiomas suportados. A documentação do produto, como
o Administration and Security Guide, é instalada somente em inglês.
Conexão padrão a um armazenamento de conteúdo IBMDB2 substitui o MicrosoftSQL Server
Ao iniciar o IBM® Cognos® Configuration pela primeira vez, a conexão ao IBM DB2 substitui o
Microsoft® SQL Server pelo armazenamento de conteúdo padrão.
Se o Banco de dados de conteúdo do IBM Cognos não foi instalado e você deseja usar outro servidor
de banco de dados para o armazenamento de conteúdo, é necessário excluir o armazenamento de
conteúdo padrão. Após a desinstalação, se instalar no mesmo local como uma versão anterior, suas
configurações são preservadas e o armazenamento de conteúdo existente é usado.
Para obter mais informações, consulte "Definição de propriedades de conexão do banco de dados
para o armazenamento de conteúdo" (p. 102 ).
O IBM Java Runtime Environment (JRE) substitui o Sun Java RuntimeEnvironment
O IBM Cognos 8 agora possui a versão da IBM do JRE como parte das instalações no Microsoft®
Windows®. Isso substitui o Sun JRE para plataformas Windows de 32 bits.
O local de instalação permanece o mesmo. Qualquer conteúdo criptografado com Sun JRE pode
ser descriptografado com o IBM JRE.
Guia de instalação e configuração 19
Capítulo 1: O que há de novo?
Recursos substituídos na versão 8,4Recursos obsoletos são substituídos por uma nova versão ou uma melhor implementação. A intenção
é interromper o uso do recurso e recomendar adaptações dessa alteração no decorrer de várias
versões.
Abaixo estão relacionados os recursos substituídos, incluindo links para tópicos relacionados.
Suporte para driver DB2 JDBC tipo 2 para bancos de dados de armazenamentode conteúdo, notificação e log em Linux, UNIX e Windows (db2java.zip)
O DB2 introduziu um driver JDBC universal que contém suporte aos drivers JDBC tipo 2 e tipo 4.
Este novo driver universal substitui o driver substituído JDBC tipo 2, db2java.zip.
É possível continuar a usar a conectividade tipo 2 sem ter de alterar configurações. Se escolher usar
a conectividade tipo 4, é necessário alterar uma configuração.
Para obter mais informações, consulte "Definição de propriedades de conexão do banco de dados
para o armazenamento de conteúdo" (p. 102 ).
Recursos removidos na versão 8.4Abaixo estão listados os recursos removidos desde a última versão. Foram incluídos links para os
tópicos diretamente relacionados.
Interface de usuário baseada em texto para instalação no UNIX e no LinuxNas versões anteriores dos produtos IBM® Cognos® 8 BI, era possível executar um programa de
instalação ou desinstalação baseado em texto ou em modo de console em sistemas que não possuem
o XWindows. Na versão atual, os programas de instalação e a desinstalação baseados em texto
não estão disponíveis. Os usuários que fizerem a instalação no UNIX® e no Linux® sem o XWindows
devem executar uma instalação ou desinstalação autônoma (p. 345 ).
Suporte ao idioma para texto e mensagens da interface de usuário do IBMCognos 8 Supplementary Languages para a instalação do IBM Cognos 8 Server
O IBM Cognos 8 vem com um conjunto de texto e mensagens de interface de usuário em diversos
outros idiomas em relação à versão anterior. Não é mais solicitado instalar os idiomas
complementares de um programa de instalação separado para exibir a interface de usuário em um
dos idiomas suportados. Os arquivos solicitados são instalados automaticamente ao instalar o
servidor do IBM Cognos 8.
Entretanto, é necessário usar o Supplementary Languages Documentation para instalar as fontes
Andale WT para Japão e Coreia. Essas fontes mapeiam o valor U+005C como um caractere de iene
ou won. Para obter mais informações, consulte "Instalação e configuração de fontes de idiomas
adicionais" (p. 189 ).
20 IBM Cognos Business Intelligence PowerPlay
Capítulo 1: O que há de novo?
Capítulo 2: Componentes usados pelo IBMPowerPlay
O IBM® Cognos® PowerPlay® é uma solução de inteligência em negócios baseada na web com
recursos integrados de criação de relatórios e exploração de dados.
O PowerPlay se integra com facilidade à infraestrutura existente usando recursos que estão em seu
ambiente. Alguns desses recursos existentes são necessários, como utilizar um banco de dados para
o armazenamento de conteúdo. Outros recursos são opcionais, como utilizar um provedor de
segurança para autenticação ou utilizar um servidor de aplicativos.
Por padrão, o IBM Cognos PowerPlay usa o Tomcat como servidor de aplicativos. É possível
configurar os produtos do IBM Cognos Business Intelligence para que sejam executados em servidores
de aplicativos compatíveis usados atualmente em seu ambiente.
Componentes do servidorOs componentes do servidor fornecem ao usuário interfaces para relatórios e exploração de dados,
assim como funcionalidades para encaminhar e processar solicitações de usuários.
Comunicação web - gatewayA comunicação web no IBM® Cognos® Business Intelligence é feita normalmente através dos
gateways residentes em um ou mais servidores web. O gateway é uma extensão de um programa
de servidor web que transfere informações desse servidor para outro.
Os gateways em geral são programas CGI, mas podem seguir outros padrões, como o Internet
Server Application Program Interface (ISAPI) e o Apache Modules (apache_mod), ou como
implementação de servlet.
Application Tier ComponentsAlguns componentes do servidor são fornecidos com todos os produtos do IBM® Cognos® Business
Intelligence. Os componentes comuns do servidor incluem as seguintes ferramentas:
Configuração e gerenciamento do produto - IBM Cognos Configuration
O IBM Cognos Configuration é uma ferramenta usada para configurar o IBM Cognos BI e para
iniciar e interromper seus serviços.
Publicação, gerenciamento e visualização de conteúdo - IBM Cognos Connection
O IBM Cognos Connection é um portal da web fornecido junto com o IBM Cognos BI que oferece
um ponto de acesso único aos dados da empresa disponíveis para seus produtos. Ele fornece um
ponto único de entrada para consultas, análises e organização de dados, e para a criação de relatórios,
cartões de desempenho e eventos. Os usuários podem executar todos os seus aplicativos do IBM
Licensed Materials – Property of IBM21© Copyright IBM Corp. 2005, 2010.
Cognos BI baseados na web por meio do IBM Cognos Connection. Outros aplicativos de inteligência
de negócios e URLs para outros aplicativos podem ser integrados ao IBM Cognos Connection.
Administração central - IBM Cognos Administration
O IBM Cognos Administration é uma interface de gerenciamento central que contém as tarefas
administrativas para o IBM Cognos BI e o IBM Cognos PowerPlay®. Ele fornece fácil acesso ao
gerenciamento total do ambiente do IBM Cognos BI e é acessível pelo IBM Cognos Connection. O
IBM Cognos Administration também dá acesso às configurações de cubo e de relatório para o
PowerPlay.
IBM Cognos PowerPlay Studio
O PowerPlay Studio permite que os usuários visualizem, explorem e distribuam relatórios usando
um navegador da web.
Visualização e interação com o conteúdo publicado - Cognos Viewer
O Cognos Viewer é um portlet em que é possível visualizar e interagir com qualquer tipo de conteúdo
publicado do IBM Cognos. É acessível pelo IBM Cognos Connection e por qualquer portal de
negócios existente.
Como facilitar as tomadas de decisão - IBM Cognos Business Insight
No IBM Cognos Business Insight é possível criar paineis de controle interativos e sofisticados usando
o conteúdo do IBM Cognos, além de fontes de dados externas, como folhas de cálculo do TM1® e
CubeViews, de acordo com suas necessidades de informação específicas. É possível visualizar e
abrir os paineis de controle e relatórios favoritos, manipular o conteúdo desses paineis e enviá-los
por e-mail. Também é possível usar os comentários e atividades para tomar decisões de maneira
colaborativa.
Gerenciamento de dados de aplicativos - Content ManagerO Content Manager é o serviço do IBM® Cognos® BI que gerencia o armazenamento de dados de
aplicativos do cliente, incluindo segurança, dados de configuração, modelos, métricas, especificações
e saídas de relatório. O Content Manager é necessário para publicar pacotes, recuperar ou armazenar
especificações de relatório, gerenciar informações de agendamento e gerenciar o namespace Cognos.
O Content Manager armazena informações em um banco de dados de armazenamento de conteúdo.
Componentes opcionais do servidorOs seguintes componentes opcionais estão disponíveis para instalação no servidor, para melhorar
os recursos do IBM® Cognos® Business Intelligence.
Banco de dados de aplicativos pré-configurado - Banco de dados de conteúdo do Cognos
O Banco de dados de conteúdo do Cognos é uma instância do banco de dados do Apache Derby.
É um componente de instalação selecionável e não é instalado por padrão. Se ele for instalado no
mesmo local do Content Manager, o Banco de dados de conteúdo do Cognos será configurado
como o armazenamento de conteúdo padrão do IBM Cognos Business Intelligence.
22 IBM Cognos Business Intelligence PowerPlay
Capítulo 2: Componentes usados pelo IBM PowerPlay
Use o Banco de dados de conteúdo do Cognos apenas em ambientes para sistemas de teste ou prova
de conceito.
O Apache Derby é um software de código aberto cujos termos de licença podem ser encontrados
no site do Apache Derby. Não se pode modificar o banco de dados do Apache Derby ou usá-lo
com outros produtos. Qualquer modificação feita no banco de dados do Apache Derby ficará por
sua conta e risco.
É possível usar o Banco de dados de conteúdo do Cognos como um banco de dados de
armazenamento de conteúdo ou de notificação, mas não como um banco de dados de consulta.
Aprendizado e solução de problemas com dados de amostra - Amostras do IBM CognosBI
As amostras do IBM Cognos BI ilustram os recursos do produto e as melhores práticas técnicas e
de negócios, usando dados de uma empresa fictícia, a Grandes Aventuras. Também é possível utilizá-
las para testar e compartilhar técnicas de elaboração de relatórios e para solucionar problemas.
Componentes de migraçãoOs componentes de migração do IBM® Cognos® Business Intelligence são usados para migrar
conteúdo do IBM Cognos Series 7 para o IBM Cognos BI. Também são usados para migrar os
relatórios do PowerPlay® Studio para o Analysis Studio e o Report Studio.
Para obter mais informações sobre os componentes de migração, consulte o Guia de migração e
administração do Cognos PowerPlay.
Os componentes de migração incluem o seguinte:
Assistente de migração
Os administradores utilizam o assistente de migração para migrar o conteúdo do IBM Cognos
Series 7 PowerPlay no PowerPlay Enterprise Server, Upfront e IBM Cognos Connection para o IBM
Cognos PowerPlay.
Serviços de migração
Os serviços de migração suportam a migração do conteúdo do PowerPlay no IBM Cognos Series 7
para o IBM Cognos PowerPlay. A instalação do IBM Cognos PowerPlay inclui, por padrão, o
serviço de migração. O CD do IBM Cognos PowerPlay também inclui o serviço de migração instalado
no computador com o IBM Cognos Series 7.
Utilitário de conversão de indicador
O utilitário de conversão de indicador converte os indicadores do PowerPlay Enterprise Server para
um formato que pode ser lido pelo IBM Cognos PowerPlay Studio.
Macro de conversão de relatórios
O IBM Cognos PowerPlay não é compatível com relatórios no formato ppr criados com o IBM
Cognos Series 7. O IBM Cognos PowerPlay fornece uma macro denominada ppr2ppx.mac que
permite a conversão dos relatórios no formato ppr para o formato ppx.
Guia de instalação e configuração 23
Capítulo 2: Componentes usados pelo IBM PowerPlay
Macro de atualização de relatório
Caso existam arquivos .ppx locais que acessam cubos remotos, o IBM Cognos PowerPlay fornece
uma macro que pode ser usada para alterar a referência do cubo no relatório para uma referência
do pacote do IBM Cognos BI. Além disso, a macro converte a codificação do relatório para UTF-8.
Migração para o Analysis Studio e o Report Studio
O Analysis Studio e o Report Studio são componentes do servidor disponíveis no IBM Cognos BI.
Os usuários podem abrir os relatórios do PowerPlay e migrá-los para o Analysis Studio ou para o
Report Studio usando as funcionalidades Abrir com o Analysis Studio ou Abrir com o Report
Studio. Essa funcionalidade, que pode ser desativada pelo administrador do PowerPlay, usa o serviço
de migração do IBM Cognos BI para migrar os relatórios.
Componentes do clienteOs componentes do cliente fornecem funcionalidade para usuários sem as exigências de uma
instalação de servidor completa e podem depender do servidor para realizar algumas operações. O
IBM® Cognos® PowerPlay® fornece o seguinte cliente.
Cliente do IBM Cognos PowerPlay
O PowerPlay Client permite aos usuários visualizar, explorar, formatar e distribuir relatórios.
Outros componentesAlém das ferramentas fornecidas com o IBM® Cognos® PowerPlay®, são necessários outros
componentes.
Armazenamento de conteúdo
O armazenamento de conteúdo é um banco de dados relacional que contém os dados necessários
para o funcionamento do IBM Cognos BI, tais como especificações de relatório, modelos publicados
e os pacotes que os contêm; informações de conexão para fontes de dados; informações sobre o
namespace externo e o próprio namespace do Cognos, assim como informações sobre programação
e distribuição de relatórios.
O produto IBM Cognos BI inclui um banco de dados incorporado, o Cognos Content Database,
que pode ser usado para que o produto seja executado rapidamente em um sistema de teste ou de
prova de conceito. Quando estiver pronto para configurar um ambiente de produção com o produto
IBM Cognos BI, configure o armazenamento de conteúdo para usar um banco de dados compatível
protegido e com desempenho e estabilidade ajustados. O portal de administração fornece recursos
que podem ser usados para fazer backup e arquivar os dados do Banco de dados de conteúdo do
Cognos, antes de mudar para o novo banco de dados de armazenamento de conteúdo no ambiente
de produção. Para obter mais informações, consulte o tópico sobre como implantar todo o
armazenamento de conteúdo no Guia de administração e segurança.
Modelos de design e arquivos de log não são guardados no armazenamento de conteúdo.
O serviço do IBM Cognos que usa o armazenamento de conteúdo é denominado Content Manager.
24 IBM Cognos Business Intelligence PowerPlay
Capítulo 2: Componentes usados pelo IBM PowerPlay
Fontes de dados
O PowerPlay oferece suporte a fontes de dados PowerCubes. Outros componentes do IBM Cognos
Business Intelligence são compatíveis com outros tipos de fontes de dados. Para obter mais
informações, consulte o Guia de administração e segurança do IBM Cognos BI.
Guia de instalação e configuração 25
Capítulo 2: Componentes usados pelo IBM PowerPlay
26 IBM Cognos Business Intelligence PowerPlay
Capítulo 2: Componentes usados pelo IBM PowerPlay
Capítulo 3: Opções de distribuição para o IBMCognos PowerPlay
Antes de implementar o IBM® Cognos® PowerPlay®, decida como o produto será instalado em seu
ambiente. É possível instalar todos os componentes do PowerPlay em um computador ou distribuí-
los em uma rede. A melhor opção de distribuição depende das exigências para relatórios, recursos
e preferências. As exigências de configuração diferem dependendo se todos os componentes são
instalados em um computador ou em mais de um computador.
O PowerPlay é compatível com outros produtos IBM Cognos Business Intelligence da mesma versão.
Se o ambiente contiver outros produtos do IBM Cognos, é preciso considerar como o PowerPlay
se adaptará a esse ambiente.
Para algumas instalações distribuídas que incluem componentes do IBM Cognos PowerPlay e do
IBM Cognos BI, é necessário realizar tarefas adicionais no IBM Cognos Administration após concluir
a instalação e a configuração. Para obter mais informações sobre as tarefas de administração
necessárias, consulte o Guia de migração e administração do PowerPlay.
Distribuição de componentes do IBMCognos PowerPlay ServerAo instalar os componentes do servidor do IBM® Cognos® PowerPlay®, especifique onde colocar
o gateway, o Application Tier Components e o Content Manager. É possível instalar esses
componentes utilizando qualquer uma das seguintes opções:
● Instale todos os componentes em um computador.
Essa opção é normalmente utilizada para uma demonstração ou em um ambiente prova de
conceito.
● Instale o gateway em um computador separado.
Nessa opção, o gateway e o servidor web estão em um computador, e os outros componentes
do IBM Cognos estão em outros computadores. É possível escolher essa opção se tiver servidores
web disponíveis para tratar as solicitações de componentes do IBM Cognos Business Intelligence.
● Instale Application Tier Components e o Content Manager em computadores separados.
Escolha essa opção para maximizar o desempenho, a disponibilidade, a capacidade ou a
segurança com base nas características de processamento da organização.
Se planeja instalar o Banco de Dados de Conteúdo do IBM Cognos, instale-o no mesmo
computador que o Content Manager ou em outro computador. Se instalá-lo no mesmo
computador e no mesmo local, o Banco de dados de conteúdo do Cognos será configurado
automaticamente para uso como o armazenamento de conteúdo. Se instalá-lo em outro
computador, verifique se definiu as propriedades de conexão para o Banco de Dados de
Conteúdo do IBM Cognos no computador com o Content Manager.
Licensed Materials – Property of IBM27© Copyright IBM Corp. 2005, 2010.
● Instale os componentes do servidor do IBM Cognos PowerPlay no mesmo computador que
outros produtos do IBM Cognos BI da mesma versão.
Os produtos do IBM Cognos BI são projetados para compartilhar componentes, incluindo o
gateway, o Content Manager, o armazenamento de conteúdo, o IBM Cognos Connection e o
IBM Cognos Configuration. Se instalar mais de um produto IBM Cognos BI no mesmo
computador, instale-os no mesmo local de instalação. O programa de instalação faz uma
verificação para determinar se existem outros componentes do IBM Cognos BI no local de
instalação. Se existir um componente e puder ser compartilhado, não será reinstalado.
Alguns componentes do IBM Cognos BI estão disponíveis para sistemas de 64 bits. Se estiver
instalando todos os componentes do servidor em um único ou diversos servidores, os
componentes de 32 e 64 bits devem estar em diretórios separados.
Depois de instalar os componentes de servidor do IBM Cognos, configure-os para que possam se
comunicar uns com os outros.
Além de instalar o Content Manager, Application Tier Components e componentes de gateway,
pode-se escolher instalar o Framework Manager, o aplicativo de modelagem de metadados para
inteligência de negócio. Também é possível escolher instalar o Transformer, a ferramenta de
modelagem e construção para criar PowerCubes para serem utilizados com o IBM Cognos BI.
Independentemente do cenário de instalação do IBM Cognos utilizado, é possível instalar todos os
componentes de modelagem em locais diferentes. Para obter mais informações sobre como instalar
o Framework Manager ou o Transformer, consulte o Guia de instalação e configuração do IBM
Cognos BI.
Todos os componentes em um computadorÉ possível instalar todos os componentes do IBM® Cognos® PowerPlay® em um computador. Escolha
esse cenário para ambientes de teste ou demonstração nos quais a carga de usuário é pequena.
Como o gateway deve estar localizado junto com o servidor web, o computador também deve
executar um servidor web. Se seu servidor web estiver no UNIX® ou Linux®, é necessário instalar
o PowerPlay Client baseado no Windows em um computador separado que seja executado no
Microsoft® Windows®.
Em uma instalação em um único computador, todos os componentes de servidor do PowerPlay
estão instalados em um único computador. O armazenamento de conteúdo e as fontes de dados
podem estar localizados em um ou mais computadores diferentes.
Requisitos de configuração
Se instalar todos os componentes do servidor do PowerPlay no mesmo computador, é necessário:
● Configurar o servidor web para visualizar conteúdo do IBM Cognos.
● Especificar informações de conexão para o armazenamento de conteúdo.
● Especificar um servidor de e-mail e uma conta de e-mail para notificações (se pretende enviar
relatórios por e-mail).
28 IBM Cognos Business Intelligence PowerPlay
Capítulo 3: Opções de distribuição para o IBM Cognos PowerPlay
Gateways em computadores separadosO gateway passa consultas do servidor web e dos clientes para o distribuidor. Pode residir em um
ou mais servidores web.
É possível instalar o gateway e um servidor web em um computador, e instalar os componentes de
servidor remanescentes do IBM® Cognos® PowerPlay® em outros computadores. Se tiver uma Web
farm, considere a instalação de um gateway em cada servidor web. A utilização de vários servidores
web para gerenciar solicitações de entrada oferece um nível de serviço melhor.
Se instalar apenas o componente de gateway no mesmo computador que o servidor web, o servidor
web gerencia os principais serviços web e não processa solicitações de usuário do IBM Cognos BI.
Essa separação do processamento pode ser necessária se houver um firewall entre o servidor web
e os computadores com o Application Tier Components.
No diagrama a seguir, cada um dos dois servidores web tem um gateway instalado. As solicitações
que chegam são passadas para o gateway e encaminhadas para o computador com Application Tier
Components.
Instalaçãode múltiplosgateways
Content Manager
Gateway doservidor web
Gateway doservidor web
Armazenamentode conteúdo
Fontes de dados
do Application TierComponents
Requisitos de configuração
Se instalar um ou mais gateways em computadores separados, será preciso garantir que possa
visualizar o conteúdo do IBM Cognos e que os gateways possam se comunicar com outros
componentes do IBM Cognos. Em cada computador onde o gateway está instalado, é necessário
● Configurar o servidor web para visualizar conteúdo da web do IBM Cognos.
● Configurar os URIs de distribuidores.
Application Tier Components e Content Managers em computadores separadosO Application Tier Components usa a interface do IBM® Cognos® Connection para equilibrar
cargas, acessar dados, efetuar consultas, agendar trabalhos e processar relatórios. O Content
Manager armazena todas as especificações de relatórios, resultados, pacotes, pastas e trabalhos no
armazenamento de conteúdo.
Guia de instalação e configuração 29
Capítulo 3: Opções de distribuição para o IBM Cognos PowerPlay
É possível instalar os Application Tier Components e o Content Manager no mesmo computador
ou em computadores diferentes. A instalação em computadores diferentes pode aperfeiçoar o
desempenho, a disponibilidade e a capacidade.
Para melhorar a escalabilidade em um ambiente no qual haja normalmente um grande volume de
solicitações para processar, é possível instalar o Application Tier Components em vários
computadores dedicados ao processamento de solicitações que chegam. Com a instalação de
Application Tier Components em vários computadores, as cargas são distribuídas e balanceadas
entre os computadores. A acessibilidade e a taxa de transferência também são melhores que em um
único computador, assim como o suporte a failover.
Em uma instalação com vários servidores IBM Cognos PowerPlay®, as solicitações de entrada são
roteadas por meio de um gateway para um distribuidor. O distribuidor encaminha a solicitação
para um dos servidores do PowerPlay. O servidor do PowerPlay encaminha a solicitação ao Content
Manager, que busca o armazenamento de conteúdo por metadados para consultar o PowerCube.
Os resultados das consultas são retornados ao servidor do PowerPlay para processamento.
Requisitos de configuração
Se instalar um ou mais Application Tier Components em um computador separado, para garantir
que possam se comunicar com outros componentes do PowerPlay, será necessário:
● Especificar todos os URIs do Content Manager.
● Especificar os URIs de distribuidores.
● Especificar o URI do distribuidor para aplicativos externos.
Mais de um Content Manager
É possível instalar uma série de instalações do Content Manager. Para suporte de failover, é
aconselhável instalar o Content Manager em dois ou mais computadores. Somente um Content
Manager pode está ativado por vez. As outras instalações agem como uma reserva do Content
Manager. Um Content Manager em espera se tornará ativo apenas se ocorrer uma falha que afete
o computador com Content Manager ativo.
O Content Manager armazena dados que o IBM Cognos Business Intelligence precisa para funcionar,
como especificações de relatório, modelos publicados e os pacotes que os usam; informações de
conexão com fontes de dados; informações sobre o namespace externo e o próprio namespace do
Cognos; e informações sobre a programação e distribuição de relatórios. O armazenamento de
conteúdo é um sistema de gerenciamento de banco de dados relacional (RDBMS). Há apenas um
armazenamento de conteúdo para cada instalação do IBM Cognos BI.
É possível instalar o Content Manager separadamente do Application Tier Components. Por
exemplo, o Content Manager pode ser necessário na camada de dados em vez da camada de
aplicativos.
Se um Content Manager ativo falhar, os dados de sessão que não foram salvos serão perdidos.
Quando o novo Content Manager ativo assumir, os usuários poderão ter que refazer login.
No diagrama a seguir, uma solicitação direcionada ao Content Manager padrão falha. A solicitação
é redirecionada ao computador do Content Manager em espera, que se tornará ativo quando o
computador padrão do Content Manager falhar.
30 IBM Cognos Business Intelligence PowerPlay
Capítulo 3: Opções de distribuição para o IBM Cognos PowerPlay
Instalação de diversosContent ManagerGateway de servidor
Content Managerem espera
Content Managerpadrão ativo
Armazenamentode conteúdo
Fontes de dados
web Application TierComponents
Requisitos de configuração
Em cada computador no qual foi instalado o Content Manager, é necessário
● Especificar informações de conexão para o armazenamento de conteúdo.
● Especificar os URIs de distribuidores.
● Especificar todos os URIs do Content Manager.
● Especificar o URI do distribuidor para aplicativos externos.
● Configurar uma conexão a uma conta de e-mail para obter notificações (se pretende enviar
relatórios por e-mail).
Instalação do IBM Cognos PowerPlay com outros componentes do IBM CognosBI em um sistema de 64 bits
Alguns componentes do IBM® Cognos® Business Intelligence estão disponíveis para sistemas
operacionais de 64 bits. Da mesma forma que em versões anteriores, os componentes do IBM
Cognos PowerPlay® permanecem com 32 bits. Entretanto, o PowerPlay fornece uma instalação
para suportar uma integração com instalações do IBM Cognos BI de 64 bits. Essa integração permite
que se aproveitem os benefícios em termos de desempenho, oferecidos pelos componentes do IBM
Cognos BI de 64 bits.
O diretório de instalação padrão utilizado pelos componentes do IBM Cognos BI depende da versão
instalada. Se estiver instalando todos os componentes do servidor em um único ou diversos servidores,
os componentes de 32 e 64 bits devem estar em diretórios separados. Para instalações de 32 bits,
o diretório de instalação padrão é C:\Program Files\IBM\Cognos\c10 (sistemas operacionais
Microsoft® Windows®) ou /usr/IBM/cognos/c10 (sistemas operacionais UNIX® e Linux®). Para
instalações de 64 bits, o diretório de instalação padrão é C:\Program Files\IBM\Cognos\c10_64
(Windows) ou /usr/IBM/cognos/c10_64 (UNIX ou Linux).
Guia de instalação e configuração 31
Capítulo 3: Opções de distribuição para o IBM Cognos PowerPlay
Componentes do servidor que devem ser instalados no diretório de 64 bits
Os componentes a seguir podem ser instalados juntos em um servidor de 64 bits ou separadamente
em diversos servidores de 64 bits. Ao instalar os componentes, certifique-se de começar a partir do
diretório de download e disco adequados:
● IBM Cognos BI Server e IBM Cognos PowerPlay (Content Manager, Application Tier
Components, Gateway).
Se estiver usando um servidor Web no qual não é possível carregar uma biblioteca compilada
de 32 bits em um servidor compilado de 64 bits, como o Apache Web Server, instale a versão
de 32 bits do componente de gateway em um servidor Web de 32 bits.
● IBM Cognos BI Supplementary Language Documentation (versões de 32 bits e de 64 bits
disponíveis em um disco).
● IBM Cognos BI Samples (versões de 32 bits e de 64 bits disponíveis em um disco).
Componentes do servidor que devem ser instalados no diretório de 32 bits
Os componentes a seguir podem ser instalados juntos em um servidor de 64 bits, mas em um
diretório separado dos componentes de 64 bits. Também podem ser instalados em um sistema de
32 bits separado:
● IBM Cognos PowerPlay Client (somente Windows)
● IBM Virtual View Manager
● IBM Cognos BI for Microsoft Office (somente Windows)
● IBM Cognos Transformer (utilitário do UNIX e do Linux para criar PowerCubes)
● IBM Cognos Transformer (ferramenta de modelagem do Windows)
Acesso da documentação do produto em um ambiente integradoA documentação dos componentes do IBM® Cognos® Business Intelligence é instalada com o
componente do gateway. Se diferentes produtos do IBM Cognos BI forem integrados, será possível
utilizar o mesmo gateway ou utilizar gateways separados. Se deseja utilizar o mesmo gateway, todos
os componentes do gateway devem ser da mesma versão do produto e o componente de gateway
do IBM Cognos BI deve ser instalado para cada produto no mesmo local, no mesmo computador.
Isso garante que toda a documentação do produto esteja disponível para todos os usuários. Se
deseja utilizar gateways separados para cada produto, instale o componente de gateway do IBM
Cognos BI para cada produto em computadores separados, porém a documentação do produto em
cada gateway será específica para o produto IBM Cognos BI instalado.
Se deseja que os usuários acessem cada produto do IBM Cognos BI por meio de gateways separados,
e ainda assim poder acessar a documentação para todos os componentes, instale o componente de
gateway de cada produto no mesmo local que os outros componentes de gateway do IBM Cognos BI.
32 IBM Cognos Business Intelligence PowerPlay
Capítulo 3: Opções de distribuição para o IBM Cognos PowerPlay
IBM Cognos PowerPlay com outros produtos IBM CognosÉ possível instalar o IBM® Cognos® PowerPlay® em um ambiente que inclui outros produtos IBM
Cognos Business Intelligence. O assistente de instalação do PowerPlay pode reconhecer diretórios
compatíveis e exibe um aviso quando ocorrem conflitos. Após a instalação do PowerPlay, é possível
acessar objetos criados em outros produtos IBM Cognos BI. As exigências de acesso dependem de
como se escolhe executar os dois produtos.
Produtos IBM Cognos Series 7 que podem ser migrados para o IBMCognos PowerPlay
É possível migrar completamente aplicativos do IBM® Cognos® Series 7 PowerPlay® para o IBM
Cognos PowerPlay. Para obter mais informações, consulte o Guia de migração e administração do
PowerPlay.
Também é possível migrar metadados e aplicativos de outros produtos do IBM Cognos Series 7
para o IBM Cognos Business Intelligence. O conteúdo que pode ser migrado inclui modelos do
Architect, relatórios e catálogos do cliente Impromptu®, e conteúdo de relatórios web do Impromptu.
PowerPlay Enterprise Server
Os recursos de análises e exploração de dados do IBM Cognos Series 7 PowerPlay estão agora
disponíveis no IBM Cognos PowerPlay. A arquitetura orientada a serviços do IBM Cognos BI torna
possível a integração dos serviços PowerPlay Web, PowerPlay Enterprise Server Administration e
PowerPlay Enterprise Server.
Use o assistente de migração para migrar conteúdo do IBM Cognos Series 7 PowerPlay do:
● PowerPlay Enterprise Server
● Upfront
● Cognos Connection (conteúdo publicado do IBM Cognos Series 7 PowerPlay Enterprise Server)
Também é possível migrar indicadores e relatórios do PowerPlay Client para o Cognos PowerPlay.
Para obter detalhes sobre o que pode ser migrado do IBM Cognos Series 7 PowerPlay para o IBM
Cognos PowerPlay, consulte o Guia de migração e administração do PowerPlay.
Para migrar o conteúdo do IBM Cognos Series 7 para o IBM Cognos PowerPlay, é necessário
instalar o IBM Cognos PowerPlay Server e o IBM Cognos Series 7 Migration Components.
Arquiteto
É possível migrar modelos de Arquiteto para usar como uma fonte de metadados no Framework
Manager.
Impromptu
É possível migrar catálogos e relatórios do Impromptu para o IBM Cognos BI. Os catálogos migrados
são usados como uma fonte de metadados do Framework Manager. Após completar o processo de
migração de catálogos, é possível migrar e implantar relatórios Impromptu.
Guia de instalação e configuração 33
Capítulo 3: Opções de distribuição para o IBM Cognos PowerPlay
Relatórios Web Impromptu
É possível migrar o conteúdo do WebReports, como programações e eventos, para o IBM Cognos BI.
O conteúdo dos Relatórios Web Impromptu é migrado usando um pacote do IBM Cognos Series 7
Deployment Manager como a fonte de migração. Antes de migrar Relatórios Web Impromptu é
necessário migrar o catálogo de metadados Impromptu usado pelos relatórios.
Não é possível migrar arquivos de definição de consultas Impromptu (.iqd), mas é possível continuar
a usar arquivos .iqd existentes para construir cubos no IBM Cognos BI Transformer 8.4. Para isso,
é necessário instalar o componente opcional Series 7 IQD Bridge, disponível para instalar com o
IBM Cognos BI nas plataformas suportadas do IBM Cognos Series 7.
Os PowerPrompts não são migrados, mas pode-se implementar uma funcionalidade semelhante
usando a funcionalidade de administrador integrada ou o IBM Cognos Software Development Kit.
Produtos IBMCognos que operam conjuntamente com o IBMCognos PowerPlayAlguns produtos do IBM® Cognos® Business Intelligence oferecem recursos que não estão disponíveis
no IBM Cognos PowerPlay®. É possível usar esses produtos no mesmo ambiente que o IBM
Cognos PowerPlay.
IBM Cognos BI Server
Para utilizar ferramentas de modelagem, como o Framework Manager e o IBM Cognos Transformer,
com o PowerPlay, é necessário instalar o IBM Cognos BI. Caso deseje utilizar também o Report
Studio, o Analysis Studio ou o Query Studio, preciso instalar o IBM Cognos BI Server.
Se estiver instalando o PowerPlay em um ambiente IBM Cognos BI existente, faça backup das
configurações do IBM Cognos BI antes de instalar o PowerPlay.
Para instalação em um único computador, instale componentes para ambos os produtos no mesmo
diretório, da seguinte forma:
1. Instale o IBM Cognos BI Server e o IBM Cognos PowerPlay.
2. Configure os componentes instalados.
3. Instale o IBM Cognos Series 7 Migration Components no servidor do IBM Cognos Series 7
PowerPlay.
Para uma instalação distribuída, instale e configure componentes da seguinte forma:
1. Instale, configure e teste todos os componentes referentes ao IBM Cognos BI Server: Content
Manager, Application Tier Components e gateway.
Para obter instruções sobre a instalação e a configuração do IBM Cognos BI Server, consulte
o Guia de instalação e configuração do IBM Cognos BI.
2. Em cada computador que inclui o Application Tier Components do IBM Cognos BI, instale o
PowerPlay Administration. Também é possível instalar o servidor do PowerPlay no mesmo
computador que o Application Tier Components do IBM Cognos BI.
3. Se instalar o Application Tier Components do PowerPlay em um computador separado do
Application Tier Components do IBM Cognos BI, alguns serviços devem ser desativados. No
computador onde o Application Tier Components do PowerPlay foi instalado, abra o Cognos
34 IBM Cognos Business Intelligence PowerPlay
Capítulo 3: Opções de distribuição para o IBM Cognos PowerPlay
Configuration e, nos serviços do IBM Cognos, desative o serviço de apresentação e o serviço
de relatórios. Opcionalmente, para reduzir a demanda dos recursos do sistema, é possível
desativar o serviço de consulta.
4. No computador que inclui os componentes do Content Manager do IBM Cognos BI, instale
os componentes do Content Manager do PowerPlay.
5. No computador que inclui os componentes de gateway do IBM Cognos BI, instale os
componentes de gateway do PowerPlay.
6. Se planeja migrar o conteúdo do IBM Cognos Series 7, instale os IBM Cognos Series 7 Migration
Components no computador IBM Cognos Series 7 PowerPlay Enterprise Server e, se necessário,
no computador IBM Cognos Series 7 Upfront.
Em alguns cenários de instalação distribuída, é necessário desempenhar tarefas adicionais no IBM
Cognos Administration após concluir a instalação e a configuração para assegurar que o conteúdo
do PowerPlay funcione corretamente. Para obter mais informações sobre as tarefas de administração
necessárias, consulte o Guia de migração e administração do PowerPlay.
IBM Cognos Planning - Analyst
Acesse dados de planos publicados no IBM Cognos BI usando o assistente do Generate Framework
Manager Model, que requer o IBM Cognos Planning - Analyst 7.3 MR1 ou mais recente.
Caso deseje utilizar esse produto com o servidor do IBM Cognos BI, será necessário instalar o
servidor de 32 bits do IBM Cognos BI. Verifique também se os dois produtos têm a mesma versão.
Para obter mais informações, consulte o Analyst User Guide.
IBM Cognos Planning - Contributor
Acesse cubos do Contributor não-publicados (em tempo real) no IBM Cognos BI executando a
instalação personalizada do componente IBM Cognos BI - Contributor Data Server incluído no
IBM Cognos Planning - Contributor, versão 7.3 MR1 ou mais recente. Acesse dados de planos
publicados no IBM Cognos BI usando a extensão de administração do Generate Framework Manager
Model, que requer o IBM Cognos Planning - Contributor 7.3 MR1 ou mais recente.
Caso deseje utilizar esse produto com o servidor do IBM Cognos BI, será necessário instalar o
servidor de 32 bits do IBM Cognos BI. Verifique também se os dois produtos têm a mesma versão.
Para obter mais informações, consulte o Contributor Administration Guide.
IBM Cognos Finance
É possível acessar cubos do IBM Cognos Finance seguros contra um namespace Série 7, usando o
IBM Cognos Finance Network API Service. Também é possível exportar dados e metadados do
IBM Cognos Finance para uso no Framework Manager.
IBM Cognos Controller
Acesse o IBM Cognos BI para criar relatórios padronizados do IBM Cognos Controller com um
modelo pré-definido do Framework Manager, criado quando o IBM Cognos Controller é instalado.
Acesse também dados do Controller publicados e estruturas no Framework Manager para criação
de relatórios padrão e análises.
Guia de instalação e configuração 35
Capítulo 3: Opções de distribuição para o IBM Cognos PowerPlay
Caso deseje utilizar esse produto com o servidor do IBM Cognos BI, será necessário instalar o
servidor de 32 bits do IBM Cognos BI. Verifique também se os dois produtos têm a mesma versão.
IBM Cognos Transformer
Use os modelos do IBM Cognos PowerCubes e do Transformer gerados pelo Transformer 7.3 ou
mais recente, diretamente no IBM Cognos BI. Os cubos e modelos são compatíveis com versões
mais recentes e não necessitam de ferramentas de migração ou de atualização. É possível executar
relatórios e análises no IBM Cognos BI em relação ao IBM Cognos PowerCubes.
Caso deseje usar os novos recursos de integração do Transformer com o IBM Cognos BI, atualize
os modelos do IBM Cognos Series 7.x Transformer para o IBM Cognos BI Transformer 8.4 ou
mais recente. Isso permite usar as fontes de dados do IBM Cognos BI (como pacotes publicados),
listar relatórios criados no Query Studio ou no Report Studio, autenticar usando a segurança do
IBM Cognos BI e publicar diretamente para o IBM Cognos Connection.
Antes de carregar o modelo, o namespace do IBM Cognos Series 7 deve estar configurado no IBM
Cognos BI (p. 201 ) e a ID do nome usada para configurá-lo no IBM Cognos BI deve coincidir com
o nome usado no IBM Cognos Series 7.
Para obter mais informações sobre como atualizar os PowerCubes seguros do IBM Cognos Series 7,
consulte o Guia do usuário do IBM Cognos BI Transformer.
Para que os PowerCubes do IBM Cognos Series 7 sejam usados no IBM Cognos BI, aumente a
eficiência dos cubos para o uso no IBM Cognos BI com o utilitário pcoptimizer, fornecido com o
IBM Cognos BI. Do contrário, os PowerCubes criados com versões anteriores do Transformer
podem demorar muito para serem abertos nos studios web do IBM Cognos BI. Esse utilitário de
otimização é adequado para PowerCuber antigos criados antes do Transformer 8.4 e não necessita
de acesso ao modelo ou à fonte de dados. Não é necessário executar este utilitário de linha de
comando para os cubos criados no Transformer 8.4. Para obter mais informações sobre como
otimizar PowerCubes, consulte o Transformer User Guide.
Publique PowerCubes usando o Transformer 8.4, o Framework Manager ou diretamente no portal
do IBM Cognos BI. Publique fontes de dados e pacotes individuais do PowerCube para o IBM
Cognos Connection, interativamente no Transformer ou na linha de comando. Publique também
no modo silencioso usando scripts em lote após criar um PowerCube. O usuário que possui privilégios
para criar fontes de dados e pacotes no IBM Cognos Connection também pode publicar PowerCubes
no IBM Cognos Connection. O arquivo MDC deve estar em um local seguro que o distribuidor e
o processo do servidor de relatórios do IBM Cognos BI possam acessar. Os pacotes que usam
diversos PowerCubes de definições diferentes de PowerCube ou PowerCubes misturados a outras
fontes de dados devem ser publicados usando o Framework Manager.
Caso utilize um PowerCube do IBM Cognos Series 7 como uma fonte de dados, o IBM Cognos BI
converte os dados do cubo da codificação usada no sistema em que o PowerCube foi criado. Para
converter com êxito, os IBM Cognos Series 7 PowerCubes devem ser criados com uma localidade
de sistema definida para corresponder aos dados no PowerCube.
Data Manager
O Data Manager é usado para criar armazenamentos e repositórios de dados para a criação de
relatórios, análises e gerenciamento de desempenho. Quando o Data Manager é instalado no
ambiente do IBM Cognos BI, pode-se usar o serviço de movimentação de dados para executar
36 IBM Cognos Business Intelligence PowerPlay
Capítulo 3: Opções de distribuição para o IBM Cognos PowerPlay
construções e JobStreams no IBM Cognos Connection. É necessário instalar o mecanismo Data
Manager no mesmo local que o IBM Cognos BI Application Tier Components. O Data Manager
e o IBM Cognos BI devem ter a mesma versão.
IBM Cognos Mobile
Com o IBM Cognos Mobile, é possível acessar relatórios criados com o Analysis Studio, o Report
Studio e o Query Studio em um dispositivo móvel (como um BlackBerry®). Para fazer download,
exibir e interagir com os relatórios, o IBM Cognos Mobile exige a instalação de um rich client no
dispositivo móvel, além da instalação dos componentes do IBM Cognos BI no servidor. O IBM
Cognos Mobile e o IBM Cognos BI devem ter a mesma versão.
Conteúdo do IBM Cognos Series 7 que pode ser recriado no IBM Cognos BIAlguns produtos IBM® Cognos® não podem ser sistematicamente migrados ou atualizados com as
ferramentas de migração ou atualização para o IBM Cognos BI. O IBM Cognos BI oferece duas
opções para a duplicação de conteúdo ou recursos referente aos produtos descritos abaixo: use o
portal Upfront no portal do IBM Cognos BI, ou os studios do IBM Cognos BI para duplicar
consultas, visualizações ou objetos.
IBM Cognos Query
É possível usar o IBM Cognos Migration Assistant para identificar os objetos do IBM Cognos
Query na origem de migração do IBM Cognos Series 7. Em seguida, é possível duplicar a maioria
das funcionalidades do IBM Cognos Query no IBM Cognos BI. As consultas de base estão disponíveis
no IBM Cognos BI ao migrar um modelo do Architect para o Framework Manager. Também é
possível copiar manualmente consultas usando os componentes SQL no Report Studio.
IBM Cognos Visualizer
É possível duplicar uma funcionalidade usando as opções de gráfico, layout e formatação no Report
Studio e no Analysis Studio.
IBM Cognos NoticeCast
Duplique funcionalidades de alerta e notificação usando o Event Studio e outros componentes do
IBM Cognos BI.
IBM Cognos Web Services
Duplique a maioria das funcionalidades do IBM Cognos Web Services usando o IBM Cognos
Software Development Kit.
IBM CognosScript
Duplique as funcionalidades de automação usando o IBM Cognos Software Development Kit.
IBM Cognos Portal Services
É possível duplicar a maioria das funcionalidades do IBM Cognos Portal Services usando o IBM
Cognos Connection.
Guia de instalação e configuração 37
Capítulo 3: Opções de distribuição para o IBM Cognos PowerPlay
38 IBM Cognos Business Intelligence PowerPlay
Capítulo 3: Opções de distribuição para o IBM Cognos PowerPlay
Capítulo 4: Preparação para a instalação
Antes de instalar o IBM® Cognos® PowerPlay®, configure os recursos no ambiente para que os
componentes possam funcionar. Por exemplo, é preciso criar um banco de dados para o
armazenamento de conteúdo e configurar os navegadores web. Também é possível criar uma conta
de usuário ou de serviço para o IBM Cognos Business Intelligence.
Se deseja utilizar o Banco de dados de conteúdo do Cognos como o armazenamento de conteúdo,
não é preciso criar um banco de dados ou configurar um cliente de banco de dados. Quando o
Banco de dados de conteúdo do Cognos é selecionado no assistente de instalação, um banco de
dados é criado durante a instalação e o PowerPlay é configurado para utilizá-lo.
Utilize a seguinte lista de verificação para guiá-lo através do processo de configuração:
❑ Reveja as notas de versão.
❑ Reveja os ambientes suportados.
❑ Verifique se o computador atende aos requisitos de software e hardware.
❑ Revise as configurações padrão de porta.
❑ Crie o banco de dados para o armazenamento de conteúdo.
❑ Configure uma conta de usuário ou de serviços de rede para o IBM Cognos BI, se necessário.
❑ Configure os navegadores web.
Depois de concluir essas tarefas, continue com "Instalação e configuração do IBM Cognos PowerPlay
em um computador" (p. 85 ) ou "Instalação e configuração dos componentes do servidor IBM
Cognos PowerPlay em computadores diferentes" (p. 121 ).
Revisão das notas de versão antes da instalaçãoAntes de instalar o produto IBM® Cognos®, é importante estar ciente de todos os problemas que
podem afetar sua estratégia de instalação.
Pode haver questões de última hora, que não eram conhecidas no momento em que este guia de
instalação foi criado.
Revisão das notas de versão antes da instalação do produto. As Notas de versão contêm as
informações mais recentes sobre questões conhecidas, atualizações na documentação e avisos de
descontinuação. As notas de versão estão disponíveis na primeira página do assistente de instalação
ou no disco do produto. Atualizações das notas de versão também estão disponíveis no site do IBM
Cognos Customer Center (www.ibm.com/software/data/cognos/customercenter/).
Licensed Materials – Property of IBM39© Copyright IBM Corp. 2005, 2010.
Revisão de ambientes suportadosPara garantir que o produto funcione corretamente, aplique todos os patches de sistema operacional
minimamente necessários e utilize somente as versões de outros softwares que sejam compatíveis
com o produto do IBM® Cognos®.
Para visualizar uma lista atualizada de ambientes suportados pelos produtos IBM Cognos, como
sistemas operacionais, patches, navegadores e servidores da web, de diretório, de bancos de dados
e de aplicativos, visite o site do IBM Cognos Customer Center (www.ibm.com/software/data/cognos/
customercenter/).
É importante observar que o sistema operacional Linux® está disponível em várias distribuições e
suporta uma série de plataformas de hardware. Certifique-se de que a combinação do sistema
operacional e do hardware usados é compatível.
Verificação das exigências do sistemaUse as tabelas a seguir para verificar as exigências mínimas de hardware e software para instalar e
executar os componentes do IBM® Cognos® Business Intelligence em um computador. Podem ser
solicitados recursos adicionais para ambientes de distribuição ou de produção.
Requisitos de hardware
EspecificaçãoExigência
Microsoft® Windows®Sistema operacional
UNIX®
Linux®
O Linux não suporta alguns componentes do IBM Cognos BI.
Mínimo: 2 GBRAM
Limite do descritor de arquivos definido para 2048 no UNIX e no LinuxEspecificações do
sistema operacional
São necessários no mínimo 2,5 GB de espaço livre para instalar o software
e 4 GB na unidade que contém o diretório temporário usado pelos
components do IBM Cognos.
Espaço em disco
Para todos os bancos de dados, o tamanho aumentará com o tempo.
Certifique-se de ter espaço em disco suficiente para exigências futuras.
40 IBM Cognos Business Intelligence PowerPlay
Capítulo 4: Preparação para a instalação
EspecificaçãoExigência
Para garantir que os relatórios sejam impressos corretamente no Windows,
o Adobe® Reader exige que pelo menos uma impressora seja configurada
no computador em que o Application Tier Components está instalado.
Todos os relatórios, independentemente do formato de impressão escolhido,
são enviados como arquivos PDF temporários ao Adobe Reader para
impressão.
Impressora
Para enviar relatórios por e-mail, o sistema requer a habilidade de usar e
acessar um servidor de e-mail.
Outro
Requisitos de software
EspecificaçãoExigência
Deve ser instalado e iniciado um servidor web.Servidor web
Um JRE da IBM é instalado automaticamente com o IBM Cognos BI no
Windows.
JavaTM Runtime
Environment
(JRE) Se estiver utilizando um servidor de aplicativo, utilize o JRE que está instalado
com ele, se for suportado no IBM Cognos BI.
O Banco de dados de conteúdo do Cognos pode ser instalado e configurado
como o banco de dados de armazenamento de conteúdo padrão em um sistema
de teste ou de prova de conceito.
Banco de dados
É preciso ter um dos seguintes bancos de dados disponível para armazenar
dados do IBM Cognos em um ambiente de produção:
● Oracle
● DB2®
● Microsoft® SQL Server
● Sybase
● Informix
A conectividade TCP/IP é necessária para todos os tipos de bancos de dados.
Guia de instalação e configuração 41
Capítulo 4: Preparação para a instalação
EspecificaçãoExigência
Para todos os navegadores web, o seguinte deverá ser ativado:Navegador web
● Cookies
● JavaScript
Somente para Microsoft Internet Explorer, o seguinte deve estar ativado:
● Executar controles ActiveX e plug-ins
● Executar scripts de controles ActiveX marcados como seguros para execução
de scripts
● Script ativo
● Permissão de META REFRESH
No Windows, Microsoft Data Access Component (MDAC) para uso com
amostras de produtos
Outro
Análise das configurações padrão de porta para o IBMCognos Business Intelligence
A tabela a seguir lista as configurações padrão das portas e de URI para o IBM® Cognos® Business
Intelligence. Depois da instalação, é possível utilizar a ferramenta de configuração para alterar as
configurações. Também é possível alterá-las editando o arquivo cogstartup.xml no diretório
local_c10\configuration.
Definições padrão de porta para componentes do IBM Cognos BI
DescriçãoValor padrãoDefinição
O URI do Content
Manager
http://localhost:9300/ p2pd/servletURI do Content Manager
O URI do gatewayhttp://localhost:80/ibmcognos/cgi-bin/cognos.cgiURI do gateway
O URI do
distribuidor
http://localhost:9300/ p2pd/servlet/dispatchURI do distribuidor
(Interno, Externo)
O URI do
distribuidor
http://localhost:9300/ p2pd/servlet/dispatchURIs do distribuidor para
aplicativos externos
42 IBM Cognos Business Intelligence PowerPlay
Capítulo 4: Preparação para a instalação
DescriçãoValor padrãoDefinição
O URI para o
primeiro distribuidor
utilizado pelo
gateway
http://localhost:9300/ p2pd/servlet/dispatch/ extURIs de distribuidores do
gateway
A porta utilizada
pelo servidor de log
local
9362Porta do servidor de log
A porta utilizada
pelo Banco de dados
de conteúdo do
Cognos.
1527Número de porta de escuta
A tabela a seguir lista as configurações padrão utilizadas pelo IBM Cognos BI para Tomcat. Os
conectores SSL e não SSL são automaticamente atualizados no arquivo server.xml quando o IBM
Cognos Configuration é utilizado para alterar a porta do distribuidor ou para ativar o protocolo
SSL . É possível atualizar diretamente a porta de encerramento utilizando o IBM Cognos
Configuration.
Definições padrão de porta para Tomcat
DescriçãoPortaDefinição
A porta que o Tomcat utiliza para passar solicitações do servidor
web para o IBM Cognos BI
9300Conector diferente de SSL Coyote
HTTP/ 1.1
A porta que o Tomcat utiliza para escutar conexões seguras9334Conector SSL Coyote HTTP/ 1.1
A porta que o Tomcat utiliza para escutar um comando de
encerramento
9399Porta de encerramento
A tabela a seguir lista as configurações padrão utilizadas na migração do IBM Cognos Series 7 para
IBM Cognos BI PowerPlay.
Definições padrão de porta para Migration
DescriçãoPortaDefinição
A porta utilizada para comunicações entre o serviço
de migração do IBM Cognos Series 7 e o serviço de
migração do IBM Cognos BI
21567Número da porta do serviço de migração
A porta utilizada para migração de indicadores7777PPBOOKMARKTOOL_PORT
Guia de instalação e configuração 43
Capítulo 4: Preparação para a instalação
Diretrizes para criar o armazenamento de conteúdoO armazenamento de conteúdo é um banco e dados que o Content Manager usa para armazenar
dados de configuração globais, definições globais (como os formatos de idioma e moeda exibidos
na interface de usuário), conexões a fontes de dados e conteúdo específico de produtos. É necessário
usar um dos bancos de dados de nível empresarial suportados como o armazenamento de conteúdo
em um ambiente de produção.
Não use o Banco de dados de conteúdo do Cognos para o armazenamento de conteúdo em um
ambiente de produção. O Banco de dados de conteúdo do Cognos é fornecido para ajudá-lo a
configurar rapidamente um sistema de teste ou de prova de conceito.
Modelos de projeto e arquivos de log não são guardados no armazenamento de conteúdo.
É necessário criar o armazenamento de conteúdo antes de utilizar o produto IBM® Cognos® Business
Intelligence.
Propriedades do banco de dados
Crie o banco de dados de armazenamento de conteúdo utilizando um dos bancos de dados listados
na tabela a seguir:
Codificação de caracteres e protocolo usado pelos bancos de dados
ProtocoloCodificação de caracteresBanco de dados
TCP/IPUTF-8DB2
TCP/IPAL32UTF8 ou AL32UTF16Oracle
TCP/IPUTF-8 ou UTF-16Microsoft® SQL Server
TCP/IPUTF-8Informix®
TCP/IPUTF-8Sybase
pré-configuradopré-configuradoBanco de dados de conteúdo do
Cognos
Se planeja utilizar o Banco de dados de conteúdo do Cognos como armazenamento de conteúdo,
um banco de dados é criado e configurado quando a instalação estiver concluída.
Seqüência de intercalação
Observe que o Cognos BI utiliza uma única ordem de classificação que especifica regras utilizadas
pelo banco de dados para interpretar, coletar, comparar e apresentar dados de caracteres. Por
exemplo, uma ordem de classificação define se a letra A é menor, igual ou maior que a letra B; se
a intercalação diferencia maiúsculas de minúsculas e acentos. Para obter mais informações sobre
intercalação e seqüências de intercalação, consulte a documentação do banco de dados.
44 IBM Cognos Business Intelligence PowerPlay
Capítulo 4: Preparação para a instalação
Configurações sugeridas para criar o armazenamento de conteúdo no DB2 noLinux, Windows e UNIX
O banco de dados criado nos sistemas operacionais Microsoft® Windows®, Linux® ou UNIX® para
o armazenamento de conteúdo deve conter as definições de configuração especificadas.
Para garantir uma instalação com sucesso, siga as seguintes diretrizes ao criar o armazenamento
de conteúdo. Use as mesmas diretrizes para criar um banco de dados para registrar mensagens.
Arquivos de biblioteca para DB2
Certifique-se de usar os arquivos de biblioteca adequados para a versão do servidor do IBM®
Cognos® Business Intelligence que foi instalada. O IBM Cognos BI requer arquivos de biblioteca
de 32 bits ao ser executado em um servidor de aplicativos de 32 bits e requer arquivos de biblioteca
de 64 bits ao ser executado em um servidor de aplicativos de 64 bits. Dependendo da versão do
DB2® instalada, será preciso alterar os arquivos de biblioteca ou a ordem na qual os arquivos de
biblioteca são listados, para que o servidor do IBM Cognos BI possa encontrar os arquivos corretos.
Independentemente da versão, os arquivos de biblioteca necessários devem ser listados primeiro.
Orientações para criar o armazenamento de conteúdo no DB2 no Linux, Windows ouUNIX
Se criar seu próprio armazenamento de conteúdo, utilize a seguinte lista de verificação para ajudá-
lo a configurar o armazenamento de conteúdo no DB2.
❑ Se usar conectividade UDBC tipo 2, defina as variáveis de ambiente adequadas para DB2,
conforme mostrado na tabela a seguir.
DescriçãoVariável do ambiente
O diretório de nível superior que contém o software cliente do
banco de dados ou toda a instalação do banco de dados.
DB2DIR
Guia de instalação e configuração 45
Capítulo 4: Preparação para a instalação
DescriçãoVariável do ambiente
O caminho da biblioteca de carregamento. É necessário
adicionar o local do driver e indicar os arquivos de 32 ou 64
bits conforme apropriado para o servidos de aplicativos.
LD_LIBRARY_PATH
Por exemplo (substitua ## por 32 ou 64 conforme apropriado),
LD_LIBRARY_PATH= $DB2_location/sqllib/lib##: $LD_
LIBRARY_PATH
Exemplos (substitua ## por 32 ou 64, conforme apropriado):
Para Solaris e Linux
LD_LIBRARY_PATH= $DB2DIR/lib##: $LD_LIBRARY_
PATH
Para AIX®:
LIBPATH=$DB2DIR/lib##:$LIBPATH
Para o HP-UX:
SHLIB_PATH=$DB2DIR/lib##:$SHLIB_PATH
A conexão padrão do servidor de banco de dados.DB2INSTANCE
A definição dessa variável de ambiente opcional a um valor
de 1208 oferece suporte para bancos de dados multilíngües.
DB2CODEPAGE
Para obter informações sobre a utilização dessa variável de
ambiente, consulte a documentação do DB2.
❑ Utilize o UTF-8 como o valor de conjunto de códigos ao criar o banco de dados.
Para verificar se o banco de dados tem o conjunto de códigos correto, utilizando a interface de
linha de comando, digite o seguinte no prompt de comando:
db2 get database configuration for database_name
O valor de conjunto de código deve ser UTF-8 e o valor da página de código deve ser 1208.
❑ Certifique-se de definir os parâmetros de configuração conforme mostrado na tabela a seguir.
DefiniçãoPropriedade
1.024 KBTamanho da memória temporária do
aplicativo Se o valor do tamanho da memória temporária
do aplicativo for muito pequeno, erros de falta
de memória podem ocorrer quando houver
muitos usuários.
(applheapsz)
46 IBM Cognos Business Intelligence PowerPlay
Capítulo 4: Preparação para a instalação
DefiniçãoPropriedade
240 segundosTempo limite de bloqueio (locktimeout)
Não defina esta opção com um valor de limite de
tempo infinito.
SIMVariável de registro DB2 (DB2_INLIST_
TO_NLJN) Definir essa variável como SIM melhora o
desempenho.
❑ Crie um pool de buffer com um tamanho de página de 32 KB e um segundo com um tamanho
de página de 4 KB.
❑ Crie um tablespace temporário de sistema utilizando o pool de buffer de 32 KB criado na etapa
anterior.
❑ Crie um tablespace temporário de usuário utilizando o pool de buffer de 4 KB criado.
Serão criadas tabelas temporárias globais no tablespace temporário do usuário.
❑ Crie um tablespace comum de usuário utilizando o pool de buffer de 4 KB criado.
Se estiver criando um banco de dados de log, crie um tablespace de usuário comum adicional
com um tamanho de página de 8 KB.
❑ Conceda os seguintes privilégios de banco de dados para a conta de usuário que o IBM Cognos BI
utilizará para acessar o banco de dados:
● conectar ao banco de dados
● criar tabelas
● criar esquemas implicitamente
Dica: se desejar hospedar mais de um armazenamento de conteúdo na instância do DB2 e for
usar mais de um por vez, use uma conta de usuário diferente para cada armazenamento de
conteúdo, para garantir que cada instância do IBM Cognos BI esteja completamente isolada
da outra.
❑ Certifique-se que a conta do usuário tenha privilégios de uso para o tablespace de usuário
temporário e outros tablespaces adequados associados com o banco de dados.
❑ Crie um esquema para a conta de usuário que o IBM Cognos BI irá utilizar para acessar o
banco de dados e verifique se o usuário tem permissões para criar, soltar e alterar o esquema.
❑ Crie um perfil que utilize o sqllib/db2profile do diretório inicial do usuário do DB2. Por exemplo,
o conteúdo do .profile será similar ao seguinte:
if [ -f /home/db2user/sqllib/db2profile ]; then
./home/db2user/sqllib/db2profile
fi
Guia de instalação e configuração 47
Capítulo 4: Preparação para a instalação
❑ O administrador do banco de dados deve fazer o backup dos bancos de dados do IBM Cognos
BI regularmente, pois estes contêm os dados do IBM Cognos. Para garantir a segurança e
integridade dos bancos de dados, proteja-os de acesso não autorizado ou inadequado.
Configurações sugeridas para criar um armazenamento de conteúdo no DB2 emz/OS
O banco de dados criado para o armazenamento de conteúdo deve conter as definições de
configuração especificadas.
Para garantir uma instalação com sucesso, siga as seguintes diretrizes ao criar o armazenamento
de conteúdo.
Orientações para criar um armazenamento de conteúdo no DB2 em z/OS
Utilize a seguinte lista de verificação para ajudá-lo a configurar o armazenamento de conteúdo no
DB2® no z/OS®.
❑ Faça login no sistema z/OS como um usuário com privilégios de administrador no DB2
(autoridade DBADM) em z/OS.
❑ Crie uma instância do banco de dados, um grupo de armazenamento e uma conta de usuário
para o armazenamento de conteúdo.
O usuário deve ter permissões para criar e excluir tabelas no banco de dados.
O IBM® Cognos® Business Intelligence usa as credenciais da conta do usuário para se comunicar
com o servidor de banco de dados.
❑ Certifique-se de reservar um pool de buffer com um tamanho de página de 32 KB e um segundo
com um tamanho de página de 4 KB para a instância do banco de dados.
❑ Os administradores devem executar um script para criar tablespaces para manter objetos grandes
e outros dados para o armazenamento de conteúdo, e conceder ao usuário direitos para usar
esses espaços. Para obter mais informações sobre como executar o script, consulte "Criação
de tablespaces para um armazenamento de conteúdo DB2 em z/OS" (p. 94 ).
❑ O administrador do banco de dados deve fazer o backup dos bancos de dados do IBM Cognos
BI regularmente, pois estes contêm os dados do IBM Cognos. Para garantir a segurança e
integridade dos bancos de dados, proteja-os de acesso não autorizado ou inadequado.
Configurações sugeridas para criar o armazenamento de conteúdo no OracleO banco de dados criado para o armazenamento de conteúdo deve conter as definições de
configuração especificadas.
Para garantir uma instalação com sucesso, siga as seguintes diretrizes ao criar o armazenamento
de conteúdo. Use as mesmas diretrizes para criar um banco de dados para registrar mensagens.
Orientações para criar o armazenamento de conteúdo no Oracle
Utilize a lista de verificação a seguir para ajudar na configuração do armazenamento de conteúdo
no Oracle.
48 IBM Cognos Business Intelligence PowerPlay
Capítulo 4: Preparação para a instalação
❑ Certifique-se de que o parâmetro para o nível de compatibilidade da instância de banco de
dados esteja configurado para 9.0.1 ou mais alto.
Por exemplo, é possível marcar a configuração do parâmetro de inicialização COMPATIBLE
emitindo a seguinte declaração SQL:
SELECIONE nome, valor, descrição DE v$parameter WHERE name='compatible';
Para obter informações sobre como alterar um parâmetro de configuração de instância, consulte
a documentação do Oracle.
❑ Determine se o banco de dados é Unicode.
Dica: Uma maneira é digitar a seguinte expressão selecionada:
select * from NLS_DATABASE_PARAMETERS
Se o conjunto de resultados gerar um NLS_CHARACTERSET que não seja Unicode, crie um
novo banco de dados e especifique AL32UTF8 nos parâmetros de conjunto de caracteres do
banco de dados.
❑ Determine qual conta de usuário será usada para acessar o banco de dados.
Dica: se deseja hospedar mais de um armazenamento de conteúdo na instância do Oracle e for
usar os dois ao mesmo tempo, use uma conta de usuário diferente para cada armazenamento
de conteúdo, a fim de garantir que cada instância do IBM® Cognos® Business Intelligence esteja
completamente isolada uma da outra.
❑ Certifique-se de que a conta de usuário que acessa o banco de dados tenha permissão para
executar o seguinte:
● Conectar-se ao banco de dados.
● Criar, alterar e soltar acionadores, visualizações, procedimentos e seqüências.
● criar e alterar tabelas
● Inserir, atualizar e excluir dados das tabelas do banco de dados.
❑ O administrador do banco de dados deve fazer o backup dos bancos de dados do IBM Cognos
BI regularmente pois estes contêm os dados do Cognos. Para garantir a segurança e integridade
dos bancos de dados, proteja-os de acesso não autorizado ou inadequado.
Configurações sugeridas para criar o armazenamento de conteúdo no MicrosoftSQL Server
O banco de dados criado para o armazenamento de conteúdo deve conter as definições de
configuração especificadas.
Para garantir uma instalação com sucesso, siga as seguintes diretrizes ao criar o armazenamento
de conteúdo. Use as mesmas diretrizes para criar um banco de dados para registrar mensagens.
Configurações sugeridas para Microsoft SQL Server
Utilize a seguinte lista de verificação para ajudá-lo a configurar o armazenamento de conteúdo no
Microsoft® SQL Server.
Guia de instalação e configuração 49
Capítulo 4: Preparação para a instalação
❑ Verifique se a seqüência de intercalação faz distinção entre maiúsculas e minúsculas.
Na instalação personalizada, escolhe-se uma intercalação, que inclui definições de caracteres
e ordem de classificação, durante a configuração do SQL Server. Na instalação típica, a
localidade identificada pelo programa de instalação é usada para a intercalação. Esta definição
não pode ser alterada mais tarde.
❑ Quando se conectar ao Microsoft SQL Server Management Studio para criar o banco de dados,
utilize autenticação de servidor SQL.
Ao se conectar usando uma autenticação do sistema operacional Microsoft® Windows®, o
banco de dados criado também usará a autenticação do Windows. Nesse caso, é necessário
configurar a conexão de banco de dados usando um tipo de banco de dados do Banco de dados
SQL Server (Autenticação do Windows) no IBM® Cognos® Configuration.
❑ Para a conta de usuário que será utilizada para acessar o banco de dados, crie um novo login
em Segurança e utilize as seguintes configurações:
● Selecione Autenticação do SQL Server.
● Desmarque a caixa de seleção Enforce password policy.
Dica: se deseja hospedar mais de um armazenamento de conteúdo na instância do Microsoft
SQL Server e for usá-los ao mesmo tempo, utilize uma conta de usuário diferente para cada
armazenamento de conteúdo a fim de garantir que cada instância do IBM Cognos Business
Intelligence fique completamente isolada.
❑ Para o Microsoft SQL Server 2008, conceda permissão de EXECUÇÃO à conta de usuário que
acessa o banco de dados.
❑ Para o banco de dados de armazenamento de conteúdo, crie um novo banco de dados em
Bancos de dados.
❑ Em Segurança para o novo banco de dados, crie um novo esquema e atribua um nome a ele.
❑ Em Segurança para o novo banco de dados, crie um novo usuário com as seguintes configurações:
● Para Nome de logon, especifique o novo login criado para a conta de usuário.
● Para Esquema padrão, especifique o novo esquema.
● Para Owned Schemas, selecione o novo esquema.
● Para Role Members, selecione db_datareader, db_datawriter e db_ddladmin.
Configurações sugeridas para criar o armazenamento de conteúdo no IBM InformixDynamic Server Database
O banco de dados criado para o armazenamento de conteúdo deve conter as definições de
configuração especificadas.
Use as diretrizes a seguir ao criar o armazenamento de conteúdo. Use as mesmas diretrizes para
criar um banco de dados para registrar mensagens.
50 IBM Cognos Business Intelligence PowerPlay
Capítulo 4: Preparação para a instalação
Configurações sugeridas para o Informix Dynamic Server Database
Utilize a seguinte lista de verificação para ajudar na configuração do armazenamento de conteúdo
do banco de dados IBM® Informix® Dynamic Server.
❑ Defina as seguintes variáveis de ambiente:
● GL_USEGLU - Para ativar a funcionalidade International Components for Unicode (ICU)
no Informix Dynamic Server, defina o valor como 1.
● DB_LOCALE - Para definir a localidade do banco de dados, especifique en_us.utf8.
❑ No arquivo ONCONFIG.nome_da_instância, defina a propriedade SHMBASE para
0x14000000L.
❑ Crie dois sbspaces chamados CMDATASPACE e CMOBJPROPS7SPACE, com o login ativado.
❑ Crie um banco de dados no modo ANSI e com o login ativado.
❑ Para a conta de usuário utilizada para acessar o banco de dados, conceda o privilégio de banco
de dados DBA.
Importante: se hospedar mais de um banco de dados na instância Informix e usar os dois ao
mesmo tempo, use uma conta de usuário diferente para cada banco de dados. Também é
necessário definir a conta de usuário em cada instância do aplicativo IBM Cognos® Configuration
criando um parâmetro de propriedade avançada e especificando a conta de usuário como o
valor. Para vários bancos de dados de armazenamento de conteúdo, atribua o nome
CMSCRIPT_CS_ID à propriedade. Para vários bancos de dados de log, atribua o nome
IPFSCRIPTIDX à propriedade.
Configurações sugeridas para criar o armazenamento de conteúdo no SybaseO banco de dados criado para o armazenamento de conteúdo deve conter as definições de
configuração especificadas.
Para garantir uma instalação com sucesso, siga as seguintes diretrizes ao criar o armazenamento
de conteúdo. Use as mesmas diretrizes para criar um banco de dados para registrar mensagens.
Configurações sugeridas para Sybase
Utilize a lista de verificação a seguir para ajudar na configuração do armazenamento de conteúdo
no Sybase.
❑ No servidor Sybase, crie uma instância de servidor com um tamanho de página de servidor de
8 KB.
Para obter instruções, consulte a documentação do Sybase.
❑ Se necessário, instale o jConnect 6.
Essa ferramenta configura a comunicação entre o driver JDBC e a instância do Sybase Adaptive
Server.
Para obter instruções, consulte a documentação do Sybase.
Guia de instalação e configuração 51
Capítulo 4: Preparação para a instalação
Se a versão do Sybase não incluir o JConnect 6, será necessário fazer o download do instalador
no site da Sybase.
❑ Adicione o conjunto de caracteres UTF-8 na instância do servidor.
❑ Se necessário, torne UTF-8 o conjunto de caracteres padrão do servidor.
❑ Crie um dispositivo de banco de dados.
Dica: Configure log_segment com um mínimo de 10 MB.
❑ Configure o novo dispositivo de banco de dados como o padrão.
Informações sobre o novo banco de dados serão armazenadas no novo dispositivo de banco
de dados. Mantenha um backup do dispositivo de banco de dados para fins de recuperação.
❑ Crie o banco de dados.
❑ Determine qual conta de usuário será usada para acessar o banco de dados.
Dica: se deseja hospedar mais de um armazenamento de conteúdo na instância do Sybase e for
usá-los ao mesmo tempo, utilize uma conta de usuário diferente para cada armazenamento de
conteúdo a fim de garantir que cada instância do IBM® Cognos® Business Intelligence fique
completamente isolada.
❑ Certifique-se de que a conta de usuário tenha os seguintes privilégios para o banco de dados:
criar padrão, criar procedimento, criar regra, criar tabela e criar visualização.
❑ Verifique se o banco de dados tem as seguintes configurações e se é reiniciado:
● privilégios de criação e descarte de tabela para a conta de usuário
● a propriedade Select into está definida como True
Configuração de contas de usuário ou contas de serviço de redeno IBM Cognos Business Intelligence
É possível configurar uma conta de usuário ou uma conta de serviços de rede no IBM® Cognos®
Business Intelligence.
A conta de usuário ou de serviço de rede em que o IBM Cognos BI é executado deve:
● Ter acesso a todos os recursos necessários, como impressoras.
● Ter direitos de fazer logon como um serviço e atuar como parte do sistema operacional.
Além disso, a conta de usuário deve ser membro do grupo administrador local.
Por exemplo, para imprimir relatórios usando uma impressora de rede, a conta deve ter acesso a
essa impressora, ou deve-se atribuir uma conta de logon para o serviço do IBM Cognos.
Configuração de contas de usuário
No sistema operacional Microsoft® Windows®, designe uma conta de logon para o serviço do IBM
Cognos. É possível configurar o serviço do IBM Cognos para utilizar uma conta de usuário especial
52 IBM Cognos Business Intelligence PowerPlay
Capítulo 4: Preparação para a instalação
selecionando o serviço do IBM Cognos da lista de serviços exibida na janela Serviços no Windows.
Em seguida, pode-se definir as propriedades da conta de usuário.
Nos sistemas operacionais UNIX® ou Linux®, crie um novo grupo no UNIX ou no Linux chamado
ibmcognos. Esse grupo deve conter o usuário que possui os arquivos do IBM Cognos. Altere a posse
do grupo dos arquivos IBM Cognos para o grupo ibmcognos, e as permissões de arquivo de todos
os arquivos do IBM Cognos para GROUP READABLE/WRITABLE/EXECUTABLE.
Configure o servidor web para utilizar aliases. Para obter mais informações, consulte o tópico sobre
configuração do servidor web.
Configuração de contas de serviço de rede
A conta de serviço de rede é a conta NT AUTHORITY\NetworkService incorporada no sistema
operacional. Os administradores não precisam gerenciar uma senha ou manter a conta.
Utilize uma conta com privilégios de administrador se estiver fazendo a instalação no Windows
Server 2008
Configure o servidor web para utilizar pool de aplicativos. Para obter mais informações, consulte
o tópico sobre configuração do servidor web. Também é necessário ter permissões de gravação
para fazer instalações no diretório.
Configuração de navegadores webOs produtos do IBM® Cognos® Business Intelligence usam as configurações padrão do navegador.
As configurações adicionais solicitadas são específicas para o navegador.
A seguinte tabela mostra as configurações que devem ser habilitadas.
Definições do navegador exigidas para o portal do IBM Cognos BI
Componente do IBM CognosDefiniçãoNavegador
IBM Cognos ConnectionPermitir cookiesInternet Explorer®
(configurações para
studios e portais)IBM Cognos Administration
Cognos Viewer
Criação ativa de scripts
Permissão de META REFRESH
Event Studio
PowerPlay® Studio
IBM Cognos ConnectionPermitir cookiesFirefox®
IBM Cognos AdministrationAtivar JavaTM
Cognos ViewerAtivar JavaScript
Report StudioCarregar imagens
Analysis Studio
PowerPlay Studio
Guia de instalação e configuração 53
Capítulo 4: Preparação para a instalação
Caso o Adblock Plus esteja instalado com o Firefox, desative-o utilizando a opção por página. O
Adblock Plus impede alguns recursos do IBM Cognos Connection de funcionar adequadamente.
Se o Microsoft Internet Explorer versão 8 for usado, poderão ocorrer erros no link do Adobe™
quando os documentos PDF forem abertos no portal do IBM Cognos. Para impedir que esses erros
ocorram, no Internet Explorer, no menu Ferramentas, selecione Gerenciar Complementos e desative
o Adobe PDF Reader Link Helper.
Se você usar um navegador da Web do Microsoft Internet Explorer, poderá adicionar o URL para
o(s) gateway(s) à lista de Sites confiáveis. Por exemplo, http://<server_name>:<port_number>/
ibmcognos. Isso permite o prompt automático com relação a downloads de arquivos.
Para obter mais informações, consulte "Configuração dos componentes do IBM Cognos para uso
no IBM Cognos Application Firewall" (p. 244 ).
Para obter mais informações, consulte o tópico sobre como configurar o IBM Cognos Application
Firewall no Guia de instalação e configuração.
O IBM Cognos BI usa os seguintes cookies para armazenar informações de usuário.
Cookies usados pelos componentes do IBM Cognos BI
FinalidadeTipoCookie
Criado se o IBM Cognos BI estiver configurado para usar um
namespace do IBM Cognos Series 7
Sessão temporáriaAS_TICKET
Contém informações de segurança de estadoSessão temporáriacaf
Armazena uma referência a uma sessão de usuário guardada no
servidor do Content Manager.
Sessão temporáriaCam_passport
Mantém informações de sessão específicas do IBM Cognos
Connection
Sessão temporáriacc_session
Mantém as informações durante as operações de edição, tais como
recortar, copiar e colar.
Sessão temporáriacc_state
Contém as informações de conteúdo e localidade do produto, e é
configurado para todos os usuários do IBM Cognos
Sessão temporáriaCRN
Armazena a escolha que o usuário faz para "exibir pasta dos
membros" no Report Studio
PersistenteCRN_RS
Armazena o caminho da pasta atual se for usado o acesso de arquivo
local, e é atualizado após as caixas de diálogo Abrir ou Salvar forem
usadas
PersistentePAT_CURRENT_
FOLDER
Armazena informações de sessão específicas do PowerPlay StudioSessão temporáriapp_session
54 IBM Cognos Business Intelligence PowerPlay
Capítulo 4: Preparação para a instalação
FinalidadeTipoCookie
Armazena as configurações feitas pelo usuário para elementos de
interface como menus e barras de ferramentas
Persistenteqs
Contém todos os recursos e a assinatura do usuário atualSessão temporáriauserCapabilities
Contém um identificador de sessão de usuário exclusivo, válido para
a duração da sessão do navegador.
Sessão temporáriausersessionid
Esses cookies armazenam as preferências para exportar para PDF.Sessão temporáriaFrameBorder
PageOrientation
PageSize
PDFLayerDimension
PDFOPTS
Armazena a configuração que determina se deve exibir ou ocultar a
barra de ferramentas de exibição da dimensão.
PersistenteDimTreeToolbar
Visible
Armazena a configuração que determina se as informações de sessão
do usuário são compartilhadas com outros componentes do IBM
Cognos BI.
Sessão temporáriacea-ssa
Armazena informações usadas para determinar a resolução de tela
a ser usada para processar gráficos.
Sessão temporáriaBRes
Após atualizar ou instalar um novo software, reinicie o navegador web e avise aos usuários para
limparem o cache de seus navegadores.
Guia de instalação e configuração 55
Capítulo 4: Preparação para a instalação
56 IBM Cognos Business Intelligence PowerPlay
Capítulo 4: Preparação para a instalação
Capítulo 5: Atualização para o IBMCognos PowerPlay
As novas versões do IBM® Cognos® PowerPlay® oferecem aprimoramentos que podem afetar muitos
componentes, como recursos e funcionalidades de produtos, desempenho, escalabilidade e
usabilidade. Devido a essas melhorias, a atualização pode não ser simples e deve ser considerada
um processo a ser realizado em etapas.
Se estiver atualizando o PowerPlay e outros componentes do IBM Cognos Business Intelligence,
consulte o Guia de instalação e configuração do IBM Cognos BI para obter informações de
atualização para os componentes do IBM Cognos BI, como o Framework Manager.
Deve-se considerar a atualização um projeto de TI que requer planejamento cuidadoso, tempo
adequado e recursos.
Ao atualizar, duas atividades distintas são realizadas:
1. Instalação da nova versão do produto.
2. Mover aplicativos para a nova versão do produto.
Instalação da nova versão do produto
É possível instalar a nova versão do produto no mesmo local que a versão existente após a
desinstalação, ou em um novo local.
Primeiro faça a instalação em uma nova localização, como um ambiente de teste. Isto o permite
testar seus aplicativos nos ambientes novo e antigo, para garantir que funcionam como esperado
ao atualizar. Compare a aparência e funcionalidade dos relatórios em ambos os ambientes para
que haja equivalência.
Como mover o conteúdo para o novo ambiente
Como parte do processo de atualização, verifique se seus aplicativos funcionam como esperado na
nova versão. Às vezes, as alterações podem causar resultados inesperados. É importante testar seus
aplicativos antes de movê-los.
No IBM Cognos BI, quando um conteúdo é movido de um ambiente para outro, o que se está
fazendo é uma implantação.
Grupos diferentes em geral estão envolvidos em cada uma dessas atividades. Como parte do projeto,
é necessário avaliar o ambiente de IT e seus aplicativos separadamente, para verificar se a infra-
estrutura consegue suportar seus objetivos de negócios.
Caso possua conteúdo do IBM Cognos Series 7, é possível mover uma parte desse conteúdo para
o IBM Cognos BI utilizando ferramentas de migração disponíveis em uma instalação separada.
Se estiver usando versões anteriores do ReportNet®, Metrics Manager, IBM Cognos for Microsoft®
Office ou Transformer, será possível atualizar o conteúdo para o IBM Cognos BI. Também é possível
Licensed Materials – Property of IBM57© Copyright IBM Corp. 2005, 2010.
fazer a atualização de versões anteriores do IBM Cognos BI, incluindo versões completas e de
manutenção (MR).
Processo de atualização
O diagrama a seguir mostra a abordagem para atualização. O diagrama mostra os estágios do
processo de atualização. Antes de começar, a atualização é planejada, os aplicativos que deseja
atualizar são avaliados e um ambiente de teste é criado. É necessário implantar e testar repetidamente
o conteúdo dos ambientes de origem e de destino, antes de mover aplicativos atualizados para um
ambiente de produção com sucesso.
Fluxo de trabalho do processo de atualização
Planejamentoda atualização
1Novo ambiente
Criação de novoambiente
3
Teste deaplicativosatualizados
5
6Mover para o ambiente de produção
Processo de implantação4
PlanoExportaçãode conteúdoexistente
Cópia paranovoambiente
Importaçãode conteúdo Teste
Preparaçãodo ambiente
Backup dearquivos Desinstalação
Instalaçãode novaversão
Implantaçãode ambientede teste
Ambiente de origem
Avaliação deaplicativos
2
Em alguns casos de atualização, podem ser necessárias outras tarefas. Por exemplo, se usar aplicativos
Software Development Kit que dependem das especificações do relatório, será necessário atualizar
esses aplicativos antes de atualizar as mesmas. Se estiver atualizando do ReportNet 1.1 MR3 ou
MR4 ou de qualquer versão anterior do IBM Cognos BI, será possível utilizar o LifeCycle Manager
para automatizar algumas tarefas no estágio de atualização de teste.
Consulte os tópicos a seguir para obter informações sobre a atualização:
❑ Planejamento da atualização
❑ Atualização de uma versão anterior do IBM Cognos PowerPlay
Planejamento da atualizaçãoPlaneje a atualização de forma que saiba o que esperar em cada etapa do processo. No estágio de
planejamento, reveja a documentação de atualização para informações sobre comportamento
esperado, novos recursos, recursos substituídos, compatibilidade entre versões e exigências para
preparar seu ambiente de produção. Quando terminar a revisão, conduza uma pesquisa local para
identificar a infra-estrutura do BI, aplicativos, relatórios e definições de configuração personalizadas.
Finalmente, teste a atualização em um subconjunto de dados de modo a sintonizar os relatórios e
dados antes de comprometer-se com a atualização completa.
O diagrama a seguir mostra uma visualização de alto nível das fases de um projeto de atualização.
58 IBM Cognos Business Intelligence PowerPlay
Capítulo 5: Atualização para o IBM Cognos PowerPlay
Criação deambientede teste
2
Implantaçãode conteúdo
3Ambiente de origem
1Avaliação deconteúdo
Teste deaplicativosatualizados
4Novo ambiente
Migração paraprodução
5
Planejamentoda atualização
Ao planejar uma atualização, verifique se
● Reuniu as informações necessárias, como as entradas e saídas necessárias de cada fase.
● Avaliou os aplicativos no ambiente de relatórios e agrupou os relatórios semelhantes.
● Instalou o novo software em um ambiente de teste e implantou o conteúdo a esse ambiente.
● Testou os aplicativos atualizados para garantir que os relatórios sejam executados como o
esperado.
A implantação e o teste são em geral um processo repetitivo. Avalie diferenças entre os ambientes
de origem e destino para determinar atividades de ação. Vá até seu ambiente de produção quando
estiver certo de que os aplicativos implantados tenham correspondido às suas exigências de negócios.
Não altere os provedores de segurança, como mudar de um namespace do IBM® Cognos® Series 7
para o Active Directory como parte do processo de atualização. É necessário encarar este processo
como um projeto separado.
Verifique se possui as habilidades disponíveis, como recursos internos ou externos. Verifique também
o hardware necessário antes de começar.
Utilize a seguinte lista de verificação para guiá-lo através do processo de planejamento:
❑ Revisão da documentação.
❑ Avaliação dos aplicativos no ambiente de origem.
❑ Realização de uma atualização experimental, que inclui as seguintes tarefas:
● Criação do ambiente de teste.
● Planejamento da implantação do conteúdo do ambiente de origem para o de teste.
● Criação de especificações da implantação de exportação.
● Cópia da especificação da implantação no ambiente de teste.
● Inclusão de objetos de configuração para importação, se solicitado
● Importação de especificações de implantação no ambiente de teste do Cognos BI.
● Teste do conteúdo atualizado.
❑ Mover para o ambiente de produção
Guia de instalação e configuração 59
Capítulo 5: Atualização para o IBM Cognos PowerPlay
Revisão da documentaçãoA documentação é fornecida a partir de uma variedade de fontes para ajudá-lo a completar uma
atualização com êxito. Toda a documentação está disponível on-line no site do IBM® Cognos®
Customer Service Center (http://www.ibm.com/software/data/support/cognos_crc.html).
Etapas
1. Leia a seção "O que há de novo?" neste guia (p. 15 ).
Essa seção contém uma lista de recursos novos, alterados, substituídos e removidos para esta
versão.
2. Leia o restante das Informações de atualização neste documento.
3. Leia o tópico sobre o IBM Cognos BI com outros produtos do IBM Cognos (p. 33 ).
Ele contém informações sobre outros produtos do IBM Cognos que podem existir em seu
ambiente e que devem ser considerados na atualização.
4. No link Documentation no IBM Cognos Customer Service Center (http://www.ibm.com/
software/data/support/cognos_crc.html), faça o download e veja as últimas versões da
documentação listada na tabela a seguir:
DescriçãoDocumento
Problemas recentes que podem afetar a atualização.Notas de versão do IBM
Cognos PowerPlay
Novos recursos que podem afetar o comportamento do
conteúdo existente.
Novos recursos do IBM
Cognos Business Intelligence
Modelos de atualização.Framework Manager UserGuide
Atualização de visualizações de usuário e de modelos do IBM
Cognos Series 7.
Guia do usuário do IBM
Cognos Transformer
Mover metadados, catálogos e relatórios Impromptu, relatórios
do PowerPlay® e conteúdo do Upfront do IBM Cognos Series 7
para o IBM Cognos BI
IBM Cognos Migration
Assistant User Guide
Como usar o Lifecycle Manager para fazer auditoria em
atualizações experimentais do ReportNet® 1.1 MR3 ou MR4
para o IBM Cognos BI, Versão 8.2 ou mais recente
IBM Cognos Lifecycle
Manager User Guide
Atualização dos aplicativos do Software Development KitIBM Cognos Software
Development Kit DeveloperGuide
60 IBM Cognos Business Intelligence PowerPlay
Capítulo 5: Atualização para o IBM Cognos PowerPlay
Recomendação - Avaliação dos aplicativos no ambiente de origemO preparo da atualização oferece uma oportunidade de revisar o investimento atual do BI, e limpar
seu ambiente de origem. Faça um inventário de seus aplicativos do BI para compreender os pontos
fortes e fracos e áreas de melhoria em seu ambiente.
Por exemplo, pode haver centenas de relatórios, pacotes, pastas públicas e aplicativos em seu
ambiente. No entanto, não é difícil verificar que vários aplicativos não são usados, não correspondem
mais às exigências da empresa ou não atuam nos ambientes de origem.
Realize uma auditoria dos aplicativos para determinar que aplicativos devem ser atualizados. A
avaliação e a redução do número de relatórios é um exercício útil. Não confie somente na resposta
do usuário para determinar qual conteúdo é utilizado.
Uma auditoria dos aplicativos existentes pode incluir o seguinte:
❑ Faça uma pesquisa local.
Uma pesquisa irá ajudá-lo a avaliar o ambiente de produção atual e identificar as áreas que
requerem atenção durante uma atualização. A pesquisa no local deve incluir informações sobre
a infra-estrutura, os aplicativos, os usuários e as definições de configuração para os produtos
IBM® Cognos® BI.
❑ Avalie o software usado em seu aplicativo de relatórios.
Liste o software, como sistemas operacionais, servidores web, segurança, bancos de dados e
etc. Compare a lista às versões suportadas para sua versão de atualização de destino, disponível
nos links Production Information e Software Environments no site do IBM Cognos Customer
Service Center (http://www.ibm.com/software/data/support/cognos_crc.html). Determine se os
componentes requerem atualização.
❑ Liste seus aplicativos BI, incluindo o seguinte:
● Modelos do Framework Manager.
● Pacotes publicados.
● relatórios
● Modelos do Transformer.
● Aplicativos do Software Development Kit e suas dependências
❑ Complete uma avaliação detalhada de seus aplicativos.
A utilização, idade, o tamanho e a complexidade de seus aplicativos são fatores importantes
de se considerar ao planejar a atualização. O tamanho total dos aplicativos pode ter um impacto
no tempo necessário para completar a atualização.
❑ Liste todos os relatórios contidos em seu aplicativo e faça o seguinte:
● Entreviste os membros da equipe para ver quais cubos, visualizações ou relatórios são
necessários e usados, quais podem ser consolidados e quais podem ser eliminados. Use os
dados de auditoria de relatório para determinar a utilização do relatório.
Guia de instalação e configuração 61
Capítulo 5: Atualização para o IBM Cognos PowerPlay
Atualize somente os relatórios que funcionam e de que os usuários precisam e que utilizam.
Este procedimento reduz o número de aplicativos que são necessários atualizar.
Para obter mais informações sobre a auditoria de relatórios, consulte o Guia de
administração e segurança.
● Veja a finalidade de cada relatório e atribua uma prioridade.
Isto identifica os aplicativos de negócios cruciais e as funcionalidades exigidas no novo
ambiente.
● Marque os relatórios que não conseguiram ser executados ou valide no ambiente atual.
É possível que esses sejam não atualizados com sucesso. Conserte esses relatórios para que
sejam atualizados.
● Considere afastar os relatórios que não são utilizados ou pouco utilizados.
● Agrupe os relatórios em categorias, como atualizados, eliminados, não mais usados e não
atualizados,
❑ Liste as seguintes informações sobre suas configurações:
● Definições de configuração ativadas usando o IBM Cognos Configuration.
Essas configurações são preservadas na atualização, e são armazenadas em dois arquivos.
Para ReportNet® v1.1, os arquivos são crnstartup.xml e crnlocale.xml. No IBM Cognos BI,
são cogstartup.xml e coglocale.xml.
● Alterações em outros arquivos de configuração.
Alterações em outros arquivos devem ser feitas manualmente durante a atualização. Se
alterou outros arquivos de configuração. avalie as alterações que deseja preservar no
ambiente atualizado. Podem ser incluídos arquivos .xml, .txt e .css na configuração, nos
modelos, webapps e diretórios de conteúdo web do local de instalação.
Observe que não são suportadas alterações em arquivos .ini. Se alterou arquivos .ini, entre
em contato com o suporte ao cliente.
❑ Faça um backup de relatórios, modelos, dados e arquivos de configuração.
❑ Crie um plano de atualização.
Recomendação - Realização de uma atualização experimentalOs projetos-piloto de atualização são exercícios importantes e práticos pois garantem que a
atualização produza os resultados esperados e exigidos. Além disso, a avaliação do projeto-piloto
garante que a atualização tenha êxito. Se ocorrerem resultados inesperados, determine se as diferenças
são aprimoramentos para sua situação ou se é necessário tomar providências para aliviar as
diferenças.
Ao atualizar, os aplicativos geralmente funcionam no novo ambiente com pouca ou nenhuma
intervenção. Ao executar uma atualização piloto é possível validar relatórios selecionados para ver
se há resultados esperados.
62 IBM Cognos Business Intelligence PowerPlay
Capítulo 5: Atualização para o IBM Cognos PowerPlay
Execute uma atualização experimental várias semanas antes de atualizar o sistema de produção. A
atualização experimental identifica os componentes que serão atualizados com esforço mínimo, e
os componentes que podem requerer ações adicionais antes ou após a atualização.
Em geral, um conjunto de relatórios de amostra é atualizado em um ambiente isolado, e a aparência
a comportamento dos relatórios são comparados antes e após a atualização.
Verifique se recursos habilitados estão disponíveis para realizar o trabalho de migração, especialmente
para aplicativos cruciais à missão. Além disso, teste e depure todos os aplicativos antes da
implantação.
Se estiver atualizando do ReportNet® 1.1 MR3 ou MR4, será possível utilizar o LifeCycle Manager
para automatizar algumas tarefas no estágio de atualização de teste.
Criação do ambiente de testeCrie um ambiente de teste para o novo software em preparação de novas atualizações experimentais.
Inicialmente, o novo ambiente não precisa ser grande, ou igual a seu ambiente de produção. Por
exemplo, se for aceitável, é possível usar o hardware de ambientes existentes, como servidores de
desenvolvimento.
O ambiente pode ser ampliado ou extinto em fases após o novo ambiente básico estar construído
e em execução.
Outra opção é que os ambientes existentes permaneçam intocados. Se desejar que o ambiente de
teste se torne o novo ambiente de produção, configure o sistema de teste para corresponder a seu
ambiente de produção.
Etapas
1. Verifique se a infra-estrutura está no lugar certo.
2. Reveja os ambientes suportados.
3. Instale o novo software no ambiente de teste.
Ter a nova versão do software em um local diferente que o da versão mais antiga garante que
ambas as versões sejam executadas ao mesmo tempo e confirme que seus aplicativos funcionem
corretamente em ambos os ambientes.
Após ter instalado o software, execute o processo de implantação para atualizar o conteúdo. Para
obter mais informações, consulte a ajuda online do console do IBM Cognos Administration.
Planejamento da implantaçãoA implantação envolve a mudança de aplicativos de uma instalação para outra. No IBM® Cognos®
BI, são implantados pacotes, pastas de nível superior ou o armazenamento de conteúdo inteiro de
um ambiente de origem para um ambiente de destino.
Ao implantar, considere em como lidar com a segurança e se implantar todo o armazenamento de
conteúdo ou pacotes, pastas e conteúdo de diretório selecionados. Outras considerações são
relacionadas ao banco de dados do armazenamento de conteúdo, distribuição de relatórios e posse
de entradas.
Guia de instalação e configuração 63
Capítulo 5: Atualização para o IBM Cognos PowerPlay
Para obter mais informações sobre como planejar a implantação de conteúdo em um novo ambiente,
consulte a ajuda online do console de Administração.
O diagrama a seguir resume o processo de implantação.
Fluxo de trabalho do processo de implantação
Teste deaplicativosatualizados
5
Processo de implantação4
PlanoExportaçãode conteúdoexistente
Cópia paranovo
ambiente
Importaçãode conteúdo Teste
Segurança
Antes de implantar, considere as permissões de acesso e segurança de arquivos de implantação.
Para implantar entradas do IBM Cognos Connection, são necessárias as seguintes permissões:
● Execute as permissões do recurso seguro Tarefas de administração.
● Desvie as permissões da função segura Administração.
Também é necessário pertencer ao grupo Administradores de sistema, e possuir acesso de leitura e
gravação para o namespace do Cognos, pois desse modo é possível implantar esse grupo.
Para obter informações sobre como implantar grupos e funções do IBM Cognos, consulte a ajuda
on-line no console do IBM Cognos Administration.
Referências a namespaces
Algumas entradas, como grupos, funções, listas de distribuição, contatos, signons da fonte de dados
e algumas propriedades do relatório como destinatários de e-mail e contatos de relatório, podem
se referir a entidades de namespaces ou provedores de autenticação. Ao implantar pastas públicas
e conteúdo do diretório, é possível implantar essas entradas com ou sem referências a terceiros.
Implantação de todo o armazenamento de conteúdo
A implantação de todo o armazenamento de conteúdo garante que todos os pacotes, pastas e
conteúdos de diretórios sejam copiados em um novo local. Por exemplo, se estiver mudando o
computador em que o IBM Cognos BI está instalado, será possível mover o armazenamento de
conteúdo inteiro do ambiente antigo para o novo ambiente e manter todos os relatórios e outras
entradas que os administradores e os usuários criaram.
Ao importar o armazenamento de conteúdo inteiro, os dados de configuração serão incluídos na
exportação, mas excluídos da importação por padrão. Não altere essa definição. Contudo, se for
necessário importar definições de configuração (p. 68 ), será possível alterar o padrão nas
Configurações avançadas.
Implantação de pastas públicas e conteúdos de diretórios selecionados
É possível escolher fazer uma implantação parcial somente das pastas públicas selecionadas e
conteúdo de diretório.
64 IBM Cognos Business Intelligence PowerPlay
Capítulo 5: Atualização para o IBM Cognos PowerPlay
Escolha os pacotes e as pastas que deseja implantar navegando na hierarquia das Pastas públicas
e selecionando um pacote ou uma pasta. Uma vez selecionados pacote ou pasta, o conteúdo é
implantado. Não é possível selecionar entradas específicas em pacotes ou pastas. Durante a
exportação, os pacotes e pastas pais não serão exportados e o Content Manager não criará locais
de espaço reservado para eles no ambiente de destino. Durante a exportação e a importação,
especifique um novo local de destino na hierarquia do Content Manager para cada pacote e pasta
implantados.
Ao fazer uma exportação parcial de pastas públicas e conteúdo de diretório, são necessárias as
seguintes permissões:
● Permissões de leitura e desvio para as entradas exportadas.
● Permissões de gravação, pois se cria uma especificação e histórico de implantação ao exportar.
● Permissões de gravação e definição de diretivas para as entradas importadas.
Implantação de pacotes
O pacote é uma entrada que contém relatórios e metadados publicados. Os pacotes são salvos no
armazenamento de conteúdo e aparecem como entradas no IBM Cognos Connection.
Durante uma implantação parcial, é possível implantar um ou mais pacotes por vez. O pacote pode
fazer referência a objetos fora dele, como objetos de segurança, fontes de dados e listas de
distribuição. No entanto, os objetos referenciados não são implantados com o pacote.
Criação de especificações de implantação de exportaçãoApós planejar sua implantação, a primeira etapa para mover conteúdo de uma instalação a outra
é exportar o armazenamento de conteúdo ou as entradas que deseja manter em seu novo ambiente.
Para tal, cria-se uma especificação de implantação de exportação em seu ambiente de origem.
As entradas são exportadas para um arquivo de implantação de exportação no ambiente de origem.
Depois, importe as entradas do arquivo para o ambiente de destino. É possível atualizar as entradas
no ambiente de destino usando as entradas do arquivo de implantação.
Interrompa o serviço IBM® Cognos® BI no IBM Cognos Administration antes de exportar e importar.
Para obter mais informações, consulte o Guia de administração e segurança.
Etapas para criar uma nova especificação de implantação de exportações noarmazenamento de conteúdo
1. Em IBMCognos Administration, na guia Configuração, clique em Administração de Conteúdo.
2. Na barra de ferramentas, clique no botão nova exportação e siga as instruções no assistente
Nova exportação .
3. Para exportar todo o armazenamento de conteúdo, clique em Selecionar todo o Armazenamento
de Conteúdo e selecione se deseja ou não incluir informações de conta de usuário.
4. Clique em Avançar.
Guia de instalação e configuração 65
Capítulo 5: Atualização para o IBM Cognos PowerPlay
5. Se desejar proteger o arquivo, em Criptografia, clique em Definir a senha de criptografia, digite
uma senha, clique em OK, e clique em Avançar.
As informações de resumo aparecem.
6. Revise as informações de resumo e depois clique em Avançar.
Dica: Se desejar alterar as informações, clique em Voltar e siga as instruções.
7. Determine como deseja que a exportação seja executada selecionando a ação desejada.
Após executar a exportação, é possível mover o arquivo de implantação. Também é possível consultar
o histórico de execução de exportação.
Etapas para criar uma nova especificação de implantação de exportações paraimplantações parciais
1. Em IBMCognos Administration, na guia Configuração, clique em Administração de Conteúdo.
2. Na barra de ferramentas, clique no botão nova exportação e siga as instruções no assistente
Nova exportação .
3. Para exportar pastas específicas e conteúdo de diretório, clique em Selecionar pastas públicas
e conteúdo de diretório e em Avançar.
4. Na página Selecionar o conteúdo de pastas públicas, clique em Adicionar.
5. Na página Selecionar entradas, na caixa Entradas disponíveis, selecione os pacotes ou pastas
que deseja exportar.
Navegue na hierarquia de Pastas públicas e escolha os pacotes e pastas desejados. Clique no
botão de seta para a direita para mover os itens selecionados para a caixa de diálogo
Entradas selecionadas , e clique em OK.
6. Para cada pacote e pasta exportados, execute um dos procedimentos a seguir:
● Caso deseje fazer qualquer alteração ao pacote ou pasta no ambiente de destino, clique no
botão Editar faça as alterações, e clique em OK.
● Para restringir o acesso ao pacote ou pasta e às entradas correspondentes, assinale a caixa
de seleção na coluna Desativar após importação. Isso é útil quando desejar testar os
relatórios antes de disponibilizá-los no ambiente de destino.
7. Em Opções, selecione se deseja incluir as versões de saída de relatório, histórico de execução
e programações, e o que fazer com entradas em caso de conflito, e clique em Avançar.
8. Na página Selecionar o conteúdo de diretório, selecione se deseja exportar grupos e funções
do IBM Cognos, listas de distribuição e contatos e origens de dados e conexões e o que fazer
com as entradas em caso de conflito, e clique em Avançar.
9. Na página Especificar as opções gerais, selecione se incluir permissões de acesso e a quem deve
pertencer as entradas após serem importadas no ambiente de destino.
10. Especifique o Nível de registro do histórico de implantação, e clique em Avançar.
66 IBM Cognos Business Intelligence PowerPlay
Capítulo 5: Atualização para o IBM Cognos PowerPlay
11. Na página Especificar um arquivo de implantação, em Arquivo de implantação, selecione um
arquivo de implantação existente da lista ou digite um novo nome para criar um.
Se estiver digitando um novo nome para o arquivo de implantação, não use espaços no nome.
Se o nome da nova especificação de implantação corresponder ao nome de um arquivo de
implantação existente, o arquivo de implantação existente será sobrescrito.
12. Se desejar proteger o arquivo, em Criptografia, clique em Definir a senha de criptografia, digite
uma senha e clique em OK.
13. Clique em Avançar.
As informações de resumo aparecem.
14. Revise as informações de resumo e depois clique em Avançar.
Dica: Se desejar alterar as informações, clique em Voltar e siga as instruções.
15. Determine como deseja que a exportação seja executada selecionando a ação desejada.
Após executar a exportação, é possível mover o arquivo de implantação. Também é possível consultar
o histórico de execução de exportação.
Etapas para executar a exportação
1. Na coluna Ações , clique no botão executar com opções .
2. Clique em Agora para executar a exportação imediatamente ou clique em Depois, e digite a
hora em que deseja que a exportação seja executada.
Também é possível programar uma tarefa para ser executada em uma base recorrente e visualizar
uma lista das tarefas programadas utilizando a ferramenta de gerenciamento de programação.
Agora é possível mover o arquivo de implantação.
Cópia da especificação da implantação no ambiente de testeMova o arquivo de implantação criado no ambiente de origem para o ambiente de teste.
Posteriormente, o arquivo de implantação é usado para importar entradas no ambiente de destino.
Se os ambientes de origem e de teste usam o mesmo armazenamento de conteúdo, é possível importar
sem mover o arquivo de implantação.
A localização padrão é local_c10\deployment.
Caso planeje mover o arquivo de implantação para um local específico na rede LAN, certifique-se
de que haja espaço suficiente em disco. Se o arquivo de implantação não foi criptografado, é
recomendável copiá-lo para um local seguro.
Etapas para copiar a especificação da implantação
1. No ambiente de origem, copie a especificação de implantação do local dos arquivos de
implantação especificado na ferramenta de configuração para um local compartilhado comum
ou para uma mídia compartilhável.
Guia de instalação e configuração 67
Capítulo 5: Atualização para o IBM Cognos PowerPlay
No IBM® Cognos® Configuration, a propriedade Localização dos arquivos de implantação está
em Ambiente. Caso altere essa propriedade, a nova localização deve ser acessível para o serviço
do Content Manager ativo.
2. No ambiente de teste, copie a especificação de implantação do local compartilhado comum ou
de mídia compartilhável para o local dos arquivos de implantação especificado na ferramenta
de configuração.
Agora é possível fazer inclusão de objetos de configuração se estiver importando todo um
armazenamento de conteúdo ou importação para o ambiente de destino.
Inclusão de objetos de configuração na importação de todo o armazenamento deconteúdo
Inclua objetos de configuração ao importar todo o armazenamento de conteúdo. Por exemplo,
talvez seja necessário importar a configuração devido a uma série de definições avançadas desejadas
para seus serviços no ambiente de origem.
Por padrão, os objetos de configuração são excluídos ao importar todo o armazenamento de
conteúdo, mesmo se estiverem incluídos na exportação. Esses objetos incluem distribuidores e pastas
de configuração usados para agrupar distribuidores.
Etapas
1. Em IBM Cognos Administration, na guia Configuração, clique em Distribuidores e Serviços.
2. Clique no distribuidor desejado.
3. Ao lado de ContentManagerService, clique no botão definir propriedades.
4. Clique na guia Configurações.
5. Na coluna Valor, clique em Editar.
6. Assinale a caixa de seleção Substituir as configurações obtidas da entrada pai.
7. Na coluna Parâmetro apresentada, digite o seguinte em letras maiúsculas:
CM.DEPLOYMENTINCLUDECONFIGURATION
8. Na coluna Valor, digite verdadeiro.
9. Clique em OK para finalizar.
Importação para o ambiente de testeAs entradas do arquivo de implantação são importadas no ambiente de destino. Para importar
entradas, cria-se uma especificação da implantação de importações.
Ao importar, selecione entradas que foram exportadas. É possível aceitar as opções padrão definidas
durante a exportação ou alterá-las. É possível selecionar opções incluídas no arquivo de implantação
somente durante a exportação.
68 IBM Cognos Business Intelligence PowerPlay
Capítulo 5: Atualização para o IBM Cognos PowerPlay
Se realizar uma implantação parcial das pastas públicas específicas e do conteúdo do diretório, o
assistente de importação mostrará se os pacotes e pastas já existem no ambiente de destino, e a data
e a hora em que foram modificados da última vez. Use esta informação para ajudá-lo a decidir
como resolver conflitos. Ao implantar novamente, o assistente também mostrará se os pacotes e
pastas estavam na implantação original.
Etapas para importar a especificação da implantação
1. No ambiente de destino, em IBM Cognos Administration, na guia Configuração, clique em
Administração de Conteúdo.
2. Na barra de ferramentas, clique no botão nova importação .
O assistente Nova Importação será exibido.
3. Na caixa Arquivo de implantação, clique no arquivo de implantação que deseja importar.
4. Se o arquivo de implantação estiver criptografado, digite a senha e clique em OK.
5. Clique em Avançar.
6. Digite um nome exclusivo, uma descrição opcional e uma dica de tela para a especificação de
implantação, selecione a pasta onde deseja salvá-lo e clique em Avançar.
7. Selecione o conteúdo que deseja incluir na importação.
Dica: para garantir que o pacote ou a pasta de destino solicitados existam no armazenamento
de conteúdo de destino, clique no botão Editar próximo ao pacote e verifique o local. Se
desejar, altere o local de destino agora.
8. Selecione as opções desejadas, junto com sua escolha de solução de conflitos para essas opções.
9. Na página Especificar as opções gerais, selecione se incluir permissões de acesso e a quem deve
pertencer as entradas após serem importadas no ambiente de destino.
10. Especifique o Nível de registro para o histórico de implantação.
O nível padrão, Básico, salva informações de progresso e de resumo da implantação. Se quiser
apenas as informações de resumo, selecioneMínimo. Se quiser todos os detalhes da implantação,
selecione Rastreamento.
11. Clique em Avançar.
As informações de resumo aparecem.
12. Revise as informações de resumo e depois clique em Avançar.
13. Determine como deseja que a importação seja executada selecionando a ação desejada.
Após executar a importação, é possível testar a implantação.
Etapas para executar uma importação
1. Na coluna Ações , clique no botão executar com opções .
Guia de instalação e configuração 69
Capítulo 5: Atualização para o IBM Cognos PowerPlay
2. Clique em Agora para executar a importação imediatamente ou em Depois e digite a hora em
que deseja que a exportação seja executada.
3. Se desejar atualizar as especificações de relatório, clique em Atualizar todas as especificações
de relatório com a versão mais recente.
Também é possível usar a ferramenta de gerenciamento de programações para programar uma
tarefa para ser executada em uma base recorrente e visualizar uma lista das tarefas programadas.
Agora é possível testar a implantação.
Teste do conteúdo implantadoApós importar os pacotes do arquivo de implantação, verifique se todas as entradas foram
implantadas com sucesso no ambiente de destino.
É possível testar a implantação fazendo o seguinte:
❑ Revise o histórico de execução de uma implantação.
❑ Verifique se os pacotes e pastas corretos foram importados, junto com o conteúdo.
❑ Execute relatórios importados e visualizações de relatórios.
Para obter mais informações, consulte a ajuda online do console do IBM Cognos Administration.
Recomendação - Testar o conteúdo atualizadoApós importar os pacotes do arquivo de implantação, verifique se todas as entradas foram
implantadas com sucesso no ambiente de destino.
Teste o conteúdo atualizado fazendo o seguinte:
❑ Teste seus relatórios como segue:
● No Report Studio, valide cada relatório e observe se a validação teve êxito.
● No Report Studio, Query Studio e Analysis Studio, execute os relatórios aplicáveis e observe
se cada relatório foi executado com sucesso.
É possível fazer o download do Lifecycle Manager a partir do site do IBM® Cognos® Customer
Center (http://www.ibm.com/software/data/cognos/customercenter/) para ajudá-lo a realizar o
teste. O Lifecycle Manager é uma ferramenta de verificação que checa se seus relatórios são
executados e produzem os mesmos resultados no novo ambiente.
❑ Teste os modelos e os PowerCubes no IBM Cognos Transformer, caso necessário:
● Abra os modelos com as opções de segurança adequadas e salve-os.
● Teste os PowerCubes.
❑ Teste os modelos no Framework Manager.
É possível usar os mesmos modelos e projetos no Framework Manager do IBM Cognos BI
usados com a versão mais antiga. Ao atualizar modelos, o processo de validação produz erros
70 IBM Cognos Business Intelligence PowerPlay
Capítulo 5: Atualização para o IBM Cognos PowerPlay
para cada modelo. Para atualizar um projeto, abra e salve-o na nova versão do Framework
Manager. Para obter mais informações, consulte o Framework Manager User Guide.
❑ Conserte ou exclua relatórios e modelos que não operam corretamente.
❑ Teste os relatórios e modelos consertados executando-os novamente no sistema de teste.
Solucione os problemas que houver e entre em contato com o Cognos Software Services sobre
os problemas de atualização não-resolvidos.
❑ Reveja o plano de atualização para incluir as adaptações feitas durante a atualização
experimental.
Para obter mais informações, consulte a ajuda online do console do IBM Cognos Administration.
Mover para o ambiente de produçãoQuando todos os problemas descobertos durante a atualização experimental forem resolvidos, você
está pronto para começar a atualização completa em seu ambiente de produção. Seu plano de
atualização irá oferecer detalhes para cada etapa da atualização completa.
O diagrama a seguir mostra as etapas de alto nível no processo de mudança dos aplicativos
atualizados para um ambiente de produção. Após preparar o ambiente de produção e fazer o backup
de dados e arquivos de configuração, instale a versão mais antiga do software e a nova versão no
mesmo local. Em seguida, é possível implantar o conteúdo de seu ambiente de teste.
6Mover para o ambiente de produção
Preparaçãodo ambiente
Backup dearquivos Desinstalação
Instalaçãode novaversão
Implantaçãode ambientede teste
Caso deseje alavancar os recursos existentes e realizar atualização no mesmo diretório, é necessário
primeiro fazer um backup dos dados de configuração, assegurar-se de que foi feito o backup e a
verificação dos modelos do Framework Manager em um sistema de controle de origem (se for o
caso), e desinstalar a versão mais antiga do IBM® Cognos® BI.
Use a seguinte lista de verificação para guiá-lo no processo de mover para um ambiente de produção:
❑ Prepare o ambiente de produção.
● Faça um backup de arquivos e dados.
É possível que haja arquivos modificados além desses na pasta de configuração. Faça o
backup do diretório de instalação inteiro.
Ao fazer backup dos dados de configuração, armazene-os em um diretório seguro. É
necessário proteger o diretório de acesso não autorizado ou indevido.
● Instale o sistema da nova versão no ambiente de produção.
Se instalar o novo software do ambiente de teste no mesmo local que o software existente,
primeiro é necessário desinstalar o software existente.
● Configure o sistema.
Guia de instalação e configuração 71
Capítulo 5: Atualização para o IBM Cognos PowerPlay
❑ Configure a personalização manualmente.
● Se os arquivos de configuração foram editados manualmente, as alterações serão substituídas
durante a atualização. É necessário aplicar as alterações novamente. Deve-ser manter um
registro de todas as personalizações para se certificar de que elas possam ser aplicadas
novamente após a atualização. Deve-se também fazer um backup desses arquivos de modo
a armazenar a versão original novamente, se necessário.
● O serviço de apresentação do IBM Cognos BI suporta a atualização automática de alguns
arquivos de sistema .xml. Se muitas alterações de personalização foram feitas nos arquivos
de sistema .xml, use o recursos de atualização automática ao invés de aplicar manualmente
as alterações outra vez após ter atualizado. Os arquivos de sistema .xml são substituídos
durante a instalação do IBM Cognos BI. Portanto, é necessário fazer um backup das versões
personalizadas desses arquivos e então copiá-los para o diretório depois de atualizar o IBM
Cognos BI. A atualização automática será aplicada quando o serviço IBM Cognos for
iniciado.
● Os arquivos de sistema .xml que suportam a atualização automática estão contidos nos
seguintes diretórios:
local_c10/templates/ps
local_c10/templates/ps/portal
local_c10/templates/ps/qs
● Observação: para atualizar arquivos personalizados, reaplique manualmente as alterações
depois que o novo software for instalado. Use a atualização automática dos arquivos de
sistema .xml somente quando tiver feito um número alto de personalizações a esses arquivos.
❑ Implante o aplicativo no sistema de produção.
Quando estiver realizando a atualização, exporte todo o armazenamento de conteúdo para um
arquivo de implantação e importe o arquivo de implantação para o IBM Cognos BI depois da
atualização do software.
❑ Implante os relatórios e modelos do sistema de teste para o sistema de produção.
Atualização de uma versão anterior do IBM Cognos PowerPlayÉ necessário atualizar o software para mudar de uma versão mais antiga do IBM® Cognos®
PowerPlay® para uma versão mais recente. É necessário atualizar todos os componentes. Os
componentes de versões diferentes não são compatíveis. Se estiver usando os PowerCubes do IBM
Cognos Series 7 como uma fonte de dados, não é necessário atualizar o Transformer a menos que
deseje usar os recursos da nova versão desse componente. Os PowerCubes criados usando o IBM
Cognos Series 7 Transformer versão 7.3 (ou mais recente) e o IBM Cognos Transformer versão 8.3
(ou mais recente) são compatíveis com os relatórios e métricas do IBM Cognos Business Intelligence.
É possível executar versões diferentes do software em seu computador ao mesmo tempo, dado que
são instaladas em diretórios diferentes e configuradas para usar um armazenamento de conteúdo
e um conjunto de portas e URLs diferente para cada versão.
72 IBM Cognos Business Intelligence PowerPlay
Capítulo 5: Atualização para o IBM Cognos PowerPlay
Antes de começar a atualizar, planeje sua estratégia de atualização (p. 58 ). A estratégia usada
depende dos dados que deseja utilizar e das personalizações feitas com a configuração existente.
Depois de atualizar para o IBM Cognos BI utilizando os dados existentes, se desejar usar novos
recursos, pode ser necessário fazer uma configuração adicional. Para obter informações sobre os
novos recursos do IBM Cognos BI, consulte os Novos recursos do IBM Cognos BI.
Content Manager
Quando o serviço for iniciado depois da atualização, o Content Manager atualizará automaticamente
o esquema e conteúdos do armazenamento de conteúdo se o mesmo banco de dados de
armazenamento de conteúdo da versão anterior for utilizado. Os Bancos de dados de armazenamento
de conteúdo atualizados não são compatíveis com versões anteriores e portanto não podem ser
usados por versões anteriores do IBM Cognos BI. Para proteger os dados do armazenamento de
conteúdo originais, é necessário configurar o IBM Cognos BI para usar uma cópia do armazenamento
de conteúdo. Cria-se uma cópia fazendo o backup do armazenamento de conteúdo original e
armazenando novamente os dados em um novo armazenamento de conteúdo.
Armazenamento de conteúdo
Caso tenha salvado relatórios do IBM Cognos Series 7 PowerPlay® ou cartões de desempenho do
IBM Cognos Metrics Manager 2.x no ReportNet, a atualização do armazenamento de conteúdo
leva os relatórios e cartões de desempenho salvos para o IBM Cognos BI.
Framework Manager
É possível usar os mesmos modelos e projetos no Framework Manager do IBM Cognos BI usados
com a versão mais antiga. Ao atualizar modelos, o processo de validação produz erros para cada
modelo. Para atualizar um projeto, abra e salve-o na nova versão do Framework Manager. Para
obter mais informações, consulte o Framework Manager User Guide.
Se possuir aplicativos Software Development Kit que contam com uma versão mais antiga das
especificações do relatório, não será possível usar o Framework Manager para publicar seu modelo
sem perder a compatibilidade com versões anteriores.
Segurança
Ao atualizar do ReportNet ou de uma versão mais antiga do IBM Cognos BI, a segurança pode ser
afetada. Por exemplo, pode haver novas funções que não estavam em versões mais antigas e algumas
funções podem possuir novos recursos. Como resultado, a segurança do sistema atualizado pode
não estar no nível desejado Para confirmar o nível de segurança após a atualização, consulte o Guia
de administração e segurança.
Sistemas operacionais
Ao atualizar seus produtos do IBM Cognos BI, é possível escolher instalar alguns componentes em
novos sistemas operacionais. Considere como esses sistemas podem afetar a instalação e configuração
do IBM Cognos BI.
Caso a atualização inclua a instalação dos componentes do cliente do IBM Cognos BI no sistema
operacional Microsoft Windows® Vista, será necessário levar em consideração o seguinte:
● perfis móveis
Guia de instalação e configuração 73
Capítulo 5: Atualização para o IBM Cognos PowerPlay
Os perfis de usuários são armazenados em um local diferente em relação aos sistemas
operacionais mais antigos do Windows. O diretório Documents and Settings é substituído pelo
diretório Usuários. O diretório Todos os usuários é substituído pelo diretório Público.
● variáveis de ambiente
Os caminhos padrão associados com variáveis de ambiente são alterados. Se usar scripts ou
aplicativos que fazem referência a caminhos nas variáveis de ambiente, pode ser necessário
atualizá-los.
Além disso, pode-se desejar configurar novamente os locais de arquivo padrão no IBM Cognos
Configuration de modo que um local de arquivo único possa ser usado em sistemas operacionais
no ambiente do IBM Cognos BI. Para obter mais informações, consulte o tópico sobre as
propriedades de atualização do local do arquivo no capítulo de configurações (p. 297 ).
Atualização do IBM Cognos PowerPlayÉ possível atualizar o IBM® Cognos® Business Intelligence no mesmo diretório que uma versão mais
antiga ou em um diretório diferente, dependendo de que ponto do processo você se encontra. Por
exemplo, se estiver configurando seu ambiente de teste, instale em um novo diretório. Se terminar
de testar os aplicativos e desejar atualizar o software no ambiente de produção, será possível instalar
no mesmo diretório depois de desinstalar a versão anterior.
Se desejar atualizar o IBM Cognos BI no mesmo diretório, primeiro será necessário fazer um backup
dos dados de configuração, verificar se os modelos do Framework Manager foram armazenados
em backup e verificados em um sistema de controle de origens (se aplicável), e desinstalar a versão
mais antiga do IBM Cognos BI. Para obter as instruções completas, consulte: Etapas para instalar
no mesmo diretório.
Se estiver instalando em um novo computador, consulte: Etapas para instalar em um novo diretório.
Ao fazer backup dos dados de configuração, eles são armazenados em um diretório seguro. É
necessário proteger o diretório de acesso não autorizado ou indevido.
Um método alternativo de atualização inclui exportar todo o armazenamento de conteúdo para
um arquivo de implantação e importar esse arquivo no IBM Cognos BI após a atualização. Para
obter mais informações sobre a implantação, consulte o Guia de administração e segurança do IBM
Cognos BI. Uma atualização de implantação é solicitada se desejar alterar o tipo do banco de dados
usado no armazenamento de conteúdo. Se usar o método de atualização de implantação, somente
as etapas para exportar e restaurar os dados de configuração são diferentes. Todas as outras etapas
são as mesmas que as descritas nesta seção.
O IBM Cognos BI instala e utiliza o Tomcat como o servidor de aplicativos por padrão. Se não
desejar utilizar o Tomcat, deve-se seguir um conjunto de etapas diferente para atualizar. Para obter
mais informações, consulte "Atualização do IBM Cognos BI em um ambiente do servidor de
aplicativos " (p. 333 ).
Depois que o conteúdo do IBM Cognos BI for atualizado, o administrador de relatório não terá
mais acesso à ferramenta Administração de conteúdo e não poderá criar definições de implantação.
74 IBM Cognos Business Intelligence PowerPlay
Capítulo 5: Atualização para o IBM Cognos PowerPlay
Arquivos do IBM Cognos BI personalizados
Se os arquivos de configuração foram editados manualmente, as alterações serão substituídas durante
a atualização. É necessário aplicar as alterações novamente. Deve-ser manter um registro de todas
as personalizações para se certificar de que elas possam ser aplicadas novamente após a atualização.
Deve-se também fazer um backup desses arquivos de modo a armazenar a versão original novamente,
se necessário.
É possível que haja arquivos modificados além desses na pasta de configuração. Faça o backup do
diretório de instalação inteiro.
O serviço de apresentação do IBM Cognos BI suporta a atualização automática de alguns arquivos
de sistema .xml. Se muitas alterações de personalização foram feitas nos arquivos de sistema .xml,
use o recursos de atualização automática ao invés de aplicar manualmente as alterações outra vez
após ter atualizado. Os arquivos de sistema .xml são substituídos durante a instalação do IBM
Cognos BI. Portanto, é necessário fazer um backup das versões personalizadas desses arquivos e
então copiá-los para o diretório depois de atualizar o IBM Cognos BI. A atualização automática
será aplicada quando o serviço IBM Cognos BI for iniciado.
Os arquivos de sistema .xml que suportam a atualização automática estão contidos nos seguintes
diretórios:
● local_c10/templates/ps
● local_c10/templates/ps/portal
● local_c10/templates/ps/qs
Observação: para atualizar arquivos personalizados, reaplique manualmente as alterações depois
que o novo software for instalado. A atualização automática dos arquivos de sistema .xml deve ser
feita somente quando tiver feito um número alto de personalizações a esses arquivos.
Etapas para instalar no mesmo diretório
1. Com a ajuda de suas ferramentas de banco de dados, faça um backup do banco de dados do
armazenamento de conteúdo existente.
Para obter informações sobre este procedimento, consulte a documentação de seu banco de
dados.
2. Faça o backup dos seguintes arquivos para um local seguro:
● cogstartup.xml e coglocale.xml no diretório local_c8/configuration
● server.xml no diretório local_c8/tomcat4.1.27/conf
● system.xml no diretório apropriado, se necessário
Certifique-se de observar o caminho do diretório original para cada arquivo armazenado em
backup. Por exemplo,
local_c8/templates/ps
3. No IBM Cognos Configuration, exporte os dados de configuração para o mesmo local protegido.
Para usar os dados na atualização, nomeie o arquivo cogstartup.xml.
Guia de instalação e configuração 75
Capítulo 5: Atualização para o IBM Cognos PowerPlay
Importante: Como o arquivo cogstartup.xml exportado contém senhas sem criptografia,
certifique-se de que o local esteja protegido.
4. Faça um backup de arquivos editados manualmente em local_c8/configuration e outros diretórios
em um local seguro.
5. Se usar um sistema de controle como Concurrent Versions System (CVS), certifique-se de que
todos os modelos do Framework Manager estejam armazenados em backup e verificados antes
da atualização.
6. Interrompa todos os serviços do IBM Cognos e de qualquer servidor web que hospedar conteúdo
do IBM Cognos BI.
7. Prepare os modelos do Transformer, caso necessário.
8. Atualize ou instale outros produtos.
9. Desinstale o IBM Cognos BI de todos os computadores com o IBM Cognos BI.
10. Instale a versão mais recente do IBM Cognos BI no mesmo diretório usado para o IBM Cognos BI
em todos os computadores.
11. Para os arquivos editados manualmente em versões anteriores do IBM Cognos BI, edite os
mesmos arquivos no diretório local_c10 e aplique novamente as alterações feitas nos arquivos
originais personalizados.
Não copie os arquivos personalizados do local de backup para os diretórios local_c10. As
versões anteriores desses arquivos podem não ser compatíveis.
12. Se usar o Oracle como banco de dados de notificação, banco de dados de log ou de
armazenamento de conteúdo, exclua o arquivo classes12.jar ou ojdbc14.jar do diretório
local_c10\webapps\p2pd\WEB-INF\lib.
Versões antigas do ReportNet e do IBM Cognos BI utilizam esses arquivos, que entram em
conflito com o arquivo ojdbc5.jar, usado na nova versão.
13. Caso utilize um armazenamento de conteúdo DB2 em um sistema operacional System z, edite
e execute o script para atualizar o armazenamento de conteúdo DB2.
É necessário ter permissão para criar tablespaces para executar o script.
O script cria novas tablespaces e garante os direitos do Content Manager de usar as tablespaces.
14. No IBM Cognos Configuration, revise as configurações e salve-as.
Quando salvar a configuração, uma caixa de diálogo de atualização aparecerá para perguntar
se deseja atualizar as especificações de relatório. A configuração padrão é de não atualizar
especificações de relatório.
Importante: Não atualize as especificações de relatório se tiver aplicativos SDK que criam,
modificam ou salvam especificações de relatório. Atualize primeiro os aplicativos SDK para
que fiquem em conformidade com o esquema de especificações de relatório do IBM Cognos
BI. Caso contrário, os aplicativos SDK talvez não possam acessar as especificações atualizadas
do relatório. Além disso, não salve seus relatórios até que os aplicativos SDK tenham sido
76 IBM Cognos Business Intelligence PowerPlay
Capítulo 5: Atualização para o IBM Cognos PowerPlay
atualizados. Para obter informações sobre a atualização das especificações de relatório, consulte
o IBM Cognos Software Development Kit Developer Guide.
15. Inicie o IBM Cognos BI.
O IBM Cognos BI atualiza automaticamente o armazenamento de conteúdo. Os arquivos
system.xml são atualizados, se necessário, para uma versão compatível com o IBM Cognos BI.
16. Instale e configure o Framework Manager.
17. Atualize seus projetos do Framework Manager e relatórios conforme necessário. Para obter
mais informações, consulte o Framework Manager User Guide.
Os usuários do Report Studio devem limpar o cache de seus navegadores para obter as imagens
mais recentes.
18. Instale e configure o Transformer, caso necessário.
19. Atualize os modelos do Transformer e PowerCubes, se necessário.
Etapas para instalar em um novo diretório
1. Com as ferramentas do banco de dados, copie o banco de dados do armazenamento de conteúdo
em um novo.
Para obter informações sobre este procedimento, consulte a documentação de seu banco de
dados.
2. Faça o backup dos seguintes arquivos para um local seguro:
● coglocale.xml no diretório local_c8/configuration.
● server.xml no diretório local_c8/tomcat4.1.27/conf
● system.xml no diretório apropriado, se necessário
Certifique-se de observar o caminho original do diretório para cada arquivo armazenado
em backup. Por exemplo,
local_c8/templates/ps
● qualquer arquivo editado manualmente no diretório local_c8/configuration e em outros
diretórios
3. No IBM Cognos Configuration, exporte os dados de configuração para o mesmo local protegido.
Para usar os dados na atualização, nomeie o arquivo cogstartup.xml.
Importante: Como o arquivo cogstartup.xml exportado contém senhas sem criptografia,
certifique-se de que o local esteja protegido.
4. Prepare os modelos do Transformer, caso necessário.
5. Atualize ou instale outros produtos.
6. Instale o IBM Cognos BI em um novo diretório.
7. Copie os arquivos .xml de um local de backup seguro para o diretório a seguir:
Guia de instalação e configuração 77
Capítulo 5: Atualização para o IBM Cognos PowerPlay
● Copie cogstartup.xml e coglocale.xml em local_c10/configuration.
● Copie server.xml para local_c10/tomcat4.1.27/conf.
● Copie system.xml no mesmo diretório no novo local em que estava na versão mais antiga,
se necessário.
Por exemplo,
local_c10/templates/ps
Se for questionado sobre a substituição dos arquivos existentes, clique em Sim.
8. Para os arquivos editados manualmente, edite os mesmos arquivos no diretório local_c10 e
faça novamente as alterações realizadas nos arquivos originais personalizados.
Não copie os arquivos personalizados do local de backup para os diretórios local_c10. As
versões anteriores desses arquivos podem não ser compatíveis com a nova versão do IBM
Cognos BI.
9. Configuração de aliases do novo servidor web.
10. Caso utilize um armazenamento de conteúdo DB2 em um sistema operacional System z, edite
e execute o script para atualizar o armazenamento de conteúdo DB2.
É necessário ter permissão para criar tablespaces para executar o script.
O script cria novas tablespaces e garante os direitos do Content Manager de usar as tablespaces.
11. No IBM Cognos Configuration, configure o IBM Cognos BI para apontar para o novo
armazenamento de conteúdo, configure novas portas e URLs, use um caminho de cookies
diferente e salve as configurações.
Certifique-se de que os números de porta e nome do serviço para esta instalação sejam diferentes
daqueles usados em versões mais antigas, de modo que não haja conflitos.
Verifique se as definições de autenticação de segurança não estejam alteradas. Por exemplo, os
namespaces devem ser iguais para diretrizes, usuários, funções e grupos para funcionarem
corretamente.
Quando salvar a configuração, uma caixa de diálogo de atualização aparecerá para perguntar
se deseja atualizar as especificações de relatório. A configuração padrão é de não atualizar
especificações de relatório.
Importante: Não atualize as especificações de relatório se tiver aplicativos SDK que criam,
modificam ou salvam especificações de relatório. Atualize primeiro os aplicativos SDK para
que fiquem em conformidade com o esquema de especificações de relatório do IBM Cognos
BI. Caso contrário, os aplicativos SDK talvez não possam acessar as especificações atualizadas
do relatório. Além disso, não salve seus relatórios até que os aplicativos SDK tenham sido
atualizados. Para obter informações sobre a atualização das especificações de relatório, consulte
o IBM Cognos Software Development Kit Developer Guide.
12. Inicie o IBM Cognos BI.
O IBM Cognos BI atualiza automaticamente o novo armazenamento de conteúdo. Os arquivos
system.xml são atualizados, se necessário, para uma versão compatível com o IBM Cognos BI.
78 IBM Cognos Business Intelligence PowerPlay
Capítulo 5: Atualização para o IBM Cognos PowerPlay
13. Instale e configure o Framework Manager, caso necessário.
14. Atualize seus projetos do Framework Manager e relatórios, se necessário. Para obter mais
informações, consulte o Framework Manager User Guide.
15. Abra o portal de administração e cancele o registro dos distribuidores usados com versões
anteriores do IBM Cognos BI.
Ao abrir o portal de administração no IBM Cognos BI, é possível visualizar os distribuidores
registrados para as duas versões.
Para obter mais informações, consulte o Guia de administração e segurança.
16. Instale e configure o Transformer, caso necessário.
17. Atualize os modelos do Transformer e PowerCubes, se necessário.
18. Quando estiver pronto para desinstalar a versão anterior do IBM Cognos BI, faça o seguinte:
● Interrompa todos os serviços do IBM Cognos BI e de qualquer servidor web que hospedar
conteúdo do IBM Cognos BI.
● Desinstale o IBM Cognos BI em todos os computadores.
Ao concluir as tarefas de atualização, o IBM Cognos BI estará completamente configurado com
exceção de novas propriedades e recursos.
Caso utilize caracteres chineses, japoneses ou coreanos, será possível observar diferenças em alguns
caracteres depois da atualização do IBM ReportNet para o IBM Cognos BI. Para obter mais
informações, consulte a seção Solução de problemas do Guia de administração e segurança.
Se utilizar um banco de dados DB2 para o armazenamento de conteúdo, modifique o banco de
dados para aproveitar os recursos DB2. Para obter mais informações, consulte o Architecture and
Deployment Guide.
Para garantir a segurança e a integridade do IBM Cognos BI, é importante proteger o diretório de
instalação de acesso não autorizado ou inadequado.
Atualização do armazenamento de conteúdo DB2 em um sistema operacionalSystem z
Caso utilize um armazenamento de conteúdo DB2® em um sistema operacional System z, é necessário
executar um script que cria novas tablespaces e concede direitos ao Content Manager de usar as
tablespaces antes de salvar a configuração para o produto IBM® Cognos® BI atualizado.
É necessário ter permissão para criar tablespaces para executar o script. É necessário executar o
script depois de instalar a nova versão do IBM Cognos BI e antes de salvar a configuração para a
nova versão.
Etapas
1. Acesse o diretório local_c10\configuration\schemas\content\db2zOS e abra tablespaceUpgrade_
db2zOS.sql em um editor de texto.
Guia de instalação e configuração 79
Capítulo 5: Atualização para o IBM Cognos PowerPlay
2. Siga as instruções no arquivo de script para substituir os valores de espaço reservado no arquivo
com os valores para o seu banco de dados DB2.
Para os seguintes espaços listados na tabela a seguir, certifique-se de usar os mesmos valores
quando configurar a conexão ao armazenamento de conteúdo no IBM Cognos Configuration:
Propriedade no IBM Cognos ConfigurationEspaço reservado
Nome do recurso exibido em Acesso a dados >
Content Manager na janela Explorer.
CMSCRIPT_DATABASE
A porção da ID do usuário de ID do usuário e
senha na janela Propriedades
CMSCRIPT_USERNAME
3. Salve e execute o arquivo.
É possível continuar o processo de atualização abrindo o IBM Cognos Configuration para configurar
propriedades e iniciar o serviço IBM Cognos.
Instalação ou atualização de outros produtosAo atualizar o IBM® Cognos® PowerPlay®, pode ser necessário atualizar outros produtos para suas
versões mais recente, atualizar alguns componentes de outros produtos ou instalar produtos
adicionais para suportar novos recursos no IBM Cognos Business Intelligence.
Para visualizar uma lista de outros produtos usados pelo IBM Cognos BI, consulte "Verificação
das exigências do sistema" (p. 40 ).
Para visualizar uma lista atualizada de ambientes compatíveis com os produtos IBM Cognos, como
sistemas operacionais, patches, navegadores, servidores web, servidores de diretório, servidores de
banco de dados e servidores de aplicativos, viste o site IBM Cognos Customer Center (http://www.
ibm.com/software/data/support/cognos_crc.html).
Etapa
● Se não possuir a versão suportada de um produto exigido, instale ou atualize o produto. Para
obter mais informações, consulte "Preparação para a instalação" (p. 39 ).
● Configuração de um cliente de banco de dados.
● Atualização do ambiente JavaTM.
● Configuração de um servidor web.
● Configuração de um navegador web.
● Alteração da versão do Java Runtime Environment utilizado no IBM Cognos BI.
Para obter instruções para instalar ou atualizar outros produtos, consulte as instruções fornecidas
com cada produto.
80 IBM Cognos Business Intelligence PowerPlay
Capítulo 5: Atualização para o IBM Cognos PowerPlay
Execução de várias versões ou instâncias do IBM Cognos BI ao mesmo tempoÉ necessário alterar as portas e o alias do servidor web no IBM® Cognos® BI caso deseje executar
o IBM Cognos BI e o ReportNet®, ou duas instâncias do IBM Cognos BI, no mesmo computador
e ao mesmo tempo.
No ReportNet, não há caminhos de cookies padrão, o que significa que o cookie é enviado a todos
os URLs no servidor web. Caso o IBM Cognos BI utilize o mesmo servidor web, o IBM Cognos BI
irá então receber dois cookies cam_passport. Para prevenir este conflito, é necessário configurar
um caminho de cookies no ReportNet.
Outras alterações podem ser necessárias dependendo de seu ambiente. Se usar o Portal Services, é
necessário especificar o local do arquivo .xml de aplicativos. Se usar um gateway ISAPI em um
servidor web IIS, é necessário isolar o gateway do IBM Cognos BI para evitar um conflito com o
gateway do ReportNet. No IIS 5, o gateway é isolado definindo-se a proteção do aplicativo para
o site e diretórios virtuais como Alta. Nos IIS 6 e 7, é necessário criar um pool de aplicativos para
cada versão do produto IBM Cognos BI e associar os aliases a ele.
Se estiver usando o mesmo tipo de banco de dados para o armazenamento de conteúdo de várias
instâncias ou versões de um produto IBM Cognos BI, para evitar conflitos entre as instâncias do
banco de dados, é necessário alterar a porta do armazenamento de conteúdo no IBM Cognos
Configuration.
Etapas para a nova instância ou versão do IBM Cognos BI
1. No IBM Cognos BI, inicie o IBM Cognos Configuration.
2. Na janela Explorer, clique em Ambiente.
3. Na janela Propriedades, emConfigurações de distribuidor, clique no valor deURI do distribuidor
interno.
4. Selecione o número da porta e depois digite o número novo da porta.
5. Se for necessário, altere o número da porta dos URIs a seguir para corresponder o novo número
da porta inserido em URI do distribuidor interno.
● Em Configurações de distribuidor, altere a porta para URI do distribuidor externo.
● Em Outras configurações URI, altere a porta para URI do distribuidor para aplicativos
externos e URIs do Content Manager.
As URIs do Content Manager não aparecem em um computador de gateway.
6. Em Configurações de gateway, clique no valor para URI de gateway e verifique se o URI contém
o alias correto do servidor web para o IBM Cognos BI.
Por exemplo, substitua crn por ibmcognos.
7. Se estiver usando o Portal Services, atualize o arquivo .xml de aplicativos:
● Na janela Explorer, clique em Ambiente > Portal Services.
● Na janela Propriedades, verifique se o número da porta de Localização de 'applications.xml'corresponde à porta de outras propriedades URI.
Guia de instalação e configuração 81
Capítulo 5: Atualização para o IBM Cognos PowerPlay
8. Na janela Explorer, clique em Acesso a dados > Content Manager > Armazenamento de
conteúdo.
9. Na janela Propriedades configure o IBM Cognos BI para usar o novo armazenamento de
conteúdo:
● Para Nome do banco de dados, especifique o nome do novo armazenamento de conteúdo.
● Para evitar conflitos com outras instâncias de bancos de dados de armazenamento de
conteúdo, na propriedade Servidor do banco de dados e número da porta, especifique o
nome do servidor e um número de porta diferente.
● Se estiver usando o Cognos Content Database como armazenamento de conteúdo e outra
instância do Cognos Content Database estiver sendo executada no computador, também
será necessário especificar um número de porta de escuta diferente:
Na janela Explorer, expanda Ambiente > Banco de dados de conteúdo do IBM Cognos.
Na janela Propriedades, em Número de porta de escuta, digite o número da porta.
Importante: Ao instalar o produto IBM Cognos BI, selecione Cognos Content Database
no assistente de instalação. O Cognos Content Database não deve ser usado um ambiente
de produção.
● Para ID do usuário e senha, clique no botão de edição e especifique a ID do usuário e a
senha para acessar o novo armazenamento de conteúdo.
10. Se estiver executando duas instâncias do IBM Cognos BI, altere o caminho de cookies para a
nova versão do IBM Cognos BI:
● No menu Ações, clique em Editar Configuração Global.
● Na janela Configuração Global, clique em Configurações de cookie.
● Acesse um caminho diferente daquele usado por uma versão mais antiga do IBM Cognos BI.
● Clique em OK.
11. Salve as configurações e inicie o IBM Cognos BI.
Etapas para o ReportNet ou para a versão/instância antiga de produto IBM Cognos BI
1. No ReportNet ou na versão/instância antiga do produto IBM Cognos BI, inicie o IBM Cognos
Configuration.
2. Altere o caminho de cookies:
● No menu Ações, clique em Editar Configuração Global.
● Na janela Configuração Global, clique em Configurações de cookie.
● Defina o caminho no diretório de instalação (por exemplo, /crn).
● Clique em OK.
3. Salve a configuração.
82 IBM Cognos Business Intelligence PowerPlay
Capítulo 5: Atualização para o IBM Cognos PowerPlay
Agora é possível executar o ReportNet e o IBM Cognos BI, ou duas instâncias do IBM Cognos BI,
ao mesmo tempo.
Observação:Ao fazer alterações a partir das portas padrão nas propriedades do URI em um sistema
operacional Microsoft® Windows®, o número da porta é automaticamente anexado ao nome do
serviço. O nome do serviço no IBM Cognos Configuration não exibe o número da porta. É possível
ver o nome do serviço e o número da porta em Serviços em suas ferramentas administrativas do
Windows.
Guia de instalação e configuração 83
Capítulo 5: Atualização para o IBM Cognos PowerPlay
84 IBM Cognos Business Intelligence PowerPlay
Capítulo 5: Atualização para o IBM Cognos PowerPlay
Capítulo 6: Instalação e configuração do IBMCognos PowerPlay em um computador
É possível instalar o IBM® Cognos® PowerPlay® em um computador. Isto é útil quando se está
configurando um ambiente de teste ou de avaliação ou para ambientes de pequena produção.
Também é possível distribuir a instalação do PowerPlay em diferentes computadores. Para obter
mais informações, consulte "Instalação e configuração dos componentes do servidor IBM Cognos
PowerPlay em computadores diferentes" (p. 121 ).
Para migrar o conteúdo do IBM Cognos Series 7 para o IBM Cognos BI, os componentes de migração
são necessários tanto no computador com IBM Cognos PowerPlay como no computador com o
IBM Cognos Series 7. Ao instalar o IBM Cognos PowerPlay, a instalação inclui automaticamente
os componentes de migração. É necessário completar uma instalação em separado a fim de adicionar
os componentes de migração aos computadores com IBM Cognos Series 7.
Utilize a seguinte lista de verificação para guiá-lo através das tarefas de instalação:
❑ Caso deseje utilizar o Report Studio, o Analysis Studio ou o Query Studio, instale o IBM
Cognos Business Intelligence Server antes de instalar o IBM Cognos PowerPlay.
Para obter instruções, consulte o Guia de instalação e configuração do IBM Cognos BI.
❑ Instalação do IBM Cognos PowerPlay
❑ Instale o pacote de correções se estiver disponível.
❑ Crie um banco de dados para um armazenamento de conteúdo DB2 no Linux utilizando um
script
❑ Crie tablespaces para um armazenamento de conteúdo DB2 em z/OS
❑ Atualize o ambiente Java
❑ Configure as opções de drive JDBC para usar o DB2 como armazenamento de conteúdo
❑ Configure a conectividade do banco de dados para o banco de dados de armazenamento de
conteúdo.
❑ Configuração do IBM Cognos PowerPlay
❑ Configure o servidor web
❑ Inicie os serviços
❑ Teste a instalação
❑ Instale e configure os componentes de migração nos computadores com IBM Cognos Series 7
É possível personalizar os componentes para uso no ambiente alterando outras configurações no
IBM Cognos Configuration (p. 233 ).
Licensed Materials – Property of IBM85© Copyright IBM Corp. 2005, 2010.
Instalação do IBM Cognos PowerPlayUtilize o assistente de instalação para selecionar os componentes que deseja instalar e o local do
computador em quer que eles sejam instalados. Para utilizar o IBM® Cognos® PowerPlay® em um
computador, é preciso instalar todos os componentes selecionados por padrão no assistente de
instalação.
Se o PowerPlay está sendo instalado com o servidor do IBM Cognos Business Intelligence, instale
e configure primeiro o servido do IBM Cognos BI. Os dois produtos devem ser da mesma versão.
Para obter mais informações, consulte "Produtos IBM Cognos que operam conjuntamente com o
IBM Cognos PowerPlay" (p. 34 ).
Se estiver atualizando de uma versão anterior do PowerPlay, utilize as etapas de atualização. Para
obter mais informações, consulte "Atualização para o IBM Cognos PowerPlay" (p. 57 ).
Atualização da instalação
Se estiver atualizando de uma versão anterior dos produtos IBM Cognos, utilize as etapas de
atualização (p. 57 ).
Se estiver atualizando do ReportNet ou de uma versão anterior ao IBM Cognos BI, todos os
componentes distribuídos devem ter a mesma versão do IBM Cognos BI. Caso instale o IBM
Cognos BI em hosts adicionais ou alternativos, será necessário atualizar propriedades específicas
de local no IBM Cognos Configuration.
Caso esteja utilizando PowerCubes protegidos contra um namespace do IBM Cognos Series 7, é
necessário instalar o IBM Cognos PowerPlay em um computador que seja compatível com o IBM
Cognos Series 7.
Caso esteja fazendo a atualização do IBM Cognos BI em um ambiente que inclua versões mais
antigas de outros produtos do IBM Cognos BI, como IBM Cognos BI Controller Versão 8.x, IBM
Cognos BI Planning Versão 8.x ou IBM Cognos BI Analysis for Microsoft Excel® Versão 8.x, instale
a nova versão do IBM Cognos BI em um local separado de outros produtos do IBM Cognos BI e
configure a nova versão do IBM Cognos BI para funcionar independentemente desse produto.
Depois de atualizar o outro produto para uma versão compatível com o IBM Cognos BI, será
possível então configurar os dois produtos para operar juntos.
Instalações do Windows
Para instalações no Microsoft® Windows®, certifique-se de que possui privilégios de administrador
no computador com Windows em que está sendo feita a instalação. Certifique-se também de que
o computador possua variável de sistema TEMP que aponte para o diretório onde se deseja
armazenar os arquivos temporários. Durante a instalação, os arquivos do disco são copiados
temporariamente para esse diretório.
Instalações do UNIX
Para instalações no UNIX®, é possível instalar os componentes do servidor usando uma interface
gráfica de usuário ou executando uma instalação em segundo plano. Para executar a instalação em
modo gráfico, o console conectado ao computador UNIX deve ser compatível com uma interface
gráfica de usuário baseada em JavaTM.
86 IBM Cognos Business Intelligence PowerPlay
Capítulo 6: Instalação e configuração do IBM Cognos PowerPlay em um computador
Além disso, o IBM Cognos BI respeita a máscara de criação de modo de arquivo (umask) da conta
que executa o programa de instalação. Isto afeta somente os diretórios de instalação. Não afeta as
permissões de arquivo nos diretórios. Entretanto, os arquivos gerados pelo tempo de execução, tais
como logs, respeitam a máscara. Utilize o umask 022 no diretório de instalação.
Banco de dados de conteúdo do Cognos como armazenamento de conteúdo
Se desejar utilizar o Banco de dados de conteúdo do Cognos como armazenamento de conteúdo,
selecione a opção correspondente no assistente de instalação. Se estiver instalando componentes
em diversos computadores, é necessário instalar somente um Banco de dados de conteúdo do
Cognos. Se instalar o Banco de dados de conteúdo do Cognos no mesmo computador que o Content
Manager e mais tarde decidir utilizar outro banco de dados para o armazenamento de conteúdo,
desinstale o Banco de dados de conteúdo do Cognos.
Requisitos de impressora
Para certificar-se de que os relatórios sejam impressos corretamente no Windows, o Adobe® Reader
exige que pelo menos uma impressora seja configurada no sistema operacional em que o Application
Tier Components está instalado. Todos os relatórios, independentemente do formato de impressão
escolhido, são enviados como arquivos PDF temporários ao Adobe Reader para impressão.
Etapas para instalar em UNIX e Linux
1. Caso esteja fazendo a instalação em um diretório com outros componentes do IBM Cognos
BI, interrompa o serviço IBM Cognos BI.
2. Defina a variável do ambiente JAVA_HOME para apontar para o local de instalação do Java
Runtime Environment (JRE).
Um exemplo de localidade de instalação de um Java Runtime Environment é
/diretório/java/versão_java/jre.
O IBM Cognos BI requer uma JVM, como a IBM Java, para ser executado no Linux®.
Se estiver instalando em um local com outros componentes do IBM Cognos BI, use a variável
de ambiente JAVA_HOME existente.
3. No HP-UX, defina a variável de ambiente _M_ARENA_OPTS da seguinte forma:
_M_ARENA_OPTS 1:4
Isto aumenta a distribuição de memória no HP-UX para que se encaixe melhor em outras
plataformas UNIX.
4. No AIX, se estiver usando um gateway de servlet, configure a variável de ambiente
AIXTHREAD_SCOPE como o seguinte:
AIXTHREAD_SCOPE=S
Isto define o escopo de contenção dos threads do usuário para todo o sistema, que suporta
programações mais eficientes dos threads do usuário.
5. Se estiver instalando a partir de um download, acesse o local em que os arquivos de instalação
foram baixados e extraídos.
Guia de instalação e configuração 87
Capítulo 6: Instalação e configuração do IBM Cognos PowerPlay em um computador
6. Se estiver instalando de um disco, monte o disco usando extensões de arquivo Rock Ridge.
Para montar o disco em HP-UX, faça o seguinte:
● Adicione o diretório pfs_mount no caminho.
Por exemplo,
PATH=/usr/sbin/:$PATH
exporte PATH
● Para iniciar os daemons NFS solicitados e executar os daemons em segundo plano, digite
bg pfs_mountd e depois bg pfsd
● Para montar a unidade, digite
pfs_mount -t rrip <device><mount_dir> -o xlat=unix
Por exemplo,
pfs_mount /dev/dsk/c0t2d0 /cdrom -o xlat=unix
É possível agora instalar ou copiar arquivos como um usuário que não seja o usuário raiz
utilizando um CD do IBM Cognos nessa unidade.
● Ao completar a instalação, digite pfs_umount /cdrom e mate os daemons pfsd e pfs_mountd
para desmontar o CD.
7. Para iniciar o assistente de instalação, vá para o diretório do sistema operacional no CD ou no
diretório para o qual os arquivos de instalação foram baixados e extraídos e digite
./issetup
Observação: Ao utilizar o comando issetup com o XWindows, os caracteres japoneses em
mensagens e arquivos de log podem ficar corrompidos. Ao instalar em japonês no UNIX ou
Linux, configure primeiro as variáveis de ambiente LANG=C e LC_ALL=C (onde C é o código
do idioma, por exemplo, ja_JP.PCK no Solaris), e então execute o assistente de instalação.
Se não estiver usando o XWindows, execute uma instalação autônoma (p. 345 ).
8. Siga as instruções do assistente de instalação e copie os arquivos necessários para seu
computador.
O idioma selecionado será o mesmo da interface do usuário. É possível alterar o idioma da
interface do usuário do produto para qualquer idioma instalado após a instalação.
Caso deseje utilizar o banco de dados de armazenamento de conteúdo fornecido pelo IBM
Cognos BI, selecione também Banco de dados de conteúdo do Cognos. Posteriormente, se optar
por usar outro banco de dados para o armazenamento de conteúdo, deverá desinstalar o Banco
de dados de conteúdo do Cognos.
Se estiver instalando em um diretório que contém outros componentes do IBM Cognos BI, será
feita uma solicitação para criar cópias de backup dos arquivos que serão substituídos.
Instale os componentes do IBM Cognos PowerPlay em um diretório que contenha apenas
caracteres ASCII no nome do caminho. Alguns servidores web UNIX e Linux só suportam
caracteres ASCII nos nomes dos diretórios.
88 IBM Cognos Business Intelligence PowerPlay
Capítulo 6: Instalação e configuração do IBM Cognos PowerPlay em um computador
9. Na página Concluir do assistente de instalação, faça o seguinte:
● Se desejar ver os arquivos de log, clique em Visualização para o arquivo de log adequado.
● Se desejar ver as últimas informações sobre o produto, assinale a caixa de seleção das Notas
de versão do IBM Cognos.
● Verifique se a caixa de seleção IBM Cognos Configuration está desmarcada. Não configure
o IBM Cognos BI imediatamente porque é necessário realizar outras tarefas antes para
garantir que o ambiente esteja devidamente configurado.
Será possível configurar o IBM Cognos BI posteriormente com o IBM Cognos Configuration,
digitando cogconfig.sh no diretório local_c10/bin ou executando uma configuração em
segundo plano ou editando cogstartup.xml no diretório local_c10/configuration.
● Clique em Concluir.
10. Anexe o diretório c10_location/bin à variável de ambiente do caminho da biblioteca adequada:
● Para AIX, LIBPATH
● Para HP-UX, SHLIB_PATH
● Para Solaris e Linux, LD_LIBRARY_PATH
11. No Linux, defina a variável do ambiente da IMPRESSORA ao nome de sua impressora.
Para garantir a segurança e a integridade do IBM Cognos BI, é importante proteger o diretório de
instalação do acesso não autorizado ou inadequado.
Se desejar que os usuários vejam a documentação do produto em um idioma diferente do inglês, é
necessário instalar o componente Supplementary Languages Documentation no local em que os
componentes de gateway foram instalados. Para obter mais informações, consulte "Instalação da
documentação do produto traduzida" (p. 188 ).
Etapas para instalar no Windows
1. Caso esteja fazendo a instalação em um diretório com outros componentes do IBM Cognos
BI, interrompa o serviço IBM Cognos BI.
2. Execute um dos seguintes procedimentos:
● Insira o disco do produto IBM Cognos.
Se o assistente de instalação não abrir automaticamente, acesse o diretório do sistema
operacional e clique duas vezes em issetup.exe.
● Acesse o local em que os arquivos de instalação foram baixados e extraídos e clique duas
vezes em issetup.exe.
3. Selecione o idioma para utilizar na instalação.
O idioma selecionado determina o idioma da interface do usuário no programa de instalação.
É possível alterar o idioma da interface do usuário do produto para qualquer idioma instalado
após a instalação.
Guia de instalação e configuração 89
Capítulo 6: Instalação e configuração do IBM Cognos PowerPlay em um computador
4. Siga as instruções do assistente de instalação e copie os arquivos necessários para seu
computador.
Caso deseje utilizar o banco de dados de armazenamento de conteúdo fornecido pelo IBM
Cognos BI, selecione também Banco de dados de conteúdo do Cognos. Posteriormente, se optar
por usar outro banco de dados para o armazenamento de conteúdo, deverá desinstalar o Banco
de dados de conteúdo do Cognos.
Instale os componentes do IBM Cognos BI em um diretório que contenha apenas caracteres
ASCII no nome do caminho. Alguns servidores web do Windows só suportam caracteres ASCII
nos nomes dos diretórios.
Se estiver instalando em um diretório que contém outros componentes do IBM Cognos BI, será
feita uma solicitação para criar cópias de backup dos arquivos que serão substituídos.
5. Na página Concluir do assistente de instalação, faça o seguinte:
● Se desejar ver os arquivos de log, clique em Visualização para o arquivo de log adequado.
● Se desejar ver as últimas informações sobre o produto, assinale a caixa de seleção das Notas
de versão do IBM Cognos.
● Verifique se a caixa de seleção IBM Cognos Configuration está desmarcada. Não configure
o IBM Cognos BI imediatamente porque é necessário realizar outras tarefas antes para
garantir que o ambiente esteja devidamente configurado.
É possível configurar o IBM Cognos BI posteriormente utilizando o menu Iniciar do
Windows para iniciar o IBM Cognos Configuration da pasta de atalho.
● Clique em Concluir.
Para garantir a segurança e a integridade do IBM Cognos BI, é importante proteger o diretório de
instalação do acesso não autorizado ou inadequado.
Se desejar que os usuários vejam a documentação de produtos em um idioma diferente de inglês, é
necessário instalar a Supplementary Languages Documentation. Para obter mais informações,
consulte "Instalação da documentação do produto traduzida" (p. 188 ).
Para usar as amostras, instale-as do CD do IBM Cognos Business Intelligence Samples. Para obter
mais informações, consulte "Instalação de amostras do IBM Cognos BI" (p. 182 ).
Instalação de pacotes de correçõesA IBM® fornece pacotes de manutenção que contêm atualização para um ou mais componentes
dos produtos IBM Cognos®. Se o pacote de correções estiver disponível ao instalar ou atualizar o
produto, instale-o após os componentes do IBM Cognos Business Intelligence.
Se o pacote de correções estiver disponível após a implantação do produto IBM Cognos, interrompa
o serviço, instale o fix pack no mesmo local que os componentes IBM Cognos BI e inicie o serviço.
Os pacotes de correções estão disponíveis para download no IBM Support em http://www.ibm.com/
support/us/en/.
90 IBM Cognos Business Intelligence PowerPlay
Capítulo 6: Instalação e configuração do IBM Cognos PowerPlay em um computador
IMPORTANTE: Os pacote de correções não são instalações independentes. Deve-se instalá-los em
computadores que têm os componentes de servidor IBM Cognos BI instalados. Instale os pacotes
de correções apropriados para a versão do produto. Para verificar qual a versão que possui, abra
o arquivo de lista de componentes em local_c10\cmplst.txt e verifique a linha que começa com
C8BISRVR_version=.
Antes de instalar o pacote de correções, crie um backup do banco de dados de armazenamento de
conteúdo. Além disso, faça back-up dos arquivos personalizados da instalação atual.
Etapas para o sistema operacional Microsoft Windows
1. Se o produto IBM Cognos BI estiver em execução, abra o IBM Cognos Configuration e
interrompa o serviço do IBM Cognos.
2. Faça backup do armazenamento de conteúdo.
3. Se o ambiente IBM Cognos BI for personalizado, faça backup de todo o local IBM Cognos BI.
4. Insira o disco do pacote de correções do sistema operacional Microsoft® Windows® ou acesse
o local em que o download foi feito e os arquivos foram extraídos.
Se mais de um pacote de correções estiver disponível, instale o que tiver o menor número de
versão primeiro.
5. No disco ou no local de download, acesse o diretório win32 e clique duas vezes no arquivo
issetup.exe.
6. Siga as instruções do assistente de instalação, instalando no mesmo local que os componentes
de servidor IBM Cognos BI já existentes.
O programa issetup solicitará permissão para que o pacote de correções crie uma cópia de
backup na pasta de instalação antes de copiar novos arquivos.
7. Se o atualizador estiver disponível, faça o seguinte:
● Para fazer uma instalação a partir do disco, insira o disco do atualizador do sistema
operacional Windows.
● Para fazer uma instalação a partir de download, siga as instruções do site de suporte e
acesse o local onde o download foi feito e os arquivos extraídos.
● No diretório do atualizador do disco ou do local de download, acesse o diretório win32 e
clique duas vezes no arquivo issetup.exe.
● Siga as instruções do assistente de instalação.
8. Para retornar um produto IBM Cognos BI implantado no serviço, abra o IBM Cognos
Configuration, salve a configuração e inicie o serviço IBM Cognos.
9. Se tiver um ambiente distribuído, repita essas etapas para todos os servidores IBM Cognos BI
restantes.
10. Se estiver executando o produto IBM Cognos BI em um servidor de aplicativos que não seja o
padrão, Tomcat, implante o produto IBM Cognos BI novamente no servidor de aplicativos.
Guia de instalação e configuração 91
Capítulo 6: Instalação e configuração do IBM Cognos PowerPlay em um computador
Para obter instruções, consulte "Configuração de propriedades do servidor de aplicativos e
implantação do IBM Cognos 8" (p. 322 ).
Etapas para os sistemas operacionais UNIX e Linux
1. Se o produto IBM Cognos BI estiver em execução, abra o IBM Cognos Configuration e
interrompa o serviço do IBM Cognos.
2. Faça backup do armazenamento de conteúdo.
3. Se o ambiente IBM Cognos BI for personalizado, faça backup de todo o local IBM Cognos BI.
4. Se estiver usando um disco, monte o disco do pacote de correções adequado para o sistema
operacional UNIX® ou Linux®, usando as extensões de arquivo Rock Ridge.
Importante: Para montar o disco do IBM Cognos no HP-UX, proceda da seguinte forma:
● Adicione o diretório pfs_mount no caminho.
Por exemplo,
PATH=/usr/sbin/:$PATH
exporte PATH
● Para iniciar os daemons NFS solicitados e executar os daemons em segundo plano, digite
bg pfs_mountd e depois bg pfsd
● Para montar a unidade, digite
pfs_mount -t rrip <device><mount_dir> -o xlat=unix
Por exemplo,
pfs_mount /dev/dsk/c0t2d0 /cdrom -o xlat=unix
Agora é possível instalar ou copiar arquivos como um usuário que não seja o usuário raiz
utilizando um disco do IBM Cognos nessa unidade.
● Ao concluir a instalação, digite pfs_umount /cdrom e finalize os daemons pfsd e pfs_mountd
para desmontar o disco.
5. Se estiver usando um download, acesse o local onde o download foi feito e onde os arquivos
do pacote de correções foram extraídos.
Se mais de um pacote de correções estiver disponível, instale o que tiver o menor número de
versão primeiro.
6. Para iniciar o assistente de instalação, digite
./issetup
Se não estiver usando o XWindows, execute uma instalação autônoma (p. 345 ).
7. Siga as instruções do assistente de instalação, instalando no mesmo local que os componentes
de servidor IBM Cognos BI já existentes.
O programa issetup solicitará permissão para que o pacote de correções crie uma cópia de
backup na pasta de instalação antes de copiar novos arquivos.
92 IBM Cognos Business Intelligence PowerPlay
Capítulo 6: Instalação e configuração do IBM Cognos PowerPlay em um computador
8. Se o atualizador estiver disponível, faça o seguinte:
● Para instalar a partir de um disco, monte o disco de atualizador adequado para o sistema
operacional, usando as extensões de arquivo Rock Ridge.
Importante: Para montar o disco no HP-UX, siga as instruções da etapa 4.
● Para instalar a partir de um download, acesse o local onde o download foi feito e os arquivos
do atualizador foram extraídos.
● Para iniciar o assistente de instalação, digite
./issetup
Se não estiver usando o XWindows, execute uma instalação autônoma (p. 345 ).
● Siga as instruções do assistente de instalação, instalando no mesmo local que os componentes
de servidor IBM Cognos BI já existentes.
9. Para retornar um produto IBM Cognos BI implantado no serviço, abra o IBM Cognos
Configuration, salve a configuração e inicie o serviço IBM Cognos.
10. Se tiver um ambiente distribuído, repita essas etapas para todos os servidores IBM Cognos BI
restantes.
11. Se estiver executando o produto IBM Cognos BI em um servidor de aplicativos que não seja o
padrão, Tomcat, implante o produto IBM Cognos BI novamente no servidor de aplicativos.
Para obter instruções, consulte "Configuração de propriedades do servidor de aplicativos e
implantação do IBM Cognos 8" (p. 322 ).
Criação de bancos de dados para o armazenamento de conteúdoDB2 em Linux com um script
O script C8DB2.sh é fornecido para permitir a criação de um banco de dados de armazenamento
de conteúdo do DB2® no sistema operacional Linux®. O script estará localizado no diretório
local_c10/C8SE depois que o IBM® Cognos® Business Intelligence for instalado.
O DB2 deve ser instalado e configurado antes da execução do script. O script cria e configura um
banco de dados que pode ser utilizado como armazenamento de conteúdo. Para obter mais
informações sobre as configurações mínimas recomendadas para um armazenamento de conteúdo
DB2, consulte "Configurações sugeridas para criar o armazenamento de conteúdo no DB2 no
Linux, Windows e UNIX" (p. 45 ).
Permissões
Para executar o script, é preciso ser um membro do grupo DB2 chamado dasadm1. Quando o script
é executado, é solicitada uma conta de usuário que receberá os privilégios requeridos para acessar
e gravar no banco de dados. Ao configurar as informações de conexão do armazenamento de
conteúdo para o IBM Cognos BI, utilize a conta de usuário inserida ao executar o script e não a
conta de usuário utilizada para executar o script.
Guia de instalação e configuração 93
Capítulo 6: Instalação e configuração do IBM Cognos PowerPlay em um computador
O script cria o banco de dados na primeira instância de DB2 no caminho. Se tiver mais de uma
instância de DB2, certifique-se de que a instância de DB2 na qual deseja criar o armazenamento de
conteúdo apareça primeiro no caminho.
Etapas
1. No diretório local_c10/C8SE em que o IBM Cognos BI está instalado, copie o script C8DB2.sh
para o servidor de banco de dados.
2. No computador servidor de banco de dados, mude para um usuário que seja membro do grupo
DB2 chamado dasadm1.
3. Execute o script utilizando o seguinte comando:
./C8DB2.sh
As seguintes informações são solicitadas:
● um nome para o armazenamento de conteúdo
● um usuário que receberá os privilégios requeridos para acessar e gravar no banco de dados
de armazenamento de conteúdo
Ao definir as propriedades de conexão de banco de dados para o armazenamento de
conteúdo, insira esse usuário na propriedade ID do usuário e senha.
Quando o script estiver concluído, um banco de dados será criado no DB2 e poderá ser utilizado
como banco de dados de armazenamento de conteúdo.
Criação de tablespaces para um armazenamento de conteúdoDB2 em z/OS
O administrador do banco de dados deve executar um script para criar um conjunto de tablespaces
necessários para o banco de dados do armazenamento de conteúdo. O script deve ser modificado
para substituir os parâmetros de espaço reservado com os adequados a seu ambiente.
Se estiver usando o mesmo banco de dados DB2® em z/OS® para o armazenamento de conteúdo e
a notificação (a configuração padrão), então deverá executar scripts para criar tablespaces de
notificação ao mesmo tempo em que cria tablespaces de armazenamento de conteúdo.
Verifique se está usando as convenções de nomes para DB2 em z/OS. Por exemplo, todos os nomes
de parâmetros devem começar com uma letra e o tamanho não pode exceder oito caracteres. Para
obter mais informações, consulte o IBM® DB2 Information Center.
Etapas
1. Conecte-se ao banco de dados como um usuário com privilégios para criar e arrastar tablespaces
e para permitir a execução de instruções SQL.
2. Vá até o diretório que contém os scripts:
local_c10/configuration/schemas/content/db2zOS
94 IBM Cognos Business Intelligence PowerPlay
Capítulo 6: Instalação e configuração do IBM Cognos PowerPlay em um computador
3. Abra o arquivo de script tablespace_db2zOS.sql e use a tabela a seguir para ajudá-lo a substituir
os parâmetros genéricos pelos adequados a seu ambiente.
Nem todos os parâmetros listados estão no script, mas podem ser adicionados no futuro.
DescriçãoNome do parâmetro
Especifica o local das tabelas de baseCMSCRIPT_CREATE_IN
Por exemplo: NomeBancodedados.baseNomeTablespace.
Especifica o nome do grupo de armazenamento.CMSCRIPT_STOGROUP
Especifica o nome do armazenamento de conteúdo Sybase.CMSCRIPT_DATABASE
Especifica a identificação da instância para o banco de
dados do armazenamento de conteúdo.
CMSCRIPT_CS_ID
A ID não deve ser maior que dois caracteres.
Especifica o nome do tablespace que irá conter todas as
tabelas de base no armazenamento de conteúdo.
CMSCRIPT_TABLESPACE
Tabelas auxiliares não são incluídas.
O nome não pode ser maior de seis caracteres.
Especifica o nome do pool de buffer grande alocado
especialmente para objetos grandes.
CMSCRIPT_LARGE_BP
Especifica o nome do pool de buffer de tamanho normal
alocado especialmente para objetos grandes e de tamanho
normal.
CMSCRIPT_REGULAR_BP
Especifica a conta de usuário que acessa o banco de dados
do armazenamento de conteúdo.
CMSCRIPT_USERNAME
4. Salve e execute o script.
5. Conceda os direitos de usuário do IBM Cognos® para os tablespaces criados ao executar o
script de arquivo tablespace_db2zOS.sql:
● Na ferramenta de acesso remoto, abra o arquivo de script rightsGrant_db2zOS.sql e
substitua os parâmetros de espaço reservado com valores adequados a seu ambiente.
Dica: Verifique se os mesmos valores usados ao alocar recursos aos pools de buffer e à
conta de usuário estão sendo usados.
● Salve e execute o arquivo.
6. Substitua os parâmetros de espaço reservado nos seguintes scripts e execute-os:
Guia de instalação e configuração 95
Capítulo 6: Instalação e configuração do IBM Cognos PowerPlay em um computador
● dbInitTest_db2zOS.sql
● dbInitMeta_db2zOS.sql
● dbInitScript_db2zOS.sql
● dbInitLock_db2zOS.sql
7. Se estiver usando o mesmo banco de dados para notificação que o utilizado para o
armazenamento de conteúdo (a configuração padrão), execute as etapas restantes.
8. Abra o arquivo de script NC_TABLESPACES.sql e use a tabela a seguir para ajudá-lo a substituir
os parâmetros de espaço reservado por aqueles que são adequados a seu ambiente.
Para parâmetros que não estejam no script, adicione-os.
DescriçãoNome do parâmetro
Especifica o nome do armazenamento de conteúdo Sybase.NCCOG
Especifica o nome do grupo de armazenamento utilizado para o banco
de dados do armazenamento de conteúdo.
DSN8G810
Especifica o nome do pool de buffer usado para os tablespaces.BP32K
9. Salve e execute o script.
10. Abra o arquivo de script NC_CREATE.sql e substitua o parâmetro de espaço reservado NCCOG
pelo nome do banco de dados do armazenamento de conteúdo.
11. Salve o script.
Os serviços de trabalho e monitor de programação executarão o script automaticamente. No
entanto, você mesmo pode executá-lo.
O banco de dados do armazenamento de conteúdo foi criado. Agora é possível configurar uma
conexão de banco de dados.
Opções de driver JDBC para usar o banco de dados DB2 comoarmazenamento de conteúdo
O IBM® Cognos® Business Intelligence usa o JavaTM Database Connectivity (JDBC) para acessar
os bancos de dados utilizados para o armazenamento de conteúdo.
Se utilizar o DB2® nos sistemas operacionais Microsoft® Windows®, Linux® ou UNIX® como
armazenamento de conteúdo, será necessário optar se irá usar o driver JDBC tipo 2 ou tipo 4,
dependendo da forma de conexão ao armazenamento de conteúdo.
Se estiver usando um banco de dados DB2 em z/OS® para o armazenamento de conteúdo, será
necessário usar uma conectividade JDBC tipo 4.
96 IBM Cognos Business Intelligence PowerPlay
Capítulo 6: Instalação e configuração do IBM Cognos PowerPlay em um computador
Especifica-se o tipo de driver usado no IBM Cognos Configuration.
Opções de configuração para o driver universal
O DB2 introduziu um diretório JDBC universal que contem suporte aos diretórios JDBC tipo 2 e
tipo 4. O driver universal, db2jcc.jar, substitui o driver substituído JDBC tipo 2, db2java.zip.
Se estiver atualizando, continue a usar a conexão JDBC tipo 2 sem alterações de configuração
solicitadas. Se desejar usar a conexão JDBC tipo 4, será necessário alterar suas configurações para
incluir o nome do host e número da porta do servidor do banco de dados.
Para obter informações sobre solicitações de configuração, consulte "Definição de propriedades de
conexão do banco de dados para o armazenamento de conteúdo" (p. 102 ).
Entretanto, para a conexão JDBC tipos 2 e 4, é necessário copiar o novo driver universal, db2jcc.jar,
e o arquivo de licença que o acompanha, db2jcc_license_*.jar, no local de instalação do IBM Cognos
BI.
Para obter mais informações, consulte "Configuração da conectividade de banco de dados para o
banco de dados de armazenamento de conteúdo" (p. 97 ).
Uso do driver JDBC tipo 2
Os drivers tipo 2 JDBC compreendem um componente API nativo e um componente JavaTM .
A conexão ao banco de dados DB2 ocorre através da bibliotecas DB2 CLI, que compreendem o
componente nativo que se comunica com o servidor do banco de dados.
Devido aos drivers JDBC tipo 2 necessitarem de um código do cliente comum e se basearem no
código nativo do produto, um cliente DB2 deve estar instalado para usar este driver. Por exemplo,
um cliente DB2 deve estar instalado no computador em que o Content Manager está instalado.
Uso do driver JDBC tipo 4
Os drivers JDBC tipo 4 são simplesmente drivers Java que fornecem acesso direto aos recursos do
banco de dados DB2 através da comunicação de rede.
O driver tipo 4 é considerado um produto independente. Não necessita que o cliente DB2 seja
instalado.
Configuração da conectividade de banco de dados para o bancode dados de armazenamento de conteúdo
Se estiver utilizando um banco de dados diferente do Banco de dados de conteúdo do Cognos®
como o armazenamento de conteúdo, poderá ser necessário instalar o software cliente de banco de
dados ou drivers JavaTM Database Connectivity (JDBC), ou ambos, em cada computador em que
instalar o Content Manager. Fazer isso permite ao Content Manager acessar o banco de dados de
armazenamento de conteúdo.
Etapas para o DB2
1. Se estiver usando uma conexão JDBC tipo 2, instale o software do cliente DB2® nos
computadores com o Content Manager.
Guia de instalação e configuração 97
Capítulo 6: Instalação e configuração do IBM Cognos PowerPlay em um computador
Se estiver usando uma conexão JDBC tipo 4 para DB2, não será solicitado para instalar o
software do cliente DB2 no local onde o Content Manager está instalado. Se for utilizado banco
de dados DB2 em z/OS® para o armazenamento de conteúdo, será necessário usar uma
conectividade JDBC tipo 4.
Para obter mais informações sobre as diferenças entre os drivers tipo 2 e tipo 4, consulte "Opções
de driver JDBC para usar o banco de dados DB2 como armazenamento de conteúdo" (p. 96
).
2. Se utilizar uma conexão JDBC tipo 2 e o armazenamento de conteúdo não estiver no computador
do Content Manager, configure um alias do banco de dados para o armazenamento de conteúdo.
No sistema operacional Microsoft® Windows®, execute o DB2 Client Configuration Assistant.
Nos sistemas operacionais UNIX® ou Linux®, use a interface de linha de comando do DB2.
Se o banco de dados do armazenamento de conteúdo e o Content Manager estiverem no mesmo
computador, o nome do armazenamento de conteúdo será automaticamente o alias.
Ao configurar os computadores com o Content Manager, certifique-se que estejam configurados
para usar o mesmo armazenamento de conteúdo.
3. No Windows, encerre os serviços DB2 e o HTML Search Server.
4. Copie os seguintes arquivos do diretório instalação_DB2/sqllib/java para o diretório local_c10/
webapps/p2pd/WEB-INF/lib.
● O arquivo do driver universal, db2jcc.jar.
● o arquivo de licença
para DB2 no Linux, UNIX ou Windows, db2jcc_license_cu.jar
para DB2 em z/OS, db2jcc_license_cisuz.jar
Se estiver conectando ao DB2 em z/OS, use a versão de driver do Linux, UNIX ou Windows
versão 9.1 Fix Pack 5 ou versão 9.5 Fix Pack 2.
Dica: Para verificar a versão do driver, execute o seguinte comando
java -cp caminho\db2jcc.jar com.ibm.db2.jcc.DB2Jjcc -version
5. No Windows, reinicie os serviços DB2 e o HTML Search Server.
6. No UNIX, se estiver utilizando uma conexão JDBC tipo 2, certifique-se de que as bibliotecas
DB2 de 32 bits estão no caminho de busca da biblioteca, que são geralmente os diretórios
$DB2DIR/lib ou $DB2DIR/lib32.
7. Repita todo o procedimento nos computadores IBM Cognos BI nos quais o Content Manager
estiver instalado ou nos quais a notificação for enviada a um banco de dados DB2.
98 IBM Cognos Business Intelligence PowerPlay
Capítulo 6: Instalação e configuração do IBM Cognos PowerPlay em um computador
É possível adaptar o banco de dados para utilizar os recursos DB2. Para obter mais informações,
consulte "Ajuste do Armazenamento de conteúdo do DB2" (p. 359 ).
Etapas para o Oracle
1. No computador em que o cliente Oracle foi instalado, vá para o diretório ORACLE_HOME/
jdbc/lib.
2. Copie o arquivo ojdbc5.jar para o diretório local_c10/webapps/p2pd/WEB-INF/lib nos
computadores em que o Content Manager estiver instalado e em que a notificação é enviada
para um banco de dados Oracle.
Se o diretório contiver o arquivo classes12.jar ou ojdbc14.jar, exclua-o antes de instalar o
arquivo ojdbc15.jar.
O driver está disponível em um cliente Oracle ou instalação do servidor, ou pode ser baixado
do site de tecnologia Oracle.
Etapas para Informix
1. No computador em que o Informix® está instalado, acesse o diretório local_Informix/sqllib/java.
2. Copie os seguintes arquivos para o diretório local_c10/webapps/p2pd/WEB-INF/lib em todos
os computadores em que o Content Manager foi instalado.
● O arquivo do driver universal, db2jcc.jar.
● o arquivo de licença, db2jcc_license_cisuz.jar
Etapas para Sybase
1. No computador onde o Sybase está instalado, acesse o diretório Sybase_location/jConnect-6/
classes.
2. Copie o arquivo jconn3.jar para o diretório local_c10/webapps/p2pd/WEB-INF/lib em todos
os computadores em que o Content Manager tiver sido instalado e que enviam notificações
para um banco de dados Sybase.
Atualização do ambiente JavaÉ possível utilizar um JavaTM Runtime Environment (JRE) existente ou o JRE fornecido com o IBM®
Cognos® Business Intelligence. Para oferecer suporte aos serviços de criptografia no IBM Cognos
BI, talvez seja necessário atualizar ou definir uma variável de ambiente JAVA_HOME. Dependendo
da sua política de segurança, talvez tenha de instalar o arquivo de política irrestrita do Java
Cryptography Extension (JCE).
JAVA_HOME
Caso queira usar seu próprio JRE e definir JAVA_HOME para esse local no Microsoft® Windows®,
ou caso esteja instalando no UNIX® ou no Linux®, será necessário atualizar JAVA_HOME para
os serviços de criptografia.
Guia de instalação e configuração 99
Capítulo 6: Instalação e configuração do IBM Cognos PowerPlay em um computador
No Windows, defina JAVA_HOME como uma variável de sistema ou de usuário. Se definir como
uma variável de sistema, pode ser necessário reiniciar seu computador para que tenha efeito. Se
definir como uma variável de usuário, faça com que o ambiente no qual o Tomcat estiver sendo
executado possa acessá-lo.
Caso ainda não possua uma variável JAVA_HOME definida no Windows, os arquivos JRE
fornecidos com a instalação serão usados e não será necessário atualizar nenhum arquivo do seu
ambiente. Se JAVA_HOME apontar para uma versão do Java que não é válida para o IBM
Cognos BI, será necessário atualizar JAVA_HOME com o caminho para uma versão válida do
Java.
Arquivo de política irrestrita do JCE
Se usar o JRE padrão do Windows ou fizer download de um JRE para UNIX ou Linux, o JRE
incluirá um arquivo de política restrita que o limita a determinados algoritmos criptográficos e
conjuntos de codificação. Se sua política de segurança exigir uma gama mais ampla de algoritmos
criptográficos e conjuntos de codificação além dos mostrados no IBM Cognos Configuration, faça
download e instale o arquivo de política irrestrita do JCE.
Etapas
1. Certifique-se de que a variável de ambiente JAVA_HOME esteja definida no local JRE.
Por exemplo, para definir JAVA_HOME para o JRE que já está sendo utilizado, o caminho é
local_Java/bin/jre/versão.
2. Se sua política de segurança exigir, faça download e instale o arquivo de política irrestrita do
JCE.
Para IBM Java, o arquivo de política irrestrita do JCE está disponível no seguinte local:
https://www14.software.ibm.com/webapp/iwm/web/preLogin.do?source-jcesdk
Pode ser necessário completar configurações adicionais para definições criptográficas. Para
obter mais informações, consulte "Configuração de definições criptográficas" (p. 239 ).
Configuração do IBM Cognos PowerPlayUse a ferramenta de configuração, o IBM® Cognos® Configuration, para configurar o IBM Cognos
Business Intelligence ou para iniciar e interromper os serviços do IBM Cognos.
Etapas para iniciar o IBM Cognos Configuration em um computador Windows
● No menu Iniciar, clique em Programas, IBM Cognos 10, IBM Cognos Configuration.
Etapas para iniciar o IBM Cognos Configuration em um computador com UNIX ou Linux
● Acesse o diretório c10_location/bin e digite
./cogconfig.sh
100 IBM Cognos Business Intelligence PowerPlay
Capítulo 6: Instalação e configuração do IBM Cognos PowerPlay em um computador
Configurar propriedades de ambiente no IBM Cognos ConfigurationEspecifique o nome do servidor ou o endereço IP nas propriedades URI usadas pelo IBM® Cognos®
Business Intelligence. Isso garantirá que os usuários em locais diferentes possam se conectar a
relatórios e painéis de controle enviados por e-mail. Por padrão, as propriedades do URI especificam
o localhost.
Etapas
1. Inicie o IBM Cognos Configuration.
2. Na janela Explorer, clique em Ambiente.
3. Na janela Propriedades, mude a porção localhost de todas as propriedades URI para o nome
ou endereço IP do servidor do IBM Cognos BI, fazendo o seguinte:
● Para URIs do Content Manager, clique no valor e, em seguida, no botão de edição. Mude
o valor e clique em OK.
● Para todas as outras propriedades URI, clique no valor e altere-o.
4. Na janela Explorer, em Segurança > Criptografia, clique em Cognos, o provedor de criptografia
padrão.
5. No grupo de propriedades Configurações da autoridade de certificação, configure a propriedade
Senha.
Grave a senha em um local seguro.
6. No menu Arquivo, clique em Salvar.
Ativação da segurançaPor padrão, o IBM® Cognos® Business Intelligence permite o acesso anônimo. Se quiser utilizar
segurança no ambiente do IBM Cognos BI, desative o acesso anônimo e configure o IBM Cognos
BI para utilizar um provedor de autenticação.
Etapas
1. Na janela Explorer do IBM Cognos Configuration , clique em Segurança > Autenticação >
Cognos.
2. Clique na caixa Valor para Permitir acesso anônimo e selecione Falso.
3. Clique com o botão direito do mouse Autenticação e clique em Novo recurso > Namespace.
4. Na caixa Nome, digite um nome para o namespace de autenticação.
5. Na lista Tipo, clique no tipo de namespace apropriado e clique em OK.
O novo recurso provedor de autenticação aparece na janela Explorer, no componente
Autenticação.
6. Na janela Propriedades, na propriedade ID do namespace, especifique um identificador exclusivo
para o namespace.
Guia de instalação e configuração 101
Capítulo 6: Instalação e configuração do IBM Cognos PowerPlay em um computador
Para obter mais informações sobre a configuração do IBM Cognos BI para utilizar um provedor
de autenticação, consulte "Configuração de componentes do IBM Cognos para utilizar
provedores de autenticação" (p. 193 ).
Para obter mais informações sobre a configuração do IBM Cognos BI para utilizar um provedor
de autenticação, consulte "Configuração de componentes do IBM Cognos BI para utilizar um
provedor de autenticação" no Guia de instalação e configuração.
7. No menu Arquivo, clique em Salvar.
Definição de propriedades de conexão do banco de dados para o armazenamentode conteúdo
Deve-se especificar as informações do servidor de banco de dados para garantir que o Content
Manager possa ser conectado ao banco de dados que você utiliza para o armazenamento de conteúdo.
O Content Manager usa o logon do banco de dados para acessar o armazenamento de conteúdo.
Após definir as propriedades de conexão de banco de dados, é possível testar a conexão entre o
Content Manager e o armazenamento de conteúdo.
Em um ambiente de produção, use um banco de dados de nível empresarial para armazenamento
do conteúdo. Se estiver usando o Banco de dados de conteúdo do Cognos em um sistema de teste
ou prova de conceito, poderá usar os recursos no portal de administração para fazer backup e
arquivar os dados antes de mudar para um banco de dados de nível empresarial no ambiente de
produção. Para obter mais informações, consulte o tópico sobre como implantar todo o
armazenamento de conteúdo no Guia de administração e segurança.
Se o Cognos Content Database estiver no mesmo computador do Content Manager no ambiente
de produção, depois de configurar o produto IBM® Cognos Business Intelligence para usar um
banco de dados de nível empresarial para o armazenamento de conteúdo, desinstale o Cognos
Content Database.
Se estiver atualizando do ReportNet® ou de uma versão anterior do IBM Cognos BI, configure o
IBM Cognos BI para apontar para uma cópia do banco de dados de armazenamento de conteúdo
existente. Depois de salvar a configuração e iniciar o serviço IBM Cognos, os dados no
armazenamento de conteúdo são automaticamente atualizados e não podem ser utilizados por uma
versão anterior. O uso de cópia do banco de dados original com a nova versão permite manter o
ReportNet ou a versão anterior sendo executada com os dados originais.
Certifique-se de que um dos servidores suportados foi usado para criar o armazenamento de
conteúdo.
Etapa para o DB2® nos sistemas operacionais Linux®, UNIX® ou Microsoft® Windows®
1. No local onde o Content Manager foi instalado, inicie o IBM Cognos Configuration.
2. Na janela Explorer, em Acesso a dados, Content Manager, clique em Armazenamento de
conteúdo.
3. Na janela Propriedades, na propriedade Nome do banco de dados, digite o nome ou alias do
banco de dados.
4. Altere as credenciais de logon para especificar uma ID e senha de usuário válidas:
102 IBM Cognos Business Intelligence PowerPlay
Capítulo 6: Instalação e configuração do IBM Cognos PowerPlay em um computador
● Clique na caixa Valor ao lado da propriedade ID do usuário e senha e clique no botão de
edição quando ele aparecer.
● Digite os valores apropriados e clique em OK.
5. Para usar a conexão JDBC tipo 4, na propriedade Servidor do banco de dados e número da
porta, digite um valor, usando a sintaxe host:porta.
Se deixar esta propriedade em branco, a conexão JDBC tipo 2 será usada.
Para obter mais informações sobre as diferenças entre os tipos de drivers, consulte "Opções de
driver JDBC para usar o banco de dados DB2 como armazenamento de conteúdo" (p. 96 ).
6. No menu Arquivo, clique em Salvar.
As credenciais de logon são imediatamente criptografadas.
7. Para testar a conexão entre o Content Manager e o banco de dados de armazenamento de
conteúdo, no menu Ações, clique em Testar.
O Content Manager se conecta ao banco de dados, verifica as permissões do banco de dados
e cria e preenche uma tabela. A tabela não é excluída e é usada todas as vezes que o teste for
feito.
Etapas para o DB2 em z/OS
1. No local onde o Content Manager foi instalado, inicie o IBM Cognos Configuration.
2. Na janela Explorer, em Acesso a dados, Content Manager, clique em Armazenamento de
conteúdo.
3. Na janela Propriedades, na propriedade Nome do banco de dados, digite o nome ou alias do
banco de dados.
4. Altere as credenciais de logon para especificar uma ID e senha de usuário válidas:
● Clique na caixa Valor ao lado da propriedade ID do usuário e senha e clique no botão de
edição quando ele aparecer. Verifique se especificou a mesma ID de usuário que a de
CMSCRIPT_USERNAME ao criar os espaços de tabela.
● Digite os valores apropriados e clique em OK.
5. Para usar a conexão JDBC tipo 4, na propriedade Servidor do banco de dados e número da
porta, digite um valor, usando a sintaxe host:porta.
Para se conectar ao DB2® em z/OS®, será necessário usar a conexão JDBC tipo 4.
Para obter mais informações sobre as diferenças entre os tipos de drivers, consulte "Opções de
driver JDBC para usar o banco de dados DB2 como armazenamento de conteúdo" (p. 96 ).
6. Na janela Explorer, clique em Configuração Local.
7. Na janela Propriedades, próximo a Propriedades avançadas, clique dentro da caixa Valor e
clique no botão de edição.
A caixa de diálogo Valor - Propriedades avançadas será exibida.
Guia de instalação e configuração 103
Capítulo 6: Instalação e configuração do IBM Cognos PowerPlay em um computador
8. Para adicionar os parâmetros usados para criar os espaços de tabelas, clique em Adicionar.
Todos os parâmetros, exceto CMSCRIPT_USERNAME, são adicionados.
9. No menu Arquivo, clique em Salvar.
As credenciais de logon são imediatamente criptografadas.
10. Para testar a conexão entre o Content Manager e o banco de dados de armazenamento de
conteúdo, no menu Ações, clique em Testar.
Isto testa a conexão entre o Content Manager e o banco de dados do armazenamento de
conteúdo.
Etapas para Microsoft SQL Server, Oracle, Informix e Sybase
1. No computador onde o Content Manager foi instalado, inicie o IBM Cognos Configuration.
2. Na janela do Explorer, em Acesso a dados, Content Manager, clique com o botão direito do
mouse em Armazenamento de conteúdo e clique em Excluir.
Isso exclui a conexão ao recurso padrão. O Content Manager pode acessar apenas um
armazenamento de conteúdo.
3. Clique com o botão direito em Content Manager, e clique em Novo recurso, Banco de dados.
4. Na caixa Nome, digite um nome para o recurso.
5. Na caixa de seleção Tipo, selecione o tipo de banco de dados e clique em OK.
Se foi instalada mais de uma versão do IBM Cognos BI, será necessário usar um armazenamento
de conteúdo diferente para cada versão. Quando um armazenamento de conteúdo é usado com
uma nova versão do IBM Cognos BI, não poderá ser usado com uma versão anterior.
Dica: se desejar usar um par de valores de palavra-chave do Oracle Net8 para gerenciar a
conexão do banco de dados, selecione Banco de dados Oracle (avançado).
6. Na janela Propriedades, forneça valores dependendo do tipo de seu banco de dados:
● Se um banco de dados Microsoft® SQL Server for utilizado, digite os valores apropriados
para as propriedades Servidor de banco de dados com número da porta ou nome da instância
e Nome do banco de dados.
Para um banco de dados do Microsoft SQL Server, é possível escolher um número de porta,
como 1433, ou uma instância denominada como o valor para a propriedade Servidor de
bancos de dados com número de porta ou nome da instância.
Para a propriedade Servidor de bancos de dados com número de porta ou nome da instância, inclua o nome da instância se existirem várias instâncias do Microsoft SQL Server.
Para se conectar a uma instância denominada, é necessário especificar o nome da instância
como uma propriedade URL JavaTM Database Connectivity (JDBC) ou de fonte de dados.
Por exemplo, digite localhost\instance1. Se não forem especificadas propriedades de nome
de instância, é criada uma conexão com a instância padrão.
104 IBM Cognos Business Intelligence PowerPlay
Capítulo 6: Instalação e configuração do IBM Cognos PowerPlay em um computador
Observe que as propriedades especificadas para a instância denominada, junto com a ID
e senha de usuário e nome do banco de dados, são usados para criar um URL JDBC. Eis
um exemplo:
jdbc:JSQLConnect://localhost\\instance1/user=sa/mais propriedades como solicitado
Para se conectar a uma instância nomeada, é necessário especificar o nome da instância.
Por exemplo, digite localhost\instance1. Se o nome de uma instância não for especificado,
será criada uma conexão com a instância padrão.
● Se usar um banco de dados Oracle, digite os valores apropriados para as propriedades
Servidor do banco de dados e número da porta e Nome do serviço.
● Se usar um banco de dados avançado do Oracle, para a propriedade Especificador do banco
de dados, digite o par de valores de palavra-chave Oracle Net8 para a conexão.
Eis um exemplo:
(description=(address=(host=myhost)(protocol=tcp)(port=1521)(connect_data=(sid=(orcl)))))
Se o banco de dados avançado do Oracle foi selecionado, o IBM Cognos BI utiliza recursos
Oracle orientados para empresa para selecionar um ouvinte, mudar para outro ouvinte se
o primeiro falhar, reconectar-se automaticamente ao banco de dados se a conexão falhar,
e equilibrar solicitações de conexão entre ouvintes e entre distribuidores.
● Se for utilizado um banco de dados Informix®, digite os valores adequados para as
propriedades Servidor do banco de dados e número da porta e Nome do banco de dados.
● Se usar um banco de dados Sybase, digite os valores apropriados para as propriedades
Servidor do banco de dados e número da porta e Nome do banco de dados.
7. Para configurar credenciais de logon, especifique uma ID e senha de usuário:
● Clique na caixa Valor ao lado da propriedade ID do usuário e senha e clique no botão de
edição quando ele aparecer.
● Digite os valores apropriados e clique em OK.
8. Se hospedar mais de um banco de dados de armazenamento de conteúdo na instância Informix,
crie a propriedade avançada CMSCRIPT_CS_ID e especifique a conta na qual a instância é
executada:
● Na janela Explorer, clique em Configuração Local.
● Na janela Propriedades, clique na coluna Valor para Propriedades avançadas e, em seguida,
clique no botão Editar .
● Na caixa de diálogo Valor - Propriedades avançadas, clique em Adicionar.
● Na coluna Nome, digite CMSCRIPT_CS_ID
● Na coluna Valor, digite o ID de usuário da conta na qual a instância do armazenamento
de conteúdo é executada.
Guia de instalação e configuração 105
Capítulo 6: Instalação e configuração do IBM Cognos PowerPlay em um computador
Use uma conta de usuário diferente para cada instância do banco de dados de conteúdo
do Informix.
9. No menu Arquivo, clique em Salvar.
As credenciais de logon são imediatamente criptografadas.
10. Para testar a conexão entre o Content Manager e o banco de dados de armazenamento de
conteúdo, no menu Ações, clique em Testar.
O Content Manager se conecta ao banco de dados, verifica as permissões do banco de dados
e cria e preenche uma tabela. A tabela não é excluída e é usada todas as vezes que o teste for
feito.
O Content Manager agora pode criar as tabelas necessárias no armazenamento de conteúdo ao
iniciar o serviço IBM Cognos pela primeira vez. Se as propriedades de conexão não forem
especificadas corretamente, não será possível iniciar os serviços IBM Cognos.
Especificar uma conexão para uma conta do servidor de e-mailSe desejar enviar relatórios por e-mail, é necessário configurar conexão com uma conta de servidor
de e-mail.
É necessário alterar a parte do nome de host do URI do gateway de localhost para o endereço IP
do computador ou para o nome do computador. Do contrário, o URL no e-mail irá conter localhost
e os usuários remotos não poderão abrir o relatório.
Etapas
1. Na janela Explorer, em Acesso a dados, clique em Notificação.
2. Na janela Propriedades, para a propriedade Servidor de correio SMTP, digite o nome do host
e da porta de seu servidor de correio SMTP (saída).
Dicas
Para conseguir abrir relatórios que são enviados por e-mail, altere a parte do nome de host do
URI do gateway de localhost para o endereço IP do computador ou para o nome do computador.
Do contrário, o URL no e-mail irá conter localhost e os usuários remotos não poderão abrir o
relatório.
Para conseguir abrir relatórios enviados como links, verifique se o URI de gateway nos servidores
de relatórios e servidores de notificação especifica um conteúdo do IBM Cognos de hospedagem
de conteúdo do servidor Web acessível. Se tiver usuários móveis acessando os links remotamente,
considere o uso de um URI externo.
3. Clique na caixa de seleção Valor próxima à propriedade Conta e senha e clique no botão de
edição quando aparecer.
4. Digite os valores adequados na caixa de diálogo Valor - Conta e senha e clique em OK.
Dica: Se as credenciais de logon não forem solicitadas pelo servidor SMTP, remova as
informações padrão para a propriedadeConta e senha. Quando surgir o prompt de confirmação
para deixar esta propriedade em branco, clique em Sim. Certifique-se o nome de usuário padrão
106 IBM Cognos Business Intelligence PowerPlay
Capítulo 6: Instalação e configuração do IBM Cognos PowerPlay em um computador
foi removido. Do contrário, a conta padrão é usada e as notificações não funcionarão
corretamente.
5. Na janela Propriedades, digite o valor apropriado para a conta do remetente padrão.
6. Teste as conexões de servidores de correio. Na janela Explorer, clique com o botão direito em
Notificação e clique em Testar.
O IBM Cognos Business Intelligence testa a conexão do servidor de e-mail.
Se não planeja enviar relatórios por e-mail ou não deseja configurar uma conta de servidor de
correio imediatamente, não é necessário. Entretanto, ao salvar a configuração e, em seguida, iniciar
os serviços no IBM Cognos Configuration, uma mensagem de alerta é exibida quando a conexão
do servidor de correio é testada. Ignore, com segurança, o aviso.
Configuração de namespaces do IBM Cognos Series 7 no IBM Cognos BICaso queira migrar informações de segurança ou conteúdo protegido do IBM® Cognos® Series 7
para o IBM Cognos Business Intelligence, é necessário configurar um namespace no IBM Cognos BI
que seja idêntico ao namespace do IBM Cognos Series 7.
É possível configurar vários namespaces para autenticação no IBM Cognos BI. Para obter mais
informações, consulte "Configuração de componentes do IBM Cognos para utilizar provedores de
autenticação" (p. 193 ).
Observação: não é possível utilizar um arquivo IBM Cognos Series 7 Local Authentication Export
(LAE) para autenticar usando os componentes do IBM Cognos BI.
É recomendável que todos os namespaces do IBM Cognos Series 7 utilizem o mesmo IBM Cognos
Series 7 Ticket Server primário. Do contrário, podem ser recebidos erros ou avisos de autenticação
mais de uma vez.
Caso altere as informações de configuração armazenadas no servidor de diretório utilizado para o
IBM Cognos Series 7, é necessário reiniciar o serviço IBM Cognos BI antes que as alterações entrem
em vigor na instalação do IBM Cognos.
Um usuário deve estar em pelo menos uma classe de usuário do Access Manager para que possa
fazer login nos componentes do IBM Cognos BI.
Etapas
1. Inicie o IBM Cognos Configuration.
2. Na janela Explorer, em Segurança, clique em Autenticação e depois em Cognos.
3. Clique na caixa Valor para Permitir acesso anônimo e selecione Falso.
4. Na janela Explorer, clique com o botão direito em Autenticação e selecione Novo recurso,
Namespace.
5. Na caixa Nome, digite um nome para o namespace de autenticação.
6. Na lista Tipo, clique em IBM Cognos Series 7 e depois em OK.
Guia de instalação e configuração 107
Capítulo 6: Instalação e configuração do IBM Cognos PowerPlay em um computador
O novo recurso provedor de autenticação aparece na janela Explorer, no componente
Autenticação.
7. Na janela Propriedades do Recurso, especifique os valores obrigatórios.
Determinados valores devem corresponder aos valores utilizados quando o namespace do IBM
Cognos Series 7 foi configurado no Configuration Manager. No Configuration Manager, as
propriedades estão localizadas em Serviços, Access Manager - Runtime, Directory Server.
● Para ID do Namespace, especifique um identificador exclusivo para o namespace.
● Para Host e porta, digite o mesmo valor usado para a propriedade Computador no
Configuration Manager.
O formato deve ser idêntico. Se utiliza um endereço IP no IBM Cognos Series 7, digite o
mesmo endereço IP. Se utiliza um nome host de rede no IBM Cognos Series 7, digite o
mesmo nome host de rede.
● Para Nome Distinto Base, digite o mesmo valor usado para a propriedade Nome Distinto
Base (DN) no Configuration Manager.
● Para Nome do namespace, digite o mesmo valor usado para a propriedade Namespace
padrão no Configuration Manager.
Este valor diferencia maiúsculas de minúsculas e deve corresponder exatamente.
8. Especifique os valores para todas as outras propriedades necessárias para garantir que os
componentes do IBM Cognos BI possam localizar e utilizar o provedor de autenticação existente.
Se a versão do namespace do IBM Cognos Series 7 for 16.0, verifique se a propriedade
Codificação de dados está definida comoUTF-8. Além disso, os computadores onde o Content
Manager está instalado deverão usar a mesma localidade que os dados no namespace do IBM
Cognos Series 7.
9. Se o ambiente do namespace inclui a versão 15.2 do namespace do IBM Cognos Series 7,
desative a configuração Series7NamespacesAreUnicode.
● Na janela Propriedades, no valor Propriedades avançadas, clique no botão de edição.
● Na janela Valor - Propriedades avançadas, clique em Adicionar.
● Na caixa Nome, digite Series7NamespacesAreUnicode.
● Na caixa Valor, digite Falso e depois clique em OK.
10. Na janela Propriedades, verifique se as propriedades Configurações de cookie, certifique-se de
que Caminho, Domínio e Sinalizador de segurança habilitado correspondem às configurações
definidas para o IBM Cognos 7.
11. No menu Arquivo, clique em Salvar.
108 IBM Cognos Business Intelligence PowerPlay
Capítulo 6: Instalação e configuração do IBM Cognos PowerPlay em um computador
Configuração do servidor webPara todas as instalações, antes de usar páginas da web geradas pelo IBM® Cognos® Business
Intelligence, é necessário configurar o servidor web. É necessário criar diretórios virtuais, ou aliases,
para que os usuários possam se conectar ao IBM Cognos BI no portal. Se planejar executar mais
de um produto IBM Cognos BI, ou diversas instâncias do mesmo produto em um computador, é
necessário criar um pool de aplicativos separado para cada produto ou instância e depois associar
os aliases para esse produto ou instância ao pool de aplicativos. As etapas para criar um pool de
aplicativo variam dependendo de seu sistema operacional.
Para usar o IBM Cognos BI para relatórios, é preciso configurar também a validade do conteúdo
para o diretório de imagens no servidor web para que o navegador web não verifique o status da
imagem depois do primeiro acesso.
Nos sistemas operacionais UNIX® e Linux®, a conta na qual o servidor web é executado deve ter
acesso de leitura para o arquivo cogstartup.xml no diretório local_c10/configuration. Por padrão
o arquivo cogstartup.xml possui permissão de acesso para outros. Se o servidor web for executado
em um grupo específico, é possível mudar as permissões do arquivo cogstartup.xml para garantir
que pertença ao mesmo grupo do servidor web. É possível então remover a permissão de leitura
para os outros.
Etapas para criar diretórios virtuais
1. Crie os diretórios virtuais mostrados na tabela a seguir:
PermissãoLocalizaçãoAlias
Leituralocal_c10/webcontentibmcognos
Execuçãolocal_c10/cgi-binibmcognos/cgi-bin
É possível usar um nome diferente de ibmcognos nos aliases. Entretanto, é necessário usar cgi
bin como a segunda parte do alias e mudar o diretório virtual na propriedade URI do gatewaypara coincidir com o novo alias do IBM Cognos.
Para o servidor web Apache, certifique-se de que o alias ibmcognos/cgi-bin foi definido antes
do alias ibmcognos no arquivo httpd.conf no diretório instalação_Apache/conf. O alias
ibmcognos/cgi-bin deve ser definido como um ScriptAlias.
2. Se desejar usar o navegador de imagens do Report Studio, ative o Web Distributed Authoring
and Versioning (WebDAV) no servidor web.
Se utilizar o servidor web Apache, especifique em qual diretório ativar o WebDAV. Para obter
informações sobre como configurar o WebDAV, consulte a documentação de seu servidor web.
Caso utilize o Microsoft® Internet Information Services (IIS), ative as propriedades Read e
Directory Browsing para a URL que deseja acessar.
3. Para relatórios no IBM Cognos BI, defina a validade do conteúdo no diretório virtual local_c10/
webcontent/pat/images no servidor web.
Guia de instalação e configuração 109
Capítulo 6: Instalação e configuração do IBM Cognos PowerPlay em um computador
Cada vez que um usuário abre o Report Studio, o navegador web verifica com o servidor web
para determinar se as imagens são atuais. Devido ao fato de haver mais de 600 imagens, isto
pode resultar em tráfico de rede excessivo. É possível adiar esta verificação até uma data
específica usando o recurso de validade do conteúdo do servidor web.
Para obter informações em como definir a validade do conteúdo, consulte a documentação de
seu servidor web.
Observação: ao atualizar, os usuários do Report Studio devem limpar o cache de seus
navegadores para obterem as imagens mais recentes.
Se utilizar aliases web diferentes de ibmcognos, ou o servidor web estiver em outro computador,
ou estiver utilizando o Microsoft Internet Application Interface (ISAPI), apache_mod ou um gateway
de servlet, altere o URI do gateway ao configurar componentes do IBM Cognos.
Etapas para a criação de um pool de aplicativos no Windows Server 2008
1. No sistema operacional Microsoft® Windows®, no menu Iniciar, selecione Painel de Controle
> Desempenho e manutenção >Ferramentas Administrativas.
2. Inicie o Internet Information Services (IIS) Manager.
Web Management Tools e World Wide Web Services estão ativados automaticamente.
3. A partir da raiz (o nome de seu sistema e seu usuário), selecione Features View.
4. Na seção IIS, inicie ISAPI and CGI Restrictions.
5. Selecione Edit Feature Settings e ative Allow unspecified CGI modules, em seguida clique em
OK.
6. Adicione os aliases. Por example, local_c10,local_c10/cgi-bin.
7. Selecione o alias cgi-bin e certifique-se de que a opção Features View esteja selecionada.
8. Clique com o botão direito em Application Pools e selecione Adicionar
9. Na caixa de diálogo, digite um alias web e o caminho correspondente para o IBM Cognos BI
webcontent.
10. Repita as etapas 8 e 9 para adicionar o alias da Web seguinte.
11. Selecione Default Web Site.
12. Abra Handler Mappings.
13. Selecione o mapeamento CGI-cgi.
14. No quadro direito, clique em Revert to Inherited.
15. Expanda o aplicativo que aponta para o local do webcontent.
16. Expanda o nó do seu aplicativo cgi-bin.
17. Adicione um mapeamento que aponte para *.cgi e chame-o de CGI-cgi.
18. Selecione o mapeamento CGI-cgi.
110 IBM Cognos Business Intelligence PowerPlay
Capítulo 6: Instalação e configuração do IBM Cognos PowerPlay em um computador
19. No quadro direito, clique em Revert to Inherited.
20. Reinicie o servidor IIS.
21. Encontre a pasta que contem cgi-bin (local_c10/cgi-bin) e clique nela com o botão direito do
mouse.
22. Selecione a guia Segurança.
23. Adicione o usuário Network Services concedendo todas as permissões, exceto Full Control.
24. Clique com o botão direito do mouse em Serviço do Cognos e selecione Propriedades.
25. Clique na guia Logon.
26. Clique em This account e digite Network Service como o usuário.
27. Exclua os valores de Senha e de Confirm the password.
28. Clique em OK.
Inicie os serviços do IBM CognosPara registrar o serviço do IBM® Cognos® Business Intelligence de forma que os usuários possam
acessá-lo por meio do IBM Cognos Connection, é necessário iniciar os serviços. Antes de iniciar os
serviços, teste a configuração utilizando o recurso de teste do IBM Cognos Configuration.
Nos sistemas operacionais Microsoft® Windows®, o serviço IBM Cognos é configurado para iniciar
automaticamente por padrão. Nos sistemas operacionais UNIX® e Linux®, para iniciar
automaticamente o processo do IBM Cognos BI, é necessário configurar o processo como daemon.
Para obter mais informações, consulte a documentação do sistema operacional.
Para usar o IBM Cognos BI para criação de relatórios, é necessário instalar e configurar os
componentes do servidor, iniciar o serviço do IBM Cognos e ter um pacote que faça referência a
uma fonte de dados disponível. Observe que se estiver atualizando, é possível continuar a usar as
mesmas fontes de dados.
Antes de começar, certifique-se de que uma conta de usuário ou serviço esteja configurado. Para
obter mais informações, consulte "Configuração de contas de usuário ou contas de serviço de rede
no IBM Cognos Business Intelligence" (p. 52 ).
Etapas
1. Inicie o IBM Cognos Configuration.
Se estiver atualizando, será exibida uma mensagem indicando que os arquivos de configuração
foram detectados e atualizados para a nova versão.
2. Certifique-se de que as configurações foram salvas, caso contrário, não será possível iniciar o
serviço IBM Cognos.
3. No menu Ações, clique em Testar.
Guia de instalação e configuração 111
Capítulo 6: Instalação e configuração do IBM Cognos PowerPlay em um computador
O IBM Cognos Configuration verifica a disponibilidade de CSK, testa as configurações de
namespace e testa as conexões para o armazenamento de conteúdo e banco de dados de log.
Se estiver usando o banco de dados e o servidor de e-mail, estes também são testados.
Dica: se Testar não estiver disponível para seleção, na janela Explorer, clique em Configuração
Local.
4. Se o teste falhar, configure novamente as propriedades afetadas e faça o teste de novo.
É possível testar alguns componentes individualmente clicando com o botão direito no
componente no painel Explorer e selecionando Testar.
Não inicie o serviço até que haja aprovação em todos os testes.
5. No menu Ações, clique em Iniciar.
Pode levar alguns minutos para o Serviço IBM Cognos iniciar.
Essa ação inicia todos os serviços instalados que não estão sendo executados e registra o serviço
IBM Cognos no Windows.
Teste da instalação e da configuraçãoÉ possível testar as configurações executando o recurso de teste ao configurar o IBM® Cognos®
Business Intelligence. Depois de ter concluído a configuração e iniciado os serviços, teste a instalação
conectando-se ao portal do IBM Cognos BI.
Etapas
1. Abra um navegador web.
2. Teste se o Content Manager está em execução digitando o valor URIs do Content Manager do
IBM® Cognos® Configuration. Por exemplo,
http://host_name:port/p2pd/servlet
O valor padrão para nome_host:porta é localhost:9300.
3. Teste a disponibilidade do distribuidor digitando o valor URI do distribuidor interno do IBM®
Cognos® Configuration. Por exemplo,
http://host_name:port/p2pd/servlet/dispatch
O valor padrão para nome_host:porta é localhost:9300.
Se a resposta exibir uma lista de conteúdo em Pastas públicas, o distribuidor estará disponível.
4. Teste a conexão ao portal do IBM Cognos BI digitando o valor do URI do gateway do IBM
Cognos Configuration.
Pode levar alguns minutos para a página da web abrir. Se a página Bem-vindo do portal do
IBM Cognos BI for exibida, a instalação estará funcionando.
112 IBM Cognos Business Intelligence PowerPlay
Capítulo 6: Instalação e configuração do IBM Cognos PowerPlay em um computador
Instalação e configuração de migração nos computadores comIBM Cognos Series 7
Antes que o Assistente de migração possa ser usado no IBM® Cognos® PowerPlay® para migrar o
conteúdo do IBM Cognos Series 7 do PowerPlay Enterprise Server, Upfront ou IBM Cognos
Connection, é necessário instalar componentes de migração nos computadores com IBM Cognos
Series 7. Os componentes de migração do IBM Cognos Series 7 estão disponíveis para Microsoft®
Windows® e UNIX® no CD do IBM Cognos PowerPlay Server.
Use a seguinte lista de verificação para guiá-lo através das tarefas necessárias para instalar e
configurar o IBM Cognos Migration.
❑ Instale os componentes de migração do IBM Cognos Series 7.
❑ Configure os componentes de migração do IBM Cognos Series 7, se necessário.
❑ Inicie o IBM Cognos Series 7 Migration Service
Para obter informações sobre migração de conteúdo do IBM Cognos Series 7 para o IBM Cognos BI,
incluindo recomendações de configuração para o processo de migração, consulte oGuia de migração
e administração do IBM Cognos PowerPlay.
Instalação do IBM Cognos Series 7 Migration ComponentsCertifique-se de que as instalações do IBM Cognos Series 7 estejam funcionando corretamente antes
de instalar os componentes de migração do IBM Cognos Series 7. Certifique-se de que o Serviço
IBM Cognos Series 7 PowerPlay Enterprise Server e os serviços Upfront, incluindo os serviços IBM
Cognos Upfront Administration Service, IBM Cognos Upfront Data Store e IBM Cognos Upfront
Dispatcher, estejam funcionando.
Instale os componentes de migração do IBM Cognos Series 7 nos computadores IBM Cognos Series
7.
● Para migrar conteúdo de um PowerPlay Enterprise Server, é necessário instalar componentes
de migração do IBM Cognos Series 7 no computador PowerPlay Enterprise Server. Se o Upfront
estiver localizado no mesmo computador também é possível migrar conteúdo do Upfront. A
instalação de componentes de migração no computador PowerPlay Enterprise Server também
suporta a migração de conteúdo PowerPlay publicado no Cognos Connection.
● Para migrar conteúdo do Upfront é necessário instalar o IBM Cognos Series 7 Migration
Components no computador Upfront. Quando o Upfront e o PowerPlay Enterprise Server
estiverem instalados em computadores separados, é necessário instalar o IBM Cognos Series 7
Migration Components nos computadores PowerPlay Enterprise Server e Upfront. Além disso,
é necessário configurar uma localização de rede compartilhada para suportar o processamento
da migração.
Etapas
1. Insira o CD do IBM Cognos PowerPlay Server adequado para seu sistema operacional. No
UNIX, é necessário montar o CD utilizando as extensões de arquivo Rock Ridge
Guia de instalação e configuração 113
Capítulo 6: Instalação e configuração do IBM Cognos PowerPlay em um computador
2. Se a página Bem-vindo não aparecer, execute um dos procedimentos a seguir:
● No Windows, no diretório win32 no CD, clique duas vezes no arquivo issetup.exe.
● No UNIX, no diretório apropriado para o sistema operacional, digite
./issetup
3. Selecione o idioma para utilizar na instalação.
O idioma selecionado determina o idioma do assistente de instalação.
4. Siga as instruções do assistente de instalação.
5. Na página Seleção do componente, desmarque todos os componentes, exceto Componentes de
migração do IBM Cognos Series 7.
6. Na página Vários locais de instalação, especifique a localização do IBM Cognos Series 7 para
instalar os componentes.
O IBM Cognos Series 7 Migration Components deve ser instalado no mesmo diretório do IBM
Cognos Series 7 versão 4 (7.4).
Se estiver instalando os componentes de migração do IBM Cognos Series 7 em um computador
com Microsoft Windows, o local de instalação deve ser uma unidade física e não uma unidade
mapeada. Caso contrário, não será possível iniciar o serviço de migração.
Se for solicitada uma localização de instalação do IBM Cognos BI, é possível aceitar a localização
por padrão ou digitar uma nova. Essa localização é usada para gravar arquivos instalados. Não
é necessário inserir o caminho em uma instalação do IBM Cognos BI em um computador
diferente e não são necessários componentes do IBM Cognos BI no computador IBM do Cognos
Series 7.
7. Na página Informações de configuração para migração, para o Número da porta do serviço
de migração, digite o número da porta que o serviço de migração do IBM Cognos Series 7 deve
usar. O padrão é 21567.
8. Na página Concluir , clique em Concluir.
Assim como outros produtos IBM Cognos, o processo de instalação cria arquivos de log que incluem
informações como detalhes sobre arquivos transferidos e erros de instalação. Os arquivos de log
estão localizados no diretório installation_location\instlog.
Configuração do serviço de migração do IBM Cognos Series 7 para migrações doUpfront em instalações distribuídas do IBM Cognos Series 7
Se o IBM Cognos Series 7 Migration Components foi instalado em um computador PowerPlay
Enterprise Server e um computador Upfront separado, é necessário configurar uma localização de
rede compartilhada. O serviço de migração grava arquivos temporariamente neste local durante o
processo de migração.
As seguintes limitações se aplicam para a migração do Upfront quando o PowerPlay Enterprise
Server e Upfront estiverem em computadores separados.
114 IBM Cognos Business Intelligence PowerPlay
Capítulo 6: Instalação e configuração do IBM Cognos PowerPlay em um computador
Observações
● O PowerPlay Enterprise Server e o Upfront devem acessar PowerCubes usando o mesmo
caminho, como \\nome_máquina\cubes. Se os cubos estiverem localizados no mesmo computador
que o PowerPlay Enterprise Server, este irá acessá-los usando um caminho local e o Upfront
irá acessar os cubos usando um caminho que inclua o nome do computador PowerPlay
Enterprise. A migração do Upfront não funcionará nesta situação.
Etapas
1. Crie uma pasta em uma localização de rede compartilhada que esteja acessível dos computadores
PowerPlay Enterprise Server e Upfront.
Certifique-se que os serviços de migração do PowerPlay Enterprise Server, Upfront e IBM
Cognos Series 7 sejam executados sob uma conta nomeada que possua acesso de gravação para
a pasta.
2. Realize as etapas a seguir em cada computador que possui os componentes de migração do
IBM Cognos Series 7.
● No local_instalação/mig7service, abra o arquivo migs7service_configuration.xml em um
editor XML ou de texto.
● Edite a linha series7-shared-location description para especificar o local de rede e ative a
linha (remova as tags de comentário). Por exemplo,
<series7-shared-location description="Caminho para a pasta compartilhada">\\bott93\
shareT\s7migration</series7-shared-location>
● Salve e feche o arquivo.
3. Reinicie o serviço de migração do IBM Series 7.
A configuração para suportar migração de computadores PowerPlay Enterprise Server e Upfront
separados foi concluída.
Início do IBM Cognos Series 7 Migration ServiceAntes de migrar o conteúdo do IBM Cognos Series 7 PowerPlay para o IBM Cognos PowerPlay, é
necessário iniciar o serviço de migração do IBM Cognos Series 7. No Windows, o serviço de migração
do IBM Cognos Series 7 inicia automaticamente quando é instalado pela primeira vez.
Etapa
● Inicie o serviço de migração:
● No Windows, se o serviço parou, reinicie o serviço de migração usando a entrada do IBM
Cognos Migration Series 7 Service na lista Serviços em Ferramentas administrativas.
● No UNIX, vá para o diretório local_c10/migs7 e inicie o serviço digitando:
./configure.sh --start
Guia de instalação e configuração 115
Capítulo 6: Instalação e configuração do IBM Cognos PowerPlay em um computador
Desinstalação do IBM Cognos BIÉ importante utilizar os programas de desinstalação para remover completamente todos os arquivos
e as modificações dos arquivos do sistema.
Para desinstalar o IBM® Cognos® Business Intelligence, desinstale os componentes e as ferramentas
de modelagem do servidor.
Caso esteja executando o IBM Cognos BI em um ambiente de servidor de aplicativos, use a
ferramenta de administração fornecida com o servidor de aplicativos para interromper o aplicativo,
caso este esteja em execução, e desimplante a porção JavaTM dos componentes do IBM Cognos BI.
Muitos servidores de aplicativos não removem completamente todos os arquivos ou diretórios de
aplicativos implantados durante uma remoção; desta forma, esta ação deverá ser feita manualmente.
Depois de ter removido os componentes do IBM Cognos BI, conclua as etapas nesta seção para
desinstalar no UNIX® e no Microsoft® Windows®.
Importante
● Não exclua os arquivos de configuração e de dados se estiver realizando atualização para uma
nova versão do IBM Cognos BI e se desejar usar os dados de configuração com a nova versão.
● Se estiver utilizando o Cognos Content Database, a localização padrão para os arquivos de
banco de dados está no diretório local_c10/contentstore. Se deseja manter seu banco de dados
depois da desinstalação, não exclua esse diretório.
Desinstalação do IBM Cognos Business Intelligence no UNIX ou LinuxSe não houver mais necessidade do IBM® Cognos® Business Intelligence ou se estiver fazendo uma
atualização nos sistemas operacionais UNIX® ou Linux®, desinstale o IBM Cognos BI.
A desinstalação não remove os arquivos que foram alterados desde a instalação, tais como os de
configuração e dados dos usuários. A localidade da instalação continua no computador, e os arquivos
ficam retidos até que sejam excluídos manualmente.
Etapas
1. Se o console conectado ao computador não for compatível com uma interface gráfica de usuário
baseada em JavaTM, determine o processo de identificação (pid) do processo do IBM Cognos
BI digitando o seguinte comando:
ps -ef | grep cogbootstrapservice
2. Interrompa o processo do IBM Cognos BI:
● Se executar o XWindows, inicie o IBM Cognos Configuration, e do menu Ações clique
em Parar .
● Se não utilizar o XWindows, digite
kill -TERM pid
3. Para desinstalar o IBM Cognos BI, acesse o diretório local_c10/uninstall e digite o comando
apropriado:
116 IBM Cognos Business Intelligence PowerPlay
Capítulo 6: Instalação e configuração do IBM Cognos PowerPlay em um computador
● Caso utilize o XWindows, digite
./uninst -u
● Se não estiver usando o XWindows, execute uma desinstalação autônoma (p. 350 ).
Se não estiver usando o XWindows, execute uma desinstalação autônoma. Para obter mais
informações, consulte o Guia de instalação e configuração.
4. Siga os prompts para completar a desinstalação.
5. Exclua todos os arquivos de Internet temporários dos computadores de navegadores web.
Desinstalação do IBM Cognos Business Intelligence no WindowsSe não houver mais necessidade do IBM® Cognos® Business Intelligence ou se estiver fazendo uma
atualização, desinstale todos os componentes do IBM Cognos BI e o serviço do IBM Cognos.
Se tiver instalado mais de um componente no mesmo local, escolha os pacotes para desinstalação
utilizando o assistente para desinstalação. Todos os componentes do pacote serão desinstalados. É
necessário repetir o processo de desinstalação em cada computador que contenha componentes do
IBM Cognos BI.
Não é necessário fazer backup da configuração e dos arquivos de dados no sistema operacional
Microsoft® Windows®. Estes arquivos são preservados durante a desinstalação.
Feche todos os programas antes de desinstalar o IBM Cognos BI. Do contrário, alguns arquivos
poderão não ser removidos.
A desinstalação não remove os arquivos que foram alterados desde a instalação, tais como os de
configuração e dados dos usuários. A localidade da instalação continua no computador e os arquivos
ficam retidos até que sejam excluídos manualmente. Não exclua os arquivos de configuração e de
dados se estiver atualizando para uma nova versão do IBM Cognos BI e desejar usar os dados de
configuração com a nova versão.
Etapas
1. No menu Iniciar, clique em Programas > IBM Cognos 10 > Desinstalar o IBM Cognos >
Desinstalar o IBM Cognos.
Exibe-se o assistente Desinstalação.
Dica: IBM Cognos BI é o nome padrão da pasta de programa criada durante a instalação. Caso
escolha outro nome, abra a pasta para encontrar o programa.
2. Siga as instruções de desinstalação dos componentes.
O arquivo cognos_uninst_log.htm registra as atividades realizadas pelo assistente de desinstalação
ao desinstalar os arquivos.
Dica: Para encontrar o arquivo de log, verifique o diretório Temp.
3. Exclua todos os arquivos de Internet temporários dos computadores de navegadores web.
Para obter mais informações, consulte a documentação do navegador web.
Guia de instalação e configuração 117
Capítulo 6: Instalação e configuração do IBM Cognos PowerPlay em um computador
Desinstalação do Banco de dados de conteúdo do CognosSe quiser desinstalar apenas o Cognos® Content Database e deixar outros componentes do IBM®
Cognos Business Intelligence no computador, será necessário executar o seguinte procedimento.
Depois de desinstalar o Banco de dados de conteúdo do Cognos é necessário configurar um novo
armazenamento de conteúdo antes de reiniciar o serviço do IBM Cognos.
Se tiver instalado apenas o Cognos Content Database, execute o procedimento para desinstalar o
IBM Cognos BI nos sistemas operacionais UNIX® ou Linux® ou para desinstalar o IBM Cognos BI
no sistema operacional Microsoft® Windows®.
Etapas
1. No computador em que foi instalado o Banco de dados de conteúdo do Cognos, acesse o
diretório local_c10/bin e digite o seguinte comando:
● No Windows, digite
derby.bat uninstall
Este comando remove o serviço do Banco de dados de conteúdo do Cognos.
● No UNIX, digite:
derby.sh stop
Este comando pára o serviço do Banco de dados de conteúdo do Cognos.
2. No diretório local_c10, exclua o diretório derby10.1.2.1.
3. No diretório local_c10/bin, exclua os seguintes arquivos:
● No Windows, derby.bat
● No UNIX, derby.sh e derbyenv.sh
4. No Windows, no diretório local_c10\logs, exclua o arquivo derby.service.
5. No diretório local_c10, abra o arquivo cmplst.txt em um editor de texto.
6. Remova as linhas que contêm valores do Banco de dados de conteúdo do Cognos. Essas linhas
contêm CCD e CMDERBY. Por exemplo:
C8BISRVRCCD_version=
C8BISRVRCCD_name=
CCD_version=
CCD_name=
CMDERBY_version=
CMDERBY_name=
Dica: Também é possível fazer um comentário nas linhas inserindo # no final de cada linha.
7. Salve o arquivo.
8. Inicie o IBM Cognos Configuration.
118 IBM Cognos Business Intelligence PowerPlay
Capítulo 6: Instalação e configuração do IBM Cognos PowerPlay em um computador
9. Em Acesso a dados e Content Manager, faça o seguinte:
● Exclua o Banco de dados de conteúdo do Cognos.
● Configure um novo recurso de banco de dados para apontar para um novo armazenamento
de conteúdo.
Para obter mais informações, consulte "Configuração da conectividade de banco de dados para
o banco de dados de armazenamento de conteúdo" (p. 137 ).
10. Reinicie o IBM Cognos BI .
Desinstalação dos componentes de migraçãoOs componentes de migração do IBM® Cognos® BI são desinstalados quando ao desinstalar o IBM
Cognos BI. Não é possível desinstalar apenas os componentes de migração da instalação do IBM
Cognos BI.
É possível desinstalar os componentes de migração do IBM Series 7 separadamente da instalação
do IBM Cognos Series 7. Após concluir a migração do IBM Cognos Series 7, é possível desinstalar
os componentes de migração de cada computador com IBM Cognos Series 7. No entanto, os
componentes de migração só ficam ativos durante a migração e não afetarão a instalação do IBM
Cognos Series 7 se deixá-los no computador.
Etapa
● Nos computadores com IBM Cognos Series 7, desinstale o componente Migração de relatórios
do Series 7 do IBM Cognos.
Para obter mais informações sobre a desinstalação dos componentes do IBM Cognos Series 7,
consulte o Solution Installation Guide do IBM Cognos Series 7.
Guia de instalação e configuração 119
Capítulo 6: Instalação e configuração do IBM Cognos PowerPlay em um computador
120 IBM Cognos Business Intelligence PowerPlay
Capítulo 6: Instalação e configuração do IBM Cognos PowerPlay em um computador
Capítulo 7: Instalação e configuração doscomponentes do servidor IBM Cognos PowerPlayem computadores diferentes
Utilize o assistente de instalação para selecionar os componentes do servidor que deseja instalar e
o local do computador onde quer que eles fiquem. Somente os componentes escolhidos para
instalação serão copiados do disco para o computador. Caso planeje instalar dois ou mais
componentes do IBM® Cognos® PowerPlay® no mesmo computador, instale-os no mesmo local de
instalação para evitar conflitos entre as portas e outras configurações padrão.
Se o IBM Cognos PowerPlay está sendo instalado com o servidor do IBM Cognos Business
Intelligence, instale e configure primeiro o servidor do IBM Cognos BI. O IBM Cognos PowerPlay
e o IBM Cognos BI devem ter a mesma versão. Para obter mais informações sobre as opções de
instalação distribuída e os requisitos de configuração, consulte "Produtos IBM Cognos que operam
conjuntamente com o IBM Cognos PowerPlay" (p. 34 ).
A instalação do IBM Cognos PowerPlay inclui componentes compatíveis com a migração do
conteúdo do PowerPlay do IBM Cognos Series 7 ao IBM Cognos BI. Se instalar o IBM Cognos
PowerPlay com o IBM Cognos BI, os componentes de migração também suportarão a opção de
abrir um relatório do PowerPlay Studio no Analysis Studio ou no Report Studio.
Os componentes do servidor IBM Cognos PowerPlay incluem o seguinte:
● Content Manager
● Componentes da camada de aplicativos: PowerPlay Server e PowerPlay Administration.
O PowerPlay Administration, que aparece no IBM Cognos Administration, permite a
configuração de opções de migração e para relatório e cubos PowerPlay. Para obter mais
informações, consulte o Guia de migração e administração do IBM Cognos PowerPlay..
● Gateway
Instale o gateway em um computador que também esteja executando um servidor web.
● Banco de dados de conteúdo do Cognos
Se estiver instalando componentes em diversos computadores, é necessário instalar somente
um Banco de dados de conteúdo do Cognos. Se instalar o Banco de dados de conteúdo do
Cognos no mesmo computador que o Content Manager e mais tarde decidir utilizar outro
banco de dados para o armazenamento de conteúdo, desinstale o Banco de dados de conteúdo
do Cognos.
● Componentes de migração IBM Cognos Series 7
Para migrar o conteúdo do IBM Cognos Series 7 PowerPlay para o IBM Cognos PowerPlay, é
necessário instalar os componentes de migração do IBM Cognos Series 7 no computador em
que o IBM Cognos Series 7 PowerPlay Enterprise Server estiver instalado. Para migrar o conteúdo
Licensed Materials – Property of IBM121© Copyright IBM Corp. 2005, 2010.
do PowerPlay do Upfront, também é necessário instalar os componentes de migração do IBM
Cognos Series 7 no computador em que o Upfront estiver instalado.
As amostras de aplicativos para o produto IBM® Cognos® BI estão em um disco separado. Para
usar as amostras, instale-as a partir do disco do IBM Cognos Business Intelligence Samples.
Interrupção da seqüência de serviços
Se for necessário interromper os serviços em um ambiente distribuído, a seqüência é importante.
Interrompa primeiro o serviço do IBM Cognos para os componentes da camada de aplicativos,
seguido do Content Manager em espera e depois o Content Manager ativo.
É importante também interromper os seguintes:
● Servidores web que hospedem conteúdo do IBM Cognos BI.
● Aplicativos relacionados ao serviço do IBM Cognos como o Framework Manager, IBM
Cognos Transformer, IBM Cognos Connection, IBM Cognos Administration e Metric Designer.
● Qualquer aplicativo de SDK em execução.
Atualização da instalação
Se estiver atualizando de uma versão anterior dos produtos IBM Cognos, utilize as etapas de
atualização (p. 57 ).
Caso esteja utilizando PowerCubes protegidos contra um namespace do IBM Cognos Series 7, é
necessário instalar o IBM Cognos PowerPlay em um computador que seja compatível com o IBM
Cognos Series 7.
Caso esteja fazendo a atualização do IBM Cognos BI em um ambiente que inclua versões mais
antigas de outros produtos do IBM Cognos BI, como IBM Cognos BI Controller Versão 8.x, IBM
Cognos BI Planning Versão 8.x ou IBM Cognos BI Analysis for Microsoft Excel® Versão 8.x, instale
a nova versão do IBM Cognos BI em um local separado de outros produtos do IBM Cognos BI e
configure a nova versão do IBM Cognos BI para funcionar independentemente desse produto.
Depois de atualizar o outro produto para uma versão compatível com o IBM Cognos BI, será
possível então configurar os dois produtos para operar juntos.
Instalações do Windows
Para instalações no Microsoft® Windows®, certifique-se de que possui privilégios de administrador
no computador com Windows em que está sendo feita a instalação. Certifique-se também de que
o computador possua variável de sistema TEMP que aponte para o diretório onde se deseja
armazenar os arquivos temporários. Durante a instalação, os arquivos originários do CD são
copiados temporariamente para esse diretório.
Instalações do UNIX
Para instalações no UNIX®, é possível instalar os componentes do servidor usando uma interface
gráfica de usuário ou executando uma instalação em segundo plano. Para executar a instalação no
modo gráfico, o console conectado ao computador UNIX deve ser compatível com uma interface
gráfica de usuário baseada em JavaTM.
122 IBM Cognos Business Intelligence PowerPlay
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
Além disso, o IBM Cognos BI respeita a máscara de criação de modo de arquivo (umask) da conta
que executa o programa de instalação. Isto afeta somente os diretórios de instalação. Não afeta as
permissões de arquivo nos diretórios. Entretanto, os arquivos gerados pelo tempo de execução, tais
como logs, respeitam a máscara. Use o umask 022 no diretório de instalação.
Seqüência de instalação para componentes do servidorEm uma instalação distribuída, a seqüência na qual os componentes são configurados é importante.
Configure inicie os serviços em pelo menos um local em que o Content Manager foi instalado antes
de configurar outros componentes do servidor.
É preciso configurar o componente de gateway por último para que as chaves de criptografia sejam
compartilhadas e a comunicação segura possa ser estabelecida entre os três componentes. O servidor
especificado para a propriedade URI do distribuidor externo no computador de gateway deve ser
o último componente do servidor a iniciar.
É recomendável instalar e configurar todos os componentes do servidor antes de instalar os
componentes do sistema operacional Microsoft® Windows®.
O diagrama a seguir mostra a seqüência do processo de instalação para componentes distribuídos.
Após planejar e preparar o ambiente, instale e configure os componentes do Content Manager, em
seguida o Application Tier Components e só então os gateways. Depois de instalar os componentes
do servidor, instale e configure o Framework Manager.
Fluxo de trabalho distribuído do processo de instalação
Instalação e configuração (servidor)Preparação
para instalação
Planejamento ContentManager
Personalizaçãoda
configuração
Componentes dacamada de aplicativos
Gateway
Instalação econfiguração
FrameworkManager
Navegador da WebArmazenamento de Conteúdo
Requisitos do sistema
DesempenhoAjuste
SegurançaPreferências
1 2 3 4 5 6
Propriedades doambiente
Fonte de dadosde relatórios
Banco de dadosde notificação
Conexão aoArmazenamento de
conteúdo
Propriedades doambiente
Banco de dadosde notificação
Servidor da Web
Propriedades doambiente
Segurança
Propriedades doambiente
Fonte de dadosde relatórios
A sequência para interromper os serviços também é importante. Interrompa primeiro o Application
Tier Components, seguido pelo Content Manager em espera e depois o Content Manager ativo.
Recomendação - instale e configure a instalação básica parainstalações distribuídas
Ao fazer uma instalação distribuída, existem várias opções diferentes de instalação e configuração
que podem ser feitas para personalizar o IBM® Cognos® BI para que ele se adapte à infra-estrutura
corporativa.
Faça primeiro uma instalação básica, o que envolve a instalação de uma ou mais instâncias de cada
um dos componentes de servidor necessários (gateway, Application Tier Components e Content
Guia de instalação e configuração 123
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
Manager) e a instalação do Framework Manager. Execute apenas as tarefas de configuração
requeridas, como configurar componentes distribuídos para que se comuniquem uns com os outros,
para colocar o ambiente distribuído em operação antes de personalizar as configurações.
Mais tarde, é possível adicionar componentes opcionais e personalizar as configurações para que
melhor se adaptem às necessidades de inteligência do negócio.
A seqüência na qual os computadores são configurados é importante. É preciso configurar e, em
seguida, iniciar os serviços em pelo menos um computador onde o Content Manager foi instalado
antes de configurar outros componentes de servidor ou o Framework Manager. Para obter mais
informações, consulte "Seqüência de instalação para componentes do servidor" (p. 123 ).
A forma mais simples e mais rápida de fazer com que o IBM Cognos BI seja executado no ambiente
é garantir que uma instalação básica funcione nesse ambiente.
Instalação e configuração do Content ManagerÉ possível instalar mais de um Content Manager para garantir o failover e é possível instalar o
Content Manager em uma localização separada de outros componentes para melhorar o desempenho.
Os computadores com o Content Manager devem conhecer a localização do armazenamento de
conteúdo, de outros componentes do Content Manager e o banco de dados utilizado para notificação.
Em uma instalação distribuída, pelo menos um dos computadores em que o Content Manager é
instalado deve estar configurado, em execução e acessível antes de configurar outros computadores
em seu ambiente do IBM® Cognos®. Isso garante que o serviço da autoridade de certificação, que
está instalado com o Content Manager, está disponível para emitir certificados a outros
computadores.
Sua instalação pode incluir mais de um Content Manager, cada um em um computador diferente.
Um computador com Content Manager fica ativo e um ou mais computadores com Content Manager
ficam em espera.
Permissões
É possível instalar utilizando autoridade raiz ou não raiz.
Além disso, o IBM® Cognos®BI respeita a máscara de criação de modo de arquivo (umask) da conta
que executa o programa de instalação. Isto afeta somente os diretórios de instalação. Não afeta as
permissões de arquivo nos diretórios. Entretanto, os arquivos gerados pelo tempo de execução, tais
como logs, respeitam a máscara. Recomenda-se o umask 022 no diretório de instalação.
Regras de configuração
Em uma instalação onde exista mais de um componente do Content Manager, ou onde o Content
Manager esteja localizado separadamente, pelo menos um dos Content Manager deve estar
configurado, em execução e acessível antes de configurar outros componentes do ambiente. Isso
garante que o serviço da autoridade de certificação, que está instalado com o Content Manager,
está disponível para emitir certificados a outros computadores do IBM Cognos.
Para obter informações sobre a seqüência do processo de instalação para componentes distribuídos,
consulte "Seqüência de instalação para componentes do servidor" (p. 123 ).
124 IBM Cognos Business Intelligence PowerPlay
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
Regras para o Content Manager ativo
Se estiver instalando diversos componentes do Content Manager, o primeiro computador com o
Content Manager que iniciar torna-se, por padrão, o Content Manager ativo. É possível designar
outro computador com o Content Manager como padrão ativo, utilizando o IBM Cognos
Administration.
Os computadores com Content Manager que ficam em espera servem para proteção de failover.
Se o computador com Content Manager ativo não estiver disponível devido a uma falha de software
ou hardware, um computador com Content Manager em espera é ativado e as solicitações são
direcionadas a ele.
Se o Content Manager ativo falhar, os dados de sessão que não foram salvos serão perdidos. Se
outro Content Manager for ativado, os usuários poderão ser alertados para efetuar o logon.
Para obter informações sobre a ativação do serviço do Content Manager, consulte o Guia de
administração e segurança. Para obter informações sobre os componentes ativos e em espera do
Content Manager, consulte "Componentes ativo e em espera do Content Manager" (p. 125 ).
Em instalações com vários Content Managers, recomendamos configurar o IBM Cognos BI para
utilizar um gateway ISAPI em vez do gateway CGI padrão. Do contrário, o desempenho pode ser
afetado depois do failover.
Atualização
Se estiver atualizando do ReportNet® ou de uma versão anterior do IBM Cognos BI, será possível
usar os dados de configuração existentes. Entretanto, alguns recursos do IBM Cognos BI são novos
e podem exigir configuração.
PowerCubes
Caso planeje instalar o IBM Cognos Transformer e estiver utilizando PowerCubes protegidos contra
um namespace do IBM Cognos Series 7, instale o Content Manager em um computador que suporta
o IBM Cognos Series 7.
Utilize a seguinte lista de verificação para guiá-lo através das tarefas necessárias de configuração
para computadores com Content Manager.
❑ Instale o Content Manager.
❑ Atualize o ambiente Java.
❑ Configure a conectividade do banco de dados com o banco de dados de armazenamento de
conteúdo.
❑ Configure a instalação do Content Manager.
❑ Teste a instalação do Content Manager.
Componentes ativo e em espera do Content ManagerÉ possível instalar qualquer número de Content Managers, embora apenas um fique ativo num
dado momento. As outras instalações agem como uma reserva do Content Manager.
Guia de instalação e configuração 125
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
Os componentes do Content Manager em espera são para proteção de failover. Se o Content
Manager ativo não estiver disponível devido a uma falha de software ou hardware, um Content
Manager em espera é ativado e as solicitações são direcionadas a ele.
Se o Content Manager ativo falhar, os dados de sessão que não foram salvos serão perdidos. Se
outro Content Manager for ativado, os usuários poderão ser alertados para efetuar o logon.
Por padrão, o primeiro Content Manager instalado com o IBM® Cognos® BI é o ativo. Um
administrador de servidor do IBM Cognos BI pode alterar o Content Manager padrão e o Content
Manager ativo a qualquer momento. Quando o IBM Cognos BI é iniciado, o Content Manager
padrão bloqueia o armazenamento de conteúdo impedindo o acesso de todas as outras instalações
do Content Manager. Essas outras instalações do Content Manager entram em espera.
Esse mecanismo de failover funciona porque os distribuidores e o Content Manager comunicam-
se rotineiramente um com o outro. Se um distribuidor não pode mais alcançar o Content Manager,
o distribuidor sinaliza um Content Manager em espera, que se torna o Content Manager ativo. As
outras instalações do Content Manager permanecem em espera para continuar o suporte de failover.
Os Content Managers em espera recuperam as configurações criptográficas, como a chave simétrica
comum (utilizada para criptografar e descriptografar dados) do Content Manager ativo.
Instalação dos componentes do Content ManagerPara instalar o Content Manager, utilize o disco para seu sistema operacional. No assistente de
instalação, desmarque todos os componentes, exceto Content Manager. Se desejar usar um Banco
de dados do conteúdo do Cognos, selecione este componente também, a menos que deseje instalar
em um servidor separado.
Se estiver instalando o IBM® Cognos® PowerPlay® para trabalhar com o IBM Cognos Business
Intelligence, instale os componentes do Content Manager do PowerPlay nos mesmos computadores
que incluem os componentes do Content Manager do IBM Cognos BI.
Se estiver instalando vários Content Managers, certifique-se de que os relógios do sistema nos
computadores com Content Manager estejam sincronizados para recuperação failover entre os
Content Managers.
Banco de dados de conteúdo do Cognos
Caso deseje utilizar o Banco de dados de conteúdo do Cognos como armazenamento de conteúdo,
selecione a opção correspondente no assistente de instalação. Se estiver instalando componentes
em diversos computadores, é necessário instalar somente um Banco de dados de conteúdo do
Cognos. Se instalar o Banco de dados de conteúdo do Cognos no mesmo computador que o Content
Manager e mais tarde decidir utilizar outro banco de dados para o armazenamento de conteúdo,
desinstale o Banco de dados de conteúdo do Cognos.
Etapas para UNIX e Linux
1. Caso esteja fazendo a instalação em um diretório com outros componentes do IBM Cognos
BI, interrompa o serviço do IBM Cognos.
2. Defina a variável de ambiente JAVA_HOME para indicar o local de instalação do JavaTM
Runtime Environment (JRE).
126 IBM Cognos Business Intelligence PowerPlay
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
Um exemplo de local de instalação de um Java Runtime Environment é
/directory/java/versão_java/jre.
O IBM Cognos BI exige um JVM, como IBM Java, para executar no Linux®.
Se estiver instalando em um local com outros componentes do IBM Cognos BI, use a variável
de ambiente JAVA_HOME existente.
3. No HP-UX, defina a variável de ambiente _M_ARENA_OPTS da seguinte forma:
_M_ARENA_OPTS 1:4
Isso aumenta a alocação de memória para o HP-UX para que se encaixe melhor em outros
sistemas operacionais UNIX®.
4. No AIX, defina a variável de ambiente AIXTHREAD_SCOPE da seguinte forma:
AIXTHREAD_SCOPE=S
Isto define o escopo de contenção dos segmentos do usuário para todo o sistema, que suporta
programações mais eficientes dos segmentos do usuário.
5. Se estiver instalando a partir de um download, acesse o local em que os arquivos de instalação
foram baixados e extraídos.
6. Se estiver instalando de um disco, monte o disco usando extensões de arquivo Rock Ridge.
Para montar o disco em HP-UX, faça o seguinte:
● Adicione o diretório pfs_mount no caminho.
Por exemplo,
PATH=/usr/sbin/:$PATH
exporte PATH
● Para iniciar os daemons NFS solicitados e executar os daemons em segundo plano, digite
bg pfs_mountd e depois bg pfsd
● Para montar a unidade, digite
pfs_mount -t rrip <device><mount_dir> -o xlat=unix
Por exemplo,
pfs_mount /dev/dsk/c0t2d0 /cdrom -o xlat=unix
Agora é possível instalar ou copiar arquivos como um usuário que não seja o usuário raiz
utilizando um disco do IBM Cognos a partir dessa unidade.
● Ao concluir a instalação, digite pfs_umount /cdrom e desabilite os daemons pfsd e
pfs_mountd para desmontar o disco.
7. Para iniciar o assistente de instalação, vá para o diretório do sistema operacional e digite
./issetup
Observação: Ao utilizar o comando issetup com o XWindows, os caracteres japoneses em
mensagens e arquivos de log podem ficar corrompidos. Ao instalar em japonês no UNIX ou
Guia de instalação e configuração 127
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
Linux®, configure primeiro as variáveis de ambiente LANG=C e LC_ALL=C (onde C é o código
do idioma, por exemplo, ja_JP.PCK no Solaris) e, então, execute o assistente de instalação.
Se não estiver usando o XWindows, execute uma instalação autônoma (p. 345 ).
8. Siga as instruções do assistente de instalação e copie os arquivos necessários para seu
computador.
● Ao selecionar o diretório, considere o seguinte:
Instale o Content Manager em um diretório que contenha apenas caracteres ASCII no nome
do caminho. Alguns servidores web UNIX e Linux só suportam caracteres ASCII nos nomes
dos diretórios.
Se estiver instalando o IBM Cognos BI em um computador que possui o ReportNet ou
uma versão anterior do IBM Cognos BI e desejar manter a versão anterior, é necessário
instalar o IBM Cognos BI em um diretório diferente.
Se estiver fazendo uma instalação em um diretório que contém outros componentes do
IBM Cognos BI, haverá uma solicitação para criar cópias de backup dos arquivos que serão
substituídos.
● Ao selecionar os componentes, desmarque todos, exceto Content Manager.
Se deseja usar o banco de dados pré-configurado, selecione também Banco de dados de
conteúdo Cognos.
9. Na página Concluir do assistente de instalação, faça o seguinte:
● Se desejar ver os arquivos de log, clique em Exibir para o arquivo de log apropriado.
● Se desejar ver as últimas informações sobre o produto, assinale a caixa de seleção das Notas
de versão do IBM Cognos.
● Não configure o IBM Cognos BI imediatamente porque é necessário realizar outras tarefas
antes para garantir que o ambiente esteja devidamente configurado. Verifique se a caixa
de seleção IBM Cognos Configuration está desmarcada.
Será possível configurar o IBM Cognos BI posteriormente com o IBM Cognos Configuration,
digitando cogconfig.sh no diretório local_c10/bin ou executando uma configuração silenciosa
ou editando cogstartup.xml no diretório local_c10/configuration.
● Clique em Concluir.
10. Anexe o diretório local_c10/bin à variável de ambiente do caminho da biblioteca apropriada.
● Para Solaris e Linux, LD_LIBRARY_PATH
● Para AIX, LIBPATH
● Para HP-UX, SHLIB_PATH
11. No Linux, defina a variável do ambiente da IMPRESSORA ao nome de sua impressora.
128 IBM Cognos Business Intelligence PowerPlay
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
Se deseja instalar o Banco de dados de conteúdo do Cognos em um computador diferente, execute
o assistente de instalação no servidor de banco de dados e selecione apenas o componente Banco
de dados de conteúdo do Cognos.
Se desejar que os usuários vejam a documentação do produto em um idioma diferente do inglês, é
necessário instalar o componente Supplementary Language Documentation no mesmo local que os
componentes de gateway foram instalados. Para obter mais informações, consulte "Instalação da
documentação do produto traduzida" (p. 188 ).
Etapas para o Windows
1. Caso esteja fazendo a instalação em um diretório com outros componentes do IBM Cognos
BI, interrompa o serviço do IBM Cognos.
2. Execute um dos seguintes procedimentos:
● Insira o disco do produto IBM Cognos.
Se o assistente de instalação não abrir automaticamente, acesse o diretório do sistema
operacional e clique duas vezes em issetup.exe.
● Acesse o local em que os arquivos de instalação foram baixados e extraídos e clique duas
vezes em issetup.exe.
3. Selecione o idioma para utilizar na instalação.
O idioma selecionado será o mesmo da interface do usuário. Todos os idiomas suportados são
instalados. É possível alterar a interface do usuário para qualquer um dos idiomas instalados
depois de concluída a instalação.
4. Siga as instruções do assistente de instalação e copie os arquivos necessários para seu
computador.
● Ao selecionar o diretório, considere o seguinte:
Instale o Content Manager em um diretório que contenha apenas caracteres ASCII no nome
do caminho. Alguns servidores web do Microsoft® Windows® não suportam caracteres
que não sejam ASCII nos nomes dos diretórios.
Se estiver instalando o IBM Cognos BI em um computador que possui o ReportNet ou
uma versão anterior do IBM Cognos BI e desejar manter a versão anterior, é necessário
instalar o IBM Cognos BI em um diretório diferente.
Se estiver fazendo uma instalação em um diretório que contém outros componentes do
IBM Cognos BI, haverá uma solicitação para criar cópias de backup dos arquivos que serão
substituídos.
● Ao selecionar os componentes, desmarque todos, exceto Content Manager.
Se deseja usar o banco de dados pré-configurado, selecione também Banco de dados de
conteúdo Cognos.
5. Na página Concluir do assistente de instalação, faça o seguinte:
● Se desejar ver os arquivos de log, clique em Exibir para o arquivo de log apropriado.
Guia de instalação e configuração 129
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
● Se desejar ver as últimas informações sobre o produto, assinale a caixa de seleção das Notas
de versão do IBM Cognos.
● Não configure o IBM Cognos BI imediatamente porque é necessário realizar outras tarefas
antes para garantir que o ambiente esteja devidamente configurado. Verifique se a caixa
de seleção IBM Cognos Configuration está desmarcada.
É possível configurar o IBM Cognos BI posteriormente utilizando o menu Iniciar do
Windows para iniciar o IBM Cognos Configuration na pasta de atalho.
● Clique em Concluir.
Se deseja instalar o Banco de dados de conteúdo do Cognos em um computador diferente, execute
o assistente de instalação no servidor de banco de dados e selecione apenas o componente Banco
de dados de conteúdo do Cognos.
Se desejar que os usuários vejam a documentação do produto em um idioma diferente do inglês, é
necessário instalar o componente Supplementary Language Documentation no mesmo local que os
componentes de gateway foram instalados. Para obter mais informações, consulte "Instalação da
documentação do produto traduzida" (p. 188 ).
Instalação do Banco de dados de conteúdo do Cognos em um servidor diferenteSe deseja instalar o Banco de dados de conteúdo do Cognos® em um servidor diferente, será necessário
fazê-lo antes de configurar o Content Manager. No assistente de instalação, desmarque todos os
componentes e selecione apenas Banco de dados de conteúdo do Cognos.
Etapas
1. No servidor do banco de dados, insira o disco do produto IBM® Cognos.
Nos sistemas operacionais UNIX® ou Linux®, monte o disco utilizando as extensões de arquivo
Rock Ridge.
2. Se a página Bem-vindo não aparecer, inicie o assistente de instalação:
● No UNIX ou Linux, no diretório do sistema operacional, digite ./issetup
● No sistema operacional Microsoft® Windows®, clique duas vezes no arquivo issetup.exe
do diretório win32 do disco.
3. Siga as instruções do assistente de instalação e copie os arquivos necessários para seu
computador.
Instale em um diretório que contenha apenas caracteres ASCII no nome do caminho. Alguns
servidores web UNIX e Linux não suportam caracteres que não sejam ASCII nos nomes dos
diretórios.
Ao selecionar os componentes, desmarque todos e selecione Banco de dados de conteúdo do
Cognos.
4. Na página Concluir do assistente de instalação, clique em Concluir.
130 IBM Cognos Business Intelligence PowerPlay
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
Instalação de pacotes de correçõesA IBM® fornece pacotes de manutenção que contêm atualização para um ou mais componentes
dos produtos IBM Cognos®. Se o pacote de correções estiver disponível ao instalar ou atualizar o
produto, instale-o após os componentes do IBM Cognos Business Intelligence.
Se o pacote de correções estiver disponível após a implantação do produto IBM Cognos, interrompa
o serviço, instale o fix pack no mesmo local que os componentes IBM Cognos BI e inicie o serviço.
Os pacotes de correções estão disponíveis para download no IBM Support em http://www.ibm.com/
support/us/en/.
IMPORTANTE: Os pacote de correções não são instalações independentes. Deve-se instalá-los em
computadores que têm os componentes de servidor IBM Cognos BI instalados. Instale os pacotes
de correções apropriados para a versão do produto. Para verificar qual a versão que possui, abra
o arquivo de lista de componentes em local_c10\cmplst.txt e verifique a linha que começa com
C8BISRVR_version=.
Antes de instalar o pacote de correções, crie um backup do banco de dados de armazenamento de
conteúdo. Além disso, faça back-up dos arquivos personalizados da instalação atual.
Etapas para o sistema operacional Microsoft Windows
1. Se o produto IBM Cognos BI estiver em execução, abra o IBM Cognos Configuration e
interrompa o serviço do IBM Cognos.
2. Faça backup do armazenamento de conteúdo.
3. Se o ambiente IBM Cognos BI for personalizado, faça backup de todo o local IBM Cognos BI.
4. Insira o disco do pacote de correções do sistema operacional Microsoft® Windows® ou acesse
o local em que o download foi feito e os arquivos foram extraídos.
Se mais de um pacote de correções estiver disponível, instale o que tiver o menor número de
versão primeiro.
5. No disco ou no local de download, acesse o diretório win32 e clique duas vezes no arquivo
issetup.exe.
6. Siga as instruções do assistente de instalação, instalando no mesmo local que os componentes
de servidor IBM Cognos BI já existentes.
O programa issetup solicitará permissão para que o pacote de correções crie uma cópia de
backup na pasta de instalação antes de copiar novos arquivos.
7. Se o atualizador estiver disponível, faça o seguinte:
● Para fazer uma instalação a partir do disco, insira o disco do atualizador do sistema
operacional Windows.
● Para fazer uma instalação a partir de download, siga as instruções do site de suporte e
acesse o local onde o download foi feito e os arquivos extraídos.
● No diretório do atualizador do disco ou do local de download, acesse o diretório win32 e
clique duas vezes no arquivo issetup.exe.
Guia de instalação e configuração 131
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
● Siga as instruções do assistente de instalação.
8. Para retornar um produto IBM Cognos BI implantado no serviço, abra o IBM Cognos
Configuration, salve a configuração e inicie o serviço IBM Cognos.
9. Se tiver um ambiente distribuído, repita essas etapas para todos os servidores IBM Cognos BI
restantes.
10. Se estiver executando o produto IBM Cognos BI em um servidor de aplicativos que não seja o
padrão, Tomcat, implante o produto IBM Cognos BI novamente no servidor de aplicativos.
Para obter instruções, consulte "Configuração de propriedades do servidor de aplicativos e
implantação do IBM Cognos 8" (p. 322 ).
Etapas para os sistemas operacionais UNIX e Linux
1. Se o produto IBM Cognos BI estiver em execução, abra o IBM Cognos Configuration e
interrompa o serviço do IBM Cognos.
2. Faça backup do armazenamento de conteúdo.
3. Se o ambiente IBM Cognos BI for personalizado, faça backup de todo o local IBM Cognos BI.
4. Se estiver usando um disco, monte o disco do pacote de correções adequado para o sistema
operacional UNIX® ou Linux®, usando as extensões de arquivo Rock Ridge.
Importante: Para montar o disco do IBM Cognos no HP-UX, proceda da seguinte forma:
● Adicione o diretório pfs_mount no caminho.
Por exemplo,
PATH=/usr/sbin/:$PATH
exporte PATH
● Para iniciar os daemons NFS solicitados e executar os daemons em segundo plano, digite
bg pfs_mountd e depois bg pfsd
● Para montar a unidade, digite
pfs_mount -t rrip <device><mount_dir> -o xlat=unix
Por exemplo,
pfs_mount /dev/dsk/c0t2d0 /cdrom -o xlat=unix
Agora é possível instalar ou copiar arquivos como um usuário que não seja o usuário raiz
utilizando um disco do IBM Cognos nessa unidade.
● Ao concluir a instalação, digite pfs_umount /cdrom e finalize os daemons pfsd e pfs_mountd
para desmontar o disco.
5. Se estiver usando um download, acesse o local onde o download foi feito e onde os arquivos
do pacote de correções foram extraídos.
Se mais de um pacote de correções estiver disponível, instale o que tiver o menor número de
versão primeiro.
132 IBM Cognos Business Intelligence PowerPlay
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
6. Para iniciar o assistente de instalação, digite
./issetup
Se não estiver usando o XWindows, execute uma instalação autônoma (p. 345 ).
7. Siga as instruções do assistente de instalação, instalando no mesmo local que os componentes
de servidor IBM Cognos BI já existentes.
O programa issetup solicitará permissão para que o pacote de correções crie uma cópia de
backup na pasta de instalação antes de copiar novos arquivos.
8. Se o atualizador estiver disponível, faça o seguinte:
● Para instalar a partir de um disco, monte o disco de atualizador adequado para o sistema
operacional, usando as extensões de arquivo Rock Ridge.
Importante: Para montar o disco no HP-UX, siga as instruções da etapa 4.
● Para instalar a partir de um download, acesse o local onde o download foi feito e os arquivos
do atualizador foram extraídos.
● Para iniciar o assistente de instalação, digite
./issetup
Se não estiver usando o XWindows, execute uma instalação autônoma (p. 345 ).
● Siga as instruções do assistente de instalação, instalando no mesmo local que os componentes
de servidor IBM Cognos BI já existentes.
9. Para retornar um produto IBM Cognos BI implantado no serviço, abra o IBM Cognos
Configuration, salve a configuração e inicie o serviço IBM Cognos.
10. Se tiver um ambiente distribuído, repita essas etapas para todos os servidores IBM Cognos BI
restantes.
11. Se estiver executando o produto IBM Cognos BI em um servidor de aplicativos que não seja o
padrão, Tomcat, implante o produto IBM Cognos BI novamente no servidor de aplicativos.
Para obter instruções, consulte "Configuração de propriedades do servidor de aplicativos e
implantação do IBM Cognos 8" (p. 322 ).
Criação de bancos de dados para o armazenamento de conteúdo DB2 em Linuxcom um script
Um script denominado C8DB2.sh é fornecido para permitir que seja criado um banco de dados de
armazenamento de conteúdo em DB2 no Linux®. O script está localizado no diretório local_c10\C8SE
depois que for instalado o IBM® Cognos® Business Intelligence.
O DB2 deve ser instalado e configurado antes de executar o script. O script cria e configura um
banco de dados que pode ser utilizado como armazenamento de conteúdo. Para obter mais
informações sobre as configurações mínimas recomendadas para um armazenamento de conteúdo
DB2, consulte "Configurações sugeridas para criar o armazenamento de conteúdo no DB2 no
Linux, Windows e UNIX" (p. 45 ).
Guia de instalação e configuração 133
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
Permissões
Para executar o script, é preciso ser um membro do grupo DB2 chamado dasadm1. Quando o script
é executado, é solicitada uma conta de usuário que receberá os privilégios requeridos para acessar
e gravar no banco de dados. Ao configurar as informações de conexão do armazenamento de
conteúdo para o IBM Cognos BI, utilize a conta de usuário inserida ao executar o script e não a
conta de usuário utilizada para executar o script.
O script cria o banco de dados na primeira instância de DB2 no caminho. Se tiver mais de uma
instância de DB2, certifique-se de que a instância de DB2 na qual deseja criar o armazenamento de
conteúdo apareça primeiro no caminho.
Etapas
1. No diretório local_c10/C8SE onde o IBM Cognos BI está instalado, copie o script C8DB2.sh
para o servidor de banco de dados.
2. No computador servidor de banco de dados, mude para um usuário que seja membro do grupo
DB2 chamado dasadm1.
3. Execute o script utilizando o seguinte comando:
./C8DB2.sh
As seguintes informações são solicitadas:
● um nome para o armazenamento de conteúdo
● um usuário que receberá os privilégios requeridos para acessar e gravar no banco de dados
de armazenamento de conteúdo
Ao definir as propriedades de conexão de banco de dados para o armazenamento de
conteúdo, digite esse usuário na propriedade ID do usuário e senha.
Quando o script estiver concluído, um banco de dados será criado no DB2 e poderá ser utilizado
como banco de dados de armazenamento de conteúdo.
Criação de tablespaces para um armazenamento de conteúdo DB2 em z/OSO administrador do banco de dados deve executar um script para criar um conjunto de tablespaces
necessários para o banco de dados do armazenamento de conteúdo. O script deve ser modificado
para substituir os parâmetros de espaço reservado com os adequados a seu ambiente.
Se estiver usando o mesmo banco de dados DB2 em z/SO para o armazenamento de conteúdo e a
notificação (a configuração padrão), então deverá executar scripts para criar tablespaces de
notificação ao mesmo tempo em que cria tablespaces de armazenamento de conteúdo.
Verifique se está usando as convenções de nomes para DB2 em z/OS. Por exemplo, todos os nomes
de parâmetros devem começar com uma letra e o tamanho não pode exceder oito caracteres. Para
obter mais informações, consulte o IBM® DB2 Information Center.
Etapas
1. Conecte-se ao banco de dados como um usuário com privilégios para criar e arrastar tablespaces
e para permitir a execução de instruções SQL.
134 IBM Cognos Business Intelligence PowerPlay
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
2. Vá até o diretório que contém os scripts:
local_c10\configuration\schemas\content\db2zOS
3. Abra o arquivo de script tablespace_db2zOS.sql e use a tabela a seguir para ajudá-lo a substituir
os parâmetros genéricos pelos adequados a seu ambiente.
DescriçãoNome do parâmetro
Especifica o local das tabelas de baseCMSCRIPT_CREATE_IN
Por exemplo, NomeBancodedados.baseNome
Espaçodetabela
Especifica o nome do grupo de armazenamento.CMSCRIPT_STOGROUP
Especifica o nome do armazenamento de conteúdo Sybase.CMSCRIPT_DATABASE
Especifica a identificação da instância para o banco de
dados do armazenamento de conteúdo.
CMSCRIPT_CS_ID
A ID não deve ser maior que dois caracteres.
Especifica o nome do tablespace que irá conter todas as
tabelas de base no armazenamento de conteúdo.
CMSCRIPT_TABLESPACE
Tabelas auxiliares não são incluídas.
O nome não pode ser maior de seis caracteres.
Especifica o nome do pool de buffer grande alocado
especialmente para objetos grandes.
CMSCRIPT_LARGE_BP
Especifica o nome do pool de buffer de tamanho normal
alocado especialmente para objetos grandes e de tamanho
normal.
CMSCRIPT_REGULAR_BP
Especifica a conta de usuário que acessa o banco de dados
do armazenamento de conteúdo.
CMSCRIPT_USERNAME
Nem todos os parâmetros listados estão no script, mas podem ser adicionados no futuro.
4. Salve e execute o script.
5. Conceda os direitos de usuário do IBM Cognos® para os tablespaces criados ao executar o
script de arquivo tablespace_db2zOS.sql:
● Na ferramenta de acesso remoto, abra o arquivo de script rightsGrant_db2zOS.sql e
substitua os parâmetros de espaço reservado com valores adequados a seu ambiente.
Dica: Verifique se os mesmos valores usados ao alocar recursos aos pools de buffer e à
conta de usuário estão sendo usados.
Guia de instalação e configuração 135
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
● Salve e execute o arquivo.
6. Substitua os parâmetros de espaço reservado nos seguintes scripts e execute-os:
● dbInitTest_db2zOS.sql
● dbInitMeta_db2zOS.sql
● dbInitScript_db2zOS.sql
● dbInitLock_db2zOS.sql
7. Se estiver usando o mesmo banco de dados para notificação que o utilizado para o
armazenamento de conteúdo (a configuração padrão), execute as etapas de 7 a 10.
8. Abra o arquivo de script NC_TABLESPACES.sql e use a tabela a seguir para ajudá-lo a substituir
os parâmetros de espaço reservado por aqueles que são adequados a seu ambiente.
DescriçãoNome do parâmetro
Especifica o nome do armazenamento de conteúdo Sybase.NCCOG
Especifica o nome do grupo de armazenamento utilizado para o banco
de dados do armazenamento de conteúdo.
DSN8G810
Especifica o nome do pool de buffer usado para os tablespaces.BP32K
Para parâmetros que não estejam no script, adicione-os.
9. Salve e execute o script.
10. Abra o arquivo de script NC_CREATE.sql e substitua o parâmetro de espaço reservado NCCOG
pelo nome do banco de dados do armazenamento de conteúdo.
11. Salve o script.
Os serviços de trabalho e monitor de programação executarão o script automaticamente. No
entanto, você mesmo pode executá-lo.
O banco de dados do armazenamento de conteúdo foi criado. Agora é possível configurar uma
conexão de banco de dados.
Atualização do ambiente JavaÉ possível utilizar um JavaTM Runtime Environment (JRE) existente ou o JRE fornecido com o IBM®
Cognos® Business Intelligence. Para oferecer suporte aos serviços de criptografia no IBM Cognos
BI, talvez seja necessário atualizar ou definir uma variável de ambiente JAVA_HOME. Dependendo
da sua política de segurança, talvez tenha de instalar o arquivo de política irrestrita do Java
Cryptography Extension (JCE).
136 IBM Cognos Business Intelligence PowerPlay
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
JAVA_HOME
Caso queira usar seu próprio JRE e definir JAVA_HOME para esse local no Microsoft® Windows®,
ou caso esteja instalando no UNIX® ou no Linux®, será necessário atualizar JAVA_HOME para
os serviços de criptografia.
No Windows, defina JAVA_HOME como uma variável de sistema ou de usuário. Se definir como
uma variável de sistema, pode ser necessário reiniciar seu computador para que tenha efeito. Se
definir como uma variável de usuário, faça com que o ambiente no qual o Tomcat estiver sendo
executado possa acessá-lo.
Caso ainda não possua uma variável JAVA_HOME definida no Windows, os arquivos JRE
fornecidos com a instalação serão usados e não será necessário atualizar nenhum arquivo do seu
ambiente. Se JAVA_HOME apontar para uma versão do Java que não é válida para o IBM
Cognos BI, será necessário atualizar JAVA_HOME com o caminho para uma versão válida do
Java.
Arquivo de política irrestrita do JCE
Se usar o JRE padrão do Windows ou fizer download de um JRE para UNIX ou Linux, o JRE
incluirá um arquivo de política restrita que o limita a determinados algoritmos criptográficos e
conjuntos de codificação. Se sua política de segurança exigir uma gama mais ampla de algoritmos
criptográficos e conjuntos de codificação além dos mostrados no IBM Cognos Configuration, faça
download e instale o arquivo de política irrestrita do JCE.
Etapas
1. Certifique-se de que a variável de ambiente JAVA_HOME esteja definida na localidade JRE.
Por exemplo, para definir JAVA_HOME para o JRE que já está sendo utilizado, o caminho é
local_Java/bin/jre/versão.
2. Se sua política de segurança exigir, faça download e instale o arquivo de política irrestrita do
JCE.
Para IBM Java, o arquivo de política irrestrita do JCE está disponível no seguinte local:
https://www14.software.ibm.com/webapp/iwm/web/preLogin.do?source-jcesdk
Pode ser necessário completar configurações adicionais para definições criptográficas. Para
obter mais informações, consulte "Configuração de definições criptográficas" (p. 239 ).
Configuração da conectividade de banco de dados para o banco de dados dearmazenamento de conteúdo
Se estiver utilizando um banco de dados diferente do Banco de dados de conteúdo do Cognos®
como o armazenamento de conteúdo, poderá ser necessário instalar o software cliente de banco de
dados ou drivers JavaTM Database Connectivity (JDBC), ou ambos, em cada computador em que
Guia de instalação e configuração 137
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
instalar o Content Manager. Fazer isso permite ao Content Manager acessar o banco de dados de
armazenamento de conteúdo.
Etapas para o DB2
1. Se estiver usando uma conexão JDBC tipo 2, instale o software do cliente DB2® nos
computadores com o Content Manager.
Se estiver usando uma conexão JDBC tipo 4 para DB2, não será solicitado para instalar o
software do cliente DB2 no local onde o Content Manager está instalado. Se for utilizado banco
de dados DB2 em z/OS® para o armazenamento de conteúdo, será necessário usar uma
conectividade JDBC tipo 4.
Para obter mais informações sobre as diferenças entre os drivers tipo 2 e tipo 4, consulte "Opções
de driver JDBC para usar o banco de dados DB2 como armazenamento de conteúdo" (p. 96
).
2. Se utilizar uma conexão JDBC tipo 2 e o armazenamento de conteúdo não estiver no computador
do Content Manager, configure um alias do banco de dados para o armazenamento de conteúdo.
No sistema operacional Microsoft® Windows®, execute o DB2 Client Configuration Assistant.
Nos sistemas operacionais UNIX® ou Linux®, use a interface de linha de comando do DB2.
Se o banco de dados do armazenamento de conteúdo e o Content Manager estiverem no mesmo
computador, o nome do armazenamento de conteúdo será automaticamente o alias.
Ao configurar os computadores com o Content Manager, certifique-se que estejam configurados
para usar o mesmo armazenamento de conteúdo.
3. No Windows, encerre os serviços DB2 e o HTML Search Server.
4. Copie os seguintes arquivos do diretório instalação_DB2/sqllib/java para o diretório local_c10/
webapps/p2pd/WEB-INF/lib.
● O arquivo do driver universal, db2jcc.jar.
● o arquivo de licença
para DB2 no Linux, UNIX ou Windows, db2jcc_license_cu.jar
para DB2 em z/OS, db2jcc_license_cisuz.jar
Se estiver conectando ao DB2 em z/OS, use a versão de driver do Linux, UNIX ou Windows
versão 9.1 Fix Pack 5 ou versão 9.5 Fix Pack 2.
Dica: Para verificar a versão do driver, execute o seguinte comando
java -cp caminho\db2jcc.jar com.ibm.db2.jcc.DB2Jjcc -version
5. No Windows, reinicie os serviços DB2 e o HTML Search Server.
6. No UNIX, se estiver utilizando uma conexão JDBC tipo 2, certifique-se de que as bibliotecas
DB2 de 32 bits estão no caminho de busca da biblioteca, que são geralmente os diretórios
$DB2DIR/lib ou $DB2DIR/lib32.
138 IBM Cognos Business Intelligence PowerPlay
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
7. Repita todo o procedimento nos computadores IBM Cognos BI nos quais o Content Manager
estiver instalado ou nos quais a notificação for enviada a um banco de dados DB2.
É possível adaptar o banco de dados para utilizar os recursos DB2. Para obter mais informações,
consulte "Ajuste do Armazenamento de conteúdo do DB2" (p. 359 ).
Etapas para o Oracle
1. No computador em que o cliente Oracle foi instalado, vá para o diretório ORACLE_HOME/
jdbc/lib.
2. Copie o arquivo ojdbc5.jar para o diretório local_c10/webapps/p2pd/WEB-INF/lib nos
computadores em que o Content Manager estiver instalado e em que a notificação é enviada
para um banco de dados Oracle.
Se o diretório contiver o arquivo classes12.jar ou ojdbc14.jar, exclua-o antes de instalar o
arquivo ojdbc15.jar.
O driver está disponível em um cliente Oracle ou instalação do servidor, ou pode ser baixado
do site de tecnologia Oracle.
Etapas para Informix
1. No computador em que o Informix® está instalado, acesse o diretório local_Informix/sqllib/java.
2. Copie os seguintes arquivos para o diretório local_c10/webapps/p2pd/WEB-INF/lib em todos
os computadores em que o Content Manager foi instalado.
● O arquivo do driver universal, db2jcc.jar.
● o arquivo de licença, db2jcc_license_cisuz.jar
Etapas para Sybase
1. No computador onde o Sybase está instalado, acesse o diretório Sybase_location/jConnect-6/
classes.
2. Copie o arquivo jconn3.jar para o diretório local_c10/webapps/p2pd/WEB-INF/lib em todos
os computadores em que o Content Manager tiver sido instalado e que enviam notificações
para um banco de dados Sybase.
Início do IBM Cognos ConfigurationUse a ferramenta de configuração, o IBM® Cognos® Configuration, para configurar os componentes
do IBM Cognos Business Intelligence durante o processo de instalação e configuração, e para iniciar
e interromper os serviços do IBM Cognos.
Antes de iniciar o IBM Cognos Configuration, certifique-se de que o ambiente operacional esteja
devidamente configurado. Por exemplo, certifique-se de que todas as variáveis de ambiente foram
definidas.
Nos sistemas operacionais UNIX® ou Linux®, não inicie o IBM Cognos Configuration na última
página do assistente de instalação. É necessário realizar configurações adicionais antes de configurar
Guia de instalação e configuração 139
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
o IBM Cognos BI. Por exemplo, é necessário atualizar o ambiente JavaTM . No sistema operacional
Microsoft® Windows®, será possível iniciar o IBM Cognos Configuration na última página do
assistente de instalação somente se não for necessário fazer nenhuma configuração adicional. Por
exemplo, se um servidor de banco de dados diferente do Microsoft® SQL ou do Cognos Content
Database for utilizado para o armazenamento de conteúdo, copie os drivers Java Database
Connectivity (JDBC) para o local apropriado antes de iniciar a ferramenta de configuração.
Certifique-se de que a conta de usuário ou serviço esteja definida. Para obter mais informações,
consulte "Configuração de contas de usuário ou contas de serviço de rede no IBM Cognos Business
Intelligence" (p. 52 ).
Etapas no UNIX ou Linux
1. Acesse o diretório local_c10/bin e digite
./cogconfig.sh
2. Se desejar acessar a ajuda do IBM Cognos Configuration, acesse o diretório
local_c10/configuration e edite o arquivo cogconfig.prefs para adicionar o local de seu navegador
Web.
Por exemplo, se utilizar o Firefox, adicione o seguinte texto ao arquivo:
BrowserPath=Web_browser_location/firefox
onde Web_browser_location é um caminho, como /usr/local/bin/
Seu navegador da web deve aceitar a seguinte sintaxe:
$ <Web_browser_location> <URL>
Etapas no Windows
1. No menu Iniciar, clique em Programas > IBM Cognos 10 > IBM Cognos Configuration.
2. Se desejar acessar a ajuda do IBM Cognos Configuration, acesse o diretório
local_c10\configuration e edite o arquivo cogconfig.prefs para adicionar o local de seu navegador
Web.
Por exemplo, se utilizar o Firefox, adicione o seguinte texto ao arquivo:
BrowserPath=localização_navegador_web\firefox
sendo que localização_navegador_web é um caminho, como \usr\local\bin\
Seu navegador da web deve aceitar a seguinte sintaxe:
$ <Web_browser_location> <URL>
Definição de propriedades de conexão do banco de dados para o armazenamentode conteúdo
Deve-se especificar as informações do servidor de banco de dados para garantir que o Content
Manager possa ser conectado ao banco de dados que você utiliza para o armazenamento de conteúdo.
O Content Manager usa o logon do banco de dados para acessar o armazenamento de conteúdo.
140 IBM Cognos Business Intelligence PowerPlay
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
Após definir as propriedades de conexão de banco de dados, é possível testar a conexão entre o
Content Manager e o armazenamento de conteúdo.
Em um ambiente de produção, use um banco de dados de nível empresarial para armazenamento
do conteúdo. Se estiver usando o Banco de dados de conteúdo do Cognos em um sistema de teste
ou prova de conceito, poderá usar os recursos no portal de administração para fazer backup e
arquivar os dados antes de mudar para um banco de dados de nível empresarial no ambiente de
produção. Para obter mais informações, consulte o tópico sobre como implantar todo o
armazenamento de conteúdo no Guia de administração e segurança do IBM® Cognos® Business
Intelligence.
Caso o Banco de dados de conteúdo do Cognos esteja no mesmo computador do Content Manager
no ambiente de produção, após configurar o produto IBM Cognos BI para usar um banco de dados
de nível empresarial para armazenamento de conteúdo, desinstale o Banco de dados de conteúdo
do Cognos.
Se estiver atualizando do ReportNet ou de uma versão anterior do IBM Cognos BI, configure o
IBM Cognos BI para apontar para uma cópia do banco de dados de armazenamento de conteúdo
existente. Depois de salvar a configuração e iniciar o serviço IBM Cognos, os dados no
armazenamento de conteúdo são automaticamente atualizados e não podem ser utilizados por uma
versão anterior. O uso de cópia do banco de dados original com a nova versão permite manter o
ReportNet ou a versão anterior sendo executada com os dados originais.
Certifique-se de que um dos servidores suportados foi usado para criar o armazenamento de
conteúdo.
Certifique-se de que a conta de usuário ou serviço esteja configurada. Para obter mais informações,
consulte "Configuração de contas de usuário ou contas de serviço de rede no IBM Cognos Business
Intelligence" (p. 52 ).
Etapa para o DB2® nos sistemas operacionais Linux®, UNIX® ou Microsoft® Windows®
1. No local onde o Content Manager foi instalado, inicie o IBM Cognos Configuration.
2. Na janela Explorer, em Acesso a dados, Content Manager, clique em Armazenamento de
conteúdo.
3. Na janela Propriedades, na propriedade Nome do banco de dados, digite o nome ou alias do
banco de dados.
4. Altere as credenciais de logon para especificar uma ID e senha de usuário válidas:
● Clique na caixa Valor ao lado da propriedade ID do usuário e senha e clique no botão de
edição quando ele aparecer.
● Digite os valores apropriados e clique em OK.
5. Para usar a conexão JDBC tipo 4, na propriedade Servidor do banco de dados e número da
porta, digite um valor, usando a sintaxe host:porta.
Se deixar esta propriedade em branco, a conexão JDBC tipo 2 será usada.
Para obter mais informações sobre as diferenças entre os tipos de drivers, consulte "Opções de
driver JDBC para usar o banco de dados DB2 como armazenamento de conteúdo" (p. 96 ).
Guia de instalação e configuração 141
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
6. No menu Arquivo, clique em Salvar.
As credenciais de logon são imediatamente criptografadas.
7. Para testar a conexão entre o Content Manager e o banco de dados de armazenamento de
conteúdo, no menu Ações, clique em Testar.
O Content Manager se conecta ao banco de dados, verifica as permissões do banco de dados
e cria e preenche uma tabela. A tabela não é excluída e é usada todas as vezes que o teste for
feito.
Etapas para o DB2 em z/OS
1. No local onde o Content Manager foi instalado, inicie o IBM Cognos Configuration.
2. Na janela Explorer, em Acesso a dados, Content Manager, clique em Armazenamento de
conteúdo.
3. Na janela Propriedades, na propriedade Nome do banco de dados, digite o nome ou alias do
banco de dados.
4. Altere as credenciais de logon para especificar uma ID e senha de usuário válidas:
● Clique na caixa Valor ao lado da propriedade ID do usuário e senha e clique no botão de
edição quando ele aparecer. Verifique se especificou a mesma ID de usuário que a de
CMSCRIPT_USERNAME ao criar os espaços de tabela.
● Digite os valores apropriados e clique em OK.
5. Para usar a conexão JDBC tipo 4, na propriedade Servidor do banco de dados e número da
porta, digite um valor, usando a sintaxe host:porta.
Para se conectar ao DB2® em z/OS®, será necessário usar a conexão JDBC tipo 4.
Para obter mais informações sobre as diferenças entre os tipos de drivers, consulte "Opções de
driver JDBC para usar o banco de dados DB2 como armazenamento de conteúdo" (p. 96 ).
6. Na janela Explorer, clique em Configuração Local.
7. Na janela Propriedades, próximo a Propriedades avançadas, clique dentro da caixa Valor e
clique no botão de edição.
A caixa de diálogo Valor - Propriedades avançadas será exibida.
8. Para adicionar os parâmetros usados para criar os espaços de tabelas, clique em Adicionar.
Todos os parâmetros, exceto CMSCRIPT_USERNAME, são adicionados.
9. No menu Arquivo, clique em Salvar.
As credenciais de logon são imediatamente criptografadas.
10. Para testar a conexão entre o Content Manager e o banco de dados de armazenamento de
conteúdo, no menu Ações, clique em Testar.
142 IBM Cognos Business Intelligence PowerPlay
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
Isto testa a conexão entre o Content Manager e o banco de dados do armazenamento de
conteúdo.
Etapas para Microsoft SQL Server, Oracle, Informix e Sybase
1. No computador onde o Content Manager foi instalado, inicie o IBM Cognos Configuration.
2. Na janela do Explorer, em Acesso a dados, Content Manager, clique com o botão direito do
mouse em Armazenamento de conteúdo e clique em Excluir.
Isso exclui a conexão ao recurso padrão. O Content Manager pode acessar apenas um
armazenamento de conteúdo.
3. Clique com o botão direito em Content Manager, e clique em Novo recurso, Banco de dados.
4. Na caixa Nome, digite um nome para o recurso.
5. Na caixa de seleção Tipo, selecione o tipo de banco de dados e clique em OK.
Se foi instalada mais de uma versão do IBM Cognos BI, será necessário usar um armazenamento
de conteúdo diferente para cada versão. Quando um armazenamento de conteúdo é usado com
uma nova versão do IBM Cognos BI, não poderá ser usado com uma versão anterior.
Dica: se desejar usar um par de valores de palavra-chave do Oracle Net8 para gerenciar a
conexão do banco de dados, selecione Banco de dados Oracle (avançado).
6. Na janela Propriedades, forneça valores dependendo do tipo de seu banco de dados:
● Se um banco de dados Microsoft® SQL Server for utilizado, digite os valores apropriados
para as propriedades Servidor de banco de dados com número da porta ou nome da instância
e Nome do banco de dados.
Para um banco de dados do Microsoft SQL Server, é possível escolher um número de porta,
como 1433, ou uma instância denominada como o valor para a propriedade Servidor de
bancos de dados com número de porta ou nome da instância.
Para a propriedade Servidor de bancos de dados com número de porta ou nome da instância, inclua o nome da instância se existirem várias instâncias do Microsoft SQL Server.
Para se conectar a uma instância denominada, é necessário especificar o nome da instância
como uma propriedade URL JavaTM Database Connectivity (JDBC) ou de fonte de dados.
Por exemplo, digite localhost\instance1. Se não forem especificadas propriedades de nome
de instância, é criada uma conexão com a instância padrão.
Observe que as propriedades especificadas para a instância denominada, junto com a ID
e senha de usuário e nome do banco de dados, são usados para criar um URL JDBC. Eis
um exemplo:
jdbc:JSQLConnect://localhost\\instance1/user=sa/mais propriedades como solicitado
Para se conectar a uma instância nomeada, é necessário especificar o nome da instância.
Por exemplo, digite localhost\instance1. Se o nome de uma instância não for especificado,
será criada uma conexão com a instância padrão.
Guia de instalação e configuração 143
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
● Se usar um banco de dados Oracle, digite os valores apropriados para as propriedades
Servidor do banco de dados e número da porta e Nome do serviço.
● Se usar um banco de dados avançado do Oracle, para a propriedade Especificador do banco
de dados, digite o par de valores de palavra-chave Oracle Net8 para a conexão.
Eis um exemplo:
(description=(address=(host=myhost)(protocol=tcp)(port=1521)(connect_data=(sid=(orcl)))))
Se o banco de dados avançado do Oracle foi selecionado, o IBM Cognos BI utiliza recursos
Oracle orientados para empresa para selecionar um ouvinte, mudar para outro ouvinte se
o primeiro falhar, reconectar-se automaticamente ao banco de dados se a conexão falhar,
e equilibrar solicitações de conexão entre ouvintes e entre distribuidores.
● Se for utilizado um banco de dados Informix®, digite os valores adequados para as
propriedades Servidor do banco de dados e número da porta e Nome do banco de dados.
● Se usar um banco de dados Sybase, digite os valores apropriados para as propriedades
Servidor do banco de dados e número da porta e Nome do banco de dados.
7. Para configurar credenciais de logon, especifique uma ID e senha de usuário:
● Clique na caixa Valor ao lado da propriedade ID do usuário e senha e clique no botão de
edição quando ele aparecer.
● Digite os valores apropriados e clique em OK.
8. Se hospedar mais de um banco de dados de armazenamento de conteúdo na instância Informix,
crie a propriedade avançada CMSCRIPT_CS_ID e especifique a conta na qual a instância é
executada:
● Na janela Explorer, clique em Configuração Local.
● Na janela Propriedades, clique na coluna Valor para Propriedades avançadas e, em seguida,
clique no botão Editar .
● Na caixa de diálogo Valor - Propriedades avançadas, clique em Adicionar.
● Na coluna Nome, digite CMSCRIPT_CS_ID
● Na coluna Valor, digite o ID de usuário da conta na qual a instância do armazenamento
de conteúdo é executada.
Use uma conta de usuário diferente para cada instância do banco de dados de conteúdo
do Informix.
9. No menu Arquivo, clique em Salvar.
As credenciais de logon são imediatamente criptografadas.
10. Para testar a conexão entre o Content Manager e o banco de dados de armazenamento de
conteúdo, no menu Ações, clique em Testar.
144 IBM Cognos Business Intelligence PowerPlay
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
O Content Manager se conecta ao banco de dados, verifica as permissões do banco de dados
e cria e preenche uma tabela. A tabela não é excluída e é usada todas as vezes que o teste for
feito.
O Content Manager agora pode criar as tabelas necessárias no armazenamento de conteúdo ao
iniciar o serviço IBM Cognos pela primeira vez. Se as propriedades de conexão não forem
especificadas corretamente, não será possível iniciar os serviços IBM Cognos.
Configuração de propriedades do ambiente para computadores com ContentManager
Os computadores do Content Manager devem conhecer a localização do armazenamento de
conteúdo, outros computadores com Content Manager e o banco de dados utilizado para notificação.
Depois de instalar o Content Manager em computadores utilizados para proteção de failover, é
preciso configurar o Content Manager nesses computadores. Se mais de um Content Manager foi
instalado, liste todos os URIs de Content Manager em cada computador com Content Manager.
Depois de concluir as tarefas de configuração necessárias e iniciar o serviço do IBM® Cognos®, o
serviço de autoridade de certificação estará disponível para emitir certificados para outros
computadores. É possível então executar as tarefas de configuração exigidas em outros computadores,
como o computador com componentes da camada de aplicativos e computadores de gateway. Caso
contrário, é possível continuar a configurar computadores com o Content Manager alterando as
configurações de propriedades padrão para que melhor se adaptem ao ambiente. Por exemplo, é
possível configurar componentes do IBM Cognos BI para utilizar um provedor de autenticação ,
ativar e desativar serviços nos computadores com Content Manager ou alterar configurações globais.
Observe que, caso as configurações globais sejam alteradas em um computador com Content
Manager, é necessário fazer as mesmas alterações nos outros computadores com Content Manager.
Etapas para o primeiro computador com Content Manager
1. No computador com Content Manager que deseja designar como Content Manager ativo
padrão, inicie o IBM Cognos Configuration.
Dica: utilize o computador com a velocidade de processador mais alta para o Content Manager
ativo padrão.
2. Na janela Explorer, clique em Ambiente.
3. Na janela Propriedades, clique no valor de URIs do Content Manager e no botão de edição.
4. Especifique os URIs para os outros computadores com Content Manager:
● Na caixa de diálogo Valor - URIs do Content Manager, clique em Adicionar.
● Na linha em branco da tabela, clique e digite o URI completo do computador com Content
Manager.
Não exclua o primeiro valor na tabela. O valor identifica o computador local com Content
Manager e é solicitado.
Guia de instalação e configuração 145
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
Substitua a parte do localhost do URI por um nome de host ou endereço IP. Todas as
propriedades de URI devem usar o mesmo formato: todas como nomes de host ou todas
como endereços IP.
● Repita as duas etapas anteriores para cada URI a ser adicionado.
É necessário incluir todos os URIs do Content Manager na lista.
● Clique em OK.
5. Na janela do Explorer, em Segurança, clique em Criptografia.
6. Na janela Propriedades, em Configurações CSK, defina Armazenar chave simétrica localmente
para Verdadeiro.
7. No menu Arquivo, clique em Salvar.
Etapas para computadores com Content Manager de espera
1. Verifique se já configurou as propriedades de ambiente em pelo menos um computador com
Content Manager e se os componentes do IBM Cognos BI estão em execução nesse computador.
2. No computador com Content Manager em espera, inicie o IBM Cognos Configuration.
3. Na janela Explorer, clique em Ambiente.
4. Na janela Propriedades, clique no valor de URIs do Content Manager e no botão de edição.
5. Especifique os URIs para os outros computadores com Content Manager:
● Na caixa de diálogo Valor - URIs do Content Manager, clique em Adicionar.
● Na linha em branco da tabela, clique e digite o URI completo do computador com Content
Manager.
Não exclua o primeiro valor na tabela. O valor identifica o computador local com Content
Manager e é solicitado.
Substitua a parte do localhost do URI por um nome de host ou endereço IP. Todas as
propriedades de URI devem usar o mesmo formato: todas como nomes de host ou todas
como endereços IP.
● Repita as duas etapas anteriores para cada URI a ser adicionado.
É necessário incluir todos os URIs do Content Manager na lista.
● Clique em OK.
6. Na janela Explorer, em Segurança > Criptografia, clique em Cognos, o provedor de criptografia
padrão.
7. Certifique-se de que as definições criptográficas correspondam ao que foi definido no
computador ativo padrão com Content Manager.
8. Na janela Explorer, em Acesso a dados > Content Manager, clique em Armazenamento de
conteúdo.
146 IBM Cognos Business Intelligence PowerPlay
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
9. Certifique-se de que os valores para todas as propriedades coincidam com o que foi configurado
no computador ativo padrão com Content Manager.
10. No menu Arquivo, clique em Salvar.
Especificação de uma conexão para uma conta do servidor de e-mailSe desejar enviar relatórios por e-mail, é necessário configurar conexão com uma conta de servidor
de e-mail.
É necessário alterar a parte do nome de host do URI do gateway de localhost para o endereço IP
do computador ou para o nome do computador. Do contrário, o URL no e-mail irá conter localhost
e os usuários remotos não poderão abrir o relatório.
Etapas
1. Na janela Explorer, em Acesso a dados, clique em Notificação.
2. Na janela Propriedades, para a propriedade Servidor de correio SMTP, digite o nome do host
e da porta de seu servidor de correio SMTP (saída).
Dicas
Para conseguir abrir relatórios que são enviados por e-mail, altere a parte do nome de host do
URI do gateway de localhost para o endereço IP do computador ou para o nome do computador.
Do contrário, o URL no e-mail irá conter localhost e os usuários remotos não poderão abrir o
relatório.
Para conseguir abrir relatórios enviados como links, verifique se o URI de gateway nos servidores
de relatórios e servidores de notificação especifica um conteúdo do IBM Cognos de hospedagem
de conteúdo do servidor Web acessível. Se tiver usuários móveis acessando os links remotamente,
considere o uso de um URI externo.
3. Clique na caixa de seleção Valor próxima à propriedade Conta e senha e clique no botão de
edição quando aparecer.
4. Digite os valores adequados na caixa de diálogo Valor - Conta e senha e clique em OK.
Dica: Se as credenciais de logon não forem solicitadas pelo servidor SMTP, remova as
informações padrão para a propriedadeConta e senha. Quando surgir o prompt de confirmação
para deixar esta propriedade em branco, clique em Sim. Certifique-se o nome de usuário padrão
foi removido. Do contrário, a conta padrão é usada e as notificações não funcionarão
corretamente.
5. Na janela Propriedades, digite o valor apropriado para a conta do remetente padrão.
6. Teste as conexões de servidores de correio. Na janela Explorer, clique com o botão direito em
Notificação e clique em Testar.
O IBM Cognos Business Intelligence testa a conexão do servidor de e-mail.
Se não planeja enviar relatórios por e-mail ou não deseja configurar uma conta de servidor de
correio imediatamente, não é necessário. Entretanto, ao salvar a configuração e, em seguida, iniciar
Guia de instalação e configuração 147
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
os serviços no IBM Cognos Configuration, uma mensagem de alerta é exibida quando a conexão
do servidor de correio é testada. Ignore, com segurança, o aviso.
Ativação da segurançaPor padrão, o IBM® Cognos® Business Intelligence permite o acesso anônimo. Se quiser utilizar
segurança no ambiente do IBM Cognos BI, desative o acesso anônimo e configure o IBM Cognos
BI para utilizar um provedor de autenticação.
Etapas
1. Na janela Explorer do IBM Cognos Configuration , clique em Segurança > Autenticação >
Cognos.
2. Clique na caixa Valor para Permitir acesso anônimo e selecione Falso.
3. Clique com o botão direito do mouse Autenticação e clique em Novo recurso > Namespace.
4. Na caixa Nome, digite um nome para o namespace de autenticação.
5. Na lista Tipo, clique no tipo de namespace apropriado e clique em OK.
O novo recurso provedor de autenticação aparece na janela Explorer, no componente
Autenticação.
6. Na janela Propriedades, na propriedade ID do namespace, especifique um identificador exclusivo
para o namespace.
Para obter mais informações sobre a configuração do IBM Cognos BI para utilizar um provedor
de autenticação, consulte "Configuração de componentes do IBM Cognos para utilizar
provedores de autenticação" (p. 193 ).
Para obter mais informações sobre a configuração do IBM Cognos BI para utilizar um provedor
de autenticação, consulte "Configuração de componentes do IBM Cognos BI para utilizar um
provedor de autenticação" no Guia de instalação e configuração.
7. No menu Arquivo, clique em Salvar.
Configuração de namespaces do IBM Cognos Series 7 no IBM Cognos BICaso queira migrar informações de segurança ou conteúdo protegido do IBM® Cognos® Series 7
para o IBM Cognos Business Intelligence, é necessário configurar um namespace no IBM Cognos BI
que seja idêntico ao namespace do IBM Cognos Series 7.
É possível configurar diversos namespaces para autenticação no IBM Cognos BI. Para obter mais
informações, consulte "Configuração de componentes do IBM Cognos para utilizar provedores de
autenticação" (p. 193 ).
Observação: não é possível utilizar um arquivo IBM Cognos Series 7 Local Authentication Export
(LAE) para autenticar usando os componentes do IBM Cognos BI.
É recomendável que todos os namespaces do IBM Cognos Series 7 utilizem o mesmo IBM Cognos
Series 7 Ticket Server primário. Do contrário, podem ser recebidos erros ou avisos de autenticação
mais de uma vez.
148 IBM Cognos Business Intelligence PowerPlay
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
Caso altere as informações de configuração armazenadas no servidor de diretório utilizado para o
IBM Cognos Series 7, é necessário reiniciar o serviço IBM Cognos BI antes que as alterações entrem
em vigor na instalação do IBM Cognos.
Um usuário deve estar em pelo menos uma classe de usuário do Access Manager para que possa
fazer login nos componentes do IBM Cognos BI.
Etapas
1. Inicie o IBM Cognos Configuration.
2. Na janela Explorer, em Segurança, clique em Autenticação e depois em Cognos.
3. Clique na caixa Valor para Permitir acesso anônimo e selecione Falso.
4. Na janela Explorer, clique com o botão direito em Autenticação e selecione Novo recurso,
Namespace.
5. Na caixa Nome, digite um nome para o namespace de autenticação.
6. Na lista Tipo, clique em IBM Cognos Series 7 e depois em OK.
O novo recurso provedor de autenticação aparece na janela Explorer, no componente
Autenticação.
7. Na janela Propriedades do Recurso, especifique os valores obrigatórios.
Determinados valores devem corresponder aos valores utilizados quando o namespace do IBM
Cognos Series 7 foi configurado no Configuration Manager. No Configuration Manager, as
propriedades estão localizadas em Serviços, Access Manager - Runtime, Directory Server.
● Para ID do Namespace, especifique um identificador exclusivo para o namespace.
● Para Host e porta, digite o mesmo valor usado para a propriedade Computador no
Configuration Manager.
O formato deve ser idêntico. Se utiliza um endereço IP no IBM Cognos Series 7, digite o
mesmo endereço IP. Se utiliza um nome host de rede no IBM Cognos Series 7, digite o
mesmo nome host de rede.
● Para Nome Distinto Base, digite o mesmo valor usado para a propriedade Nome Distinto
Base (DN) no Configuration Manager.
● Para Nome do namespace, digite o mesmo valor usado para a propriedade Namespace
padrão no Configuration Manager.
Este valor diferencia maiúsculas de minúsculas e deve corresponder exatamente.
8. Especifique os valores para todas as outras propriedades necessárias para garantir que os
componentes do IBM Cognos BI possam localizar e utilizar o provedor de autenticação existente.
Se a versão do namespace do IBM Cognos Series 7 for 16.0, verifique se a propriedade
Codificação de dados está definida comoUTF-8. Além disso, os computadores onde o Content
Manager está instalado deverão usar a mesma localidade que os dados no namespace do IBM
Cognos Series 7.
Guia de instalação e configuração 149
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
9. Se o ambiente do namespace inclui a versão 15.2 do namespace do IBM Cognos Series 7,
desative a configuração Series7NamespacesAreUnicode.
● Na janela Propriedades, no valor Propriedades avançadas, clique no botão de edição.
● Na janela Valor - Propriedades avançadas, clique em Adicionar.
● Na caixa Nome, digite Series7NamespacesAreUnicode.
● Na caixa Valor, digite Falso e depois clique em OK.
10. Na janela Propriedades, verifique se as propriedades Configurações de cookie, certifique-se de
que Caminho, Domínio e Sinalizador de segurança habilitado correspondem às configurações
definidas para o IBM Cognos 7.
11. No menu Arquivo, clique em Salvar.
Início do Content ManagerDepois de ter definido as propriedades de conexão do banco de dados para o armazenamento de
conteúdo, inicie o computador com o Content Manager.
Certifique-se de que a conta de usuário ou serviço esteja definida. Para obter mais informações,
consulte "Configuração de contas de usuário ou contas de serviço de rede no IBM Cognos Business
Intelligence" (p. 52 ).
Etapas
1. Inicie o IBM Cognos Configuration.
Se estiver atualizando, será exibida uma mensagem indicando que os arquivos de configuração
foram detectados e atualizados para a nova versão.
2. Certifique-se de que as configurações foram salvas, caso contrário, não será possível iniciar o
serviço IBM Cognos.
3. No menu Ações, clique em Testar.
O IBM Cognos Configuration verifica a disponibilidade de CSK, testa as configurações de
namespace e testa as conexões para o armazenamento de conteúdo e banco de dados de log.
Se estiver usando o banco de dados e o servidor de e-mail, estes também são testados.
Dica: se Testar não estiver disponível para seleção, na janela Explorer, clique em Configuração
Local.
4. Se o teste falhar, configure novamente as propriedades afetadas e faça o teste de novo.
É possível testar alguns componentes individualmente clicando com o botão direito no
componente no painel Explorer e selecionando Testar.
Não inicie o serviço até que haja aprovação em todos os testes.
5. No menu Ações, clique em Iniciar.
Pode levar alguns minutos para o Serviço IBM Cognos iniciar.
150 IBM Cognos Business Intelligence PowerPlay
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
Essa ação inicia todos os serviços instalados que não estão sendo executados e registra o serviço
IBM Cognos no Windows.
Teste da instalação do Content ManagerÉ possível testar a instalação utilizando um navegador web.
Etapas
1. Abra um navegador web.
2. Teste se o Content Manager está em execução digitando o valor URIs do Content Manager do
IBM® Cognos® Configuration. Por exemplo,
http://host_name:port/p2pd/servlet
O valor padrão para nome_host:porta é localhost:9300.
O valor Estado deve ser Em execução.
Instalação e configuração dos componentes da camada deaplicativos
É possível instalar Application Tier Components em um ou mais servidores do IBM® Cognos®
PowerPlay® em seu ambiente. Os componentes da camada de aplicativos incluem o PowerPlay
Server e o PowerPlay Administration. Ambos os componentes são selecionados por padrão.
Para as instalações distribuídas que incluem apenas o PowerPlay, instale o servidor do PowerPlay
e o PowerPlay Administration juntos em um ou mais computadores. Para instalações distribuídas
que incluem o PowerPlay e o IBM Cognos BI, é possível instalar o Application Tier Components
do PowerPlay nos mesmos computadores que o Application Tier Components do IBM Cognos BI
ou em computadores separados. Se instalar o Application Tier Components do PowerPlay em um
computador separado do Application Tier Components do IBM Cognos BI, faça o seguinte:
● Instale apenas o componente do PowerPlay Administration em todos os computadores que
incluem o Application Tier Components do IBM Cognos BI.
● No computador onde o Application Tier Components do PowerPlay (servidor do PowerPlay
e PowerPlay Administration), abra o Cognos Configuration e, nos serviços do IBM Cognos,
desative o serviço de apresentação e o serviço de relatórios. Opcionalmente, para reduzir a
demanda dos recursos do sistema, é possível desativar o serviço de consulta.
O computador com componentes da camada de aplicativos deve conhecer a localização de
computadores com o Content Manager e o banco de dados de notificação para utilizar para
informações de trabalho e de programação. Verifique se o computador onde instalou o Content
Manager ativo está configurado e disponível antes de configurar computadores com componentes
Guia de instalação e configuração 151
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
da camada de aplicativos. Se mais de um Content Manager foi instalado, liste todos os URIs de
Content Manager em cada computador com componentes da camada de aplicativos.
Se o Content Manager e os componentes da camada de aplicativos estiverem instalados em
computadores separados, no computador com componentes da camada de aplicativos, faça o
seguinte:
❑ Instale os componentes da camada de aplicativos.
❑ Configure os componentes da camada de aplicativos.
❑ Inicie o serviço do IBM Cognos.
❑ Teste o serviço de migração do IBM Cognos.
Outras tarefas de configuração são opcionais e devem ser desempenhas mais tarde.
Instalação dos componentes da camada de aplicativosO Application Tier Components inclui o PowerPlay® Server e o PowerPlay Administration. Instale
os componentes do Application Tier Components em um ou mais computadores, dependendo do
ambiente.
Caso esteja atualizando de uma versão anterior do IBM® Cognos® BI, o IBM Cognos BI utiliza os
dados de configuração existentes para os computadores com os componentes da camada de
aplicativos. Entretanto, se tiver instalado os componentes da camada de aplicativos em um novo
local, configure as propriedades do ambiente.
Verifique se o computador onde instalou o Content Manager ativo está configurado e disponível
antes de configurar computadores com componentes da camada de aplicativos.
Requisitos de impressora
Para garantir que os relatórios serão impressos corretamente no Microsoft® Windows®, o Adobe®
Reader exige que pelo menos uma impressora seja configurada no sistema operacional em que o
Application Tier Components está instalado. Todos os relatórios, independentemente do formato
de impressão escolhido, são enviados como arquivos PDF temporários ao Adobe Reader para
impressão.
Etapas para UNIX e Linux
1. Caso esteja fazendo a instalação em um diretório com outros componentes do IBM Cognos
BI, interrompa o serviço do IBM Cognos.
2. Defina a variável de ambiente JAVA_HOME para indicar o local de instalação do JavaTM
Runtime Environment (JRE).
Um exemplo de local de instalação de um Java Runtime Environment é
/directory/java/versão_java/jre.
O IBM Cognos BI exige um JVM, como IBM Java, para executar no Linux®.
Se estiver instalando em um local com outros componentes do IBM Cognos BI, use a variável
de ambiente JAVA_HOME existente.
152 IBM Cognos Business Intelligence PowerPlay
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
3. No HP-UX, defina a variável de ambiente _M_ARENA_OPTS da seguinte forma:
_M_ARENA_OPTS 1:4
Isso aumenta a alocação de memória para o HP-UX para que se encaixe melhor em outros
sistemas operacionais UNIX®.
4. No AIX, se estiver usando um gateway de servlet, configure a variável de ambiente
AIXTHREAD_SCOPE como o seguinte:
AIXTHREAD_SCOPE=S
Isto define o escopo de contenção dos segmentos do usuário para todo o sistema, que suporta
programações mais eficientes dos segmentos do usuário.
5. Se estiver instalando a partir de um download, acesse o local em que os arquivos de instalação
foram baixados e extraídos.
6. Se estiver instalando de um disco, monte o disco usando extensões de arquivo Rock Ridge.
Para montar o disco em HP-UX, faça o seguinte:
● Adicione o diretório pfs_mount no caminho.
Por exemplo,
PATH=/usr/sbin/:$PATH
exporte PATH
● Para iniciar os daemons NFS solicitados e executar os daemons em segundo plano, digite
bg pfs_mountd e depois bg pfsd
● Para montar a unidade, digite
pfs_mount -t rrip <device><mount_dir> -o xlat=unix
Por exemplo,
pfs_mount /dev/dsk/c0t2d0 /cdrom -o xlat=unix
Agora é possível instalar ou copiar arquivos como um usuário que não seja o usuário raiz
utilizando um disco do IBM Cognos a partir dessa unidade.
● Ao concluir a instalação, digite pfs_umount /cdrom e desabilite os daemons pfsd e
pfs_mountd para desmontar o disco.
7. Para iniciar o assistente de instalação, vá para o diretório do sistema operacional e digite
./issetup
Observação: Ao utilizar o comando issetup com o XWindows, os caracteres japoneses em
mensagens e arquivos de log podem ficar corrompidos. Ao instalar em japonês no UNIX ou
Linux, configure primeiro as variáveis de ambiente LANG=C e LC_ALL=C (onde C é o código
do idioma, por exemplo, ja_JP.PCK no Solaris), e então execute o assistente de instalação.
Se não estiver usando o XWindows, execute uma instalação autônoma (p. 345 ).
8. Siga as instruções do assistente de instalação e copie os arquivos necessários para seu
computador.
Guia de instalação e configuração 153
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
● Ao selecionar o diretório, considere o seguinte:
Instale os componentes da camada de aplicativos em um diretório que contenha apenas
caracteres ASCII no nome do caminho. Alguns servidores web UNIX e Linux só suportam
caracteres ASCII nos nomes dos diretórios.
Se estiver instalando o IBM Cognos BI em um computador que possui o ReportNet ou
uma versão anterior do IBM Cognos BI e desejar manter a versão anterior, é necessário
instalar o IBM Cognos BI em um diretório diferente.
Se estiver fazendo uma instalação em um diretório que contém outros componentes do
IBM Cognos BI, haverá uma solicitação para criar cópias de backup dos arquivos que serão
substituídos.
● Ao selecionar os componentes, desmarque todos, exceto Componentes da camada de
aplicativos.
9. Na página Concluir do assistente de instalação, faça o seguinte:
● Se desejar ver os arquivos de log, clique em Exibir para o arquivo de log apropriado.
● Se desejar ver as últimas informações sobre o produto, assinale a caixa de seleção das Notas
de versão do IBM Cognos.
● Não configure o IBM Cognos BI imediatamente porque é necessário realizar outras tarefas
antes para garantir que o ambiente esteja devidamente configurado. Verifique se a caixa
de seleção IBM Cognos Configuration está desmarcada.
Será possível configurar o IBM Cognos BI posteriormente com o IBM Cognos Configuration,
digitando cogconfig.sh no diretório local_c10/bin ou executando uma configuração silenciosa
ou editando cogstartup.xml no diretório local_c10/configuration.
● Clique em Concluir.
10. Anexe o diretório local_c10/bin à variável de ambiente do caminho da biblioteca apropriada.
● Para Solaris e Linux, LD_LIBRARY_PATH
● Para AIX, LIBPATH
● Para HP-UX, SHLIB_PATH
11. No Linux, defina a variável do ambiente da IMPRESSORA ao nome de sua impressora.
Se desejar que os usuários vejam a documentação do produto em um idioma diferente do inglês, é
necessário instalar o componente Supplementary Language Documentation no mesmo local que os
componentes de gateway foram instalados. Para obter mais informações, consulte "Instalação da
documentação do produto traduzida" (p. 188 ).
Etapas para o Windows
1. Caso esteja fazendo a instalação em um diretório com outros componentes do IBM Cognos
BI, interrompa o serviço do IBM Cognos.
2. Execute um dos seguintes procedimentos:
154 IBM Cognos Business Intelligence PowerPlay
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
● Insira o disco do produto IBM Cognos.
Se o assistente de instalação não abrir automaticamente, acesse o diretório do sistema
operacional e clique duas vezes em issetup.exe.
● Acesse o local em que os arquivos de instalação foram baixados e extraídos e clique duas
vezes em issetup.exe.
3. Selecione o idioma para utilizar na instalação.
O idioma selecionado será o mesmo da interface do usuário. Todos os idiomas suportados são
instalados. É possível alterar a interface do usuário para qualquer um dos idiomas instalados
depois de concluída a instalação.
4. Siga as instruções do assistente de instalação e copie os arquivos necessários para seu
computador.
● Ao selecionar o diretório, considere o seguinte:
Instale os componentes da camada de aplicativos em um diretório que contenha apenas
caracteres ASCII no nome do caminho. Alguns servidores web não suportam caracteres
que não sejam ASCII nos nomes dos diretórios.
Se estiver instalando o IBM Cognos BI em um computador que possui o ReportNet ou
uma versão anterior do IBM Cognos BI e desejar manter a versão anterior, é necessário
instalar o IBM Cognos BI em um diretório diferente.
Se estiver fazendo uma instalação em um diretório que contém outros componentes do
IBM Cognos BI, haverá uma solicitação para criar cópias de backup dos arquivos que serão
substituídos.
● Ao selecionar os componentes, desmarque todos, exceto Componentes da camada de
aplicativos.
5. Na página Concluir do assistente de instalação, faça o seguinte:
● Se desejar ver os arquivos de log, clique em Exibir para o arquivo de log apropriado.
● Se desejar ver as últimas informações sobre o produto, assinale a caixa de seleção das Notas
de versão do IBM Cognos.
● Não configure o IBM Cognos BI imediatamente porque é necessário realizar outras tarefas
antes para garantir que o ambiente esteja devidamente configurado. Verifique se a caixa
de seleção IBM Cognos Configuration está desmarcada.
É possível configurar o IBM Cognos BI posteriormente utilizando o menu Iniciar do
Windows para iniciar o IBM Cognos Configuration na pasta de atalho.
● Clique em Concluir.
Se desejar que os usuários vejam a documentação do produto em um idioma diferente do inglês, é
necessário instalar o componente Supplementary Language Documentation no mesmo local que os
componentes de gateway foram instalados. Para obter mais informações, consulte "Instalação da
documentação do produto traduzida" (p. 188 ).
Guia de instalação e configuração 155
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
Instalação de pacotes de correçõesA IBM® fornece pacotes de manutenção que contêm atualização para um ou mais componentes
dos produtos IBM Cognos®. Se o pacote de correções estiver disponível ao instalar ou atualizar o
produto, instale-o após os componentes do IBM Cognos Business Intelligence.
Se o pacote de correções estiver disponível após a implantação do produto IBM Cognos, interrompa
o serviço, instale o fix pack no mesmo local que os componentes IBM Cognos BI e inicie o serviço.
Os pacotes de correções estão disponíveis para download no IBM Support em http://www.ibm.com/
support/us/en/.
IMPORTANTE: Os pacote de correções não são instalações independentes. Deve-se instalá-los em
computadores que têm os componentes de servidor IBM Cognos BI instalados. Instale os pacotes
de correções apropriados para a versão do produto. Para verificar qual a versão que possui, abra
o arquivo de lista de componentes em local_c10\cmplst.txt e verifique a linha que começa com
C8BISRVR_version=.
Antes de instalar o pacote de correções, crie um backup do banco de dados de armazenamento de
conteúdo. Além disso, faça back-up dos arquivos personalizados da instalação atual.
Etapas para o sistema operacional Microsoft Windows
1. Se o produto IBM Cognos BI estiver em execução, abra o IBM Cognos Configuration e
interrompa o serviço do IBM Cognos.
2. Faça backup do armazenamento de conteúdo.
3. Se o ambiente IBM Cognos BI for personalizado, faça backup de todo o local IBM Cognos BI.
4. Insira o disco do pacote de correções do sistema operacional Microsoft® Windows® ou acesse
o local em que o download foi feito e os arquivos foram extraídos.
Se mais de um pacote de correções estiver disponível, instale o que tiver o menor número de
versão primeiro.
5. No disco ou no local de download, acesse o diretório win32 e clique duas vezes no arquivo
issetup.exe.
6. Siga as instruções do assistente de instalação, instalando no mesmo local que os componentes
de servidor IBM Cognos BI já existentes.
O programa issetup solicitará permissão para que o pacote de correções crie uma cópia de
backup na pasta de instalação antes de copiar novos arquivos.
7. Se o atualizador estiver disponível, faça o seguinte:
● Para fazer uma instalação a partir do disco, insira o disco do atualizador do sistema
operacional Windows.
● Para fazer uma instalação a partir de download, siga as instruções do site de suporte e
acesse o local onde o download foi feito e os arquivos extraídos.
● No diretório do atualizador do disco ou do local de download, acesse o diretório win32 e
clique duas vezes no arquivo issetup.exe.
156 IBM Cognos Business Intelligence PowerPlay
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
● Siga as instruções do assistente de instalação.
8. Para retornar um produto IBM Cognos BI implantado no serviço, abra o IBM Cognos
Configuration, salve a configuração e inicie o serviço IBM Cognos.
9. Se tiver um ambiente distribuído, repita essas etapas para todos os servidores IBM Cognos BI
restantes.
10. Se estiver executando o produto IBM Cognos BI em um servidor de aplicativos que não seja o
padrão, Tomcat, implante o produto IBM Cognos BI novamente no servidor de aplicativos.
Para obter instruções, consulte "Configuração de propriedades do servidor de aplicativos e
implantação do IBM Cognos 8" (p. 322 ).
Etapas para os sistemas operacionais UNIX e Linux
1. Se o produto IBM Cognos BI estiver em execução, abra o IBM Cognos Configuration e
interrompa o serviço do IBM Cognos.
2. Faça backup do armazenamento de conteúdo.
3. Se o ambiente IBM Cognos BI for personalizado, faça backup de todo o local IBM Cognos BI.
4. Se estiver usando um disco, monte o disco do pacote de correções adequado para o sistema
operacional UNIX® ou Linux®, usando as extensões de arquivo Rock Ridge.
Importante: Para montar o disco do IBM Cognos no HP-UX, proceda da seguinte forma:
● Adicione o diretório pfs_mount no caminho.
Por exemplo,
PATH=/usr/sbin/:$PATH
exporte PATH
● Para iniciar os daemons NFS solicitados e executar os daemons em segundo plano, digite
bg pfs_mountd e depois bg pfsd
● Para montar a unidade, digite
pfs_mount -t rrip <device><mount_dir> -o xlat=unix
Por exemplo,
pfs_mount /dev/dsk/c0t2d0 /cdrom -o xlat=unix
Agora é possível instalar ou copiar arquivos como um usuário que não seja o usuário raiz
utilizando um disco do IBM Cognos nessa unidade.
● Ao concluir a instalação, digite pfs_umount /cdrom e finalize os daemons pfsd e pfs_mountd
para desmontar o disco.
5. Se estiver usando um download, acesse o local onde o download foi feito e onde os arquivos
do pacote de correções foram extraídos.
Se mais de um pacote de correções estiver disponível, instale o que tiver o menor número de
versão primeiro.
Guia de instalação e configuração 157
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
6. Para iniciar o assistente de instalação, digite
./issetup
Se não estiver usando o XWindows, execute uma instalação autônoma (p. 345 ).
7. Siga as instruções do assistente de instalação, instalando no mesmo local que os componentes
de servidor IBM Cognos BI já existentes.
O programa issetup solicitará permissão para que o pacote de correções crie uma cópia de
backup na pasta de instalação antes de copiar novos arquivos.
8. Se o atualizador estiver disponível, faça o seguinte:
● Para instalar a partir de um disco, monte o disco de atualizador adequado para o sistema
operacional, usando as extensões de arquivo Rock Ridge.
Importante: Para montar o disco no HP-UX, siga as instruções da etapa 4.
● Para instalar a partir de um download, acesse o local onde o download foi feito e os arquivos
do atualizador foram extraídos.
● Para iniciar o assistente de instalação, digite
./issetup
Se não estiver usando o XWindows, execute uma instalação autônoma (p. 345 ).
● Siga as instruções do assistente de instalação, instalando no mesmo local que os componentes
de servidor IBM Cognos BI já existentes.
9. Para retornar um produto IBM Cognos BI implantado no serviço, abra o IBM Cognos
Configuration, salve a configuração e inicie o serviço IBM Cognos.
10. Se tiver um ambiente distribuído, repita essas etapas para todos os servidores IBM Cognos BI
restantes.
11. Se estiver executando o produto IBM Cognos BI em um servidor de aplicativos que não seja o
padrão, Tomcat, implante o produto IBM Cognos BI novamente no servidor de aplicativos.
Para obter instruções, consulte "Configuração de propriedades do servidor de aplicativos e
implantação do IBM Cognos 8" (p. 322 ).
Início do IBM Cognos ConfigurationUse a ferramenta de configuração, o IBM® Cognos® Configuration, para configurar os componentes
do IBM Cognos Business Intelligence durante o processo de instalação e configuração, e para iniciar
e interromper os serviços do IBM Cognos.
Antes de iniciar o IBM Cognos Configuration, certifique-se de que o ambiente operacional esteja
devidamente configurado. Por exemplo, certifique-se de que todas as variáveis de ambiente foram
definidas.
Nos sistemas operacionais UNIX® ou Linux®, não inicie o IBM Cognos Configuration na última
página do assistente de instalação. É necessário realizar configurações adicionais antes de configurar
o IBM Cognos BI. Por exemplo, é necessário atualizar o ambiente JavaTM . No sistema operacional
158 IBM Cognos Business Intelligence PowerPlay
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
Microsoft® Windows®, será possível iniciar o IBM Cognos Configuration na última página do
assistente de instalação somente se não for necessário fazer nenhuma configuração adicional. Por
exemplo, se um servidor de banco de dados diferente do Microsoft® SQL ou do Cognos Content
Database for utilizado para o armazenamento de conteúdo, copie os drivers Java Database
Connectivity (JDBC) para o local apropriado antes de iniciar a ferramenta de configuração.
Certifique-se de que a conta de usuário ou serviço esteja definida. Para obter mais informações,
consulte "Configuração de contas de usuário ou contas de serviço de rede no IBM Cognos Business
Intelligence" (p. 52 ).
Etapas no UNIX ou Linux
1. Acesse o diretório local_c10/bin e digite
./cogconfig.sh
2. Se desejar acessar a ajuda do IBM Cognos Configuration, acesse o diretório
local_c10/configuration e edite o arquivo cogconfig.prefs para adicionar o local de seu navegador
Web.
Por exemplo, se utilizar o Firefox, adicione o seguinte texto ao arquivo:
BrowserPath=Web_browser_location/firefox
onde Web_browser_location é um caminho, como /usr/local/bin/
Seu navegador da web deve aceitar a seguinte sintaxe:
$ <Web_browser_location> <URL>
Etapas no Windows
1. No menu Iniciar, clique em Programas > IBM Cognos 10 > IBM Cognos Configuration.
2. Se desejar acessar a ajuda do IBM Cognos Configuration, acesse o diretório
local_c10\configuration e edite o arquivo cogconfig.prefs para adicionar o local de seu navegador
Web.
Por exemplo, se utilizar o Firefox, adicione o seguinte texto ao arquivo:
BrowserPath=localização_navegador_web\firefox
sendo que localização_navegador_web é um caminho, como \usr\local\bin\
Seu navegador da web deve aceitar a seguinte sintaxe:
$ <Web_browser_location> <URL>
Configuração de propriedades do ambiente para computadores com componentesda camada de aplicativos
Se instalar os componentes da camada de aplicativos em um computador diferente do Content
Manager, configure o computador com componentes da camada de aplicativos para que saiba a
localização do Content Manager. Os componentes distribuídos podem então se comunicar um com
o outro.
Guia de instalação e configuração 159
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
O computador com componentes da camada de aplicativos deve conhecer a localização de
computadores com o Content Manager e o banco de dados de notificação para utilizar para
informações de trabalho e de programação. O computador com componentes da camada de
aplicativos deve utilizar o mesmo banco de dados de notificação que o computador do Content
Manager usa. Para obter mais informações, consulte "Alteração do banco de dados de
notificação" (p. 255 ).
Se mais de um Content Manager foi instalado, liste todos os URIs de Content Manager em cada
computador com componentes da camada de aplicativos.
Etapas
1. Inicie o IBM® Cognos® Configuration.
2. Na janela Explorer, clique em Ambiente.
3. Na janela Propriedades, altere a porção localhost da propriedade URIs do Content Managerpara o nome de qualquer computador com o Content Manager.
4. Especifique os URIs para os outros computadores com Content Manager:
● Na caixa de diálogo Valor - URIs do Content Manager, clique em Adicionar.
● Na linha em branco da tabela, clique e digite o URI completo do computador com Content
Manager. Substitua a parte do localhost do URI por um nome de host ou endereço IP.
Todas as propriedades de URI devem usar o mesmo formato: todas como nomes de host
ou todas como endereços IP.
● Repita as duas etapas anteriores para cada URI a ser adicionado.
É necessário incluir todos os URIs do Content Manager na lista.
● Clique em OK.
5. Altere a parte localhost da propriedade URI do gateway para o nome do computador no qual
planeja instalar o componente do gateway.
Isso garantirá que os usuários em locais diferentes possam se conectar a relatórios e painéis de
controle enviados por e-mail.
6. Altere a porção do localhost das propriedades URI remanescentes para o nome ou endereço IP
do servidor do IBM Cognos BI.
7. Na janela Explorer, em Segurança > Criptografia, clique em Cognos, o provedor de criptografia
padrão.
8. No grupo de propriedades Configurações da autoridade de certificação, defina a propriedade
Senha para coincidir com as configurações do computador com Content Manager ativo padrão.
9. Certifique-se de que as definições criptográficas coincidam com o que foi definido no computador
com Content Manager ativo padrão.
10. No menu Arquivo, clique em Salvar.
160 IBM Cognos Business Intelligence PowerPlay
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
Instalação do componentes da camada de aplicativosDepois de ter configurado as propriedades do ambiente, inicie os serviços no computador com
componentes da camada de aplicativos.
Para usar o IBM® Cognos® Business Intelligence para criação de relatórios, é necessário instalar e
configurar os componentes de servidor, iniciar o serviço do IBM Cognos, e ter um pacote que faça
referência a uma fonte de dados disponível. Observe que se estiver atualizando, é possível continuar
a usar as mesmas fontes de dados.
Certifique-se de que a conta de usuário ou serviço esteja definida. Para obter mais informações,
consulte "Configuração de contas de usuário ou contas de serviço de rede no IBM Cognos Business
Intelligence" (p. 52 ).
Etapas
1. Inicie o IBM Cognos Configuration.
Se estiver atualizando, será exibida uma mensagem indicando que os arquivos de configuração
foram detectados e atualizados para a nova versão.
2. Certifique-se de que as configurações foram salvas, caso contrário, não será possível iniciar o
serviço IBM Cognos.
3. No menu Ações, clique em Testar.
O IBM Cognos Configuration verifica a disponibilidade de CSK, testa as configurações de
namespace e testa as conexões para o armazenamento de conteúdo e banco de dados de log.
Se estiver usando o banco de dados e o servidor de e-mail, estes também são testados.
Dica: se Testar não estiver disponível para seleção, na janela Explorer, clique em Configuração
Local.
4. Se o teste falhar, configure novamente as propriedades afetadas e faça o teste de novo.
É possível testar alguns componentes individualmente clicando com o botão direito no
componente no painel Explorer e selecionando Testar.
Não inicie o serviço até que haja aprovação em todos os testes.
5. No menu Ações, clique em Iniciar.
Pode levar alguns minutos para o Serviço IBM Cognos iniciar.
Essa ação inicia todos os serviços instalados que não estão sendo executados e registra o serviço
IBM Cognos no Windows.
Teste do Application Tier ComponentsÉ possível testar a instalação utilizando um navegador web.
Etapas
1. Abra um navegador web.
Guia de instalação e configuração 161
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
2. Teste a disponibilidade do distribuidor digitando o valor URI do distribuidor externo do IBM®
Cognos® Configuration. Por exemplo,
http://host_name:port/p2pd/servlet
Se a resposta incluir o estado da string: Em execução, o distribuidor está disponível.
Teste do serviço do IBM Cognos MigrationÉ possível testar a instalação do serviço de migração do IBM® Cognos® Business Intelligence
verificando se o ícone do Assistente de migração aparece no IBM Cognos Administration.
Etapas
1. No IBM Cognos Connection, na barra de ferramentas, clique em Iniciar, IBM Cognos
Administration.
2. Clique na guia Configuração.
3. Clique em Administração de Conteúdo.
O botão do assistente de migração aparece na barra de ferramentas.
Antes de poder usar o Migration Assistant para migrar o conteúdo do IBM Cognos Series 7 do
Upfront, PowerPlay® Enterprise Server e IBM Cognos Connection, é necessário instalar os
componentes de migração com o IBM Cognos Series 7. Para obter mais informações sobre o conteúdo
de migração, consulte o Guia de migração e administração do PowerPlay.
Instalação e configuração do componente do gatewayÉ possível instalar o gateway em um ou mais computadores, dependendo do ambiente. Caso tenha
uma Web farm, considere a instalação de um gateway do IBM® Cognos® BI em cada servidor web.
O uso de diversos servidores web para gerenciar solicitações que chegam oferece o melhor serviço.
Se instalar apenas o componente de gateway no mesmo computador como servidor web, o servidor
web gerenciará os principais serviços web e não processará solicitações de usuário. Essa separação
do processamento pode ser necessária se houver um firewall de rede entre o servidor web e os
componentes do outro servidor.
Verifique se o computador onde instalou o Content Manager ativo está configurado e disponível
antes de configurar computadores com gateway.
Realize as seguintes tarefas para instalar e configurar o gateway:
❑ Instale o componente do Gateway.
❑ Configure o componente do gateway.
❑ Configure o servidor web.
❑ Teste o computador com gateway.
162 IBM Cognos Business Intelligence PowerPlay
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
Instalação de componentes do gatewayÉ possível instalar o gateway em um ou mais computadores de servidor web.
Se estiver instalando o PowerPlay para trabalhar com o IBM Cognos BI, instale os componentes
de gateway do PowerPlay nos mesmos computadores que incluem os componentes de gateway do
IBM Cognos BI.
Etapas para UNIX e Linux
1. Caso esteja fazendo a instalação em um diretório com outros componentes do IBM Cognos
BI, interrompa o serviço do IBM Cognos.
2. Defina a variável de ambiente JAVA_HOME para indicar o local de instalação do JavaTM
Runtime Environment (JRE).
Um exemplo de local de instalação de um Java Runtime Environment é
/directory/java/versão_java/jre.
O IBM Cognos BI exige um JVM, como IBM Java, para executar no Linux®.
Se estiver instalando em um local com outros componentes do IBM Cognos BI, use a variável
de ambiente JAVA_HOME existente.
3. No HP-UX, defina a variável de ambiente _M_ARENA_OPTS da seguinte forma:
_M_ARENA_OPTS 1:4
Isso aumenta a alocação de memória para o HP-UX para que se encaixe melhor em outros
sistemas operacionais UNIX®.
4. No AIX, defina a variável de ambiente AIXTHREAD_SCOPE da seguinte forma:
AIXTHREAD_SCOPE=S
Isto define o escopo de contenção dos segmentos do usuário para todo o sistema, que suporta
programações mais eficientes dos segmentos do usuário.
5. Se estiver instalando a partir de um download, acesse o local em que os arquivos de instalação
foram baixados e extraídos.
6. Se estiver instalando de um disco, monte o disco usando extensões de arquivo Rock Ridge.
Para montar o disco em HP-UX, faça o seguinte:
● Adicione o diretório pfs_mount no caminho.
Por exemplo,
PATH=/usr/sbin/:$PATH
exporte PATH
● Para iniciar os daemons NFS solicitados e executar os daemons em segundo plano, digite
bg pfs_mountd e depois bg pfsd
● Para montar a unidade, digite
pfs_mount -t rrip <device><mount_dir> -o xlat=unix
Guia de instalação e configuração 163
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
Por exemplo,
pfs_mount /dev/dsk/c0t2d0 /cdrom -o xlat=unix
Agora é possível instalar ou copiar arquivos como um usuário que não seja o usuário raiz
utilizando um disco do IBM Cognos a partir dessa unidade.
● Ao concluir a instalação, digite pfs_umount /cdrom e desabilite os daemons pfsd e
pfs_mountd para desmontar o disco.
7. Para iniciar o assistente de instalação, vá para o diretório do sistema operacional e digite
./issetup
Observação: Ao utilizar o comando issetup com o XWindows, os caracteres japoneses em
mensagens e arquivos de log podem ficar corrompidos. Ao instalar em japonês no UNIX ou
Linux, configure primeiro as variáveis de ambiente LANG=C e LC_ALL=C (onde C é o código
do idioma, por exemplo, ja_JP.PCK no Solaris), e então execute o assistente de instalação.
Se não estiver usando o XWindows, execute uma instalação autônoma (p. 345 ).
8. Siga as instruções do assistente de instalação e copie os arquivos necessários para seu
computador.
● Ao selecionar o diretório, considere o seguinte:
Instale os componentes de gateway em um diretório que contenha apenas caracteres ASCII
no nome do caminho. Alguns servidores web UNIX e Linux só suportam caracteres ASCII
nos nomes dos diretórios.
Se estiver instalando o IBM Cognos BI em um computador que possui o ReportNet ou
uma versão anterior do IBM Cognos BI e desejar manter a versão anterior, é necessário
instalar o IBM Cognos BI em um diretório diferente.
Se estiver fazendo uma instalação em um diretório que contém outros componentes do
IBM Cognos BI, haverá uma solicitação para criar cópias de backup dos arquivos que serão
substituídos.
● Ao selecionar os componentes, desmarque todos, exceto Gateway.
9. Na página Concluir do assistente de instalação, faça o seguinte:
● Se desejar ver os arquivos de log, clique em Exibir para o arquivo de log apropriado.
● Se desejar ver as últimas informações sobre o produto, assinale a caixa de seleção das Notas
de versão do IBM Cognos.
● Não configure o IBM Cognos BI imediatamente porque é necessário realizar outras tarefas
antes para garantir que o ambiente esteja devidamente configurado. Verifique se a caixa
de seleção IBM Cognos Configuration está desmarcada.
Será possível configurar o IBM Cognos BI posteriormente com o IBM Cognos Configuration,
digitando cogconfig.sh no diretório local_c10/bin ou executando uma configuração silenciosa
ou editando cogstartup.xml no diretório local_c10/configuration.
● Clique em Concluir.
164 IBM Cognos Business Intelligence PowerPlay
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
10. Anexe o diretório local_c10/bin à variável de ambiente do caminho da biblioteca apropriada.
● Para Solaris e Linux, LD_LIBRARY_PATH
● Para AIX, LIBPATH
● Para HP-UX, SHLIB_PATH
Se desejar que os usuários vejam a documentação do produto em um idioma diferente do inglês,
será necessário instalar o componente Supplementary Languages Documentation no local em que
os componentes de gateway foram instalados. Para obter mais informações, consulte "Instalação
da documentação do produto traduzida" (p. 188 ).
Etapas para o Windows
1. Caso esteja fazendo a instalação em um diretório com outros componentes do IBM Cognos
BI, interrompa o serviço do IBM Cognos.
2. Execute um dos seguintes procedimentos:
● Insira o disco do produto IBM Cognos.
Se o assistente de instalação não abrir automaticamente, acesse o diretório do sistema
operacional e clique duas vezes em issetup.exe.
● Acesse o local em que os arquivos de instalação foram baixados e extraídos e clique duas
vezes em issetup.exe.
3. Selecione o idioma para utilizar na instalação.
O idioma selecionado será o mesmo da interface do usuário. Todos os idiomas suportados são
instalados. É possível alterar a interface do usuário para qualquer um dos idiomas instalados
depois de concluída a instalação.
4. Siga as instruções do assistente de instalação e copie os arquivos necessários para seu
computador.
● Ao selecionar o diretório, considere o seguinte:
Instale os componentes de gateway em um diretório que contenha apenas caracteres ASCII
no nome do caminho. Alguns servidores web do Windows® só suportam caracteres ASCII
nos nomes dos diretórios.
Se estiver instalando o IBM Cognos BI em um computador que possui o ReportNet ou
uma versão anterior do IBM Cognos BI e desejar manter a versão anterior, é necessário
instalar o IBM Cognos BI em um diretório diferente.
Se estiver fazendo uma instalação em um diretório que contém outros componentes do
IBM Cognos BI, haverá uma solicitação para criar cópias de backup dos arquivos que serão
substituídos.
● Ao selecionar os componentes, desmarque todos, exceto Gateway.
5. Na página Concluir do assistente de instalação, faça o seguinte:
● Se desejar ver os arquivos de log, clique em Exibir para o arquivo de log apropriado.
Guia de instalação e configuração 165
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
● Se desejar ver as últimas informações sobre o produto, assinale a caixa de seleção das Notas
de versão do IBM Cognos.
● Não configure o IBM Cognos BI imediatamente porque é necessário realizar outras tarefas
antes para garantir que o ambiente esteja devidamente configurado. Verifique se a caixa
de seleção IBM Cognos Configuration está desmarcada.
É possível configurar o IBM Cognos BI posteriormente utilizando o menu Iniciar do
Windows para iniciar o IBM Cognos Configuration na pasta de atalho.
● Clique em Concluir.
Se desejar que os usuários vejam a documentação do produto em um idioma diferente do inglês,
será necessário instalar o componente Supplementary Languages Documentation no local em que
os componentes de gateway foram instalados. Para obter mais informações, consulte "Instalação
da documentação do produto traduzida" (p. 188 ).
Instalação de pacotes de correçõesA IBM® fornece pacotes de manutenção que contêm atualização para um ou mais componentes
dos produtos IBM Cognos®. Se o pacote de correções estiver disponível ao instalar ou atualizar o
produto, instale-o após os componentes do IBM Cognos Business Intelligence.
Se o pacote de correções estiver disponível após a implantação do produto IBM Cognos, interrompa
o serviço, instale o fix pack no mesmo local que os componentes IBM Cognos BI e inicie o serviço.
Os pacotes de correções estão disponíveis para download no IBM Support em http://www.ibm.com/
support/us/en/.
IMPORTANTE: Os pacote de correções não são instalações independentes. Deve-se instalá-los em
computadores que têm os componentes de servidor IBM Cognos BI instalados. Instale os pacotes
de correções apropriados para a versão do produto. Para verificar qual a versão que possui, abra
o arquivo de lista de componentes em local_c10\cmplst.txt e verifique a linha que começa com
C8BISRVR_version=.
Antes de instalar o pacote de correções, crie um backup do banco de dados de armazenamento de
conteúdo. Além disso, faça back-up dos arquivos personalizados da instalação atual.
Etapas para o sistema operacional Microsoft Windows
1. Se o produto IBM Cognos BI estiver em execução, abra o IBM Cognos Configuration e
interrompa o serviço do IBM Cognos.
2. Faça backup do armazenamento de conteúdo.
3. Se o ambiente IBM Cognos BI for personalizado, faça backup de todo o local IBM Cognos BI.
4. Insira o disco do pacote de correções do sistema operacional Microsoft® Windows® ou acesse
o local em que o download foi feito e os arquivos foram extraídos.
Se mais de um pacote de correções estiver disponível, instale o que tiver o menor número de
versão primeiro.
166 IBM Cognos Business Intelligence PowerPlay
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
5. No disco ou no local de download, acesse o diretório win32 e clique duas vezes no arquivo
issetup.exe.
6. Siga as instruções do assistente de instalação, instalando no mesmo local que os componentes
de servidor IBM Cognos BI já existentes.
O programa issetup solicitará permissão para que o pacote de correções crie uma cópia de
backup na pasta de instalação antes de copiar novos arquivos.
7. Se o atualizador estiver disponível, faça o seguinte:
● Para fazer uma instalação a partir do disco, insira o disco do atualizador do sistema
operacional Windows.
● Para fazer uma instalação a partir de download, siga as instruções do site de suporte e
acesse o local onde o download foi feito e os arquivos extraídos.
● No diretório do atualizador do disco ou do local de download, acesse o diretório win32 e
clique duas vezes no arquivo issetup.exe.
● Siga as instruções do assistente de instalação.
8. Para retornar um produto IBM Cognos BI implantado no serviço, abra o IBM Cognos
Configuration, salve a configuração e inicie o serviço IBM Cognos.
9. Se tiver um ambiente distribuído, repita essas etapas para todos os servidores IBM Cognos BI
restantes.
10. Se estiver executando o produto IBM Cognos BI em um servidor de aplicativos que não seja o
padrão, Tomcat, implante o produto IBM Cognos BI novamente no servidor de aplicativos.
Para obter instruções, consulte "Configuração de propriedades do servidor de aplicativos e
implantação do IBM Cognos 8" (p. 322 ).
Etapas para os sistemas operacionais UNIX e Linux
1. Se o produto IBM Cognos BI estiver em execução, abra o IBM Cognos Configuration e
interrompa o serviço do IBM Cognos.
2. Faça backup do armazenamento de conteúdo.
3. Se o ambiente IBM Cognos BI for personalizado, faça backup de todo o local IBM Cognos BI.
4. Se estiver usando um disco, monte o disco do pacote de correções adequado para o sistema
operacional UNIX® ou Linux®, usando as extensões de arquivo Rock Ridge.
Importante: Para montar o disco do IBM Cognos no HP-UX, proceda da seguinte forma:
● Adicione o diretório pfs_mount no caminho.
Por exemplo,
PATH=/usr/sbin/:$PATH
exporte PATH
Guia de instalação e configuração 167
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
● Para iniciar os daemons NFS solicitados e executar os daemons em segundo plano, digite
bg pfs_mountd e depois bg pfsd
● Para montar a unidade, digite
pfs_mount -t rrip <device><mount_dir> -o xlat=unix
Por exemplo,
pfs_mount /dev/dsk/c0t2d0 /cdrom -o xlat=unix
Agora é possível instalar ou copiar arquivos como um usuário que não seja o usuário raiz
utilizando um disco do IBM Cognos nessa unidade.
● Ao concluir a instalação, digite pfs_umount /cdrom e finalize os daemons pfsd e pfs_mountd
para desmontar o disco.
5. Se estiver usando um download, acesse o local onde o download foi feito e onde os arquivos
do pacote de correções foram extraídos.
Se mais de um pacote de correções estiver disponível, instale o que tiver o menor número de
versão primeiro.
6. Para iniciar o assistente de instalação, digite
./issetup
Se não estiver usando o XWindows, execute uma instalação autônoma (p. 345 ).
7. Siga as instruções do assistente de instalação, instalando no mesmo local que os componentes
de servidor IBM Cognos BI já existentes.
O programa issetup solicitará permissão para que o pacote de correções crie uma cópia de
backup na pasta de instalação antes de copiar novos arquivos.
8. Se o atualizador estiver disponível, faça o seguinte:
● Para instalar a partir de um disco, monte o disco de atualizador adequado para o sistema
operacional, usando as extensões de arquivo Rock Ridge.
Importante: Para montar o disco no HP-UX, siga as instruções da etapa 4.
● Para instalar a partir de um download, acesse o local onde o download foi feito e os arquivos
do atualizador foram extraídos.
● Para iniciar o assistente de instalação, digite
./issetup
Se não estiver usando o XWindows, execute uma instalação autônoma (p. 345 ).
● Siga as instruções do assistente de instalação, instalando no mesmo local que os componentes
de servidor IBM Cognos BI já existentes.
9. Para retornar um produto IBM Cognos BI implantado no serviço, abra o IBM Cognos
Configuration, salve a configuração e inicie o serviço IBM Cognos.
168 IBM Cognos Business Intelligence PowerPlay
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
10. Se tiver um ambiente distribuído, repita essas etapas para todos os servidores IBM Cognos BI
restantes.
11. Se estiver executando o produto IBM Cognos BI em um servidor de aplicativos que não seja o
padrão, Tomcat, implante o produto IBM Cognos BI novamente no servidor de aplicativos.
Para obter instruções, consulte "Configuração de propriedades do servidor de aplicativos e
implantação do IBM Cognos 8" (p. 322 ).
Início do IBM Cognos ConfigurationUse a ferramenta de configuração, o IBM® Cognos® Configuration, para configurar os componentes
do IBM Cognos Business Intelligence durante o processo de instalação e configuração, e para iniciar
e interromper os serviços do IBM Cognos.
Antes de iniciar o IBM Cognos Configuration, certifique-se de que o ambiente operacional esteja
devidamente configurado. Por exemplo, certifique-se de que todas as variáveis de ambiente foram
definidas.
Nos sistemas operacionais UNIX® ou Linux®, não inicie o IBM Cognos Configuration na última
página do assistente de instalação. É necessário realizar configurações adicionais antes de configurar
o IBM Cognos BI. Por exemplo, é necessário atualizar o ambiente JavaTM . No sistema operacional
Microsoft® Windows®, será possível iniciar o IBM Cognos Configuration na última página do
assistente de instalação somente se não for necessário fazer nenhuma configuração adicional. Por
exemplo, se um servidor de banco de dados diferente do Microsoft® SQL ou do Cognos Content
Database for utilizado para o armazenamento de conteúdo, copie os drivers Java Database
Connectivity (JDBC) para o local apropriado antes de iniciar a ferramenta de configuração.
Certifique-se de que a conta de usuário ou serviço esteja definida. Para obter mais informações,
consulte "Configuração de contas de usuário ou contas de serviço de rede no IBM Cognos Business
Intelligence" (p. 52 ).
Etapas no UNIX ou Linux
1. Acesse o diretório local_c10/bin e digite
./cogconfig.sh
2. Se desejar acessar a ajuda do IBM Cognos Configuration, acesse o diretório
local_c10/configuration e edite o arquivo cogconfig.prefs para adicionar o local de seu navegador
Web.
Por exemplo, se utilizar o Firefox, adicione o seguinte texto ao arquivo:
BrowserPath=Web_browser_location/firefox
onde Web_browser_location é um caminho, como /usr/local/bin/
Seu navegador da web deve aceitar a seguinte sintaxe:
$ <Web_browser_location> <URL>
Etapas no Windows
1. No menu Iniciar, clique em Programas > IBM Cognos 10 > IBM Cognos Configuration.
Guia de instalação e configuração 169
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
2. Se desejar acessar a ajuda do IBM Cognos Configuration, acesse o diretório
local_c10\configuration e edite o arquivo cogconfig.prefs para adicionar o local de seu navegador
Web.
Por exemplo, se utilizar o Firefox, adicione o seguinte texto ao arquivo:
BrowserPath=localização_navegador_web\firefox
sendo que localização_navegador_web é um caminho, como \usr\local\bin\
Seu navegador da web deve aceitar a seguinte sintaxe:
$ <Web_browser_location> <URL>
Configuração de propriedades de ambiente e de segurança para computadoresde gateway
Se instalar o componente de gateway em um computador diferente do Content Manager ou
componentes da camada de aplicativos, configure o computador do gateway para que saiba a
localização de um distribuidor. Um distribuidor está instalado em cada computador com o Content
Manager e os componentes da camada de aplicativos. Configure o gateway para utilizar o
distribuidor em um computador com componentes da camada de aplicativos.
Para obter proteção de failover, configure mais de um distribuidor para um computador com
gateway. Quando vários distribuidores estão configurados, as solicitações são normalmente roteadas
para o primeiro distribuidor da lista. Se esse distribuidor tornar-se indisponível, o gateway
determinará o próximo distribuidor funcional na lista e fará o roteamento de solicitações para ele.
O status do distribuidor principal é monitorado pelo gateway, e as solicitações são roteadas de
volta para esse componente quando retorna ao serviço.
Depois de executar as tarefas de configuração exigidas, o computador com gateway pode trabalhar
no ambiente.
Verifique se os computadores onde o Content Manager foi instalado estão configurados e o
computador com o Content Manager ativo padrão está disponível antes de configurar computadores
com gateway.
Etapas
1. Inicie o IBM® Cognos® Configuration.
2. Na janela Explorer, clique em Ambiente.
3. Na janela Propriedades, em Configurações de Gateway, especifique os valores de URIs de
distribuidores do gateway:
● Clique na coluna valor.
● Clique no botão de edição.
● Altere a porção localhost do URI para o nome ou endereço IP de um computador com
componentes da camada de aplicativos.
Isso garantirá que os usuários em locais diferentes possam se conectar a relatórios e painéis
de controle enviados por e-mail.
170 IBM Cognos Business Intelligence PowerPlay
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
Dica: se deseja enviar solicitações para o distribuidor de um aplicativo SDK ou uma
ferramenta de modelagem do IBM Cognos BI que está fora de um firewall da rede, conecte-se
a um gateway dedicado que esteja configurado para conectar-se ao distribuidor utilizando
o URI de distribuidor interno para o ambiente (por exemplo, http://localhost:9300/p2pd/
servlet/dispatch). Por questões de segurança, a configuração padrão da propriedade URI
de distribuidores de gateway impede o distribuidor de aceitar solicitações para um aplicativo
SDK ou ferramenta de modelagem que esteja fora do firewall. É necessário configurar a
segurança adequada para esse gateway dedicado, como SSL. Não altere o gateway principal
para utilizar o URI do distribuidor interno. Isso reduziria a segurança do portal e dos
studios do IBM Cognos BI.
● Se deseja adicionar outro URI, clique em Adicionar e altere a porção localhost do novo
URI para o nome ou endereço IP de outro computador com componentes da camada de
aplicativos.
Dica: se deseja utilizar o distribuidor em um computador com Content Manager de espera,
certifique-se de tê-lo adicionado depois de adicionar computadores com componentes da
camada de aplicativos. Se adicionar o distribuidor do computador com Content Manager
ativo, verifique se é o último da lista.
● Depois de especificar todos os URIs, clique em OK.
4. Na janela Explorer, em Segurança > Criptografia, clique em Cognos, o provedor de criptografia
padrão.
5. No grupo de propriedades Configurações da autoridade de certificação, defina a propriedade
Senha para coincidir com as configurações do computador com Content Manager ativo padrão.
6. Certifique-se de que as definições criptográficas coincidam com o que foi definido no computador
com Content Manager ativo padrão.
7. Teste para saber se a chave simétrica pode ser recuperada. Na janela Explorer, clique com o
botão direito em Criptografia e clique em Testar.
Os componentes do IBM Cognos BI verificam a disponibilidade de chaves simétricas comuns
(CSK).
8. No menu Arquivo, clique em Salvar.
Configuração do servidor webPara todas as instalações, antes de usar páginas da web geradas pelo IBM® Cognos® Business
Intelligence, é necessário configurar o servidor web. É necessário criar diretórios virtuais, ou aliases,
para que os usuários possam se conectar ao IBM Cognos BI no portal. Se planejar executar o
produto IBM Cognos BI mais de uma vez, ou diversas instâncias do mesmo produto em um
computador, é necessário criar um pool de aplicativos separado para cada produto ou instância e
depois associar os aliases para esse produto ou instância ao pool de aplicativos. As etapas para
criar um pool de aplicativo variam dependendo de seu sistema operacional.
Guia de instalação e configuração 171
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
Para o IBM Cognos BI para criação de relatórios, é preciso configurar também a validade do
conteúdo para o diretório de imagens no servidor web para que o navegador web não verifique o
status da imagem depois do primeiro acesso.
No UNIX® e no Linux®, a conta na qual o servidor web é executado deve ter acesso de leitura para
o arquivo cogstartup.xml no diretório local_c10/configuration. Por padrão o arquivo cogstartup.xml
possui permissão de acesso para outros. Se o servidor web for executado em um grupo específico,
é possível mudar as permissões do arquivo cogstartup.xml para garantir que pertença ao mesmo
grupo do servidor web. É possível então remover a permissão de leitura para os outros.
Etapas para criar diretórios virtuais
1. Crie os diretórios virtuais da tabela a seguir:
PermissãoLocalizaçãoAlias
Leituralocal_c10/webcontentibmcognos
Execuçãolocal_c10/cgi-binibmcognos/cgi-bin
É possível usar um nome diferente de ibmcognos nos aliases. Entretanto, é necessário usar cgi
bin como a segunda parte do alias e mudar o diretório virtual na propriedade URI do gatewaypara coincidir com o novo alias do IBM Cognos.
Para o servidor web Apache, certifique-se de que o alias ibmcognos/cgi-bin foi definido antes
do alias ibmcognos no arquivo httpd.conf no diretório instalação_Apache/conf. O alias
ibmcognos/cgi-bin deve ser definido como um ScriptAlias.
2. Se deseja usar o navegador de imagens do Report Studio, ative o Web Distributed Authoring
and Versioning (WebDAV) no servidor web.
Se utilizar o servidor web Apache, especifique em qual diretório ativar o WebDAV. Para obter
informações sobre como configurar o WebDAV, consulte a documentação de seu servidor web.
Caso utilize o Microsoft® Internet Information Services (IIS), ative as propriedades Read e
Directory Browsing para o URL que deseja acessar.
3. Para a criação de relatórios no IBM Cognos BI, defina a validade do conteúdo no diretório
virtual local_c10/webcontent/pat/images no servidor web.
Cada vez que um usuário abre o Report Studio, o navegador web verifica com o servidor web
para determinar se as imagens são atuais. Devido ao fato de haver mais de 600 imagens, isto
pode resultar em tráfico de rede excessivo. É possível adiar esta verificação até uma data
específica usando o recurso de validade do conteúdo do servidor web.
Para obter informações sobre como definir a validade do conteúdo, consulte a documentação
de seu servidor web.
Observação: ao atualizar, os usuários do Report Studio devem limpar o cache de seus
navegadores para obterem as imagens mais recentes.
172 IBM Cognos Business Intelligence PowerPlay
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
Se utilizar aliases web diferentes de ibmcognos, ou o servidor web estiver em outro computador,
ou estiver utilizando o Microsoft Internet Application Interface (ISAPI), apache_mod ou um gateway
de servlet, altere o URI do gateway ao configurar componentes do IBM Cognos.
Etapas para a criação de um pool de aplicativos no Windows Server 2008
1. No sistema operacional Microsoft® Windows®, no menu Iniciar, selecione Painel de Controle
> Desempenho e manutenção >Ferramentas Administrativas.
2. Inicie o Internet Information Services (IIS) Manager.
Web Management Tools e World Wide Web Services estão ativados automaticamente.
3. A partir da raiz (o nome de seu sistema e seu usuário), selecione Features View.
4. Na seção IIS, inicie ISAPI and CGI Restrictions.
5. Selecione Edit Feature Settings e ative Allow unspecified CGI modules, em seguida clique em
OK.
6. Adicione os aliases. Por example, local_c10,local_c10/cgi-bin.
7. Selecione o alias cgi-bin e certifique-se de que a opção Features View esteja selecionada.
8. Clique com o botão direito em Application Pools e selecione Adicionar
9. Na caixa de diálogo, digite um alias web e o caminho correspondente para o IBM Cognos BI
webcontent.
10. Repita as etapas 8 e 9 para adicionar o alias da Web seguinte.
11. Selecione Default Web Site.
12. Abra Handler Mappings.
13. Selecione o mapeamento CGI-cgi.
14. No quadro direito, clique em Revert to Inherited.
15. Expanda o aplicativo que aponta para o local do webcontent.
16. Expanda o nó do seu aplicativo cgi-bin.
17. Adicione um mapeamento que aponte para *.cgi e chame-o de CGI-cgi.
18. Selecione o mapeamento CGI-cgi.
19. No quadro direito, clique em Revert to Inherited.
20. Reinicie o servidor IIS.
21. Encontre a pasta que contem cgi-bin (local_c10/cgi-bin) e clique nela com o botão direito do
mouse.
22. Selecione a guia Segurança.
23. Adicione o usuário Network Services concedendo todas as permissões, exceto Full Control.
Guia de instalação e configuração 173
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
24. Clique com o botão direito do mouse em Serviço do Cognos e selecione Propriedades.
25. Clique na guia Logon.
26. Clique em This account e digite Network Service como o usuário.
27. Exclua os valores de Senha e de Confirm the password.
28. Clique em OK.
Teste do gatewayÉ possível testar a instalação utilizando um navegador web.
Etapas
1. Verifique se o servidor web está em execução.
2. Abra um navegador web.
3. Na caixa de endereço, digite o URI do gateway do IBM® Cognos® Configuration. Por exemplo,
http://nome_host:porta/ibmcognos
A página Bem-vindo do portal do IBM® Cognos® BI é exibida.
Instalação e configuração de migração nos computadores comIBM Cognos Series 7
Antes que o Assistente de migração possa ser usado no IBM® Cognos® PowerPlay® para migrar o
conteúdo do IBM Cognos Series 7 do PowerPlay Enterprise Server, Upfront ou IBM Cognos
Connection, é necessário instalar componentes de migração nos computadores com IBM Cognos
Series 7. Os componentes de migração do IBM Cognos Series 7 estão disponíveis para Microsoft®
Windows® e UNIX® no CD do IBM Cognos PowerPlay Server.
Use a seguinte lista de verificação para guiá-lo através das tarefas necessárias para instalar e
configurar o IBM Cognos Migration.
❑ Instale os componentes de migração do IBM Cognos Series 7.
❑ Configure os componentes de migração do IBM Cognos Series 7, se necessário.
❑ Inicie o IBM Cognos Series 7 Migration Service
Para obter informações sobre migração de conteúdo do IBM Cognos Series 7 para o IBM Cognos BI,
incluindo recomendações de configuração para o processo de migração, consulte oGuia de migração
e administração do IBM Cognos PowerPlay.
Instalação do IBM Cognos Series 7 Migration ComponentsCertifique-se de que as instalações do IBM Cognos Series 7 estejam funcionando corretamente antes
de instalar os componentes de migração do IBM Cognos Series 7. Certifique-se de que o Serviço
IBM Cognos Series 7 PowerPlay Enterprise Server e os serviços Upfront, incluindo os serviços IBM
174 IBM Cognos Business Intelligence PowerPlay
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
Cognos Upfront Administration Service, IBM Cognos Upfront Data Store e IBM Cognos Upfront
Dispatcher, estejam funcionando.
Instale os componentes de migração do IBM Cognos Series 7 nos computadores IBM Cognos Series
7.
● Para migrar conteúdo de um PowerPlay Enterprise Server, é necessário instalar componentes
de migração do IBM Cognos Series 7 no computador PowerPlay Enterprise Server. Se o Upfront
estiver localizado no mesmo computador também é possível migrar conteúdo do Upfront. A
instalação de componentes de migração no computador PowerPlay Enterprise Server também
suporta a migração de conteúdo PowerPlay publicado no Cognos Connection.
● Para migrar conteúdo do Upfront é necessário instalar o IBM Cognos Series 7 Migration
Components no computador Upfront. Quando o Upfront e o PowerPlay Enterprise Server
estiverem instalados em computadores separados, é necessário instalar o IBM Cognos Series 7
Migration Components nos computadores PowerPlay Enterprise Server e Upfront. Além disso,
é necessário configurar uma localização de rede compartilhada para suportar o processamento
da migração.
Etapas
1. Insira o CD do IBM Cognos PowerPlay Server adequado para seu sistema operacional. No
UNIX, é necessário montar o CD utilizando as extensões de arquivo Rock Ridge
2. Se a página Bem-vindo não aparecer, execute um dos procedimentos a seguir:
● No Windows, no diretório win32 no CD, clique duas vezes no arquivo issetup.exe.
● No UNIX, no diretório apropriado para o sistema operacional, digite
./issetup
3. Selecione o idioma para utilizar na instalação.
O idioma selecionado determina o idioma do assistente de instalação.
4. Siga as instruções do assistente de instalação.
5. Na página Seleção do componente, desmarque todos os componentes, exceto Componentes de
migração do IBM Cognos Series 7.
6. Na página Vários locais de instalação, especifique a localização do IBM Cognos Series 7 para
instalar os componentes.
O IBM Cognos Series 7 Migration Components deve ser instalado no mesmo diretório do IBM
Cognos Series 7 versão 4 (7.4).
Se estiver instalando os componentes de migração do IBM Cognos Series 7 em um computador
com Microsoft Windows, o local de instalação deve ser uma unidade física e não uma unidade
mapeada. Caso contrário, não será possível iniciar o serviço de migração.
Se for solicitada uma localização de instalação do IBM Cognos BI, é possível aceitar a localização
por padrão ou digitar uma nova. Essa localização é usada para gravar arquivos instalados. Não
é necessário inserir o caminho em uma instalação do IBM Cognos BI em um computador
Guia de instalação e configuração 175
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
diferente e não são necessários componentes do IBM Cognos BI no computador IBM do Cognos
Series 7.
7. Na página Informações de configuração para migração, para o Número da porta do serviço
de migração, digite o número da porta que o serviço de migração do IBM Cognos Series 7 deve
usar. O padrão é 21567.
8. Na página Concluir , clique em Concluir.
Assim como outros produtos IBM Cognos, o processo de instalação cria arquivos de log que incluem
informações como detalhes sobre arquivos transferidos e erros de instalação. Os arquivos de log
estão localizados no diretório installation_location\instlog.
Configuração do serviço de migração do IBM Cognos Series 7 para migrações doUpfront em instalações distribuídas do IBM Cognos Series 7
Se o IBM Cognos Series 7 Migration Components foi instalado em um computador PowerPlay
Enterprise Server e um computador Upfront separado, é necessário configurar uma localização de
rede compartilhada. O serviço de migração grava arquivos temporariamente neste local durante o
processo de migração.
As seguintes limitações se aplicam para a migração do Upfront quando o PowerPlay Enterprise
Server e Upfront estiverem em computadores separados.
Observações
● O PowerPlay Enterprise Server e o Upfront devem acessar PowerCubes usando o mesmo
caminho, como \\nome_máquina\cubes. Se os cubos estiverem localizados no mesmo computador
que o PowerPlay Enterprise Server, este irá acessá-los usando um caminho local e o Upfront
irá acessar os cubos usando um caminho que inclua o nome do computador PowerPlay
Enterprise. A migração do Upfront não funcionará nesta situação.
Etapas
1. Crie uma pasta em uma localização de rede compartilhada que esteja acessível dos computadores
PowerPlay Enterprise Server e Upfront.
Certifique-se que os serviços de migração do PowerPlay Enterprise Server, Upfront e IBM
Cognos Series 7 sejam executados sob uma conta nomeada que possua acesso de gravação para
a pasta.
2. Realize as etapas a seguir em cada computador que possui os componentes de migração do
IBM Cognos Series 7.
● No local_instalação/mig7service, abra o arquivo migs7service_configuration.xml em um
editor XML ou de texto.
● Edite a linha series7-shared-location description para especificar o local de rede e ative a
linha (remova as tags de comentário). Por exemplo,
<series7-shared-location description="Caminho para a pasta compartilhada">\\bott93\
shareT\s7migration</series7-shared-location>
176 IBM Cognos Business Intelligence PowerPlay
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
● Salve e feche o arquivo.
3. Reinicie o serviço de migração do IBM Series 7.
A configuração para suportar migração de computadores PowerPlay Enterprise Server e Upfront
separados foi concluída.
Início do IBM Cognos Series 7 Migration ServiceAntes de migrar o conteúdo do IBM Cognos Series 7 PowerPlay para o IBM Cognos PowerPlay, é
necessário iniciar o serviço de migração do IBM Cognos Series 7. No Windows, o serviço de migração
do IBM Cognos Series 7 inicia automaticamente quando é instalado pela primeira vez.
Etapa
● Inicie o serviço de migração:
● No Windows, se o serviço parou, reinicie o serviço de migração usando a entrada do IBM
Cognos Migration Series 7 Service na lista Serviços em Ferramentas administrativas.
● No UNIX, vá para o diretório local_c10/migs7 e inicie o serviço digitando:
./configure.sh --start
Desinstalação do IBM Cognos BIÉ importante utilizar os programas de desinstalação para remover completamente todos os arquivos
e as modificações dos arquivos do sistema.
Para desinstalar o IBM® Cognos® Business Intelligence, desinstale os componentes e as ferramentas
de modelagem do servidor.
Caso esteja executando o IBM Cognos BI em um ambiente de servidor de aplicativos, use a
ferramenta de administração fornecida com o servidor de aplicativos para interromper o aplicativo,
caso este esteja em execução, e desimplante a porção JavaTM dos componentes do IBM Cognos BI.
Muitos servidores de aplicativos não removem completamente todos os arquivos ou diretórios de
aplicativos implantados durante uma desimplantação; desta forma, esta ação deverá ser feita
manualmente. Depois de ter desimplantado os componentes do IBM Cognos BI, complete as etapas
dessa seção para desinstalar no UNIX® e no Windows®.
Importante
● Não exclua os arquivos de configuração e de dados se estiver atualizando para uma nova versão
do IBM Cognos BI e se desejar usar os dados de configuração com a nova versão.
● Se estiver utilizando o Cognos Content Database, a localização padrão para os arquivos de
banco de dados está no diretório local_c10/contentstore. Se deseja manter seu banco de dados
depois da desinstalação, não exclua esse diretório.
Guia de instalação e configuração 177
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
Desinstalação do IBM Cognos BI no UNIX ou LinuxCaso não haja mais necessidade do IBM Cognos BI ou se estiver fazendo uma atualização, desinstale
o IBM Cognos BI.
A desinstalação não remove os arquivos que foram alterados desde a instalação, tais como os de
configuração e dados dos usuários. A localidade da instalação continua no computador, e os arquivos
ficam retidos até que sejam excluídos manualmente.
Etapas
1. Se o console conectado ao computador não for compatível com uma interface gráfica de usuário
baseada em JavaTM, determine o processo de identificação (pid) do processo do IBM Cognos
BI digitando o seguinte comando:
ps -ef | grep cogbootstrapservice
2. Interrompa o processo do IBM Cognos BI:
● Se executar o XWindows, inicie o IBM Cognos Configuration, e do menu Ações clique
em Parar .
● Se não utilizar o XWindows, digite
kill -TERM pid
3. Para desinstalar o IBM Cognos BI, acesse o diretório local_c10/uninstall e digite o comando
apropriado:
● Caso utilize o XWindows, digite
./uninst -u
● Se não estiver usando o XWindows, execute uma desinstalação autônoma (p. 345 ).
4. Siga os prompts para completar a desinstalação.
5. Exclua todos os arquivos temporários de Internet dos computadores e navegadores web.
Desinstalação do IBM Cognos BI no WindowsCaso não haja mais necessidade do IBM Cognos BI ou se estiver fazendo uma atualização, desinstale
seus componentes e o serviço do IBM Cognos.
Se tiver instalado mais de um componente no mesmo local, escolha os pacotes para desinstalação
utilizando o assistente para desinstalação. Todos os componentes do pacote serão desinstalados. É
necessário repetir o processo de desinstalação em cada computador que contenha componentes do
IBM Cognos BI.
Não é necessário fazer backup de arquivos de configuração e de dados no Microsoft® Windows®.
Estes arquivos são preservados durante a desinstalação.
Feche todos os programas antes de desinstalar o IBM Cognos BI. Do contrário, alguns arquivos
podem não ser removidos.
178 IBM Cognos Business Intelligence PowerPlay
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
A desinstalação não remove os arquivos que foram alterados desde a instalação, tais como os de
configuração e dados dos usuários. A localidade da instalação continua no computador e os arquivos
ficam retidos até que sejam excluídos manualmente. Não exclua os arquivos de configuração e de
dados se estiver atualizando para uma nova versão do IBM Cognos BI e se desejar usar os dados
de configuração com a nova versão.
Etapas
1. No menu Iniciar, clique em Programas > IBM Cognos 10 > Desinstalar o IBM Cognos >
Desinstalar o IBM Cognos.
Exibe-se o assistente Desinstalação.
Dica: IBM Cognos BI é o nome padrão da pasta de programa criada durante a instalação. Caso
escolha outro nome, abra a pasta para encontrar o programa.
2. Siga as instruções de desinstalação dos componentes.
O arquivo cognos_uninst_log.htm registra as atividades realizadas pelo assistente de desinstalação
ao desinstalar os arquivos.
Dica: Para encontrar o arquivo de log, verifique o diretório Temp.
3. Exclua todos os arquivos temporários de Internet dos computadores e navegadores web.
Para obter mais informações, consulte a documentação do navegador web.
Desinstalação do Banco de dados de conteúdo do CognosCaso deseje desinstalar apenas o Banco de dados de conteúdo do Cognos e deixar outros
componentes do IBM Cognos BI no computador, será necessário executar o procedimento a seguir.
Depois de desinstalar o Banco de dados de conteúdo do Cognos é necessário configurar um novo
armazenamento de conteúdo antes de reiniciar o serviço do IBM Cognos.
Se tiver instalado apenas o Banco de dados de conteúdo do Cognos, execute o procedimento para
desinstalar o IBM Cognos BI no UNIX ou no Linux ou o procedimento para desinstalar o IBM
Cognos BI no Windows.
Etapas
1. No computador em que foi instalado o Banco de dados de conteúdo do Cognos, acesse o
diretório local_c10\bin e digite o seguinte comando:
● No Windows, digite
derby.bat uninstall
Este comando remove o serviço do Banco de dados de conteúdo do Cognos.
● No UNIX, digite:
derby.sh stop
Este comando pára o serviço do Banco de dados de conteúdo do Cognos.
2. No diretório local_c10, exclua o diretório derby10.1.2.1.
Guia de instalação e configuração 179
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
3. No diretório local_c10\bin, exclua os seguintes arquivos:
● No Windows, derby.bat
● No UNIX, derby.sh e derbyenv.sh
4. No Windows, no diretório local_c10\logs, exclua o arquivo derby.service.
5. No diretório local_c10, abra o arquivo cmplst.txt em um editor de texto.
6. Remova as linhas que contêm valores do Banco de dados de conteúdo do Cognos. Essas linhas
contêm CCD e CMDERBY. Por exemplo:
C8BISRVRCCD_version=
C8BISRVRCCD_name=
CCD_version=
CCD_name=
CMDERBY_version=
CMDERBY_name=
Dica: Também é possível fazer um comentário nas linhas inserindo # no final de cada linha.
7. Salve o arquivo.
8. Inicie o IBM Cognos Configuration.
9. Em Acesso a dados e Content Manager, faça o seguinte:
● Exclua o Banco de dados de conteúdo do Cognos.
● Configure um novo recurso de banco de dados para apontar para um novo armazenamento
de conteúdo.
Para obter mais informações, consulte "Configuração da conectividade de banco de dados para
o banco de dados de armazenamento de conteúdo" (p. 137 ).
10. Reinicie o IBM Cognos BI .
180 IBM Cognos Business Intelligence PowerPlay
Capítulo 7: Instalação e configuração dos componentes do servidor IBM Cognos PowerPlay em computadoresdiferentes
Capítulo 8: Instalação e configuração decomponentes opcionais
Os componentes opcionais fornecem funcionalidade estendida para os usuários.
Depois de instalar e configurar o IBM® Cognos® PowerPlay®, você pode instalar os seguintes
componentes opcionais.
● Amostras do IBM Cognos
● Documentação do produto traduzida
● Fontes adicionais para os símbolos de moedas japonesa e coreana
Amostras do PowerPlayAs amostras da Companhia das Grandes Aventuras ilustram os recursos do produto e as melhores
práticas técnicas e de negócios. Também é possível utilizá-los para testar com e compartilhar técnicas
de desenvolvimento de relatórios e para solução de problemas. As amostras incluem PowerCubes
e relatórios que podem ser utilizados no IBM® Cognos® PowerPlay® para testar os seguintes recursos:
● Migrar cubos e relatórios de amostra do IBM Cognos Series 7 para o IBM Cognos PowerPlay.
Para suportar a migração, algumas amostras devem ser copiadas para os servidores IBM Cognos
Series 7 PowerPlay.
Para obter mais informações sobre como utilizar as amostras para testar o processo de migração,
consulte o Guia de migração e administração do IBM Cognos PowerPlay.
● Exibir relatórios publicados do IBM Cognos PowerPlay no PowerPlay Studio e no PowerPlay
Client.
Para obter mais informações sobre como utilizar relatórios de amostra, consulte o Guia do
usuário do IBM Cognos PowerPlay Studio e o Guia do usuário do IBM Cognos PowerPlay
Client.
● Fazer o drill through de um relatório do IBM Cognos PowerPlay para outros relatórios e cubos.
Para obter mais informações sobre como utilizar drill through no IBM Cognos PowerPlay,
consulte o Guia de migração e administração do IBM Cognos PowerPlay.
A Companhia das Grandes Aventuras ou Vendas GA ou qualquer variação do nome Grandes
Aventuras, é o nome de operações de negócios fictício com dados de amostra usados para desenvolver
aplicativos de amostra para a IBM e seus clientes. Seus registros fictícios incluem dados de amostra
para transações de vendas, distribuição de produtos, e recursos humanos e financeiros. Qualquer
semelhança com nomes, endereço, números de contato ou valores de transações reais é mera
coincidência. A cópia não autorizada é proibida.
Licensed Materials – Property of IBM181© Copyright IBM Corp. 2005, 2010.
Antes de utilizar as amostras, o produto IBM Cognos Business Intelligence deve estar instalado,
configurado e em execução.
Se o ambiente do IBM Cognos incluir o Report Studio, o Analysis Studio, o Metric Studio ou o
IBM Cognos Transformer, é possível configurar outras amostras do IBM Cognos para serem
utilizadas com eles. Para obter informações sobre a configuração de outras amostras do IBM
Cognos BI, consulte o tópico Amostras no Guia de instalação e configuração para outros produtos
IBM Cognos BI.
Instalação de amostras do IBM Cognos BIInstale as amostras a partir do CD do IBM® Cognos® Business Intelligence.
A instalação do IBM Cognos Samples inclui várias fontes de dados, modelos, cubos, relatórios e
outros tipos de conteúdo para ser compatível com todos os componentes do IBM Cognos BI.
Somente alguns conteúdos de amostras interessam aos usuários do PowerPlay®. Em vez de adicionar
a instalação completa do IBM Cognos Samples ao computador com PowerPlay, instale as amostras
em um local de rede compartilhado e, em seguida, copie o conteúdo relevante para o computador
com PowerPlay. Os usuários de outros componentes do IBM Cognos BI podem copiar amostras
do mesmo local de rede.
Etapas para UNIX e Linux
1. Monte o disco do produto IBM Cognos usando extensões de arquivo Rock Ridge ou vá para
o local para o qual os arquivos de instalação foram baixados.
Para montar o disco do IBM Cognos no HP-UX, proceda da seguinte forma:
● Adicione o diretório pfs_mount no caminho.
Por exemplo,
PATH=/usr/sbin/:$PATH
exporte PATH
● Para iniciar os daemons NFS solicitados e executar os daemons em segundo plano, digite
bg pfs_mountd e depois bg pfsd
● Para montar a unidade, digite
pfs_mount -t rrip <device><mount_dir> -o xlat=unix
Por exemplo,
pfs_mount /dev/dsk/c0t2d0 /cdrom -o xlat=unix
Agora é possível instalar ou copiar arquivos como um usuário que não seja o usuário raiz
utilizando um disco do IBM Cognos dessa unidade.
● Ao concluir a instalação, digite pfs_umount /cdrom e finalize os daemons pfsd e pfs_mountd
para desmontar o CD.
2. Para iniciar o assistente de instalação, vá para o diretório do sistema operacional e digite
./issetup
182 IBM Cognos Business Intelligence PowerPlay
Capítulo 8: Instalação e configuração de componentes opcionais
Observação: Ao utilizar o comando issetup com o XWindows, os caracteres japoneses em
mensagens e arquivos de log podem ficar corrompidos. Ao instalar em japonês no UNIX®,
configure primeiro as variáveis de ambiente LANG=C e LC_ALL=C (em que C é o código do
idioma, por exemplo ja_JP.PCK no Solaris) e, em seguida, execute uma instalação autônoma.
Se não estiver usando o XWindows, execute uma instalação autônoma.
3. Siga as instruções do assistente de instalação e copie os arquivos necessários para seu
computador.
Instale as amostras no mesmo local dos componentes do servidor.
4. Na página Concluir do assistente de instalação, clique em Concluir.
Etapas para o Windows
1. Execute um dos seguintes procedimentos:
● Insira o disco do IBM Cognos BI Samples.
Se o assistente de instalação não abrir automaticamente, acesse o diretório do sistema
operacional e clique duas vezes em issetup.exe.
● Acesse o local em que os arquivos de instalação foram baixados e extraídos e clique duas
vezes em issetup.exe.
2. Selecione o idioma para utilizar na instalação.
O idioma selecionado será o mesmo da interface do usuário. É possível alterar o idioma para
qualquer um dos idiomas instalados depois de concluída a instalação.
3. Siga as instruções do assistente de instalação e copie os arquivos necessários para seu
computador.
Instale as amostras no mesmo local que os componentes do PowerPlay. Em uma instalação
distribuída, instale-as no computador de gateway.
4. Na página Concluir do assistente de instalação, clique em Concluir.
Configuração das amostras do IBM Cognos PowerPlayApós instalar as amostras do CD do IBM® Cognos® Business Intelligence, use a lista de verificação
a seguir para guiá-lo pelas tarefas de configuração das amostras.
❑ Crie uma conexão de fonte de dados para o PowerCube de amostra.
❑ Importe os relatórios de amostra.
❑ Configure PowerCubes e relatórios para exemplos de drill-through e migração.
Guia de instalação e configuração 183
Capítulo 8: Instalação e configuração de componentes opcionais
Criação de uma conexão de fonte de dados para o PowerCube de amostra
Antes de abrir a amostra de relatórios no PowerPlay® Studio, crie uma conexão de fonte de dados
com o PowerCube de amostra.
Etapas
1. Conecte-se ao portal do IBM Cognos BI.
2. Inicie o IBM Cognos Administration:
● Na página Bem-vindo, clique em Administrar o conteúdo do IBM Cognos.
● No IBM Cognos Connection, na barra de ferramentas, clique em Iniciar, IBM Cognos
Administration.
3. No IBM Cognos Administration, clique na guia Configuração.
4. Clique no botão de nova fonte de dados .
5. Na caixa Nome, digite great_outdoors_sales_en e, em seguida, clique em Avançar.
O nome deve estar em minúsculas e incluir caracteres de sublinhado.
6. Na caixa Tipo, selecione IBM Cognos PowerCube e clique em Avançar.
7. Na caixa de endereço, digite o caminho e o nome do arquivo para o PowerCube great_outdoors_
sales_en.mdc.
Por exemplo, se uma conexão para as amostras instaladas estiver sendo criada para o local
padrão da instalação no computador local, digiteC:\Program Files\ibm\cognos\c10\webcontent\
samples\datasources\cubes\PowerCubes\EN\great_outdoors_sales_en.mdc
8. Para confirmar que todos os parâmetros foram inseridos corretamente, clique em Testar a
conexão.
Após testar a conexão, clique em Fechar nas páginas Exibir os resultados e Testar a conexãopara retornar à página da string de conexão.
9. Clique em Concluir.
10. Na página Concluir, clique em OK. Não selecione Criar um pacote.
A entrada great_outdoors_sales_en é exibida na lista Conexões de Fontes de Dados.
Importação de relatórios de amostra
É possível tornar os relatórios de amostras disponíveis para uso no Cognos Viewer ou PowerPlay
Studio importando-os por meio de um arquivo de implantação. Os dados de amostra do PowerPlay
são compactados em um arquivo de implantação para PowerPlay e migração, e um arquivo de
implantação para exemplos de drill-through. Os arquivos de implantação são importados no IBM
Cognos Administration antes que os usuários possam acessar os relatórios.
Outro método para tornar relatórios disponíveis no Cognos Viewer ou PowerPlay Studio é publicá-
los utilizando o PowerPlay Client. Para obter mais informações, consulte o Guia do usuário do
IBM Cognos PowerPlay Client.
184 IBM Cognos Business Intelligence PowerPlay
Capítulo 8: Instalação e configuração de componentes opcionais
Antes de importar o conteúdo, verifique se o PowerCube de amostra foi configurado (p. 184 ).
Etapas para importar o PowerPlay e as amostras de migração
1. No computador em que as amostras estão instaladas, acesse o diretório local_c10\webcontent\
samples\content.
Por exemplo, se as amostras tiverem sido instaladas no local padrão de instalação, o caminho
será C:\Program Files\ibm\cognos\c10\webcontent\samples\content
2. Copie o arquivo IBM_Cognos_PowerPlay.zip para o diretório local_c10\deployment no
computador em que o componente do Content Manager está instalado.
3. Conecte-se ao portal do IBM Cognos BI.
4. Inicie o IBM Cognos Administration:
● Na página Bem-vindo, clique em Administrar o conteúdo do IBM Cognos.
● No IBM Cognos Connection, na barra de ferramentas, clique em Iniciar, IBM Cognos
Administration.
5. Clique na guia Configuração.
6. Clique em Administração de Conteúdo.
7. Clique no botão de nova importação .
8. Selecione IBM_Cognos_PowerPlay e clique em Avançar.
9. Mantenha o nome padrão e o local e, em seguida, clique em Avançar.
10. Selecione as pastas de Amostras e clique em Avançar.
11. Mantenha as opções padrão e clique em Avançar.
12. Revise o resumo e clique em Avançar.
13. Selecione Salvar e executar uma vez e clique em Concluir.
14. Selecione Agora e clique em Executar.
15. Clique em OK.
IBM_Cognos_PowerPlay é exibido em Administração e uma pasta Amostras é exibida em
Pastas públicas no IBM Cognos Connection.
Etapas para importar as amostras de drill-through
1. No computador em que as amostras estão instaladas, acesse o diretório local_c10\webcontent\
samples\content.
Por exemplo, se as amostras tiverem sido instaladas no local padrão de instalação, o caminho
será C:\Program Files\ibm\cognos\c10\webcontent\samples\content
Guia de instalação e configuração 185
Capítulo 8: Instalação e configuração de componentes opcionais
2. Copie o arquivo IBM_Cognos_DrillThroughSamples.zip para o diretório local_c10\deployment
no computador em que o componente do Content Manager está instalado.
3. Conecte-se ao portal do IBM Cognos BI.
4. Inicie o IBM Cognos Administration:
● Na página Bem-vindo, clique em Administrar o conteúdo do IBM Cognos.
● No IBM Cognos Connection, na barra de ferramentas, clique em Iniciar, IBM Cognos
Administration.
5. Clique em Configuração.
6. Clique em Administração de Conteúdo.
7. Clique no botão de nova importação .
8. Selecione IBM_Cognos_DrillThroughSamples e clique em Avançar.
9. Mantenha o nome padrão e o local e, em seguida, clique em Avançar.
10. Selecione a pasta Amostras e clique em Avançar.
11. Mantenha as opções padrão e clique em Avançar.
12. Revise o resumo e clique em Avançar.
13. Selecione Salvar e executar uma vez e clique em Concluir.
14. Selecione Agora e clique em Executar.
15. Clique em OK.
IBM_Cognos_DrillThroughSamples aparecerá em Administração. Duas pastas serão adicionadas
a Pastas públicas, Amostras, Pasta de modelos: Armazenamento de dados GA (análise) e
Armazenamento de dados GA (consulta). O Analysis Studio ou o Query Studio devem estar
instalados para a visualização dessas amostras de drill-through.
Teste de um relatório de amostra
É possível testar a importação abrindo um relatório de amostra no Cognos Viewer ou PowerPlay
Studio. O Cognos Viewer é o visualizador padrão quando um relatório é aberto no IBM Cognos
Connection.
Etapas para testar um relatório no Cognos Viewer
1. Conecte-se ao portal do IBM Cognos BI.
2. Inicie o IBM Cognos Connection:
● Na página Bem-vindo, clique em Conteúdo do IBM Cognos.
● No IBM Cognos Administration, na barra de ferramentas, clique em Iniciar, IBM Cognos
Connection.
186 IBM Cognos Business Intelligence PowerPlay
Capítulo 8: Instalação e configuração de componentes opcionais
3. Na lista Pastas públicas, abra Amostras, PowerPlay.
4. Clique em great_outdoors_sales_en.
5. Clique em qualquer relatório da lista.
O relatório é aberto no IBM Cognos Viewer.
Etapas para testar um relatório no PowerPlay Studio
1. Conecte-se ao portal do IBM Cognos BI.
2. Inicie o IBM Cognos Connection:
● Na página Bem-vindo, clique em Conteúdo do IBM Cognos.
● No IBM Cognos Administration, na barra de ferramentas, clique em Iniciar, IBM Cognos
Connection.
3. Acesse Pastas públicas, Amostras, PowerPlay.
4. Clique em Mais ao lado da entrada great_outdoors_sales_en .
5. Clique em Exibir o conteúdo do pacote.
6. Clique no botão Abrir com o PowerPlay Studio para qualquer relatório na lista.
O relatório será aberto no PowerPlay Studio.
Configuração de PowerCubes e relatórios de amostra para migração
Antes de fazer uma migração de amostras do IBM® Cognos® Series 7 para o IBM Cognos PowerPlay®,
é necessário copiar o PowerCube e os relatórios de amostra do IBM Cognos Series 7 do computador
com a instalação das amostras do IBM Cognos BI para o computador com o IBM Cognos Series 7
PowerPlay Enterprise Server.
Após configurar os PowerCubes e relatórios de amostra, é possível migrar os relatórios. Após a
migração, os usuários podem visualizar os relatórios no Cognos Viewer ou no PowerPlay Studio.
Por padrão, os relatórios migrados estão no formato PDF.
Para obter informações sobre como fazer a migração, consulte oGuia de migração e administração.
Etapas
1. No computador em que as amostras do IBM Cognos BI estão instaladas, copie o conteúdo a
seguir para o computador com o IBM Cognos Series 7.
● Todos os relatórios do diretório local_c10\webcontent\samples\powerplay_reports\
powerplay_7\reports_for_remote_cubes\idioma
● O great_outdoors_7.mdc do diretório local_c10\webcontent\samples\datasources\cubes\
PowerCubes\idioma.
2. No IBM Cognos Series 7 PowerPlay Administration, adicione o cubo e os relatórios ao PowerPlay
Enterprise Server.
Para obter informações, consulte o Enterprise Server Guide do IBM Cognos Series 7.
Guia de instalação e configuração 187
Capítulo 8: Instalação e configuração de componentes opcionais
3. Para atualizar o mapeamento do cubo, no cliente IBM Cognos Series 7 PowerPlay, abra cada
relatório usando uma conexão remota com o great_outdoors_7.mdc e salve o relatório.
O cubo e os relatórios estão agora prontos para serem utilizados no IBM Cognos Series 7.
Instalação da documentação do produto traduzidaA instalação do produto inclui um conjunto limitado da documentação traduzida para alguns
idiomas, como guias de instalação e notas de versão. Para acessar um conjunto completo da
documentação traduzida, é necessário instalá-lo a partir do IBM® Cognos® BI Supplementary
Language Documentation.
Antes de instalar o Supplementary Language Documentation, certifique-se de que
● O IBM Cognos BI está instalado e configurado corretamente.
● Há espaço em disco suficiente disponível para instalar o Supplementary Language
Documentation.
São necessários pelo menos 220 MB de espaço em disco.
● Seu ambiente de software seja suportado.
Etapas
1. No local em que o componente de gateway estiver instalado, insira o CD do IBM Supplementary
Languages Documentation ou acesse o diretório para o qual os arquivos de instalação foram
baixados e extraídos.
Nos sistemas operacionais UNIX® ou Linux®, monte o disco utilizando as extensões de arquivo
Rock Ridge.
No Windows®, o assistente de instalação inicia automaticamente a partir do disco do produto.
2. Para iniciar o assistente de instalação, vá para o diretório do sistema operacional e faça o
seguinte
● No Windows, se a página Bem-vindo não aparecer, clique duas vezes no arquivo issetup.exe.
● No UNIX ou Linux, digite
./issetup
Observação: Ao utilizar o comando issetup com o XWindows, os caracteres japoneses
podem ficar corrompidos.
3. Siga as instruções do assistente de instalação para copiar os arquivos requeridos na mesma
localização onde forem instalados os componentes de gateway do IBM Cognos BI.
Instale em um diretório que contenha apenas caracteres ASCII no nome do caminho. Alguns
servidores web não suportam caracteres que não sejam ASCII nos nomes dos diretórios.
Os componentes da documentação dos idiomas complementares são selecionados por padrão.
4. Escolha a opção desejada na página Concluir do assistente de instalação.
188 IBM Cognos Business Intelligence PowerPlay
Capítulo 8: Instalação e configuração de componentes opcionais
Instalação e configuração de fontes de idiomas adicionaisPara adicionar suporte aos caracteres do iene japonês ou won coreano, é necessário instalar fontes
adicionais do IBM® Cognos® BI Supplementary Language Documentation.
O ponto de código Unicode "U+005C" é oficialmente atribuído à barra invertida. Entretanto, no
Japão e na Coréia, esse código é atribuído historicamente aos símbolos de moeda e muitas pessoas
ainda preferem ver um sinal de iene ou won em determinadas partes do software, por exemplo em
caminhos de arquivo. Para ajustar isto, é possível instalar as fontes "Andale WT J" e "Andale WT
K".
Antes de instalar as fontes adicionais, verifique se
● O IBM Cognos BI está instalado e configurado corretamente.
● Haja espaço em disco disponível para instalar fontes adicionais.
São necessários pelo menos 220 MB de espaço em disco.
● Seu ambiente de software seja suportado.
Etapas
1. No local em que o Application Tier Components está instalado, insira o disco do IBM Cognos
BI Supplementary Language Documentation.
Nos sistemas operacionais UNIX® ou Linux®, monte o disco utilizando as extensões de arquivo
Rock Ridge.
2. Acesse o diretório do disco correspondente ao sistema operacional utilizado.
3. Inicie o assistente de instalação digitando o seguinte comando:
● No Windows®,
issetup
● No UNIX ou Linux,
./issetup
Observação: Ao utilizar o comando issetup com o XWindows, os caracteres japoneses
podem ficar corrompidos.
4. Siga as instruções do assistente de instalação para copiar os arquivos solicitados na mesma
localização onde instalou o Application Tier Components.
Instale em um diretório que contenha apenas caracteres ASCII no nome do caminho. Alguns
servidores web não suportam caracteres que não sejam ASCII nos nomes dos diretórios.
Ao ser solicitado para selecionar componentes, desmarque IBM Cognos Business Intelligence
Supplementary Languages Documentation, expanda Fontes de idioma adicionais e selecione a
fonte.
As fontes são copiadas para o diretório local_c10/bin/fonts. Esta localização de fonte é definida
no valor de propriedade Localizações de fontes físicas no IBM Cognos Configuration em
Guia de instalação e configuração 189
Capítulo 8: Instalação e configuração de componentes opcionais
Ambiente. Se mover as fontes para outro local, verifique se o novo local está adicionado ao
valor da propriedade Localizações de fontes físicas.
As fontes utilizadas para exibir dados em um relatório são selecionadas utilizando um processo
de correspondência entre fontes solicitado quando o relatório é projetado e as fontes que estão
disponíveis quando o relatório é produzido. Para saídas em PDF e gráficos, esse processo ocorre
no servidor onde todas as fontes do servidor que gera o relatório podem ser utilizadas.
5. Escolha a opção desejada na página Concluir do assistente de instalação.
Após instalar as fontes adicionais, é necessário configurar o suporte para as mesmas. Para obter
mais informações, consulte "Configuração de suporte para caracteres do iene japonês e do won
coreano" (p. 190 ).
Configuração de suporte para caracteres do iene japonês e do won coreanoPara que os caracteres das moedas japonesa e coreana sejam exibidos corretamente, é necessário
configurar fontes adicionais na planilha de estilo global.
Antes de configurar essas fontes, instale-as do disco do IBM® Cognos® BI Supplementary Language
Documentation.
Etapas para configurar as fontes dos caracteres de iene e won
1. Abra a folha de estilos GlobalReportStyles.css em um editor de texto.
A folha de estilos GlobalReportStyles.css está localizada no diretório local_c10\bin.
2. Ative uma das seções seguintes e modifique-a como mostrado abaixo:
● /* For Japanese: */
.pg,
.pp
{
font-family: 'MS UI Gothic', 'Andale WT J' , Tahoma, arial, geneva,
helvetica, sans-serif;
}
● /* For Korean: */
.pg,
.pp
{
font-family: Gulim, 'Andale WT K' , Tahoma, arial, geneva, helvetica,
sans-serif;
}
O gerador de PDF usa a primeira fonte disponível no servidor e inclui todos os caracteres na
string a ser exibida. Se preferir usar outras fontes em seu servidor, insira-as na lista.
3. Salve o arquivo GlobalReportStyles.css.
190 IBM Cognos Business Intelligence PowerPlay
Capítulo 8: Instalação e configuração de componentes opcionais
4. Reinicie o servidor IBM Cognos BI.
Todas as alterações feitas a folhas de estilo serão substituídas se o IBM Cognos BI for atualizado.
É necessário repetir este procedimento seguido de uma atualização.
Guia de instalação e configuração 191
Capítulo 8: Instalação e configuração de componentes opcionais
192 IBM Cognos Business Intelligence PowerPlay
Capítulo 8: Instalação e configuração de componentes opcionais
Capítulo 9: Configuração de componentes do IBMCognos para utilizar provedores de autenticação
Os componentes do IBM® Cognos® são executados em dois níveis de logon: anônimo e autenticado.
Por padrão, o acesso anônimo fica ativado.
É possível utilizar ambos os tipos de logon com sua instalação. Se escolher utilizar somente logon
autenticado, desative o acesso anônimo.
Para logon autenticado, configure os componentes do IBM Cognos com um namespace adequado
para o tipo de provedor de autenticação em seu ambiente. É possível configurar vários namespaces
para autenticação e, em seguida, escolha no tempo de execução qual namespace deseja utilizar.
Para obter mais informações, consulte o Guia de administração e segurança.
Os componentes do IBM Cognos são compatíveis com os seguintes tipos de servidores como fontes
de autenticação:
● Servidor Active Directory
● IBM Cognos Series 7
● Provedor de autenticação personalizado
● LDAP
● eTrust SiteMinder
● NTLM
● RACF
Se utilizar mais de um computador com Content Manager, configure provedores de autenticação
idênticos em cada local com o Content Manager. Isso significa que o tipo de provedor de autenticação
selecionado e a forma como foi configurado devem ser idênticos em todos os locais para todas as
plataformas. A configuração deve conter informações que sejam acessíveis a todos os Content
Managers.
Quando o IBM Cognos é instalado em um único computador com Linux® ou quando o Content
Manager é instalado em um computador com Linux, o IBM Cognos pode ser configurado para
usar apenas servidores de diretório em conformidade com LDAP V3 e provedores personalizados
como fontes de autenticação.
Alguns provedores de autenticação exigem que haja bibliotecas externas ao ambiente do IBM
Cognos disponíveis. Se essas bibliotecas não estiverem disponíveis no Linux, o provedor de
autenticação não poderá ser inicializado.
Se deseja configurar um dos seguintes como a origem de autenticação, é necessário instalar o Content
Manager em um computador sem o Linux:
● namespace IBM Cognos Series 7
Licensed Materials – Property of IBM193© Copyright IBM Corp. 2005, 2010.
● Servidor Active Directory
● NTLM
● eTrust SiteMinder
Se ativar a segurança, será preciso configurar definições de segurança imediatamente depois de
completar os processos de instalação e configuração. Para obter mais informações, consulte o Guia
de administração e segurança.
Importante: não desative a segurança depois de ativá-la. Se excluir um namespace, as preferências
de usuário, as entradas de Minhas Pastas e de Minhas Páginas serão permanentemente perdidas.
Configurações de permissão existentes farão referência a usuários, grupos ou papéis que não mais
existem. Embora isso não afete como as permissões funcionam, um usuário administrando as
configurações de permissão pode ver entradas "desconhecidas". Como essas entradas referem-se a
usuários, grupos e papéis que não mais existem, é possível excluí-las facilmente.
Depois de configurar um provedor de autenticação para os componentes do IBM Cognos, é possível
ativar o signon único entre o ambiente de provedor de autenticação e os componentes do IBM
Cognos. Isso significa que um usuário faz logon uma vez e pode, depois, trocar para um outro
aplicativo sem precisar fazer logon novamente.
Os usuários podem selecionar namespaces quando fazem logon no portal do IBM Cognos. É possível
ocultar namespaces JavaTM personalizados (p. 207 ) e namespaces eTrust SiteMinder (p. 226 ) dos
usuários.
Para utilizar um provedor de autenticação e para solicitar aos usuários que façam autenticação,
faça o seguinte:
❑ Desative o acesso anônimo, se necessário.
❑ Configure os componentes do IBM Cognos para utilizar provedores de autenticação.
Desativação do acesso anônimoPor padrão, os componentes do IBM® Cognos® não requerem autenticação de usuário. Os usuários
podem fazer logon anonimamente.
Se desejar utilizar apenas logon autenticado, poderá utilizar o IBM Cognos Configuration para
desativar o acesso anônimo.
Etapas
1. Em cada computador com o Content Manager instalado, inicie o IBM Cognos Configuration.
2. Na janela Explorer, em Segurança > Autenticação, clique em Cognos.
O recurso do IBM Cognos representa o namespace do IBM Cognos. Os namespaces Cognos
armazenam informações sobre grupos do IBM Cognos, como Usuário anônimo, contatos e
listas de distribuição, e referem-se a objetos em outros nomes de espaço de segurança. Para
obter mais informações, consulte o Guia de administração e segurança.
194 IBM Cognos Business Intelligence PowerPlay
Capítulo 9: Configuração de componentes do IBM Cognos para utilizar provedores de autenticação
3. Na janela Propriedades, clique na caixa próxima à propriedade Permitir acesso anônimo e
selecione Falso.
4. No menu Arquivo, clique em Salvar.
Agora é necessário configurar um namespace para que os usuários precisem fornecer credenciais
de logon quando acessarem recursos do IBM Cognos.
Restrição de acesso do usuário ao namespace CognosRestrinja o acesso a usuários que pertençam a qualquer grupo ou papel definido no namespace
interno do Cognos®. Por padrão, todos os usuários pertencem a vários grupos ou papéis internos.
Para restringir o acesso, faça o seguinte:
● Ative a propriedade para restringir acesso usando o IBM Cognos Configuration.
● Remova o grupo Todos das funções e grupos internos usando o IBM Cognos Administration.
● Garanta que usuários autorizados pertençam a pelo menos uma função ou grupo, usando o
IBM Cognos Administration.
Etapas
1. Em cada local com o Content Manager, inicie o IBM Cognos Configuration.
2. Na janela Explorer, em Segurança, clique emAutenticação.
3. Na janelaPropriedades, altere o valor de Restringir o acesso de membros ao namespace interno?
para Verdadeiro.
4. No menu Arquivo, clique em Salvar.
Utilize agora o portal para remover o grupo Todos das funções e grupos internos e, em seguida,
assegure que usuários autorizados pertençam a pelo menos um papel ou grupo interno.
Para obter informações sobre a adição ou remoção de membros de um grupo ou papel, consulte o
Guia de administração e segurança.
Configuração de componentes do IBM Cognos para uso doActive Directory Server
Se o Content Manager for instalado em um computador com sistema operacional Microsoft®
Windows®, será possível configurar o Active Directory como fonte de autenticação usando um
namespace do Active Directory.
Se instalar o Content Manager em um computador com UNIX®, será necessário usar um namespace
LDAP para configurar o Active Directory como sua fonte de autenticação. Se instalar o Content
Manager em computadores com Windows e UNIX, será preciso utilizar um namespace de LDAP
para configurar o Active Directory em todos os Content Manager. Ao utilizar o namespace de
LDAP para autenticar em relação ao Servidor do Active Directory, ficará limitado somente aos
Guia de instalação e configuração 195
Capítulo 9: Configuração de componentes do IBM Cognos para utilizar provedores de autenticação
recursos do LDAP. Não haverá acesso aos recursos do Active Directory como as propriedades
avançadas para domínios (p. 199 ) e signon único utilizando delegação Kerberos (p. 200 ).
Se instalar o Content Manager em um computador com Linux®, aplicam-se as mesmas restrições
usadas no computador com UNIX. É preciso utilizar um namespace do LDAP para configurar o
Active Directory como origem de autenticação.
Para obter mais informações, consulte "Configuração de namespaces LDAP para o servidor do
Active Directory" (p. 210 ).
Se pretende utilizar o Microsoft SQL Server ou Microsoft Analysis Server como origem e dados e
utilizar o signon único para autenticação, será preciso utilizar o Active Directory como origem de
autenticação.
Não é possível conectar ao Catálogo global do Active Directory, que é um servidor de cache para
o Servidor do Active Directory. Se a conexão utiliza a porta 3268, será preciso alterá-la. Por padrão,
o Servidor do Active Directory utiliza a porta 389.
Para utilizar namespaces do Servidor do Active Directory e configurar signon único, faça o seguinte:
❑ Configure os componentes do IBM® Cognos® para usar um namespace do Active Directory
Server
❑ Ative a comunicação segura para o servidor do Active Directory, se necessário.
❑ Ative o signon único entre o Servidor do Active Directory e os componentes do IBM Cognos
Configurar namespaces do Active DirectoryÉ possível utilizar o Servidor do Active Directory como seu provedor de autenticação.
Também é possível criar propriedades de usuário personalizadas do Active Directory Server disponível
para componentes do IBM® Cognos®.
Para o IBM Cognos funcionar corretamente com o Active Directory Server, verifique se o grupo de
usuários autenticados possui privilégios de leitura para a pasta Active Directory, em que os usuários
estão armazenados.
Se estiver configurando um namespace do Active Directory para suportar signon único com a fonte
de dados do Microsoft® SQL Server ou do Microsoft Analysis Server, a configuração a seguir será
necessária:
● O gateway do IBM Cognos está instalado em um servidor web IIS configurado para a
autenticação integrada do sistema operacional Microsoft Windows®.
● O gateway deve ser atribuído para o site da intranet local no navegador web.
● O Content Manager é instalado em um servidor Windows 2000 ou Windows 2003.
● O Content Manager, Application Tier Components, servidor IIS Web e o servidor de fonte de
dados (Microsoft SQL Server ou Microsoft Analysis Server) devem pertencer ao domínio do
Active Directory.
● A conexão de fonte de dados para o Microsoft SQL Server é configurada como Namespaces
externos e tal namespace deve ser o do Active Directory.
196 IBM Cognos Business Intelligence PowerPlay
Capítulo 9: Configuração de componentes do IBM Cognos para utilizar provedores de autenticação
Para obter mais informações sobre as fontes de dados, consulte oGuia de administração e segurança.
Etapas
1. Em cada local onde o Content Manager foi instalado, abra o IBM Cognos Configuration.
2. Na janela Explorer, em Segurança, clique com o botão direito em Autenticação e clique em
Novo recurso > Namespace.
3. Na caixa Nome, digite um nome para o namespace de autenticação.
4. Na lista Tipo, clique no namespace apropriado e clique em OK.
O novo recurso provedor de autenticação aparece na janela Explorer, no componente
Autenticação.
5. Na janela Propriedades, na propriedade ID do namespace, especifique um identificador exclusivo
para o namespace.
6. Especifique os valores para todas as outras propriedades solicitadas para garantir que os
componentes do IBM Cognos possam localizar e utilizar o provedor de autenticação existente.
7. Especifique os valores para a propriedade Host e porta.
Para suportar o failover do Servidor do Active Directory, é possível especificar o nome do
domínio em vez de um controlador de domínio específico. Por exemplo, utilize
mydomain.com:389 em vez de dc1.mydomain.com:389.
8. Se desejar pesquisar detalhes quando a autenticação falhar, especifique a ID e senha do usuário
para a propriedade Credenciais de vinculação.
Utilize as credenciais de um usuário do Servidor do Active Directory que tenha privilégios de
busca e leitura para esse servidor.
9. No menu Arquivo, clique em Salvar.
10. Teste a conexão em um novo namespace. Na janela Explorer, em Autenticação, clique com o
botão direito no novo recurso de autenticação e clique em Testar.
O IBM Cognos carrega, inicializa e configura as bibliotecas do provedor para o namespace.
Disponibilização das propriedades personalizadas de usuário do Active Directorypara os componentes do IBM Cognos
É possível usar atributos arbitrários de usuário do Active Directory Server nos componentes do
IBM® Cognos®. Para tal configuração, é preciso adicionar esses atributos como propriedades
personalizadas para o namespace do Active Directory.
As propriedades personalizadas estão disponíveis como parâmetros de sessão no Framework
Manager. Para obter mais informações sobre parâmetros de sessão, consulte o Framework Manager
User Guide.
Utilize também as propriedades personalizadas dentro dos blocos de comando para configurar
sessões e conexões do Oracle. Utilize blocos de comando com conexões leves do Oracle e bancos
Guia de instalação e configuração 197
Capítulo 9: Configuração de componentes do IBM Cognos para utilizar provedores de autenticação
de dados privados virtuais. Para obter mais informações, consulte o Guia de administração e
segurança.
Etapas
1. Em cada local onde o Content Manager foi instalado, abra o IBM Cognos Configuration.
2. Na janela Explorer, em Segurança > Autenticação, clique no namespace do Active Directory.
3. Na janela Propriedades, clique na coluna Valor para Propriedades personalizadas e clique no
botão de edição.
4. Na janela Valor - Propriedades personalizadas, clique em Adicionar.
5. Clique na coluna Nome e digite o nome que deseja que os componentes do IBM Cognos utilizem
para o parâmetro da sessão.
6. Clique na coluna Valor e digite o nome do parâmetro de conta no servidor do Active Directory.
7. Repita as etapas de 4 a 6 para cada coluna personalizada.
8. Clique em OK.
9. No menu Arquivo, clique em Salvar.
Ativação da comunicação segura para o Servidor do Active DirectorySe estiver utilizando uma conexão SSL para o Servidor do Active Directory, será preciso copiar o
certificado do Servidor do Active Directory ao local com o Content Manager.
Etapas
1. Em cada computador com Content Manager, utilize o navegador web para conectar ao Servidor
do Active Directory e copie o certificado raiz da CA para um local com o Content Manager.
2. Adicione o certificado raiz da CA ao armazenamento de certificados da conta utilizada para a
sessão atual do IBM® Cognos®:
● Se estiver executando a sessão do IBM Cognos sob uma conta de usuário, utilize o mesmo
navegador web que foi utilizado na etapa 1 para importar o certificado raiz da CA para o
armazenamento de certificados da conta de usuário.
Para obter informações, consulte a documentação de seu navegador web.
● Se estiver executando a sessão do IBM Cognos na conta local, use o Microsoft® Management
Console (MMC) para importar o certificado raiz para o armazenamento de certificados
do computador local.
Para obter mais informações, consulte a documentação do MMC.
3. No IBM Cognos Configuration, reinicie o serviço:
● Na janela Explorer, clique em Serviço do IBM Cognos, IBM Cognos.
● No menu Ações, clique em Reiniciar.
198 IBM Cognos Business Intelligence PowerPlay
Capítulo 9: Configuração de componentes do IBM Cognos para utilizar provedores de autenticação
Inclusão ou exclusão de domínios utilizando Propriedades avançadasQuando um namespace de autenticação é configurado para o IBM® Cognos®, os usuários de apenas
um domínio podem fazer login. Utilizando as propriedades avançadas para o Active Directory
Server, os usuários de domínios relacionados (pai-filho) e árvores de domínio não relacionadas
dentro da mesma floresta também podem fazer login.
Autenticação em uma árvore de domínio
Se definir um parâmetro chamado chaseReferrals como verdadeiro, os usuários no domínio original
autenticado e todos os domínios filho da árvore de domínio poderão fazer login no IBM Cognos.
Os usuários acima do domínio autenticado original ou em uma árvore de domínio diferente não
podem fazer login.
Autenticação em todas as árvores de domínio na floresta
Se definir um parâmetro chamado MultiDomainTrees como verdadeiro, os usuários em todas as
árvores de domínio na floresta poderão fazer login no IBM Cognos.
Etapas
1. Em cada local onde o Content Manager foi instalado, abra o IBM Cognos Configuration.
2. Na janela Explorer, em Segurança > Autenticação, clique no namespace do Active Directory.
3. Na janela Propriedades, especifique a propriedade Host e porta:
● Para usuários em um domínio, especifique o host e a porta de um controlador de domínio
para o domínio único.
● Para usuários em uma árvore de domínio, especifique o host e a porta do controlador de
nível superior para a árvore de domínio.
● Para usuários em todas as árvores de domínio na floresta, especifique o host e a porta de
qualquer controlador de domínio na floresta.
4. Clique na coluna Valor para Propriedades avançadas e clique no botão de edição.
5. Na janela Valor - Propriedades avançadas, clique em Adicionar.
6. Especifique duas novas propriedades, chaseReferrals e MultiDomainTrees, com os valores da
tabela a seguir:
MultiDomainTreeschaseReferralsAutenticação para
FalsoFalsoUm domínio
FalsoVerdadeiroUma árvore de domínio
VerdadeiroVerdadeiroTodas as árvores de domínio na floresta
7. Clique em OK.
Guia de instalação e configuração 199
Capítulo 9: Configuração de componentes do IBM Cognos para utilizar provedores de autenticação
8. No menu Arquivo, clique em Salvar.
Ativação do signon único entre o Active Directory Server e os componentes doIBM Cognos
Por padrão, o provedor do Active Directory usa delegação Kerberos e integra-se com o servidor
web IIS para usar o signon único se a autenticação integrada (anteriormente chamada NT Challenge
Response) do sistema operacional Microsoft® Windows® for ativada no servidor web IIS.
Se a autenticação integrada do Windows estiver ativada, não será solicitada a reinserção das
informações de autenticação ao acessar o conteúdo do IBM® Cognos® que é protegido pelo
namespace do Active Directory.
Se não quiser delegação Kerberos, o provedor pode ser configurado para acessar o ambiente variável
REMOTE_USER para alcançar o signon único. É preciso definir a propriedade avançada
singleSignOnOption para o valor IdentityMapping. É preciso também especificar credenciais cegas
para o namespace do Active Directory. O Microsoft IIS define o REMOTE_USER por padrão
quando a autenticação integrada do Windows é ativada. Se a autenticação Kerberos for ignorada,
o signon único para as fontes de dados Microsoft OLAP (MSAS) não será possível.
Etapas para o signon único utilizando a delegação Kerberos
1. Configure a autenticação integrada do Windows no servidor web IIS.
2. Instale o Content Manager em um local que faça parte do domínio, considerando os Content
Manager ativos e em espera.
3. Configure os computadores ou a conta de usuário que o Content Manager executa para serem
confiados para delegação.
Ao configurar os computadores utilizando a ferramenta de usuário do Active Directory, não
selecione o atributo Conta, que é sensível e não pode ser delegado.
Etapas para o signon único utilizando o REMOTE_USER
1. Em cada local onde o Content Manager foi instalado, abra o IBM Cognos Configuration.
2. Na janela Explorer, em Segurança > Autenticação, clique no namespace do Active Directory.
3. Clique na coluna Valor para Propriedades avançadas e clique no botão de edição.
4. Na caixa de diálogo Valor - Propriedades avançadas, clique em Adicionar.
5. Na coluna Nome, digite singleSignOnOption
6. Na coluna Valor, digite IdentityMapping.
7. Clique em OK.
8. Clique na coluna Valor para Credenciais de vinculação e clique no botão Editar.
9. Na caixa de diálogo Valor - Credenciais de vinculação, especifique uma ID do usuário e senha
e, em seguida, clique em OK.
200 IBM Cognos Business Intelligence PowerPlay
Capítulo 9: Configuração de componentes do IBM Cognos para utilizar provedores de autenticação
O provedor do Active Directory utiliza agora o REMOTE_USER para signon único.
Dica: Para voltar para a delegação Kerberos, edite Propriedades avançadas e, na coluna Valor,
digite KerberosAuthentication.
Configuração do IBMCognos para utilizar o namespace do IBMCognos Series 7
É possível configurar os componentes do IBM® Cognos® para usar um namespace do IBM Cognos
Series 7 como provedor de autenticação. Os usuários serão autenticados com base na configuração
de autenticação e signon do namespace do IBM Cognos Series 7.
Será necessário um namespace do IBM Cognos Series 7 para usar os PowerCubes do IBM Cognos
Series 7 e os modelos do Transformer no IBM Cognos Business Intelligence. O namespace deve
estar configurado antes de carregar os modelos do Transformer.
Se planejar executar os produtos IBM Cognos BI em um servidor de aplicativos de 64 bits, não será
possível configurar um namespace do IBM Cognos Series 7 como sua fonte de autenticação.
Se deseja configurar um namespace do IBM Cognos Series 7 como fonte de autenticação, será
preciso instalar o Content Manager em um computador que suporte o IBM Cognos Series 7.
Observação: não é possível utilizar um arquivo IBM Cognos Series 7 Local Authentication Export
(LAE) para autenticar usando os componentes do IBM Cognos.
É possível configurar os componentes do IBM Cognos para utilizar diversos provedores de
autenticação do IBM Cognos Series 7. Todos os namespaces do IBM Cognos Series 7 devem utilizar
o mesmo IBM Cognos Series 7 Ticket Server primário. Do contrário, podem ser recebidos erros ou
avisos de autenticação mais de uma vez. Para manter o desempenho, verifique também se o Ticket
Server está em execução.
Caso altere as informações de configuração armazenadas no servidor de diretório utilizado pelo
IBM Cognos Series 7, será necessário reiniciar o serviço do IBM Cognos antes que as alterações
entrem em vigor na instalação do IBM Cognos.
Um usuário deve estar em pelo menos uma classe de usuário Access Manager para fazer login nos
componentes do IBM Cognos.
Para utilizar namespaces do IBM Cognos Series 7 e configurar signon único, faça o seguinte:
❑ Configure o IBM Cognos para utilizar o namespace do IBM Cognos Series 7
❑ Ative a comunicação segura no servidor de diretórios utilizados pelo namespace do IBM Cognos
Series 7, se necessário
❑ Ative o signon único entre o IBM Cognos Series 7 e o IBM Cognos
Guia de instalação e configuração 201
Capítulo 9: Configuração de componentes do IBM Cognos para utilizar provedores de autenticação
Configuração de namespaces do IBM Cognos Series 7É possível configurar o IBM® Cognos® para utilizar um ou mais namespaces do IBM Cognos Series 7
para autenticação.
Etapas
1. Em cada local onde o Content Manager foi instalado, abra o IBM Cognos Configuration.
2. Na janela Explorer, em Segurança, clique com o botão direito em Autenticação e clique em
Novo recurso > Namespace.
3. Na caixa Nome, digite um nome para o namespace de autenticação.
4. Na lista Tipo, clique no namespace apropriado e clique em OK.
O novo recurso provedor de autenticação aparece na janela Explorer, no componente
Autenticação.
5. Na janela Propriedades, na propriedade ID do namespace, especifique um identificador exclusivo
para o namespace.
6. Especifique os valores para todas as outras propriedades solicitadas para garantir que os
componentes do IBM Cognos possam localizar e utilizar o provedor de autenticação existente.
Se a versão do namespace do IBM Cognos Series 7 for 16.0, verifique se a propriedade
Codificação de dados está definida comoUTF-8. Além disso, os locais onde o Content Manager
está instalado deverão usar a mesma localidade que os dados no namespace do IBM Cognos
Series 7.
O valor do host pode ser um nome de servidor ou um endereço IP. Se estiver publicando do
PowerPlay® Enterprise Server para IBM Cognos BI, utilize o mesmo formato de valor utilizado
no IBM Cognos Series 7 Configuration Manager para a localização do servidor de diretórios.
Por exemplo, se o nome do servidor for utilizado no IBM Cognos Series 7 Configuration
Manager, deve-se utilizar também o nome do servidor no IBM Cognos Configuration para o
IBM Cognos BI.
7. Se o ambiente do namespace inclui a versão 15.2 do namespace do IBM Cognos Series 7,
desative a configuração Series7NamespacesAreUnicode.
● Na janela Propriedades, no valor Propriedades avançadas, clique no botão de edição.
● Na janela Valor - Propriedades avançadas, clique em Adicionar.
● Na caixa Nome, digite Series7NamespacesAreUnicode.
● Na caixa Valor, digite Falso e depois clique em OK.
8. Na janela Propriedades, verifique se as propriedades Configurações de cookie, certifique-se de
que Caminho, Domínio e Sinalizador de segurança habilitado correspondem às configurações
definidas para o IBM Cognos 7.
9. No menu Arquivo, clique em Salvar.
202 IBM Cognos Business Intelligence PowerPlay
Capítulo 9: Configuração de componentes do IBM Cognos para utilizar provedores de autenticação
10. Teste a conexão em um novo namespace. Na janela Explorer, em Autenticação, clique com o
botão direito no novo recurso de autenticação e clique em Testar.
Ativação da comunicação segura para o servidor de diretório utilizado pelonamespace do IBM Cognos Series 7
Se estiver usando uma conexão SSL ao servidor de diretório utilizado pelo namespace do IBM®
Cognos® Series 7, será necessário copiar o certificado do servidor de diretório para cada local com
o Content Manager.
Para obter mais informações, consulte o IBM Cognos Access Manager Administrator Guide e a
documentação do servidor de diretório.
Ativação do signon único entre o IBM Cognos Series 7 e o IBM CognosSe o namespace do IBM® Cognos® Series 7 foi configurado para integração com os mecanismos de
autenticação externa para signon único, o provedor do IBM Cognos Series 7 irá usar essa
configuração automaticamente.
Por meio da configuração do signon único, não é solicitada a reinserção das informações de
autenticação ao acessar o conteúdo do IBM Cognos que está protegido pelo namespace do IBM
Cognos Series 7.
Etapas
1. Verifique se os componentes do IBM Cognos foram configurados para utilizar um namespace
do IBM Cognos Series 7 como provedor de autenticação (p. 201 ).
2. Para o IBM Cognos Series 7, inicie o Configuration Manager.
3. Clique em Abrir as configurações atuais.
4. Na guia Componentes, na janela Explorer, expandaServiços, Access Manager - Web
Authentication e clique em Configurações de cookie.
5. Na janela Propriedades, verifique se as propriedades Caminho, Domínio e Sinalizador de
segurança habilitado correspondem às configurações definidas para o IBM Cognos.
6. Salve e feche o Configuration Manager.
7. Se o namespace do IBM Cognos Series 7 utiliza o plug-in de signon confiável para signon único,
é preciso agora definir a função SaferAPIGetTrustedSignonWithEnv.
É possível agora adicionar o IBM Cognos Upfront Series 7 NewsBoxes às páginas de portal do IBM
Cognos Connection.
Namespaces do IBMCognos Series 7 e plug-in de signon confiável do IBMCognosSeries 7
Se o namespace do IBM® Cognos® Series 7 usa o plugin Trusted Signon, é preciso definir a função
SaferAPIGetTrustedSignonWithEnv no plugin. Em seguida, é necessário recompilar e reimplantar
Guia de instalação e configuração 203
Capítulo 9: Configuração de componentes do IBM Cognos para utilizar provedores de autenticação
a biblioteca para obter o signon único entre os componentes do IBM Cognos e o mecanismo de
autenticação.
A função SaferAPIGetTrustedSignonWithEnv é uma versão atualizada da função
SaferAPIGetTrustedSignon. Essa atualização é necessária porque o logon do IBM Cognos não é
feito no servidor Web como é o caso dos aplicativos do IBM Cognos Series 7. Portanto, não é
possível para o plug-in fazer uma chamada getenv() API para recuperar variáveis de ambiente do
servidor web. O plug-in pode solicitar que variáveis de ambiente específicas sejam removidas do
servidor web utilizando a função SaferAPIGetTrustedSignonWithEnv.
Se estiver executando produtos IBM Cognos Series 7 e IBM Cognos utilizando o mesmo plugin,
ambas as funções SaferAPIGetTrustedSignonWithEnv e SaferAPIGetTrustedSignon serão necessárias.
Para obter mais informações sobre a função SaferAPIGetTrustedSignon, consulte a documentação
do IBM Cognos Series 7.
Função SaferAPIGetTrustedSignonWithEnv
Para que os usuários sejam autenticados com sucesso pelo Access Manager, os signons de OS devem
existir e estar ativados no namespace atual.
A memória para o trustedSignonName e trustedDomainName retornados está alocada internamente
nesta API. Se a função retorna SAFER_SUCCESS, o Access Manager chama o
SaferAPIFreeTrustedSignon para liberar a memória alocada.
A memória para o reqEnvVarList retornado está alocada internamente nesta API. Se a função
retorna SAFER_INFO_REQUIRED, o Access Manager chama o SaferAPIFreeBuffer() para liberar
a memória alocada.
Implemente tanto a função SaferAPIGetTrustedSignon como a SaferAPIFreeBuffer para registrar
com sucesso a biblioteca quando o SaferAPIGetTrustedSignonWithEnv for implementada. A função
SaferAPIGetError é necessária apenas se quiser especificar mensagens de erros retornadas do plug-in.
SintaxeSaferAPIGetTrustedSignonWithEnv(
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]*/
204 IBM Cognos Business Intelligence PowerPlay
Capítulo 9: Configuração de componentes do IBM Cognos para utilizar provedores de autenticação
Parâmetros para a função SaferAPIGetTrustedSignonWithEnv
DescriçãoParâmetro
Um array de nomes de variáveis de ambiente e valores que são recuperados do
servidor web. O final do array é representado por uma entrada com envVar
Name e envVarValue nulos. Observe que na primeira vez que a API é chamada,
o array envVAR contém apenas o fim do marcador do array.
[in] envVar
Uma string contém uma lista separada por vírgulas dos nomes de variáveis do
ambiente que são solicitadas pela implementação Safer. O fim da lista deve ser
não terminado.
[in] reqEnvVarList
Uma seqüência de bytes que identifica o usuário atualmente autenticado. Este
valor não precisa ser terminado nulo. Este valor é obrigatório.
[out] trustedSignonName
Um valor inteiro que indica o comprimento de trustedSignonName. Este
comprimento deve ser excluído do terminador nulo, se houver. Este valor é
obrigatório.
[out] trustedSignonNameLength
Uma seqüência de bytes que identifica o domínio do usuário atualmente
autenticado. Não é necessário terminar esse valor nulo. Se não houver trusted
DomainName, o retorno será nulo. Este valor é opcional.
[out] trustedDomainName
Um valor inteiro que indica o comprimento de trustedDomainName. Este
comprimento deve ser excluído do terminador nulo, se houver. Este valor é
obrigatório e deve ser definido como zero se não houver trustedDomainName.
[out] trustedDomainNameLength
Um valor que indica o tipo de usuário que o Access Manager autenticará. Este
valor é obrigatório.
[out] userType
Os valores de retorno a seguir são necessários para o Access Manager autenticar
usuários com sucesso:
SAFER_NORMAL_USER
Um usuário nomeado. Os signons de OS devem existir e estar ativados no
namespace atual.
SAFER_GUEST_USER
Um usuário convidado. Uma conta de usuário convidado deve existir e estar
ativada no namespace atual.
SAFER_ANONYMOUS_USER
Um usuário anônimo. Uma conta de usuário anônimo deve existir e estar ativada
no namespace atual.
Guia de instalação e configuração 205
Capítulo 9: Configuração de componentes do IBM Cognos para utilizar provedores de autenticação
DescriçãoParâmetro
Um ponteiro utilizado para preservar dados específicos da implementação entre
invocações. Uma invocação ocorre sempre que o Access Manager chama o plug-
in de signon confiável. Esse valor é válido apenas se o plug-in de signon confiável
foi invocado e um valor foi definido para ele.
[in/out] implementerData
Configuração do IBM Cognos para utilizar provedores deautenticação personalizada
Se um provedor de autenticação personalizada JavaTM tiver sido implantado na estrutura de segurança
existente, será possível configurar os componentes do IBM® Cognos® para utilizá-lo.
É possível utilizar um provedor de autenticação personalizada para acessar e autenticar usuários
em uma fonte de autenticação alternativa. Também é possível utilizá-lo como um mecanismo de
signon único para integrar componentes do IBM Cognos com a infraestrutura de segurança. É
possível ocultar namespaces de usuários durante o logon.
Para obter mais informações, consulte o Custom Authentication Provider Developer Guide.
Configuração de namespaces de autenticação personalizadaÉ possível configurar os componentes do IBM® Cognos® para utilizar um namespace de autenticação
personalizado. Qualquer configuração adicional para acesso a fonte de autenticação, signon único
ou atributos personalizados dependem da implementação do provedor de autenticação personalizada.
Verifique se as versões do JavaTM runtime environment (JRE) e Java Software Development Kit
utilizadas são compatíveis. Se não forem usadas versões compatíveis entre si do JRE e Java Software
Development Kit, o provedor de autenticação Java personalizado configurado não será exibido na
lista de namespaces do IBM Cognos Configuration.
Etapas
1. Abra o IBM Cognos Configuration em todos os locais que tiverem o Content Manager instalado.
2. Na janela Explorer, em Segurança, clique com o botão direito em Autenticação e clique em
Novo recurso > Namespace.
3. Na caixa Nome, digite um nome para o namespace de autenticação.
4. Na lista Tipo, selecione Provedor Java personalizado e clique em OK.
O novo recurso provedor de autenticação aparece na janela Explorer, no componente
Autenticação.
5. Na janela Propriedades, na propriedade ID doNamespace, especifique um identificador exclusivo
para o namespace.
Dica: Não use dois pontos (:) na propriedade ID do namespace.
206 IBM Cognos Business Intelligence PowerPlay
Capítulo 9: Configuração de componentes do IBM Cognos para utilizar provedores de autenticação
6. Especifique os valores para todas as outras propriedades necessárias para garantir que os
componentes do IBM Cognos possam localizar e utilizar o provedor de autenticação existente.
7. No menu Arquivo, clique em Salvar.
8. Teste a conexão em um novo namespace. Na janela Explorer, em Autenticação, clique com o
botão direito no novo recurso de autenticação e clique em Testar.
O IBM Cognos carrega, inicializa e configura as bibliotecas do provedor para o namespace.
Ocultação do namespace dos usuários durante o loginÉ possível ocultar namespaces de usuários durante o login. É possível ter namespaces de signon
confiável sem exibi-los na lista de seleção de namespace que é apresentada aos usuários durante o
login.
Por exemplo, caso deseje integrar um signon único em todos os sistemas, mas desejar manter a
capacidade de autenticação direta dos clientes no IBM® Cognos® sem que sejam solicitados a escolher
um namespace.
Etapas
1. Em cada local em que um provedor de autenticação personalizado JavaTM foi configurado, abra
o IBM Cognos Configuration.
2. Na janela Explorer, em Segurança > Autenticação, clique no provedor de autenticação Java
personalizado.
3. Na janela Propriedades, clique na caixa próxima a Selecionável para autenticação e selecione
Falso.
4. No menu Arquivo, clique em Salvar.
O namespace não é mostrado na lista de seleção apresentada no login.
Configuração de componentes do IBM Cognos para utilizarLDAP
É possível configurar os componentes do IBM® Cognos® para usar um namespace LDAP como
provedor de autenticação. É possível usar um namespace LDAP para usuários armazenados em um
diretório de usuário LDAP, Active Directory Server, IBM Directory Server, Novell Directory Server
ou Sun JavaTM System Directory Server.
Também é possível utilizar a autenticação LDAP com as fontes de dados DB2® e Essbase OLAP
especificando o namespace LDAP ao se configurar a conexão com a fonte de dados. Para obter
mais informações, consulte o Guia de administração e segurança.
Também é possível criar propriedades de usuário personalizadas do namespace LDAP disponível
para componentes do IBM Cognos.
Caso queira vincular os usuários ao servidor LDAP, consulte "Mapeamento LDAP" (p. 208 ).
Para utilizar um namespace LDAP e configurar signon único, faça o seguinte:
Guia de instalação e configuração 207
Capítulo 9: Configuração de componentes do IBM Cognos para utilizar provedores de autenticação
❑ Configure os componentes do IBM Cognos para utilizar namespaces LDAP
❑ Disponibilize as propriedades de usuário personalizadas para componentes do IBM Cognos,
caso necessário
❑ Ative a comunicação segura para o servidor LDAP, se necessário.
❑ Ative o signon único entre o LDAP e os componentes do IBM Cognos, caso necessário
Mapeamento LDAPPara vincular um usuário ao servidor LDAP, o provedor de autenticação do LDAP deve construir
o nome distinto (DN). Se a propriedade Utilizar identidade externa estiver definida como Verdadeira,
usará a propriedade Mapeamento de identidade externa para tentar resolver o DN do usuário. Se
não puder encontrar a variável do ambiente ou o DN no servidor LDAP, tentará utilizar a
propriedade Pesquisa de usuário para construir o DN.
Se os usuários estão hierarquicamente armazenados dentro do servidor de diretório, será possível
configurar as propriedades Pesquisa de usuário e Mapeamento de identidade externa para utilizar
filtros de busca. Quando o provedor de autenticação do LDAP faz as pesquisas, ele utiliza os filtros
especificados nas propriedades Pesquisa de usuário e Mapeamento de identidade externa. Também
vincula ao servidor de diretório utilizando o valor especificado na propriedade Vincular DN do
usuário e senha ou utilizando anônimo se nenhum valor for especificado.
Quando um namespace LDAP foi configurado para utilizar a propriedade Mapeamento de identidade
externa para autenticação, o provedor de LDAP vincula ao servidor de diretório utilizando Vincular
DN do usuário e senha ou utilizando anônimo se nenhum valor é especificado. Todos os usuários
que efetuaram logon no IBM Cognos por meio de mapeamento de identidade externa veem os
mesmos usuários, grupos e pastas que o usuário vinculado.
Se não utilizar o mapeamento de identidade externa, será possível especificar se serão utilizadas
credenciais para pesquisar o servidor de diretório LDAP configurando a propriedadeUsar credenciais
de vinculação para a busca. Quando a propriedade é ativada, as buscas são feitas utilizando as
credenciais de usuário ou utilizando anônimo se nenhum valor for especificado. Quando a
propriedade está desativada, que é a configuração padrão, as buscas são feitas utilizando as
credenciais do usuário logado. O benefício de utilizar credenciais vinculadas é que em vez de alterar
direitos administrativos para vários usuários, é possível alterar os direitos administrativos somente
para o usuário vinculado.
Observe que, se utilizar uma sintaxe de DN, como uid=${userID}, ou=minhaempresa.com, para as
propriedades Pesquisa de usuário, Mapeamento de identidade externa, ou Vincular DN do usuário
e senha,, será preciso evitar todos os caracteres especiais utilizados no DN. Se utilizar uma sintaxe
de busca, como (uid=${userID}), para as propriedades Pesquisa de usuário ou Mapeamento de
identidade externa, não evite caracteres especiais usados no DN.
Configuração de namespaces LDAPÉ possível configurar os componentes do IBM® Cognos® para utilizar um namespace LDAP quando
os usuários estão armazenados em um diretório de usuário namespace LDAP. O diretório de usuário
208 IBM Cognos Business Intelligence PowerPlay
Capítulo 9: Configuração de componentes do IBM Cognos para utilizar provedores de autenticação
de LDAP deve ser acessado de outro ambiente de servidor, como o Servidor do Active Directory
ou eTrust SiteMinder.
Se estiver configurando um namespace LDAP para um servidor de diretório diferente do LDAP,
consulte a seção adequada:
● Para o Servidor do Active Directory, consulte Configuração de namespaces LDAP para o
servidor do Active Directory.
● Para o IBM Directory Server, consulte Configuração de namespaces LDAP para IBM Directory
Server.
● Para o Novell Directory Server, consulte Configuração de namespaces LDAP para Novell
Directory Server.
● Para Sun JavaTM System Directory Server, consulte Configuração de namespaces LDAP para
Sun Java System Directory Server.
Também é possível utilizar a autenticação LDAP com as fontes de dados DB2® e Essbase OLAP
especificando o namespace LDAP ao se configurar a conexão com a fonte de dados. Para obter
mais informações, consulte o Guia de administração e segurança.
Etapas
1. Em cada local onde o Content Manager foi instalado, abra o IBM Cognos Configuration.
2. Na janela Explorer, em Segurança, clique com o botão direito em Autenticação e clique em
Novo recurso > Namespace.
3. Na caixa Nome, digite um nome para o namespace de autenticação.
4. Na lista Tipo, clique no namespace apropriado e clique em OK.
O novo recurso provedor de autenticação aparece na janela Explorer, no componente
Autenticação.
5. Na janela Propriedades, na propriedade ID do namespace, especifique um identificador exclusivo
para o namespace.
6. Especifique os valores para todas as outras propriedades solicitadas para garantir que os
componentes do IBM Cognos possam localizar e utilizar o provedor de autenticação existente.
7. Se desejar que o provedor de autenticação LDAP se vincule a um servidor de diretório utilizando
um Vincular DN do usuário e senha determinado ao pesquisar, especifique esses valores.
Se não houver valores especificados, o provedor de autenticação LDAP vincula como anônimo.
Se o mapeamento de identidade externa estiver ativado, Vincular DN do usuário e senha é
utilizado para todos os acessos LDAP. Se o mapeamento de identidade externa não estiver
ativado, Vincular DN do usuário e senha são usados apenas quando um filtro de pesquisa for
especificado para a propriedade Pesquisa de usuário. Nesse caso, quando o DN é estabelecido,
solicitações posteriores ao servidor LDAP são executadas sob o contexto de autenticação do
usuário final.
Guia de instalação e configuração 209
Capítulo 9: Configuração de componentes do IBM Cognos para utilizar provedores de autenticação
8. Se não usar mapeamento de identidade externa, use credenciais de vinculação para buscar o
servidor de diretório LDAP executando o seguinte:
● Certifique-se de que Utilizar identidade externa esteja definido como Falso.
● Defina Usar credenciais de vinculação para buscar como Verdadeiro.
● Especifique a ID e a senha do usuário para Vincular DN do usuário e senha.
Se não forem especificadas uma ID do usuário e senha, um acesso anônimo será ativado e a
busca será feita utilizando anônimo.
9. Verifique as configurações do mapeamento para objetos e atributos obrigatórios.
Dependendo da configuração do LDAP, pode ser necessário alterar alguns valores padrão para
garantir a comunicação bem-sucedida entre os componentes do IBM Cognos e o servidor LDAP.
Os atributos LDAP mapeados para a propriedade Nome em Mapeamento de pastas,
Mapeamentos de grupos e Mapeamentos de contas devem estar acessíveis a todos os usuários
autenticados. Além disso, a propriedade Nome não pode ficar em branco.
10. No menu Arquivo, clique em Salvar.
11. Teste a conexão em um novo namespace. Na janela Explorer, em Autenticação, clique com o
botão direito no novo recurso de autenticação e clique em Testar.
O IBM Cognos carrega, inicializa e configura as bibliotecas do provedor para o namespace.
Configuração de namespaces LDAP para o servidor do Active DirectorySe configurar um novo namespace LDAP para uso com um Servidor do Active Directory, será
preciso modificar as configurações e alterar os valores para todas as propriedades dos objetos do
Active Directory.
Etapas
1. Em todos os locais que tiverem o Content Manager instalado, abra o IBM® Cognos®
Configuration.
2. Na janela Explorer, em Segurança, clique com o botão direito em Autenticação e clique em
Novo recurso > Namespace.
3. Na caixa Nome, digite um nome para o namespace de autenticação.
4. Na lista Tipo, clique no namespace apropriado e clique em OK.
O novo recurso provedor de autenticação aparece na janela Explorer, no componente
Autenticação.
5. Na janela Propriedades, na propriedade ID doNamespace, especifique um identificador exclusivo
para o namespace.
Dica: Não use dois pontos (:) na propriedade ID do namespace.
6. Especifique os valores para todas as outras propriedades solicitadas para garantir que os
componentes do IBM Cognos possam localizar e utilizar o provedor de autenticação existente.
210 IBM Cognos Business Intelligence PowerPlay
Capítulo 9: Configuração de componentes do IBM Cognos para utilizar provedores de autenticação
As configurações seguintes são exemplos:
● Em Pesquisa de usuário, especifique (sAMAccountName=${userID})
● Caso utilize um único signon, em Utilizar identidade externa defina o valor como
Verdadeiro.
● Se utilizar signon único, em Mapeamento de identidade externa, especifique
(sAMAccountName=${environment("REMOTE_USER")})
Se deseja remover o nome do domínio da variável REMOTE_USER, especifique
(sAMAccountName=${replace(${environment("REMOTE_USER")}, "domain\\","")}).
● Para Vincular DN do usuário e senha, especifique usuário@domínio
● Para Identificador exclusivo, especifique objectGUID
7. Se desejar que o provedor de autenticação LDAP se vincule a um servidor de diretório utilizando
um Vincular DN do usuário e senha determinado ao pesquisar, especifique esses valores.
Se não houver valores especificados, o provedor de autenticação LDAP vincula como anônimo.
8. Se não usar mapeamento de identidade externa, use credenciais de vinculação para buscar o
servidor de diretório LDAP executando o seguinte:
● Certifique-se de que Utilizar identidade externa esteja definido como Falso.
● Defina Usar credenciais de vinculação para buscar como Verdadeiro.
● Especifique a ID e a senha do usuário para Vincular DN do usuário e senha.
9. Para configurar as propriedades de mapeamento avançadas do LDAP para uso com objetos do
Servidor do Active Directory, utilize valores especificados na seguinte tabela.
Valor LDAPPropriedade LDAPMapeamentos
organizationalUnit,organization,containerClasse do objetoPasta
descriçãoDescrição
ou,o,cnNome
grupoClasse do objetoGrupo
descriçãoDescrição
membroMembro
cnNome
usuárioClasse do objetoConta
Guia de instalação e configuração 211
Capítulo 9: Configuração de componentes do IBM Cognos para utilizar provedores de autenticação
Valor LDAPPropriedade LDAPMapeamentos
telephonenumberTelefone comercial
(deixar em branco)Localidade do conteúdo
descriçãoDescrição
correioE-mail
facsimiletelephonenumberFax/telefone
givennameNome específico
homephoneTelefone residencial
mobileTelefone celular
displayNameNome
pagerPager
unicodePwdSenha
postaladdressEndereço postal
(deixar em branco)Localidade do produto
snSobrenome
sAMAccountNameNome de usuário
Essas propriedades de mapeamento representam as mudanças baseadas em uma instalação
padrão do Servidor do Active Directory. Caso tenha modificado o esquema, pode ser necessário
realizar alterações de mapeamento adicionais.
Os atributos LDAP mapeados para a propriedade Nome em Mapeamento de pastas,
Mapeamentos de grupos e Mapeamentos de contas devem estar acessíveis a todos os usuários
autenticados. Além disso, a propriedade Nome não pode ficar em branco.
10. No menu Arquivo, clique em Salvar.
11. Teste a conexão em um novo namespace. Na janela Explorer, em Autenticação, clique com o
botão direito no novo recurso de autenticação e clique em Testar.
O IBM Cognos carrega, inicializa e configura as bibliotecas do provedor para o namespace.
212 IBM Cognos Business Intelligence PowerPlay
Capítulo 9: Configuração de componentes do IBM Cognos para utilizar provedores de autenticação
Configuração de namespaces LDAP para IBM Directory ServerCaso configure um novo namespace LDAP para uso com um IBM® Directory Server, será necessário
modificar as configurações necessárias e alterar os valores de todas as propriedades dos objetos do
IBM Directory.
Etapas
1. Em cada localização em que o Content Manager foi instalado, abra o IBM Cognos®
Configuration.
2. Na janela Explorer, em Segurança, clique com o botão direito em Autenticação e clique em
Novo recurso > Namespace.
3. Na caixa Nome, digite um nome para o namespace de autenticação.
4. Na lista Tipo, clique em LDAP e depois em OK.
O novo recurso provedor de namespace de autenticação aparece na janela Explorer, no
componente Autenticação.
5. Na janela Propriedades, na propriedade ID doNamespace, especifique um identificador exclusivo
para o namespace.
Dica: Não use dois pontos (:) na propriedade ID do namespace.
6. Especifique os valores para todas as outras propriedades necessárias para garantir que os
componentes do IBM Cognos possam localizar e utilizar o namespace de autenticação existente.
● Em Pesquisa de usuário, especifique (cn=${userID})
● Para Vincular DN do usuário e senha, especifique cn=root
7. Se desejar que o provedor de autenticação LDAP se vincule a um servidor de diretório utilizando
um Vincular DN do usuário e senha determinado ao pesquisar, especifique esses valores.
Se não houver valores especificados, o namespace de autenticação LDAP vincula como anônimo.
8. Se não usar mapeamento de identidade externa, use credenciais de vinculação para buscar o
servidor de diretório LDAP executando o seguinte:
● Certifique-se de que Utilizar identidade externa esteja definido como Falso.
● Defina Usar credenciais de vinculação para buscar como Verdadeiro.
● Especifique a ID e a senha do usuário para Vincular DN do usuário e senha.
9. Para configurar as propriedades de mapeamento avançadas do LDAP para uso com objetos do
IBM Directory Server, utilize valores especificados na seguinte tabela.
Valor LDAPPropriedade LDAPMapeamentos
organizationalunit,organization,containerClasse do objetoPasta
descriçãoDescrição
Guia de instalação e configuração 213
Capítulo 9: Configuração de componentes do IBM Cognos para utilizar provedores de autenticação
Valor LDAPPropriedade LDAPMapeamentos
ou,o,cnNome
groupofnamesClasse do objetoGrupo
descriçãoDescrição
membroMembro
cnNome
inetorgpersonClasse do objetoConta
telephonenumberTelefone comercial
(deixar em branco)Localidade do conteúdo
descriçãoDescrição
correioE-mail
facsimiletelephonenumberFax/telefone
givennameNome específico
homephoneTelefone residencial
mobileTelefone celular
cnNome
pagerPager
userPasswordSenha
postaladdressEndereço postal
(deixar em branco)Localidade do produto
snSobrenome
uidNome de usuário
214 IBM Cognos Business Intelligence PowerPlay
Capítulo 9: Configuração de componentes do IBM Cognos para utilizar provedores de autenticação
Essas propriedades de mapeamento representam as mudanças baseadas em uma instalação
padrão do IBM Directory Server. Caso tenha modificado o esquema, pode ser necessário realizar
alterações de mapeamento adicionais.
Os atributos LDAP mapeados para a propriedade Nome em Mapeamento de pastas,
Mapeamentos de grupos e Mapeamentos de contas devem estar acessíveis a todos os usuários
autenticados. Além disso, a propriedade Nome não pode ficar em branco.
10. No menu Arquivo, clique em Salvar.
Configuração de namespaces LDAP para Novell Directory ServerSe configurar um novo namespace LDAP para uso com um Novell Directory Server, será preciso
modificar as configurações e alterar os valores para todas as propriedades dos objetos do Novell
Directory.
Etapas
1. Em todos os locais que tiverem o Content Manager instalado, abra o IBM® Cognos®
Configuration.
2. Na janela Explorer, em Segurança, clique com o botão direito em Autenticação e clique em
Novo recurso > Namespace.
3. Na caixa Nome, digite um nome para o namespace de autenticação.
4. Na lista Tipo, clique em LDAP e depois em OK.
O novo recurso provedor de namespace de autenticação aparece na janela Explorer, no
componente Autenticação.
5. Na janela Propriedades, para a propriedade ID doNamespace, especifique um identificador
exclusivo para o namespace.
Dica: Não use dois pontos (:) na propriedade ID do namespace.
6. Especifique os valores para todas as outras propriedades necessárias para garantir que os
componentes do IBM Cognos possam localizar e utilizar o namespace de autenticação existente.
● Em Pesquisa de usuário, especifique (cn=${userID})
● ParaVincular DN do usuário e senha, especifique o DN base para um usuário administrador,
como cn=Admin,0=COGNOS
7. Se desejar que o provedor de autenticação LDAP se vincule a um servidor de diretório utilizando
um Vincular DN do usuário e senha determinado ao pesquisar, especifique esses valores.
Se não houver valores especificados, o namespace de autenticação LDAP vincula como anônimo.
8. Se não usar mapeamento de identidade externa, use credenciais de vinculação para buscar o
servidor de diretório LDAP executando o seguinte:
● Certifique-se de que Utilizar identidade externa esteja definido como Falso.
● Defina Usar credenciais de vinculação para buscar como Verdadeiro.
Guia de instalação e configuração 215
Capítulo 9: Configuração de componentes do IBM Cognos para utilizar provedores de autenticação
● Especifique a ID e a senha do usuário para Vincular DN do usuário e senha.
9. Para configurar as propriedades de mapeamento avançadas do LDAP para uso com objetos do
Novell Directory Server, utilize valores especificados na seguinte tabela.
Valor LDAPPropriedade LDAPMapeamentos
organizationalunit,organization,containerClasse do objetoPasta
descriçãoDescrição
ou,o,cnNome
groupofnamesClasse do objetoGrupo
descriçãoDescrição
membroMembro
cnNome
inetOrgPersonClasse do objetoConta
telephonenumberTelefone comercial
IdiomaLocalidade do conteúdo
descriçãoDescrição
correioE-mail
facsimiletelephonenumberFax/telefone
givennameNome específico
homephoneTelefone residencial
mobileTelefone celular
cnNome
pagerPager
(deixar em branco)Senha
postaladdressEndereço postal
216 IBM Cognos Business Intelligence PowerPlay
Capítulo 9: Configuração de componentes do IBM Cognos para utilizar provedores de autenticação
Valor LDAPPropriedade LDAPMapeamentos
IdiomaLocalidade do produto
snSobrenome
uidNome de usuário
Essas propriedades de mapeamento representam as mudanças baseadas em uma instalação
padrão do Novell Directory Server. Caso tenha modificado o esquema, pode ser necessário
realizar alterações de mapeamento adicionais.
Os atributos LDAP mapeados para a propriedade Nome em Mapeamento de pastas,
Mapeamentos de grupos e Mapeamentos de contas devem estar acessíveis a todos os usuários
autenticados. Além disso, a propriedade Nome não pode ficar em branco.
Para o login bem-sucedido de usuários no IBM Cognos Connection, eles devem ter permissão
para ler os atributos ou e o.
10. No menu Arquivo, clique em Salvar.
Configuração de namespaces LDAP para Sun Java System Directory ServerSe configurar um novo namespace LDAP para uso com o Sun JavaTM System Directory Server, será
necessário modificar as configurações necessárias e alterar os valores de todas as propriedades dos
objetos do Sun Java System Directory.
Etapas
1. Em todos os locais que tiverem o Content Manager instalado, abra o IBM® Cognos®
Configuration.
2. Na janela Explorer, em Segurança, clique com o botão direito em Autenticação e clique em
Novo recurso > Namespace.
3. Na caixa Nome, digite um nome para o namespace de autenticação.
4. Na lista Tipo, clique em LDAP e depois em OK.
O novo recurso provedor de namespace de autenticação aparece na janela Explorer, no
componente Autenticação.
5. Na janela Propriedades, para a propriedade ID doNamespace, especifique um identificador
exclusivo para o namespace.
Dica: Não use dois pontos (:) na propriedade ID do namespace.
6. Especifique os valores para todas as outras propriedades necessárias para garantir que os
componentes do IBM Cognos possam localizar e utilizar o namespace de autenticação existente.
As configurações seguintes são exemplos:
● Em Pesquisa de usuário, digite (uid=${userID})
Guia de instalação e configuração 217
Capítulo 9: Configuração de componentes do IBM Cognos para utilizar provedores de autenticação
● Caso utilize um único signon, em Utilizar identidade externa defina o valor como
Verdadeiro.
● Se utilizar signon único para Mapeamento de identidade externa, especifique qualquer
atributo, como a ID de domínio do usuário ou a ID do usuário:
(ntuserdomainid=$environment("REMOTE_USER")})
(uid=${environment("REMOTE_USER")})
● Para Identificador exclusivo, digite nsuniqueid
7. Se desejar que o provedor de autenticação LDAP se vincule a um servidor de diretório utilizando
um Vincular DN do usuário e senha determinado ao pesquisar, especifique esses valores.
Se não houver valores especificados, o namespace de autenticação LDAP vincula como anônimo.
8. Se não usar mapeamento de identidade externa, use credenciais de vinculação para buscar o
servidor de diretório LDAP executando o seguinte:
● Certifique-se de que Utilizar identidade externa esteja definido como Falso.
● Defina Usar credenciais de vinculação para buscar como Verdadeiro.
● Especifique a ID e a senha do usuário para Vincular DN do usuário e senha.
9. Para configurar as propriedades de mapeamento avançadas do LDAP para uso com objetos do
Sun Java System Directory Server, utilize valores especificados na seguinte tabela.
Valor LDAPPropriedade LDAPMapeamentos
organizationalUnit,organizationClasse do objetoPasta
descriçãoDescrição
ou,oNome
groupofuniquenamesClasse do objetoGrupo
descriçãoDescrição
uniquememberMembro
cnNome
inetorgpersonClasse do objetoConta
telephonenumberTelefone comercial
preferredlanguageLocalidade do conteúdo
218 IBM Cognos Business Intelligence PowerPlay
Capítulo 9: Configuração de componentes do IBM Cognos para utilizar provedores de autenticação
Valor LDAPPropriedade LDAPMapeamentos
descriçãoDescrição
correioE-mail
facsimiletelephonenumberFax/telefone
givennameNome específico
homephoneTelefone residencial
mobileTelefone celular
cnNome
pagerPager
userPasswordSenha
postaladdressEndereço postal
preferredlanguageLocalidade do produto
snSobrenome
uidNome de usuário
Essas propriedades de mapeamento representam as mudanças baseadas em uma instalação
padrão do Sun Java System Directory Server. Caso tenha modificado o esquema, pode ser
necessário realizar alterações de mapeamento adicionais.
Os atributos LDAP mapeados para a propriedade Nome em Mapeamento de pastas,
Mapeamentos de grupos e Mapeamentos de contas devem estar acessíveis a todos os usuários
autenticados. Além disso, a propriedade Nome não pode ficar em branco.
10. No menu Arquivo, clique em Salvar.
Disponibilização das propriedades personalizadas de usuário para LDAP disponíveispara os componentes do IBM Cognos
É possível usar atributos arbitrários de usuário do servidor de autenticação LDAP nos componentes
do IBM® Cognos®. Para configurar isso, é preciso adicionar esses atributos como propriedades
personalizadas para o namespace LDAP. As propriedades personalizadas estão disponíveis como
parâmetros de sessão no Framework Manager. Para obter mais informações sobre parâmetros de
sessão, consulte o Framework Manager User Guide.
Guia de instalação e configuração 219
Capítulo 9: Configuração de componentes do IBM Cognos para utilizar provedores de autenticação
Utilize também as propriedades personalizadas dentro dos blocos de comando para configurar
sessões e conexões do Oracle. Utilize blocos de comando com as conexões leves do Oracle e bancos
de dados privados virtuais. Para obter mais informações, consulte o Guia de administração e
segurança.
Etapas
1. Em cada local onde o Content Manager foi instalado, abra o Cognos Configuration.
2. Na janela Explorer, em Segurança > Autenticação, clique no namespace do LDAP.
3. Na janela Propriedades, clique na coluna Valor para Propriedades personalizadas e clique no
botão de edição.
4. Na janela Valor - Propriedades personalizadas, clique em Adicionar.
5. Clique na coluna Nome e digite o nome que deseja que os componentes do IBM Cognos utilizem
para o parâmetro da sessão.
6. Clique na coluna Valor e digite o nome do parâmetro de conta no provedor de autenticação
do LDAP.
7. Repita as duas etapas anteriores para cada parâmetro personalizado.
8. Clique em OK.
9. No menu Arquivo, clique em Salvar.
Ativação da comunicação segura com o servidor LDAPO protocolo LDAP seguro (LDAPS) criptografa a comunicação entre o componente do Access
Manager do Content Manager e o servidor de diretório. O LDAPS impede que informações delicadas
no servidor de diretório e as credenciais do LDAP sejam enviadas como texto simples.
Para ativar o LDAPS, instale um certificado de servidor que tenha sido assinado por uma autoridade
de certificação no servidor de diretório. Em seguida, crie um banco de dados de certificados para
armazenar os certificados. Por fim, configure o servidor de diretório e o namespace LDAP do IBM®
Cognos® para utilizar o LDAPS.
O certificado do servidor deve ser uma cópia de
● certificado raiz confiável e todos os outros certificados que compõem a cadeia de confiança
para o certificado de servidor de diretório.
O certificado raiz confiável é o certificado da autoridade de certificação raiz que assinou o
certificado do servidor de diretório.
● Somente o certificado do servidor de diretório.
Os certificados devem estar codificados como Base64 no formato ASCII (PEM). Todos os certificados,
exceto o certificado raiz confiável, não devem ter sua própria assinatura.
O IBM Cognos trabalha com as versões cert8.db e cert7.db do banco de dados do certificado do
cliente. É preciso utilizar a ferramenta certutil do kit de ferramentas Netscape OpenSource
NSS_3_3_2_RTM para criar o banco de dados de certificados. O IBM Cognos não aceita outras
220 IBM Cognos Business Intelligence PowerPlay
Capítulo 9: Configuração de componentes do IBM Cognos para utilizar provedores de autenticação
versões de arquivos cert8.db, incluindo aqueles da ferramenta certutil fornecida com o Microsoft®
Active Directory. A ferramenta certutil adequada está disponível no site do FTP do Mozilla.
Também é necessário usar a versão 4.6.7 da biblioteca NSPR, que está disponível no site de FTP
do Mozilla.
Etapas
1. Crie um diretório para o banco de dados de certificados.
2. Crie um banco de dados de certificado digitando
certutil -N -d diretório_certificado
onde diretório_certificado é o diretório criado na etapa 1.
Este comando cria um arquivo cert8.db e um arquivo key3.db no novo diretório.
3. Adicione o certificado da autoridade de certificação (CA) ou o certificado do servidor de
diretório ao banco de dados de certificado digitando o comando adequado para o tipo de
certificado:
● Para um certificado de CA, digite
certutil -A -n nome_certificado -d diretório_certificado -i CA.cert -t C,C,C
● Para um certificado do servidor de diretório, digite
certutil -A -n nome_certificado -d diretório_certificado -i certificado_servidor.cert -t P
onde nome_certificado é um alias atribuído, como o nome da CA ou nome host; e certificado_
servidor é o prefixo do arquivo de certificado do servidor de diretório.
4. Copie o diretório de banco de dados do certificado para o diretório local_c10/configuration
em cada local em que o Content Manager está instalado.
5. Configure o servidor de diretório para utilizar LDAPS e reinicie o servidor de diretório.
Para obter mais informações, consulte a documentação do servidor de diretório.
6. Em cada local do Content Manager onde o namespace LDAP foi configurado para utilizar o
servidor de diretório, inicie o IBM Cognos Configuration.
7. Na janela Explorer, em Segurança > Autenticação, clique no namespace do LDAP.
8. Na janela Propriedades, para a propriedade Host e porta, altere a porta para proteger a porta
LDAPS.
Para a propriedade Banco de dados de certificados SSL, especifique o caminho para o arquivo
cert7.db.
9. Na janela Explorer, clique com o botão direito no namespace do LDAP e clique em Testar.
Se o teste falhar, revise as propriedades, garantindo que o certificado correto seja utilizado.
10. No menu Arquivo, clique em Salvar.
11. No menu Ações, clique em Reiniciar.
Guia de instalação e configuração 221
Capítulo 9: Configuração de componentes do IBM Cognos para utilizar provedores de autenticação
12. Repita as etapas 6 a 11 em cada local onde o Content Manager está instalado.
Ativação do signon único entre o LDAP e os componentes do IBM CognosO signon único é obtido para componentes do IBM® Cognos® configurando a propriedade de
mapeamento Identidade externa.
O Mapeamento de identidade externa pode referir-se a uma variável de ambiente CGI ou uma
variável de cabeçalho HTTP. No caso de um gateway de servidor de aplicativos ou entrada de
distribuidor apontando para componentes do IBM Cognos, o mapeamento de Identidade externa
pode referir-se à variável de sessão userPrincipalName. O valor resolvido da propriedade
Mapeamento de identidade externa no tempo de execução deve ser um DN de usuário válido.
Quando um namespace LDAP é configurado para utilizar a propriedade Mapeamento de identidade
externa para autenticação, o provedor de LDAP vincula ao servidor de diretório utilizando Vincular
DN do usuário e senha ou utilizando anônimo se nenhum valor é especificado. Todos os usuários
que efetuaram logon no IBM Cognos por meio de mapeamento de identidade externa veem os
mesmos usuários, grupos e pastas que o usuário vinculado.
Se deseja que os componentes do IBM Cognos funcionem com aplicativos que usam segurança
JavaTM ou segurança de servidor de aplicativo, é possível configurar a propriedade de mapeamento
Identidade externa para obter a ID do usuário principal do Java. Inclua o token ${environment
("USER_PRINCIPAL")} no valor para a propriedade. Para obter mais informações, consulte a
ajuda online do IBM Cognos Configuration.
É possível aplicar edição de expressão limitada à propriedade Mapeamento de identidade externa
utilizando a operação de substituição.
Operação de substituiçãoA operação de substituição retorna uma cópia da string com todas as ocorrências da substring
anterior substituída pela nova.
As seguintes regras aplicam-se:
● O caractere \ evita os caracteres nos parâmetros da função. Caracteres como \ e " precisam ser
evitados.
● Chamadas de funções aninhadas não são suportadas.
● Caracteres especiais não são suportados.
Sintaxe
${replace(str , old , new)}
Parâmetros para a operação de substituição
DescriçãoParâmetro
A string de busca.str
222 IBM Cognos Business Intelligence PowerPlay
Capítulo 9: Configuração de componentes do IBM Cognos para utilizar provedores de autenticação
DescriçãoParâmetro
A substring a ser substituída pela nova.old
A substring que substitui a antiga.novo
Exemplos
${replace(${environment("REMOTE_USER")},"NAMERICA\\",)}
${replace(${environment("REMOTE_USER")},"NAMERICA\\","")}
Configuração de componentes do IBM Cognos para utilizareTrust SiteMinder
É possível configurar os componentes do IBM® Cognos® para usar um namespace Netegrity
SiteMinder como fonte de autenticação, desde que o Content Manager tenha sido instalado em um
computador sem Linux®
Para definir um provedor de autenticação em um ambiente eTrust SiteMinder, configure um
namespace LDAP, NTLM ou Netegrity SiteMinder dependendo da configuração do eTrust
SiteMinder. Configurações eTrust SiteMinder suportadas são LDAP, Servidor do Active Directory
e diretórios de usuário NTLM.
Observação: o provedor de autenticação utiliza um eTrust SiteMinder Software Development Kit
para implementar um agente personalizado. A implantação do agente personalizado requer a
configuração de Propriedades de agente no console de administração do servidor de políticas eTrust
SiteMinder para suportar agentes 4.x.
Caso planeje executar os produtos IBM Cognos Business Intelligence em um servidor de aplicativos
de 64 bits, não é possível configurar um namespace Netegrity SiteMinder como sua fonte de
autenticação.
Se o eTrust SiteMinder estiver configurado para mais de um diretório de usuário
Caso tenha configurado o eTrust SiteMinder para mais de um diretório de usuário, é necessário
utilizar o namespace Netegrity SiteMinder. Depois de configurar o namespace do Netegrity
SiteMinder no IBM Cognos, também é preciso adicionar um namespace LDAP, Active Directory
Server ou NTLM correspondente à configuração do IBM Cognos para cada diretório de usuário
definido no eTrust SiteMinder.
Ao configurar um namespace LDAP correspondente, é preciso garantir que a propriedade
Mapeamento de identidade externa esteja ativada e que o token REMOTE_USER seja incluído no
valor para a propriedade. Isso não significa que o eTrust SiteMinder deve ser configurado para
definir o REMOTE_USER. O namespace do IBM Cognos Netegrity SiteMinder passa informações
do usuário internamente ao namespace LDAP correspondente quando recebe identificação de
usuário bem-sucedida do ambiente eTrust SiteMinder.
Ao configurar um namespace do Active Directory correspondente, é preciso garantir que a
propriedade singleSignOnOption esteja definida para IdentityMapping. O namespace do IBM
Guia de instalação e configuração 223
Capítulo 9: Configuração de componentes do IBM Cognos para utilizar provedores de autenticação
Cognos Netegrity SiteMinder passa informações do usuário internamente ao namespace LDAP
correspondente utilizando a variável de ambiente REMOTE_USER quando recebe identificação de
usuário bem-sucedida do ambiente eTrust SiteMinder. Para obter mais informações, consulte
"Ativação do signon único entre o Active Directory Server e os componentes do IBM Cognos" (p. 200
).
Se o eTrust SiteMinder estiver configurado com apenas um diretório de usuário
Se o eTrust SiteMinder estiver configurado com apenas um diretório de usuário, o namespace do
Netegrity SiteMinder não será necessário. É possível utilizar o diretório de usuário como fonte de
autenticação com a configuração do namespace adequado, ou é possível configurar o provedor do
eTrust SiteMinder com um diretório de usuário. Por exemplo, se o diretório de usuário do eTrust
SiteMinder for NTML, será possível configurar componentes do IBM Cognos com um namespace
do NTLM ou configurar componentes do IBM Cognos com um namespace do Netegrity SiteMinder,
fazendo referência a um diretório de usuário que é um namespace do NTLM.
Se o diretório de usuário do eTrust SiteMinder é o Active Directory, é possível utilizar um namespace
do Active Directory ou um namespace LDAP que é configurado para uso com o Active Directory.
Se deseja utilizar o diretório de usuário como fonte de autenticação em vez de configurar um
namespace do Netegrity SiteMinder, configure o namespace LDAP (p. 208 ), do Active Directory
(p. 210 ) ou NTLM (p. 227 ). Nesse caso, é preciso verificar as propriedades do objeto de configuração
de agente no servidor de políticas do eTrust SiteMinder. Certifique-se de que o SetRemoteUser
esteja ativado.
Ao configurar um namespace LDAP, nesse caso, é preciso garantir que a propriedade Mapeamento
de identidade externa esteja ativada e que o token REMOTE_USER seja incluído no valor para a
propriedade.
Ao configurar um namespace do Active Directory, nesse caso, é preciso garantir que a propriedade
singleSignOnOption esteja definida para IdentityMapping. Para obter mais informações, consulte
"Ativação do signon único entre o Active Directory Server e os componentes do IBM Cognos" (p. 200
).
Para utilizar namespaces do eTrust SiteMinder e configurar signon único, faça o seguinte:
❑ Configure os componentes do IBM Cognos para utilizar namespaces do Netegrity SiteMinder
❑ Ative a comunicação segura para o diretório de usuário eTrust SiteMinder, se necessário
❑ Ative o signon único entre o eTrust SiteMinder e o IBM Cognos
❑ Proteja o alias web do IBM Cognos.
É possível ocultar namespaces de usuários durante o login (p. 207 ).
Configuração de namespaces do Netegrity SiteMinderCaso tenha configurado o eTrust SiteMinder para mais de um diretório de usuário, é necessário
utilizar o namespace Netegrity SiteMinder. Após adicionar o namespace do Netegrity SiteMinder,
é preciso adicionar também um namespace LDAP ou NTLM correspondente para cada diretório
de usuário.
224 IBM Cognos Business Intelligence PowerPlay
Capítulo 9: Configuração de componentes do IBM Cognos para utilizar provedores de autenticação
Também é possível configurar um namespace do Netegrity SiteMinder se houver usuários
armazenados em
● um servidor LDAP
● um servidor NTLM
● um servidor do Active Directory
Etapas
1. No local onde o Content Manager foi instalado, abra o IBM® Cognos® Configuration.
2. Na janela Explorer, em Segurança, clique com o botão direito em Autenticação e clique em
Novo recurso > Namespace.
3. Na caixa Nome, digite um nome para o namespace de autenticação.
4. Na lista Tipo, clique no namespace do Netegrity SiteMinder e clique em OK.
O novo recurso provedor de autenticação aparece na janela Explorer, no componente
Autenticação.
5. Na janela Propriedades, na propriedade ID doNamespace, especifique um identificador exclusivo
para o namespace.
Dica: Não use dois pontos (:) na propriedade ID do namespace.
6. Especifique os valores para todas as outras propriedades solicitadas para garantir que os
componentes do IBM Cognos possam localizar e utilizar o provedor de autenticação existente.
7. Na janela Explorer, em Segurança > Autenticação, clique com o botão direito no namespace e
clique em Novo recurso > SiteMinder Policy Server.
8. Na caixa Nome, digite um nome para o servidor de políticas e clique em OK.
9. Na janela Propriedades, especifique a propriedadeHost e qualquer outros valores de propriedade
que deseja alterar.
10. Na janela Explorer, clique com o botão direito no novo SiteMinder Policy Server e clique em
Novo recurso > Diretório de usuários.
Dica: configure um diretório de usuário para cada diretório de usuário no servidor de políticas
do SiteMinder.
11. Na caixa Nome, digite um nome para o diretório de usuário e clique em OK.
O nome do diretório de usuários deve corresponder ao nome que aparece no servidor de
políticas.
12. Na janela Propriedades, digite um valor para a propriedade Referência à ID do namespace.
13. No menu Arquivo, clique em Salvar.
14. Teste a conexão em um novo namespace. Na janela Explorer, em Autenticação, clique com o
botão direito no novo recurso de autenticação e clique em Testar.
Guia de instalação e configuração 225
Capítulo 9: Configuração de componentes do IBM Cognos para utilizar provedores de autenticação
15. Configure um namespace LDAP, Active Directory ou NTLM correspondente para cada diretório
de usuário LDAP, Active Directory ou NTLM.
Certifique-se de utilizar o mesmo valor para a propriedade ID do namespace utilizada para a
propriedade ID do namespace para o namespace do Netegrity SiteMinder.
Ativação da comunicação segura para o diretório de usuário do eTrust SiteMinderSe utilizar uma conexão SSL ao servidor de diretório, será preciso configurar corretamente o
namespace do Cognos para o diretório de usuário.
Para obter mais informações, consulte "Configuração de namespaces LDAP" (p. 208 ).
Ativação do signon único entre o eTrust SiteMinder e o IBM CognosAo configurar o signon único, não será solicitada a reinserção de informações de autenticação.
Os componentes do IBM® Cognos® referem-se automaticamente ao cookie da sessão do eTrust
SiteMinder para dados de sessão de usuário.
Se o diretório de usuário do eTrust SiteMinder for LDAP ou Active Directory, será preciso configurar
o diretório de usuário para utilizar mapeamento de identidade externo para a variável de ambiente
REMOTE_USER.
Se o diretório de usuário eTrust SiteMinder for NTLM, a autenticação integrada do sistema
operacional Microsoft® Windows® será utilizada para signon único e nenhuma configuração adicional
será necessária.
Proteção do alias de web do IBM CognosVerifique se o eTrust SiteMinder está configurado corretamente para proteger o alias Web do IBM®
Cognos®.
Utilize a ferramenta de teste fornecida com o eTrust SiteMinder para verificar se o recurso está
protegido, autenticado e autorizado. Para obter mais informações, consulte a documentação do
eTrust SiteMinder.
Ocultação do namespace dos usuários durante o loginÉ possível ocultar namespaces de usuários durante o login. É possível ter namespaces de signon
confiável sem exibi-los na lista de seleção de namespace que é apresentada aos usuários durante o
login.
Por exemplo, caso deseje integrar um signon único em todos os sistemas, mas desejar manter a
capacidade de autenticação direta dos clientes no IBM® Cognos® sem que sejam solicitados a escolher
um namespace.
Etapas
1. Em cada local onde um provedor de autenticação eTrust SiteMinder foi configurado, abra do
IBM Cognos Configuration.
226 IBM Cognos Business Intelligence PowerPlay
Capítulo 9: Configuração de componentes do IBM Cognos para utilizar provedores de autenticação
2. Na janela Explorer, em Segurança > Autenticação, clique no provedor de autenticação Netegrity
Siteminder.
3. Na janela Propriedades, clique na caixa próxima à Selecionável para autenticação e clique em
Falso.
4. No menu Arquivo, clique em Salvar.
O namespace não é mostrado na lista de seleção apresentada no login.
Configuração de componentes do IBM Cognos para utilizar umnamespace NTLM
É possível configurar os componentes do IBM® Cognos® para usar a segurança nativa do sistema
operacional Microsoft® Windows®, o NT LAN Manager (NTLM), como fonte de autenticação.
Se não estiver utilizando NTLM no ambiente de IS, não será possível utilizar um namespace do
NTLM.
Se deseja utilizar um diretório de usuário NTLM como fonte de autenticação com o eTrust
SiteMinder, é preciso verificar as propriedades do objeto de configuração do agente no servidor de
políticas do eTrust SiteMinder. Certifique-se de que o SetRemoteUser esteja ativado.
Para utilizar um NTLM e configurar signon único, faça o seguinte:
❑ Configure um namespace NTLM
❑ Ative o signon único entre o NTLM e os componentes do IBM Cognos.
Configuração de namespaces NTLMÉ possível configurar os componentes do IBM® Cognos® para utilizar um namespace NTLM quando
os usuários estão armazenados em um diretório de usuário NTLM. O diretório de usuário NTLM
também pode ser acessado utilizando um provedor de autenticação eTrust SiteMinder.
Etapas
1. No local onde o Content Manager foi instalado, abra o IBM Cognos Configuration.
2. Na janela Explorer, em Segurança, clique com o botão direito em Autenticação e clique em
Novo recurso > Namespace.
3. Na caixa Nome, digite um nome para o namespace de autenticação.
4. Na lista Tipo, clique em NTLMe em OK.
O novo recurso provedor de autenticação aparece na janela Explorer, no componente
Autenticação.
5. Na janela Propriedades, na propriedade ID doNamespace, especifique um identificador exclusivo
para o namespace.
Dica: não use dois-pontos (:) na propriedade ID do Namespace.
Guia de instalação e configuração 227
Capítulo 9: Configuração de componentes do IBM Cognos para utilizar provedores de autenticação
6. Especifique os valores para todas as outras propriedades solicitadas para garantir que os
componentes do IBM Cognos possam localizar e utilizar o provedor de autenticação existente.
7. No menu Arquivo, clique em Salvar.
8. Teste a conexão em um novo namespace. Na janela Explorer, em Autenticação, clique com o
botão direito no novo recurso de autenticação e clique em Testar.
O IBM Cognos carrega, inicializa e configura as bibliotecas do provedor para o namespace.
Ativação do signon único entre o NTLM e os componentes do IBM CognosPor padrão, o provedor NTLM do IBM® Cognos® integra-se ao servidor web IIS para usar o signon
único se a autenticação integrada (anteriormente chamada NT Challenge Response) do sistema
operacional Microsoft® Windows® for ativada no servidor web IIS.
Se a autenticação integrada do Windows estiver ativada, não será solicitada a reinserção das
informações de autenticação ao acessar o conteúdo do IBM Cognos que é protegido pelo namespace
NTLM.
Etapas
1. Configure a autenticação integrada do Windows no servidor web IIS.
2. Instale o Content Manager em um local que faça parte do domínio, considerando os Content
Manager ativos e em espera.
3. Configure os computadores ou a conta de usuário que o Content Manager executa para serem
confiados para delegação.
4. Teste a conexão em um novo namespace. Na janela Explorer, em Autenticação, clique com o
botão direito no novo recurso de autenticação e clique em Testar.
O IBM Cognos carrega, inicializa e configura as bibliotecas do provedor para o namespace.
Configuração do IBM Cognos para utilizar provedores deautenticação
Caso utilize um provedor Resource Access Control Facility (RACF) para autenticação no ambiente
da empresa, também é possível utilizar os produtos IBM® Cognos® para autenticação.
Para configurar um namespace RACF e definir um único signon, faça o seguinte:
❑ Configure os componentes do IBM® Cognos® para usar um namespace do RACF
❑ Configure comunicações seguras
❑ Ative o signon único entre o provedor RACF e os componentes IBM Cognos
228 IBM Cognos Business Intelligence PowerPlay
Capítulo 9: Configuração de componentes do IBM Cognos para utilizar provedores de autenticação
Configuração de namespace RACFÉ possível configurar um namespace Resource Access Control Facility (RACF) usando o IBM®
Cognos® Configuration.
Antes de configurar o namespace RACF, é necessário fazer o seguinte:
● É necessário executar o Tivoli® Directory Server.
● O Tivoli Directory Server deve estar configurado para LDAP para acessar o banco de dados
SDBM (RACF).
Para obter mais informações, consulte o tópico sobre como configurar o Tivoli Access Manager
para LDAP no IBM Information Center.
Etapas
1. Se estiver sendo executado em um servidor 64 bits, faça o seguinte:
● Acesse o diretório de instalação do RACF no servidor 64 bits.
● Copie todos os arquivos de 64 bits da biblioteca RACF local_c10_64\bin64, em que
local_c10_64 é o diretório em que o servidor IBM Cognos foi instalado.
● Copie todos os arquivos da biblioteca RACF de 32 bits para local_c10_64\bin.
2. Se estiver executando em um servidor de 32 bits, copie todos os arquivos da biblioteca RACF
de 32 bits do diretório de instalação RACF para o diretório local_c10\bin.
3. No local onde o Content Manager foi instalado, abra o IBM Cognos Configuration.
4. Para criar o namespace, faça o seguinte:
● Na janela Explorer, em Segurança, clique com o botão direito em Autenticação e clique
em Novo recurso > Namespace.
● Na caixa Nome, digite um nome para o namespace de autenticação.
● Na lista Tipo, clique em RACF e depois em OK.
O novo recurso do provedor de autenticação aparece na janela Explorer, no componente
Autenticação.
5. Na janela Propriedades, na propriedade ID do namespace, especifique um identificador exclusivo
para o namespace.
Não use dois pontos (:) na propriedade ID do namespace.
6. Para a propriedade Host e porta, digite o valor que corresponde ao Tivoli Directory Server.
7. Para a propriedade Nome Distinto Base, digite o valor que corresponde ao sufixo que está
configurado para SDBM no Tivoli Directory Server.
8. Se uma conexão SSL estiver sendo usada para o provedor RACF, defina a propriedade Habilitar
SSL como verdadeira.
Guia de instalação e configuração 229
Capítulo 9: Configuração de componentes do IBM Cognos para utilizar provedores de autenticação
9. Para mapear as propriedades da conta RACF, como e-mail e número de telefone, nas
propriedades Segmento de base DATA e USERDATA de segmento TSO em Mapeamentos de
contas, clique na coluna de valores e selecione o valor da lista suspensa.
10. No menu Arquivo, clique em Salvar.
11. Teste a conexão em um novo namespace. Na janela Explorer, em Autenticação, clique com o
botão direito no novo recurso de autenticação e clique em Testar.
Ativação do signon único entre o RACF e o IBM CognosAtive o signon único entre o provedor Resource Access Control Facility (RACF) e os componentes
do IBM® Cognos® para simplificar o processo de autenticação para os usuários, evitando a
necessidade de vários signons e simplificando o gerenciamento das identidades de usuários na rede.
Obtém-se o signon único configurando o mapeamento de identidade no IBM Cognos Configuration,
configurando o IBM WebSphere® Application Server para definir o USUÁRIO_REMOTO e, em
seguida, configurando o WebSphere para autenticar-se no RACF.
Quando o namespace RACF é configurado para usar o mapeamento de identidade para autenticação,
o namespace do RACF é vinculado ao provedor RACF usando as credenciais de vinculação ou
usando usuário anônimo, caso nenhuma credencial de vinculação tenha sido especificada. Todos
os usuários que efetuaram logon no IBM Cognos por meio de mapeamento de identidade veem os
mesmos usuários, grupos e pastas que o usuário vinculado.
Etapas
1. Em cada local onde o Content Manager foi instalado, abra o IBM Cognos Configuration.
2. Na janela Explorer, em Segurança, clique com o botão direito em Autenticação e em seguida
clique no namespace RACF.
3. Na janela Propriedades do Recurso, altere Habilitar o mapeamento de identidade para
Verdadeiro.
4. Clique na coluna de valores para Credenciais de vinculação e clique no botão Editar.
5. Na caixa de diálogo Valor- Credenciais de vinculação, especifique a ID de usuário e a Senha.
6. No IBM Cognos Configuration, reinicie o serviço:
● Na janela Explorer, expanda Serviço do IBM Cognos e selecione o serviço.
● No menu Ações, clique em Reiniciar.
7. Usando a documentação WebSphere, configure o WebSphere para definir o
USUÁRIO_REMOTO.
8. Usando a documentação WebSphere, configure o WebSphere para autenticar usando o
fornecedor RACF.
230 IBM Cognos Business Intelligence PowerPlay
Capítulo 9: Configuração de componentes do IBM Cognos para utilizar provedores de autenticação
Exclusão de provedores de autenticaçãoCaso não sejam mais necessários, é possível excluir os namespaces adicionados ou desconfigurar
os namespaces que os componentes do IBM® Cognos® detectaram.
Não exclua o namespace do Cognos. Ele contém dados de autenticação que pertencem a todos os
usuários e é obrigatório para salvar a configuração.
Quando um namespace é excluído, não é mais possível fazer logon nele. Os dados de segurança
para o namespace permanecem no Content Manager até serem permanentemente excluídos no
portal. Para obter mais informações, consulte o Guia de administração e segurança.
Etapas
1. Em cada local onde o Content Manager foi instalado, abra o Cognos Configuration.
2. Na janela Explorer, em Segurança > Autenticação, clique com o botão direito no namespace e
clique em Excluir.
3. Clique em Sim para confirmar.
O namespace desaparece da janela Explorer e não é mais possível fazer logon no namespace
nesse local.
4. No menu Arquivo, clique em Salvar.
5. Repita as etapas 1 a 4 para cada local onde o Content Manager foi instalado.
É preciso agora fazer logon no portal e excluir permanentemente os dados do namespace. Para
obter mais informações, consulte o Guia de administração e segurança.
Após a exclusão de um namespace, ele aparece como Inativo no portal.
Guia de instalação e configuração 231
Capítulo 9: Configuração de componentes do IBM Cognos para utilizar provedores de autenticação
232 IBM Cognos Business Intelligence PowerPlay
Capítulo 9: Configuração de componentes do IBM Cognos para utilizar provedores de autenticação
Capítulo 10: Opções de configuração
Depois de instalar e configurar os componentes do IBM® Cognos®, é possível alterar a configuração
do seu ambiente. Inicialmente, as configurações padrão são utilizadas para configurar os
componentes. Entretanto, pode ser necessário alterar essas configurações padrão se as condições
existentes tornarem as escolhas padrão inadequadas ou para que se ajustem melhor ao ambiente.
Por exemplo, é possível configurar recursos para o IBM Cognos Application Firewall ou especificar
a quantidade de recursos que os componentes do IBM Cognos utilizam. Além disso, é possível
entregar conteúdo do IBM Cognos utilizando outro portal configurando Portal Services.
É possível configurar os componentes do IBM Cognos para utilizar outros recursos, como usar um
provedor de autenticação e, em seguida, ativar o signon único para a conexão de banco de dados
e de usuários.
Se utilizar um esquema de balanceamento de carga no ambiente, será possível alterar as configurações
e melhorar o desempenho. Por exemplo, é possível balancear solicitações entre distribuidores
alterando sua capacidade de processamento ou definindo um número máximo e mínimo de processos
e conexões. Para obter mais informações sobre ajuste de desempenho de servidor, consulte o Guia
de administração e segurança.
Se estiver atualizando o ReportNet, haverá várias opções de configuração, dependendo se deseja
continuar a utilizar a instalação existente. Para obter informações sobre opções de atualização,
consulte "Atualização de uma versão anterior do IBM Cognos PowerPlay" (p. 72 ).
Como mostrado no diagrama a seguir, se o valor de uma propriedade for alterado, será necessário
salvar a configuração e, em seguida, reiniciar o Serviço IBM Cognos para aplicar as novas
configurações. É recomendável usar o recurso de teste no IBM Cognos Configuration para validar
as mudanças.
Fluxo de trabalho do processo de configuraçãoCognos Configuration
Personalização Alteração daconfiguração
1 3Gravação dasalterações
Iníciodos serviços
4Teste derecurso
2
daconfiguração
Para todos os sistemas operacionais Microsoft® Windows® e a maioria dos sistemas operacionais
UNIX® e Linux®, utilize o IBM Cognos Configuration para configurar as definições. Entretanto,
se o console conectado ao computador UNIX ou Linux no qual estão sendo instalados os
componentes do IBM Cognos não for compatível com uma interface gráfica de usuário baseada
em JavaTM será necessário editar manualmente o arquivo cogstartup.xml no diretório
local_c10/configuration e, em seguida, executar o IBM Cognos Configuration no modo silencioso.
Utilize estas tarefas de configuração opcionais para personalizar a configuração de forma que os
componentes do IBM Cognos se integrem facilmente ao ambiente existente.
❑ Altere os ajustes de configuração padrão.
❑ Crie um novo armazenamento de conteúdo utilizando o Banco de dados de conteúdo do Cognos.
Licensed Materials – Property of IBM233© Copyright IBM Corp. 2005, 2010.
❑ Configure o protocolo SSL.
❑ Configure um repositório para as mensagens de log.
❑ Altere as configurações globais.
❑ Altere o gateway.
❑ Altere a versão do endereço IP.
❑ Configure o roteador para testar a disponibilidade do distribuidor.
❑ Atualize as propriedades de localizações de arquivo no Windows Vista.
Iniciar o IBM Cognos ConfigurationUse a ferramenta de configuração, o IBM® Cognos® Configuration, para configurar o IBM Cognos
ou para iniciar e interromper os serviços do IBM Cognos.
Antes de iniciar o IBM Cognos Configuration, certifique-se de que o ambiente operacional esteja
devidamente configurado. Por exemplo, certifique-se de que todas as variáveis foram definidas.
O IBM Cognos Configuration deverá ser iniciado na última página do assistente de instalação nos
sistemas operacionais Microsoft® Windows®, UNIX® ou Linux® somente se não for necessário fazer
configurações adicionais. Por exemplo, se um servidor de banco de dados diferente do Microsoft®
SQL for utilizado para o armazenamento de conteúdo, copie os drivers JDBC para o local apropriado
antes de iniciar a ferramenta de configuração.
Para iniciar o IBM Cognos Configuration em um computador Windows:
● No menu Iniciar, clique em Programas > IBM Cognos 10 > IBM Cognos Configuration.
Para iniciar o IBM Cognos Configuration em um UNIX ou Linux:
● Acesse o diretório local_c10/bin e digite
./cogconfig.sh
Alteração de definições de configuração padrãoAo instalar os componentes do IBM® Cognos®, a instalação utiliza definições de configuração
padrão. Se não há razões para usar esses valores padrão, como uma porta sendo usada por outro
processo, use o IBM Cognos Configuration para mudar o valor.
Se o valor de uma propriedade for alterado, será necessário salvar as configurações e, em seguida,
reiniciar o serviço do IBM Cognos para aplicar as novas configurações ao computador.
Para instalações distribuídas, certifique-se de que configurou todos os computadores em que o
Content Manager foi instalado antes de mudar as definições de configuração padrão nos outros
computadores com o IBM Cognos. Por exemplo: é possível
● Alteração do usuário e senha padrão no Banco de dados de conteúdo do Cognos.
● Alteração de URI.
234 IBM Cognos Business Intelligence PowerPlay
Capítulo 10: Opções de configuração
● Configuração de definições criptográficas.
● Configuração dos componentes do IBM Cognos para utilização do IBM Cognos Application
Firewall.
● Configuração de propriedades de arquivo temporário.
● Configuração do gateway para usar um namespace.
● Ativação e desativação de serviços.
● Configuração de fontes.
● Configuração do suporte para chinês simplificado.
● Alteração de fonte padrão para relatórios.
● Salvar saídas de relatório em um sistema de arquivos.
● Configuração do banco de dados de notificação.
Depois de alterar o comportamento padrão do IBM Cognos BI para que melhor se adapte ao
ambiente dos componentes do IBM Cognos, é possível configurar o Portal Services, configurar um
provedor de autenticação ou testar a instalação(p. 112 ).
Para o IBM Cognos BI, é possível instalar e configurar o Framework Manager. Para o Metric Studio,
é possível instalar e configurar o Metric Designer.
Alteração do usuário e senha padrão do Banco de dados de conteúdo do CognosSe o Cognos® Content Database for instalado, o banco de dados padrão criado recebe uma ID e
uma senha de usuário. Altere essa ID e senha de usuário.
As Tarefas de administração do Banco de dados de conteúdo do Cognos são realizadas usando um
utilitário chamado ij. Para obter informações sobre este utilitário, consulte a documentação do
Apache Derby. A documentação está disponível no diretório local_c10/derby10.1.2.1/docs onde
foi instalado o Banco de dados de conteúdo do Cognos.
Etapas para alterar a senha de usuário padrão
1. No computador onde o Banco de dados de conteúdo do Cognos foi instalado, acesse o diretório
local_c10/derby10.1.2.1/bin.
2. Inicie o utilitário ij usando o arquivo de script ij.bat ou ij.ksh.
O utilitário ij é um utilitário de linha de comando para criação e gerenciamento do Banco de
Dados de Conteúdo do Cognos.
3. Conecte-se ao banco de dados padrão digitando o seguinte comando do utilitário ij:
connect 'jdbc:derby://localhost:1527/cm;user=cognos;password=cognos';
Se o número da porta foi alterado do padrão 1527, use o número correto no Banco de dados
de conteúdo do Cognos.
O banco de dados padrão é chamado de cm. O nome do banco de dados diferencia maiúsculas
e minúsculas.
Guia de instalação e configuração 235
Capítulo 10: Opções de configuração
4. Mude a senha padrão do usuário cognos digitando o seguinte comando do utilitário ij:
CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY('derby.user.cognos',
'NewPassword');
A nova senha deve ser usada na próxima conexão no banco de dados.
5. Feche o utilitário ij digitando o seguinte comando:
desconectar;
Etapas para criar uma nova ID e senha de usuário
1. No computador onde o Banco de dados de conteúdo do Cognos foi instalado, acesse o diretório
local_c10/derby10.1.2.1/bin.
2. Inicie o utilitário ij usando o arquivo de script ij.bat ou ij.ksh.
3. Conecte-se ao banco de dados padrão digitando o seguinte comando do utilitário ij:
connect 'jdbc:derby://localhost:1527/cm;user=cognos;password=cognos';
Se o número da porta foi alterado do padrão 1527, use o número correto no Banco de dados
de conteúdo do Cognos.
O banco de dados padrão é chamado de cm. O nome do banco de dados diferencia maiúsculas
e minúsculas.
4. Crie um novo usuário digitando o seguinte comando do utilitário ij:
CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY('derby.user.NewUser',
'NewUserPassword');
5. Providencie ao novo usuário acesso total ao banco de dados digitando o seguinte comando do
utilitário ij:
CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY ('derby.database.
fullAccessUsers’,’cognos, NewUser');
A propriedade que está mudando, a lista de usuários, é um campo delimitado por vírgulas.
Nesta etapa, um novo usuário está sendo incluído na lista de usuários com acesso total. O
usuário padrão, cognos, ainda é parte da lista de usuários com acesso total. É possível remover
esse usuário.
6. Feche o utilitário ij digitando o seguinte comando:
desconectar;
Etapas para remover um usuário
1. No computador onde o Banco de dados de conteúdo do Cognos foi instalado, acesse o diretório
local_c10/derby10.1.2.1/bin.
2. Inicie o utilitário ij usando o arquivo de script ij.bat ou ij.ksh.
3. Conecte-se ao banco de dados padrão digitando o seguinte comando do utilitário ij:
conecte 'jdbc:derby://localhost:1527/cm;user=NewUser; password=NewUserPassword';
236 IBM Cognos Business Intelligence PowerPlay
Capítulo 10: Opções de configuração
4. Escolha o tipo de usuário que deseja remover:
● Para remover um usuário da lista de usuários com acesso total, digite o seguinte comando
do utilitário ij:
CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY ('derby.database.
fullAccessUsers', 'NewUser');
O nome de usuário é omitido da lista de usuários com acesso total. Por exemplo, o comando
acima remove o usuário padrão cognos e mantém o novo usuário recém-criado.
● Para remover usuários do banco de dados, digite o seguinte comando ij e omita a senha de
usuário:
CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY('derby.user.cognos', '');
Este comando remove a senha do usuário padrão cognos, que também remove o usuário
do banco de dados.
5. Feche o utilitário ij digitando o seguinte comando:
desconectar;
Alteração de uma configuração de porta ou de URIÉ possível mudar alguns elementos em um URI dependendo de seu ambiente. Um URI do IBM®
Cognos® contém os seguintes elementos:
● Para o URI do Content Manager, URI do distribuidor para aplicativos externos ou URI do
distribuidor
protocol://host_name_or_IP:port/context_root/alias_path
● Para o URI do gateway ou o URI do conteúdo na web
protocol://host_name_or_IP:port/virtual_directory/gateway_application
OU
protocol://host_name_or_IP:port/context_root/alias_path
Os elementos estão descritos na tabela a seguir:
DescriçãoElemento
Especifica o protocolo usado para solicitar e transmitir informações, Hyper Text
Transfer Protocol ou Hyper Text Transfer Protocol (Seguro).
protocolo
Exemplo: http ou https
Guia de instalação e configuração 237
Capítulo 10: Opções de configuração
DescriçãoElemento
Especifica a identidade do host na rede. É possível usar um endereço IP, um
nome de computador ou um nome de domínio totalmente qualificado.
nome ou IP
do host
Em uma instalação distribuída, é necessário alterar o elemento de localhost de
um URI.
Em um ambiente misto de servidores com os sistemas operacionais UNIX® e
Microsoft® Windows®, certifique-se de que os nomes de host possam ser
convertidos em endereços IP por todos os servidores do ambiente.
Exemplo: localhost ou 192.168.0.1 ou [2001:0db8:0000:0000:0000:148:57ab]:
80
Especifica a porta em que o sistema de host ouve pedidos.porta
A porta padrão para Tomcat é 9300. A porta padrão de um servidor web é 80.
Exemplo: 9300 ou 80
Usada pelo Tomcat ou um servidor de aplicativos para determinar o contexto
do aplicativo, para que a solicitação possa ser incorporada ao aplicativo web
correto para ser processada.
raiz do
contexto
Exemplo: p2pd
Usado pelo servidor de aplicativos para distribuir uma solicitação ao componente
padrão em um aplicativo web.
caminho do
alias
O caminho do alias não deve ser modificado ou os componentes do IBM
Cognos não irão funcionar corretamente.
Exemplo: servlet/dispatch
Usado pelo servidor web para mapear um diretório virtual ou alias em um local
físico.
diretório
virtual
Por exemplo, no URI do gateway padrão de http://localhost:80/ibmcognos/cgi-
bin/cognos.cgi, o diretório virtual é ibmcognos/cgi-bin.
Exemplo: ibmcognos/
Especifica o nome do aplicativo de gateway do Cognos usado.aplicativo
do gateway Por exemplo, se estiver acessando os componentes do IBM Cognos usando uma
interface de gateway comum (CGI), então o aplicativo de gateway padrão será
o cognos.cgi.
Exemplo: cognos.cgi
Etapas
1. Inicie o IBM Cognos Configuration.
238 IBM Cognos Business Intelligence PowerPlay
Capítulo 10: Opções de configuração
2. Na janela Explorer, clique no grupo ou componente apropriado:
● Para alterar um elemento para o distribuidor, clique em Ambiente.
● Para alterar um elemento do servidor de log local, em Ambiente, clique em Log.
3. Na janela Propriedades, clique na caixa de diálogo Valor próxima à propriedade de URI que
deseja alterar.
4. Selecione o elemento e digite as novas informações.
Dicas
● Para alterar a porta usada pelo distribuidor local, mude o valor da propriedade do URI do
distribuidor interno. É necessário alterar os URI de todos os componentes locais, pois a
alteração afeta todos os URI baseados no distribuidor local.
● Se a porta do distribuidor for alterada, verifique se o novo número de porta foi especificado
durante a configuração dos computadores remotos que usam este recurso, o Content
Manager ou serviços Software Development Kit neste sistema.
5. No menu Arquivo, clique em Salvar.
Configuração de definições criptográficasOs componentes do IBM® Cognos® necessitam de um provedor criptográfico, do contrário não
irão funcionar. Se excluiu o provedor de criptografia padrão, é necessário configurar outro provedor
para substituí-lo.
É possível configurar as seguintes definições criptográficas:
● definições criptográficas gerais
● definições para o provedor de criptografia padrão
● definições para um provedor de criptografia em uma infraestrutura de segurança Entrust
Configuração de definições criptográficas gerais
É possível configurar as seguintes definições criptográficas gerais:
● propriedades de armazenamento de chave simétrica comum (CSK)
A CSK é utilizada pelo IBM® Cognos® para criptografar e descriptografar dados.
● definições do secure sockets layer (SSL)
Essas definições incluem autenticação mútua e confidencialidade.
● definições avançadas de algoritmo
Esses incluem algoritmos de resumo e de logon.
Em uma instalação distribuída, os computadores com o IBM Cognos comunicam-se com o Content
Manager para estabelecer confiança e obter algumas chaves criptográficas do Content Manager.
Se mudar as chaves criptográficas no Content Manager, como alterando servidores de aplicativos
ou reinstalando o Content Manager, é necessário excluir as chaves criptográficas nos outros
Guia de instalação e configuração 239
Capítulo 10: Opções de configuração
computadores com o IBM Cognos. Então é necessário salvar as configurações em cada computador
para que possam obter as novas chaves criptográficas do Content Manager. Além disso, é preciso
configurar todos os componentes do IBM Cognos em uma instalação distribuída com as mesmas
definições do provedor de criptografia.
Também, em um ambiente de distribuição, a chave simétrica deve ser armazenada somente nos
computadores em que o Content Manager foi instalado.
Etapas
1. Inicie o IBM Cognos Configuration.
2. Na janela Explorer, em Segurança, clique em Criptografia.
3. Na janela Propriedades, mude os valores padrão clicando na caixa de diálogo Valor e
selecionando o valor adequado:
● Nos computadores que não contêm o Content Manager, se não desejar armazenar as CSKs
localmente, altere Armazenar chave simétrica localmente para Falso, em Configurações
CSK.
Quando Armazenar chave simétrica localmente for Falso, a chave é recuperada do Content
Manager quando solicitado. A propriedade Localização do banco de chaves simétricas
comuns é ignorada.
● Se deseja que os computadores de ambos os lados de uma transmissão provem sua
identidade, mude Utilizar autenticação mútua para Verdadeiro, em Configurações SSL.
Não altere a configuração Utilizar confidencialidade.
● Se desejar mudar o algoritmo de resumo, selecione outro valor na propriedade Algoritmo
digest.
4. No menu Arquivo, clique em Salvar.
5. Teste o provedor de criptografia somente em um computador de gateway. Na janela Explorer,
clique com o botão direito em Criptografia e clique em Testar.
Os componentes do IBM Cognos verificam a disponibilidade da chave simétrica.
Depois de ter configurado as definições criptográficas, as senhas em suas configurações e todos os
dados criados são criptografados.
Configuração das definições para o provedor de criptografia padrão
É possível configurar as seguintes definições criptográficas para o provedor de criptografia:
● algoritmos e conjuntos de codificação
● definições do nome de identidade
● propriedades do banco de chaves de assinatura
O par de chaves de assinatura inclui a chave privada usada para gerar a assinatura digital e a
chave pública usada para verificar a autenticidade.
240 IBM Cognos Business Intelligence PowerPlay
Capítulo 10: Opções de configuração
● propriedades do banco de chaves de assinatura
O par de chaves de criptografia inclui a chave privada usada para criptografar dados e a chave
pública usada para descriptografar dados.
● configurações da autoridade de certificação
Incluem propriedades da autoridade de certificação fornecida ou de uma CA de terceiros.
Etapas
1. Se estiver usando um JRE diferente do fornecido com o servidor do IBM Cognos, certifique-se
de que os seguintes arquivos do IBM Cognos estejam presentes no local onde o JRE está
instalado:
● Em local_c10/bin/jre/versão/lib/ext, copie bcprov-jdk14-134.jar para local_JRE/lib/ext.
● Em local_c10/bin/jre/versão/lib/security, copie local_policy.jar e US_export_policy.jar para
local_JRE/lib/security.
2. Para garantir que todos os algoritmos e conjuntos de codificação disponíveis sejam exibidos
no IBM Cognos Configuration, baixe e instale o arquivo de política irrestrita de Java
Cryptograph Extension (JCE). Para o Java fornecido pela IBM, é possível baixar o arquivo de
política irrestrita de JCE em https://www14.software.ibm.com/webapp/iwm/web/preLogin.
do?source=jcesdk.
3. Início do IBM® Cognos® Configuration.
4. Na janela Explorer, em Segurança, Criptografia, clique em Cognos.
5. Na janela Propriedades, altere as propriedades, conforme necessário.
● Para configurar o algoritmo de confidencialidade, na propriedade adequada, Algoritmo de
confidencialidade ouAlgoritmo de confidencialidade PDF, clique na colunaValor e selecione
o algoritmo na lista suspensa.
O valor de um algoritmo de confidencialidade determina como os dados são criptografados
pelos componentes do IBM Cognos. Por exemplo, as senhas dos bancos de dados no IBM
Cognos Configuration são criptografadas ao salvar as configurações. O algoritmo
selecionado quando os dados são criptografados também devem estar disponíveis para os
dados para serem criptografados mais tarde.
A disponibilidade dos algoritmos de confidencialidade podem mudar se houver mudanças
em seu ambiente Por exemplo, se o JavaTM Runtime Environment (JRE) foi alterado ou se
outro software de criptografia foi instalado no computador. É necessário verificar se o
Algoritmo de confidencialidade selecionado quando os dados foram criptografados também
está disponível quando desejar acessar os dados.
Se foram feitas mudanças em um computador, como uma atualização no JRE ou a instalação
de um software que atualizou o JRE, isto pode afetar a disponibilidade dos algoritmos de
confidencialidade. Para garantir que os algoritmos e conjuntos de codificação disponíveis
sejam exibidos no IBM Cognos Configuration, baixe e instale o arquivo de política irrestrita
de Java Cryptography Extension (JCE). Para o Java fornecido pela IBM, é possível baixar
Guia de instalação e configuração 241
Capítulo 10: Opções de configuração
o arquivo de política irrestrita de JCE em https://www14.software.ibm.com/webapp/iwm/
web/preLogin.do?source=jcesdk.
● Para ajustar os conjuntos de codificação, em Ciphersuites com suporte, clique na coluna
Valor e no botão Editar .
Remova os conjuntos de codificação que não são aplicáveis e mova os conjuntos
remanescentes para cima ou para baixo na lista para que aqueles conjuntos de codificação
na faixa mais alta estejam na posição mais alta da lista.
Não misture conjuntos de codificação na faixa de 40 a 56 bits com conjuntos de codificação
na faixa de 128 a 168 bits.
● Para mudar o local das chaves de assinatura, em Configurações das chaves de assinatura,
mude a propriedade Localização do banco de chaves de assinatura para o novo local.
● Para mudar o local das chaves de criptografia, em Configurações da chave de criptografia,
mude Localização do banco de chaves de criptografia para o novo local.
● Para usar outra autoridade de certificação, em Configurações da autoridade de certificação,
altere Utilizar CA de terceiros para Verdadeiro.
Também é necessário garantir o uso dos mesmos valores para o parâmetro -k usados nas
propriedades Localização do banco de chaves de assinatura e Localização do banco de
chaves de criptografia.
Para obter mais informações, consulte "Configuração dos componentes do IBM Cognos BI
para utilizar outra autoridade de certificação" (p. 339 ).
6. No menu Arquivo, clique em Salvar.
Se utilizar outro servidor de autoridade de certificação (CA), configure os componentes do IBM
Cognos para usar a CA. Para obter mais informações, consulte "Configuração dos componentes
do IBM Cognos BI para utilizar outra autoridade de certificação" (p. 339 ).
Configuração das definições do provedor de criptografia em uma infraestrutura de segurança Entrust
Para configurar a criptografia em uma infraestrutura de segurança Entrust, substitua o provedor
criptográfico padrão no IBM Cognos Configuration por um provedor configurado para Entrust e,
em seguida, atualize os arquivos de segurança em seu ambiente do IBM Cognos.
Verifique se as senhas dos bancos de chaves correspondem às do Perfil Entrust (EPF)
Para evitar erros de gateway, verifique se a Conta de Convidado da Internet tem permissão de
leitura e gravação para o arquivo .epf do Entrust e permissão de leitura para o arquivo .ual do
Entrust.
Etapas
1. Se estiver usando um JRE diferente do fornecido com o servidor do IBM Cognos, certifique-se
de que os seguintes arquivos do IBM Cognos e Entrust estejam presentes no local onde o JRE
está instalado:
● Em local_c10/bin/jre/versão/lib/ext, copie bcprov-jdk14-134.jar para local_JRE/lib/ext.
242 IBM Cognos Business Intelligence PowerPlay
Capítulo 10: Opções de configuração
● Em local_c10/bin/jre/versão/lib/security, copie local_policy.jar e US_export_policy.jar para
local_JRE/lib/security.
● No Entrust Authority Security Toolkit que foi baixado do Entrust, copie o arquivo .jar,
como enttoolkit.jar, para local_JRE/lib/ext.
2. Para garantir que todos os algoritmos e conjuntos de codificação disponíveis sejam exibidos
no IBM Cognos Configuration, baixe e instale o arquivo de política irrestrita de Java
Cryptography Extension (JCE). Para o Java fornecido pela IBM, é possível baixar o arquivo
de política irrestrita de JCE em https://www14.software.ibm.com/webapp/iwm/web/preLogin.
do?source=jcesdk.
3. Inicie o IBM Cognos Configuration.
4. Na janela Explorer, no grupo Segurança, clique emCriptografia.
5. Na janela Propriedades, em Configurações avançadas de algoritmo, altere o Algoritmo digestpara o algoritmo digest de mensagem adequado ou para o algoritmo hash seguro para a sua
política de segurança.
6. Na janela Explorer, no grupo Segurança e no componente Criptografia, clique com o botão
direito no recurso IBM Cognos e clique em Excluir.
7. No grupo Segurança, clique com o botão direito em Criptografia e em Novo recurso >Provedor.
8. No campo Nome, digite um nome para o serviço de criptografia que está criando.
9. No campo Tipo, clique na seta e em Entruste, em seguida, clique em OK.
Uma ramificação com o nome que você atribuiu aparecerá embaixo de Criptografia.
10. Clique na ramificação criou.
As propriedades de recursos aparecerão na janela de propriedades.
11. Na janela Propriedades, informe os valores apropriados, conforme listado na tabela a seguir.
DescriçãoPropriedade
A localização do arquivo de inicialização (.ini) do Entrust.Localização do arquivo INI
O nome distinto associado ao perfil da identidade do Entrust.Nome distinto de arquivo
de identidade (DN)
A localização do arquivo de perfil (.epf) da identidade do Entrust.Localização do arquivo de
identidade
O parâmetro que controla se os usuários devem digitar uma
senha para fazer logon no Entrust PKI.
Utilizar logon do servidor
Entrust
A senha do Entrust Profile, que deve corresponder à senha no
Entrust Profile (EPF).
Senha do arquivo de
identidade
Guia de instalação e configuração 243
Capítulo 10: Opções de configuração
DescriçãoPropriedade
O nível de criptografia que é necessário para ficar em
conformidade com a política de segurança.
Algoritmo de
confidencialidade
O algoritmo de criptografia a ser usado quando criptografar
dados PDF.
Algoritmo de
confidencialidade PDF
Os conjuntos de codificação que são suportados em seu ambiente
de segurança. Remova os que não se aplicam e reorganize os
conjuntos de codificação restantes do mais alto para o mais
baixo. Isso garante que o conjunto de codificação mais seguro
seja usado primeiro.
Ciphersuites com suporte
A localização do banco de dados de chaves que contém os pares
de chaves de assinatura.
Localização do banco de
chaves de assinatura
A localização do banco de chaves que contém os pares de chaves
de criptografia.
Localização do banco de
chaves de criptografia
Importante: guarde suas senhas em um local seguro.
12. No menu Arquivo, clique em Salvar.
13. Atualize para Entrust Java Toolkit 7.2 SP2 Patch 152842.
Configuração dos componentes do IBM Cognos para uso no IBM CognosApplication Firewall
O IBM® Cognos® Application Firewall analisa e valida as solicitações de HTTP e XML antes de
serem processadas pelos servidores do IBM Cognos. O IBM Cognos Application Firewall pode
modificar essas solicitações de HTTP e XML.
O IBM Cognos Application Firewall protege os produtos web do IBM Cognos de dados mal-
intencionados. As formas mais comuns de dados mal-intencionados são de sobrecargas de buffer
e ataques de scripts de cross-site scripting (XSS), através de injeção de scripts em páginas válidas
ou redirecionamento para outro site.
Com o IBM Cognos Configuration, é possível mudar configurações para outro suporte de ferramenta
XSS, e é possível adicionar nomes de host e domínios à lista do IBM Cognos de nomes válidos.
É possível rastrear atividades de firewall verificando o arquivo de log, que contém solicitações
rejeitadas. Por padrão, as mensagens de log são armazenadas no arquivo local_c10/logs/cogserver.
log.
As configurações do Cognos Application Firewall devem ser iguais em todos os computadores nos
quais os componentes da camada de aplicativos do IBM Cognos estiverem instalados em um
ambiente distribuído. Por exemplo: se o Cognos Application Firewall estiver desativado em alguns
244 IBM Cognos Business Intelligence PowerPlay
Capítulo 10: Opções de configuração
computadores e ativado em outros, poderão ocorrer comportamentos inesperados ou erros no
produto.
Os seguintes tipos de URLs são aceitos pela validação do Cognos Application Firewall:
● URLs totalmente qualificados (absolutos)
no formato protocol://host:port/path, em que o protocolo é http ou https e o host é validado
em relação à lista de domínios válida
● URLs relativos ao diretório de instalação web
no formato /raiz_instalação_web/.* em que raiz_instalação_web é o diretório de gateway web,
baseado no alias ibmcognos configurado em seu servidor web.
Para obter mais informações, consulte "Configuração do servidor web" (p. 171 ).
Por exemplo,
/ibmcognos/ps/portal/images/action_delete.gif
● URLs específicos permitidos, incluindo o seguinte (nenhum diferencia maiúsculas de minúsculas)
about:blank
JavaScript:window.close( )
JavaScript:parent.close( )
JavaScript:history.back( )
parent.cancelErrorPage( )
doCancel( )
Etapas
1. Em cada local onde o IBM Cognos BI Application Tier Components estiver instalado, inicie o
IBM Cognos Configuration.
2. Na janela Explorer, em Segurança, clique em IBM Cognos Application Firewall.
3. Na janela Propriedades, na propriedade Habilitar a validação do CAF, defina os valores
adequados.
Por padrão, o IBM Cognos Application Firewall está ativado.
Importante: o IBM Cognos Application Firewall é um componente essencial da segurança do
IBM Cognos, o que ajuda proteger contra vulnerabilidades de invasão. Desabilitar o IBM
Cognos Application Firewall irá remover esta proteção. Em circunstâncias normais, não desative
o IBM Cognos Application Firewall.
4. Se estiver usando outra ferramenta XSS que verifica caracteres específicos nos parâmetros de
solicitação GET, na janela Propriedades, para a propriedade A verificação XSS de terceiros
está habilitada, altere o valor para Verdadeiro.
Os caracteres padrão que são proibidos incluem >, < e '.
5. Adicione nomes de host e de domínio à lista de nomes válidos do IBM Cognos:
Guia de instalação e configuração 245
Capítulo 10: Opções de configuração
● Na propriedade Domínios ou hosts válidos, clique no valor e no botão de edição .
● Na caixa de diálogo Valor - Domínios ou hosts válidos, clique em Adicionar.
É necessário incluir os domínios de todos os hiperlinks adicionados no IBM Cognos
Connection. Para obter mais informações, consulte o tópico sobre como criar um URL no
Guia de administração e segurança.
Dica: se estiver utilizando um drill through do IBM Cognos Series 7 para relatórios no IBM
Cognos BI, adicione os nomes de host dos servidores de gateway do IBM Cognos Series 7
à lista.
● Na linha em branco da tabela, clique e digite o nome de host ou de domínio.
Para permitir um domínio e todos os seus subdomínios, use um caractere curinga no início
do nome do domínio.
Por exemplo, *.minhaempresa.com
● Repita as duas etapas anteriores marcadas para cada nome a ser adicionado.
● Clique em OK.
O IBM Cognos Application Firewall valida nomes de domínio e de host para proteger os URLs
criados. Por padrão, o IBM Cognos Application Firewall considera que os nomes de domínios
obtidos das propriedades de configuração de ambiente são nomes de domínios seguros. Adicionar
nomes à lista de nomes e hosts válidos é útil quando é preciso redirecionar solicitações para
computadores sem o IBM Cognos, usando as funções Voltar ou Cancelar, ou quando usar o
drill-through em diferentes instalações de produtos IBM Cognos.
6. Salve a configuração.
7. Reinicie os serviços.
Criptografia de propriedades de arquivo temporárioOs arquivos temporários são usados no IBM® Cognos® BI para armazenar relatórios exibidos
recentemente e dados usados pelos serviços durante o processamento. É possível alterar o local dos
arquivos temporários e optar por criptografar seu conteúdo. Por padrão, os componentes do IBM
Cognos armazenam arquivos temporários no diretório local_c10\temp e os arquivos não são
criptografados.
Visando a máxima segurança, não permita nenhum acesso ao diretório temp, exceto para a conta
de serviço utilizada para iniciar o serviço do IBM Cognos. São necessárias permissões de leitura e
gravação para a conta do serviço.
Etapas
1. Inicie o IBM Cognos Configuration.
2. Na janela Explorer, clique em Ambiente.
3. Na janela Propriedades, na propriedade Localização dos arquivos temporários, especifique o
novo local.
246 IBM Cognos Business Intelligence PowerPlay
Capítulo 10: Opções de configuração
4. Se solicitar que o conteúdo de arquivos temporários seja criptografado, configure a propriedade
Criptografar arquivos temporários para Verdadeiro.
5. Certifique-se de que a conta de usuário em que os componentes do IBM Cognos BI são
executados possui os privilégios adequados para o local dos arquivos temporários. Por exemplo:
● Nos sistemas operacionais Microsoft® Windows®: privilégios de controle total.
● Nos sistemas operacionais UNIX® ou Linux®: privilégios de leitura e gravação.
Configuração do gateway para usar um namespaceSe os componentes do IBM® Cognos® utilizarem vários namespaces ou se o acesso anônimo for
ativado e os componentes do IBM Cognos usarem um namespace, é possível configurar o gateway
para que se conecte a um namespace. Os usuários logados no servidor web em que o gateway está
localizado não são avisados para escolher uma fonte de autenticação.
Por exemplo, se tiver dois servidores web, é possível configurar cada servidor web para usar um
namespace diferente.
Etapas
1. No computador em que o gateway está localizado, inicie o IBM Cognos Configuration.
2. Na janela Explorer, clique em Ambiente.
3. Na janela Propriedades, na caixa Valor ao lado da propriedade Namespace do gateway, digite
a ID do namespace que deseja usar.
4. No menu Arquivo, clique em Salvar.
5. Reinicie seu servidor web.
Ativação e desativação de serviçosEm uma instalação de distribuição, é possível enviar certos tipos de solicitações para computadores
específicos ativando ou desativando os serviços instalados.
Por exemplo, para dedicar um computador a executar e distribuir relatórios, é possível desativar
os serviços em um computador com Application Tier Components. Para indicar que um computador
em uma instalação distribuída para processar solicitações do aplicativo Metric Studio, desative o
Serviço de integração de dados no computador.
Observação: os valores padrão para o serviço do distribuidor e o serviço de apresentação são falsos
em computadores que têm somente o Content Manager instalado. Em todos os outros tipos de
instalação, os valores padrão são verdadeiros.
Se foram instalados todos os componentes em diversos computadores, é possível desativar serviços
adequados em cada computador para obter a configuração de distribuição solicitada. Solicitações
são enviadas somente para distribuidores em que dado serviço é ativado.
Guia de instalação e configuração 247
Capítulo 10: Opções de configuração
Desativar um serviço impede-o de carregar na memória. Ao serem desativados, os serviços não são
iniciados e em conseqüência não consomem recursos. O serviço virtual não executa até que seja
ativado.
Se desativar o serviço do distribuidor, os serviços relacionados ao distribuidor são desativados.
Somente os serviços do distribuidor que são ativados podem processar solicitações.
Etapas
1. Início do IBM® Cognos® Configuration.
2. Na janela Explorer, em Ambiente, clique em Serviços do IBM Cognos.
3. Na janela Propriedades, clique em Valor próximo ao serviço que deseja ativar ou desativar.
Por padrão, todos os serviços estão ativados.
4. Clique no estado adequado para os serviços:
● Para desativar o serviço, clique em Falso.
● Para ativar o serviço, clique em Verdadeiro.
5. No menu Arquivo, clique em Salvar.
Configuração de fontesOs componentes do IBM® Cognos® utilizam fontes para processar relatórios em PDF no servidor
do IBM Cognos. Os componentes do IBM Cognos também utilizam fontes para processar gráficos
usados nos relatórios em PDF e HTML.
Para mostrar a saída corretamente, as fontes devem estar disponíveis onde o relatório ou gráfico
são processados. No caso de gráficos e relatórios em PDF, as fontes devem ser instaladas no servidor
do IBM Cognos. Caso a fonte solicitada não esteja disponível, os componentes do IBM Cognos a
substituirão por outra.
Devido ao fato de que os relatórios em HTML são processados em um navegador, as fontes
solicitadas devem ser instaladas no computador de cada usuário do IBM Cognos que irá ler o
relatório em HTML. Caso uma fonte solicitada não esteja disponível, o navegador a substituirá
por uma fonte diferente.
Utilizar a lista de verificação a seguir se desejar utilizar uma nova fonte nos relatórios
❑ Adição da fonte à lista de fontes suportadas.
❑ Especificação do local do arquivo da nova fonte.
❑ Mapeamento da nova fonte para o nome da fonte física, se solicitado.
Adição de fontes ao ambiente do IBM Cognos
É possível adicionar fontes à lista de fontes compatíveis com o ambiente do IBM® Cognos® se desejar
gerar relatórios que utilizem fontes não disponíveis atualmente. Também é possível remover fontes.
248 IBM Cognos Business Intelligence PowerPlay
Capítulo 10: Opções de configuração
Por padrão, os componentes do IBM Cognos utilizam um conjunto de fontes globais, que estão
disponíveis em todos os computadores do servidor do IBM Cognos.
Etapas
1. Em cada computador com o Content Manager, inicie o IBM Cognos Configuration.
2. No menu Ações, clique em Editar Configuração Global.
3. Clique na guia Fontes.
4. Clique em Adicionar.
Dica: para remover uma fonte de uma lista de fontes compatíveis, clique na caixa próxima ao
nome da fonte e depois clique em Remover.
5. Na caixa Nome da Fonte com Suporte, digite o nome da fonte e clique em OK.
6. No menu Arquivo, clique em Salvar.
Todas as fontes globais, inclusive as recém-adicionadas, devem ser instaladas em todos os
computadores do ambiente com o IBM Cognos.
Se uma fonte global não está instalada em todos os computadores com o IBM Cognos, é necessário
fazer o mapeamento da fonte global para uma fonte instalada e física.
Especificação do local das fontes disponíveis
É necessário especificar o local de instalação de todas as fontes, incluindo aquelas que foram
adicionadas à lista de fontes suportadas.
Por padrão, a lista de fontes consiste em fontes instaladas no diretório local_c10\bin\fonts do
computador com o IBM® Cognos®. Se os componentes do IBM Cognos estiverem instalados em
um computador com sistema operacional Microsoft® Windows®, eles também utilizarão as fontes
instaladas no diretório de fontes do Windows.
Você especifica o local da fonte em todos os computadores em que o Application Tier Components
está instalado.
Etapas
1. Em cada computador com Application Tier Components, inicie o IBM Cognos Configuration.
2. Na janela Explorer, clique em Ambiente.
3. Na janela Propriedades, na propriedade Localizações de fontes físicas, especifique o local das
fontes.
Se houver diversos caminhos de fontes, separe cada caminho por um ponto-e-vírgula (;).
Se estiver usando um servidor de aplicativos que não o Tomcat, digite o caminho totalmente
qualificado para o local da fonte. Por exemplo: local_c10/bin/fonts.
4. No menu Arquivo, clique em Salvar.
Guia de instalação e configuração 249
Capítulo 10: Opções de configuração
Mapeamento de fontes suportadas para fontes instaladas
É possível substituir fontes globais, que não estão instaladas no computador, por fontes físicas.
Mapeie as fontes em cada computador onde o Application Tier Components estejam instalados.
Por exemplo, adicione uma fonte à lista de fontes compatíveis que não esteja instalada no computador
com IBM® Cognos®. É possível especificar qual fonte usar como substituto.
Se desejar imprimir relatórios mais rápido usando as fontes de PDF integradas, mapeie uma fonte
global como Arial para uma das fontes de PDF integradas, como Helvetica-PDF, seguindo as etapas
abaixo. Também é possível selecionar uma das fontes de PDF integradas para um objeto de texto
no Report Studio ou no Query Studio. Para obter mais informações, consulte o Guia do usuário
do Query Studio ou o Guia do usuário do Report Studio.
Nenhum mapeamento é necessário se adicionar um fonte à lista de fontes suportadas que estão
instaladas nos computadores com IBM Cognos. Entretanto, é preciso especificar a localização das
fontes.
Etapas
1. Em cada computador com Application Tier Components, inicie o IBM Cognos Configuration.
2. Na janela Explorer, clique em Ambiente.
3. Na janela Propriedades, clique na caixa de diálogo Valor próxima à propriedade Mapa de
fontes físicas e clique no botão de edição .
A caixa de diálogo Valor - Mapa de fontes físicas aparece.
4. Clique em Adicionar.
Dica: para remover uma fonte, marque a caixa de seleção próxima à fonte e clique em Remover.
5. Na caixa de diálogo Nome da Fonte Global, digite o nome da fonte adicionada à lista de fontes
suportada.
6. Clique na caixa Nome da Fonte Física.
7. Se souber o nome da fonte física, digite-o. Caso contrário, clique no botão de edição . Na
caixa de diálogo Nome da Fonte Física, clique em Pesquisar Agora e clique em um nome de
fonte nos resultados.
8. Repita as etapas 4 a 7 para cada fonte global que necessita de mapeamento.
9. Clique em OK.
10. No menu Arquivo, clique em Salvar.
Agora, se necessário, especifique a localização de instalação das fontes.
Considerações sobre o suporte ao chinês simplificadoOs produtos IBM® Cognos® BI suportam o conjunto de caracteres GB18030-2000, que é utilizado
na codificação das localidades do chinês simplificado. Se for realizada uma instalação no Windows®,
250 IBM Cognos Business Intelligence PowerPlay
Capítulo 10: Opções de configuração
é fornecido suporte para o conjunto de caracteres GB18030-2000 na fonte NSimSun-18030 fornecida
pela Microsoft®. Se instalar em outros sistemas operacionais ou se usar o Internet Explorer 6 no
Windows, são necessárias tarefas adicionais de instalação:
❑ Em sistemas operacionais que não o Windows, é necessário instalar uma fonte que suporte o
GB18030-2000.
❑ Se usar o Internet Explorer 6 no Windows, é necessário atualizar as entradas de registro para
fontes referentes ao SimSun.
Atualização das entradas de registro para os vínculos da fonte do WindowsO conjunto de caracteres GB18030-2000 inclui os caracteres CJK de ideogramas unificados de
extensão A. Quando esses caracteres são codificados como UTF-8 no Internet Explorer 6, podem
não aparecer corretamente em páginas web. Para garantir que esses caracteres apareçam
corretamente, é necessário adicionar SimSun-18030 a todas as entradas de registro de vínculos de
fonte que especifiquem o SimSun.
Etapas
1. No menu Iniciar, selecione Executar.
2. Na caixa de diálogo Executar, digite regedit.
3. Abra o diretório HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\
CurrentVersion\FontLink\SystemLink.
4. Em Editor do Registro, clique com o botão direito em uma fonte que contenha SimSun no
campo Dados e selecione Modificar.
5. Na caixa de diálogo Editar seqüência múltipla, em Dados do valor, clique nas cadeias
selecionadas e digite a seguinte cadeia:
SimSun18030.ttc,SimSun-18030
6. Clique em OK.
7. Repita as etapas de 4 a 6 para cada fonte que contenha SimSun.
8. Quando estiver completo, feche o Editor do Registro.
Alteração da fonte padrão para relatórios em PDFÉ possível alterar a fonte padrão utilizada pelos componentes do IBM® Cognos® BI para relatórios
em PDF. A seguinte fonte padrão é exibida ao abrir um relatório.
Altera-se a fonte padrão no computador em que o Content Manager está instalado. Após ter feito
a alteração, a fonte se torna o padrão para todos os computadores em sua instalação. Altera-se a
fonte usada para relatórios em PDF com o IBM Cognos Configuration.
Guia de instalação e configuração 251
Capítulo 10: Opções de configuração
Certifique-se de que a fonte padrão esteja instalada em todos os computadores com o IBM Cognos.
Etapas
1. Em cada computador com o Content Manager, inicie o IBM Cognos Configuration.
2. No menu Ações, clique em Editar Configuração Global.
3. Clique na guia Geral.
4. Na caixa de diálogo Valor, em Fonte padrão, digite a fonte que deseja utilizar como o padrão
para relatórios.
5. Clique em OK.
6. No menu Arquivo, clique em Salvar.
7. Em todos os computadores com o Application Tier Components, certifique-se de que o local
de instalação da fonte padrão esteja especificado na propriedade Localizações de fontes físicas
(em Ambiente, na janela Explorer ) ou que a fonte esteja no diretório de fontes do Windows®
.
Configuração de fontes incorporadas a relatórios em PDFQuando um relatório em PDF é aberto no Adobe® Reader, todas as fontes usadas nesse relatório
devem estar disponíveis. As fontes devem estar incorporadas ao relatório ou instaladas no
computador do usuário. Se uma fonte não estiver disponível em algum desses locais, o Adobe Reader
tenta substituir uma fonte adequada. Essa substituição pode causar alterações na apresentação do
relatório ou alguns caracteres podem não ser exibidos.
Para garantir que relatórios em PDF apareçam corretamente no Adobe Reader, o IBM Cognos BI
incorpora as fontes solicitadas em relatórios por padrão. Para minimizar o tamanho do arquivo, o
IBM Cognos BI incorpora somente os caracteres (também chamados glifos) usados no relatório em
vez de todos os caracteres na definição da fonte. O IBM Cognos BI incorpora fontes somente se
estiverem licenciadas para o incorporação. As informações de licença são armazenadas na própria
fonte e são lidas pelo IBM Cognos BI.
Se tiver certeza de que as fontes usadas nos relatórios estão disponíveis nos computadores dos
usuários, é possível limitar ou eliminar fontes incorporadas para reduzir o tamanho dos relatórios
em PDF. Ao limitar as fontes, especifica-se se uma fonte é incorporada com muita ou pouca
freqüência, usando uma lista de fontes incorporadas no IBM Cognos Configuration.
Etapas
1. No computador com o Content Manager, inicie o IBM® Cognos® Configuration.
2. Na janela Explorer, clique em Ambiente.
3. Na janela Propriedades, em Configurações de fontes, clique no valor de Fontes a serem
incorporadas (serviço de relatório em batch) ou de Fontes a serem incorporadas (serviço de
relatórios), e depois clique no botão de edição .
252 IBM Cognos Business Intelligence PowerPlay
Capítulo 10: Opções de configuração
4. Se não estiver usando o diretório de fontes padrão ou se desejar adicionar um caminho para
um diretório adicional, na caixa de diálogo Fontes a Serem Incorporadas nos Relatórios no
Formato PDF, especifique o novo caminho na caixa de diálogo de caminhos de fontes.
Dica: clique em Buscar Agora para obter uma lista de fontes disponíveis no caminho especificado.
5. Para uma fonte que estará sempre disponível nos computadores dos usuários, role a tela até o
nome da fonte e clique na caixa de seleção Nunca.
O IBM Cognos BI não incorpora a fonte a nenhum relatório. O Adobe Reader escolhe a fonte
do computador do usuário quando o relatório é aberto.
6. Para uma fonte que pode não estar sempre disponível nos computadores dos usuários, role a
tela até o nome da fonte e clique na caixa de seleção Sempre.
O IBM Cognos BI incorpora a fonte a todos os relatórios que a utilizam. O Adobe Reader usa
a fonte incorporada quando o relatório é aberto.
7. Clique em OK.
Saída de relatório salvoPor padrão, os arquivos de saída de relatório são salvos no armazenamento de conteúdo. É possível
optar por salvar uma cópia da saída do relatório em outro local de arquivo que esteja fora ou dentro
do IBM® Cognos® BI. Se usar esta opção, um arquivo descritor com a extensão an _descr também
é salvo. Os arquivos salvos não são gerenciados pelo IBM Cognos BI.
Gravação de saídas de relatórios fora do IBM Cognos BI
Se for configurada uma localização de sistema de arquivos que esteja fora do IBM® Cognos® BI,
então é possível compartilhar a saída de relatório com aplicativos externos ou pessoas que não
tenham o IBM Cognos BI. É assim que se salva a maioria dos arquivos de saída de relatório.
Para usar este recurso, primeiro é necessário configurar um diretório raiz no IBM Cognos
Configuration. O administrador deve então definir o local do arquivo no IBM Cognos
Administration. Para obter mais informações, consulte o tópico sobre como definir um local de
arquivo para a saída de relatório salva fora do IBM Cognos BI, no Guia de administração e
segurança.
Etapas
1. Crie um diretório para o sistema de arquivos.
Dica: verifique se o diretório está acessível para usuários e separado do diretório de instalação.
Por exemplo, em uma instalação distribuída no Microsoft® Windows®, use uma pasta de
arquivos como \\nomeservidor\diretório.
2. Em cada computador com Content Manager, inicie o IBM Cognos Configuration.
3. No menu Ações, clique em Editar Configuração Global.
4. Na janela Configuração global, clique na guia Geral.
5. Para Raiz do sistema de arquivos da localização de arquivos, digite um URI usando o formato
Guia de instalação e configuração 253
Capítulo 10: Opções de configuração
arquivo://diretório
em que diretório é o diretório criado na etapa 1.
A parte arquivo:// do URI é necessária. Podem ser usados nomes UNC do Windows, como
\\nome_do_servidor\diretório. Se for o caso, o URI deve ser formatado como segue:
arquivo://\\nome_do_servidor\diretório
6. Para confirmar que o local correto será usado, clique em Testar.
7. Clique em OK.
8. No menu Arquivo, clique em Salvar.
O administrador agora deve configurar o local do arquivo. Para obter mais informações, consulte
o tópico sobre como definir um local de arquivo para a saída de relatório salva fora do IBM
Cognos BI, no Guia de administração e segurança.
Gravação de saídas de relatórios dentro do IBM Cognos BI
Se for configurado um local de sistema de arquivos dentro do IBM® Cognos® BI, então é possível
utilizar a saída de relatório novamente. Isto pode ser útil também para a finalidade de arquivamento,
pois os arquivos salvos no Armazenamento de conteúdo podem ser excluídos regularmente devido
a regras de retenção.
Para usar este recurso, primeiro é necessário ativar a propriedade Salvar saídas de relatórios em
um sistema de arquivos no IBM Cognos Configuration. O administrador deve então definir o local
do arquivo usando o parâmetro CM.OutPutLocation no IBM Cognos Administration. Para obter
mais informações, consulte o tópico sobre como definir um local de arquivo para a saída de relatório
salva dentro do IBM Cognos BI, no Guia de administração e segurança.
Para proteger a segurança da saída de relatório quando usar esse recurso, o sistema de arquivos
deve ter criptografia de terceiros.
Etapas
1. Crie um diretório para o sistema de arquivos.
Dica: certifique-se de que o diretório esteja acessível somente para usuários autorizados.
2. Em cada computador com Content Manager, inicie o IBM Cognos Configuration.
3. Na janela Explorer, clique em Acesso a dados > Content Manager.
4. Na propriedade Salvar saídas de relatórios em um sistema de arquivos, clique em Verdadeiro.
5. Para testar a conexão com o diretório de saída de relatório, no menu Ações, clique em Testar.
6. No menu Arquivo, clique em Salvar.
O administrador agora deve configurar o local do arquivo usando o parâmetro CM.OutPutLocation.
Para obter informações, consulte o tópico sobre como definir um local de arquivo para saída de
relatório salva dentro do IBM Cognos BI, no Guia de administração e segurança.
254 IBM Cognos Business Intelligence PowerPlay
Capítulo 10: Opções de configuração
Alterando o Local da Saída de Relatórios TemporáriosQuando os usuários executam relatórios interativos, a saída do relatório será armazenada no
Content Manager ou em um cache de sessão temporária no sistema local do arquivo de relatórios.
Como padrão, o local do cache da sessão temporária no sistema do arquivo de relatórios é
local_c10/temp/Session. O diretório Sessão é criado pelo servidor do relatório quando a primeira
solicitação da sessão do usuário é recebida. É possível alterar o local do cache de sessão temporário
para um computador remoto como diretório compartilhado em um sistema baseado no Microsoft®
Windows® ou em um diretório montado comum em um sistema baseado no UNIX® ou Linux®.
Para configurar se a saída dos relatórios temporários é armazenada no Content Manager ou no
sistema local do arquivo de relatórios, consulte o tópico sobre o armazenamento de arquivos da
sessão do usuário em um sistema local do arquivo de relatórios no Guia de Administração e
Segurança.
Etapas
1. No computador onde o Application Tier Components foi instalado, inicie o IBM® Cognos®
Configuration.
2. Na janela Explorer, clique em Ambiente.
3. Na janela Propriedades, clique no valor referente à Localização dos arquivos temporários e,
em seguida, clique no botão Editar .
4. Na caixa de diálogo Selecionar pasta, use a caixa Salvar em para localizar o computador e o
diretório e, em seguida, clique em Selecionar.
5. No menu Arquivo, clique em Salvar.
Quando um usuário executa uma sessão de relatório interativa, a saída de relatórios temporários
será armazenada no novo local.
Alteração do banco de dados de notificaçãoPor padrão, o servidor de notificações usa o mesmo banco de dados que o Content Manager usa
para o armazenamento de conteúdo. É possível usar um banco de dados separado para notificações
em situações em que se executa um grande volume de relatórios em lote e e-mails.
Usar um banco de dados separado para notificações compreende as seguintes tarefas:
❑ Configure um banco de dados de notificação.
Para DB2, Oracle, Microsoft® SQL Server ou Sybase, use o mesmo procedimento usado para
criar o banco de dados de armazenamento de conteúdo.
Para DB2 em z/OS, use as instruções em "Configurações sugeridas para criar um banco de
dados de notificação para DB2 em z/OS" (p. 256 ).
❑ Configure a conectividade do banco de dados.
Guia de instalação e configuração 255
Capítulo 10: Opções de configuração
É possível usar o mesmo procedimento usado para configurar a conectividade do banco de
dados do armazenamento de conteúdo, "Configuração da conectividade de banco de dados
para o banco de dados de armazenamento de conteúdo" (p. 97 ).
❑ Alterar as propriedades de conexão para o banco de dados de notificação.
Configurações sugeridas para criar um banco de dados de notificação para DB2em z/OS
O banco de dados criado para o banco de dados de notificação deve conter as definições de
configuração especificadas.
Para garantir uma instalação com sucesso, siga as seguintes diretrizes ao criar o banco de dados de
notificação.
Utilize a seguinte lista de verificação para ajudá-lo a configurar o banco de dados de notificação
no DB2 em z/OS®.
❑ Crie uma instância do banco de dados, um grupo de armazenamento e uma conta de usuário
para o banco de dados de notificação.
O usuário deve ter permissões para criar e excluir tabelas no banco de dados.
O IBM® Cognos® BI usa as credenciais da conta do usuário para se comunicar com o servidor
do banco de dados.
❑ Certifique-se de reservar um pool de buffer com um tamanho de página de 32 k e um segundo
com um tamanho de página de 4 k para a instância do banco de dados.
❑ Os administradores devem executar um script para criar espaços de tabelas para manter objetos
grandes e outros dados para o banco de dados de notificação a fim de usar esses espaços de
tabelas.
Para obter mais informações sobre como executar o script, consulte "Criação de tablespaces
para o banco de dados de notificação DB2 em z/OS" (p. 256 ).
❑ O administrador do banco de dados deve fazer o backup dos bancos de dados do IBM Cognos
BI regularmente, pois estes contêm os dados do IBM Cognos.
Para garantir a segurança e integridade dos bancos de dados, proteja-os de acesso não autorizado
ou inadequado.
Criação de tablespaces para o banco de dados de notificação DB2 em z/OSO administrador do banco de dados deve executar scripts para criar um conjunto de espaços de
tabelas necessários para o banco de dados de notificação. Os scripts devem ser alterados para
substituir os parâmetros de espaço reservado com os adequados a seu ambiente.
256 IBM Cognos Business Intelligence PowerPlay
Capítulo 10: Opções de configuração
Verifique se está usando as convenções de nomes para DB2 em z/OS. Por exemplo, todos os nomes
de parâmetros devem começar com uma letra e o tamanho não pode exceder oito caracteres. Para
obter mais informações, consulte o IBM® DB2 Information Center.
Etapas
1. Conecte-se ao banco de dados como um usuário com privilégios para criar e arrastar tablespaces
e para permitir a execução de instruções SQL.
2. Vá até o diretório que contém os scripts:
local_c10/configuration/schemas/content/db2zOS
3. Abra o arquivo de script NC_TABLESPACES.sql e use a tabela a seguir para ajudá-lo a substituir
os parâmetros genéricos com os adequados a seu ambiente.
DescriçãoNome do parâmetro
Especifica o nome do banco de dados de notificação.NCCOG
Especifica o nome do grupo de armazenamento.DSN8G810
Especifica o nome do pool de buffer.BP32K
Nem todos os parâmetros listados estão no script, mas podem ser adicionados no futuro.
4. Salve e execute o script.
5. Abra o arquivo de script NC_CREATE.sql e substitua o parâmetro de espaço reservado NCCOG
pelo nome do banco de dados da notificação.
6. Salve o script.
Os serviços de trabalho e monitor de programação executarão o script automaticamente. No
entanto, você mesmo pode executá-lo.
O banco de dados de notificação foi criado. Agora é possível alterar o banco de dados de notificação
no IBM Cognos® Configuration (p. 257 ).
Alteração das propriedades de conexão para o banco de dados de notificaçãoDepois de criar um banco de dados separado para notificação, é necessário configurar os
componentes do IBM® Cognos® para usar o novo banco de dados.
É necessário configurar todos os Content Managers e Application Tier Components para utilizar
o mesmo banco de dados de notificação.
Etapas
1. Em cada local onde o Content Manager ou os Application Tier Components estão instalados,
inicie o IBM Cognos Configuration.
2. Na janela Explorer, em Acesso a dados, clique em Notificação.
Guia de instalação e configuração 257
Capítulo 10: Opções de configuração
3. Identifique o banco de dados usado para notificação:
● Na janela Explorer, clique com o botão direito em Notificação e selecione Novo recurso
> Banco de dados.
● Digite um nome para o recurso do banco de dados.
● Selecione o tipo de banco de dados do menu suspenso.
● Clique em OK.
4. Na janela Propriedades, insira os valores para o recurso de banco de dados de notificação.
5. No menu Arquivo, clique em Salvar.
6. Teste a notificação. Na janela Explorer, clique com o botão direito em Notificação e clique em
Testar.
Esse procedimento testa a conexão do banco de dados e do servidor de correio.
Se o banco de dados de armazenamento de conteúdo estava sendo usado para notificação, as
programações serão replicadas nas tabelas do novo banco de dados de notificação.
Verifique se os valores usados para identificar o recurso do banco de dados de notificação são os
mesmos em todos os computadores com Content Manager e Application Tier Components. Para
usar o banco de dados de notificação padrão, não é necessário editar os valores na janela
Propriedades.
Criação de um novo armazenamento de conteúdo utilizando obanco de dados de conteúdo do Cognos
Siga as etapas abaixo se desejar criar outro banco de dados de armazenamento de conteúdo com
o Banco de dados de conteúdo do Cognos. Isso pode ser necessário caso seja instalada mais de uma
instância do produto IBM® Cognos® no local de teste e se deseje executar as instâncias
separadamente.
Use o Banco de Dados de Conteúdo do Cognos apenas para testes ou demonstrações. O Banco de
Dados de Conteúdo do Cognos coloca um sistema de teste para funcionar rapidamente. Ao ir para
um ambiente de produção com o produto IBM Cognos, configure o armazenamento de conteúdo
para usar um banco de dados compatível que pode ser protegido e ter o desempenho ajustado.
Antes de criar o novo armazenamento de conteúdo, faça o seguinte:
● Instale a instância adicional do produto IBM Cognos em um diretório separado no mesmo
computador.
Certifique-se de selecionar Banco de dados de conteúdo do Cognos na página Seleção do
componente do assistente de instalação.
258 IBM Cognos Business Intelligence PowerPlay
Capítulo 10: Opções de configuração
● Crie um novo usuário e senha para o novo banco de dados de armazenamento de conteúdo.
Etapas
1. No local onde foi instalada a nova instância do Banco de dados de conteúdo do Cognos, no
diretório local_c10/derby10.1.2.1/bin, utilize o script ij.bat ou ij.ksh para criar um novo banco
de dados.
Utilize a seguinte sintaxe:
connect 'jdbc:derby://host:port/db_name;create=true;user=username; password=password';
Certifique-se de utilizar um nome, um usuário e uma senha diferente para o novo armazenamento
de conteúdo.
Por exemplo, para criar um banco de dados chamado contentstore2 no computador localhost
na porta número 1527 como um usuário chamado cognos2 com uma senha cognos2, digita-se
connect 'jdbc:derby://localhost:1527/contentstore2;create=true;user=cognos2;
password=cognos2';
O nome do banco de dados faz distinção entre maiúsculas e minúsculas.
Os arquivos do banco de dados estão localizados no diretório local_c10\contentstore.
2. Quando você terminar de usar o utilitário ij, desconecte através do seguinte comando:
desconectar;
Configuração do protocolo SSLO protocolo de camada de soquetes de segurança (SSL) é utilizado para proteger a comunicação
entre os componentes do IBM® Cognos® instalados no mesmo computador ou em computadores
diferentes.
Além disso, pode-se desejar configurar conexões SSL entre os componentes do IBM Cognos e outros
servidores. É necessário verificar se esse SSL está configurado para outros servidores, antes de
configurar uma confiança compartilhada entre os componentes do IBM Cognos e os outros
servidores.
Utilizar a lista de verificação a seguir para configurar o protocolo SSL.
❑ Configure o SSL para os componentes do IBM Cognos (p. 260 ).
❑ Configure a confiança compartilhada entre os componentes do IBM Cognos e os outros
servidores, se necessário (p. 262 ).
❑ Selecione e classifique os conjuntos de codificação que serão utilizados na conexão SSL, se
necessário (p. 263 ).
❑ Ative o SSL no servidor web (p. 264 ).
Após configurar o protocolo SSL, pode-se selecionar e classificar conjuntos de codificação, que
controlam a qualidade de proteção usada na conexão SSL.
Guia de instalação e configuração 259
Capítulo 10: Opções de configuração
Configure o SSL para os componentes do IBM CognosÉ possível configurar os componentes do IBM® Cognos® para usar o protocolo SSL para
● Somente conexões internas.
● Somente conexões externas.
● Conexões internas e externas.
● Conexões para servidores de log locais e remotos.
Se configurar o SSL somente para conexões internas, os componentes do IBM Cognos no computador
local se comunicam usando este protocolo. O distribuidor procura conexões seguras em uma porta
diferente em relação às solicitações remotas, http. Desta forma, é necessário configurar dois URIs
de distribuidor.
Se configurar o SSL somente para conexões externas, as comunicações dos componentes remotos
do IBM Cognos no computador local usam o protocolo SSL. É necessário configurar o distribuidor
para procurar por solicitações seguras e remotas em uma porta diferente em relação a solicitações
locais, HTTP. Também é necessário configurar os URIs do Content Manager e do distribuidor para
aplicativos externos usarem o mesmo protocolo e porta que o distribuidor local.
Se configurar o SSL para todas as conexões, o distribuidor pode usar a mesma porta para conexões
internas e externas. Da mesma forma, se não usar o SSL para a comunicação local ou remota, o
distribuidor pode usar a mesma porta para todas as comunicações.
Deve-se também atualizar os URIs do Content Manager, o URI do distribuidor para aplicativos
externos e o URI do gateway para usar o SSL, se solicitado.
Conectores Tomcat
Se o URI do distribuidor interno tiver um prefixo de http mas o URI do distribuidor externo tiver
https, ou vice-versa, os conectores diferente de SSL Coyote HTTP/1.1 e SSL Coyote HTTP/1.1 são
ativados no arquivo server.xml.
Se os URIs do distribuidor externo e interno usam portas ou protocolos diferentes, a porta do
distribuidor interno fica acessível somente para os componentes no computador local. O URI do
distribuidor interno também deve especificar o localhost.
Instalações de computadores individuais
Em instalações de computadores individuais, se estiver executando o IBM Cognos sem o SSL, será
necessário interromper o serviço antes de adicionar o SSL à sua configuração. Após ter salvado as
configurações com as definições de SSL, pode-se reiniciar o serviço.
Instalações distribuídas
Em instalações distribuídas, se estiver usando o serviço de autoridade de certificação do IBM Cognos,
é necessário configurar todos os computadores com o IBM Cognos para usar o protocolo não
seguro (http) antes de configurar os componentes do IBM Cognos para usar o protocolo SSL. É
necessário proceder deste modo pois não é possível definir o protocolo SSL antes que a confiança
tenha sido estabelecida.
260 IBM Cognos Business Intelligence PowerPlay
Capítulo 10: Opções de configuração
Além disso, certifique-se de seguir a ordem solicitada de configuração de computadores em um
ambiente distribuído. Isto significa que é necessário primeiro configurar o computador em que o
Content Manager ativo padrão está instalado, e em seguida iniciar os serviços nesse computador
antes de configurar ou iniciar serviços em outros computadores. Configurando primeiro o
computador com o Content Manager ativo padrão e iniciando os serviços, garante-se que o serviço
de autoridade de certificação nesse computador possa emitir certificados para outros computadores
no ambiente do IBM Cognos.
Depois de configurar todos os computadores na instalação distribuída para usar o protocolo padrão
não-seguro, teste a instalação para garantir que os componentes do IBM Cognos estejam funcionando
corretamente. Após testar sua instalação, configure o protocolo SSL.
Ao configurar o IBM Cognos para usar o protocolo SSL, verifique se configurou primeiro o
computador ativo padrão com o Content Manager para usar o protocolo e inicie os serviços nesse
computador. Após ter feito isto, configure o protocolo SSL em outros computadores com o IBM
Cognos em seu ambiente.
Adição de um computador a uma instalação
Se adicionar um computador a um ambiente com o SSL ativado, aparecerá um aviso para aceitar
temporariamente a confiança para um certificado ao salvar as configurações. Aceitar o certificado
temporário permitirá que a confiança permanente seja estabelecida com o computador com o
Content Manager.
Adição de componentes a um computador
É possível adicionar um componente mais tarde ao mesmo local de outros componentes do IBM
Cognos. Se adicionar um componente a um local diferente no mesmo computador que outros
componentes do IBM Cognos, aparecerá um aviso para aceitar temporariamente a confiança para
um certificado ao salvar as configurações. Aceitar o certificado temporário permitirá que a confiança
permanente seja estabelecida entre o novo componente e o computador com o Content Manager.
Etapas
1. Inicie o IBM Cognos Configuration.
2. Na janela Explorer, clique em Ambiente.
3. Na janela Propriedades, digite os valores adequados para a URI do distribuidor interno e para
a URI do distribuidor externo:
● Para configurar o SSL somente para conexões internas, na propriedade URI do distribuidor
interno digite https e uma porta para a comunicação SSL. Na propriedade URI do
distribuidor externo, digite http a use a porta padrão ou alguma outra disponível.
Caso use Tomcat, a propriedade URI do distribuidor interno deve também especificar o
localhost.
As portas dos dois URIs do distribuidor devem ser diferentes.
● Para configurar o SSL somente para conexões internas, na propriedade URI do distribuidor
interno digite https e uma porta segura. Na propriedade URI do distribuidor interno, digite
http a use a porta padrão ou alguma outra disponível.
Guia de instalação e configuração 261
Capítulo 10: Opções de configuração
Caso use Tomcat, a propriedade URI do distribuidor interno deve também especificar o
localhost.
As portas dos dois URIs do distribuidor devem ser diferentes.
● Para configurar o SSL para todas as conexões, digite o mesmo URI para as propriedades
URI do distribuidor interno e URI do distribuidor externo. Digite https e uma porta segura,
como 9343.
Observação: Não é necessário usar a porta 9343, a porta padrão do SSL. Escolha qualquer
porta disponível.
4. Configure o protocolo SSL para outros URIs do ambiente, incluindo URIs do ContentManager,
URI do distribuidor para aplicativos externos e URI do gateway.
● Somente para conexões internas, digite https nos URIs que contêm localhost.
● Somente para conexões externas, digite https nos URIs que não contêm localhost.
● Para todas as conexões, digite https em todos os URIs.
5. Na janela Explorer, clique em Segurança > Criptografia.
6. Para usar o protocolo SSL, é necessário especificar senhas para os armazenamentos de chaves
de criptografia do IBM Cognos. Há mais configurações em Segurança >Criptografia >Cognos.
7. No menu Arquivo, clique em Salvar.
Configuração de confiança compartilhada entre os servidores do IBM Cognos eoutros servidores
Se desejar usar a autoridade de certificação padrão do IBM® Cognos® e o SSL para conexões de
outros servidores com os servidores do IBM Cognos, adicione o certificado do IBM Cognos ao
armazenamento de confiança nos outros servidores.
Observação: se usar navegadores para se conectar aos componentes do IBM Cognos, estes avisam
automaticamente os usuários para atualizar os armazenamentos confiáveis.
Se desejar que a conexão entre os servidores do IBM Cognos e outro servidor seja autenticada
mutuamente, também é necessário copiar a autoridade de certificação ao armazenamento confiável
dos servidores do IBM Cognos.
Se tiver configurado os componentes do IBM Cognos para utilizar outra autoridade de certificação
(CA), não será preciso configurar a confiança compartilhada entre o servidor do IBM Cognos e
outros servidores.
Etapas para copiar o certificado do IBM Cognos para outro servidor
1. Acesse o diretório local_c10/bin.
2. Extraia os certificados do IBM Cognos digitando o seguinte comando:
● No UNIX® ou no Linux®, digite
262 IBM Cognos Business Intelligence PowerPlay
Capítulo 10: Opções de configuração
ThirdPartyCertificateTool.sh -E -T -r arquivo_destino -k local_c10/configuration/
signkeypair/jCAKeystore -p senha
● No Windows®, digite
ThirdPartyCertificateTool.bat -E -T -r arquivo_destino -k local_c10\configuration\
signkeypair\jCAKeystore -p senha
3. Importe o certificado para o armazenamento confiável em seu servidor.
Para obter informações em como atualizar o armazenamento confiável, consulte a documentação
de seu servidor.
Etapas para copiar o certificado CA nos servidores do IBM Cognos
1. Copie o certificado de sua autoridade de certificação para em um local seguro no servidor do
IBM Cognos.
Verifique se a autoridade de certificação CA está no formato X.509 codificado na base 64.
2. Importe a autoridade de certificação CA digitando o seguinte comando:
● No UNIX ou Linux, digite
ThirdPartyCertificateTool.sh -T -i -r arquivo_certificado_CA -k local_c10/configuration/
signkeypair/jCAKeystore -p senha
● No Windows, digite:
ThirdPartyCertificateTool.bat -T -i -r arquivo_certificado_CA -k local_c10\configuration\
signkeypair\jCAKeystore -p senha
Seleção e classificação de conjuntos de codificação para SSLUma conexão SSL começa com uma negociação onde o cliente e o servidor apresentam uma lista
de conjuntos de codificação suportados em uma seqüência prioritária. O conjunto de codificação
fornece a qualidade de proteção para a conexão. Ele contém algoritmos criptográficos, de
autenticação, hash e de troca de chaves. O protocolo SSL seleciona o conjunto de prioridade mais
alta que o cliente e o servidor suportam.
Uma lista de conjuntos de codificação para SSL é fornecida. É possível eliminar conjuntos de
codificação que não correspondem a exigências e então atribuir uma prioridade, ou preferência,
aos conjuntos de codificação restantes. Os conjuntos de codificação selecionados são apresentados
por ordem de prioridade para as partes do cliente e servidor da negociação. No mínimo um dos
conjuntos de codificação selecionados entre as plataformas do cliente e servidor devem corresponder.
A lista de conjunto de codificações compatíveis é gerada dinamicamente em cada computador e
depende do JavaTM Runtime Environment (JRE) ou da existência de outro software de criptografia
instalado no computador. Se foram feitas mudanças em um computador, como atualização no JRE
ou a instalação de um software que atualizou o JRE, isto pode afetar os conjuntos de codificação
suportados nesse computador. Se não possuir mais um conjunto de codificação suportado que
Guia de instalação e configuração 263
Capítulo 10: Opções de configuração
corresponda a outros computadores em seu ambiente, pode ser necessário alterar o JRE no
computador para corresponder aos outros computadores em seu ambiente.
Etapas
1. Início do IBM® Cognos® Configuration.
2. Na janela Explorer, clique em Criptografia > Cognos.
3. Na janela Propriedades, clique na coluna Valor na propriedade Conjuntos de codificação com
suporte.
4. Clique no botão de edição .
● Para mover um conjunto de codificação para a lista Valores atuais, clique na caixa de
seleção na lista Valores disponíveis e em Adicionar.
● Para mover um conjunto de codificação para cima ou para baixo na lista Valores atuais,clique na caixa de seleção e depois nas setas para cima ou para baixo.
● Para remover um conjunto de codificação da lista Valores atuais, clique na caixa de seleção
e em Remover.
5. Clique em OK.
6. No menu Arquivo, clique em Salvar.
Ativação do SSL no servidor webAtive o secure sockets layer (SSL) para criptografar a comunicação de um usuário com o servidor
web.
Para ativar o SSL em seu servidor web, é necessário obter um certificado de servidor web assinado
por uma Autoridade de certificação e instalá-lo em seu servidor web. O certificado não pode ter
sua própria assinatura, pois desta maneira não terá a confiança dos componentes do IBM® Cognos®.
Para permitir que os componentes do IBM Cognos usem um servidor web habilitado para SSL, é
necessário ter cópias do certificado raiz confiável (o certificado da Autoridade de Certificação raiz
que assinou o certificado do servidor web) e de todos os outros certificados que constituem a cadeia
de confiança para o certificado do servidor web. Esses certificados devem estar em Base64 codificado
nos formatos ASCII (PEM) ou DER, e não podem ter a própria assinatura. Os certificados devem
ser instalados em cada computador onde o Application Tier Components foi instalado.
Para obter mais informações sobre como instalar certificados no servidor web, consulte a
documentação do mesmo.
Etapas
1. Configure o servidor web para SSL e inicie-o.
Para obter mais informações, consulte a documentação do servidor web.
264 IBM Cognos Business Intelligence PowerPlay
Capítulo 10: Opções de configuração
2. Em cada computador com Application Tier Components que aponta para o gateway no servidor
web, no IBM Cognos Configuration, altere o URI do gateway de HTTP para HTTPS e salve a
configuração.
Não inicie ainda o serviço do IBM Cognos.
3. Em cada computador com Application Tier Components, acesse o diretório local_c10/bin e
importe todos os certificados que compõem a cadeia de confiança para iniciar o certificado de
CA raiz no armazenamento de confiança do IBM Cognos.
Importe os certificados digitando o seguinte comando:
No UNIX® ou no Linux®, digite
ThirdPartyCertificateTool.sh -T -i -r certificate_fileName -D ../configuration/signkeypair -ppassword
No Windows®, digite
ThirdPartyCertificateTool.bat -T -i -r certificate_fileName -D ../configuration/signkeypair -ppassword
Observação: a senha já deve ter sido definida. Caso contrário, a senha padrão é NoPassWordSet.
4. Em cada computador com componentes da camada de aplicativos, no IBM Cognos
Configuration, inicie o serviço do IBM Cognos.
É possível verificar a confiança criando e executando um relatório em PDF que contenha imagens
que não foram armazenadas localmente, mas que o gateway obtém de um computador remoto. Se
esta imagem aparecer, a confiança foi estabelecida.
Para evitar prompts de alertas de segurança para cada nova sessão, instale o certificado em um dos
armazenamentos de certificados do navegador web.
Além disso, pode-se desejar configurar conexões SSL entre os componentes do IBM Cognos e outros
servidores. É necessário assegurar-se de que tal SSL esteja configurado para outros servidores. Então,
deve-se configurar uma confiança compartilhada entre os componentes do IBM Cognos e os outros
servidores. Para obter mais informações, consulte "Configuração do protocolo SSL" (p. 259 ).
Configurando um Repositório para Mensagens de LogAs mensagens de log são uma importante ferramenta de diagnóstico para investigar o comportamento
do IBM® Cognos® BI. Além das mensagens de erro, as mensagens de log oferecem informações
sobre o status dos componentes e uma visão de alto nível de eventos importantes. Por exemplo: as
mensagens de log podem fornecer informações sobre tentativas de inicializar e encerrar serviços,
finalização de solicitações de processamento e indicadores de erros fatais. Os logs de auditoria, que
estão disponíveis em um banco de dados de logs, fornecem informações sobre a atividade do usuário
e do relatório.
Os serviços do IBM Cognos em cada computador enviam informações sobre erros e eventos para
um servidor de log local. Há um servidor de log local instalado na pasta local_c10/logs em cada
computador com o IBM Cognos BI que contenha o Content Manager ou o Application Tier
Components. Uma vez que o servidor de log utiliza uma porta diferente da de outros componentes
Guia de instalação e configuração 265
Capítulo 10: Opções de configuração
do IBM Cognos BI, ele continua a processar os eventos mesmo se outros serviços no computador
local, como o distribuidor, estiverem desabilitados.
O fluxo de trabalho a seguir exibe as tarefas necessárias para preparar-se para o registro.
Planejamento doprocessamento
de mensagens de log Configuração de logs Definição de logs
Configuração de logsPlanejamento doprocessamento
de mensagens de logDefinição de logs
Planejamento do Definição de logsConfiguração de logsprocessamento de
mensagens de log
❑ Durante o planejamento, determine a configuração de registro adequada para seu ambiente.
Por exemplo, avalie os diversos repositórios de mensagens de log, como servidores de log
remotos e arquivos de log, como o log dos sistemas UNIX® ou Linux® ou o Log de eventos do
Windows® NT, além do arquivo de log local. Também é possível enviar somente informações
de log de auditoria para um banco de dados. Considere a segurança, tal como os métodos
disponíveis para proteção dos arquivos de log contra as falhas do sistema e a adulteração do
usuário. Para obter informações sobre planejamento, consulte o Architecture and Deployment
Guide.
❑ Durante a configuração, defina as propriedades de inicialização para logs, como configurações
de conexão para bancos de dados. Também é necessário criar um banco de dados de log se
houver planos de coletar os logs de auditoria. Se a comunicação entre um servidor de log local
e um servidor de log remoto deve ser segura, faça as alterações de configuração apropriadas
em todos os computadores com o IBM Cognos BI. Também é possível habilitar certos recursos
de log, como o registro específico para um usuário. Para obter informações sobre a configuração
de registro, consulte o Installation and Configuration Guide.
❑ Ao configurar o registro, especifique o nível de detalhe para concentrar as mensagens nas
informações relevantes em sua organização. O relatórios de auditoria também podem ser
configurados para rastrear as atividades de usuário e relatório. Para obter mais informações
sobre a configuração do registro, consulte o Guia de administração e segurança.
Para obter informações sobre o uso de mensagens de log para solucionar problemas comuns e
problemas relacionados ao registro, consulte a seção Solução de problemas doGuia de administração
e segurança.
266 IBM Cognos Business Intelligence PowerPlay
Capítulo 10: Opções de configuração
Diretrizes para a criação de um banco de dados de logÉ possível criar um banco de dados para armazenar mensagens de log. A criação de um banco de
dados de log envolve as seguintes tarefas:
❑ Crie um banco de dados de log.
Para DB2, Oracle, Microsoft® SQL Server, Informix® Dynamic Server ou Sybase, use o mesmo
procedimento usado para criar o banco de dados de armazenamento de conteúdo.
Para DB2 em z/OS, use as instruções em "Configurações sugeridas para criar um banco de
dados de log DB2 em z/OS" (p. 267 ).
❑ Configure a conectividade do banco de dados.
❑ Especifique o repositório das mensagens de log.
Configurações sugeridas para criar um banco de dados de log DB2 em z/OS
O banco de dados criado deve conter as definições de configuração especificadas.
Utilize a lista de verificação a seguir para ajudar na configuração do banco de dados de log no DB2.
❑ Faça login no sistema z/OS como um usuário com privilégios de administrador no DB2 em
z/OS.
❑ Crie uma instância do banco de dados, um grupo de armazenamento e uma conta de usuário
para o armazenamento de conteúdo. O IBM® Cognos® usa as credenciais da conta do usuário
para se comunicar com o servidor de banco de dados.
❑ Verifique se alocou um pool de buffer com tamanho de página de 8 KB para a instância do
banco de dados.
❑ Para um banco de dados de log no DB2 em z/OS, os administradores devem executar um script
de tablespace para criar tablespaces que mantenham objetos grandes e outros dados para o
banco de dados de log, e em seguida conceda direitos de usuário à tabela. Para obter mais
informações sobre como executar o script da tablespace, consulte "Criação de tablespaces para
o banco de dados de log DB2 em z/OS " (p. 267 ).
Criação de tablespaces para o banco de dados de log DB2 em z/OSO administrador do banco de dados deve executar um script para criar um conjunto de tablespaces
necessários para o banco de dados de log. O script deve ser modificado para substituir os parâmetros
de espaço reservado com os adequados a seu ambiente.
Verifique se está usando a convenção de nome para DB2 em z/OS. Por exemplo, todos os nomes
de parâmetros devem começar com uma letra e o tamanho não pode exceder oito caracteres. Para
obter mais informações, consulte o IBM® DB2 Information Center.
Etapas
1. Conecte-se ao banco de dados como um usuário com privilégios para criar e arrastar tablespaces
e para permitir a execução de instruções SQL.
Guia de instalação e configuração 267
Capítulo 10: Opções de configuração
2. Abra o arquivo de script LS_tablespace_db2zOS.sql e use a tabela a seguir para ajudá-lo a
substituir os parâmetros genéricos com os adequados a seu ambiente.
DescriçãoNome do parâmetro
Especifica o nome do banco de dados de log.IPFSCRIPT_DATABASE
Especifica o nome do grupo de
armazenamento.
IPFSCRIPT_STOGROUP
Especifica o nome do tablespace que irá conter
todas as tabelas de base no banco de dados de
log.
IPFSCRIPT_TABLESPACE
Este tablespace não é para tabelas auxiliares.
Especifica o nome do tablespace alocado para
tabelas auxiliares.
IPFSCRIPT_LOB_TABLESPACE
Especifica o nome do pool de buffer de 8 k
alocado para objetos normais.
IPFSCRIPT_BP
Especifica a conta de usuário que acessa o
banco de dados de log.
IPFSCRIPT_USERNAME
Nem todos os parâmetros listados estão no script, mas podem ser adicionados no futuro.
3. Salve e execute o script.
4. Conceda os direitos de usuário do IBM Cognos® às tablespaces criadas ao executar o arquivo
de script LS_tablespace_db2zOS.sql:
● Abra o arquivo de script LS_rightsGrant_db2zOS.sql, localizado no diretório local_c10/
configuration/schemas/logging/db2zOS.
● Substitua os valores de parâmetros com os adequados a seu ambiente.
Dica: Certifique-se de que os mesmos valores usados ao criar pools de buffer e a conta de
usuário estejam sendo usados.
● Salve e execute o script LS_rightsGrant_db2zOS.sql.
O banco de dados de log foi criado.
Configuração da conectividade do banco de dados para o banco de dados de logDepois de criar um banco de dados para logs de auditoria, são necessárias etapas adicionais para
configurar o banco de dados cliente se utilizar Oracle, DB2, Informix® Dynamic Server ou Sybase
como o servidor de banco de dados.
Não é possível utilizar o Banco de dados de conteúdo do Cognos® como banco de dados de log.
268 IBM Cognos Business Intelligence PowerPlay
Capítulo 10: Opções de configuração
Observação: Em um ambiente distribuído, o servidor de log local em um computador com
Application Tier Component pode enviar mensagens de log a um servidor de log remoto, que envia
mensagens ao banco de dados de log. Para Oracle, Sybase e DB2, o driver JDBC adequado e o
software cliente de banco de dados (apenas DB2) são necessários apenas no computador com
Application Tier Components com o servidor de log remoto que se conecta ao banco de dados de
log.
Banco de dados Microsoft SQL Server
Se um banco de dados Microsoft® SQL Server for utilizado, o arquivo JSQLConnect.jar será instalado
no local apropriado por padrão. A única etapa adicional é garantir que o Microsoft SQL Server
utiliza a conectividade TCP/IP.
Banco de dados Oracle ou Sybase
Se utilizar um banco de dados Oracle, Informix Dynamic Server ou Sybase, configure o driver JDBC
em todos os computadores com o Application Tier Components com uma conexão ao banco de
dados de log. Também é preciso configurar o driver JDBC no computador com o Content Manager,
a menos que esteja utilizando o mesmo tipo de banco de dados para as mensagens de log que utiliza
para o armazenamento de conteúdo.
Banco de dados DB2
O IBM® Cognos usa a conectividade JDBC para acessar o banco de dados utilizado para o banco
de dados de log.
Para um banco de dados DB2, configure o software do cliente de banco de dados e o driver JDBC
em todos os computadores com Application Tier Components com uma conexão ao banco de dados
de log. Também é preciso configurar o software do cliente de banco de dados e driver JDBC no
computador com o Content Manager, a menos que esteja utilizando o mesmo tipo de banco de
dados para as mensagens de log que utiliza para o armazenamento de conteúdo.
Se usar o DB2 no Windows®, Linux® ou UNIX® como banco de dados de log, é necessário escolher
se irá usar o driver JDBC tipo 2 ou tipo 4, dependendo de como deseja se conectar ao banco de
dados de log.
Para obter mais informações sobre as opções de driver JDBC para um banco de dados DB2, consulte
"Opções de driver JDBC para usar o banco de dados DB2 como armazenamento de conteúdo" (p. 96
).
Etapas para o Oracle
1. No computador onde o Oracle foi instalado, vá para o diretório ORACLE_HOME/jdbc/lib.
2. Copie o arquivo ojdbc5.jar para o diretório local_10/webapps/p2pd/WEB-INF/lib nos
computadores em que o Content Manager ou o Application Tier Components foram instalados.
Guia de instalação e configuração 269
Capítulo 10: Opções de configuração
Se o diretório contiver o arquivo classes12.jar ou o ojdbc14.jar, exclua-o antes de instalar o
arquivo ojdbc5.jar.
Etapas para DB2 no Linux, UNIX e Windows
1. Se estiver usando uma conectividade JDBC tipo 2, instale o software do cliente DB2 nos
computadores com o Content Manager.
Se usar uma conectividade JDBC tipo 4 para DB2, não será solicitado para instalar o software
do cliente DB2 no local onde o Content Manager está instalado.
Para obter mais informações sobre as diferenças entre os drivers tipo 2 e tipo 4, consulte "Opções
de driver JDBC para usar o banco de dados DB2 como armazenamento de conteúdo" (p. 96
).
2. Se estiver usando uma conectividade JDBC tipo 2 e o banco de dados de log estiver em um
computador diferente do servidor de log, configure um alias do banco de dados para o banco
de dados de log.
● No Windows, execute o DB2 Client Configuration Assistant.
● No UNIX ou Linux, use a interface de linha de comando DB2.
Observação: Se o banco de dados de log e o servidor de log estiverem no mesmo computador,
o nome do banco de dados de log automaticamente se tornará o alias.
3. No Windows, encerre os serviços DB2 e o HTML Search Server.
4. Copie os seguintes arquivos do diretório instalação_DB2/sqllib/java para o diretório local_c10/
webapps/p2pd/WEB-INF/lib.
● O arquivo do driver universal, db2jcc.jar.
● o arquivo de licença
para DB2 no Linux, UNIX ou Windows, db2jcc_license_cu.jar
para DB2 em z/OS, db2jcc_license_cisuz.jar
Dica: Para verificar a versão do driver, execute o comando java -cp caminho\db2jcc.jar com.
ibm.db2.jcc.DB2Jjcc -versão.
5. No Windows, reinicie os serviços DB2 e o HTML Search Server.
6. Repita o procedimento inteiro nos computadores com IBM Cognos em que o software deve
ser instalado.
Etapas para o DB2 em z/OS
1. Vá para o diretório instalação_DB2/sqllib/java.
2. Copie os seguintes arquivos para os diretórios local_c10/webapps/p2pd/WEB-INF/lib e
local_c10/bin.
● O arquivo do driver universal, db2jcc.jar.
● O arquivo de licença, por exemplo db2jcc_license_cisuz.jar.
270 IBM Cognos Business Intelligence PowerPlay
Capítulo 10: Opções de configuração
Se estiver usando um banco de dados DB2 em z/OS para o banco de dados de log, é necessário usar
uma conectividade JDBC tipo 4.
A versão do driver deverá ser no mínimo JCC 3.7 do Linux, UNIX, ou o Fix Pack versão 9.1 do
Windows, ou JCC 3.42 do Linux, UNIX, ou o Fix Pack 2 versão 9.5 do Windows.
Etapas para Informix
1. No computador em que o Informix® está instalado, acesse o diretório local_Informix/sqllib/java.
2. Copie os arquivos a seguir para o diretório local_c10/webapps/p2pd/WEB-INF/lib nos
computadores onde o Application Tier Components está instalado.
● O arquivo do driver universal, db2jcc.jar.
● o arquivo de licença, db2jcc_license_cisuz.jar
Etapas para Sybase
1. No computador onde o Sybase está instalado, ative o driver JDBC utilizando o seguinte roteiro:
Sybase_location/jConnect-6/sp/sql_server12.5.sql
2. Acesse o diretório Sybase_location/jConnect-6/classes.
3. Copie o arquivo jconn3.jar no diretório local_c10/webapps/p2pd/WEB-INF/lib nos computadores
com Content Manager ou Application Tier Components adequados.
Repositórios de mensagens de logUm servidor de log é automaticamente instalado junto com o Content Manager ou o Application
Tier Components. Especifique um ou mais repositórios em que o servidor de log local envia
mensagens de log:
● Servidor de log remoto.
● Arquivo.
● Banco de dados.
● O log do sistema UNIX® ou Linux® ou log de eventos do Windows® NT.
Para obter mais informações sobre mensagens de log, consulte o Architecture and Deployment
Guide.
Servidor de log remoto
Em uma instalação distribuída, é possível configurar o servidor de log em cada computador com
IBM® Cognos® para enviar mensagens de log para um único servidor de log remoto, que atua como
um servidor de log comum. Em seguida pode-se configurar o servidor de log comum para enviar
as mensagens de log a um arquivo ou banco de dados comum, no mesmo ou em outro computador.
Se o servidor de log remoto ficar indisponível, as mensagens de log serão redirecionadas para
arquivos de recuperação no computador local, no diretório local_c10/logs/recovery/remote. Esses
arquivos de recuperação possuem informações de carimbo de data/hora em seus nomes de arquivo,
Guia de instalação e configuração 271
Capítulo 10: Opções de configuração
e não são lidos como arquivos de log comuns. Quando o servidor de log remoto fica disponível,
um processo de recuperação automática move todas as informações de log para o servidor de log
remoto e exclui os arquivos de log locais.
Arquivo
O servidor de log é configurado por padrão para enviar mensagens de log ao arquivo local_c10/
logs/cogserver.log. Se o arquivo de log padrão não existir quando o serviço do IBM Cognos for
iniciado, ele será criado automaticamente.
É possível configurar o servidor de log para enviar mensagens de log para um arquivo diferente. Se
um arquivo de log diferente for configurado, o IBM Cognos tentará criar automaticamente este
arquivo na inicialização, além do arquivo de log padrão. Se o local do arquivo de log configurado
for diferente do diretório local_c10/logs, será necessário certificar-se de que o caminho para o
arquivo de log existe antes de iniciar o serviço do IBM Cognos. Por exemplo, se o servidor de log
for configurado para enviar mensagens para o arquivo /usr/lpp/logfiles/cognos.log, o IBM Cognos
tentará criar automaticamente o arquivo cognos.log na pasta /usr/lpp/logfiles. Se esta pasta não
existir, o IBM Cognos não irá criar o arquivo cognos.log e nenhuma mensagem de log poderá ser
registrada nele. Observe que essas mensagens de log não são registradas no arquivo de log padrão.
Apesar de o IBM Cognos criar automaticamente o arquivo de log padrão mesmo quando outro
arquivo de log é configurado, o arquivo de log padrão não é usado como backup.
Banco de dados
O servidor de log também pode enviar logs de auditoria a um banco de dados no mesmo ou em
outro computador. Os logs de auditoria fornecem informações sobre atividade do usuário e de
relatório.
O banco de dados de log possui a mesma configuração e requisitos de conta de usuário que o banco
de dados de armazenamento de conteúdo. Depois de configurar os componentes do IBM Cognos
para enviar mensagens a um banco de dados de log e reiniciar o serviço do IBM Cognos, os
componentes do IBM Cognos criam as tabelas e os campos de tabelas necessários. É possível testar
a conexão ao banco de dados de log antes de reiniciar o serviço do IBM Cognos.
Especificação do repositório de mensagens de logÉ possível configurar um tipo de repositório para as mensagens de log, e depois configurar
propriedades para o repositório específico. Também é possível configurar mais de um repositório
de mensagens de log.
Antes de especificar um banco de dados como um repositório, verifique se
❑ criou o banco de dados de log.
❑ configurou o cliente de banco de dados.
Etapas para DB2 para UNIX, Linux e Windows
1. No computador onde foi instalado o Content Manager ou o Application Tier Components,
inicie o IBM® Cognos® Configuration.
2. Na janela Explorer, em Ambiente, clique emLog.
272 IBM Cognos Business Intelligence PowerPlay
Capítulo 10: Opções de configuração
3. Na janela Propriedades, use a tabela a seguir para ajudar a configurar as propriedades do
servidor de log.
AçãoTarefa
Configure a propriedade Habilitar TCP como Verdadeiro.Use o TCP entre os
componentes do IBM Cognos
em um computador e o
servidor de log local.
O UDP fornece uma comunicação mais rápida com um risco
menor de conexões perdidas que o TCP. Entretanto, o risco de
perder uma conexão local de TCP é baixo. O TCP sempre é
usado na comunicação entre um servidor de log local e um
remoto.
Digite o valor na propriedade Segmentos de trabalho do servidor
de log local.
Altere o número de threads
disponíveis para o servidor
de log local. Mantenha o valor padrão de 10. O intervalo vai de 1 a 20.
Entretanto, se tiver um número alto de mensagens de log, é
possível alocar mais threads para melhorar o desempenho.
4. Na janela Explorer, em Ambiente, clique com o botão direito em Log e em Novo recurso >
Destino.
5. Na caixa Nome, digite o nome do repositório.
6. Na lista Tipo, clique no tipo do repositório e depois em OK.
7. Se o repositório for um arquivo, digite os valores adequados para as propriedades obrigatória
e opcional na janela Propriedades.
8. Se o repositório for um servidor de log remoto, digite os valores adequados para as propriedades
obrigatória e opcional na janela Propriedades.
Se a URI do distribuidor interno do computador do repositório de destino estiver configurada
para usar SSL, na janela Propriedades, defina a propriedade Ativação do SSL como Verdadeira.
Mais tarde á necessário especificar o repositório das mensagens de log ao configurar o servidor
de log remoto.
9. Se o repositório for um banco de dados, na janela Explorer, em Log, especifique o tipo de banco
de dados e suas propriedades da seguinte forma:
● Clique com o botão direito no nome do banco de dados e clique em Novo recurso > Banco
de dados.
● Na caixa Nome, digite o nome do repositório.
● Na lista Tipo, clique no tipo de banco de dados e depois clique em OK.
● Na janela Propriedades, digite os valores apropriados para as propriedades obrigatórias e
opcionais.
Guia de instalação e configuração 273
Capítulo 10: Opções de configuração
Para um banco de dados do Microsoft® SQL Server, é possível escolher um número de
porta, como 1433, ou uma instância nomeada como o valor para a propriedade Servidor
de banco de dados com número de porta ou nome da instância. Inclua o número da porta
se portas que não são padrão forem utilizadas. Inclua o nome da instância se existirem
várias instâncias do Microsoft SQL Server.
Para se conectar a uma instância denominada, é necessário especificar o nome da instância
como uma propriedade URL JDBC ou de fonte de dados. Por exemplo, digite
localhost\instance1. Se não forem especificadas propriedades de nome de instância, é criada
uma conexão com a instância padrão.
Observe que as propriedades especificadas para a instância denominada, junto com a ID
e senha de usuário e nome do banco de dados, são usados para criar um URL JDBC. Eis
um exemplo:
jdbc:JSQLConnect://localhost\\instance1/user=sa/mais propriedades como solicitado
● Teste a conexão ao novo banco de dados. Na janela Explorer, em Ambiente, clique com
o botão direito em Log e clique em Teste.
Os componentes do IBM Cognos conectam-se ao banco de dados. Se forem configurados
mais de um banco de dados para mensagens de log, os componentes do IBM Cognos
testarão todos os bancos de dados.
10. Repita as etapas de 5 a 10 para cada repositório para o qual deseja que o servidor de log envie
mensagens.
11. No menu Arquivo, clique em Salvar.
12. Na janela Explorer, clique em Serviço do IBM Cognos > IBM Cognos.
13. No menu Arquivo, clique em Reiniciar.
Se um banco de dados for selecionado como repositório, os componentes do IBM Cognos
criarão as tabelas e os campos necessários no banco de dados criado.
Se o repositório era um servidor de log remoto, configure e inicie esse servidor. Em seguida, reinicie
o serviço do IBM Cognos no computador local.
Se o repositório era um banco de dados, será possível utilizar os componentes do IBM Cognos para
executar relatórios de log do banco de dados.
Também é possível definir o nível de log, que controla a quantidade e o tipo de mensagens que são
enviadas para um arquivo ou banco de dados de log. Para saber as instruções, consulte o Guia de
administração e segurança.
Etapas para o DB2 em z/OS
1. No computador onde o Content Manager ou o Application Tier Components foram instalados,
inicie o IBM Cognos Configuration.
2. Na janela Explorer, em Ambiente, clique emLog.
274 IBM Cognos Business Intelligence PowerPlay
Capítulo 10: Opções de configuração
3. Na janela Propriedades, use a tabela a seguir para ajudar a configurar as propriedades do
servidor de log.
AçãoTarefa
Configure a propriedade Habilitar TCP como Verdadeiro.Use o TCP entre os
componentes do IBM Cognos
em um computador e o
servidor de log local.
O UDP fornece uma comunicação mais rápida com um risco
menor de conexões perdidas que o TCP.
O TCP é usado na comunicação entre um servidor de log
local e um remoto.
Digite o valor na propriedade Segmentos de trabalho do
servidor de log local.
Altere o número de threads
disponíveis para o servidor de
log local. Mantenha o valor padrão de 10. O intervalo vai de 1 a 20.
Entretanto, se tiver um número alto de mensagens de log, é
possível alocar mais threads para melhorar o desempenho.
4. Na janela Explorer, em Ambiente, clique com o botão direito em Log e em Novo recurso >
Destino.
5. Na caixa Nome, digite o nome do repositório.
6. Na lista Tipo, clique em Banco de dados e depois em OK.
7. Na janela Explorer, em Log, clique com o botão direito no nome do banco de dados e clique
em Novo recurso > Banco de dados.
8. Na caixa Nome, digite o nome do repositório.
9. Na lista Tipo, clique em Banco de dados DB2 e depois em OK.
10. Na janela Propriedades, digite o Servidor do banco de dados e número da porta, ID do usuário
e senha, e o Nome do banco de dados z/OS.
Verifique se a ID do usuário é igual ao valor especificado no parâmetro IPFSCRIPT_USERNAME
no arquivo de script LS_tablespace_db2zOS.sql (p. 267 ).
11. Na janela Explorer, clique em Configuração Local.
12. Na janela Propriedades, próximo a Propriedades avançadas, clique dentro da caixa Valor e
clique no botão de edição .
13. Clique em Adicionar e adicione os seguintes nomes e valores de parâmetros de configuração:
Guia de instalação e configuração 275
Capítulo 10: Opções de configuração
ValorNome do parâmetro
O local das tabelas de baseIPFSCRIPT_CREATE_IN
Por exemplo, NomeBancodedados.baseNome
Tablespace
O nome do grupo de armazenamento.IPFSCRIPT_STOGROUP
O nome do banco de dados de log.IPFSCRIPT_DATABASE
O nome do tablespace reservado para as tabelas
auxiliares no banco de dados de log.
IPFSCRIPT_LOB_TABLESPACE
14. No menu Arquivo, clique em Salvar.
15. Teste a conexão ao novo banco de dados. Na janela Explorer, em Ambiente, clique com o
botão direito em Log e clique em Teste.
Os componentes do IBM Cognos conectam-se ao banco de dados. Se forem configurados mais
de um banco de dados para mensagens de log, os componentes do IBM Cognos testarão todos
os bancos de dados.
Etapas para Informix
1. Na janela Explorer, em Ambiente, clique emLog.
2. Na janela Propriedades, use a tabela a seguir para ajudar a configurar as propriedades do
servidor de log.
AçãoTarefa
Configure a propriedade Habilitar TCP como Verdadeiro.Use o TCP entre os
componentes do IBM Cognos
em um computador e o
servidor de log local.
O UDP fornece uma comunicação mais rápida com um risco
menor de conexões perdidas que o TCP.
O TCP é usado na comunicação entre um servidor de log
local e um remoto.
Digite o valor na propriedade Segmentos de trabalho do
servidor de log local.
Altere o número de threads
disponíveis para o servidor de
log local. Mantenha o valor padrão de 10. O intervalo vai de 1 a 20.
Entretanto, se tiver um número alto de mensagens de log, é
possível alocar mais threads para melhorar o desempenho.
3. Na janela Explorer, em Ambiente, clique com o botão direito em Log e em Novo recurso >
Destino.
276 IBM Cognos Business Intelligence PowerPlay
Capítulo 10: Opções de configuração
4. Na caixa Nome, digite o nome do repositório.
5. Na lista Tipo, clique em Banco de dados e depois em OK.
6. Na janela Explorer, em Log, clique com o botão direito no nome do banco de dados e clique
em Novo recurso > Banco de dados.
7. Na caixa Nome, digite o nome do repositório.
8. Na lista Tipo, clique em Banco de dados do Informix Dynamic Server e, em seguida, clique em
OK.
9. Na janela Propriedades, digite os valores para Servidor do banco de dados e número da porta,
ID do usuário e senha e o Nome do banco de dados.
10. Se houver várias instâncias de um banco de dados de log do Informix®, crie a propriedade
avançada IPFSCRIPTIDX e especifique a conta na qual a instância é executada:
● Na janela Explorer, clique em Configuração Local.
● Na janela Propriedades, clique na coluna Valor para Propriedades avançadas e, em seguida,
clique no botão editar .
● Na caixa de diálogo Valor - Propriedades avançadas, clique em Adicionar.
● Na coluna Nome, digite IPFSCRIPTIDX
● Na coluna Valor, digite a ID de usuário da conta na qual a instância do banco de dados
de conexão é executada.
Use uma conta de usuário diferente para cada instância do banco de dados de conexão do
Informix.
● Repita todas as instâncias do IBM Cognos Configuration que usam uma instância de um
banco de dados de conexão do Informix.
11. No menu Arquivo, clique em Salvar.
12. Teste a conexão ao novo banco de dados. Na janela Explorer, em Ambiente, clique com o
botão direito em Log e clique em Teste.
Os componentes do IBM Cognos conectam-se ao banco de dados. Se forem configurados mais
de um banco de dados para mensagens de log, os componentes do IBM Cognos testarão todos
os bancos de dados.
Ativação de conexão específica do usuárioAo diagnosticar problemas, é possível definir temporariamente logs para monitorar um ou mais
usuários específicos em vez de todos os usuários de uma só vez. Após concluir o diagnóstico, retome
os logs normais. Para permitir logs específicos de usuário, utilize o IBM®® Cognos® Configuration
para configurar as informações de conexão para JavaTM Management Extensions (JMX), uma
tecnologia que fornece ferramentas para gerenciar e monitorar aplicativos e redes orientadas a
Guia de instalação e configuração 277
Capítulo 10: Opções de configuração
serviços. Depois configure as informações de conexão JMX em um arquivo de propriedades de
implantação.
Após ativar os logs específicos de usuário para os componentes do IBM Cognos, ative-os para um
usuário específico utilizando o serviço Remote Process para JMX. Para obter informações, consulte
o tópico sobre como usar os logs para diagnosticar um problema referente a um usuário específico
no Guia de administração e segurança.
É necessário instalar Sun Java JDK ou Java Software Development Kit para IBM antes de poder
ativar logs específicos de usuários.
Configuração de informações de conexão JMX usando o IBM Cognos Configuration
Configure as informações de conexão JMX no IBM Cognos Configuration especificando o valor
do cookie para, em seguida, configurar a porta e as credenciais JMX.
Etapas
1. No computador com o Content Manager instalado, inicie o IBM Cognos Configuration.
2. Na janela Explorer, em Segurança, clique emAutenticação.
3. Na janela Propriedades, para Propriedades avançadas, clique na coluna Valor e, em seguida,
no botão de edição .
4. Na caixa de diálogo Valor - Propriedades avançadas, clique em Adicionar.
5. Na nova linha, digite newCookie como o nome e digite true como o valor; em seguida, clique
em OK.
Os valores diferem maiúsculas de minúsculas.
6. Na janela Explorer, clique em Ambiente.
7. Na janela Propriedades, configure as propriedade JMX em Configurações de distribuidor:
● Para Porta JMX externa, digite um número de porta disponível.
● Para Credencial JMX externa, clique no botão de edição na coluna Valor, digite a ID
de usuário e a senha e, em seguida, clique em OK.
O ID de usuário e senha garantem que somente um usuário autorizado conecte-se ao
ambiente Java para especificar o(s) usuário(s) a ser(em) registrado(s), usando a porta
especificada em Porta JMX externa.
8. Salve a configuração.
278 IBM Cognos Business Intelligence PowerPlay
Capítulo 10: Opções de configuração
Configure as informações de conexão JMX de um arquivo de propriedades de implantação
Para que o servidor de aplicativo suporte as configurações JMX, especifique a porta JMX no arquivo
de propriedades de implantação p2pd.
Etapas
1. Em um editor de texto, abra o arquivo p2pd.deploy_defaults.properties localizado no caminho
local_c10/webapps/p2pd/WEB-INF.
2. Retire o comentário da linha rmiregistryport e defina o valor para a Porta JMX externa
configurada no IBM Cognos Configuration.
3. Salve o arquivo p2pd.deploy_defaults.properties.
4. Reinicie os serviços do IBM Cognos.
Agora o IBM Cognos suporta criação de logs de um ou mais usuários específicos. Para obter mais
informações, consulte o tópico sobre como usar os logs para diagnosticar um problema referente
a um usuário específico no Guia de administração e segurança.
Alteração de definições globaisAs configurações globais são alteradas para os seguintes propósitos
● Personalização do suporte de idiomas da interface de usuário.
● Personalização do suporte de moeda.
● Personalização do suporte da localidade do conteúdo.
● Mapeamento do idioma usado na interface de usuário do produto.
● Mapeamento de localidades do conteúdo.
● Adição de fontes ao ambiente do IBM® Cognos®.
● Personalização do fuso horário padrão.
● Alteração da codificação de mensagens de e-mail.
● Personalização de configurações de cookie.
Por padrão, os componentes do IBM Cognos asseguram que todas as localidades, que podem vir
de diferentes fontes e em vários formatos, utilizem uma forma padronizada. Isto significa que todos
os locais expandidos se adaptam às configurações de idioma e código da região.
Cada computador possui uma localidade de sistema padrão e uma localidade de usuário por usuário.
As localidades de usuário podem ser diferentes da localidade de sistema padrão.
Caso as configurações globais sejam alteradas em um computador com Content Manager, é
necessário fazer as mesmas alterações nos outros computadores com Content Manager.
Guia de instalação e configuração 279
Capítulo 10: Opções de configuração
Personalização do suporte de idioma na interface de usuárioUse a tabela Localidades do Produto para adicionar ou remover o suporte de idioma da interface
de usuário. Por exemplo, se não solicitar uma interface de usuário em alemão, é possível remover
o idioma da lista.
Se o idioma da interface de usuário do produto for alterada, os dados não são atingidos.
Se desejar que os usuários vejam a documentação de produtos em um idioma diferente de inglês, é
necessário instalar a Supplementary Languages Documentation. Para obter mais informações,
consulte "Instalação da documentação do produto traduzida" (p. 188 ).
Certifique-se de que instalou as fontes adequadas para suportar os conjuntos de caracteres e símbolos
de moedas que forem utilizados. Para que os símbolos das moedas japonesa e coreana sejam exibidos
corretamente, é necessário instalar fontes adicionais do disco Supplementary Languages
Documentation.
Etapas
1. Em cada computador com o Content Manager, inicie o IBM® Cognos® Configuration.
2. No menu Ações, clique em Editar Configuração Global.
3. Clique na guia Localidades do produto.
Todas as localidades suportadas são exibidas.
4. Clique em Adicionar.
Dica: para remover o suporte, marque a caixa de seleção próxima a Localidade Suportada e
clique em Remover.
5. Na segunda coluna, digite a porção do idioma de uma localidade.
6. Repita as etapas 3 a 5 em outros idiomas suportados que deseja adicionar.
7. Clique em OK.
8. No menu Arquivo, clique em Salvar.
Personalização do suporte de moedaSe forem necessárias moedas adicionais ou se desejar remover algumas da interface de usuário, é
possível atualizar a lista de moedas suportadas na tabela Moedas. Se usar as moedas japonesa ou
coreana, é necessário configurar o suporte para que os caracteres do Iene japonês e do Won coreano
sejam exibidos corretamente..
Adição de moedas à interface do usuário
É possível adicionar moedas suportadas ou não na interface de usuário. Adicione unidades monetárias
suportadas no IBM® Cognos® Configuration. As unidades monetárias que não são suportadas são
adicionadas ao arquivo i18n_res.xml fornecido no IBM Cognos.
Por padrão, os componentes do IBM Cognos exibem somente um subconjunto de moedas suportadas
na interface de usuário. As moedas são identificadas pelo código de moeda ISO 4217. A lista
280 IBM Cognos Business Intelligence PowerPlay
Capítulo 10: Opções de configuração
completa de moedas suportadas que podem ser adicionadas está no arquivo i18n_res.xml no diretório
local_c10/bin.
Se adicionar um código de moeda incompatível com o IBM Cognos, é necessário adicioná-lo
manualmente ao arquivo i18n_res.xml no diretório local_c10/bin. Copie este arquivo para cada
computador com o IBM Cognos na instalação.
A adição de moedas ao ambiente do IBM Cognos não garante que o seu computador possua uma
fonte com os caracteres solicitados para exibir a moeda. Certifique-se de ter instalado as fontes
adequadas para suportar os símbolos de moedas utilizados. Por exemplo, para exibir o símbolo de
moeda indiana (rúpia) corretamente, é necessário instalar uma fonte que contenha aquele caractere.
Além disso, para que os símbolos das moedas japonesa e coreana sejam exibidos corretamente, é
necessário instalar fontes adicionais do disco Supplementary Languages Documentation.
Etapas
1. Em cada computador com o Content Manager, inicie o IBM Cognos Configuration.
2. No menu Ações, clique em Editar Configuração Global.
3. Clique na guia Moedas.
4. Clique em Adicionar.
Dica: Para remover o suporte, assinale a caixa de seleção próxima ao item suportado e clique
em Remover.
5. Na segunda coluna, digite o valor apropriado.
O valor adicionado deve corresponder aos códigos ISO 4217 para a representação de moedas
e formatos. Em geral, o valor adicionado é um código alfabético de três letras. Os dois primeiros
caracteres são letras que representam o código do país ISO 3166 de onde é a moeda. A letra
adicional representa a primeira letra da moeda.
6. Repita as etapas 3 a 5 em outros tipos de suporte que deseja adicionar.
7. No menu Arquivo, clique em Salvar.
Personalização do suporte da localidade do conteúdoPara garantir que os usuários visualizem relatórios, dados ou metadados no idioma preferido ou
específico da região, adicione localidades parciais (idioma) ou localidades completas (idioma -
região) à tabela Localidades do Conteúdo. Desta forma, se o conteúdo estiver disponível em idiomas
ou localidades diferentes será processado para os usuários com base na localidade do usuário. Por
padrão, a localidade do conteúdo substitui a localidade do produto no portal por algum conteúdo.
Se visualizar relatórios no idioma tailandês, os dígitos não são suportados.
Se uma localidade não for solicitada, é possível removê-la da lista. Deixe pelo menos uma localidade
do conteúdo na lista para Application Tier Components operar.
Adicionar localidades incompletas (idiomas) ao ambiente do IBM® Cognos® não garante que seu
computador tenha uma fonte que possa exibir páginas da web em seus idiomas preferidos. Certifique-
se de que instalou as fontes adequadas para suportar os conjuntos de caracteres e símbolos de
Guia de instalação e configuração 281
Capítulo 10: Opções de configuração
moedas que forem utilizados. Para que os símbolos das moedas japonesa e coreana sejam exibidos
corretamente, é necessário instalar fontes adicionais do disco Supplementary Languages
Documentation. Para obter mais informações, consulte "Instalação e configuração de fontes de
idiomas adicionais" (p. 189 ).
Etapas
1. Em cada computador com o Content Manager, inicie o IBM Cognos Configuration.
2. No menu Ações, clique em Editar Configuração Global.
3. Clique na guia Localidades do conteúdo.
Todas as localidades suportadas são exibidas.
4. Clique em Adicionar.
Dica: Para remover o suporte, assinale a caixa de seleção próxima ao item suportado e clique
em Remover.
5. Na segunda coluna, digite o valor apropriado.
● Para adicionar um suporte de idioma para dados e metadados de relatório, digite uma
definição de localidade parcial (idioma).
● Para adicionar suporte específico de uma região, digite uma definição de localidade completa
(idioma - região).
6. Repita as etapas 3 a 5 para cada localidade adicional de que deseja o suporte.
7. No menu Arquivo, clique em Salvar.
Mapeamento de localidades do conteúdoUse a tabela Mapeamentos de Localidades do Conteúdo para mapear localidades de usuário em
uma localidade completa (idioma - região) ou parcial (idioma). Também é possível mapear o idioma
preferido de um usuário para outro idioma se o conteúdo não estiver disponível no idioma preferido
do usuário.
Por exemplo, se um relatório ou cartão de desempenho não estiver disponível em um idioma
preferido, por exemplo vietnamita, mas estiver disponível em francês ou alemão, use a tabela de
mapeamento de conteúdo para mapear o idioma preferido (vietnamita) em outro idioma (francês
ou alemão). Desta forma, vê-se o relatório ou cartão de desempenho no idioma mapeado.
Por padrão, a tabela Mapeamentos de Localidades do Conteúdo inclui as localidades que não
contêm a região. Isto permite usar somente a porção do idioma da localidade ao especificar as
configurações locais, e garante que sejam vistas sempre as informações corretas. Por exemplo, em
um banco de dados multilíngüe, os dados geralmente estão disponíveis em idiomas diferentes, como
francês (fr), espanhol (es) e inglês (en), ao invés de estarem disponíveis em diferentes localidades,
como inglês do Canadá (en-ca), inglês dos Estados Unidos (en-us) ou francês da França (fr-fr).
Os exemplos a seguir mostram o método que os componentes do IBM® Cognos® utilizam para
determinar qual relatório ou cartão de desempenho o usuário visualiza se as versões de vários
idiomas estiverem disponíveis.
282 IBM Cognos Business Intelligence PowerPlay
Capítulo 10: Opções de configuração
Exemplo 1
Um relatório está disponível no Content Manager em duas localidades, como com en-us (inglês dos
Estados Unidos) e fr-fr (francês da França), mas a localidade do usuário está definida para fr-ca
(francês do Canadá). O IBM Cognos usa o mapeamento de localidade para determinar que relatório
é visto pelo usuário.
Primeiro, o IBM Cognos verifica se o relatório está disponível no Content Manager na localidade
do usuário. Se não estiver, o IBM Cognos mapeia a localidade do usuário para uma localidade
padronizada configurada na guia Mapeamento de Localidade do Conteúdo. Como a localidade do
usuário é fr-ca, esta é mapeada para fr. O IBM Cognos utiliza o valor mapeado para ver se o
relatório está disponível em fr. Nesse caso, o relatório está disponível em en-us e fr-fr, e não em fr.
Em seguida, o IBM Cognos mapeia cada relatório disponível para uma localidade padronizada.
Desta forma, en-us se torna en e fr-fr se torna fr.
Já que o relatório e a localidade do usuário mapeiam para fr, o usuário com a localidade do usuário
fr-ca verá o relatório salvo com a localidade fr-fr.
Exemplo 2
As localidades do usuário e do relatório são mapeadas para o mesmo idioma. O IBM Cognos escolhe
qual localidade será usada. Por exemplo: se a localidade do usuário for en-ca (inglês do Canadá) e
os relatórios estiverem disponíveis em en-us (inglês dos EUA) e en-gb (inglês do Reino Unido), o
IBM Cognos mapeará todas as localidades para en. O usuário verá o relatório na configuração de
localidade que o IBM Cognos escolher.
Exemplo 3
As localidades do relatório e do usuário não mapeiam para um idioma comum. O IBM Cognos
escolhe o idioma. Neste caso, pode ser necessário configurar um mapeamento. Por exemplo, se um
relatório estiver disponível em en-us (inglês dos EUA) e fr-fr (francês da França), porém a localidade
do usuário for es-es (espanhol da Espanha), o IBM Cognos escolherá o idioma.
Etapas
1. Em cada computador com o Content Manager, inicie o IBM Cognos Configuration.
2. No menu Ações, clique em Editar Configuração Global.
3. Clique na guia Mapeamentos de Localidades do Conteúdo.
4. Clique em Adicionar.
5. Na caixa Chave, digite a localidade do usuário:
● Para se certificar de que todas as regiões de uma localidade de usuário vejam o conteúdo
em um idioma específico, digite a porção do idioma da localidade, seguida de um travessão
e (-) um asterisco (*).
Por exemplo, digite fr-*
● Para se certificar de que uma localidade de usuário (idioma - região) veja o conteúdo em
um idioma específico, digite a localidade completa.
Guia de instalação e configuração 283
Capítulo 10: Opções de configuração
Por exemplo, digite fr-ch
● Para mapear um idioma preferido a outro idioma, digite a porção do idioma preferido da
localidade.
Por exemplo, digite zh
Dica: para especificar a localidade a ser usada para um intervalo de chaves, use o caractere
curinga (*) com o valor Chave; em seguida, na caixa de diálogo Mapeamento de Localidades,digite a localidade. Por exemplo: se deseja que todas as chaves alemãs utilizem a localidade
alemã, digite de* na caixa Chave e de na caixa Mapeamento de localidades.
6. Na caixa Mapeamento de localidades, digite a porção do idioma da localidade.
Os usuários locais especificados na caixa Chave visualizarão o conteúdo no referido idioma.
7. Repita as etapas 3 a 5 em outros mapeamentos que deseja fazer.
8. Clique em OK.
9. No menu Arquivo, clique em Salvar.
Mapeamento de localidades do produtoUtilize a tabela Mapeamento de Localidades do Produto para especificar o idioma utilizado na
interface de usuário quando o idioma especificado na localidade do usuário não estiver disponível.
Certifique-se de que todas as regiões de uma localidade usam o mesmo idioma, ou que uma localidade
específica e completa (idioma - região) use um idioma em particular.
Por padrão, o usuário vê a interface do produto no idioma que corresponde à definição do idioma
da localidade do usuário.
Etapas
1. Em cada computador com o Content Manager, inicie o IBM® Cognos® Configuration.
2. No menu Ações, clique em Editar Configuração Global.
3. Clique na guia Mapeamentos de Localidades do Produto.
4. Clique em Adicionar.
5. Na caixa Chave, digite a localidade do usuário:
● Para se certificar de que todas as regiões de uma localidade de usuário vejam a interface
de usuário em um idioma específico, digite a porção do idioma da localidade, seguida de
um travessão e (-) um asterisco (*).
Por exemplo, digite es-*
● Para se certificar de que uma localidade completa (idioma - região) veja a interface de
usuário em um idioma específico, digite a localidade completa.
Por exemplo, digite es-es
284 IBM Cognos Business Intelligence PowerPlay
Capítulo 10: Opções de configuração
● Para mapear um idioma preferido a outro idioma, digite a porção do idioma preferido da
localidade.
Por exemplo, digite zh
Dica: para especificar qual localidade usar como padrão, use o caractere curinga (*) com o
valor Chave e, em seguida, na caixa de diálogo Mapeamento de Localidades, digite a localidade.
6. Na caixa Mapeamento de localidades, digite a porção do idioma da localidade.
Os usuários locais especificados na caixa Chave visualizarão o conteúdo no referido idioma.
7. Repita as etapas 3 a 5 em outros mapeamentos que deseja fazer.
8. Clique em OK.
9. No menu Arquivo, clique em Salvar.
Personalização do fuso horário do servidorÉ possível personalizar o fuso horário utilizado pelo Content Manager selecionando um fuso horário
do servidor diferente no IBM® Cognos® Configuration.
Para instalações em UNIX® que não são compatíveis com uma interface gráfica do usuário baseada
em JavaTM, é possível exibir a lista de fusos horários aceitáveis abrindo o IBM Cognos Configuration
no computador com Windows® no qual o Framework Manager está instalado.
O Content Manager está configurado para usar o fuso horário de seu sistema operacional por
padrão. Todas as atividades programadas no IBM Cognos são definidas usando este fuso horário.
Além disso, os usuários do IBM Cognos Connection usam este fuso horário se desejarem definir as
preferências para o fuso horário padrão. Para obter mais informações sobre com definir preferências
no IBM Cognos Connection, consulte o Guia de administração e segurança.
Etapas
1. Inicie o IBM Cognos Configuration.
2. No menu Ações, clique em Editar Configuração Global.
3. Na janela Configuração global, clique na guia Geral.
4. Clique na coluna Valor de Fuso horário do servidor e selecione outro fuso horário na lista.
5. No menu Arquivo, clique em Salvar.
Alteração da codificação de mensagens de e-mailPor padrão, os componentes do IBM® Cognos® utilizam a codificação UTF-8 em e-mails. Este valor
define a codificação padrão usada pelo serviço de entrega nesta instância para todas as mensagens
de e-mail. É possível que haja clientes de e-mail mais antigos ou que tenham sido enviados e-mails
do IBM Cognos para celulares e PDAs que não reconhecem o UTF-8. Se for o caso, mude a
codificação de e-mail para um valor que funcione com todos os clientes de e-mail (por exemplo,
Guia de instalação e configuração 285
Capítulo 10: Opções de configuração
ISO-8859-1, Shift-JIS). Cada instância do IBM Cognos que possui um serviço de entrega disponível
deve ser alterado.
A codificação especificada afeta toda a mensagem, incluindo o assunto, anexos, nomes de anexos
e corpo de texto simples ou HTML.
Os valores de codificação são mostrados na seguinte tabela:
Valor de codificação suportadoConjunto de caracteres
utf-8UTF-8
iso-8859-1Europa Ocidental (ISO 8859-1)
iso-8859-15Europa Ocidental (ISO 8859-15)
windows-1252Europa Ocidental (Windows-1252)
iso-8859-2Europa Central e Oriental (ISO 8859-2)
windows-1250Europa Central e Oriental (Windows-1250)
iso-8859-5Cirílico (ISO 8859-5)
windows-1251Cirílico (Windows-1251)
iso-8859-9Turco (ISO 8859-9)
windows-1254Turco (Windows-1254)
iso-8859-7Grego (ISO 8859-7)
windows-1253Grego (Windows-1253)
euc-jpJaponês (EUC-JP)
iso-2202-jpJaponês (ISO-2022-JP)
shift_jisJaponês (Shift-JIS)
big5Chinês tradicional (Big5)
gb2312Chinês simplificado (GB-2312)
euc-krCoreano (EUC-KR)
ISO 2022-KRCoreano (ISO 2022-KR)
286 IBM Cognos Business Intelligence PowerPlay
Capítulo 10: Opções de configuração
Valor de codificação suportadoConjunto de caracteres
ksc_5601Coreano (KSC-5601)
windows-874Tailandês (Windows-874)
tis-620Tailandês (TIS-620)
Etapas
1. Inicie o IBM Cognos Configuration.
2. No menu Ações, clique em Editar Configuração Global.
3. Na janela Configuração global, clique na guia Geral.
4. Clique na coluna Valor na propriedade Codificação de e-mail.
5. Role a tela até a definição desejada e clique nela.
6. No menu Arquivo, clique em Salvar.
Personalização de configurações de cookiesCom base nas exigências do ambiente do IBM® Cognos®, pode ser necessário modificar as
configurações que os componentes do IBM Cognos utilizam para criar cookies. Use o IBM Cognos
Configuration para personalizar o domínio, caminho e marcador seguro de cookies.
Os componentes do IBM Cognos determinam o domínio de cookies da solicitação HTTP enviada
pelo cliente, que é normalmente um navegador web. Na maioria das configurações de rede, as
solicitações HTTP passam por intermediários como servidores proxy e firewalls quando se deslocam
do navegador para os componentes do IBM Cognos. Alguns intermediários modificam as informações
que os componentes do IBM Cognos utilizam para calcular o domínio de cookies e assim os
componentes do IBM Cognos não conseguem configurar os cookies. O sintoma comum deste
problema é os usuários serem solicitados repetidamente para fazer logon. Para evitar este problema,
configure o domínio de cookies.
Para configurar o valor correto do domínio de cookies, use o formato e valor que representam a
maior cobertura para o host, conforme listado na tabela a seguir.
Formato do domínioHost
nome do computador ou servidor (sem pontos)computador ou servidor
Exemplo: minhaempresa
.nome.sufixoos sufixos são .com, .edu, .gov, .int,
.mil, .net, ou .org (dois pontos)
Exemplo: .minhaempresa.com
Guia de instalação e configuração 287
Capítulo 10: Opções de configuração
Formato do domínioHost
.nome1.nome2.sufixooutro
(três pontos)
Exemplo: .infoviagens.co.nz
Etapas
1. Em cada computador com o Content Manager, inicie o IBM Cognos Configuration.
2. No menu Ações, clique em Editar Configuração Global.
3. Clique na guia Geral.
4. Clique na coluna Valor em Configurações de cookie, para cada propriedade que deseja mudar
e especifique o novo valor.
Se deixar a propriedade Domínio em branco, o distribuidor obtém o domínio do nome do host
ou da solicitação.
5. Clique em OK.
Alteração do gatewayPara melhorar o desempenho do servidor web, é possível configurar o IBM® Cognos® para usar
gateways alternativos que substituam o programa CGI padrão. Use um dos gateways a seguir:
● Microsoft® Internet Server Application Programming Interface (ISAPI) para Microsoft Internet
Information Services no Windows®
● Apache Web Server módulo para o Apache Web Server e IBM HTTP Server
● Aplicativo Servlet Gateway JavaTM para servidores de aplicativos
Não são necessárias configurações do servidor web adicionais para usar o ISAPI. Para acessar os
componentes do IBM Cognos com o ISAPI, no IBM Cognos Configuration, altere a porção cognos.cgi
da propriedade URI do gateway para cognosisapi.dll. Em seguida, especifique o URI do ISAPI,
http://nome_host/ibmcognos/isapi, no navegador. Se vários Content Managers forem utilizados
para proteção contra failover, configure o IBM Cognos para usar um gateway ISAPI em vez do
gateway padrão CGI. Do contrário, o desempenho pode ser afetado depois do failover.
Antes de alterar o gateway, certifique-se primeiro de que o gateway CGI padrão e suas configurações
funcionem no ambiente.
Configuração do gateway no módulo do servidor web Apache no IBM CognosO IBM® Cognos® fornece três módulos do Apache. Use o módulo IBM Cognos Apache para o
Apache Server 1.3.x. Use o módulo IBM Cognos Apache 2 para o Apache Server 2.0.x e IBM HTTP
288 IBM Cognos Business Intelligence PowerPlay
Capítulo 10: Opções de configuração
Server 6.1. Use o módulo IBM Cognos Apache 2.2 para o Apache Server 2.2.x e IBM HTTP Server
7.1.
Etapas para Apache Server 1,3.x
1. Interrompa o servidor web Apache.
2. Anexe o diretório local_c10/cgi-bin à variável de ambiente apropriada:
● No Solaris ou no Linux®, LD_LIBRARY_PATH
● Em HP-UX, SHLIB_PATH
● Em AIX, LIBPATH
3. Em HP-UX PA-RISC, faça o seguinte:
● Verifique se a variável de ambiente LD_PRELOAD contém /usr/lib/libcl.2.
● Configure a variável de ambiente COG_CGIBIN_DIR como local_c10/cgi-bin.
4. Vá para o diretório Apache_installation/conf .
5. Abra o arquivo httpd.conf em um editor.
6. Adicione o seguinte ao final da lista de carregamento de módulo:
LoadModule cognos_module "local_c10/cgi-bin/mod_cognossufixo"
onde sufixo é exibido conforme listado na tabela a seguir:
SufixoSistema operacional
dllWindows®
soSolaris, AIX
slHP-UX PA-RISC
soHP-UX IA, Linux®
7. Adicione o seguinte ao final da lista de adição de módulo:
AddModule mod_cognos.cpp
8. Adicione a seguinte Diretiva do Apache:
ScriptAlias /ibmcognos/cgi-bin "local_c10/cgi-bin"
Alias /ibmcognos "local_c10/webcontent"
<Directory "local_c10/webcontent">
Options Indexes MultiViews
</Directory>
Guia de instalação e configuração 289
Capítulo 10: Opções de configuração
A diretiva <Directory> é opcional.
Dica: verifique se definiu o alias ibmcognos/cgi-bin antes do alias ibmcognos.
9. Adicione o seguinte à seção de relatórios de status do servidor:
<Location /ibmcognos/cgi-bin/mod_cognos.suffix>
SetHandler cognos-handler
</Location>
Digite o código exatamente como especificado, exceto para suffix. Substitua suffix pelo
valor apropriado da tabela na etapa 6.
10. Para ativar a página de diagnóstico do gateway, adicione o seguinte à seção de relatórios de
status do servidor:
<Location /ibmcognos/cgi-bin/diag_mod_cognos. suffix>
SetHandler cognos-handler
</Location>
Digite o código exatamente como especificado, exceto para suffix. Substitua suffix pelo
valor apropriado da tabela na etapa 6.
11. No Windows, Solaris e AIX, adicione o seguinte à seção do diretório de usuários:
<IfModule mod_cognos.cpp>
CGIBinDir "local_c10/cgi-bin"
</IfModule>
12. Salve e feche o arquivo.
13. Inicie o servidor web Apache.
14. Os usuários devem então especificar o URI do módulo Apache no navegador, da seguinte forma:
http://nome_host:porta/ibmcognos/cgi-bin/cognos_module
A string cognos_module deve ser digitada exatamente como especificado.
Por exemplo,
http://123.432.154.12:5562/c10/cgi-bin/cognos_module
Etapas para o Apache Server 2,0.x e IBM HTTP Server 6,1
1. Interrompa o servidor web.
2. Anexe o diretório local_c10/cgi-bin à variável de ambiente apropriada:
● No Solaris ou no Linux®, LD_LIBRARY_PATH
● Em HP-UX, SHLIB_PATH e LD_LIBRARY_PATH
● Em AIX, LIBPATH
3. Em HP-UX PA-RISC, verifique se a variável de ambiente LD_PRELOAD contém /usr/lib/libcl.2.
4. Acesse o diretório instalação_Webserver/conf.
290 IBM Cognos Business Intelligence PowerPlay
Capítulo 10: Opções de configuração
5. Abra o arquivo httpd.conf em um editor.
6. Visando à integração bem-sucedida do portal, certifique-se de que SERVERNAME e
SERVER_PORT estejam especificados na propriedade ServerName.
7. Adicione o seguinte ao final da lista de carregamento de módulo:
LoadModule cognos_module "local_c10/cgi-bin/mod2_cognos.sufixo"
onde sufixo é exibido conforme listado na tabela a seguir:
SufixoSistema operacional
dllWindows®
soSolaris, AIX
slHP-UX PA-RISC
soHP-UX IA, Linux®
8. Adicione a seguinte Diretiva do Apache:
ScriptAlias /ibmcognos/cgi-bin "local_c10/cgi-bin"
Alias /ibmcognos "local_c10/webcontent"
<Directory "local_c10/webcontent">
Options Indexes MultiViews
</Directory>
A diretiva <Directory> é opcional.
Dica: verifique se definiu o alias ibmcognos/cgi-bin antes do alias ibmcognos.
9. Adicione o seguinte à seção de relatórios de status do servidor:
<Location /ibmcognos/cgi-bin/mod2_cognos.suffix>
SetHandler cognos-handler
</Location>
Digite o código exatamente como especificado, exceto para suffix. Substitua suffix pelo
valor apropriado da tabela na etapa 6.
10. Para ativar a página de diagnóstico do gateway, adicione o seguinte à seção de relatórios de
status do servidor:
<Location /ibmcognos/cgi-bin/diag_mod2_cognos. suffix>
SetHandler cognos-handler
</Location>
Digite o código exatamente como especificado, exceto para suffix. Substitua suffix pelo
valor apropriado da tabela na etapa 6.
Guia de instalação e configuração 291
Capítulo 10: Opções de configuração
11. Adicione o seguinte à seção de diretório do usuário:
<IfModule mod2_cognos.c>
CGIBinDir "local_c10/cgi-bin"
</IfModule>
12. Salve e feche o arquivo.
13. No HP-UX, ative a busca de SHLIB_PATH executando o seguinte comando no diretório
instalação_Apache/bin:
chatr +s enable +b enable httpd
14. Inicie o servidor web Apache.
15. Os usuários devem então especificar o URI do módulo Apache no navegador, da seguinte forma:
http://nome_host:porta/ibmcognos/cgi-bin/cognos_module
A string cognos_module deve ser digitada exatamente como especificado.
Por exemplo,
http://123.432.154.12:5562/c10/cgi-bin/cognos_module
Etapas para o Apache Server 2.2.x e IBM HTTP Server 7,0
1. Interrompa o servidor web.
2. Anexe o diretório local_c10/cgi-bin à variável de ambiente apropriada:
● No Solaris ou no Linux®, LD_LIBRARY_PATH
● Em HP-UX, SHLIB_PATH e LD_LIBRARY_PATH
● Em AIX, LIBPATH
3. Em HP-UX PA-RISC, verifique se a variável de ambiente LD_PRELOAD contém /usr/lib/libcl.2.
4. Vá para o diretório Apache_installation/conf .
5. Abra o arquivo httpd.conf em um editor.
6. Visando à integração bem-sucedida do portal, certifique-se de que SERVERNAME e
SERVER_PORT estejam especificados na propriedade ServerName.
7. Adicione o seguinte ao final da lista de carregamento de módulo:
LoadModule cognos_module "local_c10/cgi-bin/mod2_2_cognos.sufixo"
onde sufixo é exibido conforme listado na tabela a seguir:
SufixoSistema operacional
dllWindows®
soSolaris, AIX
292 IBM Cognos Business Intelligence PowerPlay
Capítulo 10: Opções de configuração
SufixoSistema operacional
slHP-UX PA-RISC
soHP-UX IA, Linux®
8. Adicione a seguinte Diretiva do Apache:
ScriptAlias /ibmcognos/cgi-bin "local_c10/cgi-bin"
Alias /ibmcognos "local_c10/webcontent"
<Directory "local_c10/webcontent">
Options Indexes MultiViews
</Directory>
A diretiva <Directory> é opcional.
Dica: verifique se definiu o alias ibmcognos/cgi-bin antes do alias ibmcognos.
9. Adicione a seguinte Diretiva do Apache:
ScriptAlias /ibmcognos/cgi-bin "local_c10/cgi-bin"
Alias /ibmcognos "local_c10/webcontent"
<Directory "local_c10/webcontent">
Options Indexes MultiViews
AllowOverride None
Options None
Order allow,deny
Allow from all
</Directory>
<Directory "local_c10/cgi-bin">
AllowOverride None
Options None
Order allow,deny
Allow from all
</Directory>
10. Adicione o seguinte à seção de relatórios de status do servidor:
<Location /ibmcognos/cgi-bin/cognos_module>
SetHandler cognos-handler
Order allow,deny
Allow from all
</Location>
Guia de instalação e configuração 293
Capítulo 10: Opções de configuração
Digite o código exatamente como especificado, incluindo a string cognos_module.
11. Para ativar a página de diagnóstico do gateway, adicione o seguinte à seção de relatórios de
status do servidor:
<Location /ibmcognos/cgi-bin/diag_cognos_module>
SetHandler cognos-handler
Order allow,deny
Allow from all
</Location>
Digite o código exatamente como especificado, incluindo a string diag_cognos_module.
12. No Windows, Solaris e AIX, adicione o seguinte à seção do diretório de usuários:
<IfModule mod2_2_cognos.c>
CGIBinDir "local_c10/cgi-bin"
</IfModule>
13. Salve e feche o arquivo.
14. Inicie o servidor Web.
15. Os usuários devem então especificar o URI do módulo Apache no navegador, da seguinte forma:
http://nome_host:porta/ibmcognos/cgi-bin/cognos_module
A string cognos_module deve ser digitada exatamente como especificado.
Por exemplo,
http://123.432.154.12:5562/c10/cgi-bin/cognos_module
Configuração do gateway de servletSe o gateway de servlet do IBM® Cognos® for configurado para ser executado em um servidor de
aplicativos compatível, o ambiente não necessita de um servidor web. O servidor de aplicativos e
o gateway de servlet do IBM Cognos substituem as funções fornecidas por um servidor web e outros
gateways do IBM Cognos.
Antes de criar e implantar o gateway de servlet do IBM Cognos, verifique se:
● O servidor de aplicativos está instalado e em execução em cada computador em que o gateway
de servlet está instalado.
● Os componentes gateway do IBM Cognos estão instalados no mesmo sistema que o servidor
de aplicativos.
● O distribuidor do IBM Cognos e os componentes do Content Manager estão instalados e em
execução no ambiente.
● A conta do usuário do servidor de aplicativos tem permissões de acesso total à instalação do
IBM Cognos.
Crie um novo grupo UNIX® ou Linux® chamado ibmcognos. O grupo deve conter o usuário
que inicia o servidor de aplicativos e o usuário possuidor dos arquivos do IBM Cognos. Altere
294 IBM Cognos Business Intelligence PowerPlay
Capítulo 10: Opções de configuração
a posse do grupo dos arquivos IBM Cognos para o grupo ibmcognos, e as permissões de arquivo
de todos os arquivos do IBM Cognos para GROUP READABLE/WRITABLE/EXECUTABLE.
Para simplificar, também é possível utilizar a conta do usuário do servidor de aplicativos para
instalar e executar os componentes do IBM Cognos.
Para configurar o gateway de servlet do IBM Cognos para ser executado em seu servidor de
aplicativos, execute as seguintes ações:
❑ Crie uma instância JVM separada, se necessário.
Se pretende executar o IBM Cognos BI e o gateway de servlet do IBM Cognos no mesmo
servidor de aplicativos, o gateway de servlet deve ser implantado em uma instância JVM
separada.
❑ Verifique se os componentes do IBM Cognos estão definidos corretamente.
❑ Defina variáveis de ambiente.
❑ Configure o gateway de servlet do IBM Cognos para ser executado no servidor de aplicativos.
❑ Mude o script de inicialização do servidor de aplicativos, se necessário.
❑ Configure as propriedades do servidor de aplicativos e implemente o gateway de servlet do
IBM Cognos.
❑ Ative o SSL, se necessário.
❑ Configure o servidor web.
É possível acessar os componentes do IBM Cognos utilizando o gateway de servlet do IBM Cognos,
inserindo o URI do gateway. Por exemplo,
http[s]:host_name:port/ServletGateway
O URI do gateway de servlet do IBM Cognos diferencia maiúsculas de minúsculas.
Alteração da versão do endereço IPO IBM® Cognos® é compatível com duas versões de endereços IP: IPv4 e IPv6. O IPv4 usa endereços
IP de 32 bits e o IPv6 usa endereços IP de 128 bits. Por exemplo:
● IPv4: 192.168.0.1:80
● IPv6: [2001:0db8:0000:0000:0000:148:57ab]:80
No IBM Cognos Configuration, é possível selecionar IPv4 ou IPv6 para comunicação do IBM
Cognos utilizando a propriedade Versão IP para resolução do nome do host. Como padrão, usa-se
IPv4.
A configuração é aplicada somente ao computador em que foi definida. Se selecionar Use endereços
IPv4, todas as conexões de saída do IBM Cognos nesse computador serão estabelecidas utilizando
o IPv4 e o distribuidor aceitará somente conexões IPv4 de entrada. Se selecionar Use endereços
IPv6, todas as conexões de saída do IBM Cognos nesse computador serão estabelecidas utilizando
IPv6 e o distribuidor aceitará tanto conexões de entrada IPv4 como IPv6.
Guia de instalação e configuração 295
Capítulo 10: Opções de configuração
Os computadores do cliente IPv4 conseguem se comunicar com computadores de distribuidor
configurados para IPv6.
Os nomes do host especificados dentro de um URI são resolvidos com base no valor da propriedade
Versão IP para resolução do nome do host. Entretanto, se um URI tiver sido especificado com um
endereço numérico, ele terá precedência sobre essa configuração e a comunicação ocorrerá utilizando
IPv4.
Para o IBM Cognos Configuration aceitar endereços IPv6 nas propriedades do URI local, inicie o
IBM Cognos Configuration com a opção -ipv6. É possível especificar a opção sempre que se abre
o IBM Cognos Configuration da linha de comando.
No Windows®, é possível definir a opção permanentemente, adicionando-a ao atalho do menu
Iniciar.
Etapas para definir a versão IP
1. Inicie o IBM Cognos Configuration.
2. Na janela Explorer, clique em Ambiente.
3. Clique na caixa Valor para Versão IP para resolução do nome do host e, a seguir. em Use
endereços IPv4 ou Use endereços IPv6.
4. No menu Arquivo, clique em Salvar.
5. Feche o IBM Cognos Configuration.
Etapas para ativar manualmente a opção IPv6 ao abrir o IBM Cognos Configuration
1. Acesse o diretório local_c10/bin.
2. Inicie o IBM Cognos Configuration incluindo a opção IPv6 no comando, da seguinte forma:
● No Windows, digite:
cogconfig.bat -ipv6
● No UNIX® ou no Linux®, digite
./cogconfig.sh -ipv6
3. Edite as propriedades do URI que utilizam o formato IPv6, especifique os valores e, no menu
Arquivo, clique em Salvar.
Etapas para sempre abrir o IBM Cognos Configuration com a opção IPv6 no Windows
1. No menu Iniciar, selecione Programas > IBM Cognos 10 e, em seguida, clique com o botão
direito do mouse em IBM Cognos Configuration, Propriedades.
2. Na guia Atalho, na caixa Destino, digite
"local_c10\bin\cogconfigw.exe -ipv6"
3. Clique em OK.
296 IBM Cognos Business Intelligence PowerPlay
Capítulo 10: Opções de configuração
Configuração do roteador para testar a disponibilidade dodistribuidor
Se for utilizado um roteador para distribuir solicitações aos distribuidores do IBM® Cognos®, e o
roteador puder testar a disponibilidade de um servidor usando um URL de teste, será possível
configurar o roteador para testar a disponibilidade de um distribuidor do IBM Cognos.
Etapa
● Configure o roteador para usar um URL com o caminho /p2pd/servlet/ping.
Se o distribuidor não estiver pronto, a seguinte resposta é exibida:
503 Serviço não disponível
Se o distribuidor estiver pronto, a seguinte resposta é exibida:
200 OK
Atualização de propriedades de locais do arquivo no WindowsVista
Se os componentes do cliente do IBM® Cognos® forem instalados em um ambiente que inclui o
Windows® Vista, será necessário alterar as propriedades dos locais de arquivo no IBM Cognos
Configuration para que o IBM Cognos possa usar um único local de dados para todos os usuários.
As alterações devem ser feitas em todos os computadores em que os componentes do cliente do
IBM Cognos estão instalados.
O Windows Vista possui um aprimoramento de segurança que restringe diversos usuários de
compartilhar locais de dados. Defina variáveis de ambiente e use-as no IBM Cognos Configuration
ao especificar locais de arquivos. Isso permite direcionar arquivos aplicáveis para uma área que
será acessível aos usuários do IBM Cognos. No Windows, duas variáveis de ambiente são predefinidas
para usuários: uma para todos os usuários e uma para um usuário específico.
Como as variáveis de ambiente representam locais raiz do sistema, também inclua o nome do
diretório raiz do local de instalação, ao especificar locais do arquivo no IBM Cognos Configuration.
O diretório raiz padrão para o IBM Cognos é o c10.
Etapas
1. Inicie o IBM Cognos Configuration.
2. Na janela Explorer, clique em Ambiente.
3. Na janela Propriedades, clique em Localização de arquivos de implantação.
4. Substitua o elemento de caminho relativo “..” com a variável de ambiente e diretório raiz
adequados:
● Para uma localização de arquivo única por usuário, %LOCALAPPDATA%
● Para uma localização de arquivo única para todos os usuários no computador, %PUBLIC%
Guia de instalação e configuração 297
Capítulo 10: Opções de configuração
Por exemplo,
Para definir uma localização de arquivo única por usuário, especifique o caminho
%LOCALAPPDATA%/c10/deployment.
5. Repita a etapa 4 para as seguintes propriedades:
● Em Ambiente,
- Localização dos arquivos de dados
- Localização de arquivos de mapa
- Localização dos arquivos temporários
● Em Ambiente, Log, Arquivo,
- Localização do arquivo de log
● Em Criptografia,
- Localização do banco de chaves simétricas comuns
● Em Criptografia, Cognos,
- Localização de certificados
- Localização do banco de chaves de assinatura
- Localização do banco de chaves de criptografia
6. No menu Arquivo, clique em Salvar.
As variáveis de ambiente são resolvidas quando os locais do arquivo são acessados durante as
atividades de sistema.
Alteração das definições de configuração para o serviço demigração do IBM Cognos Series 7
Se necessário, é possível alterar o número da porta do serviço usado pelo serviço de migração do
IBM Cognos Series 7.
Etapas
1. Vá para o diretório local_s7/migs7.
2. Localize o arquivo migs7service_configuration.xml e remova o atributo de somente leitura das
propriedades de arquivo.
3. Abra o arquivo em um editor de XML ou de texto sem formatação como o Bloco de notas.
4. Altere as configurações no arquivo para corresponder a seu ambiente.
5. Salve o arquivo.
6. Reinicie o serviço de migração:
298 IBM Cognos Business Intelligence PowerPlay
Capítulo 10: Opções de configuração
● No Windows, reinicie o serviço de migração usando a entrada do IBM Cognos Migration
Series 7 Service na lista Serviços em Ferramentas administrativas.
● No UNIX, interrompa e inicie o serviço de migração digitando os seguintes comandos no
diretório migs7service:
./configure.sh --stop
./configure.sh --start
Atribuição de uma conta de usuário ao PowerPlay e aos serviçosde migração para a migração
Por padrão, o serviço do IBM Cognos PowerPlay Enterprise Server e de migração usam uma conta
de sistema. Se diversos servidores do PowerPlay irão compartilhar locais de dados durante a
migração, primeiro é necessário atribuir uma conta de usuário aos serviços.
É necessário definir uma conta de usuário em cada computador com Windows em que os
componentes Series 7 Migration Components ou PowerPlay estão instalados.
Antes de atribuir a conta de usuário aos serviços, verifique se uma conta de usuário foi definida
com uma senha que nunca expira.
Etapas
1. No Painel de controle do Windows, em Ferramentas administrativas, clique em Serviços.
2. Clique no serviço do IBM Cognos PowerPlay Enterprise Server e em Inicialização.
3. No painel Fazer logon como, clique em Esta conta.
4. Na lista, selecione a conta de usuário definida para o serviço.
5. Digite a senha para a conta nas caixas de texto Senha e Confirmar senha.
6. Clique em OK.
7. Repita as etapas 2 a 5 no serviço de migração da Series 7.
Guia de instalação e configuração 299
Capítulo 10: Opções de configuração
300 IBM Cognos Business Intelligence PowerPlay
Capítulo 10: Opções de configuração
Capítulo 11: Configuração do Portal Services
O Portal Services oferece um conjunto de portlets do IBM® Cognos® que pode ser usado no IBM®
Cognos® Connection e em outros portais. É possível utilizar os portlets para navegar, buscar e
visualizar relatórios do IBM Cognos em seu ambiente de trabalho. Outros usuários podem visualizar
informações do IBM Cognos sem necessidade de saber utilizar esses produtos.
Para obter mais informações, consulte o Guia de administração e segurança.
O Portal Services é instalado automaticamente com os componentes do IBM Cognos. Em um
ambiente distribuído, ele está incluído com o Application Tier Components. A instalação inclui os
arquivos de implantação para
● Portal IBM WebSphere®
● Oracle WebCenter Interaction Portal
● SharePoint Portal
Para algumas implantações do Portal Services, é preciso modificar algumas configurações de
propriedades do Portal Services e preparar o ambiente do IBM Cognos para suportar outro portal.
Quando utilizado em um outro portal, o Portal Services pode autenticar usuários em apenas um
namespace. Se os componentes do IBM Cognos estiverem configurados com mais de um namespace,
será preciso instalar um gateway separado para cada namespace que será utilizado para autenticar
usuários do portal. É preciso configurar cada gateway para utilizar o namespace adequado e, em
seguida, configurar os portlets implantados para utilizar esse gateway.
Depois de configurar os portlets exigidos, é preciso implantar os portlets do Cognos para o outro
portal. Para obter mais informações, consulte o Guia de administração e segurança.
Para utilizar o Portal Services com os componentes do IBM Cognos, faça o seguinte:
❑ Especifique a localização do arquivo applications.xml, se necessário.
❑ Instale e teste os portlets no outro portal.
Para obter mais informações, consulte o Guia de administração e segurança.
❑ Configure a segurança para o ambiente do outro portal.
Especificação da localização do arquivo applications.xmlSe utilizar o arquivo applications.xml como parte de um portlet de aplicativo personalizado, todos
os computadores com Application Tier Components em um ambiente distribuído deverão utilizar
o mesmo arquivo applications.xml. Se tiver diversas instâncias do arquivo applications.xml, elas
deverão ser idênticas.
Licensed Materials – Property of IBM301© Copyright IBM Corp. 2005, 2010.
Observação: as etapas são necessárias apenas se deseja utilizar o portlet Extended Applications,
que está incluso no software development kit do IBM® Cognos® Business Intelligence.
Etapas
1. No computador do Application Tier Components, inicie o IBM Cognos Configuration.
2. Na janela do Explorer, em Ambiente, clique em Portal Services.
3. Na janela Propriedades, clique em Valor próximo a Localização de 'applications.xml’.
4. Substitua o localhost por um nome de host ou endereço IP válido e, se necessário, substitua o
número da porta padrão.
5. No menu Arquivo, clique em Salvar.
Agora é possível implantar os portlets do IBM Cognos no servidor do portal. Para saber as instruções,
consulte o Guia de administração e segurança.
Configuração da segurança para o Portal ServicesAo utilizar o Portal Services em outro portal, será necessário ativar o signon único para fornecer
integração entre o portal e os componentes do IBM® Cognos®.
O Portal Services usa um signon único para autenticar usuários. Isto significa que os usuários não
devem fazer logon para outros aplicativos separadamente no portal.
É necessário configurar um URI nos componentes do IBM Cognos para cada portlet no Portal
Services.
Para ativar a segurança entre os componentes do IBM Cognos e o outro portal, faça o seguinte:
❑ Desative o acesso anônimo aos componentes do IBM Cognos.
Caso a infra-estrutura de segurança necessite de um outro método de signon único, utilize um
dos métodos a seguir:
❑ Ative um signon único para o outro portal usando o shared secret.
Caso a infra-estrutura de segurança necessite de um outro método de signon único, utilize um
dos métodos a seguir:
● "Ativação do signon único para o portal WebSphere usando o servidor de aplicativos" (p. 307
)
● "Ativação de signon único para o portal Oracle WebCenter Interaction Portal usando
autenticação básica" (p. 308 )
● "Ativação de signon único para o portal Oracle WebCenter Interaction Portal usando o
SiteMinder" (p. 308 )
❑ Configure os componentes do IBM Cognos para acesso SSL, caso seja solicitado.
302 IBM Cognos Business Intelligence PowerPlay
Capítulo 11: Configuração do Portal Services
Desativação do acesso anônimo aos componentes do IBM CognosO Portal Services usa um signon único para a autenticação. Se o logon anônimo for ativado nos
componentes do IBM® Cognos®, o Portal Services registrará todos os usuários do portal como
anônimos. É necessário verificar se o acesso anônimo está desativado nos componentes do IBM
Cognos para que o signon único no Portal Services tenha êxito. Entretanto, teste as conexões do
Portal Services usando o logon anônimo para garantir que os portlets estejam funcionando no outro
portal.
Se o Portal Services não for capaz de autenticar um usuário, este recebe uma mensagem de erro no
outro portal.
Etapas
1. Inicie o IBM Cognos Configuration.
2. Na janela Explorer, em Segurança > Autenticação, clique em Cognos.
3. Na janela Propriedades, verifique se Permitir acesso anônimo está configurado como Falso.
4. No menu Arquivo, clique em Salvar.
5. Repita as etapas 1 a 4 em todos os servidores em que foram instalados os componentes do IBM
Cognos.
Ativação de signon único com Shared secretÉ possível usar o segredo compartilhado para o signon único entre os portlets do IBM® Cognos® e
os componentes do IBM® Cognos. Os portlets do Cognos enviam uma mensagem que contém uma
versão criptografada da ID do usuário do portal. A chave de criptografia é determinada pelo valor
de uma string de caractere secreta compartilhada entre os portlets e o provedor de segurança
personalizado JavaTM no servidor do IBM Cognos.
É possível usar um shared secret para o outro portal somente se as IDs do usuário do portal puderem
ser pesquisadas em um namespace de autenticação NTLM, LDAP ou IBM Cognos Series 7,
compartilhado pelos componentes do IBM Cognos.
Os componentes do IBM Cognos devem ter acesso a um servidor de diretório que contém as IDs
de usuário para todos os usuários do portal. Ao usar o IBM Cognos Configuration, é necessário
configurar um namespace de autenticação para que os componentes do portal e do IBM
Cognos compartilhem a mesma fonte de autenticação.
Também é necessário criar um namespace de Provedor Java personalizado para registrar o provedor
Java do shared secret fornecido com os componentes do IBM Cognos. Nos portlets ou iViews, é
necessário interligar um ou outro ao namespace do provedor Java personalizado em seu respectivo
portal:
● Cognos Portlet Application (WebSphere® Portal)
● Servidor remoto (Oracle WebCenter Interaction Portal)
● Cognos WebPart (SharePoint Portal)
Guia de instalação e configuração 303
Capítulo 11: Configuração do Portal Services
Não é pedido para configurar o acesso ao conteúdo web do Portal Services. Entretanto, se os portlets
forem implantados para outro portal, configure o acesso para um URI alternativo para as imagens
e conteúdo web do Portal Services.
Etapas para configurar os namespaces exigidos
1. No IBM Cognos Configuration, configure um namespace para autenticar os usuários do portal.
2. Para um namespace LDAP, configure as seguintes propriedades:
● Para a propriedade Utilizar identidade externa, altere a configuração para Verdadeiro.
● Para a propriedade Mapeamento de identidade externa, defina-a como
(uid=${environment("REMOTE_USER")})
Para o SharePoint Portal, se o SharePoint estiver em uma máquina diferente do servidor
LDAP, defina Mapeamento de identidade externa como
(uid=${replace(${environment("REMOTE_USER")},"SharePoint_Server\\","")})
3. Para um namespace do IBM Cognos Series 7, mapeie as IDs de usuário do portal para a ID de
usuário do IBM Cognos Series 7 que usarem os signons de OS.
Para obter mais informações, consulte a documentação do IBM Cognos Series 7.
4. No IBM Cognos Configuration, crie e configure um namespace de Provedor Java personalizado.
● Para a propriedade ID do Namespace, especifique uma nova ID.
Por exemplo, cpstrusted
Esta nova ID pode ser usada nas definições de configuração do portlet.
● Para a propriedade Nome da classe Java, digite
com.cognos.cps.auth.CPSTrustedSignon
Os nomes da classe Java diferenciam maiúsculas de minúsculas.
5. No IBM Cognos Configuration, em Ambiente > Portal Services, configure as seguintes
propriedades:
● Para ID do namespace de signon confiável, digite a ID do namespace para os namespaces
LDAP, NTLM ou IBM Cognos Series 7 configurados na etapa 1.
Dica: O namespace de signon confiável age como um intermediário e deve ser anexado a
um namespace real baseado em um diretório, do tipo LDAP, NTLM ou IBM Cognos
Series 7.
● Para Shared Secret, digite a chave a ser usada para o único signon.
Este parâmetro representa o segredo de autorização que deve ser compartilhado entre os
portlets da Cognos e o servidor do IBM Cognos. Considere isto uma senha secreta. É
necessário usar a mesma string de caractere ao configurar o aplicativo de portlet. É
necessário usar uma única palavra como a chave.
Por razões de segurança, especifique um valor não nulo.
304 IBM Cognos Business Intelligence PowerPlay
Capítulo 11: Configuração do Portal Services
6. Em Ambiente, para Configurações de gateway, defina a propriedade Permitir substituição do
namespace como verdadeira.
7. No menu Arquivo, clique em Salvar.
8. Reinicie o serviço do IBM Cognos.
Etapas para configurar acesso ao conteúdo web do Portal Services
1. No computador onde o Application Tier Components foi instalado, inicie o IBM Cognos
Configuration.
2. Na janela do Explorer, em Ambiente, clique em Portal Services.
3. Na janela Propriedades, clique na caixa de diálogo Valor próxima a URI do conteúdo na Web.
4. Especifique o nome do host ou endereço IP do gateway e um número de porta com o formato
host_ou_endereço_IP:porta
5. No menu Arquivo, clique em Salvar.
Etapas para configurar os portlets do Cognos para o portal WebSphere
1. Para cada aplicativo de portlet do Cognos, clique em Modify Parameters.
2. Para a propriedade cps_auth_secret, insira a string de caractere secreto usada para a propriedade
de Shared secret, quando foi configurado o namespace do Provedor Java personalizado.
3. Para a propriedade cps_auth_namespace, insira a ID do namespace do Provedor Java
personalizado.
4. Para a propriedade CPS Endpoint, insira o caminho do URL para acessar os componentes do
Portal Services no gateway.
O formato do URL é o seguinte:
● Para os portlets de conteúdo do Cognos
Gateway_URI/wsrp/cps4/portlets/nav?wsdl&b_action=cps.wsdl
Exemplo de um gateway CGI:
http://meuservidor/ibmcognos/cgi-bin/cognos.cgi/wsrp/cps4/portlets/nav?wsdl&b_
action=cps.wsdl
Exemplo de um gateway de servlet:
http://172.0.16.1:9500/wsrp/cps4/portlets/nav?wsdl&b_action=cps.wsdl
● Para Cognos Extended Applications
Gateway_URI/wsrp/cps4/portlets/sdk?wsdl&b_action=cps.wsdl
Exemplo de um gateway CGI:
http://meuservidor/ibmcognos/cgi-bin/cognos.cgi/wsrp/cps4/portlets/sdk?wsdl&b_
action=cps.wsdl
Guia de instalação e configuração 305
Capítulo 11: Configuração do Portal Services
Exemplo de um gateway de servlet:
http://172.0.16.1:9500/wsrp/cps4/portlets/sdk?wsdl&b_action=cps.wsdl
● Para portlets de Lista de monitoração do Metrics Manager
Gateway_URI/wsrp/cps4/portlets/cmm?wsdl&b_action=cps.wsdl
Exemplo de um gateway CGI:
http://meuservidor/ibmcognos/cgi-bin/cognos.cgi/wsrp/cps4/portlets/cmm?wsdl&b_
action=cps.wsdl
Exemplo de um gateway de servlet:
http://172.0.16.1:9500/wsrp/cps4/portlets/cmm?wsdl&b_action=cps.wsdl
Etapas para configurar o servidor remoto do Oracle WebCenter Interaction Portal
1. Usando um editor de ASCII simples, como o Bloco de notas, edite o arquivo cpsalui.properties
no diretório local_c10/cps/oracle/webapps/gadgets/WEB-INF/classes.
2. Configure as definições mostradas na tabela a seguir.
ValorParâmetro
O URL para conectar-se ao Application Tier Components e extrair as
informações WSDL.
cps_
endpoint
Especifique o URI do gateway
Para gateways de servlet ou ISAPI, substitua a porção localhost/ibmcognos/cgi-
bin/cognos.cgi pelos valores de direcionamento do gateway.
Por exemplo,
http://host_name/ibmcognos/cgi-bin/cognosisapi.dll/wsrp/cps4/portlets/
[package]?wsdl&b_action=cps.wsdl
Os nomes do cookie que devem ser enviados ao Application Tier Components
para um único signon.
forward_
cookies=
Deixar em branco.
O código shared secret que o IBM Cognos usa para criptografar uma variável
de cabeçalho HTTP carrega a identidade do usuário.
cps_auth_
secret
Este parâmetro representa o segredo de autorização que deve ser compartilhado
entre os portlets da Cognos e o servidor do IBM Cognos. Considere isto uma
senha secreta. Use o mesmo valor que em Shared secret no IBM Cognos
Configuration.
Por razões de segurança, especifique um valor não nulo.
A identificação de namespace para o Provedor Java personalizado.cps_auth_
namespace
306 IBM Cognos Business Intelligence PowerPlay
Capítulo 11: Configuração do Portal Services
3. Acesse o diretório local_c10/cps/oracle e execute o seguinte arquivo de criação:
● Nos sistemas operacionais UNIX® ou Linux®: build.sh.
● No sistema operacional Microsoft® Windows®: build.bat.
Isso cria um arquivo cps-wci.war no diretório local_c10/cps/oracle/gadgets.
4. Se os componentes do IBM Cognos BI estiverem usando o Tomcat,
● Interrompa o IBM Cognos BI.
● Copie o arquivo cps-wci.war no diretório local_c10/webapps.
O Tomcat expande automaticamente o arquivo WAR e inicia o servidor remoto.
● Inicie o IBM Cognos BI.
5. Se os componentes do IBM Cognos BI estão sendo executados em outro tipo de servidor de
aplicativos, copie o arquivo cps-wci.war para o servidor de aplicativos.
Para obter instruções, consulte o guia de administração de seu servidor de aplicativos.
O signon único está configurado.
Etapas para configurar propriedades do Cognos WebPart para o portal SharePoint
1. Usando um editor de ASCII simples como o Bloco de notas, edite o arquivo web.config no
diretório drive\Arquivos de programas\Arquivos comuns\Microsoft Shared\web server extensions\
12\CONFIG.
2. Localize a seguinte string:
<SSO cps_auth_namespace="" cps_auth_secret="" />
3. Defina cps_auth_namespace à ID do namespace para o Provedor Java personalizado.
4. Defina cps_auth_secret ao valor usado em Shared secret no IBM Cognos Configuration.
Ativação do signon único para o portal WebSphere usando o servidor de aplicativosOs portlets do Portal Services podem usar os objetos do Active Credentials fornecidos pelo
WebSphere® Portal para se conectar aos componentes do IBM® Cognos®. O Portal Services suporta
os objetos do Active Credentials: HttpBasicAuth, LtpaToken, SiteMinderToken e WebSealToken.
As credenciais para o usuário do portal são passadas ao gateway usando este objeto. Para obter
mais informações sobre os objetos Active Credential, consulte a documentação do portal IBM
WebSphere.
Para usar o signon único de servidor de aplicativos, consulte a documentação do Servidor de
aplicativos do IBM WebSphere.
Guia de instalação e configuração 307
Capítulo 11: Configuração do Portal Services
Ativação de signon único para o portal Oracle WebCenter Interaction Portalusando autenticação básica
É possível configurar um portlet no portal WebCenter para enviar o nome de usuário e senha como
um cabeçalho de autenticação HTTP Basic. O cabeçalho pode ser usado com um namespace de
autenticação NTLM, LDAP ou IBM® Cognos® Series 7 para fornecer signon único.
Etapas
1. No IBM Cognos Configuration, configure um namespace para autenticar os usuários do portal.
2. Instale um CGI ou ISAPI alternativo ou um gateway de servlet no IBM Cognos.
3. Configure o gateway.
4. No console de administração do servidor web, configure os diretórios visuais para acessar o
gateway.
Para obter mais informações, consulte a documentação de seu servidor web.
5. Configure o servidor remoto WebCenter para acessar o IBM Cognos BI:
● Edite o arquivo cpsalui.properties no diretório local_c10/cps/oracle/webapps/gadgets/WEB-
INF/classes.
● Altere a propriedade cps_endpoint de forma a indicar o URL do gateway.
Para gateways de CGI, é possível utilizar a configuração padrão se o gateway e o servidor
remoto estiverem no mesmo computador. Do contrário, substitua a porção de localhost
com host_name:port
Para gateways de servlet ou ISAPI, substitua a porção localhost/ibmcognos/cgi-bin/cognos.
cgi pelos valores de direcionamento do gateway.
Por exemplo,
http://nome_host:porta/ibmcognos/cgi-bin/cognosisapi.dll/wsrp/cps4/portlets/
[package]?wsdl&b_action=cps.wsdl
● Configure a propriedade cps_auth_namespace para o namespace que deseja utilizar para
autenticação.
Ativação de signon único para o portal Oracle WebCenter Interaction Portalusando o SiteMinder
Se usar o eTrust SiteMinder para fornecer o signon único em sua infraestrutura de segurança,
também é possível usá-lo para o signon único com o portal WebCenter.
É necessário configurar um namespace de autenticação SiteMinder no IBM® Cognos® BI. O portal
WebCenter envia ao SiteMinder um token de autenticação ativo para o servidor remoto, que envia
o token ao gateway do IBM Cognos.
Etapas
1. No IBM Cognos Configuration, configure um namespace de autenticação do SiteMinder.
308 IBM Cognos Business Intelligence PowerPlay
Capítulo 11: Configuração do Portal Services
2. Configure o servidor remoto para encaminhar a token de autenticação:
● Edite o arquivo cpsalui.properties no diretório local_c10/cps/oracle/webapps/gadgets/WEB-
INF/classes.
● Mude a propriedade forward_cookies para incluir o nome da token de autenticação ativa
que o SiteMinder fornece.
● Altere a propriedade cps_endpoint de forma a indicar o URL do gateway.
Para gateways de CGI, é possível utilizar a configuração padrão se o gateway e o servidor
remoto estiverem no mesmo computador. Do contrário, substitua a porção de host local
por nome_do_host:porta.
Para gateways de servlet ou ISAPI, substitua a porção localhost/ibmcognos/cgi-bin/cognos.
cgi pelos valores de direcionamento do gateway.
Por exemplo,
http://nome_host:porta/ibmcognos/cgi-bin/cognosisapi.dll/wsrp/cps4/portlets/
[package]?wsdl&b_action=cps.wsdl
● Altere a propriedade cps_auth_namespace para o namespace que deseja utilizar para
autenticação.
Guia de instalação e configuração 309
Capítulo 11: Configuração do Portal Services
310 IBM Cognos Business Intelligence PowerPlay
Capítulo 11: Configuração do Portal Services
Capítulo 12: Configuração do IBMCognos BI paraservidores de aplicativos diferentes do Tomcat
Por padrão, o IBM® Cognos® Business Intelligence instala e utiliza o Tomcat como o servidor de
aplicativos. É possível escolher executar o IBM Cognos BI em um outro servidor suportado:
● Servidor BEA WebLogic
● Servidor de aplicativos IBM WebSphere®
● Servidor de aplicativos Oracle
● Red Hat JBoss
● O servidor de aplicativos Sun JavaTM Systems (somente para sistemas operacionais Microsoft®
Windows®, Linux® e Solaris)
Para o IBM Cognos BI para Linux no System z, o servidor IBM WebSphere Application é compatível.
Para garantir que o produto funcione corretamente, aplique todos os patches de sistema operacional
minimamente necessários e utilize somente as versões de outros softwares que sejam compatíveis
com o produto do IBM® Cognos®.
Para visualizar uma lista atualizada de ambientes suportados pelos produtos IBM Cognos, como
sistemas operacionais, patches, navegadores e servidores da web, de diretório, de bancos de dados
e de aplicativos, visite o site do IBM Cognos Customer Center (www.ibm.com/software/data/cognos/
customercenter/).
É importante observar que o sistema operacional Linux® está disponível em várias distribuições e
suporta uma série de plataformas de hardware. Certifique-se de que a combinação do sistema
operacional e do hardware usados é compatível.
É possível escolher executar o IBM Cognos Servlet Gateway em um servidor de aplicativos suportado
em vez de usar um servidor web (p. 294 ). Ao usar o gateway de servlet, o ambiente dispensa o uso
de servidores web. O servidor de aplicativos e o gateway de servlet substitui as funções oferecidas
pelo servidor web e outros gateways IBM Cognos.
Para obter informações sobre como configurar uma instalação distribuída com vários servidores
do IBM Cognos BI em um ambiente de servidor de aplicativos, entre em contato com o IBM Cognos
Customer Center (http://www.ibm.com/software/data/cognos/customercenter/).
O IBM Cognos BI deve ser instalado e estar funcionando antes de configurar e implantar o IBM
Cognos Servlet Gateway.
Para definir o IBM Cognos BI para que seja executado no servidor de aplicativos, faça o seguinte:
❑ Crie uma instância JVM separada, se necessário.
❑ Crie perfis adicionais se estiver distribuindo componentes do IBM Cognos BI
❑ Verifique se os componentes do IBM Cognos estão definidos corretamente.
Licensed Materials – Property of IBM311© Copyright IBM Corp. 2005, 2010.
❑ Faça backup de quaisquer dados e chaves de criptografia existentes do IBM Cognos, se
necessário.
❑ Defina variáveis de ambiente.
❑ Configure os componentes do IBM Cognos para serem executados no servidor de aplicativos.
❑ Identifique o JDK para WebLogic 9 no AIX®, se necessário.
❑ Mude o script de inicialização do servidor de aplicativos, se necessário.
❑ Configure propriedades do servidor de aplicativos e implante o IBM Cognos BI.
❑ Ative o SSL, se solicitado.
❑ Configure o servidor web.
❑ Remova o registro de distribuidores que não são mais utilizados.
❑ Importe qualquer dado do armazenamento de conteúdo com backup.
Depois de configurar o IBM Cognos BI para que seja executado no servidor de aplicativo, é possível
realizar algumas tarefas de configuração adicionais para personalizar o comportamento de
componentes do IBM Cognos de forma a melhor atender ao ambiente de relatórios (p. 233 ).
Dica: para o servidor de aplicativos ou o IBM Cognos BI, não utilize caminhos de instalação que
contenham espaços. Os espaços interferem nos scripts internos e parâmetros de comandos. Se
precisar utilizar caminhos de instalação com espaços, utilize a convenção de nomenclatura 8.3 do
DOS ao se referir a essas localizações.
Criação de instâncias JVM separadasPara eliminar possíveis conflitos de classe JavaTM ou de recursos de sistema, o IBM® Cognos® BI
deve ser executado em uma instância Java Virtual Machine (JVM) isolada de outros aplicativos
existentes. Isso garante que o IBM Cognos BI não afete nenhum aplicativo de cliente existente.
Sempre que possível, o IBM Cognos BI deve ser instalado em um instância Java que seja separada
dos processos administrativos do servidor de aplicativos para isolar tanto o IBM Cognos BI como
as funções administrativas do servidor de aplicativos.
Uma instância JVM isolada pode ser estabelecida criando um dos seguintes:
● Um servidor gerenciado separado no BEA WebLogic.
● Uma instância de servidor separada no IBM WebSphere®
● Uma instância OC4J separada no Servidor de aplicativos Oracle 10g.
● Uma instância de servidor separada para Red Hat JBoss.
● Um domínio separado para o Servidor de aplicativos Sun Java Systems.
Se estiver usando o IBM Cognos Servlet Gateway, ele deverá ser executado em uma instância
separada do IBM Cognos BI.
312 IBM Cognos Business Intelligence PowerPlay
Capítulo 12: Configuração do IBM Cognos BI para servidores de aplicativos diferentes do Tomcat
Criação de perfis adicionais para distribuir componentes doIBM Cognos BI para o Linux no System z
Se estiver instalando componentes do IBM® Cognos® BI em várias localizações no sistema operacional
Linux® no System z, será necessário criar perfis adicionais para o servidor de aplicativos WebSphere®.
Cada perfil pode ser usado para executar um componente do IBM Cognos BI.
Por exemplo, é possível ter o componente Content Manager instalado e em execução usando um
perfil do WebSphere, enquanto os Application Tier Components pode ser executados um outro
perfil do WebSphere. Os perfis permitem que cada componente seja executado utilizando números
de porta exclusivos.
Um script chamado create_profile.sh é fornecido para permitir a criação de perfis adicionais no
WebSphere. É possível usar o perfil padrão para um componente do IBM Cognos BI. Porém, para
cada componente adicional instalado do IBM Cognos BI, é preciso criar um perfil adicional.
Quando executa o script, é solicitada a localização da instalação do WebSphere e será possível rever
e mudar os números de porta que o script usará para o perfil.
Embora o script configure muitos números de porta, o número da porta para o WC_adminhost é
aquele necessário para iniciar o console de administração em um navegador. O número da porta
para o WC_defaulthost é aquele no qual os Serviços IBM Cognos, como o distribuidor, serão
executados. Se pretende usar o SSL para o IBM Cognos BI, os números de porta para o
WC_adminhost_secure e o WC_defaulthost_secure serão necessários para configurar e executar
componentes do IBM Cognos BI.
Para executar o script, é preciso ter as mesmas permissões que aquelas necessárias para instalar o
WebSphere.
Etapas
1. Vá para o diretório local_c8/C8SE.
2. Execute o script utilizando o seguinte comando:
./create_profile.sh profile_name
onde profile_name é o nome do perfil que o script criará. O perfil padrão criado quando da
instalação do WebSphere é chamado server1. Digite um nome de perfil diferente.
3. Quando solicitado, faça um dos seguintes:
● Digite Y para rever ou alterar os números de porta que o script utilizará para o perfil.
Quando digitar Y, um arquivo de propriedades será aberto no editor vi. Utilize os comandos
do editor vi para editar e salvar o arquivo.
● Pressione qualquer outra tecla para executar o script utilizando os números de porta
selecionados. O script utilizará números de porta disponíveis.
Quando o script tiver terminado, inicie o WebSphere com o novo perfil.
Guia de instalação e configuração 313
Capítulo 12: Configuração do IBM Cognos BI para servidores de aplicativos diferentes do Tomcat
Verificação das configurações de componentes do IBM CognosVerifique se foi feito o seguinte antes de configurar os componentes do IBM® Cognos® para serem
executados no servidor de aplicativos:
❑ Os componentes do IBM Cognos estão instalados.
❑ Antes de iniciar o IBM Cognos BI, o banco de dados para o armazenamento de conteúdo deve
ser definido. Instale e configure clientes de banco de dados, se necessário (p. 140 ), e, em seguida,
teste a conectividade do banco de dados.
❑ O servidor de aplicativos está instalado e funcionando em cada computador onde os
componentes do IBM Cognos estão instalados.
Para obter mais informações sobre a instalação, consulte a documentação do servidor de
aplicativos.
❑ A localização da instalação totalmente qualificada de todas as fontes é especificada em todos
os computadores de Application Tier Component. Especifique essa localização no IBM Cognos
Configuration (p. 249 ). Por padrão, a localização da instalação não utiliza um caminho
totalmente qualificado.
❑ A conta do usuário do servidor de aplicativos tem permissões de acesso total à instalação do
IBM Cognos.
Dica: crie um novo grupo nos sistemas operacionais UNIX® ou Linux® chamado ibmcognos.
O grupo deve conter o usuário que inicia o servidor de aplicativos e o usuário possuidor dos
arquivos do IBM Cognos. Altere a posse do grupo dos arquivos IBM Cognos para o grupo
ibmcognos, e as permissões de arquivo de todos os arquivos do IBM Cognos para GROUP
READABLE/WRITABLE/EXECUTABLE. Para simplificar, também é possível utilizar a conta
do usuário do servidor de aplicativos para instalar e executar os componentes do IBM Cognos.
Backup de informações do IBM Cognos existentesFaça o backup das informações existentes do IBM® Cognos® se os componentes do IBM Cognos
BI estiverem em execução em um servidor de aplicativos (incluindo o Tomcat) e estiver mudando
para um servidor de aplicativos que vem com seu próprio JVM. Faça backup também das
informações do IBM Cognos existentes se tiver que mudar o JVM em uso.
Observação: É necessário fazer backup de informações do IBM Cognos existentes no ambiente de
trabalho antes da atualização.
Antes de configurar os componentes do IBM Cognos BI para que seja executado no novo servidor
de aplicativos ou JVM, é preciso fazer o backup de
● Dados de armazenamento de conteúdo criando uma exportação de implantação.
● Informações de configuração por meio de sua exportação. Qualquer dado criptografado é
descriptografado durante a exportação.
● Chaves de criptografia salvando-as em uma localização alternativa. Novas chaves de criptografia
devem ser criadas utilizando o mesmo JVM que o servidor de aplicativos utiliza. Como essas
314 IBM Cognos Business Intelligence PowerPlay
Capítulo 12: Configuração do IBM Cognos BI para servidores de aplicativos diferentes do Tomcat
chaves só podem ser criadas se as chaves anteriores forem excluídas, é importante fazer backup
das chaves anteriores.
Para garantir a segurança e a integridade dos dados do IBM Cognos data, faça backup do
armazenamento de conteúdo, das informações de configuração, das chaves de criptografia em um
diretório que esteja protegido contra acesso não autorizado ou indevido.
Dica: para verificar a existência de chaves de criptografia, verifique o diretório
local_c10/configuration. As chaves de criptografia existem se esse diretório apresenta os seguintes
subdiretórios: csk, encryptkeypair ou signkeypair.
Etapas
1. Se houver dados no armazenamento de conteúdo, inicie o serviço IBM Cognos e exporte todo
o armazenamento de conteúdo utilizando a ferramenta de implantação.
Para obter mais informações, consulte o tópico sobre a criação de especificações de implantação
de exportação no Guia de administração e segurança.
2. No IBM Cognos Configuration, no menu Arquivo, clique em Exportar como e salve as
informações de configuração em um formato descriptografado. Ao nomear um arquivo, utilize
um nome como "decrypted.xml".
Exporte os dados para um diretório que esteja protegido contra acesso não autorizado ou
indevido, pois as senhas são armazenadas como texto comum. É solicitado o reconhecimento
de que a exportação é uma operação insegura.
3. Interrompa o serviço do IBM Cognos:
● Se estiver usando o Tomcat, interrompa o serviço IBM Cognos e feche o IBM Cognos
Configuration.
● Se utilizar um servidor de aplicativos diferente do Tomcat, encerre o IBM Cognos BI em
seu ambiente.
4. Faça backup de chaves de criptografia existente salvando arquivos e diretórios corretos em
uma localização alternativa que seja segura.
Os arquivos são
● local_c10/configuration/cogstartup.xml
● local_c10/configuration/caSerial
● local_c10/configuration/cogconfig.prefs
● local_c10/configuration/coglocale.xml
Os diretórios são
● local_c10/configuration/csk
● local_c10/configuration/encryptkeypair
● local_c10/configuration/signkeypair
Guia de instalação e configuração 315
Capítulo 12: Configuração do IBM Cognos BI para servidores de aplicativos diferentes do Tomcat
5. Exclua os arquivos caSerial e cogconfig.prefs e os três diretórios: csk, encryptkeypair e
signkeypair.
6. Substitua o arquivo local_c10/configuration/cogstartup.xml pelo arquivo que contém os dados
exportados do IBM Cognos Configuration (por exemplo, "decrypted.xml").
No diretório local_c10/configuration, o arquivo deve usar o nome "cogstartup.xml".
As informações nesse arquivo serão automaticamente criptografadas novamente utilizando
novas chaves de criptografia quando salvar a configuração no IBM Cognos Configuration.
Definição de variáveis de ambienteÉ preciso definir variáveis de ambiente para identificar a localização do ambiente JavaTM Virtual
Machine (JVM) e o caminho da biblioteca. É possível definir variáveis de ambiente utilizando
qualquer um dos seguintes métodos:
● No sistema operacional Microsoft® Windows®, defina uma variável de sistema ou de usuário
ou edite o script de inicialização do servidor de aplicativos.
Se definir uma variável de usuário, verifique se ela está definida para a conta de usuário que
executará o servidor de aplicativos ou console de administração.
● Nos sistemas operacionais UNIX® e Linux®, defina uma variável de ambiente no perfil do
usuário ou edite o script de inicialização do servidor de aplicativos.
Para obter informações sobre a edição do script de inicialização do servidor de aplicativos, consulte
"Alteração do script de inicialização do servidor de aplicativos" (p. 320 ).
Dica: A maioria das versões de servidor de aplicativos vem com um script especialmente destinado
à definição de variáveis de ambiente. Por exemplo, algumas versões do IBM® WebSphere® vêm com
setupCmdLine.bat ou setupCmdLine.sh, o WebLogic vem com setEnv.cmd ou setEnv.sh, e o Oracle
vem com iasenv.bat ou iasenv.sh. Esses scripts podem ser alterados para definir valores adequados
para uso com os componentes do IBM® Cognos®. A maioria desses scripts definem a variável de
ambiente JAVA_HOME por padrão.
Etapas
1. Defina a variável de ambiente JAVA_HOME para apontar ao JVM utilizado pelo servidor de
aplicativos.
Dica: Se o servidor de aplicativos vier com um JVM, então a variável de ambiente JAVA_HOME
deverá ser definida para fazer referência a ele.
O IBM Cognos Configuration utiliza essa variável para criar chaves de criptografia para
componentes do IBM Cognos que são compatíveis com o JVM utilizado pelo servidor de
aplicativos.
Por exemplo, para o WebLogic no Windows, o JVM utilizado pelo servidor de aplicativos é
especificado como:
unidade:/local_WebLogic/jdkversion
2. Anexe o local_c10/bin à variável de ambiente adequada da tabela a seguir.
316 IBM Cognos Business Intelligence PowerPlay
Capítulo 12: Configuração do IBM Cognos BI para servidores de aplicativos diferentes do Tomcat
Variável do ambienteSistema operacional
PATHWindows
LIBPATHAIX®
LD_LIBRARY_PATHSolaris e Linux
SHLIB_PATHHP-UX
A variável do ambiente do caminho da biblioteca é utilizada para localizar os arquivos de
biblioteca do IBM Cognos.
Dica: para instalar várias instâncias do IBM Cognos BI em um único servidor, defina as variáveis
PATH, LIBPATH, LD_LIBRARY_PATH ou SHLIB_PATH no escopo da instância do servidor
de aplicativos, e não como uma variável global, a fim de garantir que cada instância tenha um
valor único.
Observação: as variáveis CRN_ROOT e COG_ROOT não são mais necessárias em um ambiente
sem clusters, e devem ser removidas se foram instaladas em uma instalação anterior.
Observação: verifique se os arquivos de biblioteca de 32 bits ou 64 bits estão definidos nas variáveis
de ambiente. Para uma versão de 64 bits do IBM Cognos BI, os arquivos da biblioteca de 64 bits
devem ser listados primeiro. Para uma versão de 32 bits, os arquivos de biblioteca de 32 bits devem
ser listados primeiro.
Ajuste do tempo limite de conexão padrão para o IBM CognosBI
O valor do tempo limite do pool de conexão padrão usado no IBM® Cognos® BI é de 25 segundos.
Alguns servidores de aplicativos, como o IBM WebSphere®, usam um valor menor para o tempo
limite de conexão padrão. Para evitar conflitos entre as definições de tempo limite de conexão
padrão, configure o valor do tempo limite do pool de conexão padrão no IBM Cognos BI para uma
duração menor do que a configurada para o servidor de aplicativos.
Etapas
1. Usando um editor, abra o arquivo local_c10\configuration\BIBusTK_Config.xml.
2. Localize a seguinte string:
<BIBUSTK_CONNECTION_TIMEOUT>25000</BIBUSTK_CONNECTION_TIMEOUT>
3. Altere o valor para 90% do valor especificado para o servidor de aplicativo.
Por exemplo, o WebSphere usa um valor de tempo limite da conexão padrão de 30 segundos.
Calcule 90% dos 30 segundos, que é 27 segundos. Altere a string para:
<BIBUSTK_CONNECTION_TIMEOUT>27000</BIBUSTK_CONNECTION_TIMEOUT>
4. Salve o arquivo.
Guia de instalação e configuração 317
Capítulo 12: Configuração do IBM Cognos BI para servidores de aplicativos diferentes do Tomcat
5. Repita essas etapas em todos os computadores em que o IBM Cognos BI estiver instalado.
A definição será aplicada ao implantar o IBM Cognos BI à instância do servidor criada para isso.
Configuração dos componentes do IBM Cognos para seremexecutados no servidor de aplicativos
O IBM® Cognos® BI deve ser configurado com as informações de configuração do servidor de
aplicativos, e a configuração deve ser salva para criar novas chaves criptográficas. O IBM Cognos
Configuration usa o JavaTM Virtual Machine (JVM) definido pela variável de ambiente
JAVA_HOME.
Defina a variável de ambiente JAVA_HOME para o JVM fornecido ou utilizado pelo servidor de
aplicativos e, em seguida, copie os arquivos provedores de segurança antes de executar o IBM
Cognos Configuration para garantir que chaves de criptografia válidas sejam geradas.
Etapas
1. No diretório local_c10/bin directory, inicie o IBM Cognos Configuration:
● No sistema operacional Microsoft® Windows®, digite cogconfig.bat em uma janela de
comando ou selecione IBM Cognos Configuration no menu Iniciar.
● Nos sistemas operacionais UNIX® ou Linux®, digite cogconfig.sh.
Se houver chaves de criptografia incompatíveis, será solicitada a geração automática de novas
chaves neste momento.
Dica: Verifique se foi feito backup das chaves existentes em uma localização segura antes de
prosseguir. Não há ação de desfazer disponível após a geração de novas chaves.
2. Utilize o Assistente para Criação de Aplicativo para criar o arquivo de aplicativo que será
implantado no servidor de aplicativos. Para iniciar o Assistente para criação de aplicativos no
IBM Cognos Configuration, em Ações, clique em Criar Arquivos de Aplicativos. O assistente
permite selecionar o tipo de aplicativo para criar e a raiz de contexto utilizada para acessar o
aplicativo.
É necessário criar o arquivo de aplicativo no mesmo computador no qual o arquivo será
implantado.
O valor de raiz do contexto inserido no assistente deve ser igual ao inserido na guia Environment
e utilizado para implantar o servidor de aplicativos. Para o IBM Cognos BI, o nome do diretório
da raiz do contexto padrão e do diretório do aplicativo é p2pd, que pode ser usado na maioria
dos casos. Para o IBM Cognos Servlet Gateway, a raiz do contexto padrão e o nome do diretório
de aplicativos é ServletGateway. Outros valores de implantação do aplicativo, tais como o
nome do aplicativo, podem ser alterados para melhor se adequarem ao ambiente do sistema.
Dica: Não é necessário recriar ou implantar novamente o arquivo quando fizer mudanças na
configuração porque as informações de configuração são armazenadas externamente ao
aplicativo.
318 IBM Cognos Business Intelligence PowerPlay
Capítulo 12: Configuração do IBM Cognos BI para servidores de aplicativos diferentes do Tomcat
Para WebLogic e JBoss, é possível utilizar o Assistente para Criação de Aplicativo no IBM
Cognos Configuration para criar o aplicativo em um diretório expandido.
Por exemplo, para WebLogic, o aplicativo é colocado em C:\bea\user_projects\domains\apps\
p2pd, onde p2pd é o nome do aplicativo. Ao implantar o aplicativo do console do WebLogic
Administration, selecione o diretório p2pd.
Para o JBoss, se utilizar a opção Expandir arquivos em uma pasta, inclua a extensão .war no
nome da pasta em que o assistente criará o aplicativo p2pd. Quando o assistente solicita a
localização da pasta, vá até JBoss_location/server/instance_name/deploy e crie uma pasta
chamada p2pd.war.
Para obter informações sobre qual tipo de arquivo de aplicativo, WAR, EAR ou diretório
expandido, é suportado em seu ambiente, consulte a documentação do servidor de aplicativos.
3. Na janela Explorer do IBM Cognos Configuration, expanda Ambiente e altere as seguintes
propriedades para usar o número da porta e nome de host ou endereço IP do servidor em que
o componente e servidor de aplicativos do IBM Cognos BI estão instalados.
● Todos os URIs para o distribuidor, incluindo
URIs de distribuidores do gateway
URI do distribuidor externo
URI do distribuidor interno
URIs do distribuidor para aplicativos externos
● URI do gateway
● URIs do Content Manager
O servidor de aplicativos deve ser configurado para ouvir o nome do host ou endereço IP
inserido no URI. Para obter mais informações, consulte a documentação do servidor de
aplicativos.
Se mudar a raiz do contexto para um valor diferente do padrão de p2pd, mude também a parte
da raiz do contexto do URI.
4. Em Ambiente > Serviços IBMCognos, clique com o botão direito em IBMCognos e em Excluir.
A entrada para o serviço IBM Cognos é utilizada para configurar definições de ambiente para
execução no Tomcat. A entrada não é necessária quando utilizar um servidor de aplicativo
diferente.
5. Complete outras mudanças de configuração necessárias, como
● Especificar propriedades para o banco de dados do Content Manager.
● Inserir IDs do usuário e senhas.
Se utilizar as definições padrão para a instalação do IBM Cognos, será necessário fazer apenas
pequenas mudanças às definições de configuração padrão (p. 233 ).
6. Salve a configuração.
Guia de instalação e configuração 319
Capítulo 12: Configuração do IBM Cognos BI para servidores de aplicativos diferentes do Tomcat
Novas chaves criptográficas são criadas utilizando o JVM que é definido pela variável
JAVA_HOME.
7. Feche o IBM Cognos Configuration.
Identificação do JDK para WebLogic 9 no AIXO WebLogic 9 exige o JavaTM Development Kit (JDK) 1.5. Se utilizar o WebLogic Server 9 no AIX®,
será preciso atualizar as opções Java no arquivo commEnv.sh para especificar o identificador
exclusivo da versão serial correta (UID). Se essa atualização não for feita, ocorrerá uma discordância
de UID de versão serial ao utilizar o WebLogic Server 9 com IBM® Java 5.
Etapas
1. Abra o arquivo WebLogic9_location/common/bin/commEnv.sh.
2. Modifique o arquivo para incluir o seguinte comando:
JAVA_OPTIONS="${JAVA_OPTIONS} -Dcom.sun.xml.namespace.QName.useCompatibleSerialVersionUID=1.0" export JAVA_OPTIONS
3. Salve e feche o arquivo commEvn.sh.
Alteração do script de inicialização do servidor de aplicativosAlguns servidores de aplicativos possuem exigências específicas que precisam ser obedecidas antes
de poder executar o IBM® Cognos® BI. Dependendo do servidor de aplicativos, pode ser necessário
definir variáveis de ambiente, copiar arquivos e adicionar ou mudar códigos em arquivos.
Se estiver utilizando Red Hat JBoss ou BEA WebLogic Server , faça as mudanças no script de
inicialização do servidor de aplicativos. O script de inicialização deve ser alterado para especificar
as definições de JavaTM Virtual Machine (JVM). Para JBoss, especifique também um argumento
log4j. Para o WebLogic 9, use o console de administração para modificar o ambiente WebLogic.
Se estiver utilizando o Servidor de aplicativos IBM WebSphere® ou o servidor de aplicativos Oracle,
nenhuma alteração do script de inicialização será necessária a menos que pretenda adicionar as
alterações de variáveis de ambiente. Se fizer mudanças, o console de administração poderá ser
utilizado.
Para Red Hat JBoss, crie uma cópia da instância do servidor padrão para que possa utilizar a
instância de servidor padrão original como backup. Dê à cópia um nome que não utilize espaços,
como cognos.
Se o ambiente contiver um JRE que está sendo utilizado para outros produtos, a pasta JRE poderá
conter arquivos .jar que não são compatíveis com os arquivos .jar fornecidos com o IBM Cognos BI.
Isso pode resultar em uma falha ao iniciar o IBM Cognos BI no servidor de aplicativos. Nessa
situação, direcione o IBM Cognos BI para utilizar os arquivos .jar aprovados, incluindo o seguinte
parâmetro na linha de comando Java:
320 IBM Cognos Business Intelligence PowerPlay
Capítulo 12: Configuração do IBM Cognos BI para servidores de aplicativos diferentes do Tomcat
-Djava.endorsed.dirs=${ibmcognos_home}/tomcat[version]/common/endorsed
Etapas para WebLogic
1. Crie um domínio WebLogic Server (WLS) para IBM Cognos BI.
Se estiver configurando o IBM Cognos Servlet Gateway, crie um segundo domínio para esse
aplicativo.
Para obter informações sobre a criação de domínios, consulte a documentação do WebLogic.
2. Acesse o diretório local_WebLogic9/user_projects/domains/nome_do_domínio/bin e abra o
script de inicialização do servidor de aplicativos com um editor.
O nome do script de inicialização pode variar dependendo do tipo de instalação de WebLogic
feita. Por exemplo: em uma instalação gerenciada de servidor, o nome do script de inicialização
é startManagedWebLogic.sh (sistema operacional UNIX®) ou startManagedWebLogic.cmd
(sistema operacional Microsoft® Windows®).
3. Para versões de JRE não IBM, selecione o modo de execução JVM e mude a definição padrão
de JAVA_VM= para JAVA_VM=-server
4. Modifique o JAVA_OPTIONS para definir o analisador XML adequado para IBM Cognos BI.
Adicione a terceira linha, como mostra o exemplo a seguir:
JAVA_OPTIONS=
-Dweblogic.security.SSL.trustedCAKeyStore=%WL_HOME%\server\lib\cacerts-Dorg.xml.sax.driver=org.apache.xerces.parsers.SAXParser
5. Defina a memória máxima e mínima utilizada pelo JVM.
Geralmente, a memória é definida através de dois parâmetros JVM: -Xms e -Xmx. Como valores
iniciais, são sugeridos 256 MB como mínimo e 768 MB como máximo. É possível alterar esses
valores para melhor se adequarem ao ambiente.
O parâmetro MaxPermSize também deve ser definido. Eis um exemplo:
-XX:MaxPermSize=128m
Para obter informações sobre os parâmetros JVM, consulte a documentação do JVM ou do
servidor do aplicativo.
6. Verifique se o modo de produção está ativado alterando PRODUCTION_MODE= to
PRODUCTION_MODE=true.
7. Salve e feche o arquivo.
Etapas para JBoss
1. Vá ao diretório JBoss_location/bin e abra o script de inicialização do servidor de aplicativos
em um editor. Execute um dos seguintes procedimentos:
● Para Windows, abra run.bat
● Para os sistemas operacionais UNIX ou Linux®, abra run.sh
2. Vá para a variável JAVA_OPTS e adicione os parâmetros a seguir:
-Xms512m -Xmx1024m
Guia de instalação e configuração 321
Capítulo 12: Configuração do IBM Cognos BI para servidores de aplicativos diferentes do Tomcat
-XX:PermSize=64m -XX:MaxPermSize=256m
-Dorg.jboss.resolver.warning=true
-Dsun.rmi.dgc.client.gcInterval=3600000
-Dsun.rmi.dgc.client.gcInterval=3600000
-DLog4j.defaultInitOverride=true
As definições de memória mínima e máxima são sugeridas como valores iniciais. É possível
alterar esses valores para melhor se adequarem ao ambiente. Para obter informações sobre os
parâmetros, consulte a documentação do JVM ou do servidor do aplicativo.
3. Para HP Itanium® de 64 bits, adicione também os seguintes parâmetros:
-Djava.library.path=/install_location/bin64 -d64 -Xss4m
Se SSL estiver habilitado, aumente a pilha de thread de Java para 12 MB. Por exemplo, -Xss12m.
4. Salve e feche o arquivo.
Configuração de propriedades do servidor de aplicativos eimplantação do IBM Cognos 8
Configure o servidor de aplicativos e implante os componentes do IBM® Cognos®.
Etapas para WebSphere
1. Inicie o Servidor de aplicativos WebSphere® e, em seguida, acesso o console administrativo do
WebSphere.
2. Crie uma nova instância na qual o aplicativo IBM Cognos BI será implantado, caso essa opção
esteja disponível na versão em execução.
Se estiver implantando o IBM Cognos Servlet Gateway, crie uma segunda instância de servidor
separada.
3. Instale um novo aplicativo Enterprise utilizando o arquivo de aplicativo que foi criado pelo
IBM Cognos Configuration.
Para o IBM Cognos BI, o nome do diretório da raiz do contexto padrão é p2pd, que pode ser
usado na maioria dos casos. Para o IBM Cognos Servlet Gateway, a raiz de contexto padrão
é ServletGateway. Outros valores de implantação do aplicativo, tais como o nome do aplicativo,
podem ser alterados para melhor se adequarem ao ambiente do sistema. O valor de raiz do
contexto utilizado para implantar o aplicativo deve ser o mesmo que o valor de raiz do contexto
inserida no IBM Cognos Configuration ao executar o Assistente para Criação de Aplicativo.
4. Defina a memória utilizada pelo JVM.
Geralmente, a memória é definida pela adição ou alteração dos tamanhos iniciais e máximo
da pilha do JavaTM. Para obter informações sobre os parâmetros, consulte a documentação do
JVM ou do servidor do aplicativo.
Dica: Mínimo de 256 MB e máximo de 768 MB são os valores iniciais sugeridos. É possível
alterar esses valores para melhor se adequarem ao ambiente.
322 IBM Cognos Business Intelligence PowerPlay
Capítulo 12: Configuração do IBM Cognos BI para servidores de aplicativos diferentes do Tomcat
5. Nas propriedades do servidor, adicione uma variável de ambiente, como listado na tabela a
seguir, que se refira ao diretório installation_location/bin.
Variável do ambienteSistema operacional
PATHMicrosoft® Windows®
LIBPATHAIX®
LD_LIBRARY_PATHSolaris
SHLIB_PATHHP-UX
Certifique-se de usar os arquivos de biblioteca adequados para a versão do servidor do IBM
Cognos BI que instalar. O IBM Cognos BI requer arquivos de biblioteca de 32 bits ao ser
executado em um servidor de aplicativos de 32 bits e requer arquivos de biblioteca de 64 bits
ao ser executado em um servidor de aplicativos de 64 bits. Dependendo da versão do DB2®
instalada, será preciso alterar os arquivos de biblioteca ou a ordem na qual os arquivos de
biblioteca são listados, para que o servidor do IBM Cognos BI possa encontrar os arquivos
corretos. Independentemente da versão, os arquivos de biblioteca necessários devem ser listados
primeiro.
6. Interrompa e, em seguida, reinicie a instância do servidor de aplicativos WebSphere utilizado
para componentes do IBM Cognos.
7. Verifique se os componentes do IBM Cognos estão sendo executados procurando pela seguinte
mensagem na janela do console de administrador do aplicativo ou no arquivo de log do servidor
do aplicativo:
O distribuidor está pronto para processar solicitações.
Etapas para WebLogic
1. Se tiver utilizado a opção de diretório expandido ao criar o aplicativo no IBM Cognos
Configuration, vá para a etapa 2. Se tiver criado um arquivo WAR, expanda o aplicativo
manualmente:
● Crie um diretório em uma localização que seja acessível ao servidor de aplicativos, dando
ao diretório o mesmo nome que a raiz do contexto.
Para o IBM Cognos BI, o nome do diretório da raiz do contexto padrão e do diretório do
aplicativo é p2pd, que pode ser usado na maioria dos casos. Para o IBM Cognos Servlet
Gateway, a raiz de contexto padrão é ServletGateway. Outros valores de implantação do
aplicativo, tais como o nome do aplicativo, podem ser alterados para melhor se adequarem
ao ambiente do sistema. O valor de raiz do contexto utilizado para implantar o aplicativo
deve ser o mesmo que o valor de raiz do contexto inserida no IBM Cognos Configuration.
● No diretório que acaba de criar, extraia o arquivo WAR do aplicativo para a instalação
do WebLogic utilizando o seguinte comando de um prompt de comando:
Guia de instalação e configuração 323
Capítulo 12: Configuração do IBM Cognos BI para servidores de aplicativos diferentes do Tomcat
WebLogic_location/jdk_version/bin/jar xvfm "installation_location/application.war" .
Um espaço seguido de um ponto são necessários no fim do comando. Nesse comando, o
ponto não se refere ao diretório atual.
2. Inicie o WebLogic Administration Server e o WebLogic Managed Server associados ao domínio
do IBM Cognos.
O Node Manager deve ser iniciado antes que possa iniciar e parar instâncias do Managed Server
utilizando o console de administração
3. Para o WebLogic 9, é preciso modificar o ambiente no console de administração do WebLogic
antes de implantar o IBM Cognos BI. Efetue logon no console de administração e navegue até
a instância do Managed Server que hospedará o aplicativo IBM Cognos BI. Selecione a guia
Início do Servidor para a instância do Managed Server e ative o modo de edição.
4. Na caixa Java Home, digite o caminho para o JVM. Este valor deve ser o mesmo que o utilizado
para IBM Cognos BI. Utilize o JVM que está incluído na instalação do WebLogic.
5. Defina os argumentos Java.
Os argumentos Java incluem todas as definições do JVM, como as definições de memória
especificadas utilizando dois parâmetros JVM: -Xms e -Xmx.
O parâmetro MaxPermSize também deve ser definido. Defina o analisador XML correto para
o IBM Cognos BI.
Por exemplo: na caixa Argumentos, digite
-Xms768m -Xmx768m -XX:MaxPermSize=128m -Dorg.xml.sax.driver=org.apache.xerces.
parsers.SAXParser
Se utilizar o WebLogic no AIX, especifique também a UID de versão serial correta nos
argumentos Java. Se essa atualização não for feita, ocorrerá uma discordância de UID de versão
serial ao utilizar o WebLogic com Java 5 porque o WebLogic requer JDK 1.5.
Por exemplo: na caixa Argumentos, digite
-Xms768m -Xmx768m -XX:MaxPermSize=128m -Dorg.xml.sax.driver=org.apache.xerces.
parsers.SAXParser -Dcom.sun.xml.namespace.QName.useCompatibleSerialVersionUID=1.0
Para obter informações sobre os parâmetros JVM, consulte a documentação do JVM ou do
servidor do aplicativo.
6. Salve e aplique as alterações.
É possível agora iniciar e parar a instância do Managed Server na guia Controle.
7. Inicie a instância do servidor. A instância do servidor deve ser iniciada antes de implantar o
IBM Cognos BI ou o IBM Cognos Servlet Gateway.
8. Implante o aplicativo IBM Cognos BI ou IBM Cognos Servlet Gateway no console WebLogic
usando um novo aplicativo web da seguinte forma:
● Defina o nome do aplicativo.
Por exemplo, ibmcognos.
324 IBM Cognos Business Intelligence PowerPlay
Capítulo 12: Configuração do IBM Cognos BI para servidores de aplicativos diferentes do Tomcat
● Defina o caminho para o diretório onde os arquivos de aplicativo expandidos estão
localizados.
Observação: o IBM Cognos BI utiliza um carregador personalizado. Utilize a opção de
diretório expandido ao implantar.
● Selecione a instância de servidor de destino.
Use o Administration Server apenas para tarefas de administração do WebLogic e implante
o aplicativo do IBM Cognos BI para sua própria instância do Managed Server.
9. Após a implantação ter sido concluída com sucesso, defina o período de recarga para o aplicativo
web para -1 para melhorar o desempenho. Isso evitará que o WebLogic verifique a existência
de arquivos de aplicativo atualizados que são utilizados somente em um ambiente de
desenvolvimento.
10. Pare e, em seguida, reinicie o WebLogic Managed Server associado ao domínio do IBM Cognos
para ativar as mudanças.
11. Verifique se os componentes do IBM Cognos estão sendo executados procurando pela seguinte
mensagem na janela do console do servidor do aplicativo ou no arquivo de log do servidor do
aplicativo:
O distribuidor está pronto para processar solicitações.
Etapas para o Oracle Application Server Release 3
1. Crie uma instância OC4J dos componentes do IBM Cognos para executar.
2. Somente no Windows, insira comentários nas seguintes entradas no arquivo
Oracle_location\j2ee\Cognos_OC4J_instance\config\global-web-application.xml:
<welcome-file-list> <welcome-file>index.html</welcome-file> <welcome-file>default.jsp</welcome-file> <welcome-file>index.htm</welcome-file><welcome-file>index.jsp</welcome-file> </welcome-file-list>
3. Abra o arquivo Oracle_location/opmn/conf/opmn.xml.
4. Adicione uma variável de ambiente que faça referência ao diretório installation_location/bin e
defina variáveis para origens de dados.
Eis um exemplo para Windows e DB2:
<environment> <variable id="PATH" value="c10_location/bin" append="true"/><variable id="DB2DIR" value=" location"/> <variable id="DB2INSTANCE value="instance_name"/> <variable id="INSTHOME value=" location"/> </environment>
A tabela a seguir lista as variáveis de ambiente para cada sistema operacional que deve fazer
referência ao diretório local_c10/bin.
Variável do ambienteSistema operacional
PATHWindows
LIBPATHAIX
Guia de instalação e configuração 325
Capítulo 12: Configuração do IBM Cognos BI para servidores de aplicativos diferentes do Tomcat
Variável do ambienteSistema operacional
LD_LIBRARY_PATHSolaris
SHLIB_PATHHP-UX
5. Defina a memória utilizada pelo JVM.
Como valores iniciais, são sugeridos 256 MB como mínimo e 768 MB como máximo. É possível
alterar esses valores para melhor se adequarem ao ambiente. Para obter informações sobre os
parâmetros, consulte a documentação do JVM ou do servidor do aplicativo.
Eis um exemplo:
<data id="java-options" value="-server -Xmx768m -XX:MaxNewSize=384m-XX:NewSize=192m -XX:MaxPermSize=128m -classpathc10_location\bin;c10_location\webapps\p2pd\WEB-INF\lib -
6. Defina a configuração OC4J userThreads.
Eis um exemplo:
<data id="oc4j-options" value="-userThreads"/>
7. Adicione a opção -Dcom.sun.management.jmxremote à seção de parâmetros de início.
Por exemplo:
<category id="start-parameters"> <data id="java-options" value="-Dcom.sun.management.jmxremote"/>
Defina isso também selecionando a opção Ativar J2SE 5.0 Plataforma MBeans na página de
propriedades do servidor para a instância OC4J.
8. Abra e feche o arquivo Oracle_location/opmn/conf/opmn.xml.
9. Implante o arquivo (chamado p2pd.ear para o IBM Cognos BI ou ServletGateway.ear para o
IBM Cognos Servlet Gateway, por padrão) de aplicativo do IBM Cognos criado pelo IBM
Cognos Configuration.
O valor do parâmetro Map to URL deve ser o mesmo do valor da raiz de contexto inserido no
IBM Cognos Configuration.
10. Inicie a instância OC4J criada para os componentes IBM Cognos.
11. Verifique se os componentes do IBM Cognos estão sendo executados procurando pela seguinte
mensagem na janela do console do servidor do aplicativo ou no arquivo de log do servidor do
aplicativo:
O distribuidor está pronto para processar solicitações.
Etapas para JBoss
1. Se não quiser utilizar a porta padrão do 8080, abra o arquivo
JBoss_location/server/instance_name/deploy/jbossweb-tomcat55.sar/server.xml.
326 IBM Cognos Business Intelligence PowerPlay
Capítulo 12: Configuração do IBM Cognos BI para servidores de aplicativos diferentes do Tomcat
2. No arquivo server.xml, mude o número da porta padrão de 8080 utilizado pela instância do
servidor para a porta especificada no IBM Cognos Configuration. Por exemplo,
<Service name="jboss.web" className="org.jboss.web.tomcat.tc5.StandardService"> <!-- A HTTP/1.1 Connector on port 8080 --> <Connectorport="8080" address="${jboss.bind.address}" maxThreads="250" strategy="ms"maxHttpHeaderSize="8192" emptySessionPath="true" enableLookups="false"redirectPort="8443" acceptCount="100" connectionTimeout="20000"disableUploadTimeout="true"/>
3. Salve e feche o arquivo server.xml.
4. Coloque o aplicativo p2pd na pasta JBoss_location/server/instance_name/deploy se ainda não
estiver nessa localização.
5. Inicie o servidor de aplicativos.
Para jBoss 5.0, o comportamento padrão é vincular seus serviços ao localhost (127.0.0.1). No
entanto, isso poderá gerar erros durante o acesso ao aplicativo do IBM Cognos BI. Para evitá-
los, adicione o atributo -b ao iniciar o servidor. Por exemplo, use um comando como
run.bat -c <server_name> -b #.#.#.#
Em um ambiente de teste, para executar jBoss 5.0 com o comportamento legado, é possível
usar -b 0.0.0.0, que é vinculado a todas as interfaces disponíveis.
Importante: para um ambiente de produção, certifique-se de proteger o servidor do aplicativo
adequadamente e não use -b 0.0.0.0 como o endereço de vinculação. Para obter mais
informações, consulte a documentação do jBoss.
O aplicativo p2pd é automaticamente detectado e iniciado pelo servidor de aplicativos.
6. Verifique se os componentes do IBM Cognos estão sendo executados procurando pela seguinte
mensagem na janela do console do servidor do aplicativo ou no arquivo de log do servidor do
aplicativo:
The dispatcher is ready to process requests.
Etapas para Servidor de aplicativos Sun Java System
1. Utilize o console de administração do Servidor de aplicativos Sun Java System para adicionar
uma nova opção do JVM ao analisador XML que será utilizado pelo aplicativo IBM Cognos
Application. Por exemplo:
"-Djavax.xml.parsers.DocumentBuilderFactory=org.apache.xerces.jaxp.DocumentBuilderFactoryImpl"
2. Adicione uma opção do JVM para definir o tamanho máximo de pilha Java para limitar a
quantidade máxima de memória que pode ser utilizada pelo processo Java.
Geralmente a memória é definida através da adição ou alteração dos tamanhos inicial e máximo
da pilha de Java. Para obter informações sobre os parâmetros, consulte a documentação do
JVM ou do servidor do aplicativo.
Por exemplo, adicione "-Xmx768M" para definir 768M de memória como o valor máximo para
o processo Java.
Dica: Mínimo de 256 MB e máximo de 768 MB são os valores iniciais sugeridos. É possível
alterar esses valores para melhor se adequarem ao ambiente.
Guia de instalação e configuração 327
Capítulo 12: Configuração do IBM Cognos BI para servidores de aplicativos diferentes do Tomcat
3. Aumente o "Número máximo de threads de processamento de solicitação" do padrão de 5
para um valor adequado para o ambiente.
Dica:Inicie com um valor de 250. Se o valor for muito baixo, ocorrerão instabilidade do sistema
e falhas no processo. Se o valor for muito alto, os recursos do sistema serão reservados
desnecessariamente.
4. Copie o arquivo local_c10 \webapps\p2pd\WEB-INF\lib\xercesImpl.jar em
SJSAS_location\domains\<domain name>\lib\ext.
5. Implante o arquivo (chamado p2pd.ear para o IBM Cognos BI ou ServletGateway.ear para o
IBM Cognos Servlet Gateway, por padrão) de aplicativo do IBM Cognos criado pelo IBM
Cognos Configuration.
No Sun Java System Application Server Admin Console, acesse Common Tasks > Applications
> Enterprise Applications e use a opção de arquivo empacotado local para selecionar o arquivo
.ear que deseja implantar.
Ativação do SSLSe estiver utilizando o Secure Socket Layer (SSL) para componentes do IBM® Cognos®, ative também
o SSL no ambiente do servidor de aplicativos. Em seguida, identifique o certificado de servidor SSL
para componentes do IBM Cognos.
Etapas
1. Configure o servidor de aplicativos para utilizar o SSL.
Um certificado de servidor SSL é gerado por uma outra autoridade de certificação (CA). O
certificado da CA que gerou o certificado de servidor SSL também é fornecido.
Para obter mais informações sobre a configuração do servidor de aplicativos para utilizar SSL,
consulte a documentação do servidor de aplicativos. Para obter informações sobre o uso de
certificados de CA para seu servidor de aplicativos, consulte a documentação da CA.
2. Copie o certificado de CA no diretório local_de_instalação/bin e renomeie o arquivo como
ca.cer.
Esse arquivo deve ter o formato X.509 codificado em Base 64.
3. No diretório installation_location/bin:
● No sistema operacional Microsoft® Windows®, digite:
ThirdPartyCertificateTool.bat -T -i -r ca.cer -k ../configuration/signkeypair/jCAKeystore
-p senha
● Nos sistemas operacionais UNIX® ou Linux®, digite:
ThirdPartyCertificateTool.sh -T -i -r ca.cer -k ../configuration/signkeypair/jCAKeystore
-p senha
Digite jCAKeystore como o nome do banco de chaves de CA.
328 IBM Cognos Business Intelligence PowerPlay
Capítulo 12: Configuração do IBM Cognos BI para servidores de aplicativos diferentes do Tomcat
Configuração da comunicação webPara a maioria dos tipos de servidores de aplicativo suportados, use um gateway IBM® Cognos®
para comunicação web. Nessa situação, siga as etapas para configurar o servidor web.
Para obter informações sobre como configurar o plugin do servidor web WebSphere®, entre em
contato com o IBM Cognos Customer Center (http://www.ibm.com/software/data/cognos/
customercenter/).
Se estiver usando SAP NetWeaver no sistema operacional Microsoft® Windows® e não um servidor
web e um gateway do IBM Cognos para comunicação web, siga as etapas para configurar um
diretório virtual.
Configuração do servidor webPara todas as instalações, antes de usar páginas da web geradas pelo IBM® Cognos® BI, é necessário
configurar o servidor web. É necessário criar diretórios virtuais, ou aliases, para que usuários possam
se conectar ao IBM Cognos BI no portal. Se planeja executar o produto IBM Cognos BI mais de
uma vez, ou diversas instâncias do mesmo produto em um computador, será necessário criar um
pool de aplicativos separado para cada produto ou instância e depois associar os aliases para esse
produto ou instância ao pool de aplicativos. As etapas para criar um pool de aplicativo variam
dependendo de seu sistema operacional.
Para usar o IBM Cognos BI para relatórios, é preciso configurar também a validade do conteúdo
para o diretório de imagens no servidor web para que o navegador web não verifique o status da
imagem depois do primeiro acesso.
Nos sistemas operacionais UNIX® e Linux®, a conta na qual o servidor web é executado deve ter
acesso de leitura para o arquivo cogstartup.xml no diretório local_c10/configuration. Por padrão
o arquivo cogstartup.xml possui permissão de acesso para outros. Se o servidor web for executado
em um grupo específico, é possível mudar as permissões do arquivo cogstartup.xml para garantir
que pertença ao mesmo grupo do servidor web. É possível então remover a permissão de leitura
para os outros.
Etapas para criar diretórios virtuais
1. Crie os diretórios virtuais mostrados na tabela a seguir:
PermissãoLocalizaçãoAlias
Leituralocal_c10/webcontentibmcognos
Execuçãolocal_c10/cgi-binibmcognos/cgi-bin
É possível usar um nome diferente de ibmcognos nos aliases. Entretanto, é necessário usar cgi
bin como a segunda parte do alias e mudar o diretório virtual na propriedade URI do gatewaypara coincidir com o novo alias do IBM Cognos.
Guia de instalação e configuração 329
Capítulo 12: Configuração do IBM Cognos BI para servidores de aplicativos diferentes do Tomcat
Para o servidor web Apache, certifique-se de que o alias ibmcognos/cgi-bin foi definido antes
do alias ibmcognos no arquivo httpd.conf no diretório instalação_Apache/conf. O alias
ibmcognos/cgi-bin deve ser definido como um ScriptAlias.
2. Se desejar usar o navegador de imagens do Report Studio, ative o Web Distributed Authoring
and Versioning (WebDAV) no servidor web.
Se utilizar o servidor web Apache, especifique em qual diretório ativar o WebDAV. Para obter
informações sobre como configurar o WebDAV, consulte a documentação de seu servidor web.
Caso utilize o Microsoft® Internet Information Services (IIS), ative as propriedades Read e
Directory Browsing para a URL que deseja acessar.
3. Para relatórios no IBM Cognos BI, defina a validade do conteúdo no diretório virtual local_c10/
webcontent/pat/images no servidor web.
Cada vez que um usuário abre o Report Studio, o navegador web verifica com o servidor web
para determinar se as imagens são atuais. Devido ao fato de haver mais de 600 imagens, isto
pode resultar em tráfico de rede excessivo. É possível adiar esta verificação até uma data
específica usando o recurso de validade do conteúdo do servidor web.
Para obter informações em como definir a validade do conteúdo, consulte a documentação de
seu servidor web.
Observação: ao atualizar, os usuários do Report Studio devem limpar o cache de seus
navegadores para obterem as imagens mais recentes.
Se utilizar aliases web diferentes de ibmcognos, ou o servidor web estiver em outro computador,
ou estiver utilizando o Microsoft Internet Application Interface (ISAPI), apache_mod ou um gateway
de servlet, altere o URI do gateway ao configurar componentes do IBM Cognos.
Etapas para a criação de um pool de aplicativos no Windows Server 2008
1. No sistema operacional Microsoft® Windows®, no menu Iniciar, selecione Painel de Controle
> Desempenho e manutenção >Ferramentas Administrativas.
2. Inicie o Internet Information Services (IIS) Manager.
Web Management Tools e World Wide Web Services estão ativados automaticamente.
3. A partir da raiz (o nome de seu sistema e seu usuário), selecione Features View.
4. Na seção IIS, inicie ISAPI and CGI Restrictions.
5. Selecione Edit Feature Settings e ative Allow unspecified CGI modules, em seguida clique em
OK.
6. Adicione os aliases. Por example, local_c10,local_c10/cgi-bin.
7. Selecione o alias cgi-bin e certifique-se de que a opção Features View esteja selecionada.
8. Clique com o botão direito em Application Pools e selecione Adicionar
9. Na caixa de diálogo, digite um alias web e o caminho correspondente para o IBM Cognos BI
webcontent.
330 IBM Cognos Business Intelligence PowerPlay
Capítulo 12: Configuração do IBM Cognos BI para servidores de aplicativos diferentes do Tomcat
10. Repita as etapas 8 e 9 para adicionar o alias da Web seguinte.
11. Selecione Default Web Site.
12. Abra Handler Mappings.
13. Selecione o mapeamento CGI-cgi.
14. No quadro direito, clique em Revert to Inherited.
15. Expanda o aplicativo que aponta para o local do webcontent.
16. Expanda o nó do seu aplicativo cgi-bin.
17. Adicione um mapeamento que aponte para *.cgi e chame-o de CGI-cgi.
18. Selecione o mapeamento CGI-cgi.
19. No quadro direito, clique em Revert to Inherited.
20. Reinicie o servidor IIS.
21. Encontre a pasta que contem cgi-bin (local_c10/cgi-bin) e clique nela com o botão direito do
mouse.
22. Selecione a guia Segurança.
23. Adicione o usuário Network Services concedendo todas as permissões, exceto Full Control.
24. Clique com o botão direito do mouse em Serviço do Cognos e selecione Propriedades.
25. Clique na guia Logon.
26. Clique em This account e digite Network Service como o usuário.
27. Exclua os valores de Senha e de Confirm the password.
28. Clique em OK.
Configuração de um diretório virtual para SAP NetWeaver no WindowsSe estiver usando o SAP NetWeaver no sistema operacional Microsoft® Windows® e não um servidor
web e um gateway do IBM® Cognos® para comunicação web, crie um diretório virtual, também
conhecido como alias web. O diretório virtual é necessário para permitir que o conteúdo estático
(páginas html, imagens, entre outros) seja carregado. Ao construir o arquivo de aplicativo do IBM
Cognos, selecione a opção para incluir os arquivos estáticos da pasta webcontent. Crie um diretório
virtual que utilize o valor de raiz do contexto como um nome (por padrão, p2pd para o IBM Cognos
BI ou ServletGateway para o gateway de servlet do IBM Cognos). Certifique-se que o diretório
virtual aponte para a pasta local_c10/webcontent.
Etapa
● Crie o diretório virtual listado na tabela a seguir:
Guia de instalação e configuração 331
Capítulo 12: Configuração do IBM Cognos BI para servidores de aplicativos diferentes do Tomcat
PermissãoLocalizaçãoAlias
Leituralocal_c10/webcontentcontext_root (por exemplo, p2pd)
Remoção do registro de distribuidoresDepois de iniciar o servidor de aplicativos e o aplicativo IBM® Cognos®, remova o registro de
quaisquer distribuidores do IBM Cognos que tenham sido registrados anteriormente e que não são
mais utilizados. Por exemplo, remova o registro de quaisquer distribuidores do Tomcat que agora
estejam sendo executados sob o servidor de aplicativos.
Os distribuidores são removidos utilizando o IBM Cognos Administration. Para acessar essa
ferramenta, execute permissões para a função protegida Administração.
Etapas
1. Abra o IBM Cognos Connection conectando-se ao portal do IBM Cognos BI e clicando em
Conteúdo do IBM Cognos na página Bem-vindo.
2. No canto superior direito, clique em Iniciar > IBM Cognos Administration.
3. Na guia Configuração, clique em Distribuidores e Serviços.
4. Para o distribuidor que deseja remover, na coluna Ações, clique em Mais.
5. Clique em Remover registro.
6. Na caixa de diálogo de confirmação, clique em OK.
As informações do distribuidor são removidas do Content Manager.
Importação de dados do armazenamento de conteúdoSe o armazenamento de conteúdo foi exportado antes de configurar os componentes do IBM®
Cognos® para que sejam executados no servidor de aplicativos (p. 314 ), importe a implantação para
restaurar e criptografar os dados utilizando as novas chaves de criptografia.
Etapas
1. Inicie o IBM Cognos BI.
2. Importe todo o armazenamento de conteúdo utilizando a ferramenta de implantação.
Para obter mais informações, consulte o tópico sobre como importar para um ambiente de
destino no Guia de administração e segurança.
332 IBM Cognos Business Intelligence PowerPlay
Capítulo 12: Configuração do IBM Cognos BI para servidores de aplicativos diferentes do Tomcat
Atualização do IBM Cognos BI em um ambiente do servidorde aplicativos
Se estiver fazendo uma atualização de uma versão compatível com o IBM® Cognos® BI, execute as
seguintes etapas.
Etapas
1. Faça backup das informações do IBM Cognos existentes (p. 314 ).
2. Utilize as ferramentas administrativas para seu servidor de aplicativo para desimplantar o
aplicativo do IBM Cognos existente.
Para obter informações sobre como remover aplicativos, consulte a documentação de seu
servidor de aplicativos.
Se o diretório ao qual o aplicativo do IBM Cognos foi originalmente implantado não for
removido durante o processo de desimplantação, exclua o diretório.
Além disso, remova qualquer arquivo .jar do IBM Cognos que estiver em cache no ambiente
do servidor de aplicativos.
No WebLogic 8.1, a localização do cache é %WL_HOME%\user_projects\domains\domain-
name\managed-server-name\.wlnotdelete\extract\crn_p2pd_p2pd\ jarfiles
3. Desinstale a versão existente.
4. Instale o IBM Cognos BI .
5. Siga as instruções adequadas neste capítulo para mudar para seu servidor de aplicativos.
A maioria das instalações deve executar o seguinte:
● Configure o IBM Cognos BI para ser executado no servidor de aplicativos.
● Configure propriedades do servidor de aplicativos e implante o IBM Cognos BI.
6. Para ativar novos recursos após a atualização, salve a configuração no IBM Cognos
Configuration e, em seguida, reinicie os serviços.
Guia de instalação e configuração 333
Capítulo 12: Configuração do IBM Cognos BI para servidores de aplicativos diferentes do Tomcat
334 IBM Cognos Business Intelligence PowerPlay
Capítulo 12: Configuração do IBM Cognos BI para servidores de aplicativos diferentes do Tomcat
Capítulo 13: Opções avançadas de configuração
As opções avançadas de configuração são alterações feitas, após a instalação, às propriedades de
configuração dos recursos que os componentes do IBM® Cognos® Business Intelligence utilizam.
Não é possível utilizar o IBM Cognos Configuration para fazer essas alterações. As opções avançadas
de configuração melhoram a segurança, aumentam o desempenho ou mudam o comportamento
padrão dos componentes do IBM Cognos BI.
Alteração de versão do Java Runtime Environment utilizadopelos componentes do IBM Cognos BI
Os componentes do IBM® Cognos® BI necessitam do JavaTM Runtime Environment (JRE) para
operar.
Se deseja alterar o JRE atual, algumas mudanças de configuração serão necessárias. Mudanças
podem ser adequadas nas seguintes situações:
● Se deseja utilizar componentes do IBM Cognos BI com um servidor de aplicativos que exige
uma versão específica do JRE.
● Se já estiver utilizando uma versão do JRE com outros aplicativos.
A versão atual fornecida com o IBM Cognos BI é o JRE 1.5.0. Para obter mais informações sobre
as versões JRE compatíveis, consulte o IBM Cognos Customer Center (http://www.ibm.com/software/
data/cognos/customercenter/).
Se estiver utilizando componentes do IBM Cognos BI em ambientes de servidor de aplicativos, siga
o processo em "Configuração do IBM Cognos BI para servidores de aplicativos diferentes do
Tomcat" (p. 311 ). O processo inclui etapas para atualizar o ambiente Java.
O IBM Cognos Configuration e outros componentes do IBM Cognos BI utilizam o JRE referenciado
pela variável de ambiente JAVA_HOME. No sistema operacional Microsoft® Windows®, caso
JAVA_HOME não tenha sido definida, o JRE que acompanha os componentes do IBM Cognos BI
será utilizado por padrão.
Antes de começar, verifique se os componentes do IBM Cognos BI e o JRE que deseja utilizar estão
instalados.
Para alterar as versões do JRE, faça o seguinte:
❑ Faça backup de dados e chaves de criptografia existentes do IBM Cognos, se necessário.
❑ Atualização do ambiente Java.
❑ Importe dados para o armazenamento de conteúdo, se necessário.
Licensed Materials – Property of IBM335© Copyright IBM Corp. 2005, 2010.
Backup de informações do IBM Cognos existentesFaça o backup das informações existentes do IBM® Cognos® se os componentes do IBM Cognos
BI estiverem em execução em um servidor de aplicativos (incluindo o Tomcat) e estiver mudando
para um servidor de aplicativos que vem com seu próprio JVM. Faça backup também das
informações do IBM Cognos existentes se tiver que mudar o JVM em uso.
Observação: É necessário fazer backup de informações do IBM Cognos existentes no ambiente de
trabalho antes da atualização.
Antes de configurar os componentes do IBM Cognos BI para que seja executado no novo servidor
de aplicativos ou JVM, é preciso fazer o backup de
● Dados de armazenamento de conteúdo criando uma exportação de implantação.
● Informações de configuração por meio de sua exportação. Qualquer dado criptografado é
descriptografado durante a exportação.
● Chaves de criptografia salvando-as em uma localização alternativa. Novas chaves de criptografia
devem ser criadas utilizando o mesmo JVM que o servidor de aplicativos utiliza. Como essas
chaves só podem ser criadas se as chaves anteriores forem excluídas, é importante fazer backup
das chaves anteriores.
Para garantir a segurança e a integridade dos dados do IBM Cognos data, faça backup do
armazenamento de conteúdo, das informações de configuração, das chaves de criptografia em um
diretório que esteja protegido contra acesso não autorizado ou indevido.
Dica: para verificar a existência de chaves de criptografia, verifique o diretório
local_c10/configuration. As chaves de criptografia existem se esse diretório apresenta os seguintes
subdiretórios: csk, encryptkeypair ou signkeypair.
Etapas
1. Se houver dados no armazenamento de conteúdo, inicie o serviço IBM Cognos e exporte todo
o armazenamento de conteúdo utilizando a ferramenta de implantação.
Para obter mais informações, consulte o tópico sobre a criação de especificações de implantação
de exportação no Guia de administração e segurança.
2. No IBM Cognos Configuration, no menu Arquivo, clique em Exportar como e salve as
informações de configuração em um formato descriptografado. Ao nomear um arquivo, utilize
um nome como "decrypted.xml".
Exporte os dados para um diretório que esteja protegido contra acesso não autorizado ou
indevido, pois as senhas são armazenadas como texto comum. É solicitado o reconhecimento
de que a exportação é uma operação insegura.
3. Interrompa o serviço do IBM Cognos:
● Se estiver usando o Tomcat, interrompa o serviço IBM Cognos e feche o IBM Cognos
Configuration.
● Se utilizar um servidor de aplicativos diferente do Tomcat, encerre o IBM Cognos BI em
seu ambiente.
336 IBM Cognos Business Intelligence PowerPlay
Capítulo 13: Opções avançadas de configuração
4. Faça backup de chaves de criptografia existente salvando arquivos e diretórios corretos em
uma localização alternativa que seja segura.
Os arquivos são
● local_c10/configuration/cogstartup.xml
● local_c10/configuration/caSerial
● local_c10/configuration/cogconfig.prefs
● local_c10/configuration/coglocale.xml
Os diretórios são
● local_c10/configuration/csk
● local_c10/configuration/encryptkeypair
● local_c10/configuration/signkeypair
5. Exclua os arquivos caSerial e cogconfig.prefs e os três diretórios: csk, encryptkeypair e
signkeypair.
6. Substitua o arquivo local_c10/configuration/cogstartup.xml pelo arquivo que contém os dados
exportados do IBM Cognos Configuration (por exemplo, "decrypted.xml").
No diretório local_c10/configuration, o arquivo deve usar o nome "cogstartup.xml".
As informações nesse arquivo serão automaticamente criptografadas novamente utilizando
novas chaves de criptografia quando salvar a configuração no IBM Cognos Configuration.
Atualização do ambiente JavaÉ possível utilizar um JavaTM Runtime Environment (JRE) existente ou o JRE fornecido com o IBM®
Cognos® Business Intelligence. Para oferecer suporte aos serviços de criptografia no IBM Cognos
BI, talvez seja necessário atualizar ou definir uma variável de ambiente JAVA_HOME. Dependendo
da sua política de segurança, talvez tenha de instalar o arquivo de política irrestrita do Java
Cryptography Extension (JCE).
É possível utilizar um JavaTMRuntime Environment (JRE) existente ou o JRE fornecido com o IBM®
Cognos® BI. Para oferecer suporte aos serviços de criptografia no IBM Cognos BI, talvez seja
necessário atualizar ou definir uma variável de ambiente JAVA_HOME. Dependendo da sua política
de segurança, talvez tenha de instalar o arquivo de política irrestrita do Java Cryptography Extension
(JCE).
JAVA_HOME
Se quiser usar seu próprio JRE e definir JAVA_HOME para esse local no sistema operacional
Microsoft® Windows® ou se estiver instalando no sistema operacional UNIX® ou Linux®, será
necessário atualizar JAVA_HOME para os serviços de criptografia.
No Windows, defina JAVA_HOME como uma variável de sistema ou de usuário. Se definir como
uma variável de sistema, pode ser necessário reiniciar seu computador para que tenha efeito. Se
Guia de instalação e configuração 337
Capítulo 13: Opções avançadas de configuração
definir como uma variável de usuário, faça com que o ambiente no qual o Tomcat (ou outro servidor
de aplicativo) estiver sendo executado possa acessá-lo.
Caso ainda não possua uma variável JAVA_HOME definida no Windows, os arquivos JRE
fornecidos com a instalação serão usados e não será necessário atualizar nenhum arquivo do seu
ambiente. Se JAVA_HOME apontar para uma versão do Java que não é válida para o IBM
Cognos BI, será necessário atualizar JAVA_HOME com o caminho para uma versão válida do
Java.
Caso ainda não possua uma variável JAVA_HOME definida no Windows, os arquivos JRE
fornecidos com a instalação serão usados e não será necessário atualizar nenhum arquivo do seu
ambiente. Se JAVA_HOME apontar para uma versão do Java que não é válida para o IBM
Cognos BI, será necessário atualizar JAVA_HOME com o caminho para uma versão válida do
Java.
Arquivo de política irrestrita do JCE
Se usar o JRE padrão do Windows ou fizer download de um JRE para UNIX ou Linux, o JRE
incluirá um arquivo de política restrita que o limita a determinados algoritmos criptográficos e
conjuntos de codificação. Se sua política de segurança exigir uma gama mais ampla de algoritmos
criptográficos e conjuntos de codificação além dos mostrados no IBM Cognos Configuration, faça
download e instale o arquivo de política irrestrita do JCE.
Etapas
1. Certifique-se de que a variável de ambiente JAVA_HOME esteja definida na localização JRE.
Por exemplo: para definir JAVA_HOME para os arquivos JRE fornecidos junto com a instalação,
o caminho é local_c10/bin/jre/versão.
2. Inicie o IBM Cognos Configuration.
3. Salve a configuração.
O IBM Cognos Configuration gera novas chaves e criptografa os dados.
4. Baixe e instale o arquivo de política irrestrita de Java do seguinte local:
https://www14.software.ibm.com/webapp/iwm/web/preLogin.do?source-jcesdk
Importação de dados do armazenamento de conteúdoSe tiver exportado o armazenamento de conteúdo antes de mudar o JVM, importe a implantação
para restaurar e criptografar os dados utilizando as novas chaves de criptografia.
Etapa
● Para importar os dados do armazenamento de conteúdo, inicie o serviço do IBM® Cognos® BI
e importe todo o armazenamento de conteúdo usando a ferramenta de implantação. Para obter
mais informações, consulte o tópico sobre como importar para um ambiente de destino no
Guia de administração e segurança.
338 IBM Cognos Business Intelligence PowerPlay
Capítulo 13: Opções avançadas de configuração
Configuração dos componentes do IBM Cognos BI para utilizaroutra autoridade de certificação
Por padrão, os componentes do IBM® Cognos® BI usam seu próprio serviço de autoridade de
certificação (CA) para estabelecer a raiz de confiança na infra-estrutura de segurança do IBM
Cognos. É possível configurar os componentes do IBM Cognos BI para usar outra autoridade de
certificação, caso já possua uma, como iPlanet ou Microsoft®, no ambiente de relatórios.
Quando configurar componentes do IBM Cognos BI para utilizar outra autoridade de certificação,
verifique se foram especificadas as mesmas informações na ferramenta de utilitário de linha de
comando e no IBM Cognos Configuration.
Utilize a seguinte lista de verificação para configurar componentes do IBM Cognos BI para utilizar
uma outra autoridade de certificação.
❑ Gere chaves de segurança do IBM Cognos e solicitações de assinatura de certificado para utilizar
com sua CA.
❑ Envie chaves de segurança e certificados do Cognos à sua autoridade de certificação de terceiros.
❑ Configure componentes do IBM Cognos BI para utilizar sua autoridade de certificação.
Geração de chaves e solicitações de assinatura de certificadoUse o utilitário de linha de comando para gerar todas as chaves para os armazenamentos de chave
do IBM® Cognos® e para gerar as solicitações de assinatura de certificado (CSR).
A tabela a seguir lista as opções para a ferramenta de linha de comando utilizada para gerar chaves
e solicitações de assinatura.
Modo principal de operação
DescriçãoComando
Criar nova SAC-c
Importar um certificado-i
Modificadores de operação
DescriçãoComando
Trabalha com a identidade de assinatura-s
Trabalha com a identidade de criptografia-e
Trabalha com armazenamento confiável (somente com -i)-T
Guia de instalação e configuração 339
Capítulo 13: Opções avançadas de configuração
Marcadores de informações
DescriçãoComando
DN para utilizar para certificado-d
SAC ou localização de arquivo de certificado (depende do modo)-r
arquivo de certificado da autoridade de certificação (apenas com -i)-t
Senha do Banco de chaves (deve ser fornecida)-p
Algoritmo de par de chaves. RSA ou DSA.-a
Padrão: RSA
Localização do diretório-D
Os valores de amostra da tabela a seguir são usados:
ValorPropriedade
CN=SignCert,O=MyCompany,C=CADN de certificado de assinatura
CN=EncryptCert,O=MyCompany,C=CADN de certificado de criptografia
senhaSenha de Banco de chaves
Etapas
1. No diretório c10_location\configuration, faça backup do arquivo cogstartup.xml para um local
seguro.
2. Faça backup do conteúdo dos seguinte diretórios em uma localização segura:
● local_c10\configuration\signkeypair
● local_c10\configuration\encryptkeypair
3. Utilizando o IBM Cognos Configuration, exporte a configuração em texto simples da seguinte
maneira:
● Abra o IBM Cognos Configuration.
● No menu Arquivo, clique em Exportar Como.
● Quando solicitado sobre exportar o conteúdo descriptografado, clique em Sim.
● Na caixa de diálogo Exportar como, selecione cogstartup.xml e clique em Salvar.
● Quando solicitado sobre substituir o arquivo existente, clique em Sim.
340 IBM Cognos Business Intelligence PowerPlay
Capítulo 13: Opções avançadas de configuração
● Quando as tarefas estiverem concluída, feche a caixa de diálogo do IBM Cognos
Configuration.
● Salve a configuração.
● Feche o IBM Cognos Configuration.
4. Acesse o diretório local_c10\bin.
5. Crie a solicitação de assinatura de certificado para as chaves de assinatura digitando o seguinte
comando:
Nos sistemas operacionais UNIX® ou Linux®, digite
ThirdPartyCertificateTool.sh -c -s -d "CN=SignCert,O=MyCompany,C=CA" -r signRequest.csr
-D ../configuration/signkeypair -p senha
No sistema operacional Microsoft® Windows®, digite
ThirdPartyCertificateTool.bat c -s -d "CN=SignCert,O=MyCompany,C=CA" -r signRequest.csr
-D ../configuration/signkeypair -p senha
Dica: Os nomes de arquivos UNIX ou Linux diferenciam maiúsculas de minúsculas e devem
ser inseridos exatamente como mostrado.
É possível ignorar com segurança todos os avisos sobre logs.
O comando cria o arquivo jSignKeystore no diretório signkeypair, define a senha especificada,
cria um novo par de chaves, armazena-o no armazenamento de chaves e exporta o arquivo
signRequest.csr para o diretório local_c10\bin.
6. Crie a solicitação de assinatura de certificado para as chaves de criptografia digitando o seguinte
comando:
No UNIX ou Linux, digite
ThirdPartyCertificateTool.sh -c -e -d "CN=EncryptCert,O=MyCompany,C=CA" -r
encryptRequest.csr -D ../configuration/encryptkeypair -p senha
No Windows, digite
ThirdPartyCertificateTool.bat -c -e -d "CN=EncryptCert,O=MyCompany,C=CA" -r
encryptRequest.csr -D ../configuration/encryptkeypair -p senha
É possível ignorar com segurança todos os avisos sobre logs.
O comando cria o arquivo jEncKeystore no diretório encryptkeypair, define a senha especificada,
cria um novo par de chaves, armazena-o no armazenamento de chaves e exporta o arquivo
encryptRequest.csr para o diretório local_c10\bin.
7. Copie os arquivos signRequest.csr e encryptRequest.csr que foram gerados nas etapas 5 e 6
para um diretório que possa ser acessado pela outra autoridade de certificação.
8. Insira os arquivos signRequest.csr e encryptRequest.csr na autoridade de certificação.
A autoridade de certificação produz um certificado de assinatura e um certificado de criptografia.
Para obter mais informações, consulte a documentação da CA.
Guia de instalação e configuração 341
Capítulo 13: Opções avançadas de configuração
9. Copie o conteúdo do certificado de assinatura em um arquivo chamado signCertificate.cer.
10. Copie o conteúdo do certificado de criptografia em um arquivo chamado encryptCertificate.
cer.
11. Encontre o certificado de CA raiz para a autoridade de certificação e copie o conteúdo para
um arquivo chamado ca.cer.
12. Copie ca.cer, signCertificate.cer e encryptCertificate.cer para local_c10/bin.
Esses arquivos devem estar no formato PEM (ASCII com codificação Base-64).
13. Importe o certificado de assinatura da etapa 10 no banco de chaves de assinatura do IBM
Cognos digitando o seguinte comando:
No UNIX ou Linux, digite
ThirdPartyCertificateTool.sh -i -s -r signCertificate.cer -D ../configuration/signkeypair -p senha
-t ca.cer
No Windows, digite
ThirdPartyCertificateTool.bat-i -s -r signCertificate.cer -D ../configuration/signkeypair -p senha
-t ca.cer
É possível ignorar com segurança todos os avisos sobre logs.
O comando lê os arquivos signCertificate.cer e ca.cer no diretório local_c10\bin e importa os
certificados dos dois arquivos para o arquivo jSignKeystore no diretório signkeypair usando a
senha especificada.
14. Importe o certificado de criptografia da etapa 11 no banco de chaves de criptografia do IBM
Cognos digitando o seguinte comando:
No UNIX ou Linux, digite
ThirdPartyCertificateTool.sh -i -e -r encryptCertificate.cer -D ../configuration/encryptkeypair
-p senha -t ca.cer
No Windows, digite
ThirdPartyCertificateTool.bat -i -e -r encryptCertificate.cer -D ../configuration/encryptkeypair
-p senha -t cacert.cer
É possível ignorar com segurança todos os avisos sobre logs.
O comando lê os arquivos encryptCertificate.cer e ca.cer no diretório local_c10\bin e importa
os certificados dos dois arquivos para o arquivo jEncKeystore no diretório encryptkeypair
usando a senha especificada.
15. Importe o certificado da CA da etapa 12 no banco confiável do IBM Cognos digitando o
seguinte comando:
No UNIX ou Linux, digite
ThirdPartyCertificateTool.sh -i -T -r ca.cer -D ../configuration/signkeypair -p senha
No Windows, digite
ThirdPartyCertificateTool.bat -i -T -r ca.cer -D ../configuration/signkeypair -p senha
342 IBM Cognos Business Intelligence PowerPlay
Capítulo 13: Opções avançadas de configuração
O comando lê o arquivo ca.cer file e importa o conteúdo no arquivo jCAKeystore no diretório
signkeypair utilizando a senha especificada.
Os certificados estão agora prontos para serem configurados para IBM Cognos BI.
Configuração de componentes do IBM Cognos BI para execução em outraautoridade de certificação
É necessário configurar cada computador do IBM® Cognos® para usar uma autoridade de certificação
externa definindo a propriedade adequada no IBM Cognos Configuration.
Definindo essa propriedade, os componentes do IBM Cognos BI assumem que toda as chaves
exigidas foram geradas e examinadas pela autoridade de certificação externa.
Verifique se as localizações de banco de chaves e senha no IBM Cognos Configuration correspondem
àquelas digitadas na ferramenta de linha de comando.
Etapas
1. Inicie o IBM Cognos Configuration.
2. Na janela Explorer, em Segurança > Criptografia, clique em Cognos.
3. Na janela Propriedades, no grupo de propriedades Configurações da autoridade de certificação,
clique na caixa Valor próximo à propriedade Utilizar CA de terceiros e clique em Verdadeiro.
Observação: Quando essa propriedade é definida como verdadeira, todas as propriedades para
a autoridade de certificação e nome da identidade são ignorados.
4. Configure as seguintes propriedades para que correspondam àquelas digitadas no utilitário de
linha de comando:
● Localização do banco de chaves de assinatura
● Senha do banco de chaves de assinatura
● Localização do banco de chaves de criptografia
● Senha do banco de chaves de criptografia
● Senha do banco de chaves da Autoridade de certificação
5. No menu Arquivo, clique em Salvar.
6. Caso deseje iniciar o serviço do IBM Cognos, no menu Ações, clique em Iniciar.
Esta ação inicia todos os serviços instalados que não estiverem em execução. Caso deseje iniciar
determinado serviço, selecione o nó de serviço na janela Explorer e clique em Iniciar no menu
Ações.
Guia de instalação e configuração 343
Capítulo 13: Opções avançadas de configuração
344 IBM Cognos Business Intelligence PowerPlay
Capítulo 13: Opções avançadas de configuração
Capítulo 14: Configuração de instalações econfigurações autônomas
Configure uma instalação e uma configuração autônoma para
● Instalar uma configuração idêntica em vários computadores da rede.
● Automatizar o processo de instalação e configuração especificando opções e definições para
usuários.
● Instalar e configurar componentes em um ambiente UNIX® ou Linux® que não possui
XWindows.
Antes de configurar uma instalação e configuração autônomas, verifique se todas as exigências e
os pré-requisitos do sistema sejam cumpridos e que todos os outros softwares necessários estejam
instalados e configurados.
Também é possível configurar uma desinstalação autônoma.
Para configurar instalações e configurações autônomas, execute as seguintes tarefas:
❑ Configure um arquivo de especificação de transferência (.ats) para especificar opções de
instalação.
❑ Execute a ferramenta de instalação no modo silencioso.
❑ Utilize um arquivo de configuração pré-configurado de outro computador.
❑ Execute a ferramenta de configuração no modo silencioso.
Depois de concluir essas tarefas, verifique se o diretório de instalação do IBM® Cognos® Business
Intelligence em todos os computadores está protegido contra acesso não autorizado ou indevido.
Em seguida, o IBM Cognos BI estará pronto para ser utilizado.
Configuração de instalações autônomasUtilize um arquivo de especificação de transferência (.ats) para copiar componentes do IBM®
Cognos® BI, incluindo o Framework Manager ou o Metric Designer, para o computador sem que
seja solicitada nenhuma informação.
Por padrão, cada vez que forem instalados componentes do IBM Cognos BI utilizando o assistente
de instalação, as opções selecionadas serão registradas em um arquivo de especificação de
transferência. Assim, se os componentes do IBM Cognos BI já tiverem sido instalados em um
computador de amostra, será possível utilizar o arquivo de especificação de transferência gerado
como modelo para instalações autônomas em diferentes computadores.
Se o assistente de instalação não for utilizado para instalar componentes, será possível utilizar o
arquivo de especificação de transferência padrão chamado response.ats que está disponível no disco.
Licensed Materials – Property of IBM345© Copyright IBM Corp. 2005, 2010.
É necessário modificar o arquivo response.ats para seu ambientes antes de poder utilizá-lo em
instalações autônomas.
Verifique se a instalação autônoma foi bem-sucedida analisando o status de retorno. Um valor igual
a zero (0) indica êxito e todos os outros valores indicam que ocorreu um erro.
Etapas utilizando um arquivo gerado por uma instalação em outro computador
1. Utilize o assistente de instalação para instalar componentes do IBM Cognos BI em um
computador.
2. Acesse local_c10/instlog.
3. Localize o arquivo de especificação de transferência (.ats) gerado.
O formato do nome de arquivo é ts-código_do_produto-versão-aaaammdd_hhmm.ats
onde product_code é exibido conforme listado na tabela a seguir:
ProdutoCódigo_do_produto
Servidor do IBM Cognos BIBISRVR
Servidor de relatórios do IBM Cognos BICRNSRVR
Servidor do IBM Cognos BI AnalysisCPPSRVR
Framework ManagerBIMODEL
AmostrasBISAMPLES
Supplementary Languages DocumentationLP
4. Copie o arquivo de especificação de transferência para o computador em que planeja instalar
o IBM Cognos BI.
5. No computador em que planeja instalar o software, insira o disco correto e copie o seu conteúdo
para o computador.
6. Abra o arquivo de especificação de transferência copiado em um editor de texto.
7. Na caixa de diálogo do Contrato de licença, altere a propriedade Aceito para S.
Essa ação significa que você está aceitando o acordo de licença. Para ler os termos do acordo
de licença, consulte o LA_código_idioma e os arquivos de observações em um destes locais:
● No disco do produto: no diretório-raiz da instalação referente ao sistema operacional.
● No computador a partir do qual o arquivo response.ats foi copiado: no diretório
local_c10\license\produto.
8. Salve o arquivo de especificação de transferência no diretório em que copiou o conteúdo do
disco de instalação.
346 IBM Cognos Business Intelligence PowerPlay
Capítulo 14: Configuração de instalações e configurações autônomas
9. Instale o IBM Cognos BI .
● No Windows®, abra a janela Prompt de comando e altere para o diretório win32 para o
qual foi copiado o conteúdo do disco e, em seguida, digite o seguinte comando, onde
localização é o diretório para o qual o arquivo de especificação de transferência, o
nome_arquivo, foi copiado:
issetup -s local/nome_arquivo.ats
● No UNIX® ou no Linux®, altere para o diretório em que copiou o conteúdo do disco, e no
diretório para o sistema operacional, digite o seguinte comando, onde localização é o local
onde o arquivo de especificação de transferência, o nome_arquivo, foi copiado:
./issetup -s local/nome_arquivo.ats
Se um status de retorno diferente de zero (0) é apresentado, verifique os arquivos de registros para
mensagens de erro. Os erros são registrados no diretório local_c10\instlog em um arquivo de resumo
de log de erros. O formato do nome de arquivo é
tl-código_do_produto-versão-aaaammdd-hhmm_resumo-erros.txt.
Se ocorrerem erros antes de ocorrer inicialização suficiente, mensagens de log serão enviadas para
um arquivo de log no diretório Temp. O formato do nome de arquivo é
tl-código_do_produto-versão-aaaammdd-hhmm.txt.
Certifique-se também de que o diretório de instalação esteja protegido contra acesso inadequado
ou não autorizado.
Depois de resolver todos os erros, é possível definir uma configuração autônoma.
Etapas utilizando o arquivo response.ats
1. No computador de destino, insira o disco e copie o conteúdo para o computador.
2. Acesse o diretório do sistema operacional e abra o arquivo response.ats em um editor de texto.
Cada seção no arquivo response.ats corresponde a uma caixa de diálogo no assistente de
instalação.
3. Na caixa de diálogo do Contrato de licença, altere a propriedade Aceito para S.
Essa ação significa que você está aceitando o acordo de licença. Para ler os termos do acordo
de licença, consulte o LA_código_idioma e os arquivos de observações no diretório-raiz da
instalação referente ao sistema operacional no disco do produto.
4. Digite a localização da instalação dos arquivos de programa para o IBM Cognos BI em
APPDIR=localização.
Dica: não deve haver espaço em nenhum lado do sinal de igual (=).
5. Para os componentes do servidor do IBM Cognos BI, na seção chamada [Lista de componentes],
próxima a cada componente:
● Para instalar o componente, digite 1
● Para não instalar o componente, digite 0
Guia de instalação e configuração 347
Capítulo 14: Configuração de instalações e configurações autônomas
Observação: Não selecione componentes para o Framework Manager.
Todos os arquivos exigidos são instalados.
6. Para uma instalação Windows, para a propriedade APPFOLDER=, digite o nome da pasta do
menu Iniciar que contém os atalhos de programa.
Dica: Para garantir que a pasta de atalho seja visível a todos os usuários, digite 1 para a
propriedade ALLUSERS_FLAG=.
7. Para as informações de instalação na seção [Install Conditions]:
● Para especificar que a condição é verdadeira, digite 1.
● Para especificar que a condição é falsa, digite 0.
8. Salve o arquivo response.ats para o diretório local depois de fazer as mudanças necessárias.
9. Acesse o diretório em que o arquivo response.ats foi salvo.
10. No prompt de comando, digite o seguinte comando, onde a localização é o diretório onde o
arquivo response.ats foi copiado:
● No Windows,
issetup -s localização/response.ats
● No UNIX ou Linux,
./issetup -s localização/response.ats
Se um status de retorno diferente de zero (0) é apresentado, verifique os arquivos de registros para
mensagens de erro. Os erros são registrados no diretório local_c10\instlog em um arquivo de resumo
de log de erros. O formato do nome de arquivo é
tl-código_do_produto-versão-aaaammdd-hhmm_resumo-erros.txt.
Se ocorrerem erros antes de ocorrer inicialização suficiente, mensagens de log serão enviadas para
um arquivo de log no diretório Temp. O formato do nome de arquivo é
tl-código_do_produto-versão-aaaammdd-hhmm.txt.
Certifique-se também de que o diretório de instalação esteja protegido contra acesso inadequado
ou não autorizado.
Depois de resolver todos os erros, é possível definir uma configuração autônoma.
Definição de configurações autônomasAntes de definir uma configuração autônoma, é necessário exportar uma configuração de outro
computador que tenha os mesmos componentes do IBM® Cognos® BI instalados. É possível então
executar o IBM Cognos Configuration no modo silencioso.
A configuração exportada contém as propriedades dos componentes do IBM Cognos BI que foram
instalados no computador de origem. Se fizer mudanças à configuração global, será preciso também
copiar o arquivo de configuração global do computador de origem para o computador onde planeja
executar uma configuração autônoma. A configuração global inclui configurações como localidade
348 IBM Cognos Business Intelligence PowerPlay
Capítulo 14: Configuração de instalações e configurações autônomas
do conteúdo, do produto, moedas, fontes e cookies. Para obter mais informações, consulte "Alteração
de definições globais" (p. 279 ).
Verifique se as configurações no computador local são adequadas para uso na configuração de
outro computador com o IBM Cognos BI com os mesmos componentes instalados. Por exemplo,
se tiver alterado a parte do nome de host da propriedade URI do gateway de localhost para um
endereço IP ou nome de computador, verifique se essa configuração é adequada para a configuração
do novo computador.
Etapas
1. No IBM Cognos Configuration, no menu Arquivo, clique em Exportar como.
2. Quando solicitado sobre exportar o conteúdo descriptografado, clique em Sim.
3. Se desejar exportar a configuração atual para uma pasta diferente, na caixa Procurar em, localize
e abra a pasta.
Certifique-se de que a pasta esteja protegida de acesso inadequado ou não autorizado.
4. Na caixa Nome de arquivo, digite um nome para o arquivo de configuração.
5. Clique em Salvar.
6. Copie o arquivo de configuração exportado do computador de origem ou local de rede para o
diretório local_c10/configuration no computador onde planeja fazer uma configuração
autônoma.
7. Renomeie o arquivo para cogstartup.xml.
8. Se tiver alterado a configuração global no computador de origem, copie o arquivo coglocale.xml
do computador de origem para o diretório local_c10/configuration no computador onde planeja
fazer uma configuração autônoma.
9. Acesse local_c10/bin.
10. Digite o comando de configuração:
● No UNIX® ou Linux®, digite:
./cogconfig.sh -s
● No Windows®, digite:
cogconfig.bat -s
Dica: para ver as mensagens de log geradas durante uma configuração autônoma, consulte o
arquivo cogconfig_response.csv no diretório local_c10/logs.
Verifique se a configuração autônoma foi bem-sucedida analisando o status de retorno. Um
valor igual a zero (0) indica êxito e todos os outros valores indicam que ocorreu um erro.
O IBM Cognos Configuration aplica as configurações especificadas na cópia local do arquivo
cogstartup.xml, criptografa credenciais, gera certificados digitais e, se aplicável, inicia o serviço ou
processo do IBM Cognos.
Guia de instalação e configuração 349
Capítulo 14: Configuração de instalações e configurações autônomas
Configuração de desinstalações autônomasConfigure uma instalação e uma configuração autônoma para
● Automatizar a remoção de componentes de diversos computadores que possuem os mesmos
componentes.
● Remover os componentes em um ambiente UNIX® ou Linux® que não possua o XWindows.
Etapas
1. Acesse local_c10/instlog.
2. Abra o arquivo de especificação de transferência .ats para o produto em um editor de texto.
O formato do nome de arquivo da especificação de transferência é
ts-código_do_produto-versão-aaaammdd_hhmm.ats
onde product_code é exibido conforme listado na tabela a seguir:
ProdutoCódigo_do_produto
Servidor do IBM® Cognos® BIBISRVR
Servidor de relatórios do IBM Cognos BICRNSRVR
Servidor do IBM Cognos BI AnalysisCPPSRVR
Framework ManagerBIMODEL
AmostrasBISAMPLES
Supplementary Languages DocumentationLP
É necessário editar apenas um arquivo .ats por produto.
3. Na seção chamada [Component List], especifique os componentes a serem removidos.
● Para remover o componente, digite 1
● Para deixar o componente instalado, digite 0
Por padrão, todos os componentes instalados são definidos para ser removidos (1).
4. Salve e feche o arquivo.
5. Repita as etapas de 2 a 4 para cada produto instalado.
6. A partir da linha de comando do sistema operacional, altere para o diretório local_c10\uninstall.
7. No prompt de comando, digite o seguinte comando:
● No Windows®,
uninst -u -s
350 IBM Cognos Business Intelligence PowerPlay
Capítulo 14: Configuração de instalações e configurações autônomas
● No UNIX ou Linux,
./uninst -u -s
Todos os componentes definidos como 1 nos arquivos .ats serão removidos.
Guia de instalação e configuração 351
Capítulo 14: Configuração de instalações e configurações autônomas
352 IBM Cognos Business Intelligence PowerPlay
Capítulo 14: Configuração de instalações e configurações autônomas
Capítulo 15: Manutenção do desempenho
Esta seção inclui tópicos sobre como utilizar o IBM® Cognos® e outras ferramentas e métricas para
manter o desempenho do ambiente do IBM Cognos Business Intelligence.
Métricas de desempenho do sistemaO IBM® Cognos® BI fornece métricas de sistema que podem ser utilizados para monitorar o estado
de todo o sistema e de cada servidor, distribuidor e serviço. Também é possível definir limites para
as pontuações das métricas. Alguns exemplos de métricas de desempenho do sistema são o número
de sessões no sistema, quanto tempo um relatório fica na fila, há quanto tempo o JavaTM Virtual
Machine (JVM) está em execução e o número de solicitações e processos no sistema.
As métricas de desempenho do sistema residem no ambiente Java, mas podem ser monitoradas no
IBM Cognos Administration por meio do IBM Cognos Connection. Para obter mais informações
sobre métricas de desempenho do sistema, consulte o Guia de administração e segurança.
É possível fazer um instantâneo das métricas do sistema atual para poder acompanhar tendências
ao longo do tempo ou rever detalhes sobre o estado do sistema em determinado momento. Para
obter mais informações, consulte o tópico sobre o arquivo de esvaziamento de métricas no capítulo
sobre solução de problemas do Guia de administração e segurança.
Também é possível monitorar externamente as métricas do sistema para o IBM Cognos
Administration usando Java Management Extensions (JMX), uma tecnologia que fornece ferramentas
para gerenciar e monitorar aplicativos e redes orientadas a serviços.
Monitoramento das métricas do sistema externamenteÉ possível monitorar métricas de sistema fora do IBM® Cognos® Administration usando JavaTM
Management Extensions (JMX) padrão do mercado. Primeiro, configure duas propriedades JMX
no IBM Cognos Configuration para ativar acesso seguro às métricas no ambiente Java. Em seguida,
use uma ID e senha do usuário seguras para conectar-se às métricas por meio de uma ferramenta
de conexão JMX.
É necessário instalar o Sun Java JDK ou o Java Software Development Kit da IBM antes de poder
usar o recurso de monitoramento externo.
Etapas
1. No local onde o Content Manager está instalado, inicie o IBM Cognos Configuration.
2. Na janela Explorer, clique em Ambiente.
3. Na janela Propriedades, em Configurações de distribuidor, clique em Porta JMX externa.
4. Na coluna Valor, digite um número de porta disponível.
5. Clique em Credencial JMX externa.
Licensed Materials – Property of IBM353© Copyright IBM Corp. 2005, 2010.
6. Na coluna Valor, clique no botão de edição, digite uma ID e senha do usuário e clique em OK.
A ID e senha do usuário garantem que apenas um usuário autorizado pode conectar-se aos
dados de métricas do sistema no ambiente Java, usando a porta especificada em Porta JMX
externa.
7. Salve as alterações e reinicie o serviço.
8. Para acessar os dados de métricas do sistema, especifique as seguintes informações na ferramenta
de conexão JMX:
● O URL para se conectar aos dados de métricas do sistema
Por exemplo,
service:jmx:rmi://Content_Manager_
server/jndi/rmi://monitoring_server:<JMXport>/proxyserver
em que JMXport é o valor inserido para a Porta JMX externa, Content_Manager_server
e monitoring_server são nomes de máquinas. Não use localhost, mesmo se estiver se
conectando localmente.
● A ID e senha do usuário para proteger a conexão.
Use os mesmos valores configurados para a Credencial JMX externa.
Ativação apenas de serviços obrigatóriosCaso alguns serviços IBM® Cognos® BI não sejam necessários no ambiente, é possível desativá-los
para melhorar o desempenho de outros serviços.
Por exemplo, para dedicar um computador a executar e distribuir relatórios, é possível desativar
os serviços em um computador com Application Tier Components. Quando o serviço de apresentação
é desativado, o desempenho dos Application Tier Components melhora.
Observações
● O serviço de apresentação deve permanecer ativado em pelo menos um computador do ambiente
do IBM Cognos BI.
● Se deseja utilizar o Query Studio, ative o Serviço de apresentação.
● Se deseja utilizar o Analysis Studio, ative o Serviço de relatório.
● Se alguns componentes do IBM Cognos BI não estiverem instalados em um computador, desative
os serviços associados aos componentes ausentes. Do contrário, os componentes do IBM
Cognos BI irão falhar aleatoriamente.
Serviços IBM Cognos
Depois que o IBM Cognos BI for instalado e configurado, um distribuidor estará disponível em
cada computador por padrão. Cada distribuidor possui um conjunto de serviços associados, listados
na tabela a seguir.
354 IBM Cognos Business Intelligence PowerPlay
Capítulo 15: Manutenção do desempenho
FinalidadeServiço
Executa agentes. Se as condições para um
agente forem atendidas durante sua
execução, o serviço do agente solicitará que
o serviço do monitor execute as tarefas.
Serviço do agente
Habilita a adição de comentários aos
relatórios por meio do IBM Cognos
Dashboard. Esses comentários permanecem
nas versões do relatório.
Serviços do Annotation
Gerencia solicitações de segundo plano para
executar os relatórios e oferece resultados
do serviço de monitoração.
Serviço de relatório em batch
Aprimora o desempenho geral do sistema
e a escalabilidade do Content Manager ao
armazenar em cache os resultados das
consultas freqüentes em cada distribuidor.
Serviço de cache do Content Manager
● Desempenha funções de manipulação
de objetos no armazenamento de
conteúdo como adição, consulta,
atualização, exclusão, movimentação
e cópia.
● Desempenha funções de gerenciamento
do armazenamento de conteúdo como
importação e exportação.
Serviço Content Manager
Gerencia a execução das tarefas de
movimentação de dados no IBM Cognos
BI. As tarefas de movimentação de dados,
como Builds e JobStreams, são criadas no
Data Manager Designer e publicadas no
IBM Cognos BI.
Serviço de movimentação de dados
Envia e-mails para um servidor SMTP
externo em nome de outros serviços, como
o serviço de relatórios, serviço de trabalhos,
serviço de agentes ou serviço de integrações
de dados.
Serviço de entrega
Guia de instalação e configuração 355
Capítulo 15: Manutenção do desempenho
FinalidadeServiço
Cria, programa e gerencia objetos de evento
que representam relatórios, funções,
agentes, manutenção de armazenamento de
conteúdo, importações e exportações de
implantações e métricas.
Serviço de gerenciamento de eventos
Gera gráficos em nome do serviço de
relatório. Os gráficos podem ser gerados
em quatro formatos diferentes: linhas
paralelas, vetores, Microsoft® Excel XML
ou PDF.
Serviços do Graphics
Permite a criação e o gerenciamento de
tarefas realizadas por usuários. Uma tarefa
realizada por usuários, como a aprovação
de relatórios, pode ser atribuída à
indivíduos ou grupos em uma base ad hoc
ou por qualquer outro serviço.
Serviço de tarefas realizadas por usuários
Fornece funções básicas de texto completo
para o armazenamento e a recuperação de
termos e documentos resumidos indexados.
Serviço de dados do índice
Fornece funções de pesquisa e drill-through,
incluindo listas de alias e exemplos.
Serviço de pesquisa do índice
Fornece funções de gravação, atualização,
exclusão e administração.
Serviço de atualização do índice
Executa trabalhos ao sinalizar o serviço do
monitor para executar as etapas do trabalho
em segundo plano. As etapas incluem
relatórios, outros trabalhos, importações,
exportações, etc.
Serviço de trabalho
356 IBM Cognos Business Intelligence PowerPlay
Capítulo 15: Manutenção do desempenho
FinalidadeServiço
Registra mensagens de log geradas pelo
distribuidor e por outros serviços. O serviço
de log pode ser configurado para registrar
informações de log em um arquivo, banco
de dados, servidor de log remoto,
Windows® Event Viewer ou um log de
sistema do UNIX®. Em seguida, as
informações do log podem ser analisadas
pelos clientes ou pelo Cognos Software
Services, incluindo:
Serviço de log
● Eventos de segurança.
● Informações do erro do sistema e do
aplicativo.
● Informações de diagnóstico
selecionadas.
Fornece suporte às informações de linhagem
de dados exibidas no Cognos Viewer, no
Report Studio, no Query Studio e no
Analysis Studio. As informações de
linhagem incluem informações como fonte
de dados e expressões de cálculo.
Serviço de metadados
Fornece a interface do usuário do Metric
Studio para o monitoramento e a inserção
de informações de desempenho.
Serviço Metric Studio
Gerencia a migração do IBM Cognos Series
7 para o IBM Cognos BI.
Serviço de migração
Guia de instalação e configuração 357
Capítulo 15: Manutenção do desempenho
FinalidadeServiço
● Gerencia o monitoramento e a
execução de tarefas que estão
programadas, que foram enviadas para
execução posterior ou executadas como
uma tarefa de segundo plano.
● Atribui um serviço meta para
manipular uma tarefa programada. Por
exemplo, o serviço do monitor pode
solicitar que o serviço de relatórios em
lote execute um relatório, que o serviço
de trabalhos execute um trabalho ou
que o serviço de agentes execute um
agente.
● Cria objetos do histórico dentro do
Content Manager e gerencia o failover
e a recuperação para executar entradas.
Serviço de monitor
Gerencia as solicitações de execução de
relatórios do PowerPlay.
Serviço do PowerPlay®
● Transforma respostas genéricas em
XML de outro serviço no formato de
saída, como HTML ou PDF.
● Fornece os recursos de exibição,
navegação e administração no IBM
Cognos Connection.
Serviço de apresentação
Gerencia as solicitações de consultas
dinâmicas e exibe o resultado no serviço em
lotes ou de relatórios solicitante.
Serviço de consulta
Gerencia a transferência dos dados de
relatórios entre o IBM Cognos BI e os
aplicativos que utilizam os dados, como o
IBM Cognos BI para Microsoft Office e o
IBM Cognos Mobile.
Serviço de dados de relatório
Gerencia as solicitações interativas de
execução de relatórios e fornece o resultado
para usuários no IBM Cognos Connection
ou em um studio.
Serviço de relatório
358 IBM Cognos Business Intelligence PowerPlay
Capítulo 15: Manutenção do desempenho
Ajuste do Armazenamento de conteúdo do DB2Se utilizar um banco de dados DB2® para o armazenamento de conteúdo, você poderá executar
etapas para acelerar o processamento das solicitações.
Por padrão, o DB2 atribui tabelas que contêm objetos grandes (LOBS) a um tablespace gerenciado
por banco de dados. Como resultado, os LOBS não são gerenciados pelos pools de buffer do DB2.
Isso resulta em solicitações de E/S diretas nos LOBS, que afeta o desempenho. Ao reinstalar as
tabelas que contêm LOBS a um tablespace gerenciado pelo sistema, o número de solicitações diretas
de E/S é reduzido.
Antes de mudar o armazenamento de conteúdo do DB2, aloque espaço de log suficiente para re-
estruturar o banco de dados.
Para reconfigurar o armazenamento de conteúdo do DB2, faça o seguinte:
❑ Exporte os dados das tabelas que contêm pelo menos um objeto grande (LOB).
❑ Crie as tabelas em um tablespace gerenciado pelo sistema.
❑ Importe os dados em tabelas.
Ajuste dos recursos da memória para o IBM Cognos ServicePara melhorar o desempenho em um ambiente distribuído, é possível alterar a quantidade de recursos
que o serviço do IBM® Cognos® utiliza.
Por padrão, o serviço do IBM Cognos é configurado para usar recursos mínimos de memória a fim
de otimizar o tempo de inicialização.
As definições de modelo de configuração para o serviço do IBM Cognos se aplicam somente ao
Tomcat, o servidor de aplicativos utilizado pelo IBM Cognos BI por padrão. Se desejar configurar
o IBM Cognos BI para que seja executado em outro servidor de aplicativos, não use o IBM Cognos
Configuration para configurar os recursos. Ao invés disso, configure os recursos naquele ambiente
do servidor de aplicativos. Para obter mais informações, consulte "Configuração do IBM Cognos BI
para servidores de aplicativos diferentes do Tomcat" (p. 311 ).
O serviço do IBM Cognos está disponível somente nos computadores em que o Content Manager
ou os componentes da camada de aplicativos foram instalados.
Etapas
1. Inicie o IBM Cognos Configuration.
2. Na janela Explorer, expanda Ambiente > Serviços do IBM Cognos e clique em IBM Cognos.
3. Na janela Propriedades, altere o valor para Memória máxima em MB.
● Para reduzir o tempo de inicialização, a área de cobertura da memória e os recursos
utilizados, use a definição padrão de 768.
● Para fazer um balanço entre o tempo as velocidades rápidas do tempo de inicialização e
operacionais, digite um valor que seja cerca de 1,5 vezes o valor padrão, como 1152.
Guia de instalação e configuração 359
Capítulo 15: Manutenção do desempenho
● Para melhorar as velocidades operacionais e se o desempenho for mais importante do que
o tempo de inicialização rápida, e se o computador tiver muitos recursos, digite um valor
que seja cerca do dobro do valor padrão, como 1536.
4. No menu Arquivo, clique em Salvar.
Ajuste das configurações do Apache TomcatSe utilizar o Apache Tomcat, é possível editar as configurações para melhorar o desempenho.
É possível editar as configurações do maxProcessor e do acceptCount no arquivo server.xml.
Etapas
1. Abra o arquivo server.xml.
2. Edite as configurações que aparecem depois do seguinte comentário:
<!-- Define a non-SSL Coyote HTTP/1.1 Connector on port 8080 -->
Localize a seguinte linha:
maxProcessors="75"
e altere-a para o seguinte:
maxProcessors="1000"
3. Localize a seguinte linha:
acceptCount="100"
e altere-a para o seguinte:
acceptCount="500"
4. Salve o arquivo server.xml atualizado.
Aumento da capacidade de tratamento de solicitações para oBanco de dados de conteúdo do Cognos
O Banco de dados de conteúdo do Cognos está configurado para uso em um sistema pequeno. Se
for utilizar o Banco de dados de conteúdo do Cognos em um sistema grande, em que o número de
solicitações simultâneas é maior que dez, é preciso ajustar as configurações de memória padrão do
JVM e aumentar o tamanho de cache da página para Derby.
Etapas
1. No diretório local_c10\bin, abra o arquivo derby.sh.
2. Localize a seguinte linha:
MEM_SETTINGS=-Xmx256m
e altere-a para o seguinte:
360 IBM Cognos Business Intelligence PowerPlay
Capítulo 15: Manutenção do desempenho
MEM_SETTINGS="-Xmx1152m -XX:MaxPermSize=128M -XX:MaxNewSize=576m
-XX:NewSize=288m"
3. No diretório local_c10\configuration, renomeie derby.properties.sample para derby.properties.
4. No mesmo diretório, abra o arquivo derby.properties.
5. Comente a seguinte linha:
derby.storage.pageCacheSize=15000
Melhoria do desempenho do banco de dados de armazenamentode métricas
O IBM® Cognos® BI fornece um script chamado cmm_update_stats que atualiza os índices do banco
de dados de armazenamento de métricas, o que melhora o desempenho. Esse script é utilizado
normalmente antes ou depois de carregar dados quando o volume ou a distribuição de dados mudou
significativamente. Por exemplo, o desempenho pode melhorar se esse script for executado depois
de aumentar o número de cartões de desempenho de 100 para 1000.
Etapas
1. Certifique-se de que não haja atividade no banco de dados de armazenamento de métricas.
2. Vá para o seguinte diretório:
local_c10\configuration\schemas\cmm
3. Acesse o diretório do banco de dados apropriado.
4. Dependendo do tipo de banco de dados, execute um dos seguintes scripts da linha de comando:
● Para Microsoft® SQL Server ou DB2®:
cmm_update_stats host_name metric_store_name Admin_user_name password
● Para Oracle:
cmm_update_stats metric_store_name Admin_user_name password
Redução do tempo de entrega para relatórios em uma redeOs relatórios que são distribuídos globalmente levam mais tempo para abrir em locais remotos do
que para abrir localmente. Além disso, os relatórios HTML levam mais tempo para abrir que
relatórios em PDF porque mais solicitações são processadas para relatórios HTML.
É possível reduzir a quantidade de tempo para abrir relatórios em locais remotos de duas maneiras.
É possível reduzir o número de solicitações entre o navegador e o servidor executando o relatório
em formato PDF. Se relatórios HTML forem obrigatórios, é possível acelerar a entrega do relatório
configurando gateways adicionais em alguns locais remotos. O conteúdo estático, como gráficos e
folhas de estilo, será entregue mais rapidamente.
Guia de instalação e configuração 361
Capítulo 15: Manutenção do desempenho
Aumento do limite de tempo assíncrono em ambiente decarregamento de uso intenso
Se tiver uma carga de usuário intensa (mais de 165) e os relatórios interativos estiverem em execução
contínua em uma instalação distribuída, pode ser necessário aumentar o limite de tempo assíncrono
para evitar mensagens de erro. O padrão é 30000.
Pode ser necessário também estabelecer o limite de tempo de fila para 360. Para obter informações,
consulte o IBM® Cognos® BI Guia de administração e segurança.
Para resolver esse problema, aumente o timeout de espera.
Etapas
1. Vá para o seguinte diretório:
local_c10webapps/p2pd/WEB-INF/services/.
2. Abra o arquivo reportservice.xml em um editor de texto.
3. Altere o parâmetro async_wait_timeout_ms para 120000.
4. Salve o arquivo.
5. Reinicie os serviços.
362 IBM Cognos Business Intelligence PowerPlay
Capítulo 15: Manutenção do desempenho
Apêndice A: Configuração manual do IBM CognosBI
O console conectado ao computador com sistema operacional UNIX® ou Linux® no qual está sendo
instalado o IBM® Cognos® Business Intelligence pode não ser compatível com uma interface gráfica
de usuário baseada em JavaTM. As seguintes tarefas devem ser executadas manualmente.
❑ Alterar manualmente as definições de configuração padrão editando o arquivo cogstartup.xml,
localizado no diretório local_c10/configuration.
❑ Alterar manualmente o suporte de idioma ou de moeda, ou o mapeamento de localidades
editando o arquivo coglocale.xml, localizado no diretório local_c10/configuration.
❑ Aplicar as definições de configuração e de localidade ao seu computador iniciando os serviços
do IBM Cognos no modo silencioso.
❑ Implantar o IBM Cognos BI em um ambiente de servidor de aplicativos criando manualmente
um arquivo de aplicativos do IBM Cognos.
Para todas as instalações, são necessárias algumas tarefas de configuração para que o IBM Cognos
BI funcione no ambiente. Se os componentes do IBM Cognos BI forem distribuídos em vários
computadores, a ordem na qual se configura e inicia os computadores é importante.
Outras tarefas de configuração são opcionais e dependem do ambiente do relatório. É possível
alterar o comportamento padrão do IBM Cognos BI editando o arquivo cogstartup.xml para alterar
valores de propriedade. Também é possível utilizar arquivos de amostra que permitam que o IBM
Cognos BI use recursos disponíveis no ambiente.
Configuração manual do IBM Cognos BI no UNIX e no LinuxO console conectado ao computador com sistema operacional UNIX® ou Linux® no qual está sendo
instalado o IBM® Cognos® BI pode não ser compatível com uma interface gráfica de usuário baseada
em JavaTM. É necessário
❑ Alterar manualmente definições de configuração padrão editando o arquivo cogstartup.xml,
localizado no diretório local_c10/configuration.
❑ Alterar manualmente o suporte de idioma ou de moeda, ou o mapeamento de localidades
editando o arquivo coglocale.xml, localizado no diretório local_c10/configuration.
❑ Aplicar a configuração e as definições de localidade em seu computador executando o IBM
Cognos Configuration no modo silencioso.
Para todas as instalações, são necessárias algumas tarefas de configuração para que o IBM Cognos
BI funcione no ambiente. Se os componentes do IBM Cognos BI forem distribuídos em vários
computadores, a ordem na qual se configura e inicia os computadores é importante.
Licensed Materials – Property of IBM363© Copyright IBM Corp. 2005, 2010.
Outras tarefas de configuração são opcionais e dependem do ambiente do relatório. É possível
alterar o comportamento padrão do IBM Cognos BI editando o arquivo cogstartup.xml para alterar
valores de propriedade. Também é possível utilizar arquivos de amostra que permitam que o IBM
Cognos BI use recursos disponíveis no ambiente.
Alteração manual das definições de configuração padrão em computadores comUNIX e Linux
Se o console conectado ao computador com sistema operacional UNIX® ou Linux® não for
compatível com uma interface gráfica de usuário baseada em JavaTM, será necessário editar o arquivo
cogstartup.xml para configurar o IBM® Cognos® BI para funcionar no ambiente.
Observação: Algumas definições de configuração não são salvas no arquivo cogstartup.xml a não
ser que a interface de usuário gráfica seja usada. Por exemplo: o fuso horário do servidor não está
definido nos componentes do IBM Cognos quando se modificar diretamente o arquivo cogstartup.xml
e então executar o IBM Cognos Configuration no modo silencioso. Neste caso, outras configurações
de usuário que dependem do fuso horário do servidor podem não funcionar como o esperado.
Se desejar que o IBM Cognos BI utilize um recurso, como um provedor de autenticação que já existe
no ambiente, é possível adicionar um componente à configuração. Isso é feito copiando o código
XML necessário de arquivos de amostra no arquivo cogstartup.xml e, em seguida, editando os
valores para se adaptarem ao ambiente.
Por padrão, o arquivo cogstartup.xml é codificado utilizando UTF-8. Quando salvar o arquivo
cogstartup.xml, certifique-se de alterar a codificação da localidade do usuário para corresponder
à codificação utilizada. A codificação da localidade do usuário é definida pelas variáveis de ambiente.
Quando o arquivo cogstartup.xml é editado, lembre-se de que o XML é sensível a maiúsculas e
minúsculas. Essa sensibilidade é importante em todos os usos de texto, incluindo rótulos de elemento
e de atributos, elementos e valores.
Antes de editar o arquivo cogstartup.xml, certifique-se de
● Fazer uma cópia de backup.
● Criar o armazenamento de conteúdo em um computador disponível na rede.
● Revisar os requisitos de configuração para seu tipo de instalação.
Etapas
1. Acesse o diretório local_c10/configuration.
2. Abra o arquivo cogstartup.xml em um editor.
3. Localize a definição de configuração que deseja mudar procurando na ajuda e em comentário
de descrição que aparecem antes do marcador de início dos elementos <crn:parameter> .
4. Altere o valor do elemento <crn:value> de forma a se adequar ao ambiente.
Dica: Utilize o atributo type para ajudar a determinar o tipo de dados para a propriedade de
configuração.
5. Repita as etapas 3 e 4 até que os valores da configuração sejam adequados ao ambiente.
364 IBM Cognos Business Intelligence PowerPlay
Apêndice A: Configuração manual do IBM Cognos BI
6. Salve e feche o arquivo.
Utilize um editor de XML de validação para validar as mudanças em relação às regras no arquivo
cogstartup.xsd, localizado no local_c10/configuration.
Adição de componentes à configuração
O arquivo cogstartup.xml contém definições de configuração utilizadas pelo IBM® Cognos® BI e
por componentes padrão. É possível alterar os componentes que o IBM Cognos BI usa copiando
elementos XML dos arquivos de amostra para o arquivo cogstartup.xml. É possível editar os valores
de configuração para que se adaptem ao ambiente.
Por exemplo, para utilizar o banco de dado Oracle para o armazenamento de conteúdo, é possível
utilizar o arquivo de amostra ContentManager_language code.xml para substituir as informações
de conexão de banco de dados padrão.
O IBM Cognos BI pode usar apenas uma instância por vez dos seguintes elementos:
● O banco de dados para o armazenamento de conteúdo.
● Um provedor de criptografia.
● Um modelo de configuração para o serviço do IBM Cognos.
O usuário deve estar familiarizado com a estrutura dos arquivos XML antes de começar a editá-
los.
Etapas
1. Acesse o diretório local_c10/configuration/samples.
2. Escolha um arquivo de amostra para abrir em um editor:
● Para usar Oracle, DB2® ou Sybase para o armazenamento de conteúdo, abra o arquivo
ContentManager_código_idioma.xml.
● Para utilizar um provedor de autenticação, abra o arquivo
Authentication_language_code.xml.
● Para utilizar um provedor de criptografia, abra o arquivo Cryptography_language_code.xml.
● Para enviar mensagens de log para um lugar diferente de um arquivo, abra o arquivo
Logging_language_code.xml.
● Para utilizar um modelo médio ou grande para a quantidade de recursos que o processo
do IBM Cognos BI utiliza, abra o arquivo CognosService_código_idioma.xml.
3. Copie os elementos de que precisa.
Dica: Certifique-se de copiar o código incluindo os marcadores de início e fim para o elemento
<crn:instance>.
Por exemplo, procure os comentários (Begin of) e (End of):
<!-- =============================================== (Begin of) DB2 template--> <crn:instance ...> ... </crn:instance> <!-- End of) DB2 template=============================================== -->
Guia de instalação e configuração 365
Apêndice A: Configuração manual do IBM Cognos BI
4. Acesse o diretório local_c10/configuration.
5. Abra o arquivo cogstartup.xml em um editor.
6. Cole o código do arquivo de amostra para o arquivo cogstartup.xml e substitua o elemento
<crn:instance> correto.
7. Altere o valores desses novos elementos de forma que se adaptem ao ambiente.
Para o elemento <crn:instance>, não altere o atributo de classe. É possível alterar esses valores
para melhor se adaptarem ao ambiente.
Por exemplo, se utilizar um banco de dados Oracle para o armazenamento de conteúdo, mude
apenas o nome do atributo para se adaptar ao ambiente.
<crn:instance class="Oracle" name="MyContentStore">
8. Salve e feche o arquivo.
9. Execute o IBM Cognos Configuration no modo silencioso digitando o seguinte comando:
./cogconfig.sh -s
Isso garante que o arquivo seja válido e que as senhas estejam criptografadas.
Alteração manual de configurações criptografadas
É possível mudar manualmente as configurações criptografadas, como senhas e credenciais de
usuário, no arquivo cogstartup.xml.
Para solicitar que o IBM® Cognos® Configuration salve uma configuração criptografada, altere o
valor e, em seguida, defina o marcador de criptografia como falso.
Etapas
1. Acesse o diretório local_c10/configuration.
2. Abra o arquivo cogstartup.xml em um editor.
3. Localize a configuração criptografada que deseja mudar procurando na ajuda e em comentário
de descrição que aparecem antes do marcador de início dos elementos <crn:parameter>.
4. Altere o valor do elemento <crn:value> de forma a se adequar ao ambiente.
Dica: Utilize o atributo de tipo para ajudar a determinar o tipo de dados para a propriedade
de configuração.
5. Mude o valor da criptografia para falso.
Por exemplo,
<crn:value encrypted="false">
6. Repita as etapas 3 e 5 até que os valores da configuração sejam adequados ao ambiente.
7. Salve e feche o arquivo.
8. Digite o seguinte comando de configuração:
366 IBM Cognos Business Intelligence PowerPlay
Apêndice A: Configuração manual do IBM Cognos BI
./cogconfig.sh -s
As novas configurações são salvas e criptografadas.
Alteração manual das configurações globais em computadores com UNIX e LinuxSe o console conectado ao computador com sistema operacional UNIX® ou Linux® não for
compatível com uma interface gráfica de usuário baseada em JavaTM, será necessário editar
manualmente o arquivo coglocale.xml localizado no diretório local_c10/configuration.
As configurações globais podem ser mudadas
● Para especificar o idioma utilizado na interface de usuário quando o idioma na localidade do
usuário não estiver disponível.
● Para especificar a localidade utilizada nos relatórios quando a localidade do usuário não estiver
disponível.
● Para adicionar suporte à moeda ou localidade para reportar dados ou metadados.
● Para adicionar suporte a idioma à interface do usuário.
Por padrão, os componentes do IBM® Cognos® BI asseguram que todas as localidades, que podem
vir de diferentes fontes e formatos, utilizem uma forma padronizada. Isto significa que todos os
locais expandidos se adaptam às configurações de idioma e código da região.
Antes de adicionar um suporte de idioma à interface do usuário é necessário instalar os arquivos
de idiomas em todos os computadores da instalação distribuída. Para obter mais informações,
consulte o representante de suporte.
Exemplo 1
Um relatório está disponível no Content Manager em duas localidades, como com en-us (inglês dos
Estados Unidos) e fr-fr (francês da França), mas a localidade do usuário está definida para fr-ca
(francês do Canadá). O IBM Cognos usa o mapeamento de localidade para determinar que relatório
é visto pelo usuário.
Primeiro, o IBM Cognos verifica se o relatório está disponível no Content Manager na localidade
do usuário. Se não estiver, o IBM Cognos mapeia a localidade do usuário para uma localidade
padronizada configurada na guia Mapeamento de Localidade do Conteúdo. Como a localidade do
usuário é fr-ca, esta é mapeada para fr. O IBM Cognos utiliza o valor mapeado para ver se o
relatório está disponível em fr. Nesse caso, o relatório está disponível em en-us e fr-fr, e não em fr.
Em seguida, o IBM Cognos mapeia cada relatório disponível para uma localidade padronizada.
Desta forma, en-us se torna en e fr-fr se torna fr.
Já que o relatório e a localidade do usuário mapeiam para fr, o usuário com a localidade do usuário
fr-ca verá o relatório salvo com a localidade fr-fr.
Exemplo 2
As localidades do usuário e do relatório são mapeadas para o mesmo idioma. O IBM Cognos escolhe
qual localidade será usada. Por exemplo: se a localidade do usuário for en-ca (inglês do Canadá) e
os relatórios estiverem disponíveis em en-us (inglês dos EUA) e en-gb (inglês do Reino Unido), o
Guia de instalação e configuração 367
Apêndice A: Configuração manual do IBM Cognos BI
IBM Cognos mapeará todas as localidades para en. O usuário verá o relatório na configuração de
localidade que o IBM Cognos escolher.
Exemplo 3
As localidades do relatório e do usuário não mapeiam para um idioma comum. O IBM Cognos
escolhe o idioma. Neste caso, pode ser necessário configurar um mapeamento. Por exemplo, se um
relatório estiver disponível em en-us (inglês dos EUA) e fr-fr (francês da França), porém a localidade
do usuário for es-es (espanhol da Espanha), o IBM Cognos escolherá o idioma.
Etapas
1. Em cada computador onde o Content Manager foi instalado, acesse o diretório
local_c10/configuration.
2. Abra o arquivo coglocale.xml em um editor.
3. Adicione ou modifique o elemento e o atributos requeridos entre os marcadores de início e fim
adequados.
Os elementos, atributos e marcas inicial e final estão listados na tabela a seguir.
Marcador de fimMarcador de inícioTipo de elemento
</supportedProductLocales><supportedProductLocales>Idioma
</supportedContentLocales><supportedContentLocales>Localidades do
conteúdo
</supportedCurrencies><supportedCurrencies>Moeda
</productLocaleMap><productLocaleMap>Mapeamento de
Localidades do
Produto
</contentLocaleMap><contentLocaleMap>Mapeamento de
Localidade do
Conteúdo
</supportedFonts><supportedFonts>Fontes
</parameter><parameter name="setting">Configurações de
cookie, localização de
arquivos para
relatórios
Dica: Para remover o suporte, exclua o elemento.
4. Salve e feche o arquivo.
368 IBM Cognos Business Intelligence PowerPlay
Apêndice A: Configuração manual do IBM Cognos BI
Dica: Utilize um editor de XML de validação para validar as mudanças em relação às regras no
arquivo cogstartup.xsd, localizado no local_c10/configuration.
Se for adicionado um código de unidade monetária não suportado, será necessário adicioná-lo
manualmente ao arquivo i18n_res.xml no diretório local_c10/bin/. Copie este arquivo para cada
computador com o IBM Cognos na instalação.
Início e interrupção do IBM Cognos BI em modo silencioso nos computadorescom UNIX e Linux
Execute o IBM® Cognos® Configuration no modo silencioso para aplicar as definições de
configuração e iniciar os serviços nos computadores com sistema operacional UNIX® ou Linux®
que não são compatíveis com uma interface gráfica de usuário baseada em JavaTM.
Antes de executar a ferramenta de configuração no modo silencioso, certifique-se de que o arquivo
cogstartup.xml seja válido de acordo com as regras definidas no arquivo cogstartup.xsd. O arquivo
cogstartup.xsd está localizado no diretório local_c10/configuration.
Etapas para iniciar o IBM Cognos BI
1. Verifique se o arquivo cogstartup.xml, localizado no diretório local_c10/configuration, foi
modificado para o ambiente.
Para obter mais informações, consulte "Alteração manual das definições de configuração padrão
em computadores com UNIX e Linux" (p. 364 ).
2. Acesse o diretório local_c10/bin.
3. Digite o seguinte comando
./cogconfig.sh -s
Dica: para ver as mensagens de log geradas durante uma configuração autônoma, consulte o
arquivo cogconfig_response.csv no diretório local_c10/logs.
O IBM Cognos Configuration aplica as definições de configuração especificadas no arquivo
cogstartup.xml, criptografa credenciais, gera certificados digitais e, caso se aplique, inicia o serviço
ou processo do IBM Cognos.
Etapas para interromper o IBM Cognos BI
1. Acesse o diretório local_c10/bin.
2. Digite o seguinte comando
./cogconfig.sh -stop
Criação manual de arquivos de aplicativo do IBM CognosO IBM® Cognos® BI e o gateway de servlet devem ser empacotados em um arquivo de aplicativo
para implantação em servidores de aplicativos compatíveis (p. 320 ), (p. 294 ). O IBM Cognos BI
fornece um assistente para criação de aplicativo que pode ser utilizado para criar o arquivo de
aplicativo.
Guia de instalação e configuração 369
Apêndice A: Configuração manual do IBM Cognos BI
É possível criar um arquivo web (.war), um arquivo Enterprise (.ear) ou um diretório expandido
que inclui todos os arquivos necessários para o aplicativo. Para obter mais informações sobre os
arquivos WAR e EAR e para determinar qual deles é suportado pelo servidor de aplicativos, consulte
a documentação fornecida junto com o servidor de aplicativos.
Se escolher não utilizar o Assistente para Criação de Aplicativo, será necessário concluir as seguintes
etapas para criar o arquivo de aplicativo.
Se o servidor de aplicativo não está sendo utilizado como um servidor web, não é necessário incluir
o conteúdo estático do IBM Cognos (páginas html, imagens e assim por diante) no arquivo de
aplicativo. A exclusão do conteúdo estático ao criar o arquivo de aplicativo reduz o tamanho do
arquivo.
Etapas para criar arquivos de aplicativo do IBM Cognos BI
1. Acesse o diretório local_c10/war/p2pd.
2. Execute o script de estrutura utilizando a seguinte sintaxe de comando:
● No sistema operacional Microsoft® Windows®:
build.bat file_type option
● Nos sistemas operacionais UNIX® ou Linux®:
build.sh file_type option
onde file_type pode ser um dos valores listados na tabela a seguir:
DescriçãoValor
Arquivo WAR com conteúdo estáticowar
Arquivo WAR sem conteúdo estáticowar_without_webcontent
Arquivo WAR com conteúdo estático e sem
arquivos de documentação ou amostra
war_without_docsamples
Arquivo EAR com conteúdo estáticoear
Arquivo EAR sem conteúdo estáticoear_without_webcontent
Arquivo EAR com conteúdo estático e sem
arquivos de documentação ou amostra
ear_without_docsamples
diretório que contém o aplicativo com conteúdo
estático
expandir
diretório que contém o aplicativo sem conteúdo
estático
expand_without_webcontent
370 IBM Cognos Business Intelligence PowerPlay
Apêndice A: Configuração manual do IBM Cognos BI
DescriçãoValor
diretório que contém o aplicativo com conteúdo
estático e sem arquivos de documentação ou
amostra
expand_without_docsamples
e onde option pode ser um ou mais dos valores listados na tabela a seguir:
DescriçãoValorOpção
Executar ações em um
servidor de aplicativos
JBoss
jboss
outro (padrão)
-Dappserver_type=value
Executar ações em um
servidor de aplicativos
que não JBoss
Predeterminar um valor-
raiz de contexto para o
aplicativo
p2pd (padrão)-Dcontext_root=valor
Caminho e nome do
arquivo WAR que será
criado
caminho/nome de arquivo
O padrão é ../../p2pd.war
-Dwar_name=valor
Caminho e nome do
arquivo EAR que será
criado
caminho/nome de arquivo
O padrão é ../../p2pd.ear
-Dear_name=valor
Caminho para o diretório
onde os arquivos do
aplicativo serão
expandidos
caminho/diretório
O padrão é
../../temp/expand
-Dexpand_location=valor
(Para tipos de arquivos de expansão)
Etapas para criar arquivos de aplicativo de gateway de servlet
1. Acesse o diretório local_c10/war/gateway.
2. Execute o script de estrutura utilizando a seguinte sintaxe de comando:
● Para o Windows,
build.bat file_type option
● No UNIX ou LINUX,
build.sh file_type option
Guia de instalação e configuração 371
Apêndice A: Configuração manual do IBM Cognos BI
onde file_type pode ser um dos valores listados na tabela a seguir:
DescriçãoValor
Arquivo WAR com conteúdo estáticogateway_war
Arquivo WAR com conteúdo estático e sem
arquivos de documentação ou amostra
gateway_war_without_docsamples
Arquivo EAR com conteúdo estáticogateway_ear
Arquivo EAR com conteúdo estático e sem
arquivos de documentação ou amostra
gateway_ear_without_docsamples
diretório que contém o aplicativo com
conteúdo estático
expandir
diretório que contém o aplicativo com
conteúdo estático e sem arquivos de
documentação ou amostra
expand_without_docsamples
e onde option pode ser um ou mais dos valores listados na tabela a seguir:
DescriçãoValorOpção
Executar ações em um
servidor de aplicativos
JBoss
jboss
outro (padrão)
-Dappserver_type=value
Executar ações em um
servidor de aplicativos que
não JBoss
Predeterminar um valor-
raiz de contexto para o
aplicativo
ServletGateway (padrão)-Dcontext_root=valor
Caminho e nome do
arquivo WAR que será
criado
caminho/nome de arquivo
O padrão é ../../ServletGateway.
war
-Dwar_name=valor
Caminho e nome do
arquivo EAR que será
criado
caminho/nome de arquivo
O padrão é ../../ServletGateway.
ear
-Dear_name=valor
372 IBM Cognos Business Intelligence PowerPlay
Apêndice A: Configuração manual do IBM Cognos BI
DescriçãoValorOpção
Caminho para o diretório
onde os arquivos do
aplicativo serão expandidos
caminho/diretório
O padrão é ../../temp/expand
-Dexpand_location=valor
Guia de instalação e configuração 373
Apêndice A: Configuração manual do IBM Cognos BI
374 IBM Cognos Business Intelligence PowerPlay
Apêndice A: Configuração manual do IBM Cognos BI
Apêndice B: Solução de problemas
Use essas informações de referência de solução de problemas e essas soluções como um recurso
para ajudá-lo a resolver problemas específicos que podem ser encontrados durante ou após a
instalação dos componentes do IBM® Cognos® PowerPlay®.
Os problemas se caracterizam por seus sintomas. Cada sintoma pode ser rastreado para uma ou
mais causas utilizando ferramentas e técnicas específicas de solução de problemas. Após identificado,
o problema pode ser solucionado através da implementação de uma série de ações.
Durante a solução de problemas, os arquivos de log podem ajudar. Outra ferramenta de solução
de problemas valiosa é o Knowledge Base (Base de dados de conhecimento), disponível no IBM
Cognos Customer Center ( http://www.ibm.com/software/data/support/cognos_crc.html). A Base
de dados de conhecimento é uma base de dados de problemas e soluções para todos os produtos
IBM Cognos.
Quando não puder solucionar um problema, o recurso final é seu representante de suporte técnico
do IBM Cognos. Para analisar um problema, o representante do suporte técnico necessita de
informações a respeito da situação e dos sintomas experimentados. Para ajudar a isolar o problema,
colete os dados necessários antes de entrar em contato com o representante.
Arquivos de logOs arquivos de log podem ajudá-lo a resolver problemas registrando as atividades que acontecem
ao trabalhar com um produto. As operações realizadas no IBM® Cognos® BI são registradas em
vários arquivos de log para fins de controle. Por exemplo, se houve problemas ao instalar o IBM
Cognos BI, consulte o log de transferência para saber quais atividades o assistente de instalação
realizou ao transferir os arquivos.
Antes de começar a visualizar os arquivos de log, certifique-se de que eles contêm as informações
de que precisa. O número dos arquivos de log e as informações que eles contêm são definidos por
parâmetros no IBM Cognos Connection e no IBM Cognos Configuration.
Use o IBM Cognos Administration para aprender mais sobre as categorias de log e como definir o
nível de detalhes para fazer log em cada categoria.
Para obter mais informações, consulte o Guia de administração e segurança do IBM Cognos BI.
Use o IBM Cognos Configuration para especificar o tamanho, o número e o local dos arquivos de
log, e para configurar as propriedades do servidor de log. Para obter mais informações, consulte o
Guia do usuário do IBM Cognos Configuration.
Ao solucionar problemas, os seguintes arquivos podem ajudá-lo:
O arquivo de log de transferência
Este arquivo registra as atividades que o assistente de instalação realizou ao transferir arquivos. Os
arquivos de log de transferência estão localizados no diretório local_c10\instlog. O nome do arquivo
Licensed Materials – Property of IBM375© Copyright IBM Corp. 2005, 2010.
identifica o nome, a versão e o número de fabricação do produto, e possui um carimbo de data/hora.
A seguir, um exemplo do formato de nome de arquivo:
tl-BISRVR-8.1-0.0-20080901_1122.txt
O arquivo de log do erro de resumo da transferência
Esse arquivo registra os componentes instalados, a informação de espaço em disco, as seleções
realizadas em caixas de diálogo de transferência e qualquer erro que o assistente de instalação
encontrou ao transferir os componentes. Os arquivos de log de erro de resumo de transferência
estão localizados no diretório local_c10/instlog. O nome do arquivo identifica o nome, a versão e
o número de fabricação do produto, e possui um carimbo de data/hora. A seguir, um exemplo do
formato de nome de arquivo:
tl-BISRVR-8.1-0.0-20080901_1122_summary_error.txt
Arquivo de configuração da inicialização
Esse arquivo registra as escolha de configuração cada vez que as configurações de propriedades são
salvas. O nome do arquivo é cogstartup.xml. Se não for possível salvar as configurações ou se estiver
com problemas, é possível reverter para um arquivo de configuração salvo anteriormente. Os
arquivos de configuração de backup estão localizados no diretório local_c10/configuration. A seguir,
um exemplo do formato de nome de arquivo para o backup dos arquivos de configuração:
cogstartup_200811231540.xml
Arquivo de bloqueio da configuração da inicialização
Este arquivo é criado cada vez que o IBM Cognos Configuration for aberto. Ele evita a abertura
de mais de uma janela do IBM Cognos Configuration. Se tiver problemas ao abrir o IBM Cognos
Configuration, verifique o arquivo cogstartup.lock no diretório local_c10/configuration. Se o arquivo
existir e o IBM Cognos Configuration não estiver aberto, significa que o IBM Cognos Configuration
não foi desligado corretamente na última vez que foi utilizado. É possível excluir o arquivo de
bloqueio e abrir o IBM Cognos Configuration.
O arquivo de configuração de local
Esse arquivo registra as escolhas de configuração feitas no IBM Cognos Configuration para os
locais de produto e de conteúdo, mapeamento de local e suporte à moeda. Se tiver problemas com
o suporte de idiomas na interface de usuário ou em relatórios, use esses arquivos para rastrear as
alterações. Os arquivos de configuração de backup estão localizados no diretório
local_c10/configuration. A seguir, um exemplo do formato de nome de arquivo:
coglocale_200811231540.xml
Arquivo de log de tempo de execução
O arquivo de log padrão do IBM Cognos de nome cogserver.log ou outros arquivos de log
configurados para receber mensagens de log do servidor de log, registram informações após a
inicialização do serviço do IBM Cognos BI. Eles estão localizados no diretório local_c10/logs. Se
foi configurado outro destino para as mensagens de log, verifique o arquivo ou banco de dados
adequado.
376 IBM Cognos Business Intelligence PowerPlay
Apêndice B: Solução de problemas
Algumas mensagens de log indicam problemas. A maioria das mensagens somente fornece
informações, mas outras podem ajudá-lo a diagnosticar problemas em seu ambiente de tempo de
execução.
Arquivo de log do gateway
Os gateways registram erros no arquivo de log do gateway, localizado no diretório local_c10/logs.
É possível usar o arquivo de log do gateway para solucionar problemas que evitam que o gateway
processe solicitações ou use criptografia. Os sintomas desses problemas são os seguintes:
● IDs e senhas dos usuários não funcionam.
● O signon único não funciona.
● O distribuidor está sendo executado mas os usuários recebem uma mensagem de erro avisando
que o servidor do IBM Cognos BI não está disponível
O arquivo de log do gateway usa o seguinte formato de nome, em que gateway_interface é cgi, mod
(Apache 1.3 module), mod2 (Apache 2.0 module) ou isapi.
gwgateway_interface.log (por exemplo, gwcgi.log)
Arquivo de log de desinstalação
O arquivo registra as atividades realizadas pelo assistente de desinstalação ao desinstalar os arquivos.
O arquivo de log é nomeado cognos_uninst_log.htm e está localizado no diretório Temp. É possível
usar o arquivo de log para solucionar problemas relacionados à desinstalação dos componentes do
IBM Cognos BI.
Arquivo de log do modo silencioso
Esse arquivo registra as atividades que o IBM Cognos Configuration realizou ao executar em modo
silencioso. Esse arquivo de log é nomeado cogconfig_response.csv e está localizado no diretório
local_c10/logs.
Arquivo de atualização do ReportNet para IBM Cognos BI
Este arquivo contém um resumo dos resultados de uma atualização do ReportNet® para o IBM
Cognos BI. O arquivo de log tem o nome de upgradeLog.xml e está localizado no diretório
c10_location/logs. O arquivo está em formato xml e faz referência a uma folha de estilo xslt. Clique
duas vezes no arquivo para exibi-lo no navegador.
Problemas ao iniciar o IBM Cognos Business IntelligenceÉ possível que se depare com problemas ao:
● iniciar o serviço do IBM® Cognos® BI
● abrir a página de boas-vindas do portal do IBM Cognos BI pela primeira vez
● Iniciar um servidor de aplicativo, como o WebLogic ou o WebSphere®
A tabela a seguir mostra alguns sintomas comuns e suas soluções.
Guia de instalação e configuração 377
Apêndice B: Solução de problemas
SoluçãoSintomas
Verifique as configurações do servidor web.A tela principal do portal do IBM Cognos BI não é
exibida ao iniciar o IBM Cognos BI.
Verifique as configurações do armazenamento de conteúdo.O serviço inicia, mas nenhuma tabela é criada no banco
de dados de armazenamento de conteúdo.
Certifique-se de aguardar alguns momentos antes de enviar
uma solicitação.
O serviço não inicia.
Verifique as permissões de arquivo e os nomes de diretórios
do local de instalação do servidor de aplicativos.
O servidor de aplicativo não inicia.
Certifique-se de utilizar outro software suportado pelos componentes IBM Cognos. É possível
visualizar uma lista atualizada de ambientes como sistemas operacionais, patches, navegadores e
servidores da web, de diretórios e de bancos de dados no IBM Cognos Costumer Center (http://
www.ibm.com/software/data/cognos/customercenter/).
CFG-ERR-0106 Erro ao iniciar o serviço do IBM Cognos no IBM CognosConfiguration
Ao iniciar o serviço do IBM® Cognos® BI, a seguinte mensagem de erro pode ser exibida:
CFG-ERR-0106 O IBM Cognos Configuration não recebeu resposta do serviço do IBM Cognos
no tempo atribuído.Verifique se o serviço IBMCognos está disponível e configurado corretamente.
Há duas causas possíveis para este problema:
● O serviço do IBM Cognos precisa de mais tempo para iniciar.
● Um computador com Content Manager em espera pode estar configurado incorretamente.
O serviço do IBM Cognos precisa de mais tempo
Por padrão, o IBM Cognos Configuration verifica o progresso da solicitação de inicialização a cada
meio segundo durante três minutos. Se o IBM Cognos Configuration não receber uma resposta
durante este tempo, a mensagem de erro é exibida.
Para evitar esse erro, altere o valor do tempo que o IBM Cognos Configuration deve aguardar para
receber uma resposta do serviço do IBM Cognos. Para isso, configure as propriedades de
ServiceWaitInterval e de ServiceMaxTries no arquivo c10_location/configuration/cogconfig.prefs.
A propriedade ServiceWaitInterval representa o intervalo de tempo, em milissegundos, em que o
IBM Cognos Configuration verifica o progresso da solicitação de inicialização. Por padrão, seu
valor é 500, que é equivalente a meio segundo.
A propriedade ServiceMaxTries representa o número de vezes que o IBM Cognos Configuration
verifica o progresso da solicitação de inicialização. Por padrão, seu valor é 360.
378 IBM Cognos Business Intelligence PowerPlay
Apêndice B: Solução de problemas
Content Manager configurado incorretamente
Se esta mensagem de erro aparecer em um computador com o Content Manager em espera, a
configuração para armazenamento das chaves simétricas pode estar incorreta.
Para evitar este problema, configure o computador com Content Manager em espera para armazenar
as chaves simétricas localmente.
Etapas para alterar o tempo de espera
1. Usando o IBM Cognos Configuration, pare o serviço do IBM Cognos.
2. Abra o arquivo c10_location/configuration/cogconfig.prefs em um editor.
Este arquivo é criado automaticamente na primeira vez que o IBM Cognos Configuration for
aberto.
3. Adicione os seguintes códigos ao arquivo:
ServiceWaitInterval=número de milissegundos
ServiceWaitInterval=número de vezes
Dica: Adicione os valores numéricos que correspondem às suas necessidades de configuração.
4. Salve o arquivo.
5. Usando o IBM Cognos Configuration, inicie o serviço do IBM Cognos.
Etapas para armazenar as chaves simétricas localmente
1. No computador com Content Manager em espera, inicie o IBM Cognos Configuration.
2. Na janela Explorer, em Segurança, clique emCriptografia.
3. Na janela Propriedades, em Configurações CSK, defina Armazenar chave simétrica localmente
para Verdadeiro.
4. No menu Arquivo, clique em Salvar.
5. No menu Ações, clique em Iniciar.
Esta ação inicia todos os serviços instalados que não estiverem em execução. Caso deseje iniciar
determinado serviço, selecione o nó do serviço na janela do Explorer e clique em Iniciar no
menu Ações.
Erro de criptografia ao iniciar o IBM Cognos BIEsta mensagem de erro é exibida ao tentar iniciar o serviço do IBM® Cognos® BI após a instalação
de componentes de servidor ou cliente:
[Criptografia]
1. [ ERROR ] java.lang.NoClassDefFoundError:
javax/net/ServerSocketFactory:
Guia de instalação e configuração 379
Apêndice B: Solução de problemas
O JavaTM Runtime Environment (JRE) não tem as rotinas de criptografia e descriptografia necessárias
para o IBM Cognos BI. É necessário copiar o arquivo Java Archive (.jar) fornecido ao diretório
JRE.
Etapa
● Copie o arquivo bcprov-jdknn-nnn.jar da versão lc10_location/bin/jre/do diretório /lib/ext para
o diretório Java_location/jre/lib/ext.
Não foi possível iniciar o serviço do IBM Cognos porque a porta já está sendousada por outro processo
Talvez não seja possível iniciar o serviço ou o processo do IBM ®Cognos® BI se uma das portas
padrão estiver em uso por outro processo.
Dica: Para visualizar as conexões de rede TCP/IP da rede atual, use o comando netstat.
Use o IBM Cognos Configuration para alterar a porta padrão que o IBM Cognos BI utiliza.
Ao alterar a porta usada pelo distribuidor local, é necessário alterar o valor das propriedades do
URI do distribuidor. Deve-se alterar os URI de todos os componentes locais devido ao fato da
alteração afetar todos os URIs baseados no distribuidor local. Por padrão, os componentes locais
possuem um localhost no URI.
Por exemplo, se instalar todos os componentes em um computador e quiser alterar a porta do
distribuidor, substitua 9300 em todos os URIs de distribuidor e do Content Manager pelo novo
número de porta.
Etapas para alterar a porta padrão
1. Inicie o IBM Cognos Configuration.
2. Na janela do Explorer, clique no grupo ou componente apropriado:
● Para acessar o número de porta nos URIs de distribuidor e de Content Manager, clique em
Ambiente.
● Para acessar o número de porta do servidor de log local, em Ambiente, clique em Log.
● Para acessar o número da porta de encerramento, em Ambiente, clique em Serviços IBM
Cognos > IBM Cognos BI.
● Para acessar o número da porta para o local do arquivo applications.xml usado pelo Portal
Services, em Ambiente, clique em Portal Services.
3. Na janela Propriedades, clique na caixa Valor próxima à propriedade que deseja alterar.
4. Altere o valor de 9300 para o novo valor.
Certifique-se de alterar as portas em todos os URIs que contenham localhost:9300.
5. No menu Arquivo, clique em Salvar.
6. No menu Ação, clique em Iniciar.
380 IBM Cognos Business Intelligence PowerPlay
Apêndice B: Solução de problemas
O serviço do IBM Cognos não inicia ou há falha após a inicializaçãoO serviço do IBM® Cognos® BI inicia, mas os serviços não iniciam corretamente ou estão muito
lentos. O sistema falha pouco tempo depois da inicialização do sistema. Durante a inicialização
dos serviços, o JavaTM usa 100 % do tempo da CPU. Também poderão aparecer várias ocorrências
das seguintes mensagens de erro:
● DPR-DPR-1035 O distribuidor detectou um erro.
● CAM-CRP-1157 Impossível sincronizar o arquivo local da chave simétrica comum com o
Content Manager.
Ao usar um banco de dados DB2® para o armazenamento de conteúdo, certifique-se de que a versão
do banco de dados e a versão Java sejam compatíveis. Para a versão 8.2 do DB2, a versão 1.5 do
Java não é suportada. Para a versão 9 do DB2, a versão 1.5 do Java é suportada em todos os sistemas
operacionais exceto HPUX e Solaris.
Para visualizar uma lista atualizada de ambientes suportados pelos produtos IBM Cognos, como
sistemas operacionais, patches, navegadores e servidores da web, de diretório, de bancos de dados
e de aplicativos, visite o site do IBM Cognos Customer Center (http://www.ibm.com/software/data/
cognos/customercenter/).
Falha na inicialização do servidor IBM Cognos BI sem retorno de mensagem deerro
Pode ocorrer falha na inicialização de um servidor do IBM® Cognos® BI após uma nova instalação
ou atualização, sem que seja exibida uma mensagem de erro. Isso pode ocorrer quando um servidor
do IBM Cognos BI novo ou previamente em execução estiver configurado para usar grande
quantidade de memória.
Se o servidor no qual o IBM Cognos BI está instalado contiver a versão 1.0 da atualização de
segurança 921883 da Microsoft®, poderá ocorrer problemas quando houver muita solicitação de
memória contígua por um aplicativo.
Esse é um problema conhecido com a versão 1.0 do patch de segurança 921883 da Microsoft. A
Microsoft distribuiu uma segunda versão do patch para corrigir o problema. Como solução,
desinstale o primeiro patch de segurança ou instale a versão 2.0. Ou configure o servidor do IBM
Cognos BI para usar menos memória.
Para obter mais informações, consulte o artigo da base de dados de conhecimento da Microsoft
sobre programas que falham usando muita memória contígua no site de suporte da Microsoft.
Servidor IBM Cognos BI indisponível ao iniciar o IBM Cognos BIApós configurar os componentes do IBM® Cognos® e iniciar seus serviços, ao conectar-se ao portal
do IBM Cognos BI, as seguintes mensagens de erro podem ser exibidas:
O Cognos Gateway não consegue se conectar ao servidor Cognos BI.
O servidor pode estar indisponível, ou o gateway pode não estar configurado corretamente.
Guia de instalação e configuração 381
Apêndice B: Solução de problemas
Verifique o arquivo de log do servidor IBM Cognos para obter mais informações. Por padrão, o
arquivo cogserver.log está localizado no diretório c10_location/logs. Se foi configurado outro
destino para as mensagens de log, verifique o arquivo ou banco de dados adequado.
O Content Manager pode não conseguir conectar-se com o armazenamento de conteúdo se este
último não estiver configurado corretamente. Isso pode ocorrer se:
● o armazenamento de conteúdo usa uma codificação de caracteres incompatível
● o armazenamento de conteúdo usa uma seqüência de intercalação de banco de dados que faz
distinção entre maiúsculas e minúsculas
● as configurações especificadas no IBM Cognos Configuration são inválidas
Codificação de caracteres não suportada
Se as seguintes mensagens forem exibidas no arquivo de log, o banco de dados criado para o
armazenamento de conteúdo não usa uma codificação de caracteres compatível:
● Para Oracle:
CM-CFG-5063 Foi detectado um erro de configuração do Content Manager ao se conectar ao
armazenamento de conteúdo.
CM-SYS-5121 O Content Manager não pode iniciar porque não há suporte para o conjunto
de caracteres do banco de dados de armazenamento de conteúdo.
CM-SYS-5126 O servidor banco de dados de armazenamento de conteúdo usa o conjunto de
caracteres US7ASCII.
CM-SYS-5125 O cliente banco de dados de armazenamento de conteúdo usa o conjunto de
caracteres US7ASCII.
● Para DB2® UDB:
CM-CFG-5063 Foi detectado um erro de configuração do Content Manager ao se conectar ao
armazenamento de conteúdo.
CM-SYS-5121 O Content Manager não pode iniciar porque não há suporte para o conjunto
de caracteres do banco de dados de armazenamento de conteúdo.
CM-SYS-5124 O servidor do banco de dados de armazenamento de conteúdo usa a página de
códigos US7ASCII.
● Para Sybase:
CM-CFG-5063 Foi detectado um erro de configuração do Content Manager ao se conectar ao
armazenamento de conteúdo.
CM-SYS-5121 O Content Manager não pode iniciar porque não há suporte para o conjunto
de caracteres do banco de dados de armazenamento de conteúdo.
Para que o Content Manager conecte-se ao armazenamento de conteúdo, este último deve usar uma
codificação de caracteres apropriada, conforme listado na tabela a seguir.
382 IBM Cognos Business Intelligence PowerPlay
Apêndice B: Solução de problemas
Codificação de caracteresBanco de dados
AL32UTF8Oracle 9i
AL32UTF16
Codeset UTF-8DB2 UDB
UTF-8Sybase ASE
UTF8Microsoft® SQL Server
UTF16
Para solucionar este problema, é necessário recriar o banco de dados de armazenamento de conteúdo
usando a codificação de caracteres correta ou converter a codificação de caracteres. Para obter mais
informações, consulte a documentação do banco de dados.
Seqüência de intercalação com distinção entre maiúsculas e minúsculas
Se as seguintes mensagens forem exibidas no arquivo de log, o banco de dados criado para o
armazenamento de conteúdo utiliza uma seqüência de intercalação de banco de dados que faz
distinção entre maiúsculas e minúsculas:
CM-CFG-5063 Foi detectado um erro de configuração do Content Manager ao se conectar ao
armazenamento de conteúdo.
CM-SYS-5122 O banco de dados de armazenamento de conteúdo possui uma intercalação padrão
que distingue maiúsculas de minúsculas.OContentManager requer um armazenamento de conteúdo
que possua uma comparação que faça a distinção de maiúsculas e minúsculas.
CM-SYS-5123 O servidor do banco de dados de armazenamento de conteúdo usa a intercalação
<parâmetro>.
CM-SYS-5007 A criação @cm_build_version@ do Content Manager falhou ao iniciar! Revise os
arquivos de log do Content Manager e, em seguida, entre em contato com o administrador do
sistema ou suporte ao cliente.
Para solucionar este problema, é necessário recriar o banco de dados de armazenamento de conteúdo
usando uma seqüência de intercalação de banco de dados que não faça distinção entre maiúsculas
e minúsculas. Para obter mais informações, consulte a documentação do banco de dados.
Configurações inválidas
Se as mensagens a seguir ou mensagens similares estiverem no arquivo de log, o armazenamento
de conteúdo não foi configurado corretamente no IBM Cognos Configuration.
● Para Microsoft SQL Server:
CM-CFG-5063 Foi detectado um erro de configuração do Content Manager ao se conectar ao
armazenamento de conteúdo.
CM-CFG-5036 Falha do Content Manager ao conectar-se com o armazenamento de conteúdo.
A string de conexão é "jdbc:JSQLConnect://localhost:1433/cm".
Guia de instalação e configuração 383
Apêndice B: Solução de problemas
Falha no Logon:com.jnetdirect.jsql.x: Impossível abrir o banco de dados solicitado no login
'cm'. Falha no login. url:jdbc:JSQLConnect://localhost:1433/cm.
● Para DB2:
CM-CFG-5063 Foi detectado um erro de configuração do Content Manager ao se conectar ao
armazenamento de conteúdo.
CM-CFG-5003 O Content Manager não pode acessar o armazenamento de conteúdoVerifique
os parâmetros de conexão do banco de dados e entre em contato com o administrador do banco
de dados.
[IBM][CLI Driver] SQL1013N O nome de alias do banco de dados ou o nome do banco de
dados "CM123" não pôde ser encontrado.
● Para Oracle:
CM-CFG-5063 Foi detectado um erro de configuração do Content Manager ao se conectar ao
armazenamento de conteúdo.
CM-CFG-5036 Falha do Content Manager ao conectar-se com o armazenamento de conteúdo.
A string de conexão é "jdbc:oracle:thin:@localhost:1521:pb1".
ORA-01017: nome de usuário/senha inválido; logon negado.
● Para Sybase:
CM-CFG-5063 Foi detectado um erro de configuração do Content Manager ao se conectar ao
armazenamento de conteúdo.
CM-CFG-5036 Falha do Content Manager ao conectar-se com o armazenamento de conteúdo.
A string de conexão é "jdbc:sybase:Tds:localhost:5000/cm".
JZ006: IOException obtida: java.net.ConnectException: Conexão negada: conectar.
Se estiver usando um banco de dados Oracle, não utilize caracteres não permitidos - como, por
exemplo, sublinhados - no IBM Cognos Configuration para a propriedade Nome do serviço. Se o
Nome do serviço incluir caracteres ilegais, as tabelas não serão criadas no banco de dados de
armazenamento de conteúdo quando o serviço do IBM Cognos for iniciado.
Etapas para Microsoft SQL Server, Oracle, DB2 e Sybase
1. No computador onde o Content Manager foi instalado, inicie o IBM Cognos Configuration.
2. Na janela Explorer, em Acesso a dados > Content Manager, clique com o botão direito do
mouse em Armazenamento de conteúdo e clique em Excluir.
Esta ação exclui o recurso padrão. O Content Manager deve estar configurado para acessar
somente um armazenamento de conteúdo.
3. Clique com o botão direito do mouse em Content Manager e clique em Novo recurso > Banco
de dados.
4. Na caixa Nome, digite um nome para o recurso.
5. Na caixa de seleção Tipo, selecione o tipo de banco de dados e clique em OK.
384 IBM Cognos Business Intelligence PowerPlay
Apêndice B: Solução de problemas
Se estiver atualizando e desejar usar um armazenamento de conteúdo existente, selecione o tipo
de banco de dados usado na última versão do ReportNet® ou do IBM Cognos BI.
Se foi instalada mais de uma versão do IBM Cognos BI, será necessário usar um armazenamento
de conteúdo diferente para cada versão. Quando um armazenamento de conteúdo for usado
com uma nova versão do IBM Cognos BI, ele não poderá ser usado com uma versão mais antiga
do ReportNet ou do IBM Cognos BI .
Dica: Se desejar usar um par de valores de palavra-chave do Oracle Net8 para gerenciar a
conexão do banco de dados, selecione Banco de dados Oracle (avançado).
6. Na janela Propriedades, forneça valores dependendo do tipo de seu banco de dados:
● Se usar um banco de dados Microsoft SQL Server, digite os valores apropriados para as
propriedades Servidor de bancos de dados com número de porta ou nome da instância e
Nome do banco de dados.
Para a propriedade Servidor de bancos de dados com número de porta ou nome da instância,
inclua o número da porta se usar portas não padrão. Inclua o nome da instância se houver
instâncias múltiplas do Microsoft SQL Server.
Para se conectar a uma instância denominada, é necessário especificar o nome da instância
como uma propriedade URL JDBC ou de fonte de dados. Por exemplo, digite
localhost\instance1. Se não forem especificadas propriedades de nome de instância, é criada
uma conexão com a instância padrão.
Observe que as propriedades especificadas para a instância denominada, junto com a ID
e senha de usuário e nome do banco de dados, são usados para criar um URL JDBC. Eis
um exemplo:
jdbc:JSQLConnect://localhost\\instance1/user=sa/mais propriedades como solicitado
● Se usar um banco de dados DB2, para a propriedade Nome do banco de dados, digite o
alias do banco de dados.
● Se usar um banco de dados Oracle, digite os valores apropriados para as propriedades
Servidor do banco de dados e número da porta e Nome do serviço.
● Se usar um banco de dados avançado do Oracle, para a propriedade Especificador do banco
de dados, digite o par de valores de palavra-chave Oracle Net8 para a conexão.
Eis um exemplo:
(description=(address=(host=myhost)(protocol=tcp)(port=1521)(connect_data=(sid=(orcl)))))
● Se usar um banco de dados Sybase, digite os valores apropriados para as propriedades
Servidor do banco de dados e número da porta e Nome do banco de dados.
7. Se desejar mudar as credenciais de logon, especifique uma ID e senha de usuário:
● Clique na caixa Valor ao lado da propriedade ID do usuário e senha e, em seguida, clique
no botão de edição quando aparecer.
● Digite os valores apropriados e clique em OK.
Guia de instalação e configuração 385
Apêndice B: Solução de problemas
8. No menu Arquivo, clique em Salvar.
As credenciais de logon são imediatamente criptografadas.
9. Teste a conexão entre o Content Manager e o armazenamento de conteúdo.
Dica: Na janela Explorer, clique com o botão direito no novo banco de dados e clique em
Testar.
O Content Manager se conecta ao banco de dados, verifica as permissões do banco de dados
e cria e preenche uma tabela. A tabela não é excluída e é usada cada vez que o teste for repetido.
Não é possível fazer logon em um namespace usando o IBM Cognos ConnectionÉ possível abrir o IBM® Cognos® BI pelo IBM Cognos Connection. No entanto, ao tentar criar uma
fonte de dados e fazer logon em um namespace, as seguintes mensagens de erro são exibidas:
● PRS-CSE-1255 Um erro de exceção foi encontrado na descriptografia dos dados.
● CAM-CRP-1064 Impossível processar os dados PKCS #7 devido a um erro interno. Motivo:
java.lang.IndexOutOfBoundsException.
Esse problema pode ocorrer se você não tiver as permissões necessárias aos seguintes diretórios:
● c10\configuration
● c10\configuration\csk
● c10\configuration\encryptkeypair
● c10\configuration\signkeypair
A solução é ativar as permissões para leitura e execução nos diretórios listados acima para qualquer
pessoa que necessite iniciar o serviço do IBM Cognos.
Os serviços do IBM Cognos falham ao reiniciar após uma falha de redeO IBM® Cognos® Bootstrap Service reinicia os serviços do IBM Cognos após falha de rede. Para
instalações de Tomcat nas quais um endereço IP é especificado na URI do distribuidor interno, os
serviços do IBM Cognos pode não iniciar com sucesso durante a reinicialização. Isso exigirá,
portanto, uma reinicialização manual após a restauração da rede.
Para solucionar este problema, configure a propriedade URI do distribuidor interno no IBM Cognos
Configuration para usar o localhost ou o nome de host da rede.
Não há avisos de que instalar uma versão posterior do IBM Cognos BI atualizaautomaticamente a versão anterior do armazenamento de conteúdo
Há uma versão do ReportNet® ou do IBM® Cognos® BI instalada no computador. Ocorre a instalação
de uma versão posterior em um novo local. O mesmo banco de dados do armazenamento de
conteúdo é usado para as duas versões. Após configurar a última versão e iniciar o serviço do IBM
Cognos, a versão anterior do ReportNet ou do IBM Cognos BI não funciona mais porque todo o
conteúdo foi automaticamente atualizado.
386 IBM Cognos Business Intelligence PowerPlay
Apêndice B: Solução de problemas
Se deseja usar versões diferentes do ReportNet e do IBM Cognos BI após a atualização, verifique
se, antes de instalar a versão posterior:
● foi realizado o backup do banco de dados em uso para o armazenamento de conteúdo
● o backup foi restaurado em um novo local
Também é possível usar a ferramenta de implantação para importar todo o armazenamento de
conteúdo de uma versão anterior para uma versão posterior. Todo o conteúdo existente no banco
de dados de armazenamento de conteúdo será substituído pelo conteúdo importado. Será exibida
uma mensagem de erro sobre isto.
Falha no download de recursosAo iniciar o Report Studio no Internet Explorer, as seguintes mensagens de erro são exibidas:
Falha no download do recurso especificado.
Esse problema pode ser causado por recentes atualizações do Microsoft® XMLHTTP, se não houver
uma preferência de idioma definida no Internet Explorer.
Para solucionar este problema, especifique uma preferência de idioma no Internet Explorer.
DB2 retorna o erro SQL1224N ao conectar ao AIXSe o armazenamento de conteúdo for um banco de dados DB2® e for exibido um erro SQL1224N
no AIX®, verifique o arquivo db2diag.log para obter mais informações sobre o erro.
Se o erro incluir um código de motivo 18, pode ser necessário alterar as configurações do DB2 para
aceitar mais conexões. Para obter mais informações, consulte as páginas de suporte do IBM® DB2
sobre o erro SQL1224N.
Erro do Content Manager ao iniciar o IBM Cognos BIApós iniciar o IBM® Cognos®BI, nenhum processo BIBUSTKSERVMA é iniciado. Os erros estão
listados nos arquivos pogo******.log e cogserver.log. Os usuários obtêm erros no navegador
quando se conectam ao portal do IBM Cognos BI.
No arquivo pogo******.log, aparece um erro relacionado ao Content Manager.
No arquivo cogserver.log, o seguinte erro é exibido:
Uma tentativa de registrar o distribuidor no Content Manager foi malsucedida. Serão feitas tentativas
periódicas.
Ao conectar-se a http://nome do computador/ibmcognos, a seguinte mensagem de erro é exibida
no navegador:
● DPR-ERR-2058 O distribuidor não pode atender à solicitação no momento. O distribuidor
ainda está sendo inicializado.
● SoapSocketException: Conexão negada
Guia de instalação e configuração 387
Apêndice B: Solução de problemas
O IBM Cognos Configuration usa uma ID de usuário para conectar-se ao banco de dados LDAP.
Se esta ID de usuário for movida para outro grupo, o IBM Cognos Configuration não conseguirá
mais localizá-la.
Para corrigir o problema, mova a ID de usuário para o grupo original.
O Content Manager falha ao iniciar ou demora muito para iniciarNo Microsoft® Windows®, tente iniciar o serviço no computador em que o Content Manager está
instalado. À medida que o serviço estiver sendo iniciado, os detalhes incluirão erros semelhantes
aos seguintes:
DPR-CMI-4006 Não é possível determinar o Content Manager ativo. Serão feitas tentativas
periódicas.
CM-SYS-5007 Falha ao iniciar o Content Manager build x.x.x.x!
Os detalhes no log de erro também poderão incluir referências a OutOfMemoryError.
Para solucionar esse problema, inicie o serviço usando o parâmetro DuseCMLargeResultSet. É
possível adicionar o parâmetro ao arquivo de configuração de bootstrap e, em seguida, iniciar o
serviço usando o IBM Cognos Configuration e adicionar o parâmetro ao arquivo de configuração
de inicialização e, em seguida, executar o arquivo.
Etapas usando o arquivo de configuração de bootstrap
1. Acesse o diretório local_c10\bin e abra bootstrap_win32.xml em um editor de XML.
2. Encontre a seção que começa com <param>"${install_path}.
3. Adicione o parâmetro DuseCMLargeResultSet àquela seção, no local mostrado pelo texto em
negrito no exemplo a seguir.
<param>"-Dcatalina.base=${install_path}/tomcat"</param>
<param>"-Dcatalina.home=${install_path}/tomcat"</param>
<param>"-Djava.io.tmpdir=${temp}"</param>
<param>"-DuseCMLargeResultSet=true"</param>
4. Salve e feche o arquivo.
5. Inicie o IBM Cognos Configuration e inicie o serviço.
Etapas usando o arquivo de configuração de inicialização
1. Acesse o diretório local_c10\bin e abra startup.bat em um editor de texto.
2. Localize a seguinte linha:
set CATALINA_OPTS=-Xmx768m -XX:MaxNewSize=384m -XX:NewSize=192m -XX:MaxPermSize=128m %DEBUG_OPTS%
3. Anexe o parâmetro DuseCMLargeResultSet à linha, conforme mostrado pelo texto em negrito
no exemplo a seguir:
set CATALINA_OPTS=-Xmx768m -XX:MaxNewSize=384m -XX:NewSize=192m -XX:MaxPermSize=128m %DEBUG_OPTS%-DuseCMLargeResultSet=true
388 IBM Cognos Business Intelligence PowerPlay
Apêndice B: Solução de problemas
4. Salve e feche o arquivo.
5. Inicie o serviço ao executar o arquivo startup.bat.
DPR-ERR-2014 Erro exibido no arquivo de log no computador do ContentManagerSe o Content Manager estiver instalado em um computador separado e o serviço de gerenciamento
de eventos no computador Content Manager estiver desativado, as seguintes mensagens de erro
podem ser exibidas no arquivo cogserver.log:
DPR-ERR-2014 Não é possível equilibrar a carga da solicitação porque não há nós disponíveis no
cluster ou configurados para o serviço: eventManagementService
Para corrigir o problema, faça o seguinte:
● Inicie o IBM® Cognos® Configuration no computador do Content Manager.
● No painel Explorer, vá para Ambiente > Serviços IBM Cognos.
● Configure a propriedade Serviço de gerenciamento de eventos habilitado? para Falso.
Caracteres não ASCII no diretório de instalação causam erros de execuçãoEm todos os sistemas operacionais, ao utilizar caracteres não ASCII no diretório de instalação do
IBM® Cognos® BI, podem ocorrer erros de execução. Isto também causa falha em algumas funções
de produto, como a execução do relatório.
Para solucionar o problema, instale o IBM Cognos BI no diretório padrão ou use um nome de
diretório que contenha apenas caracteres ASCII Latin-1.
Não é possível abrir um Cubo MS ou um PowerCubeNão é possível abrir um Cubo MS ou um PowerCube, ou o Cubo MS é aberto mas apenas os
metadados são exibidos. A seguinte mensagem de erro pode ser exibida no caso do Cubo MS:
MO-ERR-0030
"Não é possível conectar à fonte de dados. Configure o serviço para ser executado como um usuário
do domínio com os privilégios corretos."
Para solucionar este problema, verifique se o usuário que executa o serviço do IBM® Cognos® BI
possui acesso ao cubo.
Os PowerCubes são acessados a partir de unidades mapeadas ou nomes de caminho UNC.
Etapas para Cubos MS
1. Adicione a conta de usuário do domínio que inicia o serviço do IBM Cognos ao privilégio Agir
como parte do sistema operacional:
● Sob Ferramentas Administrativas, selecione Diretiva de segurança local.
● Expanda Configurações de Segurança, Diretivas locais e clique em Atribuição de direitos
do usuário.
Guia de instalação e configuração 389
Apêndice B: Solução de problemas
● Clique com o botão direito do mouse na diretiva Agir como parte do sistema operacional
e selecione Propriedades.
● Clique em Adicionar usuário ou grupo e adicione a conta de usuário que inicia o serviço
do IBM Cognos.
2. Se usar o método de autenticação de ID de usuário do domínio e senha, adicione a conta de
usuário que inicia o serviço do IBM Cognos ao domínio que inclui o Content Manager, os
componentes da camada de aplicativo, o servidor web IIS e o servidor da fonte de dados
(Microsoft® SQL Server ou Microsoft Analysis Server).
3. Se usar um namespace externo, como o Active Directory Server, para autenticação, adicione a
conta de usuário que inicia o serviço do IBM Cognos ao domínio que incluir o servidor de
autenticação.
Este domínio também deve incluir o Content Manager, os componentes de camada de aplicativo,
o servidor web IIS e o servidor da fonte de dados (Microsoft SQL Server ou Microsoft Analysis
Server).
Para obter mais informações sobre a configuração de namespaces externos para autenticação,
consulte os tópicos sobre autenticação fornecidos no Guia de instalação e configuração.
Etapa para o PowerCubes
● Certifique-se de que o perfil de usuário do IBM Cognos possui direitos de acesso suficientes ao
sistema operacional ou ao domínio para abrir o arquivo do PowerCube.
Para obter mais informações, consulte o Guia de administração e segurança.
A página não foi encontrada ao iniciar o IBM Cognos BI no Windows 2003Após a instalação do IBM® Cognos® BI no sistema operacional Microsoft® Windows® 2003, a
seguinte mensagem pode ser exibida ao tentar iniciar o IBM Cognos BI:
A página não pode ser encontrada. A página que você está procurando pode ter sido removida,
teve seu nome alterado ou está temporariamente indisponível. Erro HTTP 404 - Arquivo ou diretório
não encontrado.
Este erro é causado por um recurso de segurança no Internet Information Services (IIS) do Windows
2003. Esse recurso de segurança não permite extensões de arquivo cgi desconhecidas.
Para solucionar o problema, adicione uma nova extensão de arquivo no IIS para o arquivo cognos.cgi.
Para obter mais informações, consulte a documentação do IIS.
A página não é exibida ao abrir um portal após a instalação do IBM Cognos BIApós instalar e configurar o IBM® Cognos® BI, não é possível se conectar ao portal do Cognos BI.
Isso pode ocorrer porque o servidor web não está configurado corretamente. Por exemplo, os
diretórios virtuais necessários ao IBM Cognos BI podem não existir ou podem encaminhar para as
pastas físicas incorretas.
390 IBM Cognos Business Intelligence PowerPlay
Apêndice B: Solução de problemas
Para obter mais informações sobre a configuração do servidor web, consulte o Guia de instalação
e configuração.
DPR-ERR-2058 Aparece um erro no navegador web ao iniciar o IBM Cognos BIApós iniciar os serviços no IBM® Cognos® Configuration e tentar abrir o portal, uma mensagem
como uma das seguintes pode ser exibida:
DPR-ERR-2058O distribuidor encontrou um erro enquanto atendia uma solicitação.Oprocessador
XTS deve ser inicializado antes de ser chamado.
DPR-ERR-2058 O distribuidor não pode atender à solicitação no momento. O distribuidor ainda
está sendo inicializado. Tente novamente ou entre em contato com o administrador.
Essas mensagens de erro geralmente ocorrem quando o distribuidor não consegue se comunicar
com o Content Manager. Para ajudá-lo a determinar a causa específica, veja o arquivo cogserver.log
no diretório c10_location/logs. As causas mais comuns estão listadas abaixo, com suas respectivas
soluções.
Os serviços do IBM Cognos não terminam de iniciar
Após iniciar os serviços no IBM Cognos Configuration e a ferramenta de configuração mostrar que
os serviços estão em execução, aguarde alguns minutos para que todos os serviços inicializem, antes
de abrir o portal.
O Content Manager não está disponível.
Em uma instalação distribuída, certifique-se de que o Content Manager está instalado, configurado
e em execução. Certifique-se também de que outros computadores IBM Cognos estão configurados
com os URIs corretos para o Content Manager.
O armazenamento de conteúdo não está disponível ou não foi configurado corretamente
Certifique-se de que o banco de dados do armazenamento de conteúdo foi criado e que está
configurado corretamente no IBM Cognos Configuration.
As tabelas não foram criadas no armazenamento de conteúdo
Use uma versão de DB2®, Microsoft® SQL Server, Oracle ou Sybase compatível com os componentes
IBM Cognos.
As credenciais de logon para o armazenamento de conteúdo estão incorretas
Verifique se as informações foram alteradas. Por exemplo, o DB2 lê informações a partir do
gerenciamento de usuários do NT. Se a senha da conta do NT foi alterada, também é necessário
alterar as credenciais de logon no armazenamento de conteúdo do IBM Cognos Configuration.
Verifique se não há caracteres especiais na senha de logon. Às vezes, o driver JDBC não aceita
caracteres reservados para xml, como %, !, < e >.
O usuário não possui as permissões apropriadas
Certifique-se de que o usuário possui as permissões apropriadas.
Guia de instalação e configuração 391
Apêndice B: Solução de problemas
Não há memória suficiente no HP-UX
Se estiver usando o Tomcat, é possível determinar se o problema está relacionado às configurações
de servidor do HP-UX. É possível que o número máximo esperado de threads ativos simultaneamente
por processo tenha sido excedido.
Etapas para verificar um problema de configuração do HP-UX
1. No arquivo /bin/startup.sh, procure por
../tomcat/bin/catalina.sh start "$@"
2. Altere para:
../tomcat/bin/catalina.sh run "$@"
O comando de execução faz com que a saída do Tomcat seja exibida na janela de console para
o IBM Cognos BI.
3. Encerre e reinicie o IBM Cognos BI usando os comandos ./shutdown.sh e ./startup.sh.
Se a seguinte mensagem de erro for exibida na janela de console para qualquer dos servidores
aplicativos, há um problema de configuração do HP-UX:
Erro OutofMemoryException: Não é possível criar novo thread nativo no HP-UX.
O problema é que os valores padrão para as versões 11.0 e 11i do HP-UX estão configurados
muito baixos em relação à maioria dos aplicativos JavaTM.
Dica: É possível verificar o número de threads no processo usando a opção -eprof disponível
no JDK 1.1.8 e analisando o arquivo Java.eprof através do HPjmeter, selecionando a métrica
de threads.
Etapas para aumentar o número máximo de threads por processo
1. Peça ao administrador do sistema que altere o parâmetro do Kernel da seguinte forma:
● max_thread_proc = 512
● nkthread = 1024
2. Certifique-se de que as configurações de ulimit sejam ilimitadas.
O Content Manager não consegue conectar-se ao armazenamento de conteúdo no Oracle
Se estiver usando um banco de dados Oracle como armazenamento de conteúdo, pode ocorrer o
erro DPR-ERR-2058 ao fazer o login no portal http://nome_host/ibmcognos. Todas as tabelas são
criadas no banco de dados.
Também poderão ocorrer as seguintes mensagens de erro:
● CM-CFG-5036 Falha do Content Manager ao conectar-se com o armazenamento de conteúdo.
● ORA-01017: nome de usuário/senha inválido; logon negado
Etapas para configurar o nome do servidor do banco de dados Oracle
1. Na janela Explorer, clique em Acesso a dados > Content Manager > Armazenamento de
conteúdo.
392 IBM Cognos Business Intelligence PowerPlay
Apêndice B: Solução de problemas
2. Altere o nome do servidor do banco de dados Oracle para um nome totalmente adequado,
como host_name.companyname:1534, para corresponder ao nome no arquivo tnsnames.ora.
DPR-ERR-2022 Aparece um erro no navegador web ao iniciar o IBM Cognos BIApós iniciar os serviços no IBM® Cognos® Configuration e tentar abrir o portal, uma mensagem
como a seguinte pode ser exibida:
DPR-ERR-2022 Nenhuma resposta gerada. Isto pode ocorrer devido a uma configuração incorreta,
a uma instalação defeituosa ou se o distribuidor não terminou de inicializar.
Abrir o portal muito rápido
Este problema pode ocorrer se você tentar abrir o portal antes que os serviços do IBM Cognos
sejam inicializados.
Para evitar este problema, após iniciar os serviços no IBM Cognos Configuration e a ferramenta
de configuração mostrar que os serviços estão em execução, aguarde alguns minutos para que todos
os serviços inicializem, antes de abrir o portal.
O arquivo system.xml contém erros
O arquivo system.xml pode ter sido editado.
Substitua o arquivo system.xml, no diretório c10_location\templates\ps\portal, por uma cópia de
backup ou use um editor XML para editá-lo.
Caracteres corrompidos em alguns idiomas durante a instalação no LinuxAo executar o assistente de instalação no Linux® em coreano, chinês (simplificado ou tradicional)
ou japonês, talvez apareçam caracteres corrompidos nas caixas de diálogo da interface do usuário
ou nas mensagens que são exibidas durante a instalação.
Para evitar o problema de caracteres corrompidos na interface do usuário durante a instalação, use
uma das seguintes soluções:
● Configure as fontes asiáticas no servidor do Linux:
● Defina o local como utf8.
Por exemplo,
ko_KR.utf8, ja_JP.utf8, zh_CN.utf8, ou zh_TW.utf8
● Verifique se o conjunto de fontes de idioma asiático *medium-r*--14* está disponível no
servidor X.
● Execute uma instalação autônoma usando o arquivo .ats de resposta padrão fornecido com o
produto IBM® Cognos® BI. Para obter informações sobre a instalação autônoma, consulte o
Guia de instalação e configuração.
Guia de instalação e configuração 393
Apêndice B: Solução de problemas
Não foi possível fazer o download do arquivo cognos.xtsDepois de instalar o IBM® Cognos® BI, é solicitado que se faça o download do arquivo cognos.xts
quando se conectar ao portal do IBM Cognos BI. A seguinte mensagem pode ser exibida:
Você escolheu fazer download de um arquivo desta localização. cognos.xts do nome do servidor
Este problema ocorre quando as permissões dos diretórios virtuais não estão configuradas
corretamente. É preciso fornecer o diretório virtual do cgi-bin no Microsoft® Internet Information
Service (IIS) com permissões de execução.
Para solucionar este problema, recrie os diretórios virtuais em IIS com as permissões da tabela a
seguir, em que local_c10 representa o local da instalação.
PermissõesCaminhoAlias
Leiturac10_location\webcontentibmcognos
Ler Executarc10_location\cgi-binibmcognos\cgi-bin
Por exemplo, o local da instalação padrão é C:\Arquivos de programas\IBM\cognos\c10.
O script de inicialização do servidor de aplicativos falhouPode haver problemas ao executar scripts de inicialização para um servidor de aplicativos para
implantar o aplicativo IBM Cognos se os componentes do IBM® Cognos® BI estiverem instalados
em um diretório com um nome que contenha espaços.
Para resolver esse problema, reinstale um novo diretório e não inclua espaços no novo nome. Se
esta solução não for bem recebida pelos scripts de inicialização, tente adicionar aspas antes e depois
do nome do diretório que possui espaços ou usar a convenção de nomes do DOS 8.3.
Falha do IBM Cognos BI ao executar no WebLogic Application Server no AIXA instância de servidor do IBM® Cognos® BI pode entrar no estado FAILED_NOT_RESTARTABLE
no WebLogic Administration Console no AIX®. Inúmeros arquivos de memória e arquivos de
memória JavaTM são gravados no diretório de domínio do IBM Cognos BI. O IBM Cognos BI
finaliza e não fica acessível a partir do portal.
Este comportamento ocorre apenas quando o IBM Cognos BI Managed Node é iniciado com o
WebLogic Administration Console. Em vez disso, inicie o IBM Cognos BI Managed Node usando
os scripts de inicialização do WebLogic.
A implantação do IBM Cognos BI em um servidor de aplicativos Oracle ou IBMWebSphere falha
A implantação do IBM® Cognos® BI em um servidor de aplicativos Oracle ou IBM WebSphere®.
pode falhar com qualquer um dos seguintes erros:
● Limite de tempo do navegador no console de administração
394 IBM Cognos Business Intelligence PowerPlay
Apêndice B: Solução de problemas
● HTTP 500 Erro interno
● Falha na implantação: Exceção base: java.rmi.RemoteException (Oracle)
● Volte à página de seleção de arquivo do aplicativo (IBM WebSphere)
Esses erros podem ocorrer porque o arquivo do aplicativo que está sendo implantado é muito
grande.
Para solucionar esse problema, faça o seguinte:
● Se estiver usando o Assistente para Criação de Aplicativo, desmarque a caixa Incluir arquivos
estáticos da pasta Webcontent quando selecionar o aplicativo para criar.
Isso reduzirá o tamanho do arquivo do aplicativo. Se for necessário conteúdo estático, será
possível copiá-lo manualmente para o local de implantação do aplicativo após a implantação
bem-sucedida do IBM Cognos BI no servidor de aplicativos.
● Se estiver implantando o arquivo do aplicativo manualmente em um servidor de aplicativo
Oracle, digite o seguinte comando:
dcmctl deployapplication -f caminho_e_nome_arquivo_ear -a nome_aplicação -conome_instância_OC4J
Este comando não é suportado para o Oracle Release 3.
Para obter informações adicionais sobre a implantação do IBM Cognos BI em um servidor de
aplicativos, consulte o Guia de instalação e configuração.
Erro de impossibilidade de remover a série do atributo de contexto ao implementaro arquivo p2pd.war ao WebLogic
Ao implementar o arquivo p2pd.war ao WebLogic, é possível que veja as seguintes mensagens de
erro:
Erro [context]Não foi possível desserializar atributo de contexto
java.io.NotSerializableException: com.cognos.logserver.LogService
Este erro não afeta a implantação do arquivo p2pd.war.
Para evitar este problema, adicione ao menos uma preferência de idioma no Internet Explorer.
Erro exibido após atualização do IBM Cognos BI em um servidor de aplicativosWebLogic
O erro é exibido ao usar o WebLogic e atualizar o IBM® Cognos® BI de uma versão anterior. Após
implantar o arquivo p2pd.war para a nova instalação, uma mensagem como a seguinte pode ser
exibida:
<BEA-101215> <Malformed Request "null". Falha ao solicitar análise. Cód: -10>
Isto pode ocorrer caso se retire o IBM Cognos BI do WebLogic e alguns arquivos de versões anteriores
não forem removidos do sistema.
Guia de instalação e configuração 395
Apêndice B: Solução de problemas
Para solucionar o problema, use as ferramentas administrativas do seu servidor de aplicativos para
garantir que o IBM Cognos BI foi removido. Para obter informações sobre como remover aplicativos,
consulte a documentação do servidor de aplicativos.
Se o diretório no qual o IBM Cognos BI foi implantado originalmente não for removido durante o
processo de desinstalação, exclua o diretório. Além disso, remova qualquer arquivo .jar do IBM
Cognos BI que estiver em cache no ambiente do servidor de aplicativos.
Após remover todos os arquivos de instalações anteriores, é possível implantar novamente o IBM
Cognos BI.
Caracteres chineses, japoneses ou coreanos ficam diferentes após atualizaçãoCaso utilize caracteres chineses, japoneses ou coreanos, poderá notar diferenças em alguns caracteres
após a atualização do ReportNet® para o IBM® Cognos® BI.
Exemplos
● Você executa um relatório existente. Ao comparar a saída com o mesmo relatório no ReportNet,
você vê que alguns caracteres estão diferentes.
● As mesmas pesquisas que realizava no ReportNet agora produzem resultados diferentes.
As diferenças ocorrem porque as tabelas de conversão usadas para chinês, japonês e coreano foram
modificadas para atender os padrões globais. Se as especificações de relatório ou filtros de pesquisa
contêm expressões que utilizam valores constantes, os resultados podem ser afetados.
Se deseja usar a mesma tabela de conversão usada no ReportNet, execute o seguinte script no
diretório c10_location\bin:
● No UNIX®, digite
conv_compat.sh
● No Linux®, digite
conv_compat.sh
● No sistema operacional Microsoft® Windows®, digite
conv_compat.cdm
Caracteres de dois bytes ou acentuados podem não ser exibidos corretamente aoinstalar o IBM Cognos BI no Linux
Se estiver usando o issetup sob um local UTF-8, os caracteres de dois bytes ou acentuados podem
não ser exibidos corretamente.
Para resolver esse problema ao instalar em alemão ou francês, use uma localidade diferente de UTF-
8 e inicialize o issetup para instalar o IBM® Cognos® BI.
396 IBM Cognos Business Intelligence PowerPlay
Apêndice B: Solução de problemas
RSV-SRV-0066 Foi retornada uma falha de soap ou RQP-DEF-0114 O usuáriocancelou a solicitação Aparecem erros no ambiente de carga de usuário alta
Esses erros podem surgir no IBM® Cognos® cogserver.log se houver uma alta carga de usuários
(acima de 165 usuários) e relatórios interativos em execução continuamente em uma instalação
distribuída.
Para solucionar este problema, aumente o valor do parâmetro async_wait_timeout_ms no arquivo
webapps/p2pd/WEB-INF/services/reportservice.xml. Para obter mais informações, consulte o Guia
de instalação e configuração do IBM Cognos BI.
Além disso, aumente a definição do limite de tempo na fila para 360. Para obter mais informações,
consulte o Guia de administração e segurança do IBM Cognos BI.
Problemas ao configurar o IBM Cognos Business IntelligenceApós a instalação dos componentes do IBM® Cognos® BI, podem ocorrer problemas ao salvar
alterações no IBM Cognos Configuration.
Certifique-se de:
● Configurar e inicializar os serviços no computador em que o Content Manager está localizado
antes de configurar outros componentes.
● Reiniciar o serviço do IBM Cognos depois de fazer alterações na configuração.
Os valores de devolução da ferramenta de configuração cogconfig.sh não sãocompatíveis com os valores de devolução do UNIX convencional
Nas plataformas UNIX®, o comando cogconfig.sh de ferramentas de configuração retorna 0 para
as execuções mal-sucedidas e 1 para as bem-sucedidas. Esses valores de devolução não são
compatíveis com os resultados de devolução do UNIX convencional, em que o valor de devolução
0 indica execuções bem-sucedidas e o diferente de zero, um erro.
O comportamento não-compatível será corrigido em uma futura liberação. Podem ser necessárias
alterações nos aplicativos e scripts do cliente antes de adotar o novo comportamento.
Execução de scripts de limpeza de índice e de banco de dadosEm algumas situações de solução de problemas, você poderá ser aconselhado a iniciar com novos
dados de configuração.
É possível executar scripts SQL para excluir todas as tabelas em qualquer dos bancos de dados a
seguir usados pelos componentes do IBM® Cognos® BI:
● Armazenamento de conteúdo para dados que o IBM Cognos BI precisa para operar.
● Banco de dados de entrega para notificações de relatório.
● Armazenamento de métricas para conteúdos de pacotes de métricas e preferências do usuário
do Metric Studio.
● Banco de dados para human tasks e anotações.
Guia de instalação e configuração 397
Apêndice B: Solução de problemas
É possível executar scripts SQL para excluir todas as tabelas e índices do banco de dados a seguir:
● Banco de dados de log para mensagens de log.
Ao excluir uma tabela, sua definição estrutural e seus dados são excluídos permanentemente do
banco de dados. Para o armazenamento de métricas, os objetos do banco de dados também poderão
ser excluídos.
Ao excluir os índices de um banco de dados de log, eles são excluídos permanentemente do banco
de dados.
Ao reiniciar o serviço do IBM Cognos, um novo conjunto de tabelas e índices de banco de dados
necessários é criado automaticamente no local especificado nas definições de configurações.
Etapas
1. Em cada computador onde o Content Manager está localizado, interrompa o serviço do IBM
Cognos.
2. Vá para o diretório apropriado do banco de dados:
● Para excluir tabelas e índices do banco de dados de log, vá para local_c10\configuration\
schemas\logging.
● Para excluir tabelas do armazenamento de conteúdo, vá para c10_location\configuration\
schemas\content.
● Para excluir tabelas do banco de dados de notificação, vá para c10_location\configuration\
schemas\delivery.
● Para excluir tabelas do armazenamento de métricas, vá para c10_location\configuration\
schemas\cmm.
● Para excluir tabelas do banco de dados de tarefas realizadas por usuário e de anotação, vá
para c10_location\configuration\schemas\hts.
3. Acesse o diretório do banco de dados apropriado.
4. Dependendo do banco de dados e do tipo de banco de dados, execute um dos scripts a seguir
na ferramenta de banco de dados apropriada para excluir as tabelas.
A tabela a seguir lista os nomes de script para o banco de dados de armazenamento de conteúdo.
Nome do scriptTipo de banco de dados
dbClean_db2.sqlDB2®
dbClean_db2zOS.sqlDB2 em z/OS®
dbClean_derby.sqlDerby
dbClean_informix.sqlInformix®
398 IBM Cognos Business Intelligence PowerPlay
Apêndice B: Solução de problemas
Nome do scriptTipo de banco de dados
dbClean_mssqlserver.sqlMicrosoft® SQL Server
dbClean_oracle.sqlOracle
dbClean_sybase.sqlSybase
A tabela a seguir lista os nomes de script para o banco de dados de notificação.
Nome do scriptTipo de banco de dados
NC_DROP_DB2.sqlDB2
NC_DROP_DB2.sqlDB2 em z/OS
NC_DROP_Derby.sqlDerby
NC_DROP_IFX.sqlInformix
NC_DROP_MS.sqlMicrosoft SQL Server
NC_DROP_ORA.sqlOracle
NC_DROP_SYBASE.sqlSybase
A tabela a seguir lista os nomes dos scripts para limpar tabelas e índices do banco de dados de
log.
Para o Informix, o script de limpeza de índice deve ser editado se hospedar mais de um banco
de dados de log de auditoria na instância do Informix e usá-los ao mesmo tempo. Consulte a
etapa 5.
Nome do scriptTipo debanco dedados
LS_dbClean_db2.sqlDB2
LS_dbCleanIndexes_db2.sql
LS_dbClean_db2zOS.sqlDB2 em z/OS
LS_dbCleanIndexes_db2zOS.sql
LS_dbClean_derby.sqlDerby
LS_dbCleanIndexes_derby.sql
Guia de instalação e configuração 399
Apêndice B: Solução de problemas
Nome do scriptTipo debanco dedados
LS_dbClean_informix.sqlInformix
LS_dbCleanIndexes_informix.sql
LS_dbClean_mssql.sqlMicrosoft SQL
Server LS_dbCleanIndexes_mssql.sql
LS_dbClean_oracle.sqlOracle
LS_dbCleanIndexes_oracle.sql
LS_dbClean_sybase.sqlSybase
LS_dbCleanIndexes_sybase.sql
A tabela a seguir lista os nomes de script para o banco de dados de armazenamento de métricas.
Nome do scriptTipo de bancode dados
cmm_uninstall dbalias username passwordDB2
Especifique o dbalias apenas se um banco de dados com o mesmo nome já
estiver catalogado.
cmm_uninstall metric_store_name database_name Admin_user_namepassword
Microsoft SQL
cmm_uninstalldatabase_name database_user_name passwordOracle
Substitua database_name pelo nome no arquivo tnsnames.ora que se refere
ao banco de dados SID para o Metric Studio
A tabela a seguir lista os nomes de script para o banco de dados Human Task e Anotação.
Nome do scriptTipo de banco de dados
humanTaskService-dropScript.sqltodos os tipos
5. Se hospedar mais de um banco de dados de log de auditoria na instância do Informix, faça o
seguinte:
● Acesse o diretório local_c10\configuration\schemas\logging\informix e abra LS_
dbCleanIndexes_informix.sql em um editor de texto.
400 IBM Cognos Business Intelligence PowerPlay
Apêndice B: Solução de problemas
● Substitua todas as instâncias de IPFSCRIPTIDX pelo valor especificado ao criar a
propriedade IPFSCRIPTIDX no IBM Cognos Configuration. Para obter mais informações,
consulte o tópico sobre como especificar o repositório de mensagens de log no Guia de
instalação e configuração.
● Salve e feche o arquivo.
6. Inicie o serviço do IBM Cognos.
Erro ao tentar criptografar informações ao salvar as configuraçõesAo salvar as configurações usando a ferramenta de configuração, é possível que apareça uma
mensagem de erro de que as informações criptográficas não podem ser criptografadas. Ocorreu um
erro ao solicitar um certificado para a autoridade de certificação.
Não é possível criptografar as informações de criptografiaDeseja salvar a configuração em texto
sem formatação?
Antes de criptografar as configurações, o computador onde o Content Manager está instalado deve
estar configurado e em execução. No UNIX®, certifique-se de copiar os arquivos .jar adequados
para o local de instalação do JavaTM Runtime Environment. Além disso, certifique-se de que o
ambiente Java está configurado corretamente, que os URIs estão corretos e que a mesma autoridade
de certificado está configurada para todos os computadores com Content Manager.
No Linux®, certifique-se de copiar os arquivos .jar adequados para o local de instalação do Java
Runtime Environment.
Além disso, uma mensagem similar à seguinte pode aparecer:
java.lang.NoClassDefFoundError: javax/net/ServerSocketFactory.
O erro de criptografia geralmente significa que o ambiente Java não está configurado corretamente.
Certifique-se de que a variável de ambiente JAVA_HOME está definida corretamente e que os
provedores de segurança apropriados estão instalados, como o JSSE para JRE 1.5.
Etapas para verificar as configurações
1. No computador com Content Manager, inicie o IBM® Cognos® Configuration.
2. Na janela Explorer, clique em Ambiente.
3. No janela Propriedades, verifique as seguintes propriedades:
● Em Configurações de gateway > URI do gateway
● Em Configurações de distribuidor > URI do distribuidor externo e URI do distribuidor
interno
● Em Outras configurações URI > URI do distribuidor para aplicativos externos e URIs do
Content Manager.
4. Na janela Explorer, clique em Segurança > Criptografia > Cognos.
Guia de instalação e configuração 401
Apêndice B: Solução de problemas
5. Na janela Propriedades, sob Configurações da autoridade de certificação, clique no valor de
Senha.
Certifique-se de que a mesma senha seja utilizada em todos os computadores com Content
Manager.
6. Salve as configurações e reinicie o IBM Cognos BI.
Problemas ao gerar as chaves de criptografia no IBM Cognos ConfigurationAo desinstalar o IBM® Cognos® BI, algumas pastas temporárias são deixadas para trás. Reinstalar
o produto no mesmo local, sem remover primeiro as pastas temporárias, pode causar problemas
ao tentar gerar as chaves de criptografia no IBM Cognos Configuration.
Para resolver esse problema, desinstale o IBM Cognos BI, remova a pasta c10_location/temp/cam
e instale novamente o IBM Cognos BI.
CAM-CRP-1315 Erro ao salvar as configuraçõesA seguinte mensagem de erro pode ser exibida ao salvar as configurações:
CAM-CRP-1315 A configuração atual aponta para umDomínio Confiável diferente do configurado
originalmente.
Este erro ocorre ao realizar uma alteração no domínio confiável do ambiente. O domínio confiável
é gerenciado pela autoridade de certificado associada ao armazenamento de conteúdo. Este erro
pode ocorrer se o armazenamento de conteúdo usado originalmente foi removido ou se as
configurações foram alteradas ao usar o Content Manager associado com um armazenamento de
conteúdo diferente após salvar as configurações originais.
Para solucionar o problema, altere suas configurações para usar o armazenamento de conteúdo
original ou gere novamente as chaves de criptografia.
Etapas para gerar novamente as chaves de criptografia
1. No computador do Content Manager, faça backup das chaves de criptografia existentes salvando
os seguintes diretórios em um local alternativo seguro:
● local_c10/configuration/csk
● local_c10/configuration/encryptkeypair
● local_c10/configuration/signkeypair
2. Exclua os diretórios csk, encryptkeypair e signkeypair.
3. No IBM® Cognos® Configuration, salve a configuração e reinicie os serviços.
4. Repita as etapas 1 a 3 em todos os computadores que tenham os componentes do IBM Cognos
BI instalados.
402 IBM Cognos Business Intelligence PowerPlay
Apêndice B: Solução de problemas
CAM-CRP-0221 Erro ao fazer login no portalAo instalar o IBM® Cognos® BI no sistema operacional Microsoft® Windows® (com um sistema de
32 bits ou de 64 bits) e configurar o IBM HTTP Server como gateway, as tentativas de fazer login
no portal do IBM Cognos BI resultarão numa mensagem de erro que contém o seguinte:
CAM-CRP-0221 Não foi possível carregar o provedor 'CAM_Crypto_TOpenSSL.dll' especificado
no arquivo de configuração.
Este erro ocorre quando versões incompatíveis de bibliotecas OpenSSL são carregadas. Para resolver
o problema, carregue as bibliotecas OpenSSL fornecidas com o IBM Cognos BI.
Etapas
1. No computador gateway, vá para o diretório IBM_HTTP_location\conf e abra httpd.conf em
um editor de texto.
2. Adicione as seguintes linhas ao arquivo:
LoadFile "c10_location/cgi-bin/ssleay32.dll"
LoadFile "c10_location/cgi-bin/libeay32.dll"
em que c10_location é o caminho para o diretório de instalação do IBM Cognos BI.
Alteração manual do nome do diretório de instalação afeta as instalação emexecução no servidor de aplicativos
Você instalou o IBM® Cognos®BI usando o assistente de instalação e depois renomeou o diretório
de instalação ou copiou manualmente o conteúdo para outro diretório. Ao tentar executar o IBM
Cognos BI em um servidor de aplicativos, um dos seguintes problemas pode ocorrer:
● O IBM Cognos BI não inicia.
● Os diretórios de log estão vazios.
● Os logs contêm um erro de vínculo ou um erro de link incorreto.
Ao alterar manualmente o diretório de instalação, as informações no diretório raiz do IBM Cognos
BI se tornam inválidas. Para solucionar o problema, é necessário atualizar o diretório raiz do IBM
Cognos BI antes de criar o arquivo de aplicativo do IBM Cognos BI para implantar no servidor de
aplicativos ou reinstalar o IBM Cognos BI no local original. Se reinstalar o IBM Cognos BI, siga as
etapas para atualização.
Etapas
1. No diretório de instalação novo ou renomeado, abra c10_location/webapps/p2pd/WEB-INF/
classes/cogroot.link em um editor de texto.
2. Substitua o caminho pelo novo local do diretório de instalação e salve o arquivo.
3. Para criar um arquivo de aplicativo a ser implantado no servidor de aplicativos, no IBM Cognos
Configuration, a partir do menu Ações, selecione Criar arquivos de aplicativo.
4. Se a criação e implantação do arquivo de aplicativo no servidor de aplicativos for feita antes
de atualizar o arquivo cogroot.link, desfaça a implantação.
Guia de instalação e configuração 403
Apêndice B: Solução de problemas
5. Implante o novo arquivo de aplicativo no servidor de aplicativos.
Para obter mais informações sobre a configuração do IBM Cognos BI em outro servidor de
aplicativos, consulte o Guia de instalação e configuração.
A configuração dos dados está bloqueada por outra instância do IBM CognosConfiguration
É possível que apareça uma mensagem de erro informando que os dados das configurações estão
bloqueados por outra instância do IBM® Cognos® Configuration.
Ao iniciar, o IBM Cognos Configuration verifica se o arquivo cogstartup.lock existe no diretório
c10_location/configuration. O arquivo pode existir se uma instância anterior não foi corretamente
finalizada ou se outra instância do IBM Cognos Configuration estiver em execução.
Se outra instância do IBM Cognos Configuration estiver em execução, feche aquela instância. Caso
contrário, qualquer alteração feita nas configurações locais podem resultar em erros.
Se nenhuma outra instância do IBM Cognos Configuration estiver em execução, exclua o arquivo
cogstartup.lock do diretório c10_location/configuration.
Se o serviço do IBM Cognos for interrompido, clique em Iniciar.
Não foi possível sair de uma seqüência Tab usando a navegação apenas por tecladono IBM Cognos Configuration
Se estiver utilizando a navegação por meio da tecla Tab no IBM® Cognos® Configuration, é possível
que ocorram problemas ao sair de uma seqüência tab. Por exemplo, na janela Propriedade, é possível
pressionar a tecla Tab para mover entre as propriedades.
Entretanto, como o IBM Cognos Configuration é um aplicativo JavaTM, quando quiser fechar a
janela Propriedades, será necessário pressionar Ctrl+Tab.
Não é possível salvar suas configuraçõesPode não ser possível salvar as configurações porque um recurso está faltando. Por exemplo, foi
excluído um recurso como o namespace do Cognos, um provedor de criptografia ou o
armazenamento de conteúdo. É possível substituir o tipo de banco de dados padrão pelo
armazenamento de conteúdo com Oracle, DB2® ou Sybase. Não é possível substituir o namespace
Cognos. É possível recriá-lo, mas depois é necessário recriar os grupos e funções do Cognos.
Para obter mais informações sobre a criação de grupos e funções no IBM® Cognos® Connection,
consulte o Guia de administração e segurança.
Etapas para recriar o namespace Cognos
1. Inicie o IBM Cognos Configuration.
2. Na janela Explorer, em Segurança, clique com o botão direito do mouse em Autenticação e
clique em Novo recurso > Namespace.
3. Na caixa Nome, digite um nome para o recurso.
404 IBM Cognos Business Intelligence PowerPlay
Apêndice B: Solução de problemas
4. Na caixa Tipo, clique em Cognos e depois em OK.
O namespace Cognos é exibido na janela do Explorer.
5. No menu Arquivo, clique em Salvar.
Erro de Java ao iniciar o IBM Cognos ConfigurationAo iniciar o IBM® Cognos® Configuration, pode ser exibida uma mensagem de erro que o JavaTM
Runtime Environment (JRE) mudou e que as informações de criptografia atuais não são mais
compatíveis com o novo JRE. Pode, então, ser solicitado que você gere novamente as informações
de criptografia para o novo JRE ou saia e alterne para o JRE anterior.
Este erro pode ocorrer por um dos seguintes motivos:
● Os dados da configuração foram criptografados utilizando um JRE diferente daquele que os
componentes do IBM Cognos BI estão utilizando no momento.
● As informações de criptografia podem estar corrompidas.
Se clicar em Gerar Novamente na caixa de diálogo de erro, o serviço do IBM Cognos será
interrompido e as informações de criptografia serão geradas novamente.
Se clicar em Sair na caixa de diálogo do erro, é necessário definir a variável de ambiente
JAVA_HOME para direcionar ao JRE usado para salvar as configurações.
No sistema operacional Microsoft®Windows®, se quiser que os componentes do IBM Cognos BI
usem o JRE instalado por padrão, remova a definição JAVA_HOME ou defina JAVA_HOME para
local_c10/bin/jre.
Observação: Se deseja alterar de um JRE para outro, consulte o tópico sobre mudança de versão
de JVM que os componentes do IBM Cognos BI utilizam. Para obter mais informações, consulte o
Guia de instalação e configuração.
Erro de criptografia ao iniciar o IBM Cognos ConfigurationAo iniciar o IBM® Cognos® Configuration, a seguinte mensagem de erro pode ser exibida:
As informações criptográficas podem estar danificadas ou o arquivo cogstartup.xml é inválido.
Talvez você precise corrigir esse arquivo ou removê-lo do disco.. Para obter mais informações,
consulte o Guia de instalação e configuração.
Este erro ocorre quando os componentes do IBM Cognos BI detectam um erro no arquivo
cogstartup.xml. Isto pode ocorrer quando o arquivo cogstartup.xml é editado manualmente e ocorre
um erro no texto alterado.
Para solucionar o problema, substitua o arquivo cogstartup.xml por uma cópia do local de backup.
As configurações atuais não foram aplicadas no computadorValores padrão das propriedades foram alterados ou foram adicionados recursos à instalação no
IBM® Cognos® Configuration. Após salvar as configurações atuais, é possível que você não veja as
alterações ou não seja possível usar os recursos no ambiente em tempo de execução.
Guia de instalação e configuração 405
Apêndice B: Solução de problemas
Para aplicar as novas configurações ao computador, reinicie o serviço do IBM Cognos.
Etapas para reiniciar o serviço do IBM Cognos
1. Inicie o IBM Cognos Configuration.
2. No menu Ações, clique no comando apropriado.
● Se o serviço do IBM Cognos estiver em execução, clique em Reiniciar.
Esta ação inicia todos os serviços instalados que não estiverem em execução e reinicia os
serviços em execução. Se quiser reiniciar um determinado serviço, selecione o nó de serviço
na janela do Explorer e, em seguida, clique em Reiniciar no menu Ações.
● Se o serviço do IBM Cognos for interrompido, clique em Iniciar.
Esta ação inicia todos os serviços instalados que não estiverem em execução. Caso deseje
iniciar determinado serviço, selecione o nó do serviço na janela do Explorer e clique em
Iniciar no menu Ações.
CM-CFG-029 Erro ao tentar salvar uma configuração que especifica umarmazenamento de conteúdo do Microsoft SQL Serve
No IBM® Cognos® Configuration, ocorreu uma tentativa de salvar uma configuração e a seguinte
mensagem de erro aparece no arquivo cogserver.log:
CM-CFG-5003 O Content Manager não pode determinar se o armazenamento de conteúdo foi
inicializado.
A permissão EXECUTAR foi negada no objeto "sp_tables", banco de dados "master", proprietário
"dbo'.
Isso indica que você não possui as permissões apropriadas para inicializar um armazenamento de
conteúdo ou criar uma tabela no banco de dados.
A solução é certificar-se de que o usuário do armazenamento de conteúdo possui permissões para
usar o procedimento sp_tables armazenado no banco de dados mestre.
Erro de DB2 não encontrado no Linux para Sistema ZO IBM® Cognos® BI foi instalado e depois de executar o script C8DB2.sh, um erro afirmando que
o DB2® não pode ser encontrado é exibido ou escrito nos arquivos de log:
É possível resolver esse problema utilizando as seguintes etapas:
1. Crie um perfil que utilize o sqllib/db2profile do diretório inicial do usuário para o usuário
inserido ao executar o script.
Um exemplo do que o .profile conteria é similar a:
if [ -f /home/db2user/sqllib/db2profile ]; then
./home/db2user/sqllib/db2profile
fi
2. Execute o script C8DB2.sh novamente.
406 IBM Cognos Business Intelligence PowerPlay
Apêndice B: Solução de problemas
DPR-ERR-2079 Quando o Content Manager está configurado para FailoverVários computadores foram configurados para ficar em espera, a fim de garantir failover para o
Content Manager. No entanto, a seguinte mensagem de erro é exibida ao usuário:
DPR-ERR-2079 Rejeição de segurança do firewall. Sua solicitação foi rejeitada pelo firewall de
segurança
Esta mensagem de erro pode ocorrer se os computadores em espera não forem configurados como
hosts válidos para o IBM® Cognos® Application Firewall.
Para solucionar esse problema, inicie, em cada computador distribuído, o IBM Cognos Configuration
e digite os nomes de todos os computadores que estão sendo configurados para failover.
Etapas
1. No painel do Explorer, clique em Segurança > IBM Cognos Application Firewall.
2. No painel à direita, clique na coluna Valor próximo a Domínios ou hosts válidos.
3. Clique no botão de edição.
4. Digite os nomes de todos os computadores que estiverem sendo configurados para failover.
5. Salve e inicie a configuração.
Falha ao importar um grande armazenamento de conteúdo no Solaris usando JRE1.5
Caso exporte armazenamentos de conteúdo superiores a 2 GB no ato da exportação e depois tente
importá-los para o Solaris usando o JRE 1.5, haverá falha na importação, com a mensagem de erro
"CM-SYS-5001 Ocorreu um erro interno no Content Manager".
Isto se deve a um bug no JRE 1.5 do Solaris. Use então o JRE 1.4.2.
Importar uma implantação muito grande no Windows faz a máquina virtual Javaparar
O JavaTM Virtual Machine do sistema operacional Microsoft® Windows® poderá falhar nas seguintes
circunstâncias.
1. A configuração de memória máxima de Java é Medium (1152 MB) ou maior.
2. Foi importado um arquivo muito grande de uma versão anterior do IBM Cognos BI.
3. O arquivo contém modelos grandes que requerem atualização.
Para solucionar este problema, defina a configuração de memória máxima de Java para Small (768
MB).
As credenciais para o Active Directory são solicitadas ao usuárioO mecanismo de signon único não funciona quando o IBM® Cognos® BI está configurado da seguinte
maneira:
Guia de instalação e configuração 407
Apêndice B: Solução de problemas
● O Microsoft® Internet Explorer está em execução em um computador com sistema operacional
Microsoft® Windows® NT®.
● O namespace de autenticação está configurado com o provedor do Active Directory.
● O Microsoft Internet Explorer em execução no Windows 2000 ou no Windows 2003 Server
está configurado para Autenticação integrada do Windows.
Como resultado, as credenciais para o Active Directory são solicitadas aos usuários.
Este problema ocorre porque o provedor do Active Directory do IBM Cognos BI usa um protocolo
ADSI e delegação Kerberos para realizar a autenticação em um ambiente de signon único. Quando
o Microsoft Internet Explorer está em execução no Windows NT, ele não pode autenticar o servidor
IIS usando a delegação Kerberos.
Quando seu sistema estiver configurado para a Autenticação integrada do Windows, para que o
signon único funcione como IIS, é necessário:
● Configurar o IBM Cognos BI para comunicar-se com o servidor do Activer Directory usando
o provedor LDAP.
● Configurar a propriedade de mapeamento de identidade externa para ler a variável de ambiente
REMOTE_USER.
A fonte não foi encontrada no UNIX ao iniciar o IBM Cognos ConfigurationAo iniciar o IBM® Cognos® Configuration, a seguinte mensagem de erro pode ser exibida:
A fonte especificada em font.properties não foi encontrada...
Esse é um problema comum no UNIX®. Significa que o JavaTM Virtual Machine (JVM) está tentando
usar uma ou mais fontes que não estão instaladas no computador. No entanto, o JVM deveria usar
o padrão do sistema e o IBM Cognos Configuration deveria iniciar e executar normalmente.
Para evitar tais erros, adicione as fontes faltantes no Java Runtime Environment editando os arquivos
font.properties. Vários arquivos font.properties, que contêm informações de ambiente de fontes
padrão, estão instalados Java Software Development Kit. É possível encontrar esses arquivos no
diretório local_JRE/lib.
Para obter mais informações, consulte a documentação do Java.
Não é possível detectar o ESSBASEPATHNas plataformas Windows® e UNIX®, o software Oracle Essbase utiliza a variável de ambiente
ESSBASEPATH para localizar o software cliente Essbase 11. O Oracle Hyperion Enterprise
Performance Management (EPM) System Installer cria o ESSBASEPATH como uma variável de
ambiente de usuário.
Se o serviço do IBM Cognos estiver configurado para executar ou fazer logon como conta de sistema,
adicione o ESSBASEPATH manualmente como uma variável de ambiente de sistema, caso não
exista uma. Quando o IBM Cognos não consegue localizar a variável de ambiente ESSBASEPATH,
aparece o seguinte erro:
408 IBM Cognos Business Intelligence PowerPlay
Apêndice B: Solução de problemas
DB2-ERR-0044 Não é possível detectar a variável de ambiente Essbase "ESSBASEPATH". Verifique
se o cliente Essbase está instalado.
Para solucionar esse problema, escolha uma das soluções a seguir e depois reinicie o serviço do IBM
Cognos:
● Clique duas vezes no serviço do IBM Cognos, em seguida clique na guia Logon e especifique
a conta de usuário que possui acesso ao ESSBASEPATH.
● Adicione o EESBASEPATH como uma variável de ambiente de sistema.
Observe que, caso esteja fazendo a atualização do Essbase 9 para o Essbase 11, será necessário
instalar o cliente adequado e editar o arquivo qfs_config.xml para alterar o nome da biblioteca.
Etapas
1. No diretório local_c10/configuration, abra o arquivo qfs_config.xml.
2. Encontre a linha de código <provider name="DB2OlapODP" libraryName="essodp93"
connectionCode="DO"/> e altere o nome da biblioteca de essodp93 para essodp111.
3. Salve as alterações.
Falhas na consulta ao usar o servidor Oracle EssbaseAo executar uma consulta para recuperar os metadados ou dados do servidor Oracle Essbase,
recebe-se uma mensagem similar às seguintes:
● O gateway do IBM Cognos não pode se conectar ao servidor IBM Cognos BI. O servidor pode
estar indisponível, ou o gateway pode não estar configurado corretamente.
● DB2-ERR-0005 Ocorreu um erro desconhecido durante o login. Código do erro do banco de
dados: 1,042,006.
● XQE-DS-0006 Não foi possível fazer logon na fonte de dados.
Esses erros IBM® Cognos® podem ser resultado da falta de soquetes ou portas disponíveis no
Windows®. A falta de portas suficientes pode causar falha na recuperação de dados do Essbase
devido a erros de comunicação de rede.
Para resolver o problema, aumente o número do soquetes ou portas do Windows disponíveis para
usar o programa adicionando duas entradas no Editor de registro Microsoft® Registry Editor.
Importante: O uso do Editor de registro Microsoft é por conta própria. O uso incorreto pode causar
problemas que exigem a reinstalação do sistema operacional. A Microsoft não pode garantir que
os problemas gerados pelo mau uso do Editor de registro poderão ser resolvidos.
Etapas
1. No menu Iniciar do Windows, execute o aplicativo regedit.
2. No diretório HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip\
Parameters, crie um novo valor DWORD nomeado MaxUserPort.
3. Defina as propriedades de MaxUserPort para usar um valor de 65534 e uma base de Decimal.
Guia de instalação e configuração 409
Apêndice B: Solução de problemas
O intervalo do valor é de 30.000 a 65.534.
4. No mesmo diretório, adicione outro valor DWORD nomeado TcpTimedWaitDelay.
5. Defina as propriedades de TcpTimedWaitDelay para usar um valor de 50 e uma base de
Decimal.
O intervalo do valor é de 30 a 300 segundos, com valor padrão de 240 segundos (4 minutos).
6. Após fechar o aplicativo regedit, reinicie o servidor Microsoft CRM ou reinicie o computador.
Para obter mais informações, visite o site technet2.microsoft.com e pesquise os termos MaxUserPort
e TcpTimedWaitDelay.
Os membros do grupo estão ausentes no namespace do Active DirectorySe um namespace do Active Directory estiver configurado para utilizar a mesma floresta e um
usuário estiver autenticado usando uma credencial, o membro do grupo ficará faltando.
A identidade do processo do IBM® Cognos® BI, ao executar uma conta de sistema local ou um
usuário de domínio, deve ter um desses privilégios:
● representar um cliente após a autenticação
● atuar como parte do sistema operacional
Se o privilégio estiver ausente, não existe membro de grupo para o usuário autenticado.
Para solucionar esse problema, realize as etapas a seguir.
Etapas
1. A partir do menu Iniciar, clique em Configurações, Painel de Controle.
2. Clique em Ferramentas administrativas e, então, clique duas vezes em Diretiva de segurança
local.
3. Na árvore do console, clique em Configurações de segurança, Diretivas locais.
4. Clique em Atribuições de direitos de usuário.
5. Adicione a identidade do processo ao IBM Cognos BI segundo uma das diretivas a seguir:
● Representar um cliente após a autenticação.
O padrão é Administradores, Serviço.
Para obter mais informações, consulte o artigo da biblioteca fe1fb475-4bc8-484b-9828-
a096262b54ca1033.mspx no site da Microsoft®.
● Agir como parte do sistema operacional.
O padrão é Sistema local.
Para obter mais informações, consulte o artigo da biblioteca ec4fd2bf-8f91-4122-8968-
2213f96a95dc1033.mspx no site da Microsoft.
Os dois privilégios fornecem à conta a capacidade de atuar como outro usuário.
410 IBM Cognos Business Intelligence PowerPlay
Apêndice B: Solução de problemas
O privilégio Impersonate a client after authentication é parecido com o Agir como parte do
sistema operacional, exceto pelo fato de que só permitirá que um processo represente após a
autenticação, enquanto o privilégio Agir como parte do sistema operacional permite que o
processo represente antes da autenticação.
Para obter mais informações, consulte o artigo da biblioteca tkerbdel.mspx no site da Microsoft.
Erros exibidos ao implantar no servidor de aplicativos Oracle 10GO IBM® Cognos® BI está sendo implantado a um servidor de aplicativos Oracle 10G e as seguintes
mensagens de erro são exibidas:
CMM-APP-3254 Falha na inicialização do armazenamento de métricas. DIS-ERR-3115 Falha ao
executar tarefa.
MDS-RUN-3213 Não é possível localizar o utilitário de carregamento emmassa de banco de dados.Instale a ferramenta de banco de dados apropriada para esta plataforma ('bcp' para SQL Server,
'sqlldr' para Oracle)
Isto ocorre porque os utilitários de carregamento em massa (SQL Loader no Oracle) não estão
inclusos no arquivo de implantação criado pelo IBM Cognos Configuration.
Para resolver este erro, é necessário usar o software cliente Oracle no computador em que instalou
o servidor de aplicativos Oracle 10G para instalar os componentes que estão faltando. Certifique-
se de instalar o SQL Loader.
Erro de limite de tempo CGI enquanto conectado aos componentes do IBMCognosBI por meio de um navegador web
Ao desempenhar operações por meio do navegador web, recebe-se a seguinte mensagem de erro:
Limite de tempo CGI, o processo será excluído do servidor.
O erro ocorre quando o Microsoft® Internet Information Services (IIS) é utilizado como servidor
da web e o gateway está configurado para utilizar o CGI. O IIS possui um tempo limite padrão
para aplicativos CGI.
Para solucionar esse problema, pode-se configurar o gateway para utilizar ISAPI. O IIS não tem
um tempo limite padrão para aplicativos ISAPI. Ou, se desejar manter a utilização do gateway CGI,
pode-se aumentar o tempo limite de CGI no IIS.
Etapas para alterar o gateway para ISAPI
1. No computador com gateway, inicie o IBM® Cognos® Configuration.
2. Em Ambiente, para a propriedade URI do gateway, altere a parte cognos.cgi do URI para
cognosisapi.dll
3. No navegador web, especifique o URI do ISAPI:
Guia de instalação e configuração 411
Apêndice B: Solução de problemas
http://nome_computador/ibmcognos/isapi
Etapas para aumentar o limite de tempo de CGI
1. Nas ferramentas administrativas do sistema operacional Microsoft® Windows®, abra o Internet
Information Services.
2. No nó do computador local, clique com o botão direito em Websites e selecione Propriedades.
3. Na guia Home Directory, clique em Configuração.
4. Na guia Opções de processo, aumente o tempo limite do script CGI.
Falha ao carregar a classe de servlet no WeblogicPode haver problemas ao configurar uma instalação de servidor distribuído e utilizar o WebLogic
como o servidor de aplicativos para o IBM® Cognos® BI.
Ao implantar p2pd.war no computador com componentes da camada de aplicativos, você pode
receber exceções de servlet e o distribuidor não iniciará. O arquivo cogserver.log também não será
criado.
As seguintes mensagem de erro são exibidas no console do servidor do 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 para servletcfgss não pôde ser carregado pois a classe
solicitada não foi encontrada no classpath /host2/bea812/user_projects/domains/c10/applications/
p2pd/WEB-INF/classes. java.lang.ClassNotFoundException:
com.cognos.pogo.isolation.ServletWrapper.>
<Jul 9, 2004 3:47:37 PMEDT> <Error> <HTTP> <BEA-101216> <Servlet: "cfgss" falha ao realizar
preload na inicialização do aplicativo web: "p2pd".
javax.servlet.ServletException: [HTTP:101249][ServletContext(id=19023494,name=p2pd,context-
path=/p2pd)]: Servlet class com.cognos.pogo.isolation.ServletWrapperfor o cfgss do servlet não
pôde ser carregado pois a classe solicitada não foi encontrada no classpath /host2/bea812/user_
projects/domains/c10/applications/p2pd/WEB-INF/classes.java.lang.ClassNotFoundException:
com.cognos.pogo.isolation.ServletWrapper. at
weblogic.servlet.internal.ServletStubImpl.prepareServlet (ServletStubImpl.java:799)
at weblogic.servlet.internal.WebAppServletContext.preload Servlet
(WebAppServletContext.java:3252)
Para evitar este problema, não implante o aplicativo p2pd a partir do diretório de aplicativos do
WebLogic. Crie o diretório p2pd em outro local e implante do novo local.
Etapas
1. Abra o IBM Cognos Configuration e configure o computador com componentes de camada
de aplicativos.
2. Reinicie o computador do Content Manager.
412 IBM Cognos Business Intelligence PowerPlay
Apêndice B: Solução de problemas
3. Crie um diretório p2pd em um local acessível pelo servidor WebLogic, mas não no diretório
de aplicativos do WebLogic.
Por exemplo, crie um diretório chamado p2pd no seguinte local:
WebLogic_location/user_projects/domain_name
4. Crie o arquivo p2pd.war.
5. No diretório p2pd, extraia o arquivo p2pd.war para a instalação do WebLogic usando o
seguinte comando:
%JAVA_HOME%/bin/jar xvfm "c10_location/p2pd.war" .
6. Inicie o WebLogic.
7. No console do servidor WebLogic, implante o aplicativo p2pd.
Os ícones da área de trabalho ou a janela do IBM Cognos Configuration trememno Windows
Ao executar o IBM® Cognos® Configuration no sistema operacional Microsoft®Windows®, poderá
notar que os ícones da área de trabalho ou a janela do IBM Cognos Configuration tremem.
Para solucionar este problema, inicie o IBM Cognos Configuration usando a opção de linha de
comando -noddraw.
A migração não funcionaDepois de instalar e configurar o IBM® Cognos® PowerPlay®, não é possível encontrar o Assistente
de migração ou a migração é executada e nada acontece.
Para resolver o problema, faça o seguinte:
● Os componentes do PowerPlay Server e PowerPlay Administration são instalados no servidor
do IBM Cognos PowerPlay .
● Se instalar o IBM Cognos PowerPlay com o IBM Cognos Business Intelligence, instale o
componente Content Manager do IBM Cognos PowerPlay no mesmo computador que o
componente Content Manager do IBM Cognos BI.
● No computador em que o Content Manager está instalado, no IBM Cognos Configuration, em
Ambiente, Serviço IBMCognos BI, verifique se a propriedade Serviço de migração ativado está
definida como Verdadeiro.
● Os componentes de migração do IBM Cognos Series 7 estão instalados no computador com o
IBM Cognos Series 7 PowerPlay Server .
● O serviço de migração do IBM Cognos Series 7 é iniciado no computador do IBM Cognos
Series 7 PowerPlay Server .
● Os usuários não conseguem executar uma tarefa de migração. Para obter mais informações,
consulte o Guia de migração e administração do IBM Cognos PowerPlay..
Guia de instalação e configuração 413
Apêndice B: Solução de problemas
Além disso, verifique se os usuários que executarão tarefas de migração têm as permissões
adequadas para criar uma tarefa de migração. No IBM Cognos Administration,
● Clique em Configuração, Administração de conteúdo.
● Clique no botão Definir propriedades - Administração .
● Clique na guia Permissões.
● certifique-se de que os usuários que executarem tarefas de migração tenham permissões
para Ler, Gravar, Executar e Desviar.
414 IBM Cognos Business Intelligence PowerPlay
Apêndice B: Solução de problemas
Apêndice C: Atalhos de teclado do assistente deinstalação
Atalhos de teclado, ou teclas de atalho, oferecem um método mais fácil, e normalmente mais rápido,
de navegar e utilizar software.
O assistente de instalação usa as teclas de navegação padrão do sistema operacional Microsoft®
Windows® em conjunto com as teclas específicas do aplicativo.
Observação: Os atalhos de teclado a seguir são baseados nos teclados padrão dos EUA.
A tabela a seguir lista os atalhos de teclado que podem ser usados para executar algumas das
principais tarefas no assistente de instalação no sistema operacional Windows.
PressioneAções
TabMover para o próximo campo em uma página
Shift+TabMover para o campo anterior em uma página
Alt+F4Encerrar o assistente de instalação
Alt+NMover para a próxima etapa de configuração
Alt+BRetornar para a etapa de configuração anterior
Seta para baixoMover para a próxima seleção em uma lista
Seta para cimaMover para a seleção anterior em uma lista
A tabela a seguir lista os atalhos de teclado que podem ser usados para executar algumas das
principais tarefas no assistente de instalação no sistema operacional UNIX® ou Linux®
PressioneAções
TabMover para o próximo campo em uma página
Shift+TabMover para o campo anterior em uma página
Alt+F4Encerrar o assistente de instalação
Seta para baixoMover para a próxima seleção em uma lista
Seta para cimaMover para a seleção anterior em uma lista
Licensed Materials – Property of IBM415© Copyright IBM Corp. 2005, 2010.
A tabela a seguir lista os atalhos de teclado que podem ser usados para executar algumas das
principais tarefas na página do contrato de licença do assistente de instalação.
PressioneAções
Alt+AAceitar o contrato de licença
Alt+DRecusar o acordo de licença
Alt+xEncerrar o assistente de instalação
416 IBM Cognos Business Intelligence PowerPlay
Apêndice C: Atalhos de teclado do assistente de instalação
Glossário
acesso anônimo
Tipo de acesso que permite aos usuários e servidores acessarem um servidor sem efetuar a
autenticação primeiro.
alias
Um nome alternativo utilizado em vez do nome primário.
armazenamento de conteúdo
Banco de dados que contém os dados necessários para operar, como especificações de relatórios,
modelos publicados e direitos de segurança.
armazenamento de métrica
Banco de dados que contém conteúdo para pacotes de métrica. O armazenamento de métrica
também contém as configurações do Metric Studio, tais como preferências do usuário.
arquivo de resposta
Arquivo ASCII que pode ser personalizado com os dados de definição e configuração que
automatizam uma instalação. Os dados de definição e configuração teriam de ser inseridos durante
uma instalação interativa, mas com um arquivo de resposta, a instalação pode ser realizada sem
nenhuma intervenção.
arquivos de implantação
Arquivo usado para implantação. O arquivo de implantação contém os dados do armazanamento
de conteúdo que estão sendo movidos.
autenticação
Processo de validação da identidade de um usuário ou servidor.
autoridade de certificação
Em BI, um componente que emite certificados para cada computador em que os componentes estão
instalados.
certificado
Em segurança da computação, o documento digital que vincula uma chave pública à identidade do
proprietário do certificado, permitindo que o proprietário certificado seja autenticado. Os certificados
são emitidos por uma autoridade certificada, que os assinam digitalmente.
componente de camadas de aplicativos
Para a instalação, é o conjunto de processadores que acessam os bancos de dados de consultas para
reunir informações e transformar os resultados em relatórios e métricas PDF e HTML. Os
Licensed Materials – Property of IBM417© Copyright IBM Corp. 2005, 2010.
componentes de camadas de aplicativos também passam as solicitações ao Content Manager e
devolvem os resultados que o este recupera do armazenamento de conteúdo.
conjunto de codificação
A combinação de autenticação, algoritmo de troca de chave e a especificação da cifra Secure Sockets
Layer (SSL) usada para a troca segura de dados.
Content Manager
Serviço que recebe informações do armazenamento de conteúdo e salva informações no mesmo.
conteúdo local
Código usado para configurar o idioma ou dialeto utilizado nos navegadores e texto de relatório,
além das preferências regionais, como formatos de hora, data, dinheiro, expressões monetárias e
período do dia.
credencial
Informação adquirida durante a autenticação que descreve o usuário, associações de grupo ou
outros atributos de identidade relacionados a segurança, e que é usada para realizar serviços como
autorização, auditoria ou delegação. Por exemplo, a ID e senha de um usuário são credenciais que
permitem o acesso à rede e aos recursos do sistema.
especificação do relatório
Definição executável de um relatório, incluindo regras de consulta e de layout, que podem ser
combinadas com dados para gerar uma saída de relatório.
etapa de trabalho
A menor parte de um trabalho que pode ser executada separadamente. Etapa do trabalho que pode
ser um relatório ou outro trabalho.
fonte de dados
A própria origem de dados, como um banco de dados ou arquivo XML, e as informações de conexão
necessárias para acessar os dados.
No TM1®, o arquivo ou os dados usados como origem para o processo de importação do
TurboIntegrator.
gateway
Extensão de um programa de servidor web que transforma informações deste para outro. As
gateways em geral são programas CGI, mas podem seguir outros padrões, como ISAPI e Apache
Modules.
glifo
O formato real (padrão de bits, esboço) da imagem de um caractere. Por exemplo, o A itálico e o
A romano são dois glifos diferentes que representam o mesmo caractere subjacente. De forma mais
418 IBM Cognos Business Intelligence PowerPlay
Glossário
restrita, duas imagens que diferem no formato constituem glifos diferentes. Nesta utilização, glifo
é sinônimo de imagem do caractere ou simplesmente imagem (The Unicode Standard - Versão 1.0).
grupo
Grupo de usuários que pode compartilhar autoridades de acesso quanto aos recursos protegidos.
interface de gateway comum
Padrão da internet para definir scripts que passam informações de um servidor da web para um
programa de aplicativo através de uma solicitação HTTP e vice versa.
localidade
Configuração que identifica o idioma ou a região, e determina convenções de formatação, como
intercalação, conversão de letras maiúsculas e minúsculas, classificação de caracteres, idioma das
mensagens, representação de data e hora, e representação numérica.
localidade do produto
O código ou a configuração que especifica qual idioma, configurações regionais ou ambos devem
ser usados para partes da interface do produto, como comandos do menu.
namespace
Para controle de acesso e de autenticação, uma instância configurada de um fornecedor de
autenticação que permite acesso às informações do usuário e do grupo. No Framework Manager,
os namespace identificam exclusivamente os itens de consulta, os assuntos de consulta e assim por
diante. Importa-se diferentes bancos de dados em namespaces separados para evitar nomes
duplicados.
Em XML e XQuery, um identificador uniforme de recursos (URI) que fornece um nome exclusivo
para ser associado ao elemento, atributo e definições de tipo em um esquema XML ou aos nomes
dos elementos, atributos, tipos, funções e erros em expressões XQuery.
pacote de métrica
No Cognos Connection, uma representação de um aplicativo do Metric Studio. O pacote de métrica
contém informações de conexão, relatórios e tarefas de gerenciamento de métrica para esse aplicativo.
passaporte
Informações baseadas em sessão, armazenadas e criptografadas na memória do Content Manager,
com relação aos usuários autenticados. Na primeira vez que um usuário acessa um produto Cognos,
um passaporte é criado e mantido até o término da sessão, seja quando o usuário efetua logoff ou
após um período especificado de inatividade.
portlet
Componente reutilizável que é parte do aplicativo web que fornece informações ou serviços
específicos a serem apresentados no contexto do portal.
prompt
Elemento do relatório que solicita valores de parâmetro antes de executar o relatório.
Guia de instalação e configuração 419
Glossário
provedor de autenticação
Mecanismo de comunicação a uma fonte de autenticação externa. As funcionalidades, como
autenticação de usuário, filiações de grupos e buscas de namespace, ficam disponíveis por meio de
provedores de autenticação.
trabalho
Grupo de objetos executáveis, como relatórios, agentes e outros trabalhos que o usuário executa e
programa como um lote.
usuário
Qualquer indivíduo, organização, processo, dispositivo, programa, protocolo ou sistema que utiliza
os serviços de um sistema de computação.
420 IBM Cognos Business Intelligence PowerPlay
Glossário
Índice
AAbrir com o Analysis Studio
descrição do componente, 24
Abrir com o Report Studio
descrição do componente, 24
acceptCount
aumento para Apache Tomcat, 360
acesso
configuração de acesso seguro ao portal, 107, 148
acesso anônimo
definição, 417
desabilitação, 107, 148
desativação, 194
acesso em rede
compartilhamento de locais de dados, 299
AIX
erro ao conectar ao banco de dados DB2, 387
suporte para o namespace RACF, 228
ajuste
armazenamento de conteúdo do DB2, 359
configurações do Apache Tomcat, 360
Algoritmo de confidencialidade, 241
aliases
configuração em servidores web, 109, 171, 329
configuração em servidores web Apache, 288
definição, 417
aliases da web
IBM Cognos BI, 109, 171, 329
alteração
codificação de e-mail, 285
definições de configuração padrão, 234
gateway do IBM Cognos BI, 288
modelo de configuração, 359
URIs, 237
versões de Java, 335
ambientes
compatíveis, 40
ambientes compatíveis, 40
amostras, 23
Grandes Aventuras Ltda., 181
instalação, 182
amostras da Companhia das Grandes Aventuras, 23,
181
amostras da Grandes Aventuras Ltda.
instalação, 182
amostras do IBM Cognos BI, 23
Apache Tomcat
ajuste, 360
aparecem barras invertidas ao invés da moeda, 190
aplicativo do painel de controle, 16
Application Tier Components
servidor de log, 265
armazenamento de conteúdo
atualização, 73, 386
backup, 314, 336
configurações inválidas, 381
criação, 44, 85, 258
criação no DB2 com um script, 93, 133
criação no Oracle, 48
descrição do componente, 24
drivers DB2 JDBC, 96
drivers JDBC e DB2, 17
e outros locais para armazenar a saída do
relatório, 253
exclusão de tabelas do banco de dados, 397
gerenciamento de conexão, 102, 140
implantação, 64
importação de dados, 332, 338
novo padrão na versão 8.4, 19
requisitos para alterar o servidor de aplicativos, 314
suporte para DB2 em z/OS para a versão 8.4, 18
versões compatíveis com DB2 e Java, 381
armazenamento de conteúdo DB2
erro ao executar o script C8DB2.sh, 406
Armazenamento de conteúdo do DB2, 359
armazenamento de métricas
falha, 411
melhoria do desempenho, 361
armazenamentos de conteúdo
definição, 417
Licensed Materials – Property of IBM421© Copyright IBM Corp. 2005, 2010.
armazenamentos de métrica
definição, 417
arquivamento
saída do relatório, 254
arquivo .ats
utilização para remover componentes, 350
arquivo cogroot.link, 403
arquivo cogstartup.lock, 376
arquivo cogstartup.xml, 364, 369
alteração manual das propriedades, 366
arquivo inválido, 405
arquivo cogstartup.xml inválido, 405
arquivo de especificação de transferência
utilização para remover componentes, 350
arquivo jar, 97
erro ao iniciar a configuração, 405
arquivo p2pd.war para WebLogic, 395
arquivo response.ats, 345
arquivos
não encontrados, 390
arquivos chase_referral, 199
arquivos de biblioteca
para instalação de 32 bits versus 64 bits, 45
arquivos de configuração
applications.xml para o Portal Services, 301
coglocale.xml, 367
cogstartup.xml, 364
exportação, 348
arquivos de criptografia
arquivo cogstartup.xml inválido, 405
arquivos de especificação de transferência (.ats)
configuração, 345
arquivos de fornecimento de segurança
cópia para o servidor de aplicativos JVM, 337
arquivos de implantação
definição, 417
mover, 67
arquivos de log, 375
configuração da inicialização, 376
configuração de local, 376
desinstalação, 377
erros de gateway, 377
modo silencioso, 377
resumo da transferência, 376
tempo de execução, 376
transferência, 375
arquivos de resposta
definição, 417
arquivos EAR, 369
arquivos Enterprise
implantação do IBM Cognos BI, 369
arquivos Java Archive, 99, 136
arquivos WAR, 369
arquivos web
implantação do IBM Cognos BI, 369
ASCII
requisitos para o diretório de instalação, 389
Assistente de migração
descrição do componente, 23
não funciona, 413
atalhos de teclado, 415
ativação
IBM Cognos Application Firewall, 244
serviços, 247
SSL para servidores de aplicativos, 328
atualização
afeta caracteres chineses, japoneses ou coreanos, 396
ambiente java, 99, 136, 337
armazenamento de conteúdo, 386
criação do ambiente de teste, 63
da Series 7, 57
de outros produtos IBM Cognos para o IBM Cognos
BI, 33
do Metrics Manager, 57
do ReportNet, 57
IBM Cognos BI, 74
IBM Cognos BI em um servidor de aplicativos, 333
outros produtos, 80
planejamento para mover do ambiente de teste para
o de produção, 71
preparação, 58
problemas com chaves de criptografia, 402
processo, 58
recursos, 60
ReportNet, 72
atualização experimental, 62
planejamento para mover do ambiente de
produção, 71
atualizador
instalação, 90, 131, 156, 166
auditoria
logs, 265
422 IBM Cognos Business Intelligence PowerPlay
Índice
autenticação
árvores de domínio para o Servidor do Active
Directory, 199
configuração do namespace do IBM Cognos Series
7, 202
definição, 417
desativação do logon anônimo, 194
eTrust Siteminder, 223, 224, 226
exclusão de namespaces, 231
função SaferAPIGetTrustedSignon, 204
LDAP, 207, 208
LDAP utilizando o IBM Directory Server, 213
LDAP utilizando o Novell Directory Server, 215
LDAP utilizando o Servidor do Active Directory, 210
LDAP utilizando o Sun Java System Directory
Server, 217
NTLM, 227
plug-ins de signon confiável para IBM Cognos Series
7, 203
propriedades personalizadas do usuário para
LDAP, 219
propriedades personalizadas para o Servidor do
Active Directory, 197
provedores de autenticação personalizada, 206
requisitos para signon único com o Microsoft
Analysis Server ou Microsoft SQL Server, 196
Servidor do Active Directory, 195
signon único para NTLM, 228
signon único utilizando eTrust SiteMinder, 226
signon único utilizando LDAP, 222
signon único utilizando namespaces do IBM Cognos
Series 7, 203
signon único utilizando o Servidor do Active
Directory, 200
signon único utilizando RACF, 230
SSL para eTrust Siteminder, 226
SSL utilizando LDAP, 220
uso de namespaces, 193
autenticação integrada do Windows, 200
Autenticação integrada do Windows
problemas, 407
autoridade de certificação
configuração, 339
configuração do serviço, 339
definição, 417
Bbackup
informações do IBM Cognos BI, 314, 336
banco de dados de conteúdo do Cognos
desinstalação, 118, 179
Banco de dados de conteúdo do Cognos
alteração de usuários e senhas, 235
aperfeiçoamento do desempenho, 360
descrição do componente, 22
instalação em um servidor diferente, 130
banco de dados de log
criação usando o banco de dados Informix Dynamic
Server, 50
criação usando o DB2, 45
criação usando o Microsoft SQL Server, 49
criação usando Oracle, 48
criação usando Sybase, 51
exclusão de tabelas, 397
suporte para DB2 em z/OS para a versão 8.4, 18
banco de dados de notificação
configuração, 257
configurações para DB2 em z/OS, 256
criação, 255
espaços de tabela para DB2 em z/OS, 256
exclusão de tabelas, 397
suporte para DB2 em z/OS para a versão 8.4, 18
bancos de dados
armazenamento de conteúdo, 44, 258
ausente utilitário de carregamento em massa, 411
cliente de banco de dados de log, 268
criação de armazenamento de conteúdo no DB2
usando scripts, 93
criação de um armazenamento de conteúdo no DB2
usando scripts, 133
exclusão de tabelas, 397
log, 272
logs, teste, 112
notificação, 147
bancos de dados de consulta, 25
bancos de dados de logs
teste, 112
BEA WebLogic, 311
BI bus
considerações de atualização, 73
Guia de instalação e configuração 423
Índice
CC8DB2.sh script
erro, 406
CA, 339
camada de soquetes de segurança, 259
caminhos
configuração de cookies, 287
caractere de iene, 190
caractere de won, 190
caracteres
codificação não suportada, 381
caracteres acentuados
exibição incorreta, 396
Caracteres coreanos
corrompidos durante a instalação no Linux, 393
exibidos incorretamente após atualização, 396
caracteres de dois bytes
exibição incorreta, 396
caracteres especiais
propriedades do namespace LDAP, 207
caracteres exibidos incorretamente, 396
Caracteres japoneses
corrompidos durante a instalação no Linux, 393
exibidos incorretamente após atualização, 396
caracteres não suportados, 381
caractere Won
requisitos de fonte, 189
caractere Yen
requisitos de fonte, 189
catálogos e relatórios do Impromptu
migração para o IBM Cognos BI, 33
certificados
definição, 417
chaves de criptografia
backup e exclusão, 314, 336
geração para outras autoridades de certificação, 339
gerar novamente, 402
chave simétrica comum, 239
Chinês
caracteres corrompidos durante a instalação no
Linux, 393
chineses
caracteres exibidos incorretamente após
atualização, 396
chinês simplificado
requisitos para o Internet Explorer 6, 251
cliente de banco de dados
configuração para um banco de dados de log, 268
CM-SYS-5001 Ocorreu um erro interno no Content
Manager, 407
codificação de e-mail em tailandês
exigências JRE, 285
códigos de produto
em arquivos de especificação de transferência, 350
cogconfig.sh códigos de devolução
não compatíveis com UNIX, 397
Cognos Viewer
descrição do componente, 22
comando uninst, 350
componente do cliente do PowerPlay, 24
componentes, 21
Abrir com o Analysis Studio, 24
Abrir com o Report Studio, 24
amostras do IBM Cognos BI, 23
armazenamento de conteúdo, 24
Assistente de migração, 23
Banco de dados de conteúdo do Cognos, 22
Cognos Viewer, 22
componentes de camadas de aplicativos, 29, 30
Content Manager, 22, 30, 86
fontes de dados, 25
gateways, 21, 29, 86
IBM Cognos Administration, 22
IBM Cognos Configuration, 21
IBM Cognos Connection, 21
instalação, 86
instalação em um computador, 28
PowerPlay Studio, 22
requisitos de instalação para sistemas de 64 bits, 31
Serviço de migração, 23
terceiros, 21
utilitário de conversão de indicador, 23
componentes de camada de aplicativos
configuração, 151
componentes de camadas de aplicativos
definição, 417
instalação em computadores separados, 29
requisitos de configuração, 30
componentes de migração, 23
componentes de terceiros, 24
componentes do cliente, 24
424 IBM Cognos Business Intelligence PowerPlay
Índice
componentes do servidor, 21
seqüência de instalação, 123
comunicação LDAP segura, 220
conectividade de bancos de dados
armazenamento de conteúdo, 97
conexão ao banco de dados
criação em z/OS, 267
conexões de banco de dados
Informix, 102
conexões de banco de dados, 140
conexões de fonte de dados
definição, 140
confiança compartilhada
configuração entre o IBM Cognos BI e outros
servidores, 262
configuração
adição de recursos, 364
ajustes para o IBM Cognos BI, 234
alteração de definições padrão, 234
alteração do modelo, 359
arquivo de bloqueio, 376
arquivos de especificação de transferência (.ats), 345
automação, 345
autônoma, 345, 348
backup, 314, 336
bancos de dados de notificação, 257
componentes de camada de aplicativos, 151
computadores com o Content Manager, 124
confiança compartilhada com outros servidores, 262
configurações do IBM Cognos BI, 42
configurações do Tomcat, 42
configurações não foram aplicadas, 405
configurações padrão, 234
considerações de atualização, 74
contas do servidor de correio, 106
Content Manager, 30
Content Manager de espera, 145
destino para mensagens de log, 265
erro ao criptografar informações, 401
execução da linha de comando, 369
execução de diversas versões do IBM Cognos BI, 81
fontes, 248
fuso horário padrão, 285
gateways, 170
IBM Cognos BI, 52
instalações distribuídas, 121
local de arquivo temporário, 246
manual, 363
namespace de Active Directory, 196
namespace do eTrust Siteminder, 224
namespace LDAP, 208
namespace LDAP para IBM Directory Server, 213
namespace LDAP para Servidor do Active
Directory, 210
namespace NTLM, 227
namespace RACF, 229
não é possível abrir o IBM Cognos
Configuration, 376
não é possível criptografar as informações de
criptografia, 401
não é possível salvar, 404
navegadores web, 53
opções avançadas, 335
Portal Services, 301
problemas, 397
propriedades do ambiente para componentes de
camada de aplicativos, 159
propriedades do servidor de aplicativos, 322
propriedades em configuração autônoma, 366
protocolo SSL, 259
provedores de autenticação personalizada, 206
requisitos para signon único com o Microsoft
Analysis Server ou Microsoft SQL Server, 196
roteadores, 297
serviço de autoridade de certificação, 339
serviço do IBM Cognos, 359
servidor de correio, 147
servidor web, 109, 171, 329
teste, 112
configuração autônoma
alteração de propriedades, 366
definição, 345
configuração do cliente
bancos de dados DB2, 97, 138
configurações
configurações globais, 279
dados bloqueados, 404
configurações inválidas
armazenamento de conteúdo, 381
IBM Cognos Configuration, 381
conjuntos de codificação
configuração de prioridade para conexões SSL, 263
Guia de instalação e configuração 425
Índice
definição, 418
conta de usuário
requisitos para executar o serviço do IBM
Cognos, 234
requisitos para executar o serviço do IBM Cognos
BI, 139, 158, 169
contas do servidor de correio
configuração, 106
Content Manager
alteração de fusos horários, 285
ativo e em espera, 125
componente, 30
configuração, 30, 124
configuração em vários computadores, 145
considerações de atualização, 73
definição, 418
definição de um armazenamento de conteúdo, 44,
258
descrição do componente, 22
espera, 30
exigências caso esteja usando o IBM Cognos
Transformer com um namespace Series 7, 86
falha ao iniciar, 388
instalação, 86
mensagens de erro, 407
opções de instalação, 30
padrão ativo, 124
proteção contra failover, 30
requisitos no uso do IBM Cognos Transformer com
um namespace Series 7, 201
requisitos para alterar o servidor de aplicativos, 314
servidor de log, 265
tentativa de registrar o distribuidor, 387
Content Manager ativo, 125
Content Manager de espera
configuração, 145
Content Manager em espera, 30, 125
conteúdo local
definição, 418
conversão
de indicadores do IBM Cognos Series 7 para o IBM
Cognos PowerPlay, 23
relatórios em ppr para ppx, 23
conversão de relatórios
do formato ppr para ppx, 23
cookies
ativação em navegadores web, 53
configurações, 287
personalização, 287
cookies HTML, 287
credenciais
definição, 418
credenciais de usuário
alteração em configuração autônoma, 366
criação
armazenamento de conteúdo, 85
criação ativa de scripts
ativação em navegadores web, 53
criação de strings de conexão
Microsoft SQL Server, 102, 140
criações
execução no IBM Cognos Connection usando o
Serviço de movimentação de dados, 36
criptografia
alteração de definições em configuração
autônoma, 366
erros de configuração, 401
criptografia de propriedades de arquivo temporário, 246
Cubo MS, 389
cubos
não é possível abrir, 389
cubos, 183
Ddados
bloqueados pelo IBM Cognos Configuration, 404
compartilhamento de locais de dados em uma
rede, 299
importação, 68
Data Manager
uso no IBM Cognos BI, 36
DB2
configuração do cliente, 97, 138
drivers de banco de dados, 97, 138
drivers JDBC, 17, 96
especificação como um repositório de mensagens de
log, 272
versões Java suportadas, 381
DB2-ERR-0005, 409
db2java.zip
substituído na versão 8.4, 20
426 IBM Cognos Business Intelligence PowerPlay
Índice
Derby
tamanho de cache da página, 360
desabilitação
acesso anônimo, 107, 148
descrição do produto, 13
desempenho
aperfeiçoamento para Apache Tomcat, 360
desinstalação
banco de dados de conteúdo do Cognos, 118, 179
Framework Manager, 117, 178
IBM Cognos BI, 116, 117, 177, 178
Transformer, 117, 178
desinstalação autônoma, 350
desinstalação no modo silencioso, 350
destinos de log
tipos, 265
diagnósticos, 265
diferenças
entre o IBM Cognos Series 7 PowerPlay e IBM
Cognos PowerPlay, 13
diretório de instalação
problemas após renomear ou mover, 403
requisitos, 121
diretório raiz
para salvar saídas de relatórios fora do IBM Cognos
BI, 253
diretórios
implantação de conteúdo, 64
diretórios temporários
exclusão antes da reinstalação, 402
diretórios virtuais
IBM Cognos BI, 109, 171, 329
dispositivos móveis
uso para acessar relatórios, 37
distribuição de relatórios
em uma rede, 361
distribuidor
remoção de registro, 332
distribuidores
Computador com componentes da camada de
aplicativos, 412
importação, 68
métricas do sistema, 353
documentação
arquivos traduzidos, 19
Software Development Kit, 15
domínios
árvores de domínio do Servidor do Active
Directory, 199
configuração de cookies, 287
drivers de banco de dados
DB2, 97, 138
Informix, 99, 139, 271
Oracle, 99, 139
Sybase, 99, 139
drivers JDBC, 17, 96
configuração de bancos de dados Oracle, 269
db2java.zip substituído na versão 8.4, 20
EEditor de registro Microsoft
aumento de soquetes ou portas, 409
configuração de contas do servidor de correio, 106
entrega
diminuição do tempo para abrir relatórios, 361
equilíbrio de carga, 52
ativação e desativação de serviços, 247
configuração, 29
configuração de definições do servidor de
correio, 147
erro CAM-CRP-1157, 381
erro CM-SYS-5007, 388
erro de contexto, 395
erro de criptografia, 405
erro no JRE, 405
problemas após atualização, 402
erro de diretório não encontrado, 390
erro de domínio confiável
ao salvar a configuração, 402
erro de Java ao iniciar a configuração, 405
erro de página não encontrada
inicialização do IBM Cognos BI no Windows
2003, 390
erro DPR-CMI-4006, 388
erro DPR-DPR-1035, 381
Erro HTTP 404, 390
erros
ESSBASEPATH, 408
erros de limite de tempo CGI, 411
especificações do relatório
definição, 418
Guia de instalação e configuração 427
Índice
ESSBASEPATH
adição, 408
etapas de trabalho
definição, 418
eTrust SiteMinder
ativação de signon único, 226
configuração de namespaces, 224
proteção do alias de web do IBM Cognos BI, 226
SSL, 226
uso para autenticação, 223
verificação de scripts cruzados no IBM Cognos
Application Firewall, 244
exigências do sistema, 40
exportação
arquivos de configuração, 348
criação de especificação, 65
Ffalha de rede
falha dos serviços ao iniciar, 386
falha no download de recurso, 387
finalidade do documento, 13
Firefox
configurações do navegador, 53
fontes
alteração do padrão, 251
alteração para relatórios em PDF, 251
configuração, 248
lista de fontes incorporadas a relatórios em PDF, 252
não encontradas ao iniciar o IBM Cognos
Configuration no UNIX, 408
requisitos para suporte, 250
fontes adicionais
instalação, 189
fontes de dados
definição, 418
descrição do componente, 25
fontes de dados OLAP, 389
membros ausentes ou inacessíveis, 410
fontes de dados relacionais
membros ausentes ou inacessíveis, 410
fontes de PDF
mapeamento de fontes de PDF integradas para uma
impressão de relatórios mais rápida, 250
fontes incorporadas, 252
Framework Manager
considerações de atualização, 73
desinstalação, 117, 178
erro de criptografia, 379
função SaferAPIGetTrustedSignon
uso para autenticação, 204
fusos horários
alteração, 285
fusos horários do servidor
alteração, 285
Ggateway
problemas de conexão, 403
gateway CGI
limitações com múltiplos computadores com Content
Manager, 124
gateway ISAPI
obrigatório com múltiplos computadores com
Content Manager, 124
recomendado com vários Content Managers, 288
gateways
adição em uma rede para diminuir os tempos de
entrega, 361
arquivo de log, 377
configuração, 170
configuração no IBM Cognos BI, 288
configuração para usar um namespace, 247
configurações recomendadas para Microsoft IIS, 411
definição, 418
descrição do componente, 21
instalação, 86
instalação em computadores separados, 29
quando usar ISAPI, 411
requisitos de configuração, 29
gateways Apache
configuração, 288
gateways de servlet
configuração, 294
glifos
definição, 418
grupos
definição, 419
membros ausentes no servidor Active Directory, 410
428 IBM Cognos Business Intelligence PowerPlay
Índice
Hhistóricos
implantação, 70
IIBM Cognos Administration
descrição do componente, 22
IBM Cognos Application Firewall
configuração, 244
IBM Cognos BI
alteração de servidores de aplicativos, 311
atualizador, 90, 131, 156, 166
componentes, 21
configuração, 52
configurações padrão, 85
desinstalação, 116, 177
distribuidores, 358
execução no mesmo computador do ReportNet, 81
exigências do sistema, 40
implantação, 322
instalação da ferramenta de migração no
Windows, 113, 175
login, 101, 148
não inicia em um servidor de aplicativos, 403
opções de instalação, 27
o serviço não inicia, 381
serviços, 358
solução de problemas em pacotes, 90, 131, 156, 166
IBM Cognos Configuration
configurações inválidas, 381
descrição do componente, 21
erro de fonte não encontrada no UNIX, 408
início, 100
modo autônomo, 348
não foi possível iniciar, 404
problemas ao gerar chaves de criptografia após a
instalação, 402
problemas ao salvar a configuração, 397
problemas com a navegação por teclas, 404
problemas na abertura, 376
IBM Cognos Connection
descrição do componente, 21
não é possível abrir, 390
IBM Cognos Controller
acesso a dados no IBM Cognos BI, 35
IBM Cognos Finance
acesso a dados no IBM Cognos BI, 35
IBM Cognos Go! Dashboard
renomeado como IBM Cognos Business Insight, 16
IBM Cognos Go! Mobile
relatórios móveis, 37
IBM Cognos Metrics Manager
atualização de relatórios salvos da versão 2.x para
o IBM Cognos BI, 73
atualização para o IBM Cognos BI, 72
IBM Cognos NoticeCast
duplicação de funcionalidade no IBM Cognos BI, 37
IBM Cognos Planning - Analyst
acesso a dados no IBM Cognos BI, 35
IBM Cognos Planning - Contributor
acesso a dados no IBM Cognos BI, 35
IBM Cognos Portal Services
visão geral da migração, 37
IBM Cognos PowerPlay
instalação, 86
solução de problemas em instalações, 375
IBM Cognos Query
duplicação de funcionalidade no IBM Cognos BI, 37
IBM CognosScript
visão geral da migração, 37
IBM Cognos Series 7
ativação do signon único, 203
ativação do SSL, 203
migração para o IBM Cognos BI, 33
plug-in de signon confiável, 203
uso para autenticação, 201
IBM Cognos Visualizer
duplicação de funcionalidade no IBM Cognos BI, 37
IBM Cognos Web Services
visão geral da migração, 37
IBM DB2
criação de strings de conexão, 102, 140
IBM Directory Server
com um namespace LDAP, 213
IBM Java Software Development Kit, 277
IBM WebSphere, 311
IBM WebSphere Application Server
signon único com o RACF, 230
IBM WebSphere Portal
configuração, 301
Guia de instalação e configuração 429
Índice
idioma
personalização do suporte da localidade do
conteúdo, 281
personalização na interface de usuário, 280
idiomas
incompatibilidade após atualização, 396
interface de usuário e arquivos de mensagem, 20
novo suporte na versão 8.4, 17
tabelas de conversão, 396
IIS do Windows
configurações de gateway recomendadas, 411
imagens
carregamento no Report Studio, 109, 171, 329
validade do conteúdo, 109, 171, 329
implantação
armazenamento de conteúdo, 64
conteúdo de diretórios, 64
exportação, 65
implantação parcial, 64
importação, 68
mudança de arquivos, 67
objetos de configuração, 68
pacotes, 64
Pastas públicas, 64
permissões, 64
planejamento, 63
teste, 70
implantação do IBM Cognos BI, 322
implantações
criação de uma especificação de exportação, 65
implementação
falha no servidor de aplicativos Oracle ou
WebSphere, 394
importação
configurações, 68
dados para o ambiente de destino, 68
Informix
conexões de banco de dados, 102
criação de armazenamento de conteúdo, 50
criação de um banco de dados de log, 50
drivers de banco de dados, 99, 139, 271
especificação como um repositório de mensagens de
log, 272
inicialização
arquivo de bloqueio da configuração, 376
DB2 retorna erro SQL1224N ao conectar ao
AIX, 387
falha no download de recurso, 387
falha no script, 394
não é possível abrir o IBM Cognos Connection, 390
não foi possível fazer o download de cognos.xts, 394
não foi possível iniciar o serviço, 380
página não encontrada, 390
problemas, 377
serviço do IBM Cognos, 405
serviço IBM Cognos a partir do IBM Cognos
Configuration, 111
Inicialização
falha sem erro, 381
inicialização do serviço do IBM Cognos
da linha de comando, 369
início
IBM Cognos Configuration, 100
instalação
amostras da Grandes Aventuras Ltda., 182
autônoma, 345
Banco de dados de conteúdo do Cognos
separadamente, 130
básica para várias localizações, 123
fontes adicionais, 189
IBM Cognos BI, 85, 345
IBM Cognos BI no Linux, 396
IBM Cognos PowerPlay, 86
instalação autônoma, 345, 346
lista de verificação, 85
opções para o Content Manager, 30
requisitos de nome de diretório, 389
sequência para componentes do servidor, 123
Supplementary Languages Documentation, 188
teste, 112, 151, 161, 174
uso do arquivo de especificação de transferência
(.ats), 345, 346
instalação autônomas
definição, 345
instalação de 32 bits
requisitos para arquivos de biblioteca de 32 bits, 45
instalação de 64 bits
requisitos para arquivos de biblioteca de 64 bits, 45
instalações básicas
várias localizações, 123
430 IBM Cognos Business Intelligence PowerPlay
Índice
instalações distribuídas
cenários, 27
configuração, 121
criação de perfis para o WebSphere Application
Server para o Linux no System z, 313
instalações no modo silencioso, 345
instalações para 64-bits, 31
interface
personalização do suporte de idioma, 280
interface de gateway comum
substituição, 288
interface de gateway comum (CGI)
definição, 419
interface de usuário
mapeamento para a localidade do produto, 284
personalização do suporte de idioma, 280
Internet Explorer
configurações do navegador, 53
requisitos para o suporte ao chinês simplificado, 251
interrupção do serviço do IBM Cognos
da linha de comando, 369
IPv4, 295
IPv6, 295
ISAPI
acesso ao IBM Cognos BI, 288
quando usar para um gateway, 411
JJava
alteração de versões, 335
atualização dos ambientes de tempo de
execução, 99, 337
atualização dos ambientes do tempo de
execução, 136
configuração de gateway de servlet para servidores
web compatíveis com Java, 294
usa toda a CPU, 381
versões suportadas para o armazenamento de
conteúdo DB2, 381
JAVA_HOME
configuração, 405
java.lang.NoClassDefFoundError, 379
Java Management Extensions
com logs de usuário, 277
configuração de propriedades JMX para
monitoramento remoto das métricas do
sistema, 353
Java Runtime Environment
IBM JRE substitui Sun Java Runtime
Environment, 19
Java scripts
ativação em navegadores web, 53
Java Software Development Kit da IBM, 353
JDBC
conectividade de banco de dados para
armazenamento de conteúdo, 97
JobStreams
execução no IBM Cognos Connection usando o
Serviço de movimentação de dados, 36
JRE
atualização, 136
JREs
atualização, 99, 337
JVM
alteração, 314, 335, 336
configurações de memória para o Banco de dados
de conteúdo do Cognos, 360
cópia para arquivos de fornecimento de
segurança, 337
Llatência
aperfeiçoamento, 361
LDAP
ativação do signon único, 222
ativação do SSL, 220
configuração de namespace, 208
edição da propriedade Mapeamento de identidade
externa, 222
IBM Directory Server, 213
Novell Directory Server, 215
propriedades personalizadas, 219
Servidor do Active Directory, 210
Sun Java System Directory Server, 217
uso para autenticação, 207
limite de tempo assíncrono, 362
Linux
caracteres corrompidos durante a instalação, 393
caracteres não são exibidos corretamente, 396
Guia de instalação e configuração 431
Índice
inicialização e interrupção do serviço do IBM
Cognos, 369
instalação e modo console é substituída, 20
mensagens de log, 272
no System z, criação de adição de perfis do
WebSphere para executar componentes do IBM
Cognos BI, 313
recursos e componentes não suportados, 40
requisitos do sistema, 85
variáveis de ambiente, 87, 126, 152, 163
Linux em System Z
suporte para o namespace RACF, 228
Linux no Sistema z
C8DB2.sh erro de script, 406
listas de incorporação de fontes, 252
locais do arquivo
exigências no Windows Vista, 297
local de arquivos temporários, 246
local de arquivo temporário
configuração, 246
localhost
requisito para alterar o nome do host ou o endereço
IP, 101
localidade do produto
definição, 419
localidade do usuário
mapeamento para a localidade do conteúdo, 282
localidades
definição, 419
exibição das localidades dos conteúdos
suportados, 281
exibição das localidades dos produtos
suportados, 280
localidades do conteúdo
exibição das localidades suportadas, 281
mapeamento para a localidade do usuário, 282
personalização, 281
localidades do produto
mapeamento para a interface de usuário, 284
localidades dos produtos
exibição das localidades suportadas, 280
Localização de arquivos de implantação
configuração para Windows Vista, 297
Localização de arquivos de mapa
configuração para Windows Vista, 297
Localização dos arquivos de dados
configuração para Windows Vista, 297
Localização dos arquivos temporários
configuração para Windows Vista, 297
log
banco de dados, 272
cliente de banco de dados, 268
configuração da segurança, 101, 148
log de eventos do Windows
destino para mensagens de log, 272
log do sistema
destino para mensagens de log, 272
login
ocultação de namespaces durante, 207, 226
logins de usuário
configuração de acesso seguro ao portal, 107, 148
logs
configuração, 272
processamento de mensagens, 265
serviço, 357
servidores remotos de log, 271
uso dos arquivos, 272
logs de auditoria, 265
destinos de logs, 265
logs de eventos, 272
logs de usuário, 277
Mmacro
conversão de relatórios em ppr para ppx, 23
manutenção
aperfeiçoamento do desempenho do sistema, 353
máquina virtual Java
pára ao implantar a importação, 407
marcador de segurança
configuração de cookies, 287
maxProcessor
aumento para Apache Tomcat, 360
mensagens de e-mail
alteração da codificação, 285
mensagens de erro
CAM-CRP-1064, 386
CAM-CRP-1315 A configuração atual aponta para
um Domínio Confiável diferente, 402
CFG-ERR-0106 O Cognos Configuration não
recebeu resposta, 378
432 IBM Cognos Business Intelligence PowerPlay
Índice
CM-CFG-029 O Content Manager não pode
determinar, 406
CMM-APP-3254 Falha na inicialização do
armazenamento de métricas, 411
DIS-ERR-3115 Falha ao executar tarefa, 411
download de um arquivo, 394
DPR-ERR-2014, 389
DPR-ERR-2022 Nenhuma resposta gerada, 393
DPR-ERR-2058, 387, 391
DPR-ERR-2079, 407
Erro HTTP 404, 390
falha ao carregar classe de servlet no WebLogic, 412
falha no download de recursos especificados, 387
informações de criptografia corrompidas, 405
Java Runtime Environment, 405
limite de tempo CGI, 411
MDS-RUN-3213 Não é possível localizar o utilitário
de carregamento em massa de banco de dados, 411
não é possível criptografar as informações de
criptografia, 401
Não foi possível equilibrar a carga da
solicitação, 389
não foi possível remover a série do atributo de
contexto, 395
página não encontrada, 390
PRS-CSE-1255, 386
RQP-DEF-0114, 397
RSV-SRV-066, 397
SoapSocketException, 387
solicitação malformada, 395
SQL1224N, 387
mensagens de log, 265
ativação no IBM Cognos Application Firewall, 244
destinos de logs, 265
servidor remoto de log, 265
métricas
para servidores, distribuidores e serviços, 353
métricas de sistema
acesso de fora do IBM Cognos Administration, 16
métricas do sistema
monitoramento remoto, 353
Microsoft
atualização de segurança afeta a memória, 381
Microsoft Analysis Server
requisito de namespace, 196
Microsoft Analysis Services
signon único a fontes de dados MSAS, 200
Microsoft Office
serviço de dados de relatórios, 358
Microsoft SQL Server
criação de strings de conexão, 102, 140
especificação como um repositório de mensagens de
log, 272
requisito de namespace, 196
migração
de outros produtos IBM Cognos para o IBM Cognos
BI, 33
exigências de autenticação, 107
falha ao executar, 413
modelo
alteração do tamanho do modelo, 359
modelos do Architect
migração para o IBM Cognos BI, 33
modo autônomo, 345
modo console
para instalação no UNIX e Linux, 20
modo silencioso, 345
moeda
fontes necessárias para caracteres Yen ou Won, 189
iene, 190
personalização do suporte, 280
won, 190
moeda coreana, 190
moeda japonesa, 190
Mover da atualização experimental para o ambiente de
produção, 71
mudança
arquivos de implantação, 67
multi_domain_tree, 199
Nnamespace
RACF, 228
namespace do Cognos
recriação, 404
namespace RACF, 228
namespaces
autenticação, 193
configuração de provedores de autenticação
personalizada, 206
configuração de um gateway, 247
Guia de instalação e configuração 433
Índice
definição, 419
exclusão, 231
exigências para o Content Manager caso esteja
usando o Transformer com um namespace Series
7, 86, 201
IBM Cognos Series 7, 107
membros do grupo ausentes no servidor Active
Directory, 410
não é possível fazer logon, 386
ocultação durante o login, 207, 226
recriação, 404
não é possível abrir o IBM Cognos Configuration, 376
não é possível criptografar as informações de
criptografia, 401
navegadores de internet
erros ao iniciar o portal web, 391, 393
navegadores web
configuração, 53
definições de segurança, 40
nenhuma resposta gerada, 393
Netegrity SiteMinder, 223
notas de versão
revisão antes da instalação, 39
Novell Directory Server
com um namespace LDAP, 215
NTLM, 227
ativação do signon único, 228
configuração, 227
NTLM, 227
OOracle
criação de strings de conexões, 102, 140
drivers de banco de dados, 99, 139
drivers JDBC de banco de dados, 269
erros de implantação, 411
especificação como um repositório de mensagens de
log, 272
servidor de aplicativos, 325
Oracle Application Server
falha na implementação do IBM Cognos BI, 394
Oracle Essbase
falhas na consulta, 409
Oracle WebCenter Interaction Portal
configuração, 301
OutOfMemoryError, 388
outros produtos
atualização, 80
Ppacote de correções
instalação, 90, 131, 156, 166
pacote de serviços
instalação, 90, 131, 156, 166
pacotes
implantação, 65
pacotes de métrica
definições, 419
parâmetro DuseCMLargeResultSet, 388
partes de patches
servidor de aplicativos, 314
passaportes
definição, 419
pastas
implantação pública, 64
Pastas públicas
implantação, 64
perfis
criação para o WebSphere Application Server para
Linux no System z, 313
permissões
implantação, 64
para a conta de usuário utilizada no serviço do IBM
Cognos, 234
para a conta de usuário utilizada no serviço do IBM
Cognos BI, 139, 158, 169
planejamento de atualização, 58
pool de aplicativos
criação no Windows Server 2008, 110, 173, 330
pools de aplicativos, 109, 171, 329
portal
configuração de acesso seguro para usuários, 107,
148
erros na inicialização, 391, 393
Portal do IBM Cognos BI
problema ao conectar no WebSphere Application
Server de 64 bits, 403
Portal Services, 301
disponibilidade no Linux, 40
especificação do arquivo applications.xml, 301
portas
alteração, 237
434 IBM Cognos Business Intelligence PowerPlay
Índice
definições de configuração padrão, 42
execução de diversas versões do IBM Cognos BI, 81
portas em uso, 380
portlets
definição, 419
PowerCube de amostra
configuração, 183
PowerCubes
acesso no IBM Cognos BI, 36
configuração da amostra para o PowerPlay, 183
exigências para uma conversão de idiomas bem-
sucedida, 36
não é possível abrir, 389
PowerCubes do IBM Cognos Series 7
exigências para uma conversão de idiomas bem-
sucedida, 36
PowerPlay Administration, 413
PowerPlay Server, 413
PowerPlay Studio
descrição do componente, 22
problemas no portal
não é possível abrir, 390
processamento de mensagens de log, 265
produto
alterações de nome, 19
prompts
definição, 419
tarefas exigidas, 121
propriedade de conta RACF
mapeamento de namespace RACF, 229
propriedade Mapeamento de identidade externa
caracteres especiais para namespace LDAP, 207
edição para namespace LDAP, 222
propriedade Pesquisa de usuário
caracteres especiais para namespace LDAP, 207
propriedades
alteração em configuração autônoma, 366
configuração para servidor de aplicativos, 322
local de arquivo temporário, 246
propriedades do ambiente, 101
propriedades personalizadas de usuário
Servidor do Active Directory, 197
propriedades personalizadas do usuário
LDAP, 219
propriedades URI
requisito para alterar o localhost para o nome do
host ou o endereço IP, 101
propriedade Vincular DN do usuário e senha
caracteres especiais para namespace LDAP, 207
proteção contra failover, 30
proteção de failover
gateway ISAPI obrigatório para instalação múltipla
de Content Manager, 124
protocolo
endereço IP, 295
protocolo SSL
configuração, 259
provedor de autenticação
configuração do IBM Cognos BI para utilizar
segurança, 101, 148
provedores de autenticação
definição, 419
provedores de autenticação personalizada, 206
público-alvo do documento, 13
Qqualidade de proteção em conexões SSL, 263
RRACF
ativação do signon único, 230
conectividade, 229
configurações de autenticação para administradores
do IBM Cognos BI, 229
recriação de namespaces no Cognos, 404
recursos
adição, 364
relatórios
alteração da fonte padrão, 251
diminuição do tempo de entrega, 361
personalização do suporte de idioma, 281
teste antes da atualização, 62
Relatórios Web Impromptu
migração para o IBM Cognos BI, 34
remoção de componentes de vários servidores, 350
remoção de registros de distribuidores, 332
ReportNet
arquivo de atualização para IBM Cognos BI, 377
atualização, 72
atualização para o IBM Cognos BI, 72
Guia de instalação e configuração 435
Índice
execução no mesmo computador do IBM Cognos
BI, 81
Report Studio
carregamento de imagens, 109, 171, 329
requisitos
diretório de instalação, 389
Resource Access Control Facility
Consulte também RACF, 228
revisão das notas de versão antes da instalação, 39
roteadores
configuração, 297
Ssaída de relatório
como salvar em um sistema de arquivos, 253
compartilhamento com usuários fora do IBM
Cognos BI, 253
saída do relatório
reutilização, 254
SAP Enterprise Portal
configuração, 301
scripts
criação de armazenamento de conteúdo no DB2, 93,
133
excluir tabelas de bancos de dados, 397
para melhorar o desempenho do armazenamento de
métricas, 361
scripts de inicialização, 320
scripts de limpeza do banco de dados, 397
scripts de SQL
para excluir bancos de dados, 397
segurança
ativação, 101, 148
configuração de acesso seguro ao portal, 107, 148
definições para navegadores web, 40
problemas com a Autenticação integrada do
Windows, 407
segurança nativa do Windows (NTLM)
ativação do signon único, 228
uso para autenticação, 227
senhas
alteração em configuração autônoma, 366
alteração no Banco de dados de conteúdo do
Cognos, 235
seqüência de intercalação, 44
seqüências de intercalação
distinção entre maiúsculas e minúsculas, 381
série do atributo de contexto não pode ser removida, 395
Series 7 PowerCubes
exigências para uma conversão de idiomas bem-
sucedida, 36
Series 7 PowerPlay
atualização de relatórios salvos do ReportNet para
o IBM Cognos BI, 73
serviço
atualização do índice, 356
dados do índice, 356
gráficos, 356
pesquisa do índice, 356
tarefa realizada por usuários, 356
serviço Content Manager, 355
serviço de agentes, 355
serviço de anotação, 355
serviço de apresentação, 358
Serviço de apresentação
requisitos, 354
serviço de atualização do índice, 356
serviço de consulta, 358
serviço de dados de relatório, 358
serviço de dados do índice, 356
serviço de entrega, 355
serviço de gerenciamento de eventos, 356
serviço de gráficos, 356
serviço de integração de dados, 355
serviço de metadados, 357
serviço de migração, 357
Serviço de migração
descrição do componente, 23
serviço de monitor, 358
Serviço de movimentação de dados
uso no IBM Cognos Connection, 36
serviço de pesquisa do índice, 356
Serviço de relatório
lista de fontes incorporadas a relatórios em PDF, 252
requisitos, 354
Serviço de relatório em lote
lista de fontes incorporadas a relatórios em PDF, 252
serviço de relatório em lotes, 355
serviço de tarefas realizadas por usuários, 356
serviço de trabalhos, 356
436 IBM Cognos Business Intelligence PowerPlay
Índice
serviço do IBM Cognos
configuração, 359
inicialização a partir da linha de comando, 369
interrupção da linha de comando, 369
requisitos para a conta de usuário utilizada para o
serviço, 234
servidor indisponível, 381
serviço do IBM Cognos BI
requisitos para a conta de usuário utilizada para o
serviço, 139, 158, 169
serviço IBM Cognos
inicialização, 100, 405
inicialização do IBM Cognos Configuration, 111
serviço Metrics Manager, 357
serviços
agente, 355
ajuste para melhorar o desempenho, 354
anotação, 355
apresentação, 354, 358
ativação e desativação, 247
consulta, 358
Content Manager, 355
dados de relatórios, 358
definição da conta de usuário para o acesso à rede
compartilhada, 299
desinstalação, 116, 177
entrega, 355
falha ao iniciar após falha de rede, 386
gerenciamento de eventos, 356
IBM Cognos BI, 358
início, 100
início da linha de comando, 369
integração de dados, 355
interrupção da linha de comando, 369
log, 357
metadados, 357
métricas do sistema, 353
Metrics Manager, 357
Migração, 357
monitor, 358
não foi possível iniciar, 380
relatório, 358
Relatório, 354
relatório em lotes, 355
serviço de migração não funciona, 413
trabalho, 356
serviços de relatório, 358
servidor Active Directory
membros do grupo ausentes, 410
Servidor de aplicativo Oracle, 311
Servidor de aplicativos de 64 bits
problema ao conectar com o portal do IBM Cognos
BI, 403
servidor de aplicativos WebSphere
falha na implantação do IBM Cognos BI, 394
servidor de correio
configuração, 147
Servidor do Active Directory
ativação do signon único, 200
ativação do SSL, 198
autenticação em múltiplos domínios, 199
com um namespace LDAP, 210
propriedades avançadas, 199
uso para autenticação, 195
servidor do IBM Cognos BI
falha na inicialização, 381
servidores
métricas do sistema, 353
servidores de aplicativos
alteração do padrão, 311
atualização do IBM Cognos BI, 333
configuração, 322
falha ao carregar classe de servlet no WebLogic, 412
falha no script de inicialização, 394
gateways de servlet, 294
problemas na execução do IBM Cognos BI, 403
scripts de inicialização, 320
scripts de inicialização para servidor de aplicativos
Oracle, 325
scripts de inicialização para servidor de aplicativos
Sun Java System, 327
servidores de internet IIS do Windows
configurações de gateway recomendadas, 411
servidores de log remotos
configuração, 272
servidores remotos de log, 271
servidores virtuais
configuração para o IBM Cognos BI, 109, 171, 329
servidores web
ativação do SSL, 264
configuração, 109, 171, 329
Guia de instalação e configuração 437
Índice
definição do tempo de carregamento do Report
Studio, 109, 171, 329
gateways de servlet, 294
signon único utilizando o Active Directory e o
servidor web IIS, 200
servidores web Apache
configuração como gateways, 288
configuração de aliases, 109, 171, 329
servidores web IIS
signon único utilizando o Active Directory, 200
SharePoint Portal
configuração, 301
signon único
namespace do Active Directory, 200
namespace LDAP, 222
namespace NTLM, 228
namespace RACF, 230
problemas com a Autenticação integrada do
Windows, 407
uso de namespaces do IBM Cognos Series 7, 203
single signon
diretório de usuário do eTrust SiteMinder, 226
sistema de relatório
para salvar cópias da saída do relatório, 253
sistemas operacionais
como afetam na atualização, 73
Software Development Kit
documentação, 15
Solaris
JRE 1.5, 407
solicitações de assinatura de certificado
geração, 339
solução de problemas, 375
Content Manager falha ao iniciar, 388
logs, 265
para um usuário específico, 277
SSL
ativação em servidores web, 264
ativação para servidores de aplicativos, 328
configuração de confiança compartilhada com
outros servidores, 262
diretório de usuário do eTrust SiteMinder, 226
namespace LDAP, 220
qualidade de proteção, 263
Servidor do Active Directory, 198
uso de namespaces do IBM Cognos Series 7, 203
strings de conexão de banco de dados
IBM DB2, 102, 140
Oracle, 102, 140
Sybase, 102
Sun Java JDK, 277, 353
Sun Java Runtime Environment
substituído pelo IBM JRE, 19
Sun Java System
servidor de aplicativos, 327
Sun Java System Directory Server
com um namespace LDAP, 217
suporte a idioma, 19
Supplementary Languages Documentation
instalação, 188
novidades da versão 8.4, 19
Sybase
criação de armazenamento de conteúdo, 51
criação de strings de conexões, 102
drivers de banco de dados, 99, 139
especificação como um repositório de mensagens de
log, 272
System z
criação de adição de perfis do WebSphere para
executar componentes do IBM Cognos BI, 313
Ttabelas
exclusão de um banco de dados, 397
tablespaces, 359
banco de dados de notificação DB2 em z/OS, 256
tamanho de cache da página
Derby, 360
tarefas exigidas
configuração, 121
teclado
problemas de navegação, 404
teclas de atalho, 415
tecla Tab
problemas no IBM Cognos Configuration, 404
tela tremida, 413
tempo limite do pool de conexão padrão
conflitos entre o IBM Cognos BI e alguns servidores
de aplicativos, 317
teste
configuração, 112
implantação, 70
438 IBM Cognos Business Intelligence PowerPlay
Índice
instalação, 112
teste da instalação, 151, 161, 174
Tomcat
ajuste, 360
definições de configuração padrão, 42
tours rápidos, 13
trabalhos
definição, 420
Transformer
acesso a dados no IBM Cognos BI, 36
desinstalação, 117, 178
exigências para o Content Manager caso esteja
usando um namespace Series 7, 86, 201
tremer, 413
UUNIX
erro de fonte não encontrada, 408
inicialização e interrupção do serviço do IBM
Cognos, 369
instalação e modo console é substituída, 20
mensagens de log, 272
requisitos do sistema, 85
variáveis de ambiente, 87, 126, 152, 163
UNIX AIX
suporte para o namespace RACF, 228
URI
alteração, 237
definições de configuração padrão, 42
URIs do Content Manager, 145, 159
usuários
alteração no Banco de dados de conteúdo do
Cognos, 235
definição, 420
UTF-8
codificação de mensagens de e-mail, 285
utilitário de conversão de indicador, 23
Vvalidade do conteúdo
diretório de imagens, 109, 171, 329
valores de devolução
cogconfig.sh não compatíveis com UNIX, 397
variáveis de ambiente
armazenamento de conteúdo, 44
configuração para componentes de camada de
aplicativos, 159
definição para servidores de aplicativos, 316
exigências no Windows Vista, 297
para instalação no UNIX ou no Linux, 87, 126,
152, 163
verificação de scripts cruzados
configuração no IBM Cognos Application
Firewall, 244
versão de endereço IP, 295
versões
atualizações do ReportNet suportadas, 72
versões do produto, 90, 131, 156, 166
WWebLogic
falha ao carregar classe de servlet, 412
falha no script de inicialização, 394
implantação do arquivo p2pd.war, 395
não foi possível remover a série do atributo de
contexto, 395
script de inicialização, 320
servidor do aplicativo, 323, 326
WebLogic Application Server
falha do IBM Cognos BI, 394
WebSphere
servidor de aplicativos, 322
WebSphere Application Server
falha no script de inicialização, 394
perfis adicionais no Linux para o System z, 313
problema ao conectar com o portal do IBM Cognos
BI, 403
Windows
instalação da ferramenta de migração do IBM
Cognos, 113, 175
requisitos do sistema, 85
Windows Server 2008
criação de pool de aplicativos, 110, 173, 330
Windows Vista
como afeta na atualização, 73
exigências para locais do arquivo, 297
Won coreano
requisitos de fonte, 189
XXQE-DS-0006, 409
Guia de instalação e configuração 439
Índice
YYen japonês
requisitos de fonte, 189
440 IBM Cognos Business Intelligence PowerPlay
Índice