public.dhe.ibm.compublic.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Componentes de migração 23 Componentes do cliente 24 Outros componentes 24 Componente2:Planejamentodainstalação

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.

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

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


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


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


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


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


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


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


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.




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.


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


http://www.ibm.com/software/data/support/cognos_crc.html

http://publib.boulder.ibm.com/infocenter/cbi/v10r1m0/

http://publib.boulder.ibm.com/infocenter/cbi/v10r1m0/

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.



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.



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).




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


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.



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


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 ).



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


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.


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.



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.



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.





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.


● 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).


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


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.



É 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.


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.



Instalação de diversosContent ManagerGateway de servidor

Content Managerem espera

Content Managerpadrão ativo

Armazenamentode conteúdo

Fontes de dados

web Application TierComponents


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).



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.



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.



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



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.



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.





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



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.





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/).


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

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.






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


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.




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



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



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.



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



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)



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



❑ 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.


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 ).


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




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.



❑ 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.


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





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.



❑ 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



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.



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çõ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.



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



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



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



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.





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


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.


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


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



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






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.




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.



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.



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


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.



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.



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.



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.




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.



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.



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.


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.




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 .



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




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.



❑ 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.



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



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.



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,


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. 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



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,


● 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:



● 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,


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.


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.



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.


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.



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.





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.



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.



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.





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 ).


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.


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.



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.



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.


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


Etapas para instalar no Windows


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.




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


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.


● Se desejar ver os arquivos de log, clique em Visualização para o arquivo de log adequado.



● 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.



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/.



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.

● 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





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:


Por exemplo,


exporte PATH





Por exemplo,


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.


versão primeiro.

6. Para iniciar o assistente de instalação, digite

./issetup









● 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


● Siga as instruções do assistente de instalação, instalando no mesmo local que os componentes





restantes.





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.



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



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:



● 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.


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


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.



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


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.

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 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.



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




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.


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.



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 ).


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.


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:



● 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 ).


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



conteúdo.


banco de dados.



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.




Para se conectar ao DB2® em z/OS®, será necessário usar a conexão JDBC tipo 4.



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.





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


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.

● 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:




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.







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



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


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


2. Na janela Explorer, em Segurança, clique em Autenticação e depois em Cognos.


4. Na janela Explorer, clique com o botão direito em Autenticação e selecione Novo recurso,

Namespace.


6. Na lista Tipo, clique em IBM Cognos Series 7 e depois em OK.




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.




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.



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.





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


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 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


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


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.



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



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


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.



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



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:



● 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.


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.



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.




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.





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


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.


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



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


Banco de dadosde notificação

Servidor da Web


Segurança


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



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



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 ).



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.



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


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




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®.




_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.






Por exemplo,


exporte PATH





Por exemplo,



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





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.



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.


● Se desejar ver os arquivos de log, clique em Exibir para o arquivo de log apropriado.



● 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.


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.


10. Anexe o diretório local_c10/bin à variável de ambiente do caminho da biblioteca apropriada.







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



necessário instalar o componente Supplementary Language Documentation no mesmo local que os



Etapas para o Windows










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.


computador.


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.






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.











Windows para iniciar o IBM Cognos Configuration na pasta de atalho.


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






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.


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.









support/us/en/.





C8BISRVR_version=.











versão primeiro.


issetup.exe.




















restantes.














Por exemplo,


exporte PATH





Por exemplo,









versão primeiro.




./issetup













./issetup







restantes.





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 ).



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.


./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.




Etapas






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.


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



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:

● 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.


os parâmetros de espaço reservado por aqueles que são adequados a seu ambiente.


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.



pelo nome do banco de dados do armazenamento de conteúdo.

11. Salve o script.



O banco de dados do armazenamento de conteúdo foi criado. Agora é possível configurar uma

conexão de banco de dados.








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.



definir como uma variável de usuário, faça com que o ambiente no qual o Tomcat estiver sendo

executado possa acessá-lo.





Java.







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:


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




instalar o Content Manager. Fazer isso permite ao Content Manager acessar o banco de dados de


Etapas para o DB2

1. Se estiver usando uma conexão JDBC tipo 2, instale o software do cliente DB2® nos


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.



).

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.








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


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.

É 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 ).


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.



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.



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



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.


local_c10\configuration e edite o arquivo cogconfig.prefs para adicionar o local de seu navegador

Web.


BrowserPath=localização_navegador_web\firefox

sendo que localização_navegador_web é um caminho, como \usr\local\bin\



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 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,



Etapa para o DB2® nos sistemas operacionais Linux®, UNIX® ou Microsoft® Windows®



conteúdo.


banco de dados.







Se deixar esta propriedade em branco, a conexão JDBC tipo 2 será usada.











feito.




conteúdo.


banco de dados.



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.




Para se conectar ao DB2® em z/OS®, será necessário usar a conexão JDBC tipo 4.





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.







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


2. Na janela do Explorer, em Acesso a dados, Content Manager, clique com o botão direito do


Isso exclui a conexão ao recurso padrão. O Content Manager pode acessar apenas um


3. Clique com o botão direito em Content Manager, e clique em Novo recurso, Banco de dados.




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



● 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.


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.



um exemplo:


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.







Eis um exemplo:


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.



7. Para configurar credenciais de logon, especifique uma ID e senha de usuário:




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:



clique no botão Editar .


● 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.









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.


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.



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.


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.


4. Na janela Propriedades, clique no valor de URIs do Content Manager e no botão de edição.




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.



● Clique em OK.


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.



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.


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


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



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.


3. Clique com o botão direito do mouse Autenticação e clique em Novo recurso > Namespace.


5. Na lista Tipo, clique no tipo de namespace apropriado e clique em OK.


Autenticação.


para o namespace.


de autenticação, consulte "Configuração de componentes do IBM Cognos para utilizar

provedores de autenticação" (p. 193 ).


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.


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



(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


2. Na janela Explorer, em Segurança, clique em Autenticação e depois em Cognos.


4. Na janela Explorer, clique com o botão direito em Autenticação e selecione Novo recurso,

Namespace.


6. Na lista Tipo, clique em IBM Cognos Series 7 e depois em OK.


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.


componentes do IBM Cognos BI possam localizar e utilizar o provedor de autenticação existente.


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.













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.




Etapas











Local.











Teste da instalação do Content ManagerÉ possível testar a instalação utilizando um navegador web.

Etapas


2. Teste se o Content Manager está em execução digitando o valor URIs do Content Manager do

IBM® Cognos® Configuration. Por exemplo,



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



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.














_M_ARENA_OPTS 1:4



4. No AIX, se estiver usando um gateway de servlet, configure a variável de ambiente

AIXTHREAD_SCOPE como o seguinte:

AIXTHREAD_SCOPE=S








Por exemplo,


exporte PATH





Por exemplo,







./issetup







computador.




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.






substituídos.

● Ao selecionar os componentes, desmarque todos, exceto Componentes da camada de

aplicativos.





































computador.


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.






substituídos.

● Ao selecionar os componentes, desmarque todos, exceto Componentes da camada de

aplicativos.























support/us/en/.





C8BISRVR_version=.











versão primeiro.


issetup.exe.




















restantes.














Por exemplo,


exporte PATH





Por exemplo,









versão primeiro.




./issetup













./issetup







restantes.










definidas.
















./cogconfig.sh



Web.






Etapas no Windows




Web.






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.



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.


3. Na janela Propriedades, altere a porção localhost da propriedade URIs do Content Managerpara o nome de qualquer computador com o Content Manager.




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.



● 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.


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.




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.




Etapas











Local.









Teste do Application Tier ComponentsÉ possível testar a instalação utilizando um navegador web.

Etapas




2. Teste a disponibilidade do distribuidor digitando o valor URI do distribuidor externo do IBM®

Cognos® Configuration. Por exemplo,


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.



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.












_M_ARENA_OPTS 1:4



4. No AIX, defina a variável de ambiente AIXTHREAD_SCOPE da seguinte forma:

AIXTHREAD_SCOPE=S








Por exemplo,


exporte PATH







Por exemplo,







./issetup







computador.


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







substituídos.

● Ao selecionar os componentes, desmarque todos, exceto Gateway.


















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 ).















computador.


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







substituídos.

● Ao selecionar os componentes, desmarque todos, exceto Gateway.













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 ).







support/us/en/.





C8BISRVR_version=.











versão primeiro.






issetup.exe.
















restantes.














Por exemplo,


exporte PATH







Por exemplo,









versão primeiro.


./issetup













./issetup









restantes.










definidas.














./cogconfig.sh



Web.






Etapas no Windows






Web.






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.


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.



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.


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).


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.



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.


1. Crie os diretórios virtuais da tabela a seguir:









2. Se deseja usar o navegador de imagens do Report Studio, ative o Web Distributed Authoring





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.





Para obter informações sobre como definir a validade do conteúdo, consulte a documentação

de seu servidor web.
















OK.





webcontent.













mouse.









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.


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



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


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.

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


● 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>




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:


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.



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.


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.




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.



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.


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 .



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.


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.


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:


Por exemplo,


exporte PATH





Por exemplo,



utilizando um disco do IBM Cognos dessa unidade.


para desmontar o CD.


./issetup


Capítulo 8: Instalação e configuração de componentes opcionais


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.


computador.

Instale as amostras no mesmo local dos componentes do servidor.




● Insira o disco do IBM Cognos BI Samples.






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.


computador.

Instale as amostras no mesmo local que os componentes do PowerPlay. Em uma instalação

distribuída, instale-as no computador de gateway.


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.



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.



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.





Administration.

5. Clique na guia Configuração.


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



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.





Administration.

5. Clique em Configuração.


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


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. 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


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.



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.


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.


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.



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.


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.


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



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.



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.





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.


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


● 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


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.


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.


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.


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



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.



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.


4. Na lista Tipo, clique no namespace apropriado e clique em OK.


Autenticação.


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.


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



de dados privados virtuais. Para obter mais informações, consulte o Guia de administração e

segurança.

Etapas


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.


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.



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



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.




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



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.



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.


(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



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







Autenticação.


para o namespace.




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.















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



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]*/



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.




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.




4. Na lista Tipo, selecione Provedor Java personalizado e clique em OK.


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.









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.


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:



❑ 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



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







Autenticação.


para o namespace.



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.



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.





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.






Autenticação.


para o namespace.






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



Se não houver valores especificados, o provedor de autenticação LDAP vincula como anônimo.






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


membroMembro

cnNome

usuárioClasse do objetoConta




telephonenumberTelefone comercial

(deixar em branco)Localidade do conteúdo


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.










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.




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.


para o namespace.



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



Se não houver valores especificados, o namespace de autenticação LDAP vincula como anônimo.







IBM Directory Server, utilize valores especificados na seguinte tabela.


organizationalunit,organization,containerClasse do objetoPasta





ou,o,cnNome

groupofnamesClasse do objetoGrupo


membroMembro

cnNome

inetorgpersonClasse do objetoConta


(deixar em branco)Localidade do conteúdo


correioE-mail





cnNome

pagerPager

userPasswordSenha


(deixar em branco)Localidade do produto

snSobrenome

uidNome de usuário




padrão do IBM Directory Server. Caso tenha modificado o esquema, pode ser necessário realizar

alterações de mapeamento adicionais.





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


Configuration.







5. Na janela Propriedades, para a propriedade ID doNamespace, especifique um identificador

exclusivo para o namespace.




● 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












Novell Directory Server, utilize valores especificados na seguinte tabela.


organizationalunit,organization,containerClasse do objetoPasta


ou,o,cnNome

groupofnamesClasse do objetoGrupo


membroMembro

cnNome

inetOrgPersonClasse do objetoConta


IdiomaLocalidade do conteúdo


correioE-mail





cnNome

pagerPager

(deixar em branco)Senha





IdiomaLocalidade do produto

snSobrenome

uidNome de usuário


padrão do Novell Directory Server. Caso tenha modificado o esquema, pode ser necessário

realizar alterações de mapeamento adicionais.




Para o login bem-sucedido de usuários no IBM Cognos Connection, eles devem ter permissão

para ler os atributos ou e o.


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


Configuration.







5. Na janela Propriedades, para a propriedade ID doNamespace, especifique um identificador

exclusivo para o namespace.




As configurações seguintes são exemplos:

● Em Pesquisa de usuário, digite (uid=${userID})



● 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










Sun Java System Directory Server, utilize valores especificados na seguinte tabela.


organizationalUnit,organizationClasse do objetoPasta


ou,oNome

groupofuniquenamesClasse do objetoGrupo


uniquememberMembro

cnNome

inetorgpersonClasse do objetoConta


preferredlanguageLocalidade do conteúdo





correioE-mail





cnNome

pagerPager

userPasswordSenha


preferredlanguageLocalidade do produto

snSobrenome

uidNome de usuário


padrão do Sun Java System Directory Server. Caso tenha modificado o esquema, pode ser

necessário realizar alterações de mapeamento adicionais.





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.



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.


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



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.


11. No menu Ações, clique em Reiniciar.



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


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


A string de busca.str




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



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.



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.




4. Na lista Tipo, clique no namespace do Netegrity SiteMinder e clique em OK.


Autenticação.


para o namespace.




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.






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.



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.


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.




4. Na lista Tipo, clique em NTLMe em OK.


Autenticação.


para o namespace.

Dica: não use dois-pontos (:) na propriedade ID do 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.




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



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.


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.



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.




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


Etapas


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.



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.


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.





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


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.


❑ 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.


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.



● 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.



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





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.


desconectar;

Etapas para remover um usuário





conecte 'jdbc:derby://localhost:1527/cm;user=NewUser; password=NewUserPassword';



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.


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



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




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.


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



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


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.


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.



● 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



https://www14.software.ibm.com/webapp/iwm/web/preLogin.do?source=jcesdk


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 ).


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.





● 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.


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





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.


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



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


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:



● 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


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.


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



3. Na janela Propriedades, na propriedade Localização dos arquivos temporários, especifique o

novo local.



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.


3. Na janela Propriedades, na caixa Valor ao lado da propriedade Namespace do gateway, digite

a ID do namespace que deseja usar.


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.



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


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.


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.



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.


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.


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.




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.


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.


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.


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®,



é 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.



Certifique-se de que a fonte padrão esteja instalada em todos os computadores com o IBM Cognos.

Etapas



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.


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.


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 .



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.


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



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.


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.


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.



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.


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.


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.



É 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


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®.


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 ).


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.






Etapas




local_c10/configuration/schemas/content/db2zOS


os parâmetros genéricos com os adequados a seu ambiente.


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




pelo nome do banco de dados da notificação.

6. Salve o script.



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.




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.


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.



● 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.



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.



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



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.



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.


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



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



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


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.


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.



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



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.



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.


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



Etapas





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.


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



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.



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

).


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.



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


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.



).

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.








Dica: Para verificar a versão do driver, execute o comando java -cp caminho\db2jcc.jar com.

ibm.db2.jcc.DB2Jjcc -versão.


6. Repita o procedimento inteiro nos computadores com IBM Cognos em que o software deve

ser instalado.


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 de licença, por exemplo db2jcc_license_cisuz.jar.



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.



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.



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,



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.



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.



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.


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.



um exemplo:


● 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.


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.


1. No computador onde o Content Manager ou o Application Tier Components foram instalados,

inicie o IBM Cognos Configuration.





servidor de log.

AçãoTarefa






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



disponíveis para o servidor de

log local. Mantenha o valor padrão de 10. O intervalo vai de 1 a 20.




Destino.


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.


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 ).



clique no botão de edição .

13. Clique em Adicionar e adicione os seguintes nomes e valores de parâmetros 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


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.




servidor de log.

AçãoTarefa






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



disponíveis para o servidor de

log local. Mantenha o valor padrão de 10. O intervalo vai de 1 a 20.




Destino.




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.


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:



clique no botão editar .


● 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.


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



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.


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.




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.



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.


3. Clique na guia Localidades do produto.

Todas as localidades suportadas são exibidas.


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.


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



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



3. Clique na guia Moedas.


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.


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



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



3. Clique na guia Localidades do conteúdo.

Todas as localidades suportadas são exibidas.


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.


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.



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



3. Clique na guia Mapeamentos de Localidades do Conteúdo.


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.



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.


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.


3. Clique na guia Mapeamentos de Localidades do Produto.


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



● 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.


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




4. Clique na coluna Valor de Fuso horário do servidor e selecione outro fuso horário na lista.


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,



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)



Valor de codificação suportadoConjunto de caracteres

ksc_5601Coreano (KSC-5601)

windows-874Tailandês (Windows-874)

tis-620Tailandês (TIS-620)

Etapas




4. Clique na coluna Valor na propriedade Codificação de e-mail.

5. Role a tela até a definição desejada e clique nela.


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



Formato do domínioHost

.nome1.nome2.sufixooutro

(três pontos)

Exemplo: .infoviagens.co.nz

Etapas



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



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>



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>


</Location>



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.



● 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.




6. Visando à integração bem-sucedida do portal, certifique-se de que SERVERNAME e

SERVER_PORT estejam especificados na propriedade ServerName.


LoadModule cognos_module "local_c10/cgi-bin/mod2_cognos.sufixo"



dllWindows®

soSolaris, AIX

slHP-UX PA-RISC

soHP-UX IA, Linux®






</Directory>




<Location /ibmcognos/cgi-bin/mod2_cognos.suffix>


</Location>




status do servidor:

<Location /ibmcognos/cgi-bin/diag_mod2_cognos. suffix>


</Location>





11. Adicione o seguinte à seção de diretório do usuário:

<IfModule mod2_cognos.c>


</IfModule>


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.




Por exemplo,


Etapas para o Apache Server 2.2.x e IBM HTTP Server 7,0

1. Interrompa o servidor web.



● 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 .


6. Visando à integração bem-sucedida do portal, certifique-se de que SERVERNAME e

SERVER_PORT estejam especificados na propriedade ServerName.


LoadModule cognos_module "local_c10/cgi-bin/mod2_2_cognos.sufixo"



dllWindows®

soSolaris, AIX




slHP-UX PA-RISC

soHP-UX IA, Linux®






</Directory>








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>


<Location /ibmcognos/cgi-bin/cognos_module>


Order allow,deny

Allow from all

</Location>



Digite o código exatamente como especificado, incluindo a string cognos_module.


status do servidor:

<Location /ibmcognos/cgi-bin/diag_cognos_module>


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>


</IfModule>


14. Inicie o servidor Web.




Por exemplo,


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



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.


É 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.



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



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.


5. Feche o IBM Cognos Configuration.

Etapas para ativar manualmente a opção IPv6 ao abrir o IBM Cognos Configuration


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.



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



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%



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


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


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:



● 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


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.





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.


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.


❑ 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.


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.


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.



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


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.


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)



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.



6. Em Ambiente, para Configurações de gateway, defina a propriedade Permitir substituição do

namespace como verdadeira.


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


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


http://meuservidor/ibmcognos/cgi-bin/cognos.cgi/wsrp/cps4/portlets/sdk?wsdl&b_

action=cps.wsdl




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


http://meuservidor/ibmcognos/cgi-bin/cognos.cgi/wsrp/cps4/portlets/cmm?wsdl&b_

action=cps.wsdl


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



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.



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/


● 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.



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/


● Altere a propriedade cps_auth_namespace para o namespace que deseja utilizar para

autenticação.





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®.



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.





❑ 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.


❑ 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.


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.


./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.



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



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



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.



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.



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.



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 ).




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:



-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.


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



-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.


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


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.



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.


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


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:



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.



● 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.


mensagem na janela do console do servidor do aplicativo ou no arquivo de log do servidor do

aplicativo:


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.


PATHWindows

LIBPATHAIX




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


O valor do parâmetro Map to URL deve ser o mesmo do valor da raiz de contexto inserido no


10. Inicie a instância OC4J criada para os componentes IBM Cognos.



aplicativo:


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.



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">  <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.



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.



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


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


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.



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.


1. Crie os diretórios virtuais mostrados na tabela a seguir:













2. Se desejar usar o navegador de imagens do Report Studio, ative o Web Distributed Authoring





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.





Para obter informações em como definir a validade do conteúdo, consulte a documentação de

seu servidor web.














OK.





webcontent.















mouse.







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:




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


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.



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.





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.




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.



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




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.






É 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.





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.





Java.





Java.







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.



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:


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





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



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.



● 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


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.



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:


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


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:


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


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:


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



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


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


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.





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.


É 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.


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



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


./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



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.



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).


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




./uninst -u -s

Todos os componentes definidos como 1 nos arquivos .ats serão removidos.





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.


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.


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.



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



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



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



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



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


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.



● 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.


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:



Localize a seguinte linha:

maxProcessors="75"

e altere-a para o seguinte:

maxProcessors="1000"

3. Localize a seguinte linha:

acceptCount="100"


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.


MEM_SETTINGS=-Xmx256m




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.



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.



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.


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.


Apêndice A: Configuração manual do IBM Cognos BI


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):

 <crn:instance ...> ... </crn:instance> 





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">


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



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.


8. Digite o seguinte comando de configuração:



./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



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.




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 ).


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


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.



É 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


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



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



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


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



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


gateway_war_without_docsamples

Arquivo EAR com conteúdo estáticogateway_ear

Arquivo EAR com conteúdo estático e sem


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:




JBoss

jboss

outro (padrão)

-Dappserver_type=value


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


O padrão é ../../ServletGateway.

war

-Dwar_name=valor

Caminho e nome do

arquivo EAR que será

criado


O padrão é ../../ServletGateway.

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





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



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.



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.



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.





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.



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:



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


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.


6. No menu Ação, clique em Iniciar.



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.



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.





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


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-SYS-5124 O servidor do banco de dados de armazenamento de conteúdo usa a página de

códigos US7ASCII.

● Para Sybase:





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.



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-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-5036 Falha do Content Manager ao conectar-se com o armazenamento de conteúdo.

A string de conexão é "jdbc:JSQLConnect://localhost:1433/cm".



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-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:




A string de conexão é "jdbc:oracle:thin:@localhost:1521:pb1".

ORA-01017: nome de usuário/senha inválido; logon negado.

● Para Sybase:




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


2. Na janela Explorer, em Acesso a dados > Content Manager, clique com o botão direito do


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.





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.


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



● 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.


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.



um exemplo:


● Se usar um banco de dados DB2, para a propriedade Nome do banco de dados, digite o

alias do banco de dados.





Eis um exemplo:




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.






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.


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.



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



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>


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.


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




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.



● 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.


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.



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.



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.



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.



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



● 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.



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.



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.



É 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®




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.


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



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.


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.



● 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.


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.


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.



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:




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.



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.



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


2. Na janela Explorer, em Segurança, clique com o botão direito do mouse em Autenticação e

clique em Novo recurso > Namespace.




4. Na caixa Tipo, clique em Cognos e depois em OK.

O namespace Cognos é exibido na janela do Explorer.


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.



Para aplicar as novas configurações ao computador, reinicie o serviço do IBM Cognos.

Etapas para reiniciar o serviço do IBM Cognos


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.



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:



● 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:



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.



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.



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:



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.



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..



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.



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


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



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


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


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


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.


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.


Glossário

Índice

AAbrir com o Analysis Studio

descrição do componente, 24

Abrir com o Report Studio


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


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


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


ASCII

requisitos para o diretório de instalação, 389

Assistente de migração


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


Í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


alteração de usuários e senhas, 235

aperfeiçoamento do desempenho, 360


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


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



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


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


Í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


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


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


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


Índice

componentes do servidor, 21

seqüência de instalação, 123

comunicação LDAP segura, 220

conectividade de bancos de dados


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


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


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



conjuntos de codificação

configuração de prioridade para conexões SSL, 263


Í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


definição, 418

definição de um armazenamento de conteúdo, 44,

258


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


criação ativa de scripts


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


Í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


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

e-mail

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


Í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


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



erro de criptografia, 379

função SaferAPIGetTrustedSignon


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


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


Índice

Hhistóricos

implantação, 70

IIBM Cognos Administration


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


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


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



IBM Cognos Controller

acesso a dados no IBM Cognos BI, 35

IBM Cognos Finance


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


IBM Cognos Planning - Contributor


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


IBM CognosScript


IBM Cognos Series 7

ativação do signon único, 203

ativação do SSL, 203


plug-in de signon confiável, 203


IBM Cognos Visualizer


IBM Cognos Web Services


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


Í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


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çõ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


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


instalação

amostras da Grandes Aventuras Ltda., 182

autônoma, 345


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


Í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


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


Java Software Development Kit da IBM, 353

JDBC

conectividade de banco de dados para


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



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


Sun Java System Directory Server, 217


limite de tempo assíncrono, 362

Linux

caracteres corrompidos durante a instalação, 393

caracteres não são exibidos corretamente, 396


Í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


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


Localização dos arquivos de dados


Localização dos arquivos temporários


log

banco de dados, 272

cliente de banco de dados, 268

configuração da segurança, 101, 148

log de eventos do Windows


log do sistema


login

ocultação de namespaces durante, 207, 226

logins de usuário


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


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


Í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


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


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


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


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


Í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


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


NTLM, 227


configuração, 227

NTLM, 227

OOracle

criação de strings de conexões, 102, 140


drivers JDBC de banco de dados, 269

erros de implantação, 411


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


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


Índice


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


PowerCubes do IBM Cognos Series 7


sucedida, 36

PowerPlay Administration, 413

PowerPlay Server, 413

PowerPlay Studio


problemas no portal


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


propriedades


configuração para servidor de aplicativos, 322

local de arquivo temporário, 246

propriedades do ambiente, 101

propriedades personalizadas de usuário


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


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


público-alvo do documento, 13

Qqualidade de proteção em conexões SSL, 263

RRACF


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


teste antes da atualização, 62

Relatórios Web Impromptu


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


Í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


definições para navegadores web, 40

problemas com a Autenticação integrada do

Windows, 407

segurança nativa do Windows (NTLM)



senhas


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


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


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


requisitos, 354

Serviço de relatório em lote


serviço de relatório em lotes, 355

serviço de tarefas realizadas por usuários, 356

serviço de trabalhos, 356


Í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


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


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



autenticação em múltiplos domínios, 199


propriedades avançadas, 199


servidor do IBM Cognos BI

falha na inicialização, 381

servidores


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


configuração, 109, 171, 329


Í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


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


Sun Java System Directory Server


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



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


Índice

instalação, 112

teste da instalação, 151, 161, 174

Tomcat

ajuste, 360


tours rápidos, 13

trabalhos

definição, 420

Transformer



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



variáveis de ambiente, 87, 126, 152, 163

UNIX AIX


URI

alteração, 237


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


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


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


WebSphere Application Server


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


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


XXQE-DS-0006, 409


Índice

YYen japonês



Índice