431
IBM Cognos PowerPlay Versão 10.2.2 Guia de Instalação e Configuração

IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

  • Upload
    others

  • View
    12

  • Download
    0

Embed Size (px)

Citation preview

Page 1: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

IBM Cognos PowerPlayVersão 10.2.2

Guia de Instalação e Configuração

���

Page 2: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

NotaAntes de usar estas informações e o produto suportado por elas, leia as informações em “Avisos” na página 393.

Informações do produto

Este documento se aplica ao IBM Cognos Business Intelligence Versão 10.2.2 e também pode se aplicar às liberaçõessubsequentes.

Licensed Materials - Property of IBM

© Copyright IBM Corporation 2005, 2014.

Page 3: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Índice

Introdução . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi

Capítulo 1. O que há de novo? . . . . . . . . . . . . . . . . . . . . . . . . . . 1Novos recursos na versão 10.2.2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

WebSphere Liberty Profile é o servidor de aplicativos padrão . . . . . . . . . . . . . . . . . . 1opção Instalação Rápida . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Novos Recursos na Versão 10.2.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1Novos Padrões de Segurança no IBM Cognos BI . . . . . . . . . . . . . . . . . . . . . . 1Armazene Relatórios em um Armazenamento de Objeto Externo . . . . . . . . . . . . . . . . . 2

Novos Recursos na Versão 10.2.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2Opção para inicializar o Cognos Configuration a partir de um Arquivo Diferente . . . . . . . . . . . 2Opção para Visualizar o Status das Instalações Silenciosas na Tela . . . . . . . . . . . . . . . . 2Configurações LDAP Predefinidas . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

Novos recursos na versão 10.1.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3Acesso ao guia de instalação e de configuração do Software Development Kit . . . . . . . . . . . . 3

Recursos alterados na versão 10.1.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3Local de instalação padrão e alias da Web . . . . . . . . . . . . . . . . . . . . . . . . 3Administração em Lote do PowerPlay . . . . . . . . . . . . . . . . . . . . . . . . . . 4IBM Cognos Go! Dashboard É Mesclado com Recursos do IBM Cognos Viewer em uma Interface com o Usuário 4Suporte Aprimorado para Autenticação Usando um Provedor RACF . . . . . . . . . . . . . . . 4Acesso seguro ao monitorar as métricas do sistema externamente . . . . . . . . . . . . . . . . 4

Recursos removidos na versão 10.1.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . 4Gerenciando Memória para o Serviço do IBM Cognos . . . . . . . . . . . . . . . . . . . . 4

Capítulo 2. Opções de Distribuição . . . . . . . . . . . . . . . . . . . . . . . . 5Componentes do produto Cognos PowerPlay . . . . . . . . . . . . . . . . . . . . . . . . 5

Componentes do servidor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5Componentes opcionais do servidor . . . . . . . . . . . . . . . . . . . . . . . . . . 8Componentes de migração. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Componentes do cliente . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10Componentes Necessários do Banco de Dados. . . . . . . . . . . . . . . . . . . . . . . 10

Componentes do Cognos Mobile . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11Serviço do Cognos Mobile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12Rich client do IBM Cognos Mobile. . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Distribuição de Componentes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12Todos os Componentes do Servidor em um Computador . . . . . . . . . . . . . . . . . . . 13Gateways em Computadores Separados . . . . . . . . . . . . . . . . . . . . . . . . . 14Componentes da Camada de Aplicativos e Content Managers em Computadores Separados . . . . . . . 15Instalando Versões de 64 Bits de Produtos IBM Cognos BI . . . . . . . . . . . . . . . . . . . 16

Opções de distribuição para o Cognos Mobile . . . . . . . . . . . . . . . . . . . . . . . . 18Componentes do Cognos Mobile instalados em um computador. . . . . . . . . . . . . . . . . 18Componentes do Cognos Mobile instalados em computadores separados . . . . . . . . . . . . . . 18

IBM Cognos PowerPlay com outros Produtos do IBM Cognos . . . . . . . . . . . . . . . . . . 20Produtos IBM Cognos Series 7 que Podem Ser Migrados para o IBM Cognos PowerPlay . . . . . . . . 21Produtos IBM Cognos que Interoperam com o IBM Cognos PowerPlay . . . . . . . . . . . . . . 22Conteúdo do IBM Cognos Series 7 que Pode Ser Recriado no IBM Cognos Business Intelligence . . . . . . 25

Capítulo 3. Preparando para Instalar . . . . . . . . . . . . . . . . . . . . . . . 27Revisando as Notas sobre o Release antes da Instalação . . . . . . . . . . . . . . . . . . . . 27Revise os Ambientes Suportados . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27Verificar Requisitos do Sistema . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Definições de memória . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30Requisitos Java . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32Revisando as Configurações de Porta Padrão para o IBM Cognos Business Intelligence . . . . . . . . . . 33Diretrizes para Criar o Armazenamento de Conteúdo . . . . . . . . . . . . . . . . . . . . . 34

© Copyright IBM Corp. 2005, 2014 iii

Page 4: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Configurações Sugeridas para Criar o Armazenamento de Conteúdo no DB2 Sistemas Operacionais Linux,Windows e UNIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36Configurações Sugeridas para Criar o Armazenamento de Conteúdo no DB2 no z/OS . . . . . . . . . 39Configurações Sugeridas para Criar o Armazenamento de Conteúdo no Oracle. . . . . . . . . . . . 39Configurações Sugeridas para Criar o Armazenamento de Conteúdo no Microsoft SQL Server. . . . . . . 40Configurações sugeridas para criar o armazenamento de conteúdo no servidor de banco de dados IBMInformix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41Configurações Sugeridas para Criar o Armazenamento de Conteúdo no Sybase . . . . . . . . . . . 42

Configuração de uma Conta de Usuário ou Conta de Serviço de Rede para o IBM Cognos Business Intelligence . 43Configuração de navegadores web. . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

Capítulo 4. Atualizar o IBM Cognos Business Intelligence. . . . . . . . . . . . . . 49Processo de Upgrade . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

Revisando a Documentação . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51Aplicativos de Avaliação em seu Ambiente antes do Upgrade . . . . . . . . . . . . . . . . . 51Acessar Conteúdo de uma Versão Anterior no Portal . . . . . . . . . . . . . . . . . . . . 53

Tarefas de Atualização . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53Instalar e Configurar uma Nova Versão do Produto . . . . . . . . . . . . . . . . . . . . . 53Mover Seu Conteúdo para a Nova Versão do Produto . . . . . . . . . . . . . . . . . . . . 56Atualizar seu Armazenamento de Conteúdo . . . . . . . . . . . . . . . . . . . . . . . 57Movendo o Conteúdo com um Arquivo de Implementação . . . . . . . . . . . . . . . . . . 59Atualizar suas Especificações de Relatório . . . . . . . . . . . . . . . . . . . . . . . . 62Usar o Lifecycle Manager para Comparar os Relatórios entre suas Versões do Produto . . . . . . . . . 63

Capítulo 5. Instalação e Configuração dos Componentes do Produto em umComputador . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65Instalar os Componentes do Servidor . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

Instalando Componentes do Servidor nos Sistemas Operacionais UNIX ou Linux . . . . . . . . . . . 67Instalando Componentes do Servidor em Sistemas Operacionais Windows . . . . . . . . . . . . . 69

Instalando fix packs do IBM Cognos . . . . . . . . . . . . . . . . . . . . . . . . . . . 71Instalando a Documentação do Produto Traduzida . . . . . . . . . . . . . . . . . . . . . . 72Configure a conectividade do banco de dados para o banco de dados de armazenamento de conteúdo. . . . . 72

Configurar a Conectividade do Banco de Dados para um Armazenamento de Conteúdo IBM DB2 . . . . . 73Configurar a Conectividade do Banco de Dados para um Armazenamento de Conteúdo Oracle . . . . . . 78Configurar Conectividade do Banco de Dados para um Armazenamento de Conteúdo Informix . . . . . . 78Configurar a Conectividade do Banco de Dados para um Armazenamento de Conteúdo Sybase . . . . . . 79

Configurando o cliente de banco de dados Mobile . . . . . . . . . . . . . . . . . . . . . . 79Configurando o cliente de banco de dados Mobile no Oracle . . . . . . . . . . . . . . . . . . 79Configurando o cliente de banco de dados do Mobile no DB2 . . . . . . . . . . . . . . . . . 80DB2 no z/OS como um banco de dados Móvel . . . . . . . . . . . . . . . . . . . . . . 81

Início do IBM Cognos Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . 83Configurando Propriedades de Ambiente no IBM Cognos Configuration . . . . . . . . . . . . . . . 84Ativação da segurança. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84Definição de propriedades de conexão com o banco de dados para o armazenamento de conteúdo . . . . . . 85

Configurando as Propriedades de Conexão do Banco de Dados para um Armazenamento de Conteúdo DB2 . . 85Configurando as Propriedades de Conexão do Banco de Dados para um Armazenamento de ConteúdoMicrosoft SQL Server, Oracle, Informix ou Sybase . . . . . . . . . . . . . . . . . . . . . 86

Especificação de uma conexão para uma conta do servidor de correio . . . . . . . . . . . . . . . . 88Configurar um Namespace do IBM Cognos Series 7 no IBM Cognos BI . . . . . . . . . . . . . . . 89Inicie os serviços do IBM Cognos . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90Configurando o Servidor da Web . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91

Usar Gateways Compilados para Sistemas de Produção . . . . . . . . . . . . . . . . . . . 91Usar o Gateway CGI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96Configurando o WebDAV para Visualizar e Navegar pelas Imagens . . . . . . . . . . . . . . . 99Configurando o IIS com um tipo MIME para relatórios Ativos que usam JSON . . . . . . . . . . . 101

Teste de instalação e configuração . . . . . . . . . . . . . . . . . . . . . . . . . . . 101Métodos de instalação e configuração de componentes do cliente do IBM Cognos Mobile . . . . . . . . . 102Executando o Cognos Mobile sem um servidor da web . . . . . . . . . . . . . . . . . . . . 102Instalando e Configurando a Migração no IBM Cognos Series 7 . . . . . . . . . . . . . . . . . 103

Instalar Componentes de Migração do IBM Cognos Series 7 . . . . . . . . . . . . . . . . . 103

iv IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 5: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Configurando o Serviço de Migração em um Ambiente Distribuído do IBM Cognos Series 7 . . . . . . . 104Início do Serviço de Migração do IBM Cognos Series 7 . . . . . . . . . . . . . . . . . . . 105

Capítulo 6. Instalação e Configuração dos Componentes do Servidor em DiferentesComputadores . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107Sequência de Instalação para os Componentes do Servidor . . . . . . . . . . . . . . . . . . . 109Recomendação - instale e configure a instalação básica para instalações distribuídas . . . . . . . . . . . 110Instalação e configuração do Content Manager . . . . . . . . . . . . . . . . . . . . . . . 111

Componentes ativo e em espera do Content Manager . . . . . . . . . . . . . . . . . . . . 112Instalar os Componentes do Content Manager . . . . . . . . . . . . . . . . . . . . . . 113Instalando fix packs do IBM Cognos. . . . . . . . . . . . . . . . . . . . . . . . . . 116Configure a conectividade do banco de dados para o banco de dados de armazenamento de conteúdo. . . . 117Início do IBM Cognos Configuration . . . . . . . . . . . . . . . . . . . . . . . . . 124Definição de propriedades de conexão com o banco de dados para o armazenamento de conteúdo. . . . . 124Configuração de propriedades do ambiente para computadores com Content Manager . . . . . . . . . 127Especificação de uma conexão para uma conta do servidor de correio . . . . . . . . . . . . . . 129Ativação da segurança . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130Configurar um Namespace do IBM Cognos Series 7 no IBM Cognos BI . . . . . . . . . . . . . . 131Início do Content Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132Teste da instalação do Content Manager . . . . . . . . . . . . . . . . . . . . . . . . 133

Instalação e configuração do Application Tier Components . . . . . . . . . . . . . . . . . . . 133Instalação do Application Tier Components . . . . . . . . . . . . . . . . . . . . . . . 133Instalando fix packs do IBM Cognos . . . . . . . . . . . . . . . . . . . . . . . . . 137Início do IBM Cognos Configuration . . . . . . . . . . . . . . . . . . . . . . . . . 137Configuração de propriedades do ambiente para computadores com Application Tier Components. . . . . 138Instalação do Application Tier Components . . . . . . . . . . . . . . . . . . . . . . . 139Teste do Application Tier Components . . . . . . . . . . . . . . . . . . . . . . . . . 140Teste o Serviço de Migração do IBM Cognos BI . . . . . . . . . . . . . . . . . . . . . . 140Métodos de instalação e configuração de componentes do cliente do IBM Cognos Mobile . . . . . . . . 141Executando o Cognos Mobile sem um servidor da web . . . . . . . . . . . . . . . . . . . 141

Instalação e configuração do gateway . . . . . . . . . . . . . . . . . . . . . . . . . . 142Instalando os Componentes de Gateway nos Sistemas Operacionais UNIX ou Linux . . . . . . . . . 142Instalando os Componentes de Gateway nos Sistemas Operacionais Windows. . . . . . . . . . . . 144Instalando fix packs do IBM Cognos . . . . . . . . . . . . . . . . . . . . . . . . . 145Início do IBM Cognos Configuration . . . . . . . . . . . . . . . . . . . . . . . . . 146Configuração de propriedades de ambiente e de segurança para computadores de gateway . . . . . . . 147Configurando o Servidor da Web. . . . . . . . . . . . . . . . . . . . . . . . . . . 148Teste do gateway . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159Instalando e Configurando a Migração no IBM Cognos Series 7 . . . . . . . . . . . . . . . . 159

Capítulo 7. Instalando as Amostras do Cognos PowerPlay . . . . . . . . . . . . . 163Criando uma Conexão de Origem de Dados para Amostras do PowerCube . . . . . . . . . . . . . 163Importando as Amostras do Cognos PowerPlay . . . . . . . . . . . . . . . . . . . . . . . 164Testando um Relatório de Amostra . . . . . . . . . . . . . . . . . . . . . . . . . . . 164

Capítulo 8. Configurando Componentes do IBM Cognos para Usar um Provedor deAutenticação . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165Desativação do acesso anônimo . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166Acesso de Usuário Restrito ao Namespace Cognos . . . . . . . . . . . . . . . . . . . . . . 167Configurando Componentes do IBM Cognos para Usar o Active Directory Server . . . . . . . . . . . 167

Configurando um namespace do Active Directory . . . . . . . . . . . . . . . . . . . . . 168Disponibilizando Propriedades de Usuário Customizadas para o Active Directory para Componentes do IBMCognos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170Ativação da comunicação segura para o Servidor do Active Directory . . . . . . . . . . . . . . 170Inclusão ou exclusão de domínios utilizando Propriedades avançadas . . . . . . . . . . . . . . 171Ativar a Conexão Única entre o Active Directory Server e os Componentes do IBM Cognos . . . . . . . 172

Configurando o IBM Cognos para Usar Namespace IBM Cognos Series 7 . . . . . . . . . . . . . . 176Configurando um namespace do IBM Cognos Series 7 . . . . . . . . . . . . . . . . . . . 177Ativando Comunicação Segura para o Servidor de Diretório Usado pelo Namespace IBM Cognos Series 7 . . 178Ativando Conexão Única entre o IBM Cognos Series 7 e o IBM Cognos . . . . . . . . . . . . . . 178

Índice v

Page 6: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Namespaces IBM Cognos Series 7 e o Plug-in de Conexão Confiável do IBM Cognos Series 7 . . . . . . 179Configurando o IBM Cognos para Usar um Provedor de Autenticação Customizada . . . . . . . . . . 181

Configuração de namespaces de autenticação customizada . . . . . . . . . . . . . . . . . . 181Ocultação do namespace dos usuários durante o login . . . . . . . . . . . . . . . . . . . 182

Configurando componentes do IBM Cognos para uso com LDAP . . . . . . . . . . . . . . . . . 182Mapeamento de LDAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183Configurando um Namespace LDAP . . . . . . . . . . . . . . . . . . . . . . . . . 184Configurando um namespace do LDAP para o Active Directory Server . . . . . . . . . . . . . . 185Configurando um namespace LDAP para o IBM Directory Server . . . . . . . . . . . . . . . . 187Configurando um namespace LDAP para o Novell Directory Server . . . . . . . . . . . . . . . 189Configurando um namespace LDAP para o Oracle Directory Server . . . . . . . . . . . . . . . 191Tornar propriedades de usuário customizadas para LDAP disponíveis para componentes do IBM Cognos . . 193Ativando a comunicação segura para o servidor LDAP . . . . . . . . . . . . . . . . . . . 193Ative a conexão única entre o LDAP e componentes IBM Cognos . . . . . . . . . . . . . . . . 195Operação de Substituição . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195

Configure os Componentes do IBM Cognos para Usar o CA SiteMinder. . . . . . . . . . . . . . . 196Configurando o Namespace SiteMinder . . . . . . . . . . . . . . . . . . . . . . . . 197

Configurando o IBM Cognos para Usar um Provedor RACF para Autenticação . . . . . . . . . . . . 199Configurando um Namespace RACF . . . . . . . . . . . . . . . . . . . . . . . . . 199Ativando a Conexão Única entre o RACF e o IBM Cognos . . . . . . . . . . . . . . . . . . 200

Configurando o IBM Cognos para Usar SAP . . . . . . . . . . . . . . . . . . . . . . . . 201Configuração de namespaces SAP . . . . . . . . . . . . . . . . . . . . . . . . . . 202Ativar Conexão Única entre SAP e IBM Cognos . . . . . . . . . . . . . . . . . . . . . . 203

Exclusão de provedores de autenticação . . . . . . . . . . . . . . . . . . . . . . . . . 203

Capítulo 9. Opções de Configuração . . . . . . . . . . . . . . . . . . . . . . 205Início do IBM Cognos Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . 205Alterando a Versão do Java Usada pelos Componentes do IBM Cognos BI . . . . . . . . . . . . . . 206

Fazendo backup de informações existentes do IBM Cognos . . . . . . . . . . . . . . . . . . 206Mude a sua Versão do Java. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207

Alteração de definições de configuração padrão . . . . . . . . . . . . . . . . . . . . . . . 208Alterando Senha e Usuário Padrão para o Banco de Dados de Conteúdo do Cognos . . . . . . . . . 209Configurações de Porta e URI . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211Configuração de definições criptográficas . . . . . . . . . . . . . . . . . . . . . . . . 213IBM Cognos Application Firewall . . . . . . . . . . . . . . . . . . . . . . . . . . 217Criptografia de propriedades de arquivo temporário . . . . . . . . . . . . . . . . . . . . 219Configuração do gateway para usar um namespace . . . . . . . . . . . . . . . . . . . . 220Ativação e desativação de serviços . . . . . . . . . . . . . . . . . . . . . . . . . . 220Configurando Fontes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221Alterar a Fonte Padrão de Relatórios em PDF . . . . . . . . . . . . . . . . . . . . . . 224Configuração de fontes integradas a relatórios em PDF . . . . . . . . . . . . . . . . . . . 224Saída de relatório salvo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225Alterando o Local da Saída de Relatórios Temporários . . . . . . . . . . . . . . . . . . . 227

Ajustando o WebSphere Liberty Profile . . . . . . . . . . . . . . . . . . . . . . . . . . 227Ativando replicação de sessão para serviços do Content Manager em espera . . . . . . . . . . . . . 228Utilize um Armazenamento de Objeto Externo para Saída de Relatório . . . . . . . . . . . . . . . 229

Verifique o Acesso ao Objeto de Armazenamento Externo . . . . . . . . . . . . . . . . . . 230Customizando a Impressão no Lado do Servidor para Plataformas UNIX e Linux . . . . . . . . . . . 230Alterar o Banco de Dados de Notificação . . . . . . . . . . . . . . . . . . . . . . . . . 231

Alterar as propriedades de conexão para o banco de dados de notificação . . . . . . . . . . . . . 232Criando um Novo Armazenamento de Conteúdo Usando Banco de Dados de Conteúdo do Cognos . . . . . 232Mude a Conformidade Padrão de Segurança para os Armazenamentos Confiáveis do IBM Cognos. . . . . . 233

Restaure Certificados Padrão Não NIST SP800-131a para Armazenamentos Confiáveis do IBM Cognos . . . 233Remova Certificados Padrão Não NIST SP800-131a dos Armazenamentos Confiáveis do IBM Cognos . . . . 234

Configurando Componentes do IBM Cognos para Usar Outra Autoridade de Certificação . . . . . . . . . 234Comandos e exemplos de ThirdPartyCertificateTool . . . . . . . . . . . . . . . . . . . . 235Criar Arquivos Certificate Signing Request (CSR) . . . . . . . . . . . . . . . . . . . . . 236Importar os Certificados CA nos Componentes do IBM Cognos . . . . . . . . . . . . . . . . 238Configurar Componentes do IBM Cognos BI para Usar Certificados Gerados pelo CA . . . . . . . . . 240

Configurando o Protocolo SSL para Componentes do IBM Cognos . . . . . . . . . . . . . . . . 240Configurando SSL para componentes do IBM Cognos . . . . . . . . . . . . . . . . . . . . 241

vi IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 7: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Configure a Confiança Compartilhada entre Servidores IBM Cognos e Outros Servidores . . . . . . . . 242Selecionar e Classificar Conjuntos de Cifras para Secure Socket Layer . . . . . . . . . . . . . . 243

Configurar Servidores da Web Ativados pelo IBM Cognos para SSL . . . . . . . . . . . . . . . . 244Usar o protocolo secure sockets layer (SSL) para conexões com o banco de dados no IBM Cognos Configuration 245

Usando SSL para conexões com o banco de dados no IBM Cognos Configuration para um banco de dadosIBM DB2, Informix ou Sybase . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247Usando SSL para conexões com o banco de dados no IBM Cognos Configuration para um banco de dadosOracle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249

Configure conexões da origem de dados JDBC para conexão única usando Kerberos . . . . . . . . . . 251Criando arquivos de inicialização do Kerberos . . . . . . . . . . . . . . . . . . . . . . 251Criando um SPN para o serviço de consulta . . . . . . . . . . . . . . . . . . . . . . . 252Criando um arquivo keytab . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252Configurando o módulo de login do Kerberos . . . . . . . . . . . . . . . . . . . . . . 253Configurando conexões de origem de dados usando o Kerberos . . . . . . . . . . . . . . . . 253

Configurando um Repositório para Mensagens de Log . . . . . . . . . . . . . . . . . . . . 254Diretrizes para Criar um Banco de Dados de Criação de Log . . . . . . . . . . . . . . . . . 255Conectividade do Banco de Dados para o Banco de Dados de Criação de Log. . . . . . . . . . . . 255Repositório de Mensagens de Log . . . . . . . . . . . . . . . . . . . . . . . . . . 257Ativação de conexão específica do usuário . . . . . . . . . . . . . . . . . . . . . . . 262

Alteração de definições globais . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263Personalização do suporte ao idioma na interface com o usuário . . . . . . . . . . . . . . . . 263Personalização do suporte de moeda . . . . . . . . . . . . . . . . . . . . . . . . . 264Customizar Suporte do Código de Idioma do Conteúdo . . . . . . . . . . . . . . . . . . . 265Códigos do idioma do conteúdo . . . . . . . . . . . . . . . . . . . . . . . . . . . 266Mapeamento de códigos do idioma do produto . . . . . . . . . . . . . . . . . . . . . . 268Personalização do fuso horário do servidor . . . . . . . . . . . . . . . . . . . . . . . 269Codificação para E-mails . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269Customizando as configurações de cookie . . . . . . . . . . . . . . . . . . . . . . . . 270

Mudança da versão do endereço IP . . . . . . . . . . . . . . . . . . . . . . . . . . . 271Configurando a Versão IP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272Configurando Manualmente o IBM Cognos Configuration para Iniciar com a Opção IPv6 . . . . . . . . 272Configurando o IBM Cognos Configuration para Sempre Começar com a Opção IPv6 no Windows . . . . 272

Propriedades do Local do Arquivo no Windows Vista . . . . . . . . . . . . . . . . . . . . . 273Atualização das Propriedades de Localização de Arquivos no Windows Vista . . . . . . . . . . . . 273

Alterando Definições de Configuração para o Serviço do IBM Cognos Series 7 Migration . . . . . . . . . 274Incluindo uma Conta do Usuário no PowerPlay e Serviços de Migração para Migração . . . . . . . . . 274

Capítulo 10. Configuração do Portal Services . . . . . . . . . . . . . . . . . . 277Especificação da localização do arquivo applications.xml . . . . . . . . . . . . . . . . . . . . 277Configuração da segurança para o Portal Services . . . . . . . . . . . . . . . . . . . . . . 278

Desativar Acesso Anônimo a Componentes do IBM Cognos . . . . . . . . . . . . . . . . . . 278Ativação de conexão única com Shared secret . . . . . . . . . . . . . . . . . . . . . . 279Ativar Conexão Única com Sharepoint Usando Autenticação do Kerberos . . . . . . . . . . . . . 283Ativando Conexão Única para WebSphere Portal Usando o Servidor de Aplicativos . . . . . . . . . . 286Ativação de conexão única para o portal Oracle WebCenter Interaction Portal usando autenticação básica . . 287Ative a conexão única para o Portal Oracle WebCenter Interaction Usando CA SiteMinder . . . . . . . 287

Capítulo 11. Implementar IBM Cognos em outro servidor de aplicativos . . . . . . . 289Criar uma Instância JVM Separada . . . . . . . . . . . . . . . . . . . . . . . . . . . 289

Configurar Parâmetros JVM para Desempenho . . . . . . . . . . . . . . . . . . . . . . 289Verificar a Configuração de Componentes IBM Cognos . . . . . . . . . . . . . . . . . . . . 290Fazendo backup de informações existentes do IBM Cognos . . . . . . . . . . . . . . . . . . . 290Configurar Variáveis de Ambiente . . . . . . . . . . . . . . . . . . . . . . . . . . . 292Ajustando o Valor de Tempo Limite de Conexão Padrão para IBM Cognos Business Intelligence . . . . . . 293Configurando componentes do IBM Cognos para execução dentro do servidor de aplicativos . . . . . . . 293

Use o Assistente para Construção de Aplicativo para construir e instalar o IBM Cognos no IBM WebSphereApplication Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295

Identificando o JDK para WebLogic 9 no AIX. . . . . . . . . . . . . . . . . . . . . . . . 297Alterar o Script de Inicialização do Servidor de Aplicativos . . . . . . . . . . . . . . . . . . . 297

Alterando o script de inicialização do servidor de aplicativos para WebLogic . . . . . . . . . . . . 297

Índice vii

Page 8: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Alterar o Script de Inicialização do Servidor de Aplicativos para JBoss . . . . . . . . . . . . . . 298Configurar Propriedades do Servidor de Aplicativos e Instalar Componentes IBM Cognos . . . . . . . . 298

Instalar o IBM Cognos no WebSphere . . . . . . . . . . . . . . . . . . . . . . . . . 299Instalando o IBM Cognos no WebLogic. . . . . . . . . . . . . . . . . . . . . . . . . 300Instalando o IBM Cognos no SAP NetWeaver . . . . . . . . . . . . . . . . . . . . . . 301Instalar o IBM Cognos no JBoss . . . . . . . . . . . . . . . . . . . . . . . . . . . 302

Ativando o Secure Socket Layer . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303Configurando Comunicação da Web. . . . . . . . . . . . . . . . . . . . . . . . . . . 304

Configurar Diretório Virtual para SAP NetWeaver . . . . . . . . . . . . . . . . . . . . . 304Cancelando o registro de dispatchers que foram configurados para o servidor de aplicativos padrão . . . . . 305Upgrade para IBM Cognos BI em um Ambiente de Servidor de Aplicativos . . . . . . . . . . . . . 305

Capítulo 12. Usando instalação e configuração não assistidas . . . . . . . . . . . 307Instalações Não Assistidas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307

Usar um Arquivo de Resposta a partir de uma Instalação em Outro Computador . . . . . . . . . . 308Modificando um Arquivo de Resposta . . . . . . . . . . . . . . . . . . . . . . . . . 309Iniciando uma Instalação não Assistida . . . . . . . . . . . . . . . . . . . . . . . . . 310

Usar uma Configuração Não Assistida . . . . . . . . . . . . . . . . . . . . . . . . . . 311Use uma Desinstalação Não Assistida . . . . . . . . . . . . . . . . . . . . . . . . . . 312

Capítulo 13. Manutenção do desempenho . . . . . . . . . . . . . . . . . . . . 313Métricas de desempenho do sistema. . . . . . . . . . . . . . . . . . . . . . . . . . . 313

Monitoramento das métricas do sistema externamente. . . . . . . . . . . . . . . . . . . . 313Ativação apenas de serviços obrigatórios . . . . . . . . . . . . . . . . . . . . . . . . . 314Ajustando um Armazenamento de Conteúdo do DB2 . . . . . . . . . . . . . . . . . . . . . 318Ajustando os recursos de memória para o serviço do IBM Cognos . . . . . . . . . . . . . . . . 318Reduzindo o Número de Solicitações por Processo . . . . . . . . . . . . . . . . . . . . . . 319Aumentando a Capacidade de Manipulação de Solicitações para o Banco de Dados de Conteúdo do Cognos . . 319Desempenho do IBM Cognos Mobile . . . . . . . . . . . . . . . . . . . . . . . . . . 320

Estimar a largura da banda requerida pelo IBM Cognos Mobile . . . . . . . . . . . . . . . . 320Estimar o número necessário de servidores . . . . . . . . . . . . . . . . . . . . . . . 320Estimando o tamanho de um relatório . . . . . . . . . . . . . . . . . . . . . . . . . 321

Melhoria do desempenho do banco de dados de armazenamento de métricas . . . . . . . . . . . . . 321Redução do tempo de entrega para relatórios em uma rede . . . . . . . . . . . . . . . . . . . 322Aumento do limite de tempo assíncrono em ambiente de carregamento de uso intenso. . . . . . . . . . 322

Capítulo 14. Configurando Manualmente o IBM Cognos Business Intelligence nosSistemas Operacionais UNIX e Linux . . . . . . . . . . . . . . . . . . . . . . 323Alterar Manualmente Definições de Configuração Padrão . . . . . . . . . . . . . . . . . . . 323Incluindo um Componente em Sua Configuração . . . . . . . . . . . . . . . . . . . . . . 324Alterando as Configurações Criptografadas Manualmente . . . . . . . . . . . . . . . . . . . 325Configurações Globais em Sistemas Operacionais UNIX e Linux . . . . . . . . . . . . . . . . . 326

Alterando Manualmente as Configurações Globais nos Sistemas Operacionais UNIX e Linux . . . . . . . 327Iniciando e Parando o Cognos BI em Modo Silencioso em Sistemas Operacionais UNIX e Linux. . . . . . . 328

Iniciando o Cognos BI em Modo Silencioso em Sistemas Operacionais UNIX e Linux . . . . . . . . . 328Parando o Cognos BI em Modo Silencioso em Sistemas Operacionais UNIX e Linux . . . . . . . . . 329

Criar Manualmente um Arquivo de Aplicativo IBM Cognos . . . . . . . . . . . . . . . . . . . 329Criando Arquivo de Aplicativo IBM Cognos para o Software Business Intelligence . . . . . . . . . . 330Criando Arquivo de Aplicativo IBM Cognos para um Gateway de Servlet . . . . . . . . . . . . . 331

Capítulo 15. Desinstalando o IBM Cognos BI . . . . . . . . . . . . . . . . . . . 333Desinstalar o IBM Cognos Business Intelligence nos Sistemas Operacionais UNIX ou Linux . . . . . . . . 333Desinstale o IBM Cognos Business Intelligence em Sistemas Operacionais Windows . . . . . . . . . . . 334

Apêndice A. Recursos de Acessibilidade . . . . . . . . . . . . . . . . . . . . 337Atalhos de teclado do assistente de instalação . . . . . . . . . . . . . . . . . . . . . . . 337

viii IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 9: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Apêndice B. Opções da Linha de Comandos do IBM Cognos Configuration . . . . . 339

Apêndice C. Resolução de problemas . . . . . . . . . . . . . . . . . . . . . . 341Resolvendo um Problema . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341

Procurando em Bases de Conhecimento . . . . . . . . . . . . . . . . . . . . . . . . 343Obtendo Correções . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344Entrando em Contato com o Suporte IBM . . . . . . . . . . . . . . . . . . . . . . . . 344Trocando Informações com a IBM . . . . . . . . . . . . . . . . . . . . . . . . . . 345Assinando Atualizações de Suporte . . . . . . . . . . . . . . . . . . . . . . . . . . 346

Arquivos de log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348Não é Possível Executar issetup em Sistemas Operacionais Linux . . . . . . . . . . . . . . . . . 350Problemas ao Iniciar o IBM Cognos Business Intelligence. . . . . . . . . . . . . . . . . . . . 350

CFG-ERR-0106 Erro ao Iniciar o Serviço do IBM Cognos no IBM Cognos Configuration . . . . . . . . 351Erro Criptográfico ao Iniciar o IBM Cognos Business Intelligence . . . . . . . . . . . . . . . . 353Não É Possível Iniciar o Serviço do IBM Cognos Porque a Porta Está Sendo Usada por Outro Processo . . . 353O Serviço do IBM Cognos não Inicia ou Falha após Iniciar . . . . . . . . . . . . . . . . . . 354Servidor IBM Cognos Business Intelligence Falha ao Iniciar e Não Fornece Mensagem de Erro . . . . . . 355Servidor Não Disponível ao Iniciar o IBM Cognos Business Intelligence . . . . . . . . . . . . . . 355Não É Possível Efetuar Logon em um Namespace ao Usar o IBM Cognos Connection . . . . . . . . . 358Os Serviços do IBM Cognos Falham ao Reiniciar após uma Indisponibilidade da Rede . . . . . . . . . 358Nenhum aviso de que a instalação da versão mais recente atualizará automaticamente a versão mais antigado armazenamento de conteúdo . . . . . . . . . . . . . . . . . . . . . . . . . . . 359Falha no Download do Recurso . . . . . . . . . . . . . . . . . . . . . . . . . . . 359DB2 Retorna Erro SQL1224N ao se Conectar do AIX . . . . . . . . . . . . . . . . . . . . 359Erro do Content Manager ao Iniciar o IBM Cognos Business Intelligence . . . . . . . . . . . . . 360Content Manager Falha ao Iniciar ou Leva Muito Tempo para Iniciar. . . . . . . . . . . . . . . 360Erro DPR-ERR-2014 no arquivo de log no computador com Content Manager . . . . . . . . . . . . 361Caracteres Não ASCII no Diretório de Instalação Causam Erros de Tempo de Execução . . . . . . . . 362Não É Possível Abrir um Microsoft Cube ou PowerCube . . . . . . . . . . . . . . . . . . . 362A Página não Pode Ser Localizada ao Iniciar o IBM Cognos Business Intelligence no Windows 2003 . . . . 363A página não é mostrada ao abrir um portal após instalar o IBM Cognos Business Intelligence . . . . . . 364DPR-ERR-2058 Erro Exibido no Navegador da Web ao Iniciar o IBM Cognos Business Intelligence . . . . . 364DPR-ERR-2022 Erro Exibido no Navegador da Web ao Iniciar o IBM Cognos Business Intelligence . . . . . 366Caracteres Corrompidos na Instalação de alguns Idiomas no Linux . . . . . . . . . . . . . . . 366Não É Possível Fazer o Download do Arquivo cognos.xts . . . . . . . . . . . . . . . . . . 367Falha do Script de Inicialização do Servidor de Aplicativos . . . . . . . . . . . . . . . . . . 367O IBM Cognos Business Intelligence Falha em Execução no WebLogic Application Server no AIX . . . . . 367Falha na Implementação do IBM Cognos Business Intelligence IBM WebSphere Application Server. . . . . 368Não é possível desserializar o erro de atributo de contexto ao implementar o arquivo p2pd.war no WebLogic 368Exibido Erro após a Atualização do IBM Cognos Business Intelligence em um WebLogic Application Server 368Caracteres Chineses, Japoneses ou Coreanos Ficam Diferentes após a Atualização . . . . . . . . . . 369Caracteres Acentuados ou de Byte Duplo Podem Não Ser Exibidos Corretamente ao Instalar o IBM CognosBusiness Intelligence no Linux. . . . . . . . . . . . . . . . . . . . . . . . . . . . 370Erros "RSV-SRV-0066 Uma Falha de SOAP Foi Retornada" ou "RQP-DEF-0114 O Usuário Cancelou aSolicitação" São Exibidos em Ambientes de Alta Carga de Usuários . . . . . . . . . . . . . . . 370Não é Possível Iniciar o Serviço IBM Cognos ao Atualizar Instalações Multitenant . . . . . . . . . . 370

Definições de configuração de serviço do IBM Cognos Mobile são reconfiguradas ao padrão após a atualização 371As tabelas do banco de dados do Cognos Mobile não são criadas . . . . . . . . . . . . . . . . . 371O IBM Cognos Mobile falha ao conectar-se com o banco de dados . . . . . . . . . . . . . . . . 371Alterar o gateway padrão o redireciona caso não esteja usando o gateway CGI . . . . . . . . . . . . 372Problemas ao Configurar o IBM Cognos Business Intelligence . . . . . . . . . . . . . . . . . . 372

Executando Scripts de Limpeza do Banco de Dados e de Índice . . . . . . . . . . . . . . . . 373Erro ao Tentar Criptografar Informações ao Salvar sua Configuração . . . . . . . . . . . . . . . 376CAM-CRP-1315 Erro ao salvar configuração . . . . . . . . . . . . . . . . . . . . . . . 377CAM-CRP-0221 Erro ao Efetuar Login no Portal. . . . . . . . . . . . . . . . . . . . . . 377Alterar Manualmente o Nome do Diretório de Instalação Afeta Instalações em Execução em um Servidor deAplicativos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378Os Dados de Configuração estão Bloqueados por Outra Instância do IBM Cognos Configuration . . . . . 379Não é Possível Sair de uma Sequência de Tabs Usando Somente a Navegação pelo Teclado no IBM CognosConfiguration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379Não É Possível Salvar sua Configuração . . . . . . . . . . . . . . . . . . . . . . . . 379

Índice ix

Page 10: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Erro do Java ao Iniciar o IBM Cognos Configuration . . . . . . . . . . . . . . . . . . . . 380Erro Criptográfico ao Iniciar o IBM Cognos Configuration . . . . . . . . . . . . . . . . . . 380Reinício do Serviço do IBM Cognos para Aplicação das Definições de Configuração. . . . . . . . . . 381Teste do servidor de correio SMTP falha em computadores Windows 7 . . . . . . . . . . . . . . 381CM-CFG-029 Erro ao Tentar Salvar uma Configuração que Especifica Armazenamento de Conteúdo doMicrosoft SQL Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 381Erro DB2 não Localizado para Linux no System z . . . . . . . . . . . . . . . . . . . . . 382DPR-ERR-2079 Quando o Content Manager Está Configurado para Failover . . . . . . . . . . . . 382Falha ao Importar um Grande Armazenamento de Conteúdo no Solaris Usando o JRE 1.5 . . . . . . . 382A Importação de uma Grande Implementação no Windows Trava a Java Virtual Machine . . . . . . . . 383Erro DPR-ERR-2008 Ao Abrir um Relatório . . . . . . . . . . . . . . . . . . . . . . . 383Não é Possível Carregar o TM1 Cubeviewer ou WebSheet iWidget no Business Insight . . . . . . . . . 383Usuários Devem Fornecer Credenciais do Active Directory . . . . . . . . . . . . . . . . . . 384A Fonte do UNIX não foi Localizada ao Iniciar o IBM Cognos Configuration . . . . . . . . . . . . 384ESSBASEPATH Não Pode Ser Detectado . . . . . . . . . . . . . . . . . . . . . . . . 385Falha na Consulta ao Usar o Servidor Oracle Essbase . . . . . . . . . . . . . . . . . . . . 385Associação ao Grupo Ausente do Namespace do Active Directory . . . . . . . . . . . . . . . . 386Erros Exibidos ao Implementar no Oracle 10G Application Server . . . . . . . . . . . . . . . . 387Erro de Tempo Limite do CGI durante a Conexão com o IBM Cognos Business Intelligence por meio de umNavegador da Web . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388Falha da Classe de Servlet ao Carregar no WebLogic . . . . . . . . . . . . . . . . . . . . 389Ícones de Área de Trabalho ou da Janela do IBM Cognos Configuration Cintilam no Windows . . . . . . 390A migração não funciona . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 390Traduções Ausentes para Nomes de Objetos em alguns Códigos de Idioma . . . . . . . . . . . . 391

Avisos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393

Glossário . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397B . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398D . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400E . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400F . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401G . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401H . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401I. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401L . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402M . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402N . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403O . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403P . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403R . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404S . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405T . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405U . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406V . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406W . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406

Índice Remissivo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407

x IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 11: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Introdução

Este guia contém instruções para instalar, atualizar, configurar e testar o IBM®

Cognos PowerPlay.

Para obter informações sobre a migração e as diferenças entre o IBM CognosSeries 7 PowerPlay e o IBM Cognos PowerPlay, consulte o Guia de Migração eAdministração do IBM Cognos PowerPlay.

Público-alvo

Para utilizar esse guia, é preciso estar familiarizado comv IBM Cognos Series 7 PowerPlayv a instalação do software em um sistema operacional Microsoft Windows ou

UNIXv Sua tecnologia da informações e infra-estrutura de segurança.v Administração de banco de dados, servidor de diretórios e servidor de

aplicativos.

Localizando Informações

Para localizar a documentação do produto na web, incluindo toda a documentaçãotraduzida, acesse IBM Knowledge Center (http://www.ibm.com/support/knowledgecenter). As Notas sobre a Liberação são publicadas diretamente no IBMKnowledge Center e incluem links para as mais recentes notas técnicas e APARs.

Também é possível ler versões em PDF dos arquivos de ajuda online do produtoclicando nos links em PDF na parte superior de cada página HTML ou acessar osPDFs na página da web de documentação do produto IBM Cognos(www.ibm.com/support/docview.wss?uid=swg27042003).

Recursos de acessibilidade

Os recursos de acessibilidade ajudam usuários com alguma deficiência, comomobilidade reduzida ou visão limitada, a utilizar produtos de tecnologia dainformações. Este produto possui recursos de acessibilidade. Para obterinformações sobre esses recursos, consulte “Atalhos de teclado do assistente deinstalação” na página 337.

A documentação HTML do IBM Cognos possui recursos de acessibilidade. Osdocumentos PDF são complementares e, como tal, não incluem recursos deacessibilidade adicionais.

Instruções para Procura de Versões Futuras

Esta documentação descreve a funcionalidade atual do produto. Referências a itensque não estão disponíveis atualmente podem estar incluídas. Não se deve inferirimplicações de qualquer disponibilidade futura. Tais referências não representamum compromisso, uma promessa ou uma obrigação legal de entrega de qualquermaterial, código ou funcionalidade. O desenvolvimento, a liberação e asincronização de recursos ou funcionalidade ficam ao arbítrio exclusivo da IBM.

© Copyright IBM Corp. 2005, 2014 xi

Page 12: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Renúncia de Responsabilidade de Amostras

A Companhia de Aventuras de Amostra, a Companhia de Aventuras de Amostra, aVendas GA, qualquer variação dos nomes Aventuras ou Grandes Aventuras e aAmostra de Planejamento representam operações de negócios fictícias com dadosde amostra usados para desenvolver aplicativos de amostra para a IBM e para osclientes IBM. Estes registros fictícios incluem dados de amostra para transações devendas, distribuição de produtos, finanças e recursos humanos. Qualquersemelhança com nomes, endereços, números de contato ou valores de transação écoincidência. Outros arquivos de amostra podem conter dados fictícios geradosmanualmente ou por máquina, dados reais compilados de origens acadêmicas oupúblicas ou dados usados com permissão do portador do copyright, para seremusados como dados de amostra para o desenvolvimento de aplicativos de amostra.Os nomes de produtos referidos podem ser marcas registradas de seus respectivosproprietários. A cópia não autorizada é proibida.

xii IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 13: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Capítulo 1. O que há de novo?

Esta seção contém uma lista de recursos novos, alterados e removidos para estaliberação. A seção auxiliará no planejamento de estratégias de implantação deaplicativos e atualizações e de solicitações de treinamento dos usuários.

Para revisar uma lista atualizada de ambientes suportados pelos produtos IBMCognos Business Intelligence, incluindo informações sobre sistemas operacionais,correções, navegadores, servidores da web, servidores de diretórios, servidores debanco de dados e servidores de aplicativos, consulte a página Relatórios deCompatibilidade de Produto IBM Software (www.ibm.com/support/docview.wss?uid=swg27042164).

Novos recursos na versão 10.2.2Os tópicos a seguir descrevem os novos recursos para 10.2.2.

WebSphere Liberty Profile é o servidor de aplicativos padrãoO IBM Cognos Business Intelligence agora instala um WebSphere Liberty Profilecomo o servidor de aplicativos padrão. O Apache Tomcat não é mais instaladocomo o servidor de aplicativos padrão com o IBM Cognos BI.

O WebSphere Liberty Profile usa os mesmos números de porta padrão que foramusados para o servidor do Apache Tomcat. Por exemplo, o número de portapadrão 9300 também é usado para o WebSphere Liberty Profile.

opção Instalação RápidaA opção Instalação Rápida instala todos os componentes (camada do aplicativo,gateway, Content Manager), instala e configura um gateway de servlet, instala econfigura o IBM DB2 Advanced Workgroup Server Edition como o banco de dadosde armazenamento de conteúdo, preenche as informações de configuração doContent Manager no Cognos Configuration, configura um conjunto de dadospessoais e inicia todos os serviços.

Esta opção está disponível apenas para Microsoft Windows de 64 bits e apenas seo DB2 não estiver instalado ainda.

Novos Recursos na Versão 10.2.1Os tópicos a seguir descrevem os novos recursos da 10.2.1.

Novos Padrões de Segurança no IBM Cognos BIPor padrão, o IBM Cognos versão 10.2.1 é qualificado para o padrão NISTSP800-131a à medida que as funções criptográficas do produto são configuradaspara esse padrão.

Você pode configurar o IBM Cognos BI para conformidade com outros padrões ouremover componentes criptográficos que são associados com padrões mais antigosutilizando o ThirdPartyCertificateTool.

© Copyright IBM Corp. 2005, 2014 1

Page 14: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Para obter informações adicionais, consulte “Mude a Conformidade Padrão deSegurança para os Armazenamentos Confiáveis do IBM Cognos” na página 233.

Armazene Relatórios em um Armazenamento de ObjetoExterno

Você pode configurar o Content Manager para armazenamento de saída dorelatório para uma unidade local ou compartilhamento de rede em vez de nobanco de dados de armazenamento de conteúdo configurando um objeto externo.

Um armazenamento de objeto externo oferece desempenho de leitura e gravaçãomelhorado ao reduzir o carregamento no Content Manager.Tarefas relacionadas:“Utilize um Armazenamento de Objeto Externo para Saída de Relatório” na página229Você pode configurar o Content Manager para armazenamento de saída dorelatório para uma unidade local ou compartilhamento de rede definindo umarmazenamento de objeto externo. A saída de relatório está disponível por meio doIBM Cognos Connection e IBM Cognos SDK, mas a saída de relatório não éarmazenada no banco de dados de armazenamento de conteúdo.

Novos Recursos na Versão 10.2.0Os novos recursos estão listados desde a última liberação. Foram incluídos linkspara os tópicos diretamente relacionados.

Opção para inicializar o Cognos Configuration a partir de umArquivo Diferente

É possível usar a opção -startupfile path/filename.xml para especificar umarquivo de inicialização que não seja o arquivo cogstartup.xml ao iniciar aferramenta de configuração IBM Cognos.

O arquivo cogstartup.xml ainda deve existir no diretório de Configuração.

Por exemplo, o comando a seguir executa o programa de instalação no modosilencioso usando o arquivo test.xml localizado no diretório de Configuração paraconfigurar os parâmetros de configuração.

cogconfig.sh -s -startupfile <c10_location>/configuration/test.xml

Tarefas relacionadas:“Usar uma Configuração Não Assistida” na página 311Para usar uma configuração não assistida, você deve exportar uma configuração apartir de uma instalação existente que possua os mesmos componentes IBMCognos BI instalados. É possível então executar o IBM Cognos Configuration nomodo silencioso.

Opção para Visualizar o Status das Instalações Silenciosas naTela

É possível usar a opção -displayLog para visualizar o status da instalaçãosilenciosa na tela em um ambiente UNIX ou Linux.

2 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 15: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Por exemplo, o comando a seguir executa o programa de instalação no modosilencioso. O programa de instalação usa o test.ats como o arquivo de resposta eexibe o status da instalação na tela.

./issetup -s test.ats -displayLog

Tarefas relacionadas:“Modificando um Arquivo de Resposta” na página 309Gere e modifique um arquivo de resposta para especificar e registrar suaspreferências de instalação. É possível modificar o modelo do arquivo de respostafornecido.

Configurações LDAP PredefinidasNo IBM Cognos Configuration, é possível configurar o seu ambiente selecionandoa partir de diversas configurações de namespace de autenticação LDAPpredefinida.

A seguir está uma lista de configurações LDAP predefinidas:v LDAP - Active Directoryv LDAP - IBM Tivoliv LDAP - OracleSunOne

Novos recursos na versão 10.1.0Os novos recursos estão listados desde a última liberação. Foram incluídos linkspara os tópicos diretamente relacionados.

Acesso ao guia de instalação e de configuração do SoftwareDevelopment Kit

Na Versão 10.1.0, o Guia de Instalação e Configuração do IBM Cognos SoftwareDevelopment Kit está disponível no Centro de Informações do IBM Cognos

O Centro de Informações do IBM Cognos está localizado no http://pic.dhe.ibm.com/infocenter/cogic/v1r0m0/index.jsp.

Recursos alterados na versão 10.1.0As mudanças nos recursos estão listadas desde a última liberação. Foram incluídoslinks para os tópicos diretamente relacionados.

Local de instalação padrão e alias da WebO caminho para o diretório de instalação padrão foi alterado no IBM CognosBusiness Intelligence, Versão 10.1.0.

O local padrão, representado por c10_location neste guia, é o seguinte:v Sistema operacional Microsoft Windows

C:\Program Files\IBM\cognos\c10

v Sistemas operacionais UNIX e Linux/usr/IBM/cognos/c10

O alias da Web padrão no IBM Cognos Configuration foi alterado de cognos8 paraibmcognos.

Capítulo 1. O que há de novo? 3

Page 16: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Administração em Lote do PowerPlayNo release anterior, o utilitário Administração em Lote do IBM Cognos PowerPlayestava disponível somente como um download separado. Para este release, outilitário está incluído na instalação do PowerPlay.

Para obter informações adicionais sobre o utilitário, consulte o Guia de Migração eAdministração do PowerPlay.

IBM Cognos Go! Dashboard É Mesclado com Recursos doIBM Cognos Viewer em uma Interface com o Usuário

Em releases anteriores, um aplicativo de painel interativo estava disponívelmediante a instalação do IBM Cognos Go! Dashboard com seu produto do servidorIBM Cognos BI. Além disso, o IBM Cognos Viewer fornecia uma experiência deconsumo de relatório básica.

IBM Cognos Go! Dashboard e os recursos do IBM Cognos Viewer agora estãomesclados em uma única interface com o usuário. Isso traz o consumo deinformações para a linha de frente da experiência, em vez da exibição e daabertura de pastas. No entanto, o IBM Cognos Viewer ainda está disponível e émantido neste release.

Suporte Aprimorado para Autenticação Usando um ProvedorRACF

Em liberações anteriores, se você desejasse usar um provedor Resource AccessControl Facility (RACF) para autenticação com o servidor IBM Cognos BusinessIntelligence, criaria um provedor Java™ customizado e, em seguida, configurariaum namespace do Custom Java Provider no IBM Cognos Configuration parausá-lo. No servidor IBM Cognos Business Intelligence, Versão 10.1.0, é possívelconfigurar um namespace RACF diretamente no IBM Cognos Configuration nossistemas operacionais AIX ou Linux para System z.

Acesso seguro ao monitorar as métricas do sistemaexternamente

Em releases anteriores, era possível monitorar métricas do sistema externamentepara o IBM Cognos Administration usando Java Management Extensions (JMX),uma tecnologia que fornece ferramentas para gerenciar e monitorar aplicativos eredes orientadas a serviços. No IBM Cognos Business Intelligence Server, Versão10.1.0, o IBM Cognos Configuration fornece duas novas propriedades que podemser usadas para ativar o acesso seguro às métricas no ambiente Java.

Recursos removidos na versão 10.1.0Os recursos removidos desde a última liberação estão listados. Foram incluídoslinks para os tópicos diretamente relacionados.

Gerenciando Memória para o Serviço do IBM CognosEm releases anteriores, você tinha duas opções no IBM Cognos Configuration paraconfigurar a quantidade máxima de memória para o serviço do IBM Cognos. Erapossível ajustar o valor de memória máximo ou excluir o serviço do Cognos eselecionar um novo serviço que usasse um modelo de configuração pequeno,médio ou grande. No servidor IBM Cognos BI, Versão 10.1.0, você tem a opçãoúnica de ajustar o valor de memória máximo.

4 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 17: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Capítulo 2. Opções de Distribuição

Antes de implementar o IBM Cognos PowerPlay, decida como irá instalá-lo em seuambiente. É possível instalar todos os componentes do PowerPlay em umcomputador ou distribuí-los por uma rede. A melhor opção de distribuiçãodepende das exigências para relatórios ou scorecards, recursos e preferências. Asexigências de configuração diferem dependendo se todos os componentes sãoinstalados em um computador ou em mais de um computador.

O IBM Cognos PowerPlay é compatível com outros produtos IBM Cognos. Se seuambiente incluir outros produtos IBM Cognos, você deverá considerar como o IBMCognos PowerPlay se ajustará nesse ambiente.

Para algumas instalações distribuídas que incluem os componentes do IBM CognosPowerPlay e do IBM Cognos BI, você deve concluir tarefas adicionais no IBMCognos Administration após concluir a instalação e a configuração. Para obterinformações sobre as tarefas de administração necessárias, consulte a publicaçãoIBM Cognos PowerPlay Migration and Administration Guide.

Componentes do produto Cognos PowerPlayO IBM Cognos PowerPlay é uma solução de inteligência de negócios baseada naweb com recursos de relatório integrado e exploração de dados.

O IBM Cognos PowerPlay integra-se facilmente em sua infraestrutura existenteusando recursos que estão em seu ambiente. Alguns desses recursos existentes sãonecessá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 paraautenticação ou utilizar um servidor de aplicativos.

Por padrão, IBM Cognos BI usa WebSphere Application Server Liberty Profilecomo servidor de aplicativos. É possível configurar produtos IBM Cognos BI paraexecução em outros servidores de aplicativos que você usa atualmente em seuambiente.

Componentes do servidorOs componentes do servidor para o IBM Cognos Business Intelligence sãoseparados em três camadas.

Os componentes do servidor fornecem ao usuário interfaces para relatórios eexploração de dados, assim como funcionalidades para encaminhar e processarsolicitações de usuários.

No programa de instalação, selecione os seguintes componentes do servidor:v Gatewayv Componentes da Camada de Aplicativosv Content Manager

© Copyright IBM Corp. 2005, 2014 5

Page 18: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Comunicação web - gatewayA comunicação da Web no IBM Cognos Business Intelligence é geralmente feitaatravés de gateways, que residem em um ou mais servidores da Web. O gateway éuma extensão de um programa de servidor web que transfere informações desseservidor 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.

Componentes da camada de aplicativosAs camadas do aplicativo IBM Cognos Business Intelligence contêm um ou maisservidores IBM Cognos BI. Um servidor IBM Cognos BI executa solicitações, comorelatórios, análises e consultas que são encaminhados por um gateway. Umservidor IBM Cognos BI também renderiza o IBM Cognos Connection e asinterfaces de studio.

Configurando e Gerenciando o Produto - IBM Cognos Configuration

O IBM Cognos Configuration é uma ferramenta usada para configurar o IBMCognos BI e para iniciar e parar seus serviços.

Publicando, Gerenciando e Visualizando Conteúdo - IBM CognosConnection

O IBM Cognos Connection é um portal da web fornecido com o IBM CognosBusiness Intelligence, que oferece um ponto de acesso único aos dadoscorporativos disponíveis para seus produtos. Ele fornece um ponto único deentrada para consultas, análises e organização de dados, e para a criação derelatórios, scorecards e eventos. Os usuários podem executar seus aplicativos doIBM Cognos BI baseados na Web por meio do IBM Cognos Connection. Outrosaplicativos de Business Intelligence e endereços da Web para outros aplicativospodem ser integrados com o IBM Cognos Connection.

Administração Central - IBM Cognos Administration

O IBM Cognos Administration é uma interface de gerenciamento central quecontém as tarefas administrativas do IBM Cognos BI. Ela fornece fácil acesso aogerenciamento geral do ambiente do IBM Cognos e é acessível pelo IBM CognosConnection.

O IBM Cognos Administration também fornece acesso ao cubo e configurações derelatório para o PowerPlay.

IBM Cognos PowerPlay Studio

O IBM Cognos PowerPlay Studio permite que os usuários visualizem, explorem edistribuam relatórios usando um navegador da web.

Visualização e Interação com o Conteúdo Publicado - Cognos Viewer

O Cognos Viewer é um portlet no qual é possível visualizar e interagir comqualquer tipo de conteúdo publicado do IBM Cognos. Ele é acessível pelo IBMCognos Connection e por qualquer Enterprise Portal existente.

6 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 19: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Exploração, análise e comparação de dados de dimensão - AnalysisStudio

No Analysis Studio, os usuários podem explorar, analisar e comparar dados dedimensão. O Analysis Studio fornece acesso a origens de dados de dimensão,OLAP (processamento on-line analítico) e relacionais modeladas dimensionalmente.As análise criadas no Analysis Studio podem ser abertas no Report Studio e usadaspara criar relatórios profissionais.

Facilitando a Tomada de Decisão - IBM Cognos Workspace

É possível criar áreas de trabalho interativas sofisticadas usando o conteúdo doIBM Cognos, bem como origens de dados externas como TM1 Websheets eCubeViews, de acordo com suas necessidades de informações específicas. Épossível visualizar e abrir áreas de trabalho e relatórios favoritos, manipular oconteúdo e enviar provas por email. Também é possível usar os comentários eatividades para tomar decisões de maneira colaborativa.

IBM Cognos Mobile

O IBM Cognos Mobile estende o IBM Cognos Business Intelligence e ogerenciamento de desempenho a dispositivos móveis. Com seu rich client, oCognos Mobile permite que os usuários visualizem em seus dispositivos, relatórios,áreas de trabalho e análises do Cognos BI produzidos por ferramentas comoReport Studio, Query Studio, Analysis Studio e Cognos Workspace. O CognosMobile fornece informações oportunas, esclarecedoras e interativas para suportarusuários móveis em seus processos de tomada de decisão, independentemente deonde os usuários estão localizados.

O Cognos Mobile processa cada relatório Cognos BI que ele recebe e o renderizaem uma versão apropriada ao usuário remoto.

O Cognos Mobile usa a funcionalidade de prompts do Cognos BI e os mecanismosde planejamento para fornecer relatórios customizados de maneira oportuna. Paraobter mais informações sobre prompts, consulte o IBM Cognos Report Studio UserGuide. Para obter mais informações sobre planejamentos, consulte o IBM CognosBusiness Intelligence Administration and Security Guide.

O Cognos Mobile usa a segurança do Cognos BI, implementa medidas desegurança adicionais específicas para um aplicativo remoto, alavanca váriasarquiteturas de segurança específicas do fornecedor e aproveita medidas desegurança com base no dispositivo e no servidor.

Muitos dos servidores de gerenciamento e ferramentas de administraçãoespecíficos de dispositivo usados pelo Cognos Mobile oferecem a capacidade deremover remotamente o conteúdo de um dispositivo ou desativar completamente odispositivo. Por exemplo, se um dispositivo for perdido ou roubado, oadministrador do Cognos BI poderá usar esta funcionalidade para proteger oconteúdo sigiloso no dispositivo. Ou, um administrador do Cognos BI podeconfigurar uma data de expiração para um relatório após a qual o relatório setorna inacessível até que haja uma nova autenticação do usuário. Para obter maisinformações sobre a segurança do Cognos BI, consulte o IBM Cognos BusinessIntelligence Administration and Security Guide. Para obter mais informações sobregerenciamento de dispositivo e segurança, consulte a documentação do dispositivo.

Capítulo 2. Opções de Distribuição 7

Page 20: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

O Cognos Mobile também suporta solicitações entre o dispositivo móvel e oambiente do servidor para as funções de procura, navegação e execução doproduto:

Você deve instalar e executar a mesma versão do Cognos Mobile e do servidor doCognos BI.

Gerenciamento de dados de aplicativos - Content ManagerO Content Manager é o serviço do IBM Cognos Business Intelligence que gerenciao armazenamento dos dados do aplicativo do cliente, incluindo segurança, dadosde configuração, modelos, métricas, especificações de relatório e saída de relatório.O Content Manager é necessário para publicar pacotes, recuperar ou armazenarespecificações de relatório, gerenciar informações de planejamento e gerenciar onamespace Cognos.

O Content Manager armazena informações em um banco de dados dearmazenamento de conteúdo.

Componentes opcionais do servidorOs seguintes componentes opcionais estão disponíveis para instalação no servidorpara estender a funcionalidade do IBM Cognos Business Intelligence.

Banco de dados de aplicativo pré-configurado - Banco de dadosdo IBM DB2 Advanced Workgroup Server Edition

A opção Instalação Rápida instala e configura o banco de dados do IBM DB2Advanced Workgroup Server Edition 10.5.0.3. Ele é pré-configurado como oarmazenamento de conteúdo padrão para o IBM Cognos Business Intelligence.

É possível usar um banco de dados do IBM DB2 Advanced Workgroup ServerEdition como o armazenamento de conteúdo, banco de dados de notificação ecomo um banco de dados de consulta.

Nota: Esta opção só está disponível se o DB2 não estiver instalado. Esta opção estádisponível somente para versões de 64 bits do Microsoft Windows.

Banco de Dados do Aplicativo Pré-configurado - Banco deDados de Conteúdo do Cognos

O Banco de Dados de Conteúdo do Cognos é uma instância de banco de dados doApache Derby. É um componente de instalação selecionável e não é instalado porpadrão. Se você instalar o Banco de Dados de Conteúdo do Cognos, ele estáconfigurado com o armazenamento de conteúdo padrão para o IBM CognosBusiness Intelligence.

Não use o Banco de Dados de Conteúdo do Cognos para o armazenamento deconteúdo em um ambiente de produção. O Banco de Dados de Conteúdo doCognos é fornecido para ajudá-lo a configurar rapidamente um teste de sistema deprova de conceito.

O Apache Derby é um software de código aberto cujos termos de licença podemser encontrados no Web site do Apache Derby. Não se pode modificar o banco dedados do Apache Derby ou usá-lo com outros produtos. Qualquer modificaçãofeita no banco de dados do Apache Derby ficará por sua conta e risco.

8 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 21: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

O Banco de Dados de Conteúdo do Cognos pode ser usado como umarmazenamento de conteúdo ou um banco de dados de notificação, mas não comoum banco de dados de consulta.

Aprendendo e Resolvendo Problemas Usando Dados de Amostra- IBM Cognos BI Samples

As amostras do IBM Cognos BI ilustram os recursos do produto e as melhorespráticas técnicas e de negócios usando dados de uma empresa fictícia, aCompanhia das Aventuras de Amostra. Também é possível utilizá-las para testar ecompartilhar técnicas de desenvolvimento de relatórios e de solução de problemas.

Componentes de migraçãoOs componentes do migração do IBM Cognos Business Intelligence são usadospara migrar conteúdo do IBM Cognos Series 7 para o IBM Cognos BI.

Para obter informações adicionais sobre os componentes de migração, consulte oGuia de Migração e Administração do IBM Cognos PowerPlay.

Os componentes de migração incluem o seguinte:

Assistente de migração

Administradores usam o Migration Assistant para migrar o conteúdo do IBMCognos Series 7 PowerPlay do PowerPlay Enterprise Server, Upfront e IBMCognos 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 do IBMCognos Series 7 para o IBM Cognos PowerPlay. Uma instalação do IBM CognosPowerPlay inclui o serviço de migração por padrão. O CD do IBM CognosPowerPlay também inclui o serviço de migração instalado no computador com oIBM Cognos Series 7.

Utilitário de conversão de marcador

O utilitário de conversão de marcador converte marcadores do PowerPlayEnterprise Server em um formato que pode ser lido pelo IBM Cognos PowerPlayStudio.

Macro de conversão de relatórios

O IBM Cognos PowerPlay não suporta relatórios com formato ppr criados com oIBM Cognos Series 7. O IBM Cognos PowerPlay fornece uma macro denominadappr2ppx.mac para permitir a coversão de relatórios com formato ppr em formatoppx.

Macro de atualização de relatório

Se você tiver arquivos .ppx locais que acessem cubos remotos, o IBM CognosPowerPlay fornece uma macro que pode ser usada para alterar a referência decubo no relatório para uma referência de pacote do IBM Cognos BI. Além disso, amacro converte a codificação do relatório para UTF-8.

Capítulo 2. Opções de Distribuição 9

Page 22: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Componentes do clienteOs componentes do cliente fornecem funcionalidade para usuários sem asexigências de uma instalação de servidor completa e podem depender do servidorpara realizar algumas operações. O IBM Cognos PowerPlay fornece o cliente aseguir.

IBM Cognos PowerPlay Client

O PowerPlay Client permite que usuários visualizem, explorem, formatem edistribuam relatórios.

Componentes Necessários do Banco de DadosAlém das ferramentas fornecidas, o IBM Cognos PowerPlay requer os seguintescomponentes que são criados usando outros recursos.

Armazenamento de conteúdo

O armazenamento de conteúdo é um banco de dados relacional que contém osdados que o seu produto IBM Cognos BI precisa para operar, como especificaçõesde relatório, modelos publicados e os pacotes que os contêm; informações deconexão para origens de dados; informações sobre o namespace externo e opróprio namespace Cognos; e informações sobre planejamento e bursting derelatórios.

Seu produto IBM Cognos BI inclui o banco de dados do IBM DB2 AdvancedWorkgroup Server Edition (instalado com a opção Instalação Rápida) e o Banco deDados do Conteúdo do Cognos (Apache Derby), que você pode usar para colocaro seu produto em funcionamento rapidamente em um sistema de teste ou provade conceito.

O IBM DB2 Advanced Workgroup Server Edition é um banco de dados totalmentesuportado, mas antes de usá-lo em um ambiente de produção, assegure-se de queele atenda às suas necessidades de capacidade e de desempenho.

O Banco de Dados de Conteúdo do Cognos não se destina a ser utilizado em umambiente de produção. Quando estiver pronto para configurar um ambiente deprodução com o seu produto IBM Cognos BI, configure o armazenamento deconteúdo para usar um banco de dados suportado que possa ser assegurado esintonizado para desempenho e estabilidade. O portal de administração fornecerecursos que podem ser usados para fazer backup e arquivar os dados do Bancode Dados de Conteúdo do Cognos antes que sejam movidos para o novo banco dedados de armazenamento de conteúdo no seu ambiente de produção. Para obtermais informações, consulte o tópico sobre como implementar o armazenamento deconteúdo inteiro noBusiness Intelligence Guia de Administração e segurançae IBMCognos.

Modelos de projeto e arquivos de log não são guardados no armazenamento deconteúdo.

O serviço do IBM Cognos que usa o armazenamento de conteúdo é chamadoContent Manager.

10 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 23: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Origens de dados

Origens de dados, também conhecidas como banco de dados de consulta, sãobancos de dados relacionais, cubos dimensionais ou OLAP, arquivos ou outrosarmazenamentos de dados físicos que podem ser acessados por meio do IBMCognos BI. Os Componentes da camada de aplicativos usam conexões de origensde dados para acessar origens de dados.

O IBM Cognos PowerPlay suporta origens de dados do PowerCube. Para obterinformações adicionais, consulte o Guia de Administração e Segurança do IBM CognosBusiness Intelligence.

Componentes do Cognos MobilePara implementar o IBM Cognos Mobile, inclua componentes na camada doaplicativo e no gateway em que o IBM Cognos Business Intelligence está instalado.

O Cognos Mobile inclui o serviço do Cognos Mobile e o rich client do CognosMobile. Em dispositivos Research in Motion BlackBerry, Cognos Mobile tambéminterage com BlackBerry Enterprise Server e o componente BlackBerry MDSConnection Service.

O diagrama a seguir mostra como os componentes interagem no ambiente doCognos BI. Os dispositivos móveis se conectam ao armazenamento de conteúdopor meio da Internet e de operadoras de serviços wireless, um firewall, BES e oserviço do Cognos Mobile.

Deve-se entender a arquitetura do ambiente do Cognos BI existente. Para obterinformações adicionais, consulte o Guia de Arquitetura e Implementação do IBMCognos Business Intelligence.

IBM Cognos

Serviço de relatório

Serviço do IBM Cognos Mobile

Firewall corporativo

Origem de dados do relatório

Content Store

Internet e operadoras de serviços wireless

Wi-Fi corporativo

Firewall corporativo

Smartphones

Computadores Tablet

Smartphones

Computadores Tablet

Figura 1. Componentes do Cognos Mobile no ambiente do Cognos BI

Capítulo 2. Opções de Distribuição 11

Page 24: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Serviço do Cognos MobileO serviço do IBM Cognos Mobile gerencia as atividades relacionadas ao cliente doIBM Cognos Mobile.

O serviço manipula as seguintes operações:v Transforma relatórios e análises do Cognos Business Intelligence para consumo

móvel.v Compacta o conteúdo de relatório e de análise do Cognos BI para rápida

distribuição over-the-air para dispositivos móveis e acesso a partir dessesdispositivos.

v Envia por push o conteúdo de relatório e de análise para os dispositivos móveis.v Facilita solicitações relacionadas a relatórios e a análises de entrada e saída entre

o dispositivo móvel e o ambiente para procurar, navegar ou executar relatórios.v Sincroniza o armazenamento de conteúdo móvel no servidor com o banco de

dados móvel no dispositivo móvel.v Converte mensagens do Cognos BI Simple Object Access Protocol (SOAP) em

mensagens convenientes wireless.v Comunica-se com o dispositivo móvel.

Rich client do IBM Cognos MobileO dispositivo móvel contém o rich client do IBM Cognos Mobile e oarmazenamento de conteúdo móvel compactado e criptografado. Essescomponentes fornecem a funcionalidade de que o usuário do dispositivo móvelprecisa para trabalhar com relatórios, painéis e análises do IBM Cognos BusinessIntelligence.

Distribuição de ComponentesAo instalar componentes do servidor IBM Cognos PowerPlay, você especifica ondecolocar os gateways, os Componentes da Camada de Aplicativos e o ContentManager. É possível instalar esses componentes utilizando qualquer uma dasseguintes opções:v Instale todos os componentes em um computador.

Essa opção é normalmente utilizada para uma demonstração ou em umambiente prova de conceito.

v Instale o gateway em um computador separado.Nessa opção, o gateway e o servidor da Web estão em um computador e oscomponentes restantes do IBM Cognos estão em outros computadores. Vocêpode escolher essa opção se tiver servidores da Web existentes disponíveis paratratar de solicitações de componente do IBM Cognos.

v Instale Application Tier Components e o Content Manager em computadoresseparados.Escolha essa opção para maximizar o desempenho, a disponibilidade, acapacidade ou a segurança com base nas características de processamento daorganização.Se você planeja instalar o Banco de Dados de Conteúdo do Cognos, instale-o nomesmo computador que o Content Manager. O Banco de Dados de Conteúdo doCognos é configurado automaticamente para uso como seu armazenamento deconteúdo.

v Instale os componentes do servidor IBM Cognos PowerPlay no mesmo local dosoutros produtos IBM Cognos BI.

12 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 25: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Produtos IBM Cognos BI diferentes compartilham componentes, como ContentManager. Se você pretende instalar os componentes de relatório e scorecard doIBM Cognos BI no mesmo computador, por exemplo, instale-os no mesmo localde instalação. Isso preserva recursos como espaço em disco e consumo dememória por serviços.

v Instalação de componentes em sistemas de 64 bitsAlguns componentes do IBM Cognos BI estão disponíveis para sistemas de 64bits. Se estiver instalando todos os componentes do servidor em um único oudiversos servidores, os componentes de 32 e 64 bits devem estar em diretóriosseparados.

v Para o iPad que suporta o aplicativo nativo Cognos Mobile, os usuários fazemdownload do aplicativo na Apple App Store.

v Para o iPad (versão da web), Android e iPhone, os usuários devem configurar oCognos Mobile usando um aplicativo da web que possa ser acessado usando-seuma URL.

Após instalar os componentes do servidor IBM Cognos BI, você deve configurá-lospara que eles possam se comunicar uns com os outros.

Além de instalar o Content Manager, Application Tier Components e componentesde gateway, instale o Framework Manager, o aplicativo de modelagem demetadados para inteligência de negócio. Também é possível optar por instalar oTransformer, a ferramenta de construção e modelagem para a criação dePowerCubes para uso com o IBM Cognos BI. Independentemente do cenário deinstalação do IBM Cognos que você seguir, é possível instalar todos oscomponentes de modelagem em locais separados.

Para obter informações adicionais sobre como instalar o Framework Manager ou oTransformer, consulte o Guia de Instalação e Configuração do IBM CognosBusiness Intelligence.

Todos os Componentes do Servidor em um ComputadorÉ possível instalar todos os componentes do servidor IBM Cognos PowerPlay emum computador. Escolha este cenário para prova de conceito ou ambientes dedemonstração em que o carregamento do usuário seja pequeno

Como o gateway deve estar localizado junto com o servidor web, o únicocomputador também deve executar um servidor web.

Se seu servidor da Web estiver no UNIX ou Linux, você deve instalar o PowerPlayClient em um computador separado que execute em um sistema operacionalMicrosoft Windows.

Em uma instalação em um único computador, todos os componentes de servidorpara o PowerPlay são instalados em um computador. O armazenamento deconteúdo e as origens de dados podem estar em um ou mais computadores.

Requisitos de Configuração

Se instalar todos os componentes do servidor para IBM Cognos PowerPlay nomesmo computador, você deve entãov Configurar seu servidor da Web para hospedar o webcontent do IBM Cognosv Especificar informações de conexão para o armazenamento de conteúdo.

Capítulo 2. Opções de Distribuição 13

Page 26: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

v Configurar uma conta de e-mail para notificações (se pretende enviar relatóriospor e-mail).

Gateways em Computadores SeparadosO gateway passa consultas do servidor web e clientes para o dispatcher. Poderesidir em um ou mais servidores web.

É possível instalar o gateway e um servidor da Web em um computador e instalaros componentes restantes do servidor IBM Cognos PowerPlay em outroscomputadores. Se tiver uma Web farm, considere a instalação de um gateway emcada servidor web. A utilização de diversos servidores web para gerenciarsolicitações recebidas oferece um nível de serviço melhor.

Se instalar apenas o componente de gateway no mesmo computador comoservidor web, o servidor web gerenciará os principais serviços da Web e nãoprocessará solicitações de usuário. Essa separação do processamento pode sernecessária se houver um firewall entre o servidor web e os computadores comApplication Tier Components.

No diagrama a seguir, dois servidores web têm um gateway cada instalado. Assolicitações recebidas são passadas para o gateway e encaminhadas para ocomputador com Application Tier Components.

Requisitos de Configuração

Se você instalar um ou mais gateways em computadores separados, você devegarantir que seja possível visualizar conteúdo do IBM Cognos e que os gatewayspoderão se comunicar com outros componentes do IBM Cognos. Em cadacomputador onde o gateway está instalado, é necessáriov Configurar seu servidor da Web para hospedar o webcontent do IBM Cognosv Configurar os URIs de dispatchers.

Content Store

Componentes da Camada de AplicativosContent Manager

Bancos de dados de consulta

Gateway do servidor daweb

Gateway do servidor da web

Figura 2. Instalação com Dois Gateways

14 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 27: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Componentes da Camada de Aplicativos e Content Managersem Computadores Separados

Componentes da Camada de Aplicativos usam a interface do IBM CognosConnection para balancear carga, acessar dados, executar consultas, planejar tarefase renderizar relatórios. O Content Manager armazena todas as especificações derelatórios, resultados, pacotes, pastas e tarefas no armazenamento de conteúdo.

É possível instalar os Application Tier Components e o Content Manager nomesmo computador ou em computadores diferentes. A instalação emcomputadores diferentes pode aperfeiçoar o desempenho, a disponibilidade e acapacidade.

Mais de um Content ManagerÉ possível instalar qualquer número de Content Managers, embora apenas umfique ativo num dado momento. As outras instalações agem como uma reserva doContent Manager. Essas reservas ficam ativas apenas se ocorre uma falha que afetao computador com Content Manager ativo. Para suporte de failover, é aconselhávelinstalar o Content Manager em dois ou mais computadores.

Instalar Diversos Content Managers

O Content Manager armazena dados dos quais o IBM Cognos BI precisa paraoperar, como especificações de relatório, modelos publicados e os pacotes que osusam; informações de conexão para origens de dados; informações sobre onamespace externo e o próprio namespace do Cognos; além de informações sobreo planejamento e o bursting de relatórios. O armazenamento de conteúdo é umsistema de gerenciamento de banco de dados relacional (RDBMS). Há apenas umarmazenamento de conteúdo para cada instalação do IBM Cognos.

É possível instalar o Content Manager separadamente do Application TierComponents. Por exemplo, o Content Manager pode ser necessário na camada dedados em vez da camada de aplicativos.

Se um Content Manager ativo falhar, os dados de sessão que não foram salvosserão perdidos. Quando o novo Content Manager ativo assumir, os usuáriospoderão ter que refazer logon.

Requisitos de Configuração

Em cada computador no qual foi instalado o Content Manager, é necessáriov Especificar informações de conexão para o armazenamento de conteúdo.v Especificar os URIs de dispatchers.v Especificar todos os URIs do Content Manager.v Especificar o URI do dispatcher para aplicativos externos.v Configurar uma conexão a uma conta de e-mail para obter notificações (se

pretende enviar relatórios por e-mail).

Mais de um Computador com Componentes da Camada deAplicativosPara melhorar a escalabilidade em um ambiente no qual haja normalmente umgrande volume de solicitações para processar, é possível instalar o Application TierComponents em vários computadores dedicados ao processamento de solicitaçõesrecebidas. Com a instalação de Application Tier Components em várioscomputadores, as cargas são distribuídas e balanceadas entre os computadores. A

Capítulo 2. Opções de Distribuição 15

Page 28: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

acessibilidade e a taxa de transferência também são melhores que em um únicocomputador, assim como o suporte a failover.

Em uma instalação com diversos servidores IBM Cognos PowerPlay, solicitaçõesrecebidas são roteadas por meio de um gateway para um dispatcher. O dispatcherencaminha a solicitação para um dos servidores PowerPlay. O servidor PowerPlayencaminha a solicitação para o Content Manager, que consulta o armazenamentode conteúdo para metadados para consultar o PowerCube. Os resultados daconsulta são retornados para o servidor PowerPlay para renderização.

Requisitos de Configuração

Se você instalar um ou mais Componentes da Camada de Aplicativos em umcomputador separado, para garantir que eles possam se comunicar com outroscomponentes do IBM Cognos PowerPlay, faça o seguinte:v Especificar todos os URIs do Content Manager.v Especificar os URIs de dispatchers.v Especificar o URI do dispatcher para aplicativos externos.

Instalando Versões de 64 Bits de Produtos IBM Cognos BIAlguns componentes do IBM Cognos BI estão disponíveis para sistemas de 64 bits.Ao instalar em um sistema de 64 bits, os componentes devem ser instalados nosdiretórios adequados.

Como releases anteriores, os componentes do IBM Cognos PowerPlay permanecemde 32 bits. Porém, o PowerPlay fornece uma instalação para suportar integraçãocom instalações do IBM Cognos BI de 64 bits. Essa integração permite que seaproveitem os benefícios em termos de desempenho, oferecidos pelos componentesdo IBM Cognos BI de 64 bits.

O diretório de instalação padrão que é usado pelos componentes do IBM CognosBI depende da versão instalada.

Tabela 1. Caminhos Padrão para Instalações de 32 Bits

Para uma Instalação de 32 bits no Caminho padrão

Sistemas operacionais Microsoft Windows C:\Arquivos de Programas\IBM\Cognos\c10

Sistemas operacionais Microsoft Windows de64 bits

C:\Arquivos de Programas(x86)\IBM\Cognos\c10

Sistemas operacionais UNIX /usr/IBM/cognos/c10

Sistemas operacionais Linux /opt/IBM/cognos/c10

Tabela 2. Caminhos Padrão para Instalações de 64 Bits

Para uma Instalação de 64 bits no Caminho padrão

Sistemas operacionais Microsoft Windows C:\Arquivos de Programas\IBM\Cognos\c10_64

Sistemas operacionais UNIX /usr/IBM/cognos/c10_64

Sistemas operacionais Linux /opt/IBM/cognos/c10_64

Se estiver instalando todos os componentes do servidor juntos em um únicoservidor ou em diversos servidores, os componentes de 32 bits e de 64 bits devemestar em diretórios separados.

16 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 29: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Componentes do Servidor Que Podem ser Instalados Juntos noDiretório c10_64

Os componentes a seguir podem ser instalados juntos em um servidor de 64 bitsou 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:v IBM Cognos BI Server e IBM Cognos PowerPlay (Content Manager,

Componentes da Camada de Aplicativos, Gateway)v IBM Cognos BI Supplementary Language Documentation (versões de 32 e 64

bits disponíveis em um disco)v IBM Cognos BI Samples (versões de 32 e 64 bits disponíveis em um disco)

Componentes Que Devem ser Instalados em um DiretórioSeparado dos Componentes de 64 Bits

Os componentes a seguir podem ser instalados juntos no servidor de 64 bits, maseles devem ser instalados em um diretório separado dos componentes de 64 bits.Por exemplo, o local de instalação padrão desses componentes é o diretórioArquivos de Programas (x86) em um computador Windows de 64 bits, enquantoos componentes do servidor de 64 bits são instalados no diretório Arquivos dePrograma. Também podem ser instalados em um sistema de 32 bits separado:v Framework Manager (apenas Windows)v IBM Cognos PowerPlay Client (somente para o Windows)v IBM Cognos Transformer (utilitário do UNIX e Linux para a construção de

PowerCubes)v IBM Cognos Transformer (ferramenta de modelagem do Windows)v IBM Cognos BI for Microsoft Office (apenas Windows)

Acessando a Documentação do Produto em um AmbienteIntegrado

A documentação para componentes do IBM Cognos Business Intelligence éinstalada com o componente de gateway. Se você integrar diferentes produtos IBMCognos BI, é possível usar o mesmo gateway ou gateways separados. Se quiserusar o mesmo gateway, todos os componentes de gateway deverão ter a mesmaversão do produto e você deverá instalar o componente de gateway do IBMCognos BI para cada produto no mesmo local no mesmo computador. Isso garanteque toda a documentação do produto esteja disponível para todos os usuários. Sedesejar usar gateways separados para cada produto, poderá instalar o componentede gateway do IBM Cognos BI para cada produto em computadores separados,mas a documentação do produto em cada gateway é específica para o produtoIBM Cognos BI instalado.

Se você quiser que os usuários acessem cada produto IBM Cognos BI por meio degateways separados, e ainda possam acessar a documentação de todos oscomponentes, é possível instalar o componente de gateway de cada produto nomesmo local de outros componentes de gateway do IBM Cognos BI.

Capítulo 2. Opções de Distribuição 17

Page 30: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Opções de distribuição para o Cognos MobileO IBM Cognos Mobile é um componente integrado da arquitetura do IBM CognosBusiness Intelligence. É possível instalar todos os componentes do IBM CognosMobile em um computador, ou distribuí-los em uma rede.

O Cognos Mobile consiste nos seguintes componentes:v Componentes da camada de aplicativosv Um gatewayv O cliente do Cognos Mobile

Deve-se instalar os Componentes da camada de aplicativos do Cognos Mobile comos Componentes da camada de aplicativos do Cognos BI.

Deve-se instalar o cliente e o gateway do Cognos Mobile com o gateway doCognos BI.

Todos os componentes necessários são instalados e ativados por padrão.

Componentes do Cognos Mobile instalados em umcomputador

É possível instalar e configurar o IBM Cognos Mobile em um único computador.

O diagrama a seguir mostra um exemplo em que todos os componentes doservidor estão instalados em um computador.

Componentes do Cognos Mobile instalados em computadoresseparados

Você distribui componentes do IBM Cognos Mobile usando o mesmo método deinstalação e configuração usado para distribuir componentes do IBM Cognos BI.

Content Store

Web serverGatewayComponentes da Camada de Aplicativos - Serviço de relatório - Serviço do IBM Cognos Mobile Content Manager

Smartphones

Computadores Tablet

Figura 3. Componentes do servidor Cognos Mobile instalados em um computador

18 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 31: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Execute a instalação em cada computador e, em seguida, conclua a configuraçãoespecificando a localização dos componentes distribuídos do IBM Cognos BI.

Em uma instalação distribuída, você instala os componentes da camada deaplicativos do Cognos Mobile nos sistemas em que deseja executar o serviço doCognos Mobile. Deve-se instalar o componente de gateway do Cognos Mobile emseus sistemas de gateway. Esses componentes incluem as próprias páginas deinstalação over-the-air móveis de amostra e o componente do cliente do Mobile.

Todas as instâncias do serviço do IBM Cognos Mobile devem ser capazes deacessar o banco de dados onde as tabelas do IBM Cognos Mobile são armazenadas.Se uma instância do servidor IBM Cognos BI não estiver configurada com osdetalhes do banco de dados para o armazenamento de conteúdo do IBM Cognos,ou se você desejar que o IBM Cognos Mobile use uma instância de banco de dadosdiferente do armazenamento de conteúdo do IBM Cognos, use o IBM CognosConfiguration para incluir um banco de dados.

O diagrama a seguir mostra um cenário no qual o gateway do Cognos Mobile estáinstalado em um computador e os componentes da camada de aplicativos estãoinstalados em um computador diferente.

O diagrama a seguir mostra um cenário no qual os componentes do gateway estãoinstalados em um computador, e os componentes da camada de aplicativos estãoinstalados em três computadores. Esta instalação é adequada para um ambiente demédio a grande porte.

Content Store

Componentes da Camada de Aplicativos - Serviço de relatório - Serviço do IBM Cognos MobileContent Manager

firewall de rede

firewall de rede

Servidor da webGateway - Gateway do IBM Cognos Mobile

Smartphones

Computadores Tablet

Figura 4. Componentes do Cognos Mobile instalados em computadores separados (cenário1)

Capítulo 2. Opções de Distribuição 19

Page 32: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

IBM Cognos PowerPlay com outros Produtos do IBM CognosÉ possível instalar o IBM Cognos PowerPlay em um ambiente que inclui outrosprodutos IBM Cognos Business Intelligence. O assistente de instalação para oPowerPlay pode reconhecer diretórios compatíveis e mostra um aviso quandoocorrerem conflitos. Após a instalação do PowerPlay, é possível acessar objetoscriados em outros produtos IBM Cognos BI. As exigências de acesso dependem decomo se escolhe executar os dois produtos.

Content Store

Servidor da webGateway - Gateway do IBM Cognos Mobile

Computadores Tablet

Content ManagerBanco de dados doIBM CognosMobile alternativo

Smartphones

Figura 5. Componentes do Cognos Mobile instalados em computadores separados (cenário2)

20 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 33: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Produtos IBM Cognos Series 7 que Podem Ser Migrados parao IBM Cognos PowerPlay

É possível migrar completamente aplicativos do IBM Cognos Series 7 PowerPlaypara o IBM Cognos PowerPlay. Para obter informações adicionais, consulte o Guiade Migração e Administração do PowerPlay.

Também é possível migrar metadados e aplicativos de outros produtos IBMCognos Series 7 para o IBM Cognos Business Intelligence. O conteúdo que podeser migrado inclui modelos do Architect, relatórios e catálogos de clientes doImpromptu e conteúdo de Relatórios da Web do Impromptu.

PowerPlay Enterprise Server

Os recursos de análise e exploração de dados do IBM Cognos Series 7 PowerPlayagora estão disponíveis com o IBM Cognos PowerPlay. A arquitetura orientada aserviços do IBM Cognos BI possibilita a integração de serviço PowerPlay Web,PowerPlay Enterprise Server Administration e PowerPlay Enterprise Server.

O Migration Assistant é usado para migrar o conteúdo do IBM Cognos Series 7PowerPlay dov PowerPlay Enterprise Serverv Upfrontv Cognos Connection (conteúdo publicado do IBM Cognos Series 7 PowerPlay

Enterprise Server)

Também é possível migrar marcadores e relatórios do PowerPlay Client para oCognos PowerPlay. Para obter detalhes sobre o que pode ser migrado do IBMCognos Series 7 PowerPlay para o IBM Cognos PowerPlay, consulte o Guia deMigração e Administração do PowerPlay.

Para migrar conteúdo do IBM Cognos Series 7 para o IBM Cognos PowerPlay,você deve instalar os Componentes de Migração do IBM Cognos PowerPlay Servere do IBM Cognos Series 7.

Architect

É possível migrar modelos de Architect para usar como uma fonte de metadadosno Framework Manager.

Impromptu

É possível migrar relatórios e catálogos Impromptu para o IBM Cognos BI. Oscatálogos migrados são usados como uma fonte de metadados do FrameworkManager. Após você concluir o processo de migração de catálogo, é possívelmigrar e implementar relatórios Impromptu.

Relatórios da Web do Impromptu

É possível migrar o conteúdo dos relatórios da Web do Impromptu, comoprogramações e eventos, para o IBM Cognos BI. Migre o conteúdo dos relatóriosda Web do Impromptu usando um pacote IBM Cognos Series 7 DeploymentManager como fonte de migração. Antes de migrar relatórios da Web doImpromptu, você deve migrar os metadados do catálogo Impromptu usados pelosrelatórios.

Capítulo 2. Opções de Distribuição 21

Page 34: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Não é possível migrar arquivos de definição da consulta (.iqd) do Impromptu, masé possível continuar usando arquivos .iqd existentes para construir cubos no IBMCognos BI Transformer 8.4. Para isso, você deve instalar o componente opcional,Series 7 IQD Bridge, que está disponível para instalação com o IBM Cognos BI nasplataformas suportadas do IBM Cognos Series 7.

PowerPrompts não são migrados, mas é possível implementar funcionalidadesemelhante usando a funcionalidade de administrador integrada ou o IBM CognosSoftware Development Kit.

Produtos IBM Cognos que Interoperam com o IBM CognosPowerPlay

Alguns produtos IBM Cognos Business Intelligence fornecem funcionalidades quenão estão disponíveis no IBM Cognos PowerPlay. É possível usar estes produtos nomesmo ambiente que o IBM Cognos PowerPlay.

IBM Cognos BI Server

Para usar ferramentas de modelagem, tais como Framework Manager e IBMCognos Transformer, com o PowerPlay, você deve instalar o IBM Cognos BI. Setambém quiser usar o Report Studio, Analysis Studio ou Query Studio, seránecessário ter o IBM Cognos BI Server.

Se o PowerPlay estiver sendo instalado em um ambiente do IBM Cognos BIexistente, faça backup da configuração do IBM Cognos BI antes de instalar oPowerPlay.

Para instalação em um único computador, instale componentes para ambos osprodutos 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 IBM Cognos

Series 7 PowerPlay.

Para uma instalação distribuída, instale e configure componentes da seguinteforma:1. Instale, configure e teste todos os componentes para o IBM Cognos BI Server:

Content Manager, camada do aplicativo e gateway.Para obter instruções sobre como instalar e configurar o IBM Cognos BI Server,consulte o Guia de Instalação e Configuração do IBM Cognos BI.

2. Em cada computador que inclui Componentes da camada de aplicativos doIBM Cognos BI, instale o PowerPlay Administration. Também é possívelinstalar o PowerPlay Server no mesmo computador que os Componentes daCamada do Aplicativo do IBM Cognos BI.

3. Se instalar os Componentes da camada de aplicativos do PowerPlay em umcomputador separado dos Componentes da camada de aplicativos do IBMCognos BI, você deve desativar alguns serviços. No computador no qual osComponentes da camada de aplicativos do PowerPlay foram instalados, abra oCognos Configuration e, sob IBM Cognos Services, desative o serviço deapresentação e o serviço de relatório. Opcionalmente, para reduzir a demandados recursos do sistema, é possível desativar o serviço de consulta.

4. No computador que inclui os componentes do IBM Cognos BI ContentManager, instale os componentes do PowerPlay Content Manager.

22 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 35: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

5. No computador que inclui os componentes de gateway do IBM Cognos BI,instale os componentes de gateway do PowerPlay.

6. Se você planejar migrar o conteúdo do IBM Cognos Series 7, instale osComponentes de Migração do IBM Cognos Series 7 no computador IBMCognos Series 7 PowerPlay Enterprise Server e, se necessário, no computadorIBM Cognos Series 7 Upfront.

Para alguns cenários de instalação distribuída, você deve concluir as tarefasadicionais no IBM Cognos Administration após concluir a instalação e aconfiguração para garantir que o conteúdo do PowerPlay funcione corretamente.Para obter informações sobre as tarefas de administração necessárias, consulte oGuia de Migração e Administração do IBM Cognos PowerPlay.

Cognos Planning - Analyst

É possível acessar dados de plano publicados no IBM Cognos BI usando oassistente do Generate Framework Manager Model, que requer IBM CognosPlanning - Analyst 7.3 MR1 ou posterior.

Se desejar usar este produto com o servidor IBM Cognos BI, você deverá assegurarque ambos os produtos sejam da mesma versão.

Para obter mais informações, consulte o Guia do Usuário do Analista do IBMCognos.

Cognos Planning - Contributor

É possível acessar cubos do Contributor não publicados (tempo real) no IBMCognos BI fazendo a instalação customizada do componente IBM Cognos BI -Contributor Data Server que está incluído no release do IBM Cognos Planning -Contributor 7.3 MR1 ou posterior. É possível acessar dados de plano publicadosno IBM Cognos BI usando a extensão de administração do Generate FrameworkManager Model no Contributor, que requer o IBM Cognos Planning -Contributor 7.3 MR1 ou posterior.

Se desejar usar este produto com o servidor IBM Cognos BI, você deverá assegurarque ambos os produtos sejam da mesma versão. Não é possível instalar o IBMCognos Planning no mesmo caminho do IBM Cognos BI de 64 bits.

Para obter informações adicionais, consulte IBM Cognos Contributor: Guia deAdministração.

Cognos Finance

É possível acessar cubos do IBM Cognos Finance que estão protegidos contra umnamespace Series 7 usando o IBM Cognos Finance Network API Service. Tambémé possível exportar dados e metadados do IBM Cognos Finance para uso noFramework Manager.

Cognos Controller

É possível acessar o IBM Cognos BI para criar Relatórios Padrão do IBM CognosController usando um modelo predefinido do Framework Manager que é criadoquando o IBM Cognos Controller é instalado. Acesse também dados do Controllerpublicados e estruturas no Framework Manager para criação de relatórios padrão eanálises.

Capítulo 2. Opções de Distribuição 23

Page 36: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Se desejar usar este produto com o servidor IBM Cognos BI, você deverá assegurarque ambos os produtos sejam da mesma versão.

Cognos Transformer

É possível usar os modelos IBM Cognos PowerCubes e Transformer que foramgerados pelo Transformer 7.3 ou posterior diretamente no IBM Cognos BI. Oscubos e modelos são compatíveis com versões mais recentes e não necessitam deferramentas de migração ou de atualização. É possível executar relatórios e análisesno IBM Cognos BI com relação aos IBM Cognos PowerCubes.

Se quiser usar os novos recursos de integração do Transformer com IBM CognosBI, é possível atualizar os modelos IBM Cognos Series 7.x Transformer para o IBMCognos BI Transformer 8.4 ou posterior. Isso permite usar origens de dados doIBM Cognos BI (como pacotes publicados), listar relatórios criados no QueryStudio ou Report Studio, autenticar usando segurança do IBM Cognos BI epublicar diretamente no IBM Cognos Connection.

Antes de carregar o modelo, o namespace do IBM Cognos Series 7 deve serconfigurado no IBM Cognos BI e o ID do nome usado para configurá-lo no IBMCognos BI deve corresponder ao nome usado no IBM Cognos Series 7.

Para obter mais informações sobre a atualização do IBM Cognos Series 7 securedPowerCubes, consulte o Guia do Usuário do IBM Cognos Business IntelligenceTransformer.

Para os IBM Cognos Series 7 PowerCubes serem usados no IBM Cognos BI,otimize os cubos para uso no IBM Cognos BI usando o utilitário pcoptimizer, que éfornecido com o IBM Cognos BI. Caso contrário, os PowerCubes que foram criadoscom versões anteriores do Transformer podem levar muito tempo para seremabertos nos studios da Web do IBM Cognos BI. Esse utilitário de otimização éadequado para PowerCuber antigos criados antes do Transformer 8.4 e nãonecessita de acesso ao modelo ou à origem de dados. Não é necessário executareste utilitário de linha de comandos para os cubos criados no Transformer 8.4 oumais recente. Para obter mais informações sobre como otimizar PowerCubes,consulte o Transformer User Guide.

É possível publicar PowerCubes usando Transformer 8.4, Framework Manager oudiretamente no portal do IBM Cognos BI. É possível publicar pacotes e origens dedados únicas do PowerCube no IBM Cognos Connection interativamente noTransformer ou na linha de comandos. Publique também no modo silenciosousando scripts em lote após criar um PowerCube. Um usuário que tem privilégiospara criar origens de dados e pacotes no IBM Cognos Connection pode publicarPowerCubes no IBM Cognos Connection também. O arquivo MDC deve estar emum local seguro que o processo do servidor de relatório e o dispatcher do IBMCognos BI possam acessar. Os pacotes que usam diversos PowerCubes dedefinições diferentes de PowerCube ou PowerCubes misturados a outras origensde dados devem ser publicados usando o Framework Manager.

Se você usar um IBM Cognos Series 7 PowerCube como uma origem de dados, oIBM Cognos BI converterá os dados do cubo da codificação que foi usada nosistema onde o PowerCube foi criado. Para uma conversão bem-sucedida, os IBMCognos Series 7 PowerCubes devem ser criados com um código de idioma dosistema configurado para corresponder aos dados no PowerCube.

24 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 37: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Cognos Data Manager

O Data Manager é usado para criar armazéns e repositórios de dados para acriação de relatórios, análises e gerenciamento de desempenho. Quando o DataManager é instalado no ambiente do IBM Cognos BI, é possível usar o Serviço deMovimentação de Dados para executar construções e JobStreams no IBM CognosConnection. Você deve instalar o mecanismo do Data Manager no mesmo local dosComponentes da Camada de Aplicativos do IBM Cognos BI. Tanto o Data Managerquanto o IBM Cognos BI devem estar na mesma versão.

Conteúdo do IBM Cognos Series 7 que Pode Ser Recriado noIBM Cognos Business Intelligence

Alguns produtos IBM Cognos não podem ser migrados programaticamente com asferramentas de migração do IBM Cognos BI. O IBM Cognos BI oferece duas opçõespara duplicar o conteúdo ou a funcionalidade dos produtos descritos: usar o portalUpfront dentro do portal do IBM Cognos BI ou usar os estúdios do IBM Cognos BIpara duplicar consultas, visualizações ou objetos.

A última liberação das ferramentas de migração foi a versão 10.1.1. É possível usaressas ferramentas para migrar para o IBM Cognos Business Intelligence versão10.1.1 (Report Studio ou Analysis Studio) e, em seguida, atualizar o conteúdomigrado para IBM Cognos BI versão 10.2.0.

Cognos Query

É possível usar o IBM Cognos Migration Assistant para identificar objetos do IBMCognos Query na fonte de migração do IBM Cognos Series 7. É possível entãoduplicar a maioria das funcionalidades do IBM Cognos Query no IBM Cognos BI.As consultas de base estão disponíveis no IBM Cognos BI quando você migra ummodelo do Architect para o Framework Manager. Também é possível copiarmanualmente consultas usando os componentes SQL no Report Studio.

Cognos Visualizer

É possível duplicar uma funcionalidade usando as opções de gráfico, layout eformatação no Report Studio e no Analysis Studio.

Cognos NoticeCast

É possível duplicar a funcionalidade de alerta e notificação usando o Event Studioe outros componentes do IBM Cognos BI.

Cognos Web Services

É possível duplicar a maioria das funcionalidades do IBM Cognos Web Servicesusando o IBM Cognos Software Development Kit.

CognosScript

É possível duplicar a funcionalidade de automação usando o IBM Cognos SoftwareDevelopment Kit.

Capítulo 2. Opções de Distribuição 25

Page 38: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Cognos Portal Services

É possível duplicar a maioria das funcionalidades do IBM Cognos Portal Servicesusando o IBM Cognos Connection.

26 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 39: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Capítulo 3. Preparando para Instalar

Antes de instalar o IBM Cognos PowerPlay, você deve configurar recursos em seuambiente para que os componentes possam operar. Por exemplo, você deve criarum banco de dados para o armazenamento de conteúdo, configurar navegadoresda Web e criar uma conta do usuário para o IBM Cognos Business Intelligence.

Se desejar usar a opção Configuração Rápida com o banco de dados do IBM DB2Advanced Workgroup Server Edition como seu armazenamento de conteúdo, nãoserá necessário criar um banco de dados ou configurar um cliente de banco dedados. Um banco de dados é criado durante a instalação e o IBM Cognos BI éconfigurado para usá-lo.

Se quiser usar o Banco de dados de conteúdo do Cognos como armazenamento deconteúdo, você não precisará criar um banco de dados ou configurar um cliente debanco de dados. Um banco de dados é criado durante a instalação e o IBM CognosBI é configurado para usá-lo.

Quando o Banco de dados de conteúdo do Cognos é selecionado no assistente deinstalação, um banco de dados é criado durante a instalação e o PowerPlay éconfigurado para utilizá-lo.

Revisando as Notas sobre o Release antes da InstalaçãoAntes de você instalar seu produto IBM Cognos, é importante estar ciente de todosos problemas que podem afetar sua estratégia de instalação.

Pode haver questões de última hora, que não eram conhecidas no momento emque este guia de instalação foi criado.

Revise as Notas sobre a Liberação antes de instalar seu produto. As Notas sobre aLiberação contêm as informações mais recentes sobre problemas conhecidos,atualizações de documentação e avisos de descontinuação. As Notas sobre aLiberação estão disponíveis na primeira página do assistente de instalação, nodisco do produto e no IBM Cognos Business Intelligence Knowledge Center(http://www.ibm.com/support/knowledgecenter/SSEP7J/welcome).

Revise os Ambientes SuportadosPara garantir que o produto funcione corretamente, aplique todas as correçõesmínimas necessárias do sistema operacional e use somente as versões de softwarede terceiros.

Para revisar uma lista atualizada de ambientes suportados pelos produtos IBMCognos Business Intelligence, incluindo informações sobre sistemas operacionais,correções, navegadores, servidores da web, servidores de diretórios, servidores debanco de dados e servidores de aplicativos, consulte a página Relatórios deCompatibilidade de Produto IBM Software (www.ibm.com/support/docview.wss?uid=swg27042164).

A não ser que indicado de outra forma, os produtos IBM Cognos são compatíveiscom versões mais recentes de correções e Service Packs das versões indicadas.

© Copyright IBM Corp. 2005, 2014 27

Page 40: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

É importante observar que o sistema operacional Linux está disponível em umasérie de distribuições e suporta várias plataformas de hardware. Assegure-se deque a combinação de sistema operacional e hardware utilizada seja compatível.

Produtos Cognos e Ambientes de Virtualization

A Política de virtualização IBM (www.ibm.com/software/support/virtualization_policy.html) descreve o suporte IBM para ambientes de virtualização.

Para obter mais informações, procure os ambientes de virtualização do servidor dosuportado por produto (http://pic.dhe.ibm.com/infocenter/prodguid/v1r0/clarity/vesForProduct.html).

Verificar Requisitos do SistemaUse as tabelas a seguir para verificar os requisitos mínimos de software e hardwarepara instalar e executar os componentes do IBM Cognos Business Intelligence emum computador. Podem ser solicitados recursos adicionais para ambientes dedistribuição ou de produção.

A tabela a seguir lista os requisitos de hardware e as especificações para uma únicainstalação do computador.

Requisitos de Hardware

Tabela 3. Requisitos de Hardware para uma Instalação em Computador Único

Exigência Especificação

Sistema operacional Microsoft Windows

UNIX

Linux

Alguns componentes do IBM Cognos BI não sãosuportados no Linux.

RAM Mínimo de 10 GB. Para obter mais informações,consulte “Definições de memória” na página 30.

Especificações do sistemaoperacional

Limite do descritor de arquivos configurado como 2048no UNIX e Linux

Espaço em disco É necessário no mínimo 3.5 GB de espaço livre parainstalar o software e 4 GB de espaço livre na unidadeque contém o diretório temporário usado peloscomponentes do IBM Cognos.

Para todos os bancos de dados, o tamanho aumentarácom o tempo. Certifique-se de ter espaço em discosuficiente para exigências futuras.

Impressora Para garantir que os relatórios sejam impressoscorretamente no Windows, o Adobe Reader requer quepelo menos uma impressora seja configurada nocomputador em que os Componentes da Camada deAplicativos estão instalados. Todos os relatórios,independente do formato de impressão escolhido, sãoenviados como arquivos PDF temporários para o AdobeReader para impressão.

28 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 41: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Tabela 3. Requisitos de Hardware para uma Instalação em ComputadorÚnico (continuação)

Exigência Especificação

Outro Para enviar relatórios por e-mail, o sistema requer ahabilidade de usar e acessar um servidor de correio.

Requisitos de Software

A tabela a seguir lista os requisitos de software e as especificações para uma únicainstalação do computador.

Tabela 4. Requisitos de Software para uma Instalação em Computador Único

Exigência Especificação

Servidor web Deve ser instalado e iniciado um servidor web. Seestiver usando a opção Configuração Rápida (apenaspara 64 bits), um gateway de servlet será configuradocomo parte da instalação, significando que não hánecessidade de um servidor da web.

Java Runtime Environment (JRE) Um IBM JRE é instalado automaticamente com o IBMCognos BI no Windows.

Se estiver usando um servidor de aplicativos, use o JREque está instalado com ele, se for suportado no IBMCognos BI.

Banco de Dados A opção Instalação Rápida (apenas 64 bits) instala econfigura o IBM DB2 Advanced Workgroup ServerEdition. Esta opção não estará disponível se o DB2 jáestiver instalado.

O Banco de dados de conteúdo daCognos pode serinstalado e configurado como o banco de dados dearmazenamento de conteúdo padrão em um sistema deteste ou de prova de conceito.

É preciso ter um dos seguintes bancos de dadosdisponível para armazenar dados do IBM Cognos emum ambiente de produção:

v Oracle

v DB2

v Microsoft SQL Server

v Sybase

v Informix

A conectividade TCP/IP é necessária para todos ostipos de bancos de dados.

Capítulo 3. Preparando para Instalar 29

Page 42: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Tabela 4. Requisitos de Software para uma Instalação em Computador Único (continuação)

Exigência Especificação

Navegador web Para todos os navegadores web, o seguinte deverá serativado:

v Cookies

v JavaScript

Apenas para o Microsoft Internet Explorer, o seguintedeve ser ativado:

v Executar os controles e plug-ins ActiveX.

v Controles de script ActiveX marcados como segurospara criação de scripts.

v Criação ativa de scripts.

v Permissão de META REFRESH

Para Microsoft Internet Explorer versão 10, certifique-sede que Recuperar automaticamente de erros de layoutde página com Modo de Compatibilidade está ativadona guia Avançado de Opção da Internet.

Definições de memóriaAs configurações de memória dependem de inúmeros fatores, como nível deatividade esperado no servidor, complexidade dos aplicativos IBM Cognos, númerode usuários e solicitações e tempos de resposta aceitáveis.

Se o seu ambiente suporta mais de 100 usuários nomeados, é complexa,experimenta altos períodos de picos de uso, ou inclui qualquer combinação dessesfatores, considere concluir um plano de capacidade. Para obter mais informações,consulte Serviços de Software IBM para Cognos (www.ibm.com/software/analytics/cognos/services/).

Para determinar as configurações que melhor se adaptam ao seu ambiente, éaconselhado o teste de desempenho.

Use as seguintes configurações de memória como ponto de início e ajuste-asbaseado no uso da memória de seu sistema.v 2 GB para o sistema operacional de base e acompanhamento de software, como

antivírus, backup e software de gerenciamento corporativov 4 GB para um Content Manager JVM de 64 bitsv 4 GB for uma Camada de Aplicativo JVM de 64 bitsv 2 GB para os gráficos JVM (IBM Cognos Workspace)v 2-4 GB para o serviço de consulta (modo de consulta dinâmica) JVMv 1 GB por núcleo para os processos de serviços de relatório (modo de consulta

dinâmica) (JVM)v 1 GB por núcleo para os processos de serviços de relatório (modo de consulta

dinâmica) (JVM)

A seguinte tabela mostra as configurações de memória sugeridas pela camada dearquitetura de um sistema operacional de 64 bits.

30 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 43: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Tabela 5. Configurações de memória sugeridas por camadas de arquitetura

Camada de Arquitetura Definições de memória

Camada de Gateway do IBM Cognos 2 GB

Camada do aplicativo do IBM Cognos (modo de consultacompatível)

2 GB por núcleo

Camada do aplicativo do IBM Cognos (modo de consulta 4 GB + 1 GB por núcleo

Camada do IBM Cognos Content Manager Tier 4 GB

IBM DB2 Advanced Workgroup Server Edition 2 GB (Opção Instalação Rápida)

Mais recursos podem ser necessários quando se instala um software adicional.

IBM Cognos BI em ambientes de virtualização

IBM Cognos BI funciona como esperado na maioria das tecnologias devirtualização. Se a imagem estiver configurada e ajustada corretamente paraaplicativos IBM Cognos BI, o desempenho e a escalabilidade poderão sersemelhantes aos do aplicativo IBM Cognos BI no hardware físico. Sob altas cargas,a instância da VM pode requerer um número um pouco maior de núcleos do queum ambiente de hardware físico. Se você estiver mudando para um ambiente deVM, inclua 20 - 40% mais núcleos para assegurar que as altas cargas de pico dedesempenho não sejam afetadas.

Configurar valores de ulimit em sistemas operacionais UNIX eLinuxConfigurar valores de ulimit apropriados em seu sistema operacional UNIX eLinux pode afetar como o IBM Cognos Business Intelligence é executado.

Por exemplo, em sistemas operacionais Linux, os problemas que são causados porconfigurações de ulimit de pilha incluem erros de alto uso incomum de memóriade BIBusTKServerMain ou BIBusTKServerMain quando grandes relatórios sãoprocessados.v Se estiver usando o serviço de relatórios de 32 bits em sistemas operacionais

Linux, os relatórios podem falhar.v Se estiver usando o serviço de relatórios de 64 bits em sistemas operacionais

Linux, relatórios ou processos BIBusTKServerMain inativos em execução podemusar toda a sua RAM disponível.

Considerando que, em sistemas operacionais UNIX, podem surgir problemas se asconfigurações de ulimit de pilha forem muito baixas.

Assegurar as configurações de ulimit de pilha corretas pode evitar essesproblemas.

As configurações de ulimit recomendadas para uma nova instalação são como aseguir:

IBM AIX

v Tempo de CPU (segundos): ulimit -t unlimitedv Tamanho de arquivo (blocos): ulimit -f unlimitedv Tamanho máximo de memória (kbytes): ulimit -m unlimitedv Máximo de processos do usuário: ulimit -u unlimitedv Arquivos abertos: ulimit -n 8192 (valor mínimo)

Capítulo 3. Preparando para Instalar 31

Page 44: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

v Tamanho de pilha (kbytes): ulimit -s 8192 (valor mínimo)v Memória virtual (kbytes): ulimit -v unlimited

Sun Solaris

v Tempo de CPU (segundos): ulimit -t unlimitedv Tamanho de arquivo (blocos): ulimit -f unlimitedv Máximo de processos do usuário: ulimit -u unlimitedv Memória (kbytes): ulimit -m unlimitedv Arquivos abertos: ulimit -n 8192 (valor mínimo)v Tamanho de pilha (kbytes): ulimit -s 8192 (valor mínimo)v Memória virtual (kbytes): ulimit -v unlimited

HP-UX

v Tempo de CPU (segundos): ulimit -t unlimitedv Tamanho de arquivo (blocos): ulimit -f unlimitedv Memória (kbytes): ulimit -m unlimitedv Nofiles (descritores): ulimit -n 8192 (valor mínimo)v Tamanho de pilha (kbytes): ulimit -s 8192 (valor mínimo)

Linux (x e z)

v Tempo de CPU (segundos): ulimit -t unlimitedv Tamanho de arquivo (blocos): ulimit -f unlimitedv Tamanho máximo de memória (kbytes): ulimit -m unlimitedv Máximo de processos do usuário: ulimit -u unlimitedv Arquivos abertos: ulimit -n 8192 (valor mínimo)v Tamanho de pilha (kbytes): ulimit -s unlimitedv Memória virtual (kbytes): ulimit -v unlimited

Nota: Estas configurações podem precisar ser ajustadas para seu ambiente duranteo ciclo de vida do aplicativo.

Requisitos JavaPara suportar os serviços criptográficos no IBM Cognos Business Intelligence, podeser necessário atualizar sua versão do Java ou configurar uma variável de ambienteJAVA_HOME. Dependendo dos requisitos da sua política de segurança, tambémpoderá ser necessário instalar o arquivo de políticas Java Cryptography Extension(JCE) não restrito.

É possível usar um Java Runtime Environment (JRE) existente ou o JRE fornecidocom o IBM Cognos BI.

Padrões Criptográficos

Por padrão, o IBM Cognos BI está configurado para suportar o padrão desegurança NIST SP800-131a. Para ser compatível com este padrão de segurança,você deve utilizar um JRE que também suporta esse padrão.

O JRE que é fornecido para instalações no sistema operacional Microsoft Windowsnão suporta esse padrão. Se estiver utilizando outro JRE e desejar utilizar o padrãode segurança NIST SP800-131a, você deve assegurar que o JRE suporta o padrão.

32 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 45: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Para obter mais informações sobre as versões suportadas do Java para IBM CognosBI, consulte o página Relatórios de Compatibilidade de Produto IBM Software(www.ibm.com/support/docview.wss?uid=swg27042164).

Para obter mais informações sobre esta norma de segurança, consulte o IBM SDK,Java Technology Edition Knowledge Center (http://www-01.ibm.com/support/knowledgecenter/SSYKE2/welcome_javasdk_family.html).

JAVA_HOME

Defina uma variável de ambiente JAVA_HOME se:v Estiver instalando em um sistema operacional UNIX ou Linux.v Estiver instalando em sistemas operacionais Microsoft Windows e desejar usar o

seu próprio Java ou um pacote configurável Java com outro software. Porexemplo, se estiver instalando o IBM Cognos BI no WebSphere ApplicationServer.

Certifique-se de que a versão do JRE é suportada pelos produtos IBM Cognos.

Em sistemas operacionais Microsoft Windows, se não tiver uma variávelJAVA_HOME, os arquivos JRE que são fornecidos com a instalação são usados.

Para verificar se o JRE é suportado, consulte página Relatórios de Compatibilidadede Produto IBM Software (www.ibm.com/support/docview.wss?uid=swg27042164).

Arquivo de política irrestrita do JCE

Os JREs incluem um arquivo de políticas restrito que limita a determinadosalgoritmos criptográficos e conjuntos de cifras. Se você precisar de uma gamamaior de algoritmos criptográficos e conjuntos de cifras do que a mostrada no IBMCognos Configuration, é possível fazer o download e instalar o arquivo depolíticas irrestritas JCE.

Para o Java, que é fornecido pela IBM, o arquivo de política JCE irrestrito estádisponível no website na IBM (https://www14.software.ibm.com/webapp/iwm/web/preLogin.do?source=jcesdk).

Revisando as Configurações de Porta Padrão para o IBM CognosBusiness Intelligence

Depois da instalação, é possível utilizar a ferramenta de configuração para alteraras configurações. Também é possível alterá-las editando o arquivo cogstartup.xml.

Configurações de Porta Padrão para Componentes do IBMCognos BI

A tabela a seguir lista as configurações de porta e URI padrão para o IBM CognosBusiness Intelligence.

Tabela 6. Configurações de Porta Padrão para Componentes do IBM Cognos BI

Configuração Valor padrão Descrição

URI do Content Manager http://localhost:9300/p2pd/servlet

O URI do Content Manager

Capítulo 3. Preparando para Instalar 33

Page 46: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Tabela 6. Configurações de Porta Padrão para Componentes do IBM CognosBI (continuação)

Configuração Valor padrão Descrição

URI do gateway http://localhost:80/ibmcognos/cgi-bin/cognos.cgi

O URI do gateway

URI do dispatcher

(Interno, Externo)

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

O URI do dispatcher

URI do dispatcher paraaplicativos externos

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

O URI do dispatcher

URIs de dispatchers dogateway

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

O URI para o primeirodispatcher utilizado pelogateway

Porta do servidor de log 9362 A porta utilizada peloservidor de log local

Número de porta de escuta 1527 A porta usada pelo Banco dedados de conteúdo doCognos

Definições padrão de porta para Migration

A tabela a seguir lista as configurações padrão usadas na migração do IBM CognosSeries 7 para o IBM Cognos BI PowerPlay.

Tabela 7. Definições padrão de porta para Migration

Configuração Porta Descrição

Número da porta do serviçode migração

21567 A porta usada para as comunicações entreo serviço de migração do IBM CognosSeries 7 e o serviço de migração do IBMCognos BI

PPBOOKMARKTOOL_PORT 7777 A porta utilizada para migração demarcadores

Diretrizes para Criar o Armazenamento de ConteúdoO armazenamento de conteúdo é um banco e dados que o Content Manager usapara armazenar dados de configuração globais, definições globais (como osformatos de idioma e moeda exibidos na interface com o usuário), conexões aorigens de dados e conteúdo específico de produtos. É necessário usar um dosbancos de dados de nível empresarial suportados como o armazenamento deconteúdo em um ambiente de produção.

Não use o Banco de Dados de Conteúdo do Cognos para o armazenamento deconteúdo em um ambiente de produção. O Banco de Dados de Conteúdo doCognos é fornecido para ajudá-lo a configurar rapidamente um teste de sistema deprova de conceito.

Modelos de projeto e arquivos de log não são guardados no armazenamento deconteúdo.

34 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 47: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Você deverá criar o armazenamento de conteúdo antes que seja possível usar oproduto IBM Cognos Business Intelligence. Se você usar a opção Instalação Rápida,o DB2 Advanced Workgroup Server Edition está instalado e configurado para serusado como seu armazenamento de conteúdo.

Se você estiver usando sua própria instância do IBM DB2 para o seuarmazenamento de conteúdo, é possível gerar um DDL para permitir que seuadministrador de banco de dados crie um banco de dados DB2 adequado para oarmazenamento de conteúdo. Para obter mais informações, consulte “Gerando umArquivo de Script para Criar um Banco de Dados para um Armazenamento deConteúdo do DB2” na página 73.

Propriedades do Banco de Dados

Você deve criar o banco de dados de armazenamento de conteúdo usando um dosbancos de dados listados na seguinte tabela.

A tabela a seguir mostra a codificação de caracteres e o protocolo que são usadospor diferentes tipos de bancos de dados.

Tabela 8. Codificação de Caracteres e Protocolos para o Banco de Dados deArmazenamento de Conteúdo

Banco de Dados Codificação de caracteres Protocolo

DB2 UTF-8 TCP/IP

Oracle AL32UTF8 ou AL32UTF16 TCP/IP

Microsoft SQL Server UTF-8 ou UTF-16 TCP/IP

Informix UTF-8 TCP/IP

Sybase UTF-8 TCP/IP

Banco de Dados deConteúdo do Cognos

pré-configurado pré-configurado

DB2 Advanced WorkgroupServer Edition a partir daopção Instalação Rápida

pré-configurado pré-configurado

Se você planeja usar o Cognos Content Database como seu armazenamento deconteúdo, um banco de dados será criado e pré-configurado quando a instalaçãofor concluída.

Sequência de Ordenação

O Cognos BI usa uma única ordem de classificação que especifica as regras usadaspelo banco de dados para interpretar, coletar, comparar e apresentar os dados decaractere. Por exemplo, uma ordem de classificação define se a letra A é menor,igual ou maior que a letra B; se a ordenação diferencia maiúsculas de minúsculas eacentos. Para obter informações adicionais sobre ordenação e sequências deordenação, consulte o website ICU - International Components for Unicode(http://site.icu-project.org/), selecione o Guia do Usuário e procure porOrdenação.

Capítulo 3. Preparando para Instalar 35

Page 48: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Configurações Sugeridas para Criar o Armazenamento deConteúdo no DB2 Sistemas Operacionais Linux, Windows eUNIX

O banco de dados criado nos sistemas operacionais Microsoft Windows, Linux ouUNIX para o armazenamento de conteúdo deve conter as definições deconfiguração especificadas.

Nota: Este tópico se aplica apenas a sua própria instância de DB2. Se você usar aopção Instalação Rápida, o DB2 Advanced Workgroup Server Edition é instalado econfigurado para você.

Para garantir uma instalação com sucesso, siga as seguintes diretrizes ao criar oarmazenamento de conteúdo. Use as mesmas diretrizes para criar um banco dedados para registrar mensagens.

Arquivos de Biblioteca para DB2

Certifique-se de usar os arquivos de biblioteca apropriados para a versão doservidor IBM Cognos Business Intelligence que instalar. O IBM Cognos BI requerarquivos de biblioteca de 32 bits ao ser executado em um servidor de aplicativosde 32 bits e requer arquivos de biblioteca de 64 bits ao ser executado em umservidor de aplicativos de 64 bits. Dependendo da versão do DB2 instalada, poderáser necessário alterar os arquivos de biblioteca ou alterar a ordem na qual osarquivos de biblioteca estão listados, para que o servidor IBM Cognos BI possalocalizar os arquivos corretos. Qualquer que seja a versão necessária dos arquivosde biblioteca, ela deverá ser listada primeiro.

Diretrizes para Criar o Armazenamento de Conteúdo

Use a lista de verificação a seguir para ajudá-lo a configurar o armazenamento deconteúdo no DB2.v Configure as variáveis de ambiente apropriadas para DB2, que são mostradas na

tabela a seguir.

Tabela 9. Variáveis de Ambiente para o DB2

Variável do ambiente Descrição

DB2PATH O diretório de nível superior que contém osoftware do cliente de banco de dados ou ainstalação do banco de dados inteiro.

36 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 49: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Tabela 9. Variáveis de Ambiente para o DB2 (continuação)

Variável do ambiente Descrição

LD_LIBRARY_PATH O caminho da biblioteca de carregamento.Você deve incluir o local do driver e indicaros arquivos de biblioteca de 32 bits ou 64bits conforme apropriado para seu servidorde aplicativos.

Por exemplo, (substituir o símbolo de hashduplo pelo valor do arquivo de biblioteca,32 bits ou 64 bits), 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

DB2INSTANCE A conexão padrão do servidor de banco dedados.

DB2CODEPAGE A definição dessa variável de ambienteopcional a um valor de 1208 oferece suportepara bancos de dados multilíngues.

Para obter informações sobre o uso dessavariável de ambiente, consulte adocumentação do DB2.

v 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 possui o conjunto de códigos correto, use ainterface da linha de comandos e digite o seguinte no prompt de comandos:configuração do banco de dados db2 get para database_name

O valor do conjunto de códigos é UTF-8 e o valor da página de códigos é 1208.v Certifique-se de definir os parâmetros de configuração conforme mostrado na

tabela a seguir.

Tabela 10. Parâmetros de Configuração para o DB2

Propriedade Configuração

Tamanho da memória temporária doaplicativo

(applheapsz)

AUTOMATIC ou pelo menos 1024 KB

Se o valor do tamanho de intervalo doaplicativo for muito pequeno, erros de faltade memória podem ocorrer quando houvermuitos usuários.

Capítulo 3. Preparando para Instalar 37

Page 50: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Tabela 10. Parâmetros de Configuração para o DB2 (continuação)

Propriedade Configuração

Tempo limite de bloqueio (locktimeout) 240 segundos

Não defina esta opção com um valor delimite de tempo infinito.

Variável de registro DB2(DB2_INLIST_TO_NLJN)

SIM

Definir essa variável como SIM melhora odesempenho.

v Crie um buffer pool com um tamanho de página de 32 KB e um segundo comum tamanho de página de 8 KB.

v Crie um tablespace temporário de sistema utilizando o pool de buffer de 32 KBcriado na etapa anterior.

v Crie um espaço de tabela temporário de usuário utilizando o buffer pool de 8KB criado.Serão criadas tabelas temporárias globais no espaço de tabela temporário dousuário.

v Crie um espaço de tabela comum de usuário utilizando o buffer pool de 8 KBcriado.Se estiver criando um banco de dados de criação de log, crie um tablespace deusuário comum adicional com um tamanho de página de 8 KB.

v Conceda os seguintes privilégios do banco de dados para a conta do usuário queo IBM Cognos BI usará para acessar o banco de dados:– Conectar-se ao banco de dados– Criar tabelas– Criar esquemas implicitamente

Dica: Se desejar hospedar mais de um armazenamento de conteúdo na instânciado DB2 e usar os dois ao mesmo tempo, use uma conta do usuário diferentepara cada armazenamento de conteúdo para garantir que cada instância do IBMCognos BI seja totalmente isolada da outra.

v Certifique-se que a conta do usuário tenha privilégios de uso para o tablespacede usuário temporário e outros tablespaces adequados associados com o bancode dados.

v Crie um esquema para a conta do usuário que o IBM Cognos BI usará paraacessar o banco de dados e garantir que o usuário tenha permissões para criar,descartar e alterar o esquema.

v Crie um perfil que origine o sqllib/db2profile a partir do diretório inicial dousuário do DB2. Por exemplo, o conteúdo do seu perfil será semelhante aoseguinte:

if[ -f /home/db2user/sqllib/db2profile ]; then./home/db2user/sqllib/db2profilefi

v Seu administrador de banco de dados deve fazer backup dos bancos de dadosdo IBM Cognos BI regularmente porque eles contêm os dados do IBM Cognos.Para garantir a segurança e integridade dos bancos de dados, proteja-os deacesso não autorizado ou inadequado.

38 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 51: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Configurações Sugeridas para Criar o Armazenamento deConteúdo no DB2 no z/OS

O banco de dados criado para o armazenamento de conteúdo deve conter asdefinições de configuração especificadas.

Para garantir uma instalação com sucesso, siga as seguintes diretrizes ao criar oarmazenamento de conteúdo.

Use a lista de verificação a seguir para ajudá-lo a configurar o armazenamento deconteúdo no DB2 no z/OS.v Efetue logon no sistema z/OS como um usuário com privilégios de

Administrador do Sistema (SYSADM) ou Controle do Sistema (SYSCTRL) noDB2 para criar o banco de dados.

v Crie uma instância do banco de dados, um grupo de armazenamento e umaconta de usuário para o armazenamento de conteúdo.O IBM Cognos Business Intelligence usa as credenciais da conta do usuário paracomunicar-se com o servidor de banco de dados.

v Assegure-se de reservar um buffer pool com um tamanho de página de 32 KB, eum segundo com um tamanho de página de 4 KB para a instância de banco dedados.

v Os administradores devem executar um script para criar espaços de tabela paramanter Objetos Grandes e outros dados para o armazenamento de conteúdo econceder ao usuário os direitos aos espaços de tabela. Para obter maisinformações sobre como executar o script, consulte “Criando Espaços de Tabelapara um Armazenamento de Conteúdo no DB2 para z/OS” na página 74.

v Seu administrador de banco de dados deve fazer backup do armazenamento deconteúdo regularmente porque ele contém as informações de aplicativo de dadose de segurança do IBM Cognos. Para garantir a segurança e integridade dobanco de dados de armazenamento de conteúdo, proteja-o de acesso nãoautorizado ou inapropriado.

Configurações Sugeridas para Criar o Armazenamento deConteúdo no Oracle

O banco de dados criado para o armazenamento de conteúdo deve conter asdefinições de configuração especificadas.

Para garantir uma instalação com sucesso, siga as seguintes diretrizes ao criar oarmazenamento de conteúdo. Use as mesmas diretrizes para criar um banco dedados para registrar mensagens.

Use a lista a seguir para ajudá-lo a configurar o armazenamento de conteúdo noOracle.v 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çãoCOMPATIBLE emitindo a seguinte instrução SQL:SELECT name, value, description FROM v$parameter WHERE name=’compatible’;

Para obter informações sobre como alterar um parâmetro de configuração deinstância, consulte a documentação do Oracle.

v Determine se o banco de dados é Unicode.

Dica: Um método é digitar a seguinte instrução select:

Capítulo 3. Preparando para Instalar 39

Page 52: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

select * from NLS_DATABASE_PARAMETERS

Se o conjunto de resultados gerar um NLS_CHARACTERSET que não sejaUnicode, crie um novo banco de dados e especifique AL32UTF8 nos parâmetrosde conjunto de caracteres do banco de dados.

v Determine qual conta do usuário será usada para acessar o banco de dados.

Dica: Se quiser hospedar mais de um armazenamento de conteúdo em suainstância Oracle e você for usá-los ao mesmo tempo, use uma conta de usuáriodiferente para cada armazenamento de conteúdo para assegurar que cadainstância do IBM Cognos Business Intelligence esteja integralmente isolada dasoutras.

v Certifique-se de que a conta de usuário que acessa o banco de dados tenhapermissão para executar o seguinte:– Conectar-se ao banco de dados– Criar, alterar e descartar acionadores, visualizações, procedimentos e

sequências– Criar e alterar tabelas– Inserir, atualizar e excluir dados nas tabelas de banco de dados

v Seu administrador de banco de dados deve fazer backup dos bancos de dadosdo IBM Cognos BI regularmente porque eles contêm os dados do Cognos. Paragarantir a segurança e integridade dos bancos de dados, proteja-os de acesso nãoautorizado ou inadequado.

Configurações Sugeridas para Criar o Armazenamento deConteúdo no Microsoft SQL Server

O banco de dados criado para o armazenamento de conteúdo deve conter asdefinições de configuração especificadas.

Para garantir uma instalação com sucesso, siga as seguintes diretrizes ao criar oarmazenamento de conteúdo. Use as mesmas diretrizes para criar um banco dedados para registrar mensagens.

Use a seguinte lista de verificação para ajudá-lo a configurar o armazenamento deconteúdo no Microsoft SQL Server.v Verifique se a sequência de ordenação faz distinção entre maiúsculas e

minúsculas.Em uma instalação Customizada, você escolhe uma ordenação, que inclui osconjuntos de caracteres e a ordem de classificação, durante a configuração doMicrosoft SQL Server. Na instalação típica, o código do idioma identificado peloprograma de instalação é usada para a ordenação. Esta definição não pode seralterada mais tarde.

v Ao se conectar ao Microsoft SQL Server Management Studio para criar o bancode dados, use a autenticação do Microsoft SQL Server.Se você se conectar usando a autenticação do sistema operacional MicrosoftWindows, o banco de dados criado também usará a autenticação do Windows.Nesse caso, você deverá configurar a conexão do banco de dados usando umtipo de banco de dados do SQL Server (Autenticação do Windows) no IBMCognos Configuration.

v Para a conta de usuário que será utilizada para acessar o banco de dados, crieum novo login em Segurança e utilize as seguintes configurações:– Selecione Autenticação do SQL Server.

40 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 53: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

– Desmarque a caixa de seleção Enforce password policy.

Dica: Se desejar hospedar mais de um armazenamento de conteúdo na suainstância do Microsoft SQL Server e for usar mais de um ao mesmo tempo, useuma conta do usuário diferente para cada armazenamento de conteúdo paragarantir que cada instância do IBM Cognos Business Intelligence fiquecompletamente isolada das outras.

v Para o Microsoft SQL Server 2008, conceda permissão de EXECUÇÃO para aconta do usuário que acessa o banco de dados.

v Para o banco de dados de armazenamento de conteúdo, crie um novo banco dedados em Bancos de dados.

v Em Segurança para o novo banco de dados, crie um novo esquema e atribua umnome a ele.

v Em Segurança para o novo banco de dados, crie um novo usuário com asseguintes configurações:– Para Nome de login, 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 deconteúdo no servidor de banco de dados IBM Informix

O banco de dados que criar para o armazenamento de conteúdo IBM CognosBusiness Intelligence deve conter definições de configuração específicas.

Use as diretrizes a seguir ao criar o armazenamento de conteúdo. Use as mesmasdiretrizes para criar um banco de dados para registrar mensagens.

Use a lista de verificação a seguir para ajudar a configurar o armazenamento deconteúdo no banco de dados do servidor de banco de dados do IBM Informix.v Defina as seguintes variáveis de ambiente:

– Configure GL_USEGLU para 1 para ativar o International Components forUnicode (ICU) no servidor de banco de dados Informix.

– Configure DB_LOCALE para en_us.utf8 para configurar o código de idioma dobanco de dados para Unicode.

v Crie um banco de dados no modo ANSI e com o login ativado.v Para a conta de usuário utilizada para acessar o banco de dados, conceda o

privilégio de banco de dados DBA.

Importante: Se você hospedar mais que um banco de dados na sua instância doInformix e usá-los ao mesmo tempo, use uma conta do usuário diferente paracada banco de dados. Você também deve definir a conta do usuário em cadainstância do aplicativo IBM Cognos Configuration, criando um parâmetro depropriedade avançada e especificando a conta do usuário como o valor. Paradiversos bancos de dados de armazenamento de conteúdo, nomeie apropriedade CMSCRIPT_CS_ID. Para diversos bancos de dados de criação de logs,nomeie a propriedade IPFSCRIPTIDX.

Capítulo 3. Preparando para Instalar 41

Page 54: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Configurações Sugeridas para Criar o Armazenamento deConteúdo no Sybase

O banco de dados criado para o armazenamento de conteúdo deve conter asdefinições de configuração especificadas.

Para garantir uma instalação com sucesso, siga as seguintes diretrizes ao criar oarmazenamento de conteúdo. Use as mesmas diretrizes para criar um banco dedados para registrar mensagens.

Utilize a lista de verificação a seguir para ajudar na configuração doarmazenamento de conteúdo no Sybase.v 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.

v Se necessário, instale o jConnect 6.Essa ferramenta configura a comunicação entre o driver JDBC e a instância doSybase Adaptive Server.Para obter instruções, consulte a documentação do Sybase.Se sua versão do Sybase não incluir JConnect 6, você deverá fazer o downloaddo instalador a partir do Web site do Sybase.

v Adicione o conjunto de caracteres UTF-8 na instância do servidor.v Se necessário, torne UTF-8 o conjunto de caracteres padrão do servidor.v Crie um dispositivo de banco de dados.

Dica: Configure log_segment para no mínimo 10 MB.v Configure o novo dispositivo de banco de dados como o padrão.

Informações sobre o novo banco de dados serão armazenadas no novodispositivo de banco de dados. Mantenha um backup do dispositivo de bancode dados para fins de recuperação.

v Crie o banco de dados.v Determine qual conta de usuário será usada para acessar o banco de dados.

Dica: Se quiser hospedar mais de um armazenamento de conteúdo em suainstância Sybase e você for usá-los ao mesmo tempo, use uma conta de usuáriodiferente para cada armazenamento de conteúdo para assegurar que cadainstância do IBM Cognos Business Intelligence esteja integralmente isolada dasoutras.

v Certifique-se de que a conta de usuário tenha os seguintes privilégios para obanco de dados: criar padrão, criar procedimento, criar regra, criar tabela e criarvisualização.

v 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

42 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 55: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Configuração de uma Conta de Usuário ou Conta de Serviço de Redepara o IBM Cognos Business Intelligence

É possível configurar uma conta do usuário ou uma conta de serviço de rede parao IBM Cognos Business Intelligence.

A conta de usuário ou de serviço de rede que o IBM Cognos BI executa deve:v Ter acesso a todos os recursos necessários, como impressoras.v 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 da rede, a contadeve possuir acesso à impressora da rede ou você deve designar uma conta delogon para o serviço do IBM Cognos.

Configuração de contas de usuário

Para o sistema operacional Microsoft Windows, designe uma conta de logon para oserviço do IBM Cognos. É possível configurar o serviço do IBM Cognos para usaruma conta do usuário especial ao selecionar o serviço do IBM Cognos na lista deserviços mostrada na janela Serviços no Windows. Em seguida, pode-se definir aspropriedades da conta de usuário.

Nos sistemas operacionais UNIX ou Linux crie um novo grupo chamado UNIX ouLinux cognos, por exemplo. Esse grupo deve conter o usuário que possui osarquivos do IBM Cognos. Altere a propriedade do grupo dos arquivos IBM Cognospara o grupo cognos e altere as permissões de arquivo para todos os arquivos IBMCognos para GROUP READABLE/WRITABLE/EXECUTABLE.

Configure o servidor web para utilizar aliases. Para obter mais informações,consulte o Guia de Instalação e Configuração do IBM Cognos BI.

Configuração de contas de serviço de rede

A conta de serviço de rede é a conta integrada NT AUTHORITY\NetworkServiceno sistema operacional. Os administradores não precisam gerenciar uma senha oumanter a conta.

Use uma conta com privilégios de administrador se estiver instalando no WindowsServer 2008.

Configure o servidor web para utilizar pool de aplicativos. Para obter informaçõesadicionais, consulte o Guia de Instalação e Configuração do IBM Cognos BusinessIntelligence. Também é necessário ter permissões de gravação para fazer instalaçõesno diretório.

Configuração de navegadores webProdutos IBM Cognos Business Intelligence usam configurações de navegadorpadrão. As configurações adicionais solicitadas são específicas para o navegador.

Capítulo 3. Preparando para Instalar 43

Page 56: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Configurações de Navegador Necessárias para o Portal do IBMCognos BI

A seguinte tabela mostra as configurações que devem ser habilitadas.

Tabela 11. Configurações do Navegador Ativadas para oIBM Cognos BI Portal

Navegador Configuração Componente do IBM Cognos

Internet Explorer(configurações parastudios e portais)

Permitir cookies

Criação ativa de scripts

Permissão de META REFRESH

IBM Cognos Connection

IBM Cognos Administration

Cognos Viewer

Event Studio

PowerPlay Studio

IBM Cognos Workspace

IBM Cognos WorkspaceAdvanced

Firefox Permitir cookies

Ativar Java

Ativar JavaScript

Carregar imagens

IBM Cognos Connection

IBM Cognos Administration

Cognos Viewer

Report Studio

Analysis Studio

PowerPlay Studio

IBM Cognos Workspace

IBM Cognos WorkspaceAdvanced

Safari 5 Ativar Java

Ativar JavaScript

Não Bloquear a Janela Pop-upWindows

Bloquear Cookies: Nunca

IBM Cognos Connection

Cognos Viewer

IBM Cognos Workspace

Google Chrome Cookies: Permitir que dadoslocais sejam configurados

Imagens: Mostrar todas asimagens

JavaScript: Permitir que todosos sites executem JavaScript

Pop-ups: Permitir que todos ossites mostrem pop-ups

IBM Cognos Connection

Cognos Viewer

IBM Cognos Workspace

Caso o Adblock Plus esteja instalado com o Firefox, desative-o utilizando a opçãopor página. Adblock Plus impede alguns recursos do IBM Cognos Connection detrabalharem corretamente.

44 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 57: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Se usar o Microsoft Internet Explorer Versão 8, é possível receber erros de link doAdobe ao abrir documentos PDF no portal do IBM Cognos. Para impedir que esseserros ocorram, no Internet Explorer, no menu Ferramentas, selecione GerenciarComplementos e desative o Adobe PDF Reader Link Helper.

Se usar um navegador da Web Microsoft Internet Explorer, é possível incluir a URLpara o(s) gateway(s) na lista de Sites Confiáveis. Por exemplo,http://<server_name>:<port_number>/ibmcognos. Isso permite o promptautomático com relação a downloads de arquivos.

Para obter mais informações, consulte “IBM Cognos Application Firewall” napágina 217.

Para obter informações adicionais, consulte o tópico sobre configuração do IBMCognos Application Firewall na publicação IBM Cognos Business IntelligenceInstallation and Configuration Guide.

Cookies Usados pelos Componentes do IBM Cognos BI

IBM Cognos BI usa os seguintes cookies para armazenar informações do usuário.

Tabela 12. Cookies Usados pelos Componentes do IBM Cognos BI

Cookie Tipo Finalidade

AS_TICKET Sessão temporária Criado se o IBM Cognos BIestiver configurado para usarum namespace IBM CognosSeries 7

caf Sessão temporária Contém informações desegurança de estado

Cam_passport Sessão temporária Armazena uma referênciapara uma sessão do usuárioarmazenada no servidor doContent Manager.

Os administradores podemconfigurar o atributoHTTPOnly para bloquearscripts de leitura oumanipulação do cookie depassaporte do CAM duranteuma sessão do usuário comseu navegador da Web.

Para obter informaçõesadicionais, consulte o Guia deAdministração e Segurança doIBM Cognos BusinessIntelligence.

cc_session Sessão temporária Contém informações desessão específicas do IBMCognos Connection

cc_state Sessão temporária Mantém as informaçõesdurante as operações deedição, tais como recortar,copiar e colar.

Capítulo 3. Preparando para Instalar 45

Page 58: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Tabela 12. Cookies Usados pelos Componentes do IBM Cognos BI (continuação)

Cookie Tipo Finalidade

CRN Sessão temporária Contém informações decódigo de idioma do produtoe conteúdo e estáconfigurado para todos osusuários do IBM Cognos

CRN_RS Persistente Armazena a opção que ousuário faz para a pasta demembros de visualização noReport Studio

PAT_CURRENT_ FOLDER Persistente Armazena o caminho dapasta atual se for usado oacesso de arquivo local, e éatualizado após as caixas dediálogo Abrir ou Salvarforem usadas

pp_session Sessão temporária Armazena informações desessão específicas doPowerPlay Studio

qs Persistente Armazena as configuraçõesfeitas pelo usuário paraelementos de interface comomenus e barras deferramentas

userCapabilities Sessão temporária Contém todos os recursos e aassinatura do usuário atual

usersessionid Sessão temporária Contém um identificador desessão de usuário exclusivo,válido para a duração dasessão do navegador.

FrameBorder

PageOrientation

PageSize

PDFLayerDimension

PDFOPTS

Sessão temporária Esses cookies armazenam aspreferências para exportarpara PDF.

DimTreeToolbarVisible Persistente Armazena a configuraçãoque determina se deve exibirou ocultar a barra deferramentas de exibição dadimensão.

cea-ssa Sessão temporária Armazena a configuraçãoque determina se asinformações de sessão dousuário são compartilhadascom outros componentes doIBM Cognos BI.

BRes Sessão temporária Armazena informaçõesusadas para determinar aresolução de tela a ser usadapara processar gráficos.

46 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 59: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Após atualizar ou instalar um novo software, reinicie o navegador web e avise aosusuários para limparem o cache de seus navegadores.

Capítulo 3. Preparando para Instalar 47

Page 60: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

48 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 61: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Capítulo 4. Atualizar o IBM Cognos Business Intelligence

Os aprimoramentos em novas versões do IBM Cognos Business Intelligence (BI)podem afetar várias partes de seu ambiente de inteligência de negócios. Portanto, émelhor executar o upgrade em estágios. Para assegurar o sucesso, trate o upgradecomo um projeto de TI que requer planejamento cuidadoso, tempo adequado erecursos adequados.

Website do Cognos Upgrade Central

O website da Central de Atualização do Cognos (http://www.ibm.com/software/analytics/cognos/customercenter/upgrade.html) fornece informações adicionaispara ajudá-lo a atualizar. Por exemplo, as perguntas mais frequentes, os vídeos dedemonstração e os links para recursos adicionais estão disponíveis no website.

Processo de UpgradeCada upgrade requer um plano e cada plano segue o mesmo processo de upgradebásico.

Você deve planejar seu upgrade para que saiba o que esperar em cada estágio doprocesso. No estágio de planejamento, reveja a documentação de atualização parainformações sobre comportamento esperado, novos recursos, recursosdescontinuados, compatibilidade entre versões e exigências para preparar seuambiente de produção. Quando terminar a revisão, conduza uma pesquisa localpara identificar a infra-estrutura do BI, aplicativos, relatórios e definições deconfiguração customizadas. Finalmente, é possível testar o upgrade em umsubconjunto de dados, para que seja possível otimizar os relatórios e os dadosantes de assumir compromisso com o upgrade integral.

Ao planejar seu upgrade, assegure-se de executar as tarefas a seguir:v Reúna as informações necessárias, como entradas necessárias e saídas esperadas

para cada fase.v Avalie os aplicativos em seu ambiente de relatório e agrupe os relatórios

semelhantes.v Instale o novo software em um ambiente de teste e implemente o conteúdo para

o ambiente de teste.v Teste os aplicativos atualizados para assegurar que seus relatórios são

executados conforme o esperado.É possível usar o Lifecycle Manager para comparar os relatórios a partir de umaversão diferente do IBM Cognos BI. Para obter informações adicionais, consultea documentação do Lifecycle Manager.

A implantação e o teste são em geral um processo repetitivo. Avalie as diferençasentre os ambientes de origem e de destino. Vá até seu ambiente de produçãoquando estiver certo de que os aplicativos implantados tenham correspondido àssuas exigências de negócios.

O diagrama a seguir mostra um fluxo de trabalho de upgrade geral e os estágiosno processo de upgrade. O processo inclui os estágios a seguir:v Criar um plano de upgrade, que inclua as atividades a seguir:

© Copyright IBM Corp. 2005, 2014 49

Page 62: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

– Revisar recursos, como a documentação e o website da Central de Atualizaçãodo Cognos (www.ibm.com/software/analytics/cognos/customercenter/upgrade.html)

– Verificar os ambientes suportados para garantir a compatibilidade com outrossoftware acessando os página Relatórios de Compatibilidade de Produto IBMSoftware (www.ibm.com/support/docview.wss?uid=swg27042164). Vocêtambém pode querer verificar esta página se estiver pensando em atualizar osistema operacional.

– Avaliar seu sistema existente para determinar se deseja mover sua novaversão do produto.

– Criar um plano detalhado para implementar sua estratégia de upgrade.v Criar um desenvolvimento ou sistema de teste com a nova versão do produto.v Usar as informações aprendidas do desenvolvimento ou sistema de teste e

aplicá-las conforme cria seu QA ou sistemas de produção.

Revisar recursos» FAQs» Documentação» Ambientes suportados

Avaliar o sistema existente» Auditorias» Pesquisas de opinião» Recursos disponíveis

Plano de upgrade detalhado» Marcos» Testando» Recursos

A) Preparar: Criar um plano de upgrade1 2 3

1

B) Validar: Crie um teste or development system

Atualizar o armazenamento de 2

3

4

5

6

1

C) Executar: Crie um QA ou sistema de produção

2

3

4

5

6

Aplicar lições aprendidasconforme criar um QA ou o sistema de produção

D) Alavancar: Adotar novos recursos

Revisar a documentação de novos recursos

Figura 6. Processo de Upgrade

50 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 63: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Revisando a DocumentaçãoA documentação é fornecida de várias fontes para ajudá-lo a executar um upgradecom êxito.

Toda a documentação está disponível online no Centro de Informações do IBMCognos (http://pic.dhe.ibm.com/infocenter/cogic/v1r0m0/index.jsp).

Procedimento1. Leia a seção O que há de novo neste guia.

Essa seção contém uma lista de recursos novos, alterados, substituídos eremovidos para esta liberação.

2. Leia o restante das Informações de atualização neste documento.3. A partir do IBM Cognos Knowledge Center (http://www-01.ibm.com/

support/knowledgecenter/SSEP7J_10.2.2/com.ibm.swg.ba.cognos.cbi.doc/welcome.html), revise as versões mais recentes da documentação listada natabela a seguir.

Tabela 13. Lista da Documentação de Upgrade

Documento Informações pelas quais procurar

Notas Sobre a Liberação do IBM CognosPowerPlay

Problemas recentes que podem afetar umupgrade

IBM Cognos Business Intelligence New Features Novos recursos que podem afetar ocomportamento do conteúdo existente

Guia do Usuário do IBM Cognos FrameworkManager

Modelos de atualização.

Guia do Usuário do IBM Cognos Transformer Atualizando Visualizações do Usuário eModelos do IBM Cognos Series 7

Guia do Usuário do IBM Cognos MigrationAssistant

Movendo o conteúdo de IBM Cognos Series7 para IBM Cognos BI.

A última liberação das ferramentas demigração foi a versão 10.1.1. É possível usaressas ferramentas para migrar para o IBMCognos Business Intelligence versão 10.1.1(Report Studio ou Analysis Studio) e, emseguida, atualizar o conteúdo migrado paraIBM Cognos BI versão 10.2.0.

É possível também usar as ferramentas demigração para migrar o conteúdo do Series 7PowerPlay para IBM Cognos BIPowerPlayversão 10.2.0.

Guia do Usuário do IBM Cognos LifecycleManager

Usando o Lifecycle Manager para auditar osupgrades de teste.

Aplicativos de Avaliação em seu Ambiente antes do UpgradeA preparação para o upgrade fornece uma oportunidade de revisar seus aplicativosexistentes e limpar o ambiente de origem.

Por exemplo, você pode ter vários aplicativos em seu ambiente. No entanto, não éraro localizar diversos aplicativos não usados ou que não atendem mais aosrequisitos.

Capítulo 4. Atualizar o IBM Cognos Business Intelligence 51

Page 64: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Avaliar os seus aplicativos é um exercício útil porque pode reduzir o número deaplicativos a serem considerados durante um upgrade.

Uma auditoria de seus aplicativos existentes pode incluir as tarefas a seguir:v Execute uma pesquisa de opinião do site para avaliar o ambiente de produção

atual e identificar as áreas que requerem atenção durante o upgrade. A pesquisado site inclui informações sobre a infraestrutura, os aplicativos, os usuários e asdefinições de configuração.

v Avalie o software que você usa em seu ambiente e crie uma lista do software,como sistemas operacionais, servidores da web, provedores de segurança ebancos de dados.Para revisar uma lista atualizada de ambientes suportados pelos produtos IBMCognos Business Intelligence, incluindo informações sobre sistemas operacionais,correções, navegadores, servidores da web, servidores de diretórios, servidoresde banco de dados e servidores de aplicativos, consulte a página Relatórios deCompatibilidade de Produto IBM Software (www.ibm.com/support/docview.wss?uid=swg27042164).

v Complete uma avaliação detalhada de seus aplicativos. A utilização, idade, otamanho e a complexidade de seus aplicativos são fatores importantes de seconsiderar ao planejar a atualização. O tamanho total dos aplicativos pode terum impacto no tempo necessário para concluir o upgrade.

v Liste as seguintes informações sobre suas configurações:– As definições de configuração que você ativou no IBM Cognos Configuration

Instalar a nova versão do produto em um local diferente da versão existentepermite comparar as definições entre as duas versões. Para executar as duasversões, você deve assegurar-se de usar os números de porta exclusivos, osalias do servidor da web e os bancos de dados de armazenamento deconteúdo.

– Mudanças em outros arquivos de configuraçãoVocê deve alterar manualmente os outros arquivos de configuração durante oupgrade. Se alterou outros arquivos de configuração. avalie as mudanças quedeseja preservar no ambiente atualizado. Isso pode incluir os arquivos .xml,.txt e .css nos diretórios configuration, templates, webapps e webcontent.

Nota: Se você modificou os arquivos .ini, entre em contato com o Suporte aoCliente para determinar se as mudanças são suportadas na versão dosoftware.

v Faça backup do seu banco de dados de armazenamento de conteúdo.

Depois que a sua auditoria for concluída, será possível criar um plano de upgrade.

Diretrizes ao Atualizar o Sistema Operacional

Você pode querer levar em consideração as seguintes diretrizes antes de atualizarpara uma versão mais recente do sistema operacional nos computadores em que oIBM Cognos BI está instalado:v Verifique página Relatórios de Compatibilidade de Produto IBM Software

(www.ibm.com/support/docview.wss?uid=swg27042164) para assegurar que aversão do IBM Cognos BI suporte a versão do sistema operacional para a qualestá pensando em mudar.

v Certifique-se de que o software de terceiros usado pelo IBM Cognos BI sejasuportado na versão do sistema operacional proposto. O software de terceiros

52 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 65: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

incluiria componentes como banco de dados e driver de banco de dados,servidores de aplicativos, servidores da web e navegadores.

v Determine se você deve recompilar os aplicativos de SDK do IBM Cognos BI.v Determine se você deve recriar as implementações da web, que incluem os

arquivos do archive web (.war) e os arquivos do archive corporativo (.ear).

Acessar Conteúdo de uma Versão Anterior no PortalÉ possível visualizar o conteúdo de uma versão anterior do IBM Cognos BI nanova versão ativando coexistência de diversas versões.

Ativar a coexistência de diversas versões pode ajudar a fornecer uma experiênciamais direta por meio do processo de upgrade intermediando o upgrade. É possívelfornecer TI com a capacidade de abordar demandas de negócios para recursos nanova versão. E, ao mesmo tempo, fornecer a flexibilidade para planejar umupgrade do aplicativo com a capacidade de seu departamento de TI.

Para obter informações adicionais, consulte Como Acessar Conteúdo de LiberaçãoAnterior do IBM Cognos a partir do Portal do IBM Cognos 10 no website da IBM(https://www.ibm.com/support/docview.wss?uid=swg21459041).

Tarefas de AtualizaçãoAo atualizar, execute as tarefas a seguir:1. Instale e configure a nova versão do produto.2. Mova seu conteúdo para a nova versão do produto.3. Atualize suas especificações de relatório.4. Compare o seu conteúdo atualizado para o conteúdo existente para assegurar a

consistência.

Instalar e Configurar uma Nova Versão do ProdutoInstale a nova versão do produto em um novo local. O local pode ser no mesmocomputador que sua versão existente do produto ou em outro computador.

Instalar em um novo local permite manter sua versão existente do produto eexecutá-la além da nova versão do produto. Isso pode ajudar você a testar suanova versão sem afetar sua versão existente. É possível comparar as definições deconfiguração entre a versão e comparar a aparência e a funcionalidade dosrelatórios em ambos os ambientes para assegurar a equivalência.

Executando várias versões ou instâncias do IBM Cognos BI nomesmo computadorPara ter diversas versões ou instâncias do IBM Cognos Business Intelligence nomesmo computador, você deve alterar a configuração para assegurar que asversões não compartilhem números de porta ou outros recursos.

Mudanças Necessárias na Configuração para Executar DiversasVersões no Mesmo Computador

Para executar diversas versões do IBM Cognos Business Intelligence no mesmocomputador, certifique-se de que cada instalação seja distinta. As versões ouinstâncias devem se instaladas em diretórios diferentes. As definições deconfiguração para cada versão deve usar diferentes configurações para as seguintespropriedades de configuração.

Capítulo 4. Atualizar o IBM Cognos Business Intelligence 53

Page 66: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Configurações de Portas e de URI

Se estiver usando o servidor de aplicativos padrão, você deverá usarnúmeros de porta diferentes de 9300 para evitar conflitos de porta. IBMCognos BI reserva um intervalo de números de porta, portanto, deve-seassegurar o uso de um deslocamento de pelo menos 100 para o número deporta. Por exemplo, se você estiver usando o número da porta padrão,9300, para uma instância do IBM Cognos BI. Para uma segunda instalaçãono mesmo computador, deve-se alterar o número da porta para pelomenos 9400. Não use os mesmos números de porta para ambas asinstalações.

Altere as portas a seguir.v URIs de dispatchers do gatewayv URI do dispatcher externov URI do dispatcher internov URI do dispatcher para aplicativos externosv URIs do Content Managerv Número da porta do servidor de log local

Se você estiver instalando o produto em um servidor de aplicativosdiferente do fornecido com o IBM Cognos BI, assegure-se de instalar anova versão em um novo perfil de servidor de aplicativos ou umainstância separada da versão existente.

Armazenamento de conteúdoUse um armazenamento de conteúdo ou esquema diferentes para cadainstalação. Não é possível reverter o conteúdo após ele ser atualizado. Épossível usar uma cópia restaurada de seu armazenamento de conteúdoexistente como o armazenamento de conteúdo para a versão mais recentedo IBM Cognos Business Intelligence. A versão mais recente do produtoatualiza o armazenamento de conteúdo quando você inicia os serviços.

Diretórios Virtuais do Servidor da Web

Para visualizar o conteúdo estatístico do IBM Cognos Business Intelligence,os diretórios virtuais para o servidor da web devem ser diferentes paracada versão. Assegure-se de atualiza o URI do Gateway no CognosConfiguration para refletir os nomes dos diretórios virtuais.

Por exemplo, o diretório virtual padrão é http://servername/ibmcognos. Setiver dois gateways instalados no mesmo computador, você deve alterar odiretório virtual ibmcognos para um dos gateways.

Conjuntos de Aplicativos (Servidor da Web do Microsoft IIS)Se você usar cognosisap.dll, cada gateway deve usar um conjunto deaplicativos separado.

Conta do Usuário que Inicia o Serviço (Opcional)Alterar a conta do usuário pode ser útil quando você estiver solucionandoos problemas. Por exemplo, é possível solucionar problemas de processosJava pelo proprietário.

Definições de Configuração que São Iguais para Diversas Versões doMesmo Servidor

Diversas instâncias ou versões do IBM Cognos Business Intelligence em execuçãono mesmo computador usam os mesmos recursos, como memória, rede e espaçoem disco.

54 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 67: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Diversas versões do IBM Cognos podem usar a fonte de autenticação para ambasas versões. É possível configurar propriedades idênticas para o namespace.

Arquivos de Configuração Customizados

Se você editou manualmente alguns arquivos de configuração, deve reaplicar asmudanças. Mantenha um registro de quaisquer customizações para assegurar quepossam ser reaplicadas após seu upgrade. Além disso, faça backup desses arquivospara que a versão original possa ser restaurada, se necessário.

O serviço de apresentação do IBM Cognos BI suporta o upgrade automático dealguns arquivos system.xml. Se tiverem sido feitas muitas customizações nosarquivos system.xml, é possível usar este recurso de upgrade automático em vezde reaplicar as mudanças manualmente após o upgrade. Ao substituir os arquivossystem.xml pelos arquivos da sua versão anterior do produto, os arquivos poderãoser atualizados pela nova versão do produto. O upgrade automático é aplicado aoiniciar o serviço do IBM Cognos.

Os arquivos system.xml, para os quais o upgrade automático é suportado, estãonos diretórios a seguir:v c10_location/templates/ps

v c10_location/templates/ps/portal

v c10_location/templates/ps/qs

Configurando uma Segunda Instância do IBM Cognos BI em umComputadorPara ter mais de uma instância do IBM Cognos Business Intelligence em umcomputador, você deve configurar cada instância com valores exclusivos para asportas, o diretório virtual do servidor da web e o banco de dados dearmazenamento de conteúdo.

Antes de Iniciar

Para a nova versão do produto, é necessário um novo armazenamento deconteúdo. Se você estiver atualizando seu armazenamento de conteúdo inteiro, crieum armazenamento de conteúdo a partir de um backup do seu armazenamento deconteúdo existente. Se você estiver movendo seu conteúdo com arquivos deimplementação, é possível criar um banco de dados de armazenamento deconteúdo em branco.

Assegure-se de ter seu novo banco de dados de armazenamento de conteúdo antesde configurar a nova versão do produto.

Importante: Se você estiver se conectando a um backup do seu armazenamento deconteúdo, na primeira vez que iniciar os seus serviços IBM Cognos, será solicitadoque atualize seus relatórios. Atualizar seus relatórios pode demorar e é melhoratualizá-los depois que tiver a nova versão em execução. É possível atualizar seusrelatórios depois usando o IBM Cognos Administration.

Procedimento1. Para a nova instância do IBM Cognos BI, inicie o IBM Cognos Configuration.2. Na janela Explorer, clique em Ambiente.3. Assegure-se de que os números da porta para as configurações a seguir não

entram em conflito com outra instância ou versão do IBM Cognos BI:

Capítulo 4. Atualizar o IBM Cognos Business Intelligence 55

Page 68: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

v URIs de dispatchers do gateway

v URI do dispatcher externo

v URI do dispatcher interno

v URI do dispatcher para aplicativos externos

v URIs do Content Manager

4. Assegure-se de que o URI do Gateway usa um diretório virtual ou aliasdiferente da outra instância ou versão do IBM Cognos BI.

5. Clique em Criação de Log e assegure-se de que o Número de Porta doServidor de Log Local seja exclusivo.

6. Se você estiver usando o Portal Services, atualize o local do arquivoapplications.xml:v Na janela Explorer, clique em Ambiente > Portal Services.v Na janela Propriedades, assegure-se de que o número da porta para a

propriedade Location of applications.xml corresponda ao número da portapara outras propriedades de URI.

7. Na janela Explorer, em Acesso a Dados > Content Manager, assegure-se denão usar o mesmo armazenamento de conteúdo usado para sua outra instânciaou versão do IBM Cognos BI.

8. Salve a configuração e inicie o IBM Cognos BI.

Mover Seu Conteúdo para a Nova Versão do ProdutoExistem dois métodos para mover o seu conteúdo. É possível mover todo oarmazenamento de conteúdo ou mover o conteúdo criando arquivos deimplementação.

Mova o seu Armazenamento de Conteúdo Inteiro

Este método requer que você faça backup do armazenamento de conteúdoexistente e, em seguida, restaure o backup para um novo armazenamento deconteúdo. Em seguida, conecte sua nova versão do produto para o armazenamentode conteúdo restaurado e o produto atualiza o armazenamento de conteúdo para anova versão.

Este método mantém toda a sua segurança e preferências do usuário, mas requerum novo banco de dados de armazenamento de conteúdo.

Ao configurar a segurança, certifique-se de configurar o identificador exclusivopara o mesmo valor que ele tinha na liberação da qual você está fazendo oupgrade, caso contrário, as configurações de segurança serão perdidas. Para obtermais informações, consulte “Ativação da segurança” na página 84.

Execute uma verificação de consistência em seu armazenamento de conteúdo antesde fazer o upgrade para garantir que não há inconsistências. Para obter maisinformações, consulte o tópico "Crie uma Tarefa de Manutenção deArmazenamento de Conteúdo" no Guia de Administração e Segurança do IBM CognosBusiness Intelligence.

Importante: Ao usar este método, na primeira vez que iniciar os serviços IBMCognos, será solicitado que atualize seus relatórios. Atualizar seus relatórios podedemorar e é melhor atualizá-los depois que tiver a nova versão em execução. Alémdisso, se você tiver aplicativos do Kit de Desenvolvimento de Software que criem,

56 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 69: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

modifiquem ou salvem as especificações de relatório, não selecione a opção paraatualizar suas especificações de relatório. É possível atualizar seus relatórios depoisusando o IBM Cognos Administration.

Além disso, você deve assegurar-se de remover o registro de quaisquer dispatchersde sua versão anterior do produto. Isso pode ser feito usando o IBM CognosAdministration depois de você ter iniciado os serviços.

Mova o Conteúdo Criando Arquivos de Implementação

É possível mover o conteúdo criando os arquivos de implementação.

Este método permite mover o conteúdo específico, mas pode demorar para umgrande armazenamento de conteúdo.

Se você estiver alterando os fornecedores de banco de dados de armazenamento deconteúdo, deve criar as implementações para mover o seu conteúdo. Por exemplo,se você estiver alterando o armazenamento de conteúdo a partir do Microsoft SQLServer para o IBM DB2, isso deve ser feito com arquivos de implementação.

Considerações para Ambos os Métodos

As tabelas NC devem ser completamente esvaziadas antes de executar oupgrade.Execute o NC_DROP_Database_Type.sql apropriado antes de fazer upgrade.Para obter mais informações, consulte “Executando Scripts de Limpeza do Bancode Dados e de Índice” na página 373.

Como parte do processo de atualização, verifique se seus aplicativos funcionamcomo esperado na nova versão. Às vezes, as mudanças podem apresentarresultados inesperados. É importante testar os seus aplicativos com a nova versãodo produto antes de movê-los para o ambiente de produção.

Atualizar seu Armazenamento de ConteúdoO IBM Cognos BI atualiza o banco de dados de armazenamento de conteúdo paraa nova versão do produto quando você inicia os serviços pela primeira vez.

O processo de atualizar o upgrade para a nova versão do produto inclui as etapasa seguir:1. Fazer um backup de seu banco de dados de armazenamento de conteúdo

existente.2. Criar um banco de dados do backup.

Se o seu armazenamento de conteúdo estiver no DB2 no z/OS, você deveexecutar o script para atualizar o armazenamento de conteúdo antes de iniciaros serviços no IBM Cognos Configuration.

3. Conecte a nova versão do produto ao armazenamento de conteúdo que vocêcriou a partir do backup no IBM Cognos Configuration.

4. Inicie os seus serviços.O armazenamento de conteúdo é atualizado durante o processo deinicialização.

Importante: Ao usar este método, na primeira vez que iniciar os serviços IBMCognos, será solicitado que atualize seus relatórios. Atualizar seus relatóriospode demorar e é melhor atualizá-los depois que tiver a nova versão emexecução. É possível atualizar seus relatórios depois usando o IBM Cognos

Capítulo 4. Atualizar o IBM Cognos Business Intelligence 57

Page 70: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Administration. Além disso, se você tiver aplicativos do Kit deDesenvolvimento de Software que criem, modifiquem ou salvem asespecificações de relatório, não selecione a opção para atualizar suasespecificações de relatório.

Este processo permite que você use as versões nova e antiga do produto ao mesmotempo, onde cada versão possui seu próprio armazenamento de conteúdo.

Importante: Quando você conecta a nova versão do produto ao armazenamentode conteúdo criado a partir do backup, o banco de dados de armazenamento deconteúdo é atualizado e não pode mais ser usado com sua antiga versão doproduto.

Atualizando um Armazenamento de Conteúdo no IBM DB2 noz/OSPara atualizar o armazenamento de conteúdo no DB2 no z/OS, execute o scriptque cria novos espaços de tabela e concede ao Content Manager os direitos parausar os espaços de tabela.

Antes de Iniciar

Para executar o script, você deve ter permissão para criar os espaços de tabela.Execute o script antes de salvar a configuração para a nova versão.

Procedimento1. Acesse o diretório c10_location\configuration\schemas\content\db2zOS e abra

tablespaceUpgrade_db2zOS.sql em um editor de texto.2. Siga as instruções no arquivo de script e substitua os valores do marcador no

arquivo com os valores para o banco de dados.3. Salve e execute o arquivo.

Cancelar Registro de Dispatchers da Versão Anterior do seuArmazenamento de ConteúdoSe você usar um backup do armazenamento de conteúdo existente com uma novaversão do produto, você deve cancelar o registro dos dispatchers da versãoanterior.

Procedimento1. Abra o IBM Cognos Connection em seu navegador da web.2. No canto superior direito, clique em Iniciar e em IBM Cognos Administration.3. Clique em Configuração e, em seguida, clique em Dispatchers e Serviços.4. Clique em Mais para os dispatchers pertencentes à versão anterior.5. Clique em Cancelar Registro e, em seguida, clique em OK.

As informações do dispatcher serão removidas do armazenamento deconteúdo.

Fazendo Upgrade de um Banco de Dados de Criação de Log noIBM DB2 no z/OSPara fazer upgrade do banco de dados de criação de log no DB2 no z/OS, executeum script que crie novos espaços de tabela e conceda os direitos para uso dosespaços de tabela.

58 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 71: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Antes de Iniciar

Para executar o script, você deve ter permissão para criar os espaços de tabela.Execute o script antes de salvar a configuração para a nova versão.

Procedimento1. Acesse o diretório c10_location\configuration\schemas\logging\db2zOS e abra

LS_tablespaceUpgrade_db2zOS.sql em um editor de texto.2. Siga as instruções no arquivo de script e substitua os valores do marcador no

arquivo com os valores para o banco de dados.3. Salve e execute o arquivo.

Movendo o Conteúdo com um Arquivo de ImplementaçãoPara mover o conteúdo específico do armazenamento de conteúdo é possível usaros arquivos de implementação. Os arquivos de implementação são arquivoscompactados que é possível importar para a sua nova versão do produto.

Importante: Se você moveu o seu conteúdo restaurando seu armazenamento deconteúdo existente, não precisará mover o conteúdo usando os arquivos deimplementação.

Mover o conteúdo com arquivos de implementação envolve as etapas a seguir:1. Criar um archive.2. Copiar o archive para a nova versão do produto.3. Importar o conteúdo.

Criando um Arquivo de ImplementaçãoUse a tarefa a seguir para criar um arquivo de implementação.

Procedimento1. Em IBM Cognos Administration, na guia Configuração, clique em

Administração de Conteúdo.

2. Na barra de ferramentas, clique no ícone Nova Exportação .3. Insira Nome para o archive.4. Selecione o conteúdo que você deseja incluir no archive:

v Para exportar pastas específicas e conteúdo de diretório, clique emSelecionar Pastas Públicas e Conteúdo de Diretório.

v Para exportar o armazenamento de conteúdo inteiro, clique em Selecionar oArmazenamento de Conteúdo Inteiro. Se selecionar o armazenamento deconteúdo inteiro, também poderá selecionar Incluir Informações de Contasdos Usuários.

5. Clique em Avançar.6. Se você clicou em Selecionar o Armazenamento de Conteúdo Inteiro, insira

uma senha a ser usada ao importar o conteúdo e, em seguida, clique em OK.7. Se você clicou em Selecionar Pastas Públicas e Conteúdo do Diretório:

a. No painel Selecionar Conteúdo das Pastas Públicas, clique em Incluir.b. No painel Selecionar Entradas, na caixa Entradas Disponíveis, selecione

os pacotes ou pastas que deseja exportar.

Capítulo 4. Atualizar o IBM Cognos Business Intelligence 59

Page 72: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

É possível procurar na hierarquia de Pastas Públicas e escolher os pacotes

e pastas desejados. Clique no ícone Incluir para mover os itensselecionados para a caixa Entradas Selecionadas e clique em OK.

c. Para cada pacote e pasta que você exportar, faça o seguinte, e, em seguida,clique em Avançar:v Se você desejar fazer qualquer mudança no pacote ou na pasta no

ambiente de destino, clique no ícone Editar , faça as mudanças eclique em OK.

v Para restringir o acesso ao pacote ou pasta e às entradascorrespondentes, assinale a caixa de seleção na coluna Desativar apósimportação. Isso é útil quando desejar testar os relatórios antes dedisponibilizá-los no ambiente de destino.

v Em Opções, selecione se deseja incluir as versões de saída de relatório,executar o histórico e programações, e o que fazer com as entradasquando há um conflito.

d. No painel Selecionar o Conteúdo do Diretório, selecione as opçõesdesejadas e clique em Avançar.

e. No painel Especificar Opções Gerais, selecione as opções desejadas eclique em Avançar.

f. No painel Especificar um Arquivo de Implementação, selecione umarquivo de implementação existente a partir da lista ou crie um.Se estiver digitando um novo nome para o arquivo de implementação, nãouse espaços no nome. Se o nome da nova especificação de implementaçãocorresponder ao nome de um arquivo de implementação existente, oarquivo de implementação existente será sobrescrito.

8. Revise as informações de resumo e depois clique em Avançar.9. Em Ações, selecione Salvar e Executar Uma Vez.

10. No painel Executar com Opções, selecione Agora e clique em Executar.

Resultados

Um arquivo de implementação é criado no diretório deployment em que vocêinstalou o IBM Cognos BI.

Copiando o Arquivo de Implementação para a Nova VersãoVocê deve copiar manualmente os arquivos de implementação a partir da instânciana qual eles foram criados em sua nova instância.

Procedimento

Copie os arquivos de implementação que você criou a partir do diretórioold_version_install_location/deployment para o diretórionew_version_install_location/deployment.

Nota: O diretório de implementação é configurável no IBM Cognos Configuration.Por padrão, o local é install_location/deployment. Se você estiver usando umlocal diferente, assegure-se de copiar os arquivos de implementação para umdiretório apropriado.

60 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 73: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Incluindo Objetos de Configuração ao Importar um Arquivo deImplementação do Armazenamento de Conteúdo InteiroInclua objetos de configuração ao importar todo o armazenamento de conteúdo.Por exemplo, talvez você queira importar a configuração porque possui uma sériede configurações avançadas para os serviços que deseja do ambiente de origem.

Por padrão, os objetos de configuração são excluídos ao importar todo oarmazenamento de conteúdo, mesmo se estiverem incluídos na exportação. Essesobjetos incluem dispatchers e pastas de configuração usados para agrupardispatchers.

Procedimento1. Em IBM Cognos Administration, na guia Configuração, clique em Dispatchers

e Serviços.2. Clique no dispatcher desejado.3. Próximo ao ContentManagerService, clique no ícone configurar 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, digite o texto em maiúscula a seguir:

CM.DEPLOYMENTINCLUDECONFIGURATION

8. Na coluna Valor, digite verdadeiro.9. Clique em OK para finalizar.

Importando um Arquivo de ImplementaçãoPara importar entradas, cria-se uma especificação da implementação deimportações.

Ao importar, selecione entradas que foram exportadas. É possível aceitar as opçõespadrão definidas durante a exportação ou alterá-las. É possível selecionar asopções que foram incluídas no arquivo de implementação durante a exportação.

Se você executar a implementação parcial do conteúdo do diretório e pastaspúblicas específicas, o assistente de importação mostrará se os pacotes e as pastasexistem no ambiente de destino e a data e a hora da última modificação. Use estainformação para ajudá-lo a decidir como resolver conflitos. Ao implementarnovamente, o assistente também mostrará se os pacotes e pastas estavam naimplementação original.

Antes de Iniciar

Assegure-se de ter copiado o arquivo de implementação para o diretórioc10_location/deployment para a nova versão do produto.

Procedimento1. Para a sua nova versão do produto, no IBM Cognos Administration, na guia

Configuração, clique em Administração de Conteúdo.

2. Na barra de ferramentas, clique no novo ícone de importação.3. Na caixa Arquivo de Implementação, selecione o arquivo de implementação

que deseja importar e clique em Avançar.

Capítulo 4. Atualizar o IBM Cognos Business Intelligence 61

Page 74: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

4. Se o seu arquivo de implementação é do armazenamento de conteúdo inteiro,digite a senha inserida durante a exportação e clique em OK.

5. Digite o nome da importação e selecione a pasta na qual deseja salvá-la e, emseguida, clique em Avançar.

6. Selecione o conteúdo que deseja incluir na importação, selecione as opções eclique em Avançar.

Dica: Clique no ícone de edição junto ao pacote, se deseja alterar o localde destino para o conteúdo importado.

7. No painel Especificar Opções Gerais, selecione as opções desejadas e cliqueem Avançar.

8. Revise as informações de resumo e depois clique em Avançar.9. Em Açõesselecione Salvar e Executar Uma Vez e clique em Concluir.

10. No painel Executar com Opções, faça o seguinte:a. Selecione Atualizar Todas as Especificações de Relatório para a Versão

mais Recente se desejar atualizar as especificações de relatório durante aimportação. Também é possível executar esta tarefa depois de importar oconteúdo.

b. Clique em Executar.

Atualizar suas Especificações de RelatórioAs especificações de relatório terão que ser alteradas a partir de uma versão doIBM Cognos BI para outra. Você deve atualizar qualquer especificação de relatóriocriada nas versões anteriores do produto.

Se estiver atualizando a partir de um backup de seu armazenamento de conteúdoexistente, você deve atualizar as especificações do relatório depois de ter iniciadoos serviços.

Se você estiver movendo o conteúdo para uma nova versão usando os arquivos deimplementação, será possível optar por atualizar as especificações de importaçãodurante a importação.

Se você moveu o seu conteúdo usando o arquivo de implementação, você pode terselecionado a opção para atualizar suas especificações de relatório. Se vocêatualizou as especificações de relatório durante a importação, não é necessáriofazer isso novamente.

Antes de Iniciar

Importante: Não atualize suas especificações de relatório se tiver aplicativosSoftware Development Kit que criam, modificar ou salvam especificações derelatório. Primeiro você deve atualizar seus aplicativos Software Development Kitpara conformidade com o esquema de especificações de relatório do IBM Cognos.Do contrário, os aplicativos do Software Development Kit não poderão acessar asespecificações de relatório atualizadas. Para obter informações sobre como fazerupgrade de especificações de relatório, consulte o IBM Cognos Software DevelopmentKit Developer Guide.

Procedimento1. Clique em Ativar, IBM Cognos Administration.2. Na guia Configuração, clique em Administração de Conteúdo.

62 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 75: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

3. Clique na seta no botão nova manutenção de conteúdo na barra deferramentas e, em seguida, clique em Nova Atualização de Relatório

4. Digite um nome para a tarefa de atualização e, se desejar, uma dica de tela e adescrição. Clique em Avançar.

5. Selecione os pacote e os locais para a especificação de relatório que desejaatualizar. Clique em Avançar.Se atualizar as especificações de relatório por pacote, todos os relatórios doarmazenamento de conteúdo baseados no modelo desse pacote serãoatualizados. Se atualizar as especificações de relatório por pasta, todos osrelatórios da pasta serão atualizados.

6. Escolha uma das seguintes opções:v Salvar e executar uma vez abre a execução com a página de opções.v Salvar e programar abre a ferramenta de programação.v Apenas salvar permite salvar a atualização para que possa ser executada

posteriormente.

Usar o Lifecycle Manager para Comparar os Relatórios entresuas Versões do Produto

O Lifecycle Manager permite verificar seu conteúdo atualizado comparando osrelatórios no seu antigo ambiente com os relatórios em sua nova versão doproduto.

Para obter informações adicionais, consulte a documentação do IBM CognosLifecycle Manager.

Capítulo 4. Atualizar o IBM Cognos Business Intelligence 63

Page 76: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

64 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 77: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Capítulo 5. Instalação e Configuração dos Componentes doProduto em um Computador

É possível instalar todos os componentes do IBM Cognos PowerPlay em umcomputador. Isto é útil quando se está configurando um ambiente de teste ou deavaliação ou para ambientes de pequena produção. Também é possível distribuir ainstalação do IBM Cognos PowerPlay em diferentes computadores. Após ainstalação, é possível customizar os componentes para serem usados em seuambiente alterando outras configurações no IBM Cognos Configuration.

Para migrar o conteúdo do IBM Cognos Series 7 para o IBM Cognos BI,componentes de migração são requeridos em ambos, no computador IBM CognosPowerPlay e nos computadores do IBM Cognos Series 7. Ao instalar o IBM CognosPowerPlay, a instalação inclui automaticamente os componentes de migração. Vocêdeve concluir uma instalação separada para incluir componentes de migração emcomputadores com o IBM Cognos Series 7.

Para obter instruções de desinstalação, consulte Capítulo 15, “Desinstalando o IBMCognos BI”, na página 333.

Instalar os Componentes do ServidorUtilize o assistente de instalação para selecionar os componentes do servidor quedeseja instalar e o local do computador onde quer que eles fiquem. Somente oscomponentes escolhidos para instalação serão copiados do disco para ocomputador.

Para usar o IBM Cognos PowerPlay em um computador, você deve instalar todosos componentes selecionados por padrão no assistente de instalação.

Se estiver instalando o IBM Cognos PowerPlay com o IBM Cognos BusinessIntelligence Server, instale e configure o servidor IBM Cognos BI primeiro. Os doisprodutos devem ser da mesma versão.

Amostras de aplicativo para o produto IBM Cognos BI estão em um discoseparado. Se quiser usar as amostras, você deverá instalá-las a partir do disco IBMCognos Business Intelligence Samples.

Parando o Serviço

Se precisar parar o serviço do IBM Cognos, é importante parar também o seguinte:v Aplicativos que estão relacionados com o serviço do IBM Cognos, como

Framework Manager, IBM Cognos Transformer, IBM Cognos Connection, IBMCognos Administration e Metrics Designer

v Aplicativos Software Development Kit que estão sendo executados

Atualizando a Instalação

Se estiver atualizando a partir de uma liberação anterior do IBM CognosPowerPlay, você deve usar as etapas de atualização.

© Copyright IBM Corp. 2005, 2014 65

Page 78: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Se você estiver atualizando de uma liberação anterior dos produtos IBM Cognos,consulte Capítulo 4, “Atualizar o IBM Cognos Business Intelligence”, na página 49.

Se você estiver atualizando a partir de uma versão anterior do IBM Cognos BI,todos os componentes distribuídos devem ter a mesma versão do IBM Cognos BI.Se instalar o IBM Cognos BI em hosts adicionais ou alternativos, você deveráatualizar propriedades específicas do código do idioma no IBM CognosConfiguration.

Se você irá usar os PowerCubes que são protegidos em relação a um namespace doIBM Cognos Series 7, você deve instalar o IBM Cognos PowerPlay em umcomputador que suporte o IBM Cognos Series 7.

Se você estiver atualizando o IBM Cognos BI em um ambiente que inclui versõesanteriores de outros produtos IBM Cognos BI, como o IBM Cognos BI ControllerVersão 8.x IBM Cognos BI Planning Versão 8.x ou IBM Cognos BI Analysis paraMicrosoft Excel Versão 8.x, instale a nova versão do IBM Cognos BI em um localseparado do outro produto IBM Cognos BI e configure a nova versão do IBMCognos BI para operar independentemente desse produto. Após a atualização dooutro produto para uma versão compatível com o IBM Cognos BI, é possívelconfigurar os dois produtos para operarem juntos.

Instalações de 64 Bits

O gateway do IBM Cognos BI fornece bibliotecas de 32 bits, independentemente dea instalação ser em um servidor de 64 bits ou de 32 bits. Em alguns servidoresWeb, como o Apache Web server, não é possível carregar uma biblioteca compiladade 32 bits em um servidor compilado de 64 bits. Nessa situação, instale a versãode 32 bits do gateway do IBM Cognos em um servidor da Web de 32 bits.

O componente do servidor de relatório, incluído com os Componentes da Camadade Aplicativos, é fornecido nas versões de 32 bits e de 64 bits. A seleção da versãousada é feita com o IBM Cognos Configuration após a instalação. Por padrão, ocomponente do servidor de relatório está configurado para usar o modo de 32 bits,mesmo em um computador de 64 bits. O modo de 32 bits permite executar todosos relatórios, enquanto o modo de 64 bits permite executar apenas os relatórioscriados para o modo de consulta dinâmica.

Se você estiver atualizando o IBM Cognos BI em um ambiente que inclua versõesanteriores de outros produtos IBM Cognos BI, como IBM Cognos BI ControllerVersão 8.x, IBM Cognos BI Planning Versão 8.x ou IBM Cognos BI Analysis paraMicrosoft Excel Versão 8.x, instale a nova versão do IBM Cognos BI em um localseparado do outro produto IBM Cognos BI e configure a nova versão do IBMCognos BI para operar independentemente desse produto. Após a atualização dooutro produto para uma versão compatível com o IBM Cognos BI, é possívelconfigurar os dois produtos para operarem juntos.

Instalações do Windows

Para instalações do sistema operacional Microsoft Windows, certifique-se de ter osprivilégios de administrador para o computador Windows no qual está instalando.Certifique-se também de que o computador possua variável de sistema TEMP queaponte 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 essediretório.

66 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 79: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Instalações do UNIX

Para instalações do sistema operacional UNIX, é possível instalar componentes deservidor usando uma interface gráfica com o usuário ou executando umainstalação silenciosa. Para executar a instalação no modo gráfico, o consoleconectado ao seu computador UNIX deverá suportar uma interface gráfica deusuário baseada em Java.

Além disso, o IBM Cognos BI respeita a máscara de criação do modo de arquivo(umask) da conta executando o programa de instalação. Isto afeta somente osdiretó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, respeitama máscara. Utilize o umask 022 no diretório de instalação.

Banco de Dados de Conteúdo do Cognos como Armazenamentode Conteúdo

Se quiser usar o Banco de dados de conteúdo do Cognos como armazenamento deconteúdo, você deverá selecioná-lo no assistente de instalação. Se você estiverinstalando componentes em vários computadores, será necessário instalar o Bancode dados de conteúdo do Cognos apenas uma vez.

Requisitos da Impressora

Para garantir que os relatórios sejam impressos corretamente no Windows, oAdobe Reader requer que você configure pelo menos uma impressora no sistemaoperacional no qual os Componentes da Camada de Aplicativos estão instalados.Todos os relatórios, independente do formato de impressão escolhido, são enviadoscomo arquivos PDF temporários para o Adobe Reader para impressão.

Instalando Componentes do Servidor nos SistemasOperacionais UNIX ou Linux

Utilize o assistente de instalação para selecionar os componentes do servidor quedeseja instalar e o local do computador onde quer que eles fiquem. Somente oscomponentes escolhidos para instalação serão copiados do disco para ocomputador.

Antes de Iniciar

Vá para o página Relatórios de Compatibilidade de Produto IBM Software(www.ibm.com/support/docview.wss?uid=swg27042164). Verifique se você tem ascorreções requeridas instaladas em seu computador antes de instalar o produto.

Procedimento1. Se estiver instalando em um diretório com outros componentes do IBM

Cognos BI, pare o serviço do IBM Cognos.2. Configure a variável de ambiente JAVA_HOME para apontar para o local da

instalação do seu Java Runtime Environment (JRE).Um exemplo do local de instalação de um Java Runtime Environment é/directory/java/java_version/jre.O IBM Cognos BI requer uma JVM, como a fornecida pela IBM, para execuçãono sistema operacional Linux.Se você estiver instalando em um local com outros componentes do IBMCognos BI, use a variável de ambiente JAVA_HOME existente.

Capítulo 5. Instalação e Configuração dos Componentes do Produto em um Computador 67

Page 80: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

3. No HP-UX, defina a variável de ambiente _M_ARENA_OPTS da seguinteforma:_M_ARENA_OPTS 1:4

Isso aumenta a alocação de memória para HP-UX para corresponder melhor àde outras plataformas UNIX.

4. No AIX, se você estiver usando um gateway de servlet, configure a variávelde ambiente AIXTHREAD_SCOPE da seguinte forma:AIXTHREAD_SCOPE=S

Isso define o escopo de contenção de 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 osarquivos de instalação foram baixados e extraídos.

6. Se estiver instalando de um disco, monte o disco usando extensões de arquivoRock Ridge.Para montar o disco em HP-UX, faça o seguinte:v Inclua o diretório pfs_mount no seu caminho.

Por exemplo,PATH=/usr/sbin/:$PATH

exporte PATH

v Para iniciar os daemons NFS necessários e executar os daemons no planode fundo, digite bg pfs_mountd e digite bg pfsd

v Para montar a unidade, digitepfs_mount -t rrip <device><mount_dir> -o xlat=unix

Por exemplo,pfs_mount /dev/dsk/c0t2d0 /cdrom -o xlat=unix

Agora é possível instalar ou copiar arquivos como um usuário não raizusando um disco IBM Cognos a partir dessa unidade.

v Ao concluir a instalação, digite pfs_umount /cdrom e finalize os daemonspfsd e pfs_mountd para desmontar o disco.

7. Para iniciar o assistente de instalação, vá para o diretório do sistemaoperacional e digite./issetup

Nota: Ao usar o comando issetup com XWindows, os caracteres japoneses nasmensagens e arquivos de log poderão ficar corrompidos. Ao instalar emjaponês no UNIX ou Linux, primeiro configure as variáveis de ambienteLANG=C e LC_ALL=C (em que C é o código de idioma, por exemplo,ja_JP.PCK no Solaris) e inicie o assistente de instalação.Se não estiver usando o XWindows, execute uma instalação não assistida(consulte Capítulo 12, “Usando instalação e configuração não assistidas”, napágina 307).Se não estiver usando o XWindows, execute uma instalação não assistida. Paraobter mais informações, consulte o Guia de instalação e configuração.Se estiver instalando nos sistemas operacionais Linux e receber mensagens deerro sobre bibliotecas openmotif ausentes, será possível usar uma instalaçãonão assistida com o comando issetupnx.

8. Siga as instruções do assistente de instalação e copie os arquivos necessáriospara seu computador.

68 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 81: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Instale os componentes do IBM Cognos BI em um diretório que contenhaapenas caracteres ASCII no nome do caminho. Alguns servidores da WebUNIX e Linux não suportam caracteres não ASCII em nomes de diretório.

9. Ao ser solicitado para instalar a documentação do produto em um idiomadiferente do inglês, clique em OK para continuar.

10. Na página Concluir do assistente de instalação, faça o seguinte:v Se desejar ver os arquivos de log, clique em Visualização para o arquivo de

log adequado.v Se quiser ver as últimas informações sobre o produto, selecione a caixa de

seleção das Notas sobre o Release do IBM Cognos.v Não configure o IBM Cognos BI imediatamente, pois você deve executar

outras tarefas primeiro para garantir que seu ambiente esteja configuradocorretamente. Certifique-se de que a caixa de seleção IBM CognosConfiguration esteja limpa.É possível configurar posteriormente o IBM Cognos BI usando o IBMCognos Configuration, digitando cogconfig.sh no diretórioc10_location/bin64.

v Clique em Concluir.11. Anexe o diretório c10_location/bin na variável de ambiente do caminho da

biblioteca adequada.v Para Solaris e Linux, LD_LIBRARY_PATHv Para AIX, LIBPATHv Para HP-UX, SHLIB_PATH

Resultados

Se desejar que os usuários vejam a documentação do produto em um idiomadiferente do inglês, será necessário instalar o componente SupplementaryLanguage Documentation no local em que os componentes de gateway foraminstalados. Para obter mais informações, consulte “Instalando a Documentação doProduto Traduzida” na página 72.

Você também deve atualizar sua estrutura de segurança Java (consulte “RequisitosJava” na página 32) antes de poder configurar o IBM Cognos BI. Caso contrário, oseguinte erro é apresentado:[Cryptography]1. [ ERROR ] java.lang.NoClassDefFoundError:javax/net/ServerSocketFactory:

Tarefas relacionadas:“Não é Possível Executar issetup em Sistemas Operacionais Linux” na página 350Execute issetup para instalar o IBM Cognos BI, mas você receberá a mensagem deerro a seguir: Error while loading shared libraries: libXm.so.4: cannot openshared object file: No such file or directory.

Instalando Componentes do Servidor em SistemasOperacionais Windows

Utilize o assistente de instalação para selecionar os componentes do servidor quedeseja instalar e o local do computador onde quer que eles fiquem. Somente oscomponentes escolhidos para instalação serão copiados do disco para ocomputador.

Capítulo 5. Instalação e Configuração dos Componentes do Produto em um Computador 69

Page 82: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Para computadores com o Windows Vista, Windows 7 ou Windows 2008, o localde instalação padrão usa o diretório Program Files (x86). Se você instalar nesselocal, assegure que você execute o IBM Cognos Configuration como umAdministrador. Como alternativa, é possível instalar o produto fora do diretórioProgram Files (x86). Por exemplo, é possível alterar o diretório de instalação paraalgo como C:\IBM\cognos\c10.

Procedimento1. Se estiver instalando em um diretório com outros componentes do IBM Cognos

BI, pare o serviço do IBM Cognos.2. Execute um dos seguintes procedimentos:

v Insira o disco do produto IBM Cognos.Se o assistente de instalação não for aberto automaticamente, acesse odiretório do sistema operacional e clique duas vezes em issetup.exe.

v Acesse o local em que os arquivos de instalação foram transferidos pordownload e extraídos e clique duas vezes em issetup.exe.

3. Selecione o idioma para utilizar na instalação.Essa seleção determina o idioma da interface com o usuário. Todos os idiomassuportados são instalados. É possível alterar a interface com o usuário paraqualquer um dos idiomas instalados depois de concluída a instalação.

4. Siga as instruções do assistente de instalação e copie os arquivos necessáriospara seu computador.Clique em Instalação Rápida para instalar todos os componentes (camada doaplicativo, gateway, Content Manager), instalar e configurar um gateway deservlet, instalar e configurar o IBM DB2 Advanced Workgroup Server Editioncomo o banco de dados de armazenamento de conteúdo, preencher asinformações de configuração do Content Manager no Cognos Configuration,configurar um conjunto de dados pessoais e iniciar todos os serviços. Estaopção não está disponível se o DB2 já estiver instalado. Esta opção estádisponível apenas em ambientes do Windows de 64 bits.Se a opção Instalação Rápida não for usada, escolha os componentes na páginaSeleção de Componente.Instale os componentes do IBM Cognos BI em um diretório que contenhaapenas caracteres ASCII no nome do caminho. Alguns servidores da Web doWindows não suportam caracteres não ASCII em nomes de diretório.

5. Ao ser solicitado para instalar a documentação do produto em um idiomadiferente do inglês, clique em OK para continuar.

6. Na página Concluir do assistente de instalação, faça o seguinte:v Se desejar ver os arquivos de log, clique em Visualização para o arquivo de

log adequado.v Se quiser ver as últimas informações sobre o produto, selecione a caixa de

seleção das Notas sobre o Release do IBM Cognos.v Se você iniciar o IBM Cognos Configuration a partir do assistente de

instalação, certifique-se de seguir as tarefas adicionais nessa seção paraassegurar que o seu ambiente esteja apropriadamente configurado antes deiniciar os serviços.É possível iniciar o IBM Cognos Configuration usando o atalho IBM CognosConfiguration do menu Iniciar.

v Clique em Concluir.Se desejar que os usuários vejam a documentação do produto em um idiomadiferente do inglês, será necessário instalar o componente Supplementary

70 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 83: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Language Documentation no local em que os componentes de gateway foraminstalados. Para obter mais informações, consulte “Instalando a Documentaçãodo Produto Traduzida” na página 72.

Instalando fix packs do IBM CognosO IBM fornece pacotes de manutenção temporários que contêm atualizações paraum ou mais componentes para o seu produto IBM Cognos. Fix packs sãoatualizações de produto que contêm correções de códigos acumulativas realizadasdesde a última liberação do produto. Se um fix pack estiver disponível ao instalarou atualizar seu produto, é necessário instalá-lo após instalar os componentes doIBM Cognos. Os fix packs do IBM Cognos são instalados no mesmo local que oproduto existente.

Os fix packs são acumulativos. Quando se instala um fix pack, ele incluiatualizações de todos os fix packs anteriores. Os fix packs estão disponíveis paradownload a partir do Suporte IBM (www.ibm.com/support/entry/portal/overview).

Nota:

v Os fix packs não são instalações independentes. É necessário instalá-los noscomputadores que possuem componentes do IBM Cognos instalados. Instale osfix packs que são apropriados para sua versão do produto. Para verificar suaversão, abra o arquivo da lista de componentes no c10_location\cmplst.txt everifique a linha que inicia com C8PPCLIENT_version= para o PowerPlay Client eC8PPES_version= para a versão do servidor PowerPlay.

v Se você usou a opção Configuração Rápida para a instalação do Cognos BIoriginal (versão 10.2.2), isso significa que o DB2 Advanced Workgroup ServerEdition foi instalado e configurado como o banco de dados de armazenamentode conteúdo. A opção Configuração Rápida não estará disponível para instalar ofix pack. Use a opção de instalação do IBM Cognos Business Inteliigence Server.Além disso, os fix packs ou correções para o DB2 Advanced Workgroup ServerEdition precisarão ser instalados usando os métodos de instalação de fix pack doDB2.

Procedimento1. Acesse o local onde os arquivos de instalação foram transferidos por download

ou insira o disco se você tiver um.2. Inicie o assistente de instalação:

v Em computadores executando sistemas operacionais Linux ou UNIX, acesseo diretório do sistema operacional e execute ./issetup.

v Em computadores executando sistemas operacionais Microsoft Windows,acesse o diretório do sistema operacional e clique duas vezes emissetup.exe.

3. Siga as instruções do assistente de instalação para que os arquivos de fix packsejam instalados no mesmo local que os componentes do IBM Cognos.

4. Se necessário, atualize os novos arquivos de instalação com todas as mudançasdas cópias de backup de seus arquivos customizados.Para evitar erros, antes de copiar os arquivos customizados, compare ambas asversões dos arquivos. Esta validação determina se é possível substituir oarquivo.

5. Se você tiver um ambiente distribuído, repita estas etapas para todos osservidores IBM Cognos restantes.

Capítulo 5. Instalação e Configuração dos Componentes do Produto em um Computador 71

Page 84: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Instalando a Documentação do Produto TraduzidaA instalação do produto inclui um conjunto limitado da documentação traduzidapara alguns idiomas, como guias de instalação e notas sobre a liberação. Paraacessar um conjunto completo da documentação traduzida, ela deve ser instalada apartir do IBM Cognos BI Supplementary Language Documentation.

Antes de Iniciar

Antes de instalar o Supplementary Language Documentation, certifique-se de que:v O IBM Cognos BI está instalado e configurado corretamentev 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.

v Seu ambiente de software seja suportado.

Procedimento1. No local em que o componente de Gateway está instalado, insira o disco do

IBM Supplementary Language Documentation ou acesse o diretório onde foifeito o download e a extração dos arquivos de instalação.Nos sistemas operacionais UNIX ou Linux, monte o disco usando as extensõesde arquivos Rock Ridge.No Windows, o assistente de instalação é iniciado automaticamente a partir dodisco do produto.

2. Para iniciar o assistente de instalação, vá para o diretório do sistemaoperacional e faça o seguintev No Windows, se a página de Boas Vindas não aparecer, clique duas vezes no

arquivo issetup.exe.v No UNIX ou Linux, digite

./issetup

Nota: Ao usar o comando issetup com XWindows, os caracteres japonesespoderão ficar corrompidos.

3. Siga as instruções no assistente de instalação para copiar os arquivosnecessários para o mesmo local em que foram instalados os componentes degateway do IBM Cognos BI.Instale em um diretório que contenha apenas caracteres ASCII no nome docaminho. Alguns servidores web não suportam caracteres que não sejam ASCIInos nomes dos diretórios.Os componentes da documentação dos idiomas complementares sãoselecionados por padrão.

4. Escolha a opção desejada na página Concluir do assistente de instalação.

Configure a conectividade do banco de dados para o banco de dadosde armazenamento de conteúdo.

Se estiver usando um banco de dados diferente do Cognos Content Database, oIBM DB2 Advanced Workgroup Server Edition (da opção Configuração Rápida) ouMicrosoft SQL Server como o armazenamento de conteúdo, pode ser necessárioinstalar o software do cliente de banco de dados ou drivers Java Database

72 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 85: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Connectivity (JDBC), ou ambos, em cada computador no qual o Content Managerfor instalado. Fazer isso permite que o Content Manager acesse o banco de dadosde armazenamento de conteúdo.Conceitos relacionados:“Usar o protocolo secure sockets layer (SSL) para conexões com o banco de dadosno IBM Cognos Configuration” na página 245É possível configurar o IBM Cognos Business Intelligence para usar o protocolosecure sockets layer (SSL) para comunicação com bancos de dados usados peloIBM Cognos BI, incluindo armazenamento de conteúdo, notificação e criação delog de bancos de dados.

Configurar a Conectividade do Banco de Dados para umArmazenamento de Conteúdo IBM DB2

Este procedimento descreve como configurar a conectividade do banco de dadospara um armazenamento de conteúdo do DB2 . Você deve executar esteprocedimento em cada computador em que instalar Content Manager.

Você deve usar um driver tipo 4 Java Database Connectivity (JDBC) para conectaro armazenamento de conteúdo se estiver usando o IBM DB2.

O driver tipo 4 é considerado um produto independente. Ele não requer que ocliente DB2 esteja instalado.

Nota: Este tópico não se aplica se você tiver usado a opção Instalação Rápida parainstalar o IBM DB2 Advanced Workgroup Server Edition como o banco de dadosde armazenamento de conteúdo.

Procedimento

Copie os arquivos a seguir a partir do diretório DB2_installation\sqllib\javapara o diretório c10_location\webapps\p2pd\WEB-INF\lib:v O arquivo do driver universal, db2jcc.jarv O arquivo de licença:

Para DB2 nos sistemas operacionais Linux, UNIX ou Windows, usedb2jcc_license_cu.jar.Para DB2 no z/OS, use db2jcc_license_cisuz.jar.Se estiver se conectando ao DB2 no z/OS, use a versão do 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 path\db2jcc.jar com.ibm.db2.jcc.DB2Jcc -version

Gerando um Arquivo de Script para Criar um Banco de Dadospara um Armazenamento de Conteúdo do DB2É possível gerar um arquivo de script para automaticamente criar oarmazenamento de conteúdo no IBM DB2 em todas as plataformas. O arquivo descript é um arquivo DDL.

Procedimento1. Inicie o IBM Cognos Configuration.2. Na janela Explorer, em Acesso a Dados > Content Manager, clique em

Content Store.

Capítulo 5. Instalação e Configuração dos Componentes do Produto em um Computador 73

Page 86: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

A configuração padrão é para um banco de dados IBM DB2. Certifique-se deque o Tipo seja Banco de Dados DB2.

3. No campo Servidor de Banco de Dados e Número da Porta, insira o nome doseu computador e número de porta no qual o DB2 está sendo executado. Porexemplo, localhost:50000. Em que, 50000 é o número da porta padrão que éusada pelo IBM DB2. Se você estiver usando um número de porta diferente,certifique-se de usar tal valor.

4. Clique no campo Valor próximo à propriedade Senha e ID de Usuário e, emseguida, clique no ícone de edição. Digite os valores apropriados e clique emOK.

5. Na janela Propriedades, para a propriedade Nome do Banco de Dados, digiteo nome para o banco de dados de armazenamento de conteúdo.

Importante: Não use um nome com mais de oito caracteres e use apenas letras,números, sublinhados e hifens no nome.

6. Clique com o botão direito do mouse em Content Store, e clique em GerarDDL.

7. Clique em Detalhes para registrar o local do arquivo DDL gerado.O arquivo DDL denominado createDB.sql é criado. O script é criado nodiretório c10_location\configuration\schemas\content\db2.

O que Fazer Depois

Use este script para criar um banco de dados noIBM DB2. Para obter informaçõesadicionais sobre o uso de um arquivo DDL, consulte sua documentação do IBMDB2.

Se usar a interface da linha de comando do IBM DB2, é possível executar o scriptinserindo o comando a seguir:db2 -tvf createDB.sql

Criando Espaços de Tabela para um Armazenamento deConteúdo no DB2 para z/OSUm administrador de banco de dados deve executar scripts para criar um conjuntode espaços de tabelas necessário para o banco de dados de armazenamento deconteúdo. Modifique os scripts para substituir os parâmetros do marcador pelosapropriados para o seu ambiente.

Por padrão, o armazenamento de conteúdo é usado para notificações, tarefasmanuais e anotações. É possível criar bancos de dados separados para cada umdeles.

Sobre Esta Tarefa

Certifique-se de que sejam usadas as convenções de nomenclatura para o DB2 noz/OS. Por exemplo, todos os nomes de parâmetros devem começar com uma letrae o comprimento não pode exceder oito caracteres. Há duas exceções para o limitede comprimento de caracteres:v CMSCRIPT_CS_ID não possui mais de 2 caracteres.v CMSCRIPT_TABLESPACE não possui mais de 6 caracteres.

O motivo para a exceção é que quando dois parâmetros são concatenados, ocomprimento do caractere não pode ter mais de 8 caracteres.

74 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 87: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Para obter informações adicionais, consulte o IBM DB2 for z/OS KnowledgeCenter (http://www.ibm.com/support/knowledgecenter/SSEPEK/db2z_prodhome.html).

Procedimento1. Conecte-se ao banco de dados como um usuário que possui privilégios para

criar e eliminar espaços de tabelas para permitir a execução de instruções SQL.2. Vá até o diretório que contém os scripts:

c10_location/configuration/schemas/content/db2zOS

3. Faça uma cópia de backup do arquivo de script tablespace_db2zOS.sql e salveo arquivo em outro local.

4. Abra o arquivo de script tablespace_db2zOS.sql original.a. Inclua uma instrução de conexão no início do script.

Por exemplo,connect to databasename;

b. Use a tabela a seguir para ajudá-lo a substituir os parâmetros genéricospelos parâmetros apropriados para seu ambiente.Nem todos os parâmetros listados estão no script, mas alguns podem serincluídos no futuro.

Tabela 14. Nomes de Parâmetro e Descrição para o Script de Espaço de Tabela deArmazenamento de Conteúdo

Nome do parâmetro Descrição

CMSCRIPT_STOGROUP Especifica o nome do grupo dearmazenamento.

CMSCRIPT_DATABASE Especifica o nome do armazenamento deconteúdo Sybase.

CMSCRIPT_CS_ID Especifica a identificação do subsistema parao banco de dados de armazenamento deconteúdo.

O ID não deve ser mais longo que 2caracteres.

CMSCRIPT_TABLESPACE Especifica o nome do espaço de tabela quecontém todas as tabelas base noarmazenamento de conteúdo.

Tabelas auxiliares não são incluídas.

O nome não deve ser mais longo que 6caracteres.

CMSCRIPT_LARGE_BP Especifica o nome do pool de buffer grandealocado especialmente para objetos grandes.

Esse buffer pool é aquele com 32 KB que foicriado quando o administrador do banco dedados criou o banco de dados dearmazenamento de conteúdo no sistemaz/OS.

Capítulo 5. Instalação e Configuração dos Componentes do Produto em um Computador 75

Page 88: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Tabela 14. Nomes de Parâmetro e Descrição para o Script de Espaço de Tabela deArmazenamento de Conteúdo (continuação)

Nome do parâmetro Descrição

CMSCRIPT_REGULAR_BP Especifica o nome do pool de buffer detamanho normal alocado especialmente paraobjetos grandes e de tamanho normal.

Esse buffer pool é aquele com 16 KB que foicriado quando o administrador do banco dedados criou o banco de dados dearmazenamento de conteúdo no sistemaz/OS.

CMSCRIPT_USERNAME Especifica a conta de usuário que acessa obanco de dados do armazenamento deconteúdo.

5. Salve e execute o script.Por exemplo, se você configurar o seu arquivo clp.properties e o seu aliasDB2 no seu perfil ou no arquivo de script tcshrc, digite o seguinte comandopara executar o script:db2 -tvf tablespace_db2zOS.sql

6. Conceda os direitos do usuário do IBM Cognos para os espaços de tabela queforam criados quando você executou o script de arquivotablespace_db2zOS.sql:a. Faça uma cópia do arquivo de script rightsGrant_db2zOS.sql e armazene-a

em outro local.b. Na ferramenta de acesso remoto, abra o arquivo de script

rightsGrant_db2zOS.sql original e substitua os parâmetros de marcadorcom valores que são apropriados para o seu ambiente.Certifique-se de usar os mesmos valores usados quando você alocourecursos para os buffer pools e para a conta do usuário.

c. Inclua uma instrução de conexão no início do script.Por exemplo,connect to databasename user username using password;

d. Salve e, em seguida, execute o script.Por exemplo,db2 -tvf rightsGrant_db2zOS.sql

7. Para criar os espaços de tabela de notificação, acesse o diretórioc10_location/configuration/schemas/delivery/zosdb2.a. Faça uma cópia de backup do arquivo de script NC_TABLESPACES.sql e salve

o arquivo em outro local.b. Abra o arquivo de script NC_TABLESPACES.sql original e use a tabela a seguir

para ajudá-lo a substituir os parâmetros de marcador pelos parâmetrosapropriados para seu ambiente.

Tabela 15. Nomes e Descrições de Parâmetros de Espaços de Tabela para o Banco deDados de Notificação DB2 no z/OS

Nome do parâmetro Descrição

NCCOG Especifica o nome do banco de dados denotificação.

76 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 89: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Tabela 15. Nomes e Descrições de Parâmetros de Espaços de Tabela para o Banco deDados de Notificação DB2 no z/OS (continuação)

Nome do parâmetro Descrição

DSN8G810 Especifica o nome do grupo dearmazenamento.

BP32K Especifica o nome do pool de buffer.

Nem todos os parâmetros listados estão no script, mas alguns podem serincluídos no futuro.

c. Salve e execute o script.Por exemplo,db2 -tvf NC_TABLESPACES.sql

d. Abra o arquivo de script NC_CREATE_DB2.sql e substitua o parâmetro demarcador NCCOG pelo nome do banco de dados de notificação.

e. Salve o script.Os serviços de tarefa e monitor de programação executarão o scriptautomaticamente. No entanto, você mesmo pode executá-lo.

8. Para criar os espaços de tabela de tarefas manuais, acesse o diretórioc10_location/configuration/schemas/hts/zosdb2.a. Faça uma cópia de backup do arquivo de script HTS_tablespaces.sql e

salve o arquivo em outro local.b. Abra o arquivo de script HTS_TABLESPACES.sql original e use a tabela a

seguir para ajudá-lo a substituir os parâmetros genéricos pelos parâmetrosapropriados para seu ambiente.

Tabela 16. Nomes de Parâmetro de Espaço de Tabela e Descrições para Tarefas Manuaisno DB2 para z/OS

Nome do parâmetro Descrição

NCCOG Especifica o nome do banco de dados.

DSN8G810 Especifica o nome do grupo dearmazenamento.

BP32K Especifica o nome do buffer pool de 32 k.

Consulte o script para uma lista completa dos parâmetros necessários.c. Salve e execute o script.d. Abra o arquivo de script HTS2_CREATE_Db2zos.sql e use a tabela a seguir

para ajudá-lo a substituir os parâmetros genéricos pelos parâmetrosapropriados para seu ambiente.

Tabela 17. Nomes de Parâmetro de Espaço de Tabela e Descrições para Tarefas Manuaisno DB2 para z/OS

Nome do parâmetro Descrição

NCCOG O nome do banco de dados.

Consulte o script para uma lista completa dos parâmetros necessários.e. Salve e execute o script.

9. Para criar os espaços de tabela de anotações, acesse o diretórioc10_location/configuration/schemas/ans/zosdb2.a. Faça uma cópia de backup do arquivo de script ANN_TABLESPACES.sql e

salve o arquivo em outro local.

Capítulo 5. Instalação e Configuração dos Componentes do Produto em um Computador 77

Page 90: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

b. Abra o arquivo de script ANN_TABLESPACES.sql original e use a tabela aseguir para ajudá-lo a substituir os parâmetros genéricos pelos parâmetrosapropriados para seu ambiente.

Tabela 18. Nomes de Parâmetro de Espaço de Tabela e Descrições para Anotações noDB2 para z/OS

Nome do parâmetro Descrição

NCCOG O nome do banco de dados.

DSN8G810 O nome do grupo de armazenamento.

BP32K O nome do buffer pool de 32 k.

Consulte o script para uma lista completa dos parâmetros necessários.c. Salve e execute o script.d. Abra o arquivo de script ANS2_CREATE_Db2zos.sql e use a tabela a seguir

para ajudá-lo a substituir os parâmetros genéricos pelos parâmetrosapropriados para seu ambiente.

Tabela 19. Nomes de Parâmetro de Espaço de Tabela e Descrições para Anotações noDB2 para z/OS

Nome do parâmetro Descrição

NCCOG O nome do banco de dados.

Consulte o script para uma lista completa dos parâmetros necessários.e. Salve e execute o script.

Configurar a Conectividade do Banco de Dados para umArmazenamento de Conteúdo Oracle

Este procedimento descreve como configurar a conectividade do banco de dadospara um armazenamento de conteúdo do Oracle. Você deve executar esteprocedimento em cada computador em que instalar Content Manager.

Procedimento1. No computador onde está instalado o cliente Oracle, acesse o diretório

ORACLE_HOME/jdbc/lib.2. Copie o arquivo de biblioteca completo da sua versão do cliente Oracle para o

diretório c10_location\webapps\p2pd\WEB-INF\lib no computador onde oContent Manager está instalado e onde a notificação é enviada para um bancode dados Oracle.Se estiver usando o Oracle 10g, você deve ter ojdbc14.jar.Se estiver usando o Oracle 11g, você deve ter ojdbc5.jar.Os arquivos estão disponíveis de uma instalação do cliente ou servidor Oracle etambém podem ser transferidos por download do Web site de tecnologiaOracle.

Configurar Conectividade do Banco de Dados para umArmazenamento de Conteúdo Informix

Este procedimento descreve como configurar a conectividade do banco de dadospara um armazenamento de conteúdo do Informix. Você deve executar esteprocedimento em cada computador em que instalar Content Manager.

78 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 91: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Procedimento1. No computador onde o Informix está instalado, acesso o diretório

Informix_location/sqllib/java.2. Copie os seguintes arquivos para o diretório c10_location/webapps/p2pd/WEB-

INF/lib em cada computador em que o Content Manager estiver instalado.v o arquivo do driver universal, db2jcc.jarv o arquivo de licença, db2jcc_license_cisuz.jar

Configurar a Conectividade do Banco de Dados para umArmazenamento de Conteúdo Sybase

Este procedimento descreve como configurar a conectividade do banco de dadospara um armazenamento de conteúdo do Sybase. Você deve executar esteprocedimento em cada computador em que instalar Content Manager.

Procedimento1. 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 c10_location/webapps/p2pd/WEB-

INF/lib em cada computador onde o Content Manager estiver instalado e ondea notificação é enviada para um banco de dados do Sybase.

Configurando o cliente de banco de dados MobileO serviço do IBM Cognos Mobile deve acessar diretamente o banco de dados dearmazenamento de conteúdo em vez de acessar por meio do Content Manager.Portanto, o serviço deve ter acesso aos mesmos drivers Java Database Connectivity(JDBC) que são instalados com o IBM Cognos Business Intelligence.

O serviço tem acesso direto aos drivers JDBC instalados com Cognos BI se oCognos Mobile usar o mesmo Content Manager que o Cognos BI ou usar umbanco de dados Microsoft SQL Server. Entretanto, se o IBM Cognos Mobile nãoutiliza o Content Manager do IBM Cognos BI ou se ele utiliza um banco de dadosDB2 ou banco de dados Oracle, é necessário configurar o software do cliente debanco de dados para permitir acesso direto ao banco de dados de armazenamentode conteúdo.

Para obter mais informações sobre a configuração da conectividade do banco dedados para o banco de dados de armazenamento de conteúdo, consulte “Configurea conectividade do banco de dados para o banco de dados de armazenamento deconteúdo.” na página 72.

Se você deseja usar um banco de dados diferente do banco de dados do ContentManager que o IBM Cognos BI está configurado a usar, deve definir outro bancode dados usando a Configuração do IBM Cognos. Certifique-se de usar um dosservidores de banco de dados suportados para criar um banco de dados. Paraobter mais informações sobre como criar um armazenamento de conteúdo, consulte“Diretrizes para Criar o Armazenamento de Conteúdo” na página 34.

Configurando o cliente de banco de dados Mobile no OracleSe você usar o Oracle como servidor de base de dados para armazenamento deconteúdo, deve-se configurar o driver Java Database Connectivity (JDBC).

Capítulo 5. Instalação e Configuração dos Componentes do Produto em um Computador 79

Page 92: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Procedimento1. No computador no qual o cliente Oracle está instalado, acesse o diretório

ORACLE_HOME/jdbc/lib.2. Copie o arquivo .jar para a sua versão do Oracle para c10_location/webapps/

p2pd/WEB-INF/lib nos computadores em que o IBM Cognos Mobile estáinstalado, como a seguir:v Para Oracle 10g, copie o arquivo ojdbc14.jar.v Para Oracle 11g, copie o arquivo ojdbc5.jar.Esses arquivos incluem o driver requerido pelo armazenamento de conteúdo.

Configurando o cliente de banco de dados do Mobile no DB2Se você usa o DB2, deve configurar o software do cliente de banco de dados e odriver Java Database Connectivity (JDBC) 2.0. Isso deve ser feito em cadacomputador em que o Content Manager está instalado, depois de instalar e antesde configurar o IBM Cognos BI.

Procedimento1. Instale o software do cliente DB2 nos computadores apropriados.2. Se o armazenamento de conteúdo estiver em um computador diferente do IBM

Cognos Mobile, faça o seguinte:a. Configure um alias do banco de dados para o armazenamento de conteúdo

executando o DB2 Client Configuration Assistant.Nos sistemas operacionais UNIX ou Linux, use a interface de linha decomandos do DB2.

b. Quando configurar os computadores IBM Cognos Mobile, certifique-se deque eles estejam todos configurados para usar o mesmo armazenamento deconteúdo.

3. No sistema operacional Microsoft Windows, pare os serviços do DB2 e o HTMLSearch Server.

4. No UNIX, certifique-se de que as bibliotecas de 32 bits do DB2 estejam nocaminho da procura de biblioteca, que geralmente é o diretório $DB2DIR/lib ouo diretório $DB2DIR/lib32.

5. Copie o arquivo do driver universal, db2jcc.jar, do diretórioDB2_installation/sqllib/java para o diretório c10_location/webapps/p2pd/WEB-INF/lib.Se estiver se conectando ao DB2 no z/OS, use a versão do driver do Linux,UNIX ou Windows versão 9.1 fix pack 5 ou versão 9.5 fix pack 2.Para verificar a versão do driver, execute o seguinte comando:java -cp path\db2jcc.jar com.ibm.db2.jcc.DB2Jjcc - version

6. Copie um dos seguintes arquivos de licença do diretório DB2_installation/sqllib/java para o diretório c10_location/webapps/p2pd/WEB-INF/lib:v para o DB2 no Linux, UNIX ou Windows, db2jcc_license_cu.jarv para o DB2 no z/OS, db2jcc_license_cisuz.jar

7. No Windows, reinicie os serviços do DB2 e o HTML Search Server.8. No UNIX, se estiver usando a conectividade JDBC tipo 2, certifique-se de que

as bibliotecas de 32 bits do DB2 estejam no caminho da procura de biblioteca,que geralmente é o diretório $DB2DIR/lib ou o diretório $DB2DIR/lib32.

9. Repita as etapas nos outros computadores IBM Cognos BI em que o softwaredeve ser instalado.

80 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 93: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Resultados

É possível sintonizar o banco de dados para aproveitar os recursos do DB2. Paraobter informações adicionais, consulte o IBM Cognos Business IntelligenceArchitecture and Deployment Guide.

DB2 no z/OS como um banco de dados MóvelÉ possível usar o DB2 no z/OS como seu banco de dados móvel.

As configurações de conexão do DB2 no z/OS são similares às do DB2 em sistemasoperacionais Linux, UNIX e Microsoft Windows. Entretanto, configuraçõesavançadas adicionais devem ser definidas.

Um administrador de banco de dados deve executar scripts para criar um conjuntode espaços de tabelas necessário para o banco de dados móvel. Os scripts devemser alterados para substituir os parâmetros de espaço reservado com os adequadosa seu ambiente.

Configurações sugeridas para criar um banco de dados DB2Mobile no z/OSO banco de dados criado para o banco de dados móvel deve conter as definiçõesde configuração especificadas.

Para assegurar uma instalação bem-sucedida, use as seguintes diretrizes ao criar obanco de dados do Cognos Mobile.v Crie uma instância de banco de dados, grupo de armazenamentos e uma conta

de usuário para o armazenamento do Cognos Mobile.O usuário deve ter permissões para criar e excluir tabelas no banco de dados. OIBM Cognos Business Intelligence usa as credenciais da conta do usuário paracomunicar-se com o servidor de banco de dados.

v Certifique-se de reservar um buffer pool 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 de bancode dados.

v Os administradores devem executar um script para criar espaços de tabela paraconter objetos grandes e outros dados para o banco de dados do Cognos Mobileusar os espaços de tabela.

v O administrador de banco de dados deve fazer backup dos bancos de dados doIBM Cognos BI regularmente, pois eles contêm dados do IBM Cognos. Paraassegurar a segurança e a integridade dos bancos de dados, proteja-os do acessonão autorizado ou inapropriado.

Criando espaços de tabelas para o banco de dados do CognosMobile no DB2 for z/OSUm administrador de banco de dados deve executar scripts para criar um conjuntode espaços de tabelas necessário para o banco de dados móvel. Os scripts devemser alterados para substituir os parâmetros de espaço reservado com os adequadosa seu ambiente.

Certifique-se de que sejam usadas as convenções de nomenclatura para o DB2 noz/OS. Por exemplo, todos os nomes de parâmetros devem começar com uma letrae o comprimento não pode exceder oito caracteres.

Para obter mais informações, consulte a documentação do IBM DB2.

Capítulo 5. Instalação e Configuração dos Componentes do Produto em um Computador 81

Page 94: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Procedimento1. Conecte-se ao banco de dados como um usuário que possui privilégios para

criar e eliminar espaços de tabelas para permitir a execução de instruçõesSQL.

2. Vá até o diretório que contém os scripts:c10_location/configuration/schemas/mobile/db2zOS.

3. Abra o arquivo de script tablespace_db2zOS.sql.4. Inclua uma instrução de conexão no início do script.

Por exemplo,connect to databasename/

5. Use as informações a seguir para ajudá-lo a substituir os parâmetros genéricospelos apropriados para seu ambiente.

COGMOBDBEspecifica o nome do banco de dados móvel.

DB0AUSREspecifica o nome do grupo de armazenamento.

BP32KEspecifica o nome do pool de buffer.

6. Salve e execute o script tablespace_db2zOS.sql.Por exemplo,db2 -td/ -vf tablespace_db2zOS.sql

7. Abra o arquivo de script rightsGrant_db2zOS.sql e substitua os parâmetrosde item temporário COGMOBDB e MOBUSR pelo nome do banco de dados e nomede usuário necessários, respectivamente.

8. Inclua uma instrução de conexão no início do script.Por exemplo,connect to databasename/

9. Salve e execute o script rightsGrant_db2zOS.sql.Por exemplo,db2 -td/ -vf rightsGrant_db2zOS.sql

10. Abra o arquivo de script initialize-schema-version-table.sql, substitua oparâmetro de item temporário COGMOBDB pelo nome do banco de dadosnecessário e salve o script.

11. Abra o arquivo de script upgrade-lock-object-init.sql, substitua osparâmetros de item temporário COGMOBDB, DB0AUSR e BP32K pelos nomes debancos de dados, de grupos de armazenamentos e de buffer pools e salve oscript.

12. Abra os arquivos de script restantes que começam com upgrade e substitua osparâmetros de item temporário COGMOBDB e DB0AUSR pelo nome de banco dedados e nome do grupo de armazenamentos necessários, respectivamente.

13. Salve os scripts, mas não os execute manualmente.Os scripts serão executados automaticamente quando o Mobile Service foriniciado.

Resultados

O banco de dados Cognos Mobile é criado. Agora é possível especificar o banco dedados Cognos Mobile no IBM Cognos Configuration.

82 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 95: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Para obter mais informações sobre o IBM Cognos Configuration, consulte o IBMCognos Business Intelligence Installation and Configuration Guide.

Início do IBM Cognos ConfigurationUse IBM Cognos Configuration para configurar os componentes do IBM CognosBusiness Intelligence e iniciar e parar serviços do IBM Cognos.

Se você estiver usando um servidor de aplicativos diferente do fornecido, deve-seiniciar e parar os serviços do IBM Cognos por meio do servidor de aplicativos.

Antes de Iniciar

Antes de iniciar o IBM Cognos Configuration, certifique-se de que o ambienteoperacional esteja devidamente configurado. Por exemplo, certifique-se de quetodas as variáveis de ambiente foram definidas.

Em um sistema operacional Microsoft Windows, é possível iniciar o IBM CognosConfiguration na última página do assistente de instalação somente se não fornecessário fazer nenhuma configuração adicional. Por exemplo, se você usar umservidor de banco de dados que não seja Microsoft SQL ou Banco de dados deconteúdo do Cognos para o armazenamento de conteúdo, copie os drivers JavaDatabase Connectivity (JDBC) no local apropriado antes de iniciar a ferramenta deconfiguração.

Em sistemas operacionais UNIX ou Linux, não inicie oIBM Cognos Configurationna última página do assistente de instalação. Configuração adicional é necessáriaantes de ser possível configurar o IBM Cognos BI. Por exemplo, você deveatualizar seu ambiente Java.

Assegure-se de que a conta do usuário ou do serviço usada para executar o IBMCognos tenha sido configurada.

Procedimento1. No Microsoft Windows, clique em Iniciar > IBM Cognos Configuration.

Se estiver usando um computador Windows Vista, Windows 7 ou Windows2008 e tiver instalado o produto no diretório Arquivos de Programas (x86),inicie o IBM Cognos Configuration como um Administrador.

2. Nos sistemas operacionais UNIX ou Linux, acesse o diretórioc10_location/bin64 e, em seguida, digite o seguinte comando:./cogconfig.sh

Se o IBM Cognos Configuration não abrir, certifique-se de que você configuroua variável de ambiente DISPLAY.Se você vir uma mensagem JAVA.Lang.unsatisfied link, verifique se estáusando uma versão suportada do Java.Se você vir uma mensagem Java.lang.unsupportedClassVersionError,certifique de que está usando uma versão de 64 bits do Java.

Capítulo 5. Instalação e Configuração dos Componentes do Produto em um Computador 83

Page 96: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Configurando Propriedades de Ambiente no IBM CognosConfiguration

Especifique o nome do servidor ou um endereço IP nas propriedades URI usadaspelo IBM Cognos Business Intelligence. Isso garantirá que os usuários emdiferentes locais podem se conectar aos relatórios e às áreas de trabalho enviadospor email. Por padrão, as propriedades do URI especificam o localhost.

Procedimento1. Inicie o IBM Cognos Configuration.2. Na janela Explorer, clique em Ambiente.3. Na janela Propriedades, altere a parte localhost de todas as propriedades URI

para o nome ou endereço IP do seu servidor IBM Cognos BI fazendo oseguinte:v Para URIs do Content Manager, clique no valor e, em seguida, no ícone de

edição. Mude o valor e clique em OK.v Para todas as outras propriedades URI, clique no valor e altere-o.

4. Na janela Explorer, em Segurança > Criptografia, clique em Cognos, oprovedor de criptografia padrão.

5. No grupo de propriedades Configuração 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 acesso anônimo. Se quiserusar segurança em seu ambiente do IBM Cognos BI, você deverá desativar oacesso anônimo e configurar o IBM Cognos BI para usar um provedor deautenticação.

Procedimento1. Na janela IBM Cognos Configuration Explorer, 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 em 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, nocomponente Autenticação.

6. Na janela Propriedades, na propriedade ID do namespace, especifique umidentificador exclusivo para o namespace.

7. No menu Arquivo, clique em Salvar.

84 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 97: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Definição de propriedades de conexão com o banco de dados para oarmazenamento de conteúdo

Deve-se especificar as informações do servidor de banco de dados para garantirque o Content Manager possa ser conectado ao banco de dados que você utilizapara o armazenamento de conteúdo. O Content Manager usa o logon do banco dedados para acessar o armazenamento de conteúdo. Após definir as propriedadesde conexão com o banco de dados, é possível testar a conexão entre o ContentManager e o armazenamento de conteúdo.

Se o Banco de Dados de Conteúdo do Cognos foi instalado, as propriedades deconexão do banco de dados usarão o Banco de Dados de Conteúdo do Cognos, porpadrão. Não é necessário alterar as propriedades de conexão padrão. Entretanto, oBanco de Dados de Conteúdo do Cognos é apenas para sistemas de teste ou provade conceito. Ao mudar para um ambiente de produção, deve usar um banco dedados de nível empresarial para armazenamento do conteúdo.

Se você estiver atualizando a partir de uma versão anterior do IBM Cognos BI,configure o IBM Cognos BI para apontar para uma cópia do banco de dados dearmazenamento de conteúdo existente. Após salvar a configuração e iniciar oserviço do IBM Cognos, os dados no armazenamento de conteúdo serãoautomaticamente atualizados e não poderão ser usados pela versão anterior. O usode uma cópia do banco de dados original com a nova versão permite manter aversão anterior em execução com os dados originais.Conceitos relacionados:“Usar o protocolo secure sockets layer (SSL) para conexões com o banco de dadosno IBM Cognos Configuration” na página 245É possível configurar o IBM Cognos Business Intelligence para usar o protocolosecure sockets layer (SSL) para comunicação com bancos de dados usados peloIBM Cognos BI, incluindo armazenamento de conteúdo, notificação e criação delog de bancos de dados.

Configurando as Propriedades de Conexão do Banco deDados para um Armazenamento de Conteúdo DB2

Deve-se especificar as informações do servidor de banco de dados para garantirque o Content Manager possa ser conectado ao banco de dados que você utilizapara o armazenamento de conteúdo.

Procedimento1. No local em que 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:v Clique na caixa de seleção Valor próxima à propriedade ID do usuário e

senha e clique no botão de edição quando ele aparecer.Se você estiver se conectando a um banco de dados no DB2 no z/OS,assegure-se de especificar o mesmo ID do usuário que o valor especificadopara CMSCRIPT_USERNAME quando criou os espaços de tabela.

Capítulo 5. Instalação e Configuração dos Componentes do Produto em um Computador 85

Page 98: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

v Digite os valores apropriados e clique em OK.5. No campo Servidor de Banco de Dados e Número da Porta, insira o nome do

seu computador e número de porta no qual o DB2 está sendo executado. Porexemplo, localhost:50000. 50000 é o número de porta padrão usado pelo DB2.Se você estiver usando um número de porta diferente, certifique-se de usar talvalor.

6. Se você estiver se conectando a um banco de dados no DB2 no z/OS:a. Na janela Explorer, clique em Configuração Local.b. Na janela Propriedades, próxima a Propriedades avançadas, clique dentro

da caixa Valor e clique no ícone de edição.c. Clique em Incluir para incluir os parâmetros que usou para criar os espaços

de tabela. Inclua todos os parâmetros, exceto CMSCRIPT_USERNAME.7. No menu Arquivo, clique em Salvar.

Configurando as Propriedades de Conexão do Banco deDados para um Armazenamento de Conteúdo Microsoft SQLServer, Oracle, Informix ou Sybase

Deve-se especificar as informações do servidor de banco de dados para garantirque o Content Manager possa ser conectado ao banco de dados que você utilizapara o armazenamento de conteúdo.

Procedimento1. 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.Esta etapa exclui a conexão para o recurso padrão. O Content Manager podeacessar apenas um armazenamento de conteúdo.

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

4. Na caixa Nome, digite um nome para o recurso.5. Na caixa de seleção Tipo, selecione o tipo de banco de dados e clique em OK.

Dica: Se desejar usar um par de valores da palavra-chave do Oracle Net8 paragerenciar a conexão do banco de dados, selecione Banco de Dados Oracle(Avançado).

6. Na janela Propriedades, forneça valores para o seu tipo de banco de dados:v Se você usa um banco de dados Microsoft SQL Server, digite os valores

apropriados para as propriedades Servidor de banco de dados com númeroda porta ou nome da instância e Nome do banco de dados.Para um banco de dados Microsoft SQL Server, é possível escolher usar umnúmero da porta, como 1433, uma instância denominada como valor para apropriedade Servidor de banco de dados com número da porta ou nome dainstância.Para a propriedade Servidor de banco de dados com número da porta ounome da instância, inclua o nome da instância, se houver diversas instânciasdo Microsoft SQL Server.Para conectar-se a uma instância denominada, você deve especificar o nomeda instância como uma propriedade URL Java Database Connectivity (JDBC)ou uma propriedade de origem de dados. Por exemplo, é possível digitarlocalhost\instance1. Se não forem especificadas propriedades de nome deinstância, é criada uma conexão com a instância padrão.

86 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 99: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

As propriedades especificadas para a instância denominada, junto com a ID esenha de usuário e nome do banco de dados, são usados para criar um JDBCURL. Eis um exemplo:jdbc:JSQLConnect://localhost\\instance1/user=sa/more properties as required

Para se conectar a uma instância nomeada, é necessário especificar o nomeda instância. Por exemplo, é possível digitar localhost\instance1. Se o nomede uma instância não for especificado, será criada uma conexão com ainstância padrão.

v Se você usar um banco de dados Oracle, digite os valores apropriados paraas propriedades Servidor de Banco de Dados e Número da Porta e SID.

v Se usar um banco de dados avançado do Oracle, para a propriedadeEspecificador do banco de dados, digite o par de valores de palavra-chaveOracle Net8 para a conexão.Eis um exemplo:(description=(address=(host=myhost)(protocol=tcp)(port=1521)(connect_data=(sid=(orcl)))))

Ao selecionar o banco de dados Oracle avançado, o IBM Cognos BI usarárecursos do Oracle orientados para empresa para selecionar um ouvinte,alternar para outro ouvinte se o primeiro ouvinte falhar, conectar-senovamente ao banco de dados automaticamente se a conexão falhar,equilibrar solicitações de conexão entre ouvintes e equilibrar as solicitaçõesde conexão entre dispatchers.

v Se estiver usando um banco de dados Informix, digite os valores apropriadospara as propriedades Servidor de banco de dados e número da porta eNome do banco de dados.

v Se usar um banco de dados Sybase, digite os valores apropriados para aspropriedades Servidor de banco de dados e número da porta e Nome dobanco de dados.

7. Para configurar credenciais de logon, especifique uma ID e senha de usuário:v Clique na caixa Valor próxima à propriedade ID do usuário e senha e clique

no ícone de edição quando ele aparecer.v Digite os valores apropriados e clique em OK.

8. Se hospedar mais de um banco de dados de armazenamento de conteúdo emuma instância do Informix, crie a propriedade avançada CMSCRIPT_CS_ID eespecifique a conta na qual a instância será executada:v Na janela Explorer, clique em Configuração Local.v Na janela Propriedades, clique na coluna Valor de Propriedades Avançadas

e, em seguida, clique no ícone de edição.v Na caixa de diálogo Valor - Propriedades avançadas, clique em Adicionar.v Na coluna Nome, digite CMSCRIPT_CS_ID

v Na coluna Valor, digite o ID do usuário da conta na qual a instância doarmazenamento de conteúdo é executada.Use uma conta do usuário diferente para cada instância do banco de dadosde armazenamento de conteúdo do Informix.

9. No menu Arquivo, clique em Salvar.As credenciais de logon são imediatamente criptografadas.

Capítulo 5. Instalação e Configuração dos Componentes do Produto em um Computador 87

Page 100: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Resultados

Agora o Content Manager poderá criar as tabelas necessárias no armazenamentode conteúdo quando o serviço IBM Cognos for iniciado pela primeira vez. Se aspropriedades da conexão não estiverem especificadas corretamente, não serápossível iniciar os serviços do IBM Cognos.

Especificação de uma conexão para uma conta do servidor de correioSe desejar enviar relatórios por e-mail, é necessário configurar conexão com umaconta de servidor de correio.

É necessário alterar a parte do nome do host do URI do gateway de localhost parao endereço IP do computador ou para o nome do computador. Do contrário, oURL no e-mail irá conter localhost e os usuários remotos não poderão abrir orelatório.

Procedimento1. No local em que o Content Manager está instalado, inicie o IBM Cognos

Configuration.2. Na janela Explorer, em Acesso a dados, clique em Notificação.3. 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).

Dica: Para conseguir abrir os relatórios enviados como links, certifique-se deque a URI do Gateway nos servidores de relatório e nos servidores denotificação especifique um servidor da Web acessível que hospeda o conteúdodo IBM Cognos. Se tiver usuários móveis acessando os links remotamente,considere o uso de um URI externo.

4. Clique na caixa de seleção Valor próxima à propriedade Conta e senha e cliqueno botão de edição quando aparecer.

5. Digite os valores adequados na caixa de diálogo Valor - Conta e senha e cliqueem OK.

Dica: Se as credenciais de logon não forem necessárias para o servidor SMTP,remova as informações padrão da propriedade Conta e senha. Quando forsolicitada a confirmação para deixar essa propriedade em branco, clique emOK. Certifique-se o nome de usuário padrão foi removido. Do contrário, aconta padrão é usada e as notificações não funcionarão corretamente.

6. Na janela Propriedades, digite o valor apropriado para a conta do remetentepadrão.

7. Teste as conexões de servidores de correio. Na janela Explorer, clique com obotão direito em Notificação e clique em Testar.O IBM Cognos Business Intelligence testa a conexão de servidores de correio.

Resultados

Se não planeja enviar relatórios por e-mail ou não deseja configurar uma conta deservidor de correio imediatamente, não é necessário. Entretanto, ao salvar aconfiguração e depois iniciar os serviços no IBM Cognos Configuration, apareceráuma mensagem de aviso quando a conexão de servidores de correio for testada.Ignore, com segurança, o aviso.

88 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 101: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Configurar um Namespace do IBM Cognos Series 7 no IBMCognos BI

Se quiser migrar as informações de segurança ou o conteúdo assegurado do IBMCognos Series 7 para o IBM Cognos Business Intelligence, você deve configurarum namespace no IBM Cognos BI que seja idêntico ao namespace do IBM CognosSeries 7.

É possível configurar vários namespaces para autenticação no IBM Cognos BI.Para obter mais informações, consulte Capítulo 8, “Configurando Componentes doIBM Cognos para Usar um Provedor de Autenticação”, na página 165.

Nota: : Não é possível usar um arquivo Local Authentication Export (LAE) do IBMCognos Series 7 para autenticação com componentes do IBM Cognos BI.

Recomendamos que todos os namespaces do IBM Cognos Series 7 usem o mesmoServidor do Chamado principal do IBM Cognos Series 7. Do contrário, podem serrecebidos erros ou avisos de autenticação mais de uma vez.

Se alterar as informações de configuração armazenadas no servidor de diretóriousado para o IBM Cognos Series 7, você deve reiniciar o serviço do IBMCognos BI antes das mudanças terem efeito na instalação do IBM Cognos.

Um usuário deve estar em pelo menos uma classe de usuário do Access Managerpara poder efetuar logon nos componentes do IBM Cognos BI.

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

Cognos.3. Clique na caixa Valor para Permitir acesso anônimo e selecione Falso.4. Na janela Explorer, clique com o botão direito em Autenticação e selecione

Novo recurso, Namespace.5. Na caixa Nome, digite um nome para o namespace de autenticação.6. Na lista Tipo, clique em IBM Cognos Series 7 e depois em OK.

O novo recurso provedor de autenticação aparece na janela Explorer, nocomponente Autenticação.

7. Na janela Propriedades do Recurso, especifique os valores obrigatórios.Determinados valores devem corresponder aos valores usados ao configurar onamespace do IBM Cognos Series 7 no Gerenciador de Configuração. NoConfiguration Manager, as propriedades estão localizadas em Serviços, AccessManager - Runtime, Directory Server.v Para ID do Namespace, especifique um identificador exclusivo para o

namespace.v Para Host e porta, digite o mesmo valor usado para a propriedade

Computador no Configuration Manager.O formato deve ser idêntico. Se você usar um endereço IP no IBM CognosSeries 7, digite o mesmo endereço IP. Se usar um nome de host de rede noIBM Cognos Series 7, digite o mesmo nome de host de rede.

v Para Nome Distinto Base, digite o mesmo valor usado para a propriedadeNome Distinto Base (DN) no Configuration Manager.

Capítulo 5. Instalação e Configuração dos Componentes do Produto em um Computador 89

Page 102: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

v Para Nome do namespace, digite o mesmo valor usado para a propriedadeNamespace padrão no Configuration Manager.Este valor diferencia maiúsculas de minúsculas e deve corresponderexatamente.

8. Especifique os valores para todas as demais propriedades necessárias paraassegurar que componentes do IBM Cognos BI possam localizar e usar seuprovedor de autenticação existente.Se a versão do namespace IBM Cognos Series 7 for 16.0, certifique-se de que apropriedade Codificação de dados esteja configurada como UTF-8. Alémdisso, os computadores onde o Content Manager está instalado devem usar omesmo código do idioma que os dados no namespace do IBM CognosSeries 7.

9. Se o ambiente do namespace incluir a versão 15.2 do namespace IBM CognosSeries 7, você deverá desativar a configuraçãoSeries7NamespacesAreUnicode.v Na janela Propriedades, no valor Propriedades Avançadas, clique no ícone

de edição.v Na janela Valor - Propriedades avançadas, clique em Adicionar.v Na caixa Nome, digite Series7NamespacesAreUnicode.v Na caixa Valor, digite Falso e depois clique em OK.

10. Na janela Propriedades, em Configurações de Cookie, certifique-se de que aspropriedades Caminho, Domínio e Sinalizador Seguro Ativadocorrespondam às configurações feitas para o IBM Cognos Series 7.

11. No menu Arquivo, clique em Salvar.

Inicie os serviços do IBM CognosPara registrar o serviço do IBM Cognos Business Intelligence para que os usuáriospossam acessá-lo por meio do IBM Cognos Connection, você deve iniciar osserviços. Antes de iniciar os serviços, teste a configuração usando o recurso deteste no IBM Cognos Configuration.

Antes de Iniciar

Antes de começar, certifique-se de que uma conta de usuário ou serviço estejaconfigurado. Para obter mais informações, consulte “Configuração de uma Contade Usuário ou Conta de Serviço de Rede para o IBM Cognos Business Intelligence”na página 43.

Procedimento1. Inicie o IBM Cognos Configuration.

Se estiver atualizando, será exibida uma mensagem indicando que os arquivosde configuração foram detectados e atualizados para a nova versão.

2. Certifique-se de que suas configurações foram salvas, caso contrário, não serápossível iniciar o serviço do IBM Cognos.

3. No menu Ações, clique em Testar.O IBM Cognos Configuration verifica a disponibilidade da chave simétricacomum (CSK), testa a configuração do namespace e testa as conexões com oarmazenamento de conteúdo e outros recursos.

Dica: Se Teste não estiver disponível para seleção, na janela Explorer, cliqueem Configuração Local.

90 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 103: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

4. Se o teste falhar, configure novamente as propriedades afetadas e faça o testede novo.É possível testar alguns componentes individualmente clicando com o botãodireito no componente na área de janela 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 do IBM Cognos iniciar.Essa ação inicia todos os serviços instalados que não estão em execução eregistra o serviço do IBM Cognos no Windows.

Configurando o Servidor da WebVocê deve configurar o servidor da web antes que os usuários possam se conectarao portal IBM Cognos BI.

Para o IBM Cognos BI para relatórios, você também deve configurar a validade doconteúdo para o diretório de imagens em seu servidor da Web para que onavegador da Web não verifique o status da imagem após o primeiro acesso.

Nos sistemas operacionais UNIX e Linux, a conta sob a qual o servidor da web éexecutado deve ter acesso de leitura ao arquivo cogstartup.xml no diretórioc10_location/configuration. Por padrão, o arquivo cogstartup.xml tem permissãode leitura para outros. Se o servidor da web é executado em um grupo específico,é possível alterar as permissões do arquivo cogstartup.xml para garantir que elepertença ao mesmo grupo do servidor da web. É possível então remover apermissão de leitura para os outros.

Usar Gateways Compilados para Sistemas de ProduçãoPara sistemas de produção, é possível melhorar o desempenho alterando ogateway a partir do gateway CGI padrão.

Os gateways compilados incluem:v Microsoft Internet Server Application Programming Interface (ISAPI) para

Microsoft Internet Information Services (IIS)v Módulo Apache para Servidor da Web Apache ou IBM HTTP Serverv Aplicativo Java do gateway de servlet, se desejar usar um servidor de

aplicativos para entregar as páginas do portal no lugar de um servidor da web

Usar Módulos Apache no Servidor Apache ou IBM HTTP ServerÉ possível usar os módulos Apache para Apache Server 2.2.x ou Apache Server2.0.x ou para IBM HTTP Server 8, 7 ou 6.1.

Importante: Não é possível usar os módulos Apache com a versão do ApacheServer 2.2 que é fornecida com o Red Hat Enterprise Linux versão 5.3 e posterior.

Procedimento1. Anexe o diretório c10_location/cgi-bin à variável de ambiente apropriada:

v No Solaris ou Linux, LD_LIBRARY_PATHv Em HP-UX, SHLIB_PATH e LD_LIBRARY_PATHv No AIX, LIBPATH

2. Acesse o diretório Webserver_installation/conf.3. Abra o arquivo httpd.conf em um editor.

Capítulo 5. Instalação e Configuração dos Componentes do Produto em um Computador 91

Page 104: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

4. Certifique-se de que tanto o nome do servidor quanto o número da porta deservidor da web sejam especificados para a propriedade ServerName.

5. Adicione o seguinte ao final da lista de carregamento de módulo:LoadModule cognos_module "c10_location/cgi-bin/mod2_2_cognos.suffix"

Onde suffix é listado conforme a tabela a seguir.

Tabela 20. Sufixo de Módulo para o seu Sistema Operacional

Sistema operacional Sufixo

Windows dll

Solaris, AIX, HP-UX IA, Linux so

Módulos Apache são fornecidos para versões diferentes do Servidor Apacheou do IBM HTTP Server:v Use o módulo mod2_2_cognos para Apache Server 2.2.x ou IBM HTTP

Server 8 e 7.v Use o módulo mod2_cognos para o Servidor Apache 2.0.x e IBM HTTP

Server 6.1.6. Inclua o seguinte:

ScriptAlias /ibmcognos/cgi-bin "c10_location/cgi-bin"

<Directory "c10_location/cgi-bin">AllowOverride NoneOptions NoneOrder allow,denyAllow from all

</Directory>

Alias /ibmcognos "c10_location/webcontent"

<Directory "c10_location/webcontent">Options Indexes MultiViewsAllowOverride NoneOrder allow,denyAllow from all

</Directory>

A diretiva <Directory> é opcional.

Nota: Assegure-se de definir o alias /ibmcognos/cgi-bin antes do alias/ibmcognos.

Importante: O ibmcognos é o valor padrão usado nos valores URI doGateway e URI do Controlador para o gateway no IBM CognosConfiguration. Se você não usar o ibmcognos para os valores de ScriptAlias eAlias, certifique-se de mudar os valores de URI do Gateway e URI doControlador para o gateway para corresponder aos valores que você usa.Também, certifique-se de utilizar o mesmo valor para a parte ibmcognos dosvalores ScriptAlias e Alias conforme mostrado nos exemplos.

7. Adicione o seguinte à seção de relatórios de status do servidor:<Location /ibmcognos/cgi-bin/module_alias>SetHandler cognos-handlerOrder allow,denyAllow from all</Location>

Onde module_alias for um nome que é possível escolher.8. Para ativar a página de diagnóstico do gateway, adicione o seguinte à seção

de relatórios de status do servidor:

92 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 105: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

<Location /ibmcognos/cgi-bin/diag_module_alias>SetHandler cognos-handlerOrder allow,denyAllow from all</Location>

Onde diag_module_alias for um nome que é possível escolher.9. Adicione o seguinte à seção de diretório do usuário:

<IfModule mod2_2_cognos.c>CGIBinDir "c10_location/cgi-bin"</IfModule>

Arquivos de módulo Apache são fornecidos por diferentes versões doServidor Apache ou do IBM HTTP Server:v Use mod2_2_cognos.c para Apache Server 2.2.x ou IBM HTTP Server 8 e 7.v Use mod2_cognos.c para Servidor Apache 2.0.x e IBM HTTP Server 6.1.

10. Salve e feche o arquivo.11. No HP-UX, ative a procura por SHLIB_PATH executando o seguinte comando

no diretório Apache_installation/bin:chatr +s enable +b enable httpd

12. Reinicie o servidor da Web.13. Inicie o IBM Cognos Configuration.14. No painel Explorer, clique em Configuração Local > Ambiente.15. Na caixa URI do Gateway, altere a parte cognos.cgi da URI para

module_alias.Por exemplo, http://host_name:port/ibmcognos/cgi-bin/module_alias.

16. Salve as mudanças.

Resultados

Os usuários podem acessar o servidor inserindo a URI do módulo do Apache emseu navegador. Por exemplo,

http://servername:port/ibmcognos/cgi-bin/module_alias.

Use o Gateway ISAPI no Microsoft Internet Information Services(IIS) Versão 7 ou 8Se você estiver usando um servidor da web Microsoft Internet Information Services(IIS), configure o IBM Cognos para usar o gateway ISAPI em vez do gateway CGIpadrão.

Sobre Esta Tarefa

Se estiver usando o Microsoft IIS como seu servidor da web e planejar executarmais de um produto do IBM Cognos BI, ou várias instâncias do mesmo produto,em um computador, deverá criar um conjunto de aplicativos separado para cadaproduto ou instância e, em seguida, associar os aliases desse produto ou instânciapara o conjunto de aplicativos.

Para obter mais informações sobre como criar um conjunto de aplicativos, consultesua documentação do servidor da web.

Importante: Se você estiver usando a versão de 32 bits do gateway ISAPI, deveativar o aplicativo de 32 bits para o conjunto de aplicativos usado para o gatewaydo IBM Cognos. No Internet Information Services (IIS) Manager, selecione o

Capítulo 5. Instalação e Configuração dos Componentes do Produto em um Computador 93

Page 106: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

conjunto de aplicativos usado para o IBM Cognos e clique em ConfiguraçõesAvançadas. Altere o valor para Ativar Aplicativos de 32 Bits para True.

Procedimento1. No Painel de Controle do Microsoft Windows, clique em Programas >

Programas e Recursos.Se estiver usando o Microsoft Windows 8 ou 2012 Server, Programas eRecursos está disponível diretamente no Painel de Controle.

2. Clique em Ativar ou desativar recursos.3. Se você estiver usando o Microsoft Windows 2008 Server, use as etapas a

seguir:a. Clique em Gerenciador de Servidor > Funções > Servidor da Web (IIS).b. Assegure que Recursos de HTTP Comuns, ou os recursos que você requer

são ativados.c. Se as extensões ISAPI estiverem configuradas para Não instaladas,

selecione extensões ISAPI e clique em Incluir Serviço de Função.4. Se você estiver usando o Microsoft Windows 2012 Server, use as etapas a

seguir:a. No Assistente Incluir Funções e Recursos, clique em Instalação baseada

em função ou em recurso, e clique em Avançar.b. Selecione seu servidor e clique em Avançar.c. Selecione Web Server (IIS), se ele ainda não estiver instalado, assegure que

Recursos HTTP Comuns está selecionado e clique em Avançar até chegarà seção Serviços de Função do assistente.

d. Expanda Desenvolvimento de Aplicativo.e. Selecione extensões ISAPI se ainda não estiver selecionado e clique em

Avançar.f. Clique em Instalar.

5. Se estiver usando o Microsoft Windows 7 ou 8, use as etapas a seguir:a. Selecione Internet Information Services se ainda não estiver selecionado.b. Expanda Internet Information Services > World Wide Web Services.c. Assegure que Recursos de HTTP Comuns, ou os recursos que você requer

são ativados.d. Expanda Recursos de Desenvolvimento de Aplicativo.e. Se asextensões ISAPI não estiverem selecionadas, selecione extensões

ISAPI.f. Clique em OK.

6. No console Gerenciador do Internet Information Services (IIS), emConexões, selecione seu nome de servidor.v Se você estiver usando o Microsoft Windows 2012 Server, no Gerenciador

de Servidor, selecione IIS, e depois dê um clique direito no nome do seuservidor e clique em Gerenciador do Internet Information Services (IIS).

v Se você estiver usando o Microsoft Windows 2008 Server, no Gerenciadorde Servidor, expanda Funções > Web Server (IIS), e depois clique emGerenciador do Internet Information Services (IIS).

v Caso esteja usando o Microsoft Windows 8, a partir do Painel de Controle,clique em Ferramentas Administrativas para acessar o console do InternetInformation Services (IIS) Manager.

94 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 107: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

v Caso esteja usando o Microsoft Windows 7, a partir do Painel de Controle,clique em Sistema e Segurança > Ferramentas Administrativas paraacessar o console do Internet Information Services (IIS) Manager.

7. Expanda Sites e em seu website, inclua os diretórios virtuais conformemostrado na tabela:

Tabela 21. Diretórios Virtuais Necessários

Alias Localização

ibmcognos c10_location/webcontent

ibmcognos/cgi-bin c10_location/cgi-bin

Importante: O ibmcognos é o valor padrão usado nos valores URI doGateway e URI do Controlador para o gateway no IBM CognosConfiguration. Se você não usar o ibmcognos para os valores de Alias,certifique-se de ter mudado para os valores URI do Gateway e URI doControlador para gateway para corresponder aos valores que você usa.

8. Selecione o diretório virtual cgi-bin que você criou.9. Clique duas vezes em Mapeamentos do Manipulador.

10. Sob Ações, clique em Incluir Mapeamento de Módulo.a. Em Solicitar Caminho, digite cognosisapi.dll.b. Em Módulo, selecione IsapiModule.c. Em Executável, insira o caminho para o arquivo cognosisapi.dll.

Por exemplo, digite:C:\Program Files\ibm\cognos\c10\cgi-bin\cognosisapi.dll

d. Em Nome, insira um nome para a entrada, como CognosISAPI.e. Clique em OK.f. Clique em Sim na caixa de diálogo para permitir a extensão ISAPI.

11. Inicie o IBM Cognos Configuration.12. No painel Explorer, clique em Configuração Local > Ambiente.13. Na caixa URI do Gateway, altere a parte cognos.cgi da URI para

cognosisapi.dll.

Resultados

Os usuários podem acessar o gateway ISAPI inserindo http://servername/ibmcognos/isapi em seus navegadores da web.

Configurar o Gateway de Servlet para um Servidor de AplicativosÉ possível usar o gateway de servlet para entregar as páginas do portal em vez dese usar um servidor da web.

Antes de Iniciar

Assegure-se de que as tarefas a seguir estejam concluídas:v O servidor de aplicativos está instalado e em execução em cada computador em

que o gateway de servlet está instalado.v Os componentes de gateway IBM Cognos BI estão instalados no mesmo sistema

que o servidor de aplicativos.v Os Componentes da Camada de Aplicativos IBM Cognos BI e Content Manager

estão instalados e em execução no ambiente.

Capítulo 5. Instalação e Configuração dos Componentes do Produto em um Computador 95

Page 108: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

v A conta do usuário do servidor de aplicativos tem permissão de acesso totalpara instalação IBM Cognos.

Sobre Esta Tarefa

Em vez de rotear solicitações diretamente para o dispatcher, implemente o gatewayde servlet para uma instância JVM (Java Virtual Machine) diferente das instânciasJVM que executam os servlets do IBM Cognos BI Application Tier Components eContent Manager. Executar esse tipo de implementação separa o carregamentopara entregar o conteúdo estático dos aplicativos principais.

Procedimento1. Crie uma instância JVM separada, se necessário.

Caso pretenda executar o IBM Cognos BI e o IBM Cognos Servlet Gateway nomesmo servidor de aplicativos, o gateway de servlet deverá ser implementadoem uma instância de JVM separada.

2. Verifique se os componentes do IBM Cognos estão configurados corretamente.3. Defina variáveis de ambiente.4. Configure IBM Cognos Servlet Gateway para execução no servidor de

aplicativos.5. Mudança do script de inicialização do servidor de aplicativos, se necessário.6. Configure propriedades do servidor de aplicativo e implemente o IBM Cognos

Servlet Gateway.7. Ative o SSL, se necessário.

Resultados

Agora é possível acessar os componentes IBM Cognos usando o gateway de servletinserindo o URI do gateway. Por exemplo, http[s]:host_name:port/ServletGateway.

O URI do IBM Cognos Servlet Gateway faz distinção entre maiúsculas eminúsculas.

Usar o Gateway CGIÉ possível usar o gateway CGI no IBM HTTP Server, Apache Web Server ouMicrosoft Internet Information Services (IIS) Server.

Usar o gateway do CGI no Servidor Apache ou IBM HTTP ServerO gateway padrão configurado no IBM Cognos Configuration e o gateway do CGI.Para usar o gateway do CGI, você deve configurar aliases para o Servidor Apacheou o IBM HTTP Server.

Procedimento1. Acesse o diretório Webserver_installation/conf.2. Abra o arquivo httpd.conf em um editor.3. Certifique-se de que tanto o nome do servidor quanto o número da porta de

servidor da web sejam especificados para a propriedade ServerName.4. Inclua o seguinte:

ScriptAlias /ibmcognos/cgi-bin "c10_location/cgi-bin"

<Directory "c10_location/cgi-bin">AllowOverride None

96 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 109: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Options NoneOrder allow,denyAllow from all

</Directory>

Alias /ibmcognos "c10_location/webcontent"

<Directory "c10_location/webcontent">Options Indexes MultiViewsAllowOverride NoneOrder allow,denyAllow from all

</Directory>

A diretiva <Directory> é opcional.

Nota: Assegure-se de definir o alias /ibmcognos/cgi-bin antes do alias/ibmcognos.

Importante: O ibmcognos é o valor padrão usado nos valores URI do Gatewaye URI do Controlador para o gateway no IBM Cognos Configuration. Se vocênão usar o ibmcognos para os valores de ScriptAlias e Alias, certifique-se demudar os valores de URI do Gateway e URI do Controlador para o gatewaypara corresponder aos valores que você usa. Também, certifique-se de utilizar omesmo valor para a parte ibmcognos dos valores ScriptAlias e Alias conformemostrado nos exemplos.

5. Salve e feche o arquivo.6. Reinicie o servidor da Web.

Resultados

Os usuários podem acessar o portal em http://servername:port/ibmcognos.

Use gateway do CGI no Microsoft Internet Information Services(IIS) versão 7 ou 8Se você estiver usando Microsoft Internet Information Services (IIS) versão 7 ouposterior, use a seguinte tarefa para configurar o gateway do CGI.

O gateway do CGI é fornecido para ambos os servidores da web, o de 32 bits e ode 64 bits.

Sobre Esta Tarefa

Caso esteja usando o Microsoft IIS como seu servidor da web e planeje executarmais do que um produto IBM Cognos BI ou várias instâncias do mesmo produto,em um computador, você deve criar um conjunto de aplicativos separado paracada produto ou instância e, em seguida, associar os aliases para este produto ouinstância para o conjunto de aplicativos.

Para obter informações adicionais sobre criação de um conjunto de aplicativo,consulte a documentação de seu servidor.

Procedimento1. No Painel de Controle do Microsoft Windows, clique em Programas >

Programas e Recursos.Caso esteja usando o Microsoft Windows 8 ou 2012 Server, o Programas eRecursos está disponível diretamente do Painel de Controle.

2. Clique em Ativar ou desativar recursos.

Capítulo 5. Instalação e Configuração dos Componentes do Produto em um Computador 97

Page 110: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

3. Caso esteja usando o Microsoft Windows 2008 Server, use as etapas a seguir:a. Clique em Gerenciador do Servidor > Funções > Servidor da Web (IIS).b. Assegure-se de que o Common HTTP Features ou os recursos solicitados

estejam ativados.c. Se CGI estiver configurado como Não Instalado, selecione CGI e clique

em Incluir Serviço de Função.4. Caso esteja usando o Microsoft Windows 2012 Server, use as etapas a seguir:

a. No Incluir Funções e Assistente de Recursos, clique em Instalação baseadaem função ou baseada em recursos, e clique em Avançar.

b. Selecione seu servidor e clique em Avançar.c. Selecione Servidor da Web (IIS), caso ele não esteja instalado ainda,

assegure-se de que o Common HTTP Features esteja selecionado e cliqueem Avançar até que você chegue à seção Serviços da Função do assistente.

d. Expanda Desenvolvimento de Aplicativo.e. Selecione CGI caso ele não esteja ainda selecionado e clique em Avançar.f. Clique em Instalar.

5. Caso esteja usando Microsoft Windows 7 ou 8, use as etapas a seguir:a. Selecione Internet Information Services caso ele ainda não esteja

selecionado.b. Expanda Internet Information Services > World Wide Web Services.c. Assegure-se de que o Common HTTP Features ou os recursos solicitados

estejam ativados.d. Expanda Recursos de Desenvolvimento de Aplicativo.e. Se CGI não estiver selecionado, selecione CGI.f. Clique em OK.

6. No console Gerenciador do Internet Information Services (IIS), emConexões, selecione seu nome de servidor.v Caso esteja usando o Microsoft Windows 2012 Server, no Server Manager,

selecione IIS e, em seguida, clique com o botão direito do mouse no nomede seu servidor e clique em Internet Information Services (IIS) Manager.

v Caso esteja usando o Microsoft Windows 2008 Server, no Gerenciador deServidor, expanda Funções > Web Server (IIS) e, em seguida, clique emInternet Information Services (IIS) Manager.

v Caso esteja usando o Microsoft Windows 8, a partir do Painel de Controle,clique em Ferramentas Administrativas para acessar o console do InternetInformation Services (IIS) Manager.

v Caso esteja usando o Microsoft Windows 7, a partir do Painel de Controle,clique em Sistema e Segurança > Ferramentas Administrativas paraacessar o console do Internet Information Services (IIS) Manager.

7. Clique duas vezes em Restrições ISAPI e CGI.8. Em Ações, clique em Incluir.9. Insira o caminho até o arquivo cognos.cgi. O arquivo está no diretório

c10_location\cgi-bin.Você deve inserir o caminho completo, incluindo o nome do arquivo. Se ocaminho incluir espaços, certifique-se de usar as aspas ao redor do caminho.Por exemplo, digite:“C:\Program Files\ibm\cognos\c10\cgi-bin\cognos.cgi”

10. Insira uma Descrição, como CognosCGI.

98 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 111: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

11. Selecione Permitir que o caminho de extensão seja executado e clique emOK.

12. Em Conexões, expanda Sites e em seu website, inclua os diretórios virtuaisconforme mostrado na tabela:

Tabela 22. Diretórios Virtuais Necessários

Alias Local

ibmcognos c10_location/webcontent

ibmcognos/cgi-bin c10_location/cgi-bin

13. Selecione o diretório virtual cgi-bin que você criou.14. Clique duas vezes em Mapeamentos Manipuladores.15. Em Ações, clique em Incluir Mapeamento de Módulo.

a. Em Caminho de Solicitação, digite cognos.cgi.b. Em Módulo, selecione CgiModule.c. Deixe Executável (opcional) em branco.d. Em Nome, insira um nome para a entrada, tal como CognosCGI.e. Clique em OK.

Resultados

Os usuários podem acessar o gateway CGI inserindo http://servername/ibmcognosem seus navegadores da web.

Use o gateway CGI em versões mais antigas do Microsoft IISPara versões do Microsoft Internet Information Services (IIS) anteriores à versão 7,use estas etapas para configurar o gateway CGI.

Procedimento

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

Tabela 23. Diretórios Virtuais Necessários

Alias Localização Permissão

ibmcognos local_c10/webcontent Leitura

ibmcognos/cgi-bin local_c10/cgi-bin Execução

Importante: O ibmcognos é o valor padrão usado nos valores URI do Gateway eURI do Controlador para o gateway no IBM Cognos Configuration. Se você nãousar o ibmcognos para os valores de ScriptAlias e Alias, certifique-se de mudar osvalores de URI do Gateway e URI do Controlador para o gateway paracorresponder aos valores que você usa.

Configurando o WebDAV para Visualizar e Navegar pelasImagens

Para visualizar e navegar pelas imagens no Report Studio, configure o WebDistributed Authoring and Versioning (WebDAV) em seu servidor da web. Osautores de relatório podem navegar pelas imagens para incluir nos relatórios deuma maneira semelhante à navegação pelo sistema de arquivos.

Capítulo 5. Instalação e Configuração dos Componentes do Produto em um Computador 99

Page 112: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Configurando WebDAV em Servidores da Web Microsoft IISNos servidores da web Microsoft Internet Information Services (IIS), você deveprimeiro ativar o recurso WebDAV e, em seguida, configurar seu servidor da webpara acessar o local da imagem.

Procedimento1. No Painel de Controle do Microsoft Windows, clique em Programas >

Programas e Recursos.Se estiver usando o Microsoft Windows 8 ou 2012 Server, Programas eRecursos está disponível diretamente no Painel de Controle.

2. Clique em Ativar ou desativar recursos.3. Se você estiver usando o Microsoft Windows 2008 Server, use as etapas a

seguir:a. Clique em Gerenciador de Servidor > Funções > Servidor da Web (IIS).b. Na seção Serviços de Função, selecione Incluir Serviços de Função.c. Em Servidor da Web > Recursos HTTP Comuns, selecione Publicação

WebDAV.d. Clique em Avançar e, em seguida, clique em Instalar.

4. Se você estiver usando o Microsoft Windows 2012 Server, use as etapas aseguir:a. No Assistente de Incluir Funções e Recursos, clique em Instalação

baseada em função ou baseada em recurso, e clique em Avançar.b. Selecione seu servidor e clique em Avançar.c. Expanda Servidor da Web (IIS) > Servidor da Web > Recursos HTTP

Comuns, e selecione Publicação WebDAV.d. Clique em Avançar > Avançar, e depois clique em Instalar.

5. Se estiver usando o Microsoft Windows 7 ou 8, use as etapas a seguir:a. Expanda Internet Information Services > World Wide Web Services >

Recursos HTTP Comuns.b. Selecione Publicação WebDAV e clique em OK.

6. No console Gerenciador do Internet Information Services (IIS), emConexões, selecione seu nome de servidor.v Se você estiver usando o Microsoft Windows 2012 Server, no Gerenciador

de Servidor, selecione IIS, e depois dê um clique direito no nome do seuservidor e clique em Gerenciador do Internet Information Services (IIS).

v Se você estiver usando o Microsoft Windows 2008 Server, no Gerenciadorde Servidor, expanda Funções > Web Server (IIS), e depois clique emGerenciador do Internet Information Services (IIS).

v Se você estiver usando o Microsoft Windows 8, no Painel de Controle,clique em Ferramentas Administrativas para acessar o console doGerenciador do Internet Information Services (IIS).

v Se você estiver usando o Microsoft Windows 7, no Painel de Controle,clique em Sistema e Segurança > Ferramentas Administrativas paraacessar o console do Gerenciador do Internet Information Services (IIS).

7. Em Conexões, expanda seu servidor da web, Sites e selecione seu website.Por exemplo, selecione Website Padrão.

8. Dê um clique duplo em Autoria WebDAV.9. Clique em Ativar WebDAV.

10. Clique em Configurações de WebDAV.

100 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 113: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

11. Se você tiver acesso anônimo ativado, selecione True para Permitir Consultasde Propriedade Anônimas e clique em Aplicar.

12. Selecione o diretório ou diretório virtual para o qual deseja permitir acesso aoWebDAV.

13. Dê um clique duplo em Autoria WebDAV.14. Clique em Incluir Regra de Autoria e inclua as regras apropriadas para o seu

ambiente. Por exemplo, se você instalou as amostras e deseja utilizar ocaminho padrão, sob o diretório virtual ibmcognos, expanda amostras, eselecione imagens e inclua uma regra de autoria para os arquivos de imagem.

15. Clique com o botão direito no diretório ou diretório virtual no qual incluiuregras de autoria e clique em Editar Permissões.

16. Clique em Segurança e inclua as permissões apropriadas. Por exemplo, sevocê permitir acesso anônimo para seu servidor da web, inclua permissõespara o usuário de acesso anônimo. Você pode localizar esse usuárioselecionando o website, dando um clique duplo em Autenticação evisualizando as propriedades para os usuários exibidos.

Resultados

Com o WebDAV ativado, os usuários do Report Studio podem incluir imagens emseus relatórios. Quando os usuários clicam em Navegar no navegador de imagens,o local padrão para navegar é http://servername/ibmcognos/samples/images. Sevocê tiver criado outro local, os usuários podem inserir esse local.

Configurando o IIS com um tipo MIME para relatórios Ativosque usam JSON

Se você usar o Microsoft Internet Information Services (IIS) como o servidor daweb, então, para suportar os relatórios Ativos contendo visualizações de lado docliente que usam JSON, deve-se definir o tipo JSON MIME para IIS.

Procedimento1. Abra o console de gerenciamento do Microsoft IIS.2. Selecione o nome do computador local.3. Clique em Tipos de MIME.4. Clique em Novo ou Incluir.5. Na caixa Extensão, digite .json.6. Na caixa Tipo MIME, digite application/json.

Teste de instalação e configuraçãoÉ possível testar as definições de configuração executando o recurso de testeconforme você configura o IBM Cognos Business Intelligence. Após ter concluído aconfiguração e iniciado os serviços, é possível testar a instalação conectando-se aoportal do IBM Cognos BI.

Procedimento1. Abra um navegador web.2. Teste se o Content Manager está em execução digitando o valor URIs do

Content Manager a partir do IBM Cognos Configuration. Por exemplo,http://host_name:port/p2pd/servlet

O valor padrão para nome_host:porta é localhost:9300.

Capítulo 5. Instalação e Configuração dos Componentes do Produto em um Computador 101

Page 114: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

3. Teste a disponibilidade do dispatcher digitando o valor URI do dispatcherinterno no IBM Cognos Configuration. Por exemplo,http://host_name:port/p2pd/servlet/dispatch

O valor padrão para nome_host:porta é localhost:9300.Se a resposta exibir uma lista de conteúdo em Pastas públicas, o dispatcherestará disponível.

4. Teste o gateway digitando o valor URI do Gateway no IBM CognosConfiguration em seu navegador da Web.Pode levar alguns minutos para a página da web se abrir. Se você vir a páginaBoas-vindas no portal do IBM Cognos BI, sua instalação está funcionando.

Métodos de instalação e configuração de componentes do cliente doIBM Cognos Mobile

Após instalar e configurar os componentes do servidor do IBM Cognos Mobile, osusuários podem instalar o aplicativo IBM Cognos Mobile em seus dispositivosmóveis ou usar uma versão da web para acessar os relatórios do análises do IBMCognos Business Intelligence.

Para usar o aplicativo, os usuários fazem o download da versão iOS na Loja deaplicativos da Apple, ou da versão Android na Loja Google Play.

Para usar a versão da web, os usuários acessam o IBM Cognos Mobile a partir deuma URL.v Para a localização padrão do IBM Cognos BI, a URL é http://servername/

ibmcognos e, quando solicitado, selecione o portal Móvel ou o portal da área detrabalho

v Para o gateway CGI, a URL é http://servername/ibmcognos/m

v Para um gateway ISAPI, a URL é http://servername/ibmcognos/m/isapi

v Para um módulo Apache, a URL é http://servername/ibmcognos/m/mod

Dica: Após a abertura do aplicativo da web no navegador, os usuários podemincluir a página à sua tela inicial.

Executando o Cognos Mobile sem um servidor da web

A instalação padrão do Cognos BI agora instala o WebSphere Application ServerLiberty Profile como o servidor de aplicativos. Dessa maneira, é possível executar oCognos Mobile sem um servidor da web configurado, se algumas mudanças foremfeitas.

Procedimento1. Configure o URI do Gateway para o mesmo valor que o URI do dispatcher

externo. Esses valores são especificados no Cognos Configuration,Configuração Local, Ambiente. Configure o URI do dispatcher externo e oURI de Gateway usando o padrãohttp://<server-name>:<port>/p2pd/servlet/dispatch. Por exemplo, http://myhostserver:9300/p2pd/servlet/dispatch

2. Use o seguinte padrão de URL para executar os clientes nativos do CognosMobile, incluindo iOS e Android:http(s)://<server-name>:<port>/p2pd

3. Use o seguinte padrão de URL para iniciar o ativador do Cognos Mobile emum navegador em um dispositivo móvel:

102 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 115: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

http(s)://<server-name>:<port>/p2pd

4. Use o seguinte padrão de URL para executar o aplicativo da web do CognosMobile diretamente em um navegador em um dispositivo móvel oucomputador pessoal:http(s)://<server-name>:<port>/p2pd/m/index.html

Instalando e Configurando a Migração no IBM Cognos Series 7Antes que você possa usar o Migration Assistant no IBM Cognos PowerPlay paramigrar conteúdo do IBM Cognos Series 7 do PowerPlay Enterprise Server, Upfrontou IBM Cognos Connection, você deve instalar componentes de migração noscomputadores com o IBM Cognos Series 7. Os componentes de migração do IBMCognos Series 7 estão disponíveis no Microsoft Windows e no UNIX, no CD doIBM Cognos PowerPlay Server.

Use a lista de verificação a seguir para guiá-lo pelas tarefas para instalar econfigurar o IBM Cognos Migration__ v Instale os componentes de migração do IBM Cognos Series 7.__ v Configure os componentes de migração do IBM Cognos Series 7, se

necessário.__ v Inicie o serviço de migração do IBM Cognos Series 7.

Para obter informações sobre como migrar conteúdo do IBM Cognos Series 7 parao IBM Cognos BI, inclusive recomendações de configuração para o processo demigração, consulte o Guia de Migração e Administração do IBM Cognos PowerPlay.

Instalar Componentes de Migração do IBM Cognos Series 7Certifique-se de que as instalações do IBM Cognos Series 7 estejam funcionandocorretamente antes de instalar os componentes de migração do IBM Cognos Series7. Isso inclui assegurar que o serviço do IBM Cognos Series 7 PowerPlayEnterprise Server e os serviços do Upfront, incluindo os serviços IBM CognosUpfront Administration Service, IBM Cognos Upfront Data Store e IBM CognosUpfront Dispatcher, estejam em execução.

Instale os componentes de migração do IBM Cognos Series 7 nos computadoresIBM Cognos Series 7.v Para migrar conteúdo de um PowerPlay Enterprise Server, você deve instalar

componentes de migração do IBM Cognos Series 7 no computador com oPowerPlay Enterprise Server. Se o Upfront estiver localizado no mesmocomputador também é possível migrar conteúdo do Upfront. A instalação decomponentes de migração no computador PowerPlay Enterprise Server tambémsuporta a migração de conteúdo PowerPlay publicado no Cognos Connection.

v Para migrar conteúdo do Upfront é necessário instalar o IBM Cognos Series 7Migration Components no computador Upfront. Quando o Upfront e oPowerPlay Enterprise Server forem instalados em computadores separados, vocêdeve instalar os componentes de migração do IBM Cognos Series 7 em ambos ocomputador com o PowerPlay Enterprise Server e o computador com o Upfront.Além disso, é necessário configurar uma localização de rede compartilhada parasuportar o processamento da migração.

Procedimento1. Insira o CD do IBM Cognos PowerPlay Server apropriado para seu sistema

operacional. No UNIX, é necessário montar o CD utilizando as extensões dearquivo Rock Ridge

Capítulo 5. Instalação e Configuração dos Componentes do Produto em um Computador 103

Page 116: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

2. Se a página Bem-vindo não aparecer, execute um dos procedimentos a seguir:v No Windows , no diretório win32 no CD, clique duas vezes no arquivo

issetup.exe.v Em UNIX, no diretório que é apropriado para o seu sistema operacional,

digite ./issetup

3. Selecione o idioma para utilizar na instalação.O idioma selecionado determina o idioma do assistente de instalação.

4. Siga as instruções do assistente de instalação.5. Na página Seleção do componente, desmarque todos os componentes, exceto

Componentes de migração do IBM Cognos Series 7.6. Na página Vários locais de instalação, especifique a localização do IBM

Cognos Series 7 para instalar os componentes.O IBM Cognos Series 7 Migration Components deve ser instalado no mesmodiretório do IBM Cognos Series 7 versão 4 (7.4).Se estiver instalando os componentes de migração do IBM Cognos Series 7 emum computador com o Microsoft Windows, o local de instalação deve ser umaunidade física e não uma unidade mapeada. Caso contrário, não será possíveliniciar o serviço de migração.Se for solicitado um local de instalação para o IBM Cognos BI, é possívelaceitar o local padrão ou inserir um novo local. Essa localização é usada paragravar arquivos instalados. Não é necessário inserir o caminho em umainstalação do IBM Cognos BI em um computador diferente e componentes doIBM Cognos BI não são necessários no computador com o IBM Cognos Series 7.

7. Na página Informações de configuração para migração, para o Número daporta do serviço de migração, digite o número da porta que o serviço demigração do IBM Cognos Series 7 deve usar. O padrão é 21567.

8. Na página Concluir , clique em Concluir.

Resultados

Assim como outros produtos IBM Cognos , o processo de instalação cria arquivosde log que incluem informações como detalhes sobre arquivos transferidos e errosde instalação. Os arquivos de log estão localizados no diretórioinstallation_location\instlog.

Configurando o Serviço de Migração em um AmbienteDistribuído do IBM Cognos Series 7

Se tiver instalado componentes de migração do IBM Cognos Series 7 em umcomputador com o PowerPlay Enterprise Server e em um computador separadocom o Upfront, você deve definir e configurar um local de rede compartilhada. Oserviço de migração grava arquivos temporariamente neste local durante oprocesso de migração.

As limitações a seguir serão aplicadas à migração do Upfront quando o PowerPlayEnterprise Server e Upfront estiverem em computadores separados.

O PowerPlay Enterprise Server e o Upfront devem acessar PowerCubes usando omesmo caminho, como \\machine_name\cubes. Se os cubos estiverem localizadosno mesmo computador que o PowerPlay Enterprise Server, o PowerPlay EnterpriseServer acessará os cubos usando um caminho local e o Upfront acessará os cubosusando um caminho que inclua o nome do computador com o PowerPlayEnterprise. A migração do Upfront não funcionará nesta situação.

104 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 117: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Procedimento1. Crie uma pasta em uma localização de rede compartilhada que esteja acessível

dos computadores PowerPlay Enterprise Server e Upfront.Assegure que os serviços para migração do PowerPlay Enterprise Server, doUpfront e do IBM Cognos Series 7 sejam executados sob contas denominadasque tenham acesso de gravação para a pasta.

2. Conclua as etapas a seguir em cada computador que inclua os componentes demigração do IBM Cognos Series 7.v No local_instalação/mig7service, abra o arquivo

migs7service_configuration.xml em um editor XML ou de texto.v 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 pastacompartilhada”>\\bott93\shareT\s7migration</series7-shared-location>

v Salve e feche o arquivo.3. Reinicie o serviço de migração do IBM Series 7.

Resultados

A configuração para suportar a migração de computadores PowerPlay EnterpriseServer e Upfront separados foi concluída.

Início do Serviço de Migração do IBM Cognos Series 7Antes de migrar o conteúdo do IBM Cognos Series 7 PowerPlay para o IBMCognos PowerPlay, você deve iniciar o serviço de migração do IBM CognosSeries 7. No Windows, o serviço de migração do IBM Cognos Series 7 iniciaautomaticamente quando é instalado pela primeira vez.

Procedimento

Inicie o serviço de migração:v No Windows, se o serviço for interrompido, reinicie o serviço de migração

usando a entrada do IBM Cognos Migration Series 7 Service na lista Serviçosem Ferramentas Administrativas.

v No UNIX, acesse o diretório c10_location/migs7 e inicie o serviço digitando./configure.sh --start

Capítulo 5. Instalação e Configuração dos Componentes do Produto em um Computador 105

Page 118: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

106 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 119: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Capítulo 6. Instalação e Configuração dos Componentes doServidor em Diferentes Computadores

Utilize o assistente de instalação para selecionar os componentes do servidor quedeseja instalar e o local do computador onde quer que eles fiquem. Somente oscomponentes escolhidos para instalação serão copiados do disco para ocomputador.

Caso pretenda instalar dois ou mais componentes no mesmo computador,instale-os no mesmo local de instalação para evitar conflitos entre portas e outrasconfigurações padrão.

Se estiver instalando o IBM Cognos PowerPlay com o IBM Cognos BusinessIntelligence Server, instale e configure o servidor IBM Cognos Business Intelligenceprimeiro. Ambos, o IBM Cognos PowerPlay e o servidor IBM Cognos BusinessIntelligence devem ser da mesma versão.

A instalação do IBM Cognos PowerPlay inclui componentes que suportam amigração do conteúdo do PowerPlay a partir do IBM Cognos Series 7 para o IBMCognos Business Intelligence.

Os componentes do servidor incluem o seguinte:v Content Managerv Componentes da Camada de Aplicativosv Gatewayv Componentes de Migração do IBM Cognos Series 7

Para migrar conteúdo do IBM Cognos Series 7 PowerPlay para o IBM CognosPowerPlay, você deve instalar os componentes de migração do IBM CognosSeries 7 no computador no qual o IBM Cognos Series 7 PowerPlay EnterpriseServer está instalado. Para migrar o conteúdo do PowerPlay do Upfront, você deveinstalar os componentes de migração do IBM Cognos Series 7 no computador noqual o Upfront está instalado.

É possível instalar cada componente em um computador separado ou no mesmocomputador. Instale o gateway em um computador que também esteja executandoum servidor web.

Parando a Sequência de Serviços

Se for necessário interromper os serviços em um ambiente distribuído, a sequênciaserá importante. Pare o serviço do IBM Cognos para os Componentes da Camadade Aplicativos, seguido pelo Content Manager em espera, e depois ative o ContentManager.

É importante também interromper os seguintes:v Aplicativos que estão relacionados com o serviço do IBM Cognos, como

Framework Manager, IBM Cognos Transformer, IBM Cognos Connection, IBMCognos Administration e Metrics Designer

v Aplicativos Software Development Kit que estão sendo executados

© Copyright IBM Corp. 2005, 2014 107

Page 120: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Atualizando a Instalação

Se estiver atualizando a partir de uma liberação anterior do IBM CognosPowerPlay, você deve usar as etapas de atualização.

Se você estiver atualizando de uma liberação anterior dos produtos IBM Cognos,consulte Capítulo 4, “Atualizar o IBM Cognos Business Intelligence”, na página 49.

Se você estiver atualizando a partir de uma versão anterior do IBM Cognos BI,todos os componentes distribuídos devem ter a mesma versão do IBM Cognos BI.Se instalar o IBM Cognos BI em hosts adicionais ou alternativos, você deveráatualizar propriedades específicas do código do idioma no IBM CognosConfiguration.

Se você irá usar os PowerCubes que são protegidos em relação a um namespace doIBM Cognos Series 7, você deve instalar o IBM Cognos PowerPlay em umcomputador que suporte o IBM Cognos Series 7.

Se você estiver atualizando o IBM Cognos BI em um ambiente que inclui versõesanteriores de outros produtos IBM Cognos BI, como o IBM Cognos BI ControllerVersão 8.x IBM Cognos BI Planning Versão 8.x ou IBM Cognos BI Analysis paraMicrosoft Excel Versão 8.x, instale a nova versão do IBM Cognos BI em um localseparado do outro produto IBM Cognos BI e configure a nova versão do IBMCognos BI para operar independentemente desse produto. Após a atualização dooutro produto para uma versão compatível com o IBM Cognos BI, é possívelconfigurar os dois produtos para operarem juntos.

Instalações do Windows

Para instalações do sistema operacional Microsoft Windows, certifique-se de ter osprivilégios de administrador para o computador Windows no qual está instalando.Certifique-se também de que o computador possua variável de sistema TEMP queaponte 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 essediretório.

Instalações do UNIX

Para instalações do sistema operacional UNIX, é possível instalar componentes deservidor usando uma interface gráfica com o usuário ou executando umainstalação silenciosa. Para executar a instalação no modo gráfico, o consoleconectado ao seu computador UNIX deverá suportar uma interface gráfica deusuário baseada em Java.

Além disso, o IBM Cognos BI respeita a máscara de criação do modo de arquivo(umask) da conta executando o programa de instalação. Isto afeta somente osdiretó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, respeitama máscara. Utilize o umask 022 no diretório de instalação.

Banco de Dados de Conteúdo do Cognos como Armazenamentode Conteúdo

Se quiser usar o Banco de dados de conteúdo do Cognos como armazenamento deconteúdo, você deverá selecioná-lo no assistente de instalação. Se você estiverinstalando componentes em vários computadores, será necessário instalar o Banco

108 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 121: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

de dados de conteúdo do Cognos apenas uma vez.

Requisitos da Impressora

Para garantir que os relatórios sejam impressos corretamente no Windows, oAdobe Reader requer que você configure pelo menos uma impressora no sistemaoperacional no qual os Componentes da Camada de Aplicativos estão instalados.Todos os relatórios, independente do formato de impressão escolhido, são enviadoscomo arquivos PDF temporários para o Adobe Reader para impressão.

Sequência de Instalação para os Componentes do ServidorEm uma instalação distribuída, a sequência na qual os componentes sãoconfigurados é importante. Configure inicie os serviços em pelo menos um localem que o Content Manager foi instalado antes de configurar outros componentesdo servidor.

Você deve configurar o componente de gateway por último para que as chavescriptográficas sejam compartilhadas e a comunicação segura possa ocorrer entre ostrês componentes. O servidor especificado para a propriedade URI do dispatcherexterno no computador de gateway deve ser o último componente do servidor ainiciar.

Recomendamos instalar e configurar todos os componentes do servidor antes dainstalação dos componentes do sistema operacional Microsoft Windows.

O diagrama a seguir mostra a sequência do processo de instalação paracomponentes distribuídos. Após planejar e preparar o ambiente, instale e configureos componentes do Content Manager, em seguida o Application Tier Componentse só então os gateways. Depois de instalar os componentes do servidor, instale econfigure o Framework Manager.

Capítulo 6. Instalação e Configuração dos Componentes do Servidor em Diferentes Computadores 109

Page 122: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Recomendação - instale e configure a instalação básica parainstalações distribuídas

Quando você faz uma instalação distribuída, há várias opções diferentes deinstalação e configuração que podem ser usadas para customizar o IBM Cognos BIpara que ele se ajuste à sua infraestrutura corporativa.

Primeiro, execute uma instalação básica que envolva a instalação de uma ou maisinstâncias de cada um dos componentes do servidor necessários (gateway,Componentes da camada de aplicativos e Content Manager) e a instalação doFramework Manager. Execute apenas as tarefas de configuração requeridas, comoconfigurar componentes distribuídos para que se comuniquem uns com os outros,para colocar o ambiente distribuído em operação antes de personalizar asconfigurações.

Preparando para Instalar

1Navegador da webContent storeRequisitos do sistema

Instalação e configuração (Servidor)2

3

4

Propriedades do Ambiente Reportando fontes de dadosBanco de dados de notificação

Conexão do Content StorePropriedades de ambienteBanco de dados de notificação

Servidor da web Propriedades do ambienteSegurança

Instalar e configurar (Cliente)5

Propriedades do ambienteRelatando fontes de dados

Customizar a configuração Ajuste de desempenhoSecurançaPreferências

Figura 7. Fluxo de Trabalho do Processo de Instalação Distribuída

110 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 123: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Mais tarde, é possível adicionar componentes opcionais e personalizar asconfigurações para que melhor se adaptem às necessidades de inteligência donegócio.

A sequência na qual os computadores são configurados é importante. É precisoconfigurar e, em seguida, iniciar os serviços em pelo menos um computador ondeo Content Manager foi instalado antes de configurar outros componentes deservidor ou o Framework Manager. Para obter mais informações, consulte“Sequência de Instalação para os Componentes do Servidor” na página 109.

A maneira mais simples e rápida de ter o IBM Cognos BI em execução em seuambiente é garantindo que uma instalação básica funcione em seu 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 outroscomponentes para melhorar o desempenho.

Os computadores com o Content Manager devem conhecer o local doarmazenamento de conteúdo, o local de outros componentes do Content Managere o banco de dados usado para notificação.

Em uma instalação distribuída, pelo menos um dos computadores nos quais vocêinstalou o Content Manager deverá estar configurado, em execução e acessívelantes de você configurar outros componentes em seu ambiente do IBM Cognos.Isso garante que o serviço da autoridade de certificação, que está instalado com oContent Manager, está disponível para emitir certificados a outros computadores.

Sua instalação pode incluir mais de um Content Manager, cada um em umcomputador diferente. Um computador com Content Manager fica ativo e um oumais 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 do modo de arquivo(umask) da conta executando o programa de instalação. Isto afeta somente osdiretó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, respeitama máscara. Recomenda-se o umask 022 no diretório de instalação.

Regras para Configuração

Em uma instalação onde exista mais de um componente do Content Manager, ouonde o Content Manager esteja localizado separadamente, pelo menos um dosContent Manager deve estar configurado, em execução e acessível antes deconfigurar outros componentes do ambiente. Isso garante que o serviço deautoridade de certificação, que está instalado com o Content Manager, fiquedisponível para emitir certificados para outros computadores IBM Cognos.

Para obter informações sobre a sequência do processo de instalação paracomponentes distribuídos, consulte “Sequência de Instalação para os Componentesdo Servidor” na página 109.

Capítulo 6. Instalação e Configuração dos Componentes do Servidor em Diferentes Computadores 111

Page 124: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Regras para Content Manager Ativo

Se estiver instalando diversos componentes do Content Manager, o primeirocomputador com o Content Manager que iniciar torna-se, por padrão, o ContentManager ativo. É possível designar outro computador com Content Manager comoativo padrão usando IBM Cognos Administration.

Os computadores com Content Manager que ficam em espera servem paraproteção de failover. Se o computador com Content Manager ativo não estiverdisponível devido a uma falha de software ou hardware, um computador comContent 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ãoperdidos. Se outro Content Manager for ativado, os usuários poderão ser alertadospara efetuar o logon.

Para obter informações sobre a ativação do serviço do Content Manager, consulte oGuia de administração e segurança. Para obter informações sobre os componentesativos e em espera do Content Manager, consulte “Componentes ativo e em esperado Content Manager”.

Em instalações com diversos Content Managers, configure o IBM Cognos BI parausar gateways compilados em vez do gateway CGI padrão. Por exemplo, use oMódulo Apache para Servidor Apache ou para IBM HTTP Server ou use ISAPIpara IIS. Do contrário, o desempenho pode ser afetado depois do failover.

Atualizando

Se estiver atualizando a partir do ReportNet ou de uma versão anterior do IBMCognos BI, é possível usar os dados de configuração existentes. No entanto, algunsrecursos no IBM Cognos BI são novos e podem exigir configuração.

PowerCubes

Se você pretende instalar o IBM Cognos Transformer e estiver usando PowerCubesprotegidos contra um namespace IBM Cognos Series 7, você deverá instalar oContent Manager em um computador que suporte o IBM Cognos Series 7.

Componentes ativo e em espera do Content ManagerÉ possível instalar qualquer número de Content Managers, embora apenas umfique ativo num dado momento. As outras instalações agem como uma reserva doContent Manager.

Os componentes do Content Manager em espera são para proteção de failover. Seo Content Manager ativo não estiver disponível devido a uma falha de software ouhardware, um Content Manager em espera é ativado e as solicitações sãodirecionadas a ele.

Se o Content Manager ativo falhar, os dados de sessão que não foram salvos serãoperdidos. Se outro Content Manager for ativado, os usuários poderão ser alertadospara efetuar o logon.

Por padrão, o primeiro Content Manager instalado com o IBM Cognos BI é o ativo.Um administrador do servidor IBM Cognos BI pode alterar o Content Managerpadrão e o Content Manager ativo a qualquer momento. Quando o IBM Cognos BI

112 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 125: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

é iniciado, o Content Manager bloqueia o armazenamento de conteúdo impedindoseu acesso a partir de todas as instalações do Content Manager. Essas outrasinstalações do Content Manager entram em espera.

Esse mecanismo de failover funciona porque os dispatchers e o Content Managercomunicam-se rotineiramente um com o outro. Se um dispatcher não pode maisalcançar o Content Manager, o dispatcher sinaliza um Content Manager em espera,que se torna o Content Manager ativo. As outras instalações do Content Managerpermanecem em espera para continuar o suporte de failover. Os Content Managersem espera recuperam as configurações criptográficas, como a chave simétricacomum (utilizada para criptografar e descriptografar dados) do Content Managerativo.

Instalar os Componentes do Content ManagerPara instalar o Content Manager, utilize o disco para seu sistema operacional. Noassistente de instalação, desmarque todos os componentes, exceto ContentManager.

Se estiver instalando o IBM Cognos PowerPlay para funcionar com o IBM CognosBusiness Intelligence, instale o componente PowerPlay Content Manager nosmesmos computadores que incluem os componentes do IBM Cognos BusinessIntelligence Content Manager.

Se estiver instalando vários Content Managers, certifique-se de que os relógios dosistema nos computadores com Content Manager estejam sincronizados pararecuperação failover entre os Content Managers.

Banco de Dados de Conteúdo do Cognos

Se quiser usar o Banco de dados de conteúdo do Cognos como seuarmazenamento de conteúdo, você deverá selecioná-lo no assistente de instalação.Se você estiver instalando componentes em vários computadores, será necessárioinstalar o Banco de dados de conteúdo do Cognos apenas uma vez.

Instalando o Content Manager nos Sistemas Operacionais UNIXou LinuxUse o seguinte procedimento para instalar o Content Manager em um sistemaoperacional UNIX ou Linux.

Antes de Iniciar

Vá para o página Relatórios de Compatibilidade de Produto IBM Software(www.ibm.com/support/docview.wss?uid=swg27042164). Verifique se você tem ascorreções requeridas instaladas em seu computador antes de instalar o produto.

Procedimento1. Se estiver instalando em um diretório com outros componentes do IBM

Cognos BI, pare o serviço do IBM Cognos.2. Configure a variável de ambiente JAVA_HOME para apontar para o local da

instalação do seu Java Runtime Environment (JRE).Um exemplo do local da instalação de um Java Runtime Environment é/directory/java/java_version/jre.O IBM Cognos BI requer uma JVM, como o Java fornecido pela IBM paraexecução em um sistema operacional Linux.

Capítulo 6. Instalação e Configuração dos Componentes do Servidor em Diferentes Computadores 113

Page 126: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Se você estiver instalando em um local com outros componentes do IBMCognos BI, use a variável de ambiente JAVA_HOME existente.

3. No HP-UX, defina a variável de ambiente _M_ARENA_OPTS da seguinteforma:_M_ARENA_OPTS 1:4

Isso aumenta a alocação de memória para HP-UX para corresponder melhor àde outras plataformas UNIX.

4. No AIX, se você estiver usando um gateway de servlet, configure a variávelde ambiente AIXTHREAD_SCOPE da seguinte forma:AIXTHREAD_SCOPE=S

Isso define o escopo de contenção de 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 osarquivos de instalação foram baixados e extraídos.

6. Se estiver instalando de um disco, monte o disco usando extensões de arquivoRock Ridge.Para montar o disco em HP-UX, faça o seguinte:v Inclua o diretório pfs_mount no seu caminho.

Por exemplo,PATH=/usr/sbin/:$PATH

exporte PATH

v Para iniciar os daemons NFS necessários e executar os daemons no planode fundo, digite bg pfs_mountd e digite bg pfsd

v Para montar a unidade, digitepfs_mount -t rrip <device><mount_dir> -o xlat=unix

Por exemplo,pfs_mount /dev/dsk/c0t2d0 /cdrom -o xlat=unix

Agora é possível instalar ou copiar arquivos como um usuário não raizusando um disco IBM Cognos a partir dessa unidade.

v Ao concluir a instalação, digite pfs_umount /cdrom e finalize os daemonspfsd e pfs_mountd para desmontar o disco.

7. Para iniciar o assistente de instalação, vá para o diretório do sistemaoperacional e digite./issetup

Nota: Ao usar o comando issetup com XWindows, os caracteres japoneses nasmensagens e arquivos de log poderão ficar corrompidos. Ao instalar emjaponês no UNIX ou Linux, primeiro configure as variáveis de ambienteLANG=C e LC_ALL=C (em que C é o código de idioma, por exemplo,ja_JP.PCK no Solaris) e inicie o assistente de instalação.Se não estiver usando o XWindows, execute uma instalação não assistidaCapítulo 12, “Usando instalação e configuração não assistidas”, na página 307.Se não estiver usando o XWindows, execute uma instalação não assistida. Paraobter mais informações, consulte o Guia de instalação e configuração.Se estiver instalando nos sistemas operacionais Linux e receber mensagens deerro sobre bibliotecas openmotif ausentes, será possível usar uma instalaçãonão assistida com o comando issetupnx.

8. Siga as instruções do assistente de instalação e copie os arquivos necessáriospara seu computador.

114 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 127: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

v Ao selecionar o diretório, considere o seguinte:Instale o Content Manager em um diretório que contenha apenas caracteresASCII no nome do caminho. Alguns servidores da Web UNIX e Linux nãosuportam caracteres não ASCII em nomes de diretório.Se estiver instalando o IBM Cognos BI em um computador que tenha umaversão anterior do IBM Cognos BI e desejar manter a versão anterior, vocêdeve instalar o IBM Cognos BI em um diretório diferente.

v Ao selecionar os componentes, desmarque todos, exceto Content Manager.Se deseja usar o banco de dados pré-configurado, selecione também Bancode dados de conteúdo Cognos.

9. Na página Concluir do assistente de instalação, faça o seguinte:v Se desejar ver os arquivos de log, clique em Visualização para o arquivo de

log adequado.v Se quiser ver as últimas informações sobre o produto, selecione a caixa de

seleção das Notas sobre o Release do IBM Cognos.v Não configure o IBM Cognos BI imediatamente, pois você deve executar

outras tarefas primeiro para garantir que seu ambiente esteja configuradocorretamente. Certifique-se de que a caixa de seleção IBM CognosConfiguration esteja limpa.É possível configurar posteriormente o IBM Cognos BI usando o IBMCognos Configuration, digitando cogconfig.sh no diretórioc10_location/bin64.

v Clique em Concluir.10. Anexe o diretório c10_location/bin na variável de ambiente do caminho da

biblioteca adequada.v Para Solaris e Linux, LD_LIBRARY_PATHv Para AIX, LIBPATHv Para HP-UX, SHLIB_PATH

Instalando o Content Manager nos Sistemas OperacionaisWindowsUse o seguinte procedimento para instalar o Content Manager em um sistemaoperacional Microsoft Windows.

Para computadores com o Windows Vista, Windows 7 ou Windows 2008, o localde instalação padrão usa o diretório Program Files (x86). Se você instalar nesselocal, assegure que você execute o IBM Cognos Configuration como umAdministrador. Como alternativa, é possível instalar o produto fora do diretórioProgram Files (x86). Por exemplo, é possível alterar o diretório de instalação paraalgo como C:\IBM\cognos\c10.

Antes de Iniciar

Vá para o página Relatórios de Compatibilidade de Produto IBM Software(www.ibm.com/support/docview.wss?uid=swg27042164). Verifique se você tem ascorreções requeridas instaladas em seu computador antes de instalar o produto.

Procedimento1. Se estiver instalando em um diretório com outros componentes do IBM Cognos

BI, pare o serviço do IBM Cognos.2. Execute um dos seguintes procedimentos:

v Insira o disco do produto IBM Cognos.

Capítulo 6. Instalação e Configuração dos Componentes do Servidor em Diferentes Computadores 115

Page 128: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Se o assistente de instalação não for aberto automaticamente, acesse odiretório do sistema operacional e clique duas vezes em issetup.exe.

v Acesse o local em que os arquivos de instalação foram transferidos pordownload e extraídos e clique duas vezes em issetup.exe.

3. Selecione o idioma para utilizar na instalação.Essa seleção determina o idioma da interface com o usuário. Todos os idiomassuportados são instalados. É possível alterar a interface com o usuário paraqualquer um dos idiomas instalados depois de concluída a instalação.

4. Siga as instruções do assistente de instalação e copie os arquivos necessáriospara seu computador.v Ao selecionar o diretório, considere o seguinte:

Instale o Content Manager em um diretório que contenha apenas caracteresASCII no nome do caminho. Alguns servidores da Web do sistemaoperacional Microsoft Windows não suportam caracteres não ASCII emnomes de diretórios.Se estiver instalando o IBM Cognos BI em um computador que tenha umaversão anterior do IBM Cognos BI e desejar manter a versão anterior, vocêdeve instalar o IBM Cognos BI em um diretório diferente.

v Ao selecionar os componentes, desmarque todos, exceto Content Manager.Se deseja usar o banco de dados pré-configurado, selecione também Bancode dados de conteúdo Cognos.

5. Na página Concluir do assistente de instalação, faça o seguinte:v Se desejar ver os arquivos de log, clique em Visualização para o arquivo de

log adequado.v Se quiser ver as últimas informações sobre o produto, selecione a caixa de

seleção das Notas sobre o Release do IBM Cognos.v Se você iniciar o IBM Cognos Configuration a partir do assistente de

instalação, certifique-se de seguir as tarefas adicionais nessa seção paraassegurar que o seu ambiente esteja apropriadamente configurado antes deiniciar os serviços.É possível iniciar o IBM Cognos Configuration usando o atalho IBM CognosConfiguration do menu Iniciar.

v Clique em Concluir.

Instalando fix packs do IBM CognosO IBM fornece pacotes de manutenção temporários que contêm atualizações paraum ou mais componentes para o seu produto IBM Cognos. Fix packs sãoatualizações de produto que contêm correções de códigos acumulativas realizadasdesde a última liberação do produto. Se um fix pack estiver disponível ao instalarou atualizar seu produto, é necessário instalá-lo após instalar os componentes doIBM Cognos. Os fix packs do IBM Cognos são instalados no mesmo local que oproduto existente.

Os fix packs são acumulativos. Quando se instala um fix pack, ele incluiatualizações de todos os fix packs anteriores. Os fix packs estão disponíveis paradownload a partir do Suporte IBM (www.ibm.com/support/entry/portal/overview).

Nota:

v Os fix packs não são instalações independentes. É necessário instalá-los noscomputadores que possuem componentes do IBM Cognos instalados. Instale os

116 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 129: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

fix packs que são apropriados para sua versão do produto. Para verificar suaversão, abra o arquivo da lista de componentes no c10_location\cmplst.txt everifique a linha que inicia com C8PPCLIENT_version= para o PowerPlay Client eC8PPES_version= para a versão do servidor PowerPlay.

v Se você usou a opção Configuração Rápida para a instalação do Cognos BIoriginal (versão 10.2.2), isso significa que o DB2 Advanced Workgroup ServerEdition foi instalado e configurado como o banco de dados de armazenamentode conteúdo. A opção Configuração Rápida não estará disponível para instalar ofix pack. Use a opção de instalação do IBM Cognos Business Inteliigence Server.Além disso, os fix packs ou correções para o DB2 Advanced Workgroup ServerEdition precisarão ser instalados usando os métodos de instalação de fix pack doDB2.

Procedimento1. Acesse o local onde os arquivos de instalação foram transferidos por download

ou insira o disco se você tiver um.2. Inicie o assistente de instalação:

v Em computadores executando sistemas operacionais Linux ou UNIX, acesseo diretório do sistema operacional e execute ./issetup.

v Em computadores executando sistemas operacionais Microsoft Windows,acesse o diretório do sistema operacional e clique duas vezes emissetup.exe.

3. Siga as instruções do assistente de instalação para que os arquivos de fix packsejam instalados no mesmo local que os componentes do IBM Cognos.

4. Se necessário, atualize os novos arquivos de instalação com todas as mudançasdas cópias de backup de seus arquivos customizados.Para evitar erros, antes de copiar os arquivos customizados, compare ambas asversões dos arquivos. Esta validação determina se é possível substituir oarquivo.

5. Se você tiver um ambiente distribuído, repita estas etapas para todos osservidores IBM Cognos restantes.

Configure a conectividade do banco de dados para o bancode dados de armazenamento de conteúdo.

Se estiver usando um banco de dados diferente do Cognos Content Database, oIBM DB2 Advanced Workgroup Server Edition (da opção Configuração Rápida) ouMicrosoft SQL Server como o armazenamento de conteúdo, pode ser necessárioinstalar o software do cliente de banco de dados ou drivers Java DatabaseConnectivity (JDBC), ou ambos, em cada computador no qual o Content Managerfor instalado. Fazer isso permite que o Content Manager acesse o banco de dadosde armazenamento de conteúdo.Conceitos relacionados:“Usar o protocolo secure sockets layer (SSL) para conexões com o banco de dadosno IBM Cognos Configuration” na página 245É possível configurar o IBM Cognos Business Intelligence para usar o protocolosecure sockets layer (SSL) para comunicação com bancos de dados usados peloIBM Cognos BI, incluindo armazenamento de conteúdo, notificação e criação delog de bancos de dados.

Capítulo 6. Instalação e Configuração dos Componentes do Servidor em Diferentes Computadores 117

Page 130: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Configurar a Conectividade do Banco de Dados para umArmazenamento de Conteúdo IBM DB2Este procedimento descreve como configurar a conectividade do banco de dadospara um armazenamento de conteúdo do DB2 . Você deve executar esteprocedimento em cada computador em que instalar Content Manager.

Você deve usar um driver tipo 4 Java Database Connectivity (JDBC) para conectaro armazenamento de conteúdo se estiver usando o IBM DB2.

O driver tipo 4 é considerado um produto independente. Ele não requer que ocliente DB2 esteja instalado.

Nota: Este tópico não se aplica se você tiver usado a opção Instalação Rápida parainstalar o IBM DB2 Advanced Workgroup Server Edition como o banco de dadosde armazenamento de conteúdo.

Procedimento

Copie os arquivos a seguir a partir do diretório DB2_installation\sqllib\javapara o diretório c10_location\webapps\p2pd\WEB-INF\lib:v O arquivo do driver universal, db2jcc.jarv O arquivo de licença:

Para DB2 nos sistemas operacionais Linux, UNIX ou Windows, usedb2jcc_license_cu.jar.Para DB2 no z/OS, use db2jcc_license_cisuz.jar.Se estiver se conectando ao DB2 no z/OS, use a versão do 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 path\db2jcc.jar com.ibm.db2.jcc.DB2Jcc -version

Gerando um Arquivo de Script para Criar um Banco de Dados para umArmazenamento de Conteúdo do DB2:

É possível gerar um arquivo de script para automaticamente criar oarmazenamento de conteúdo no IBM DB2 em todas as plataformas. O arquivo descript é um arquivo DDL.

Procedimento

1. Inicie o IBM Cognos Configuration.2. Na janela Explorer, em Acesso a Dados > Content Manager, clique em

Content Store.A configuração padrão é para um banco de dados IBM DB2. Certifique-se deque o Tipo seja Banco de Dados DB2.

3. No campo Servidor de Banco de Dados e Número da Porta, insira o nome doseu computador e número de porta no qual o DB2 está sendo executado. Porexemplo, localhost:50000. Em que, 50000 é o número da porta padrão que éusada pelo IBM DB2. Se você estiver usando um número de porta diferente,certifique-se de usar tal valor.

4. Clique no campo Valor próximo à propriedade Senha e ID de Usuário e, emseguida, clique no ícone de edição. Digite os valores apropriados e clique emOK.

118 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 131: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

5. Na janela Propriedades, para a propriedade Nome do Banco de Dados, digiteo nome para o banco de dados de armazenamento de conteúdo.

Importante: Não use um nome com mais de oito caracteres e use apenas letras,números, sublinhados e hifens no nome.

6. Clique com o botão direito do mouse em Content Store, e clique em GerarDDL.

7. Clique em Detalhes para registrar o local do arquivo DDL gerado.O arquivo DDL denominado createDB.sql é criado. O script é criado nodiretório c10_location\configuration\schemas\content\db2.

O que Fazer Depois

Use este script para criar um banco de dados noIBM DB2. Para obter informaçõesadicionais sobre o uso de um arquivo DDL, consulte sua documentação do IBMDB2.

Se usar a interface da linha de comando do IBM DB2, é possível executar o scriptinserindo o comando a seguir:db2 -tvf createDB.sql

Criando Espaços de Tabela para um Armazenamento de Conteúdo no DB2 paraz/OS:

Um administrador de banco de dados deve executar scripts para criar um conjuntode espaços de tabelas necessário para o banco de dados de armazenamento deconteúdo. Modifique os scripts para substituir os parâmetros do marcador pelosapropriados para o seu ambiente.

Por padrão, o armazenamento de conteúdo é usado para notificações, tarefasmanuais e anotações. É possível criar bancos de dados separados para cada umdeles.

Sobre Esta Tarefa

Certifique-se de que sejam usadas as convenções de nomenclatura para o DB2 noz/OS. Por exemplo, todos os nomes de parâmetros devem começar com uma letrae o comprimento não pode exceder oito caracteres. Há duas exceções para o limitede comprimento de caracteres:v CMSCRIPT_CS_ID não possui mais de 2 caracteres.v CMSCRIPT_TABLESPACE não possui mais de 6 caracteres.

O motivo para a exceção é que quando dois parâmetros são concatenados, ocomprimento do caractere não pode ter mais de 8 caracteres.

Para obter informações adicionais, consulte o IBM DB2 for z/OS KnowledgeCenter (http://www.ibm.com/support/knowledgecenter/SSEPEK/db2z_prodhome.html).

Procedimento

1. Conecte-se ao banco de dados como um usuário que possui privilégios paracriar e eliminar espaços de tabelas para permitir a execução de instruções SQL.

2. Vá até o diretório que contém os scripts:c10_location/configuration/schemas/content/db2zOS

Capítulo 6. Instalação e Configuração dos Componentes do Servidor em Diferentes Computadores 119

Page 132: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

3. Faça uma cópia de backup do arquivo de script tablespace_db2zOS.sql e salveo arquivo em outro local.

4. Abra o arquivo de script tablespace_db2zOS.sql original.a. Inclua uma instrução de conexão no início do script.

Por exemplo,connect to databasename;

b. Use a tabela a seguir para ajudá-lo a substituir os parâmetros genéricospelos parâmetros apropriados para seu ambiente.Nem todos os parâmetros listados estão no script, mas alguns podem serincluídos no futuro.

Tabela 24. Nomes de Parâmetro e Descrição para o Script de Espaço de Tabela deArmazenamento de Conteúdo

Nome do parâmetro Descrição

CMSCRIPT_STOGROUP Especifica o nome do grupo dearmazenamento.

CMSCRIPT_DATABASE Especifica o nome do armazenamento deconteúdo Sybase.

CMSCRIPT_CS_ID Especifica a identificação do subsistema parao banco de dados de armazenamento deconteúdo.

O ID não deve ser mais longo que 2caracteres.

CMSCRIPT_TABLESPACE Especifica o nome do espaço de tabela quecontém todas as tabelas base noarmazenamento de conteúdo.

Tabelas auxiliares não são incluídas.

O nome não deve ser mais longo que 6caracteres.

CMSCRIPT_LARGE_BP Especifica o nome do pool de buffer grandealocado especialmente para objetos grandes.

Esse buffer pool é aquele com 32 KB que foicriado quando o administrador do banco dedados criou o banco de dados dearmazenamento de conteúdo no sistemaz/OS.

CMSCRIPT_REGULAR_BP Especifica o nome do pool de buffer detamanho normal alocado especialmente paraobjetos grandes e de tamanho normal.

Esse buffer pool é aquele com 16 KB que foicriado quando o administrador do banco dedados criou o banco de dados dearmazenamento de conteúdo no sistemaz/OS.

CMSCRIPT_USERNAME Especifica a conta de usuário que acessa obanco de dados do armazenamento deconteúdo.

5. Salve e execute o script.

120 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 133: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Por exemplo, se você configurar o seu arquivo clp.properties e o seu aliasDB2 no seu perfil ou no arquivo de script tcshrc, digite o seguinte comandopara executar o script:db2 -tvf tablespace_db2zOS.sql

6. Conceda os direitos do usuário do IBM Cognos para os espaços de tabela queforam criados quando você executou o script de arquivotablespace_db2zOS.sql:a. Faça uma cópia do arquivo de script rightsGrant_db2zOS.sql e armazene-a

em outro local.b. Na ferramenta de acesso remoto, abra o arquivo de script

rightsGrant_db2zOS.sql original e substitua os parâmetros de marcadorcom valores que são apropriados para o seu ambiente.Certifique-se de usar os mesmos valores usados quando você alocourecursos para os buffer pools e para a conta do usuário.

c. Inclua uma instrução de conexão no início do script.Por exemplo,connect to databasename user username using password;

d. Salve e, em seguida, execute o script.Por exemplo,db2 -tvf rightsGrant_db2zOS.sql

7. Para criar os espaços de tabela de notificação, acesse o diretórioc10_location/configuration/schemas/delivery/zosdb2.a. Faça uma cópia de backup do arquivo de script NC_TABLESPACES.sql e salve

o arquivo em outro local.b. Abra o arquivo de script NC_TABLESPACES.sql original e use a tabela a seguir

para ajudá-lo a substituir os parâmetros de marcador pelos parâmetrosapropriados para seu ambiente.

Tabela 25. Nomes e Descrições de Parâmetros de Espaços de Tabela para o Banco deDados de Notificação DB2 no z/OS

Nome do parâmetro Descrição

NCCOG Especifica o nome do banco de dados denotificação.

DSN8G810 Especifica o nome do grupo dearmazenamento.

BP32K Especifica o nome do pool de buffer.

Nem todos os parâmetros listados estão no script, mas alguns podem serincluídos no futuro.

c. Salve e execute o script.Por exemplo,db2 -tvf NC_TABLESPACES.sql

d. Abra o arquivo de script NC_CREATE_DB2.sql e substitua o parâmetro demarcador NCCOG pelo nome do banco de dados de notificação.

e. Salve o script.Os serviços de tarefa e monitor de programação executarão o scriptautomaticamente. No entanto, você mesmo pode executá-lo.

8. Para criar os espaços de tabela de tarefas manuais, acesse o diretórioc10_location/configuration/schemas/hts/zosdb2.

Capítulo 6. Instalação e Configuração dos Componentes do Servidor em Diferentes Computadores 121

Page 134: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

a. Faça uma cópia de backup do arquivo de script HTS_tablespaces.sql esalve o arquivo em outro local.

b. Abra o arquivo de script HTS_TABLESPACES.sql original e use a tabela aseguir para ajudá-lo a substituir os parâmetros genéricos pelos parâmetrosapropriados para seu ambiente.

Tabela 26. Nomes de Parâmetro de Espaço de Tabela e Descrições para Tarefas Manuaisno DB2 para z/OS

Nome do parâmetro Descrição

NCCOG Especifica o nome do banco de dados.

DSN8G810 Especifica o nome do grupo dearmazenamento.

BP32K Especifica o nome do buffer pool de 32 k.

Consulte o script para uma lista completa dos parâmetros necessários.c. Salve e execute o script.d. Abra o arquivo de script HTS2_CREATE_Db2zos.sql e use a tabela a seguir

para ajudá-lo a substituir os parâmetros genéricos pelos parâmetrosapropriados para seu ambiente.

Tabela 27. Nomes de Parâmetro de Espaço de Tabela e Descrições para Tarefas Manuaisno DB2 para z/OS

Nome do parâmetro Descrição

NCCOG O nome do banco de dados.

Consulte o script para uma lista completa dos parâmetros necessários.e. Salve e execute o script.

9. Para criar os espaços de tabela de anotações, acesse o diretórioc10_location/configuration/schemas/ans/zosdb2.a. Faça uma cópia de backup do arquivo de script ANN_TABLESPACES.sql e

salve o arquivo em outro local.b. Abra o arquivo de script ANN_TABLESPACES.sql original e use a tabela a

seguir para ajudá-lo a substituir os parâmetros genéricos pelos parâmetrosapropriados para seu ambiente.

Tabela 28. Nomes de Parâmetro de Espaço de Tabela e Descrições para Anotações noDB2 para z/OS

Nome do parâmetro Descrição

NCCOG O nome do banco de dados.

DSN8G810 O nome do grupo de armazenamento.

BP32K O nome do buffer pool de 32 k.

Consulte o script para uma lista completa dos parâmetros necessários.c. Salve e execute o script.d. Abra o arquivo de script ANS2_CREATE_Db2zos.sql e use a tabela a seguir

para ajudá-lo a substituir os parâmetros genéricos pelos parâmetrosapropriados para seu ambiente.

122 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 135: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Tabela 29. Nomes de Parâmetro de Espaço de Tabela e Descrições para Anotações noDB2 para z/OS

Nome do parâmetro Descrição

NCCOG O nome do banco de dados.

Consulte o script para uma lista completa dos parâmetros necessários.e. Salve e execute o script.

Configurar a Conectividade do Banco de Dados para umArmazenamento de Conteúdo OracleEste procedimento descreve como configurar a conectividade do banco de dadospara um armazenamento de conteúdo do Oracle. Você deve executar esteprocedimento em cada computador em que instalar Content Manager.

Procedimento1. No computador onde está instalado o cliente Oracle, acesse o diretório

ORACLE_HOME/jdbc/lib.2. Copie o arquivo de biblioteca completo da sua versão do cliente Oracle para o

diretório c10_location\webapps\p2pd\WEB-INF\lib no computador onde oContent Manager está instalado e onde a notificação é enviada para um bancode dados Oracle.Se estiver usando o Oracle 10g, você deve ter ojdbc14.jar.Se estiver usando o Oracle 11g, você deve ter ojdbc5.jar.Os arquivos estão disponíveis de uma instalação do cliente ou servidor Oracle etambém podem ser transferidos por download do Web site de tecnologiaOracle.

Configurar Conectividade do Banco de Dados para umArmazenamento de Conteúdo InformixEste procedimento descreve como configurar a conectividade do banco de dadospara um armazenamento de conteúdo do Informix. Você deve executar esteprocedimento em cada computador em que instalar Content Manager.

Procedimento1. No computador onde o Informix está instalado, acesso o diretório

Informix_location/sqllib/java.2. Copie os seguintes arquivos para o diretório c10_location/webapps/p2pd/WEB-

INF/lib em cada computador em que o Content Manager estiver instalado.v o arquivo do driver universal, db2jcc.jarv o arquivo de licença, db2jcc_license_cisuz.jar

Configurar a Conectividade do Banco de Dados para umArmazenamento de Conteúdo SybaseEste procedimento descreve como configurar a conectividade do banco de dadospara um armazenamento de conteúdo do Sybase. Você deve executar esteprocedimento em cada computador em que instalar Content Manager.

Procedimento1. No computador onde o Sybase está instalado, acesse o diretório

Sybase_location/jConnect-6/classes.

Capítulo 6. Instalação e Configuração dos Componentes do Servidor em Diferentes Computadores 123

Page 136: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

2. Copie o arquivo jconn3.jar para o diretório c10_location/webapps/p2pd/WEB-INF/lib em cada computador onde o Content Manager estiver instalado e ondea notificação é enviada para um banco de dados do Sybase.

Início do IBM Cognos ConfigurationUse IBM Cognos Configuration para configurar os componentes do IBM CognosBusiness Intelligence e iniciar e parar serviços do IBM Cognos.

Se você estiver usando um servidor de aplicativos diferente do fornecido, deve-seiniciar e parar os serviços do IBM Cognos por meio do servidor de aplicativos.

Antes de Iniciar

Antes de iniciar o IBM Cognos Configuration, certifique-se de que o ambienteoperacional esteja devidamente configurado. Por exemplo, certifique-se de quetodas as variáveis de ambiente foram definidas.

Em um sistema operacional Microsoft Windows, é possível iniciar o IBM CognosConfiguration na última página do assistente de instalação somente se não fornecessário fazer nenhuma configuração adicional. Por exemplo, se você usar umservidor de banco de dados que não seja Microsoft SQL ou Banco de dados deconteúdo do Cognos para o armazenamento de conteúdo, copie os drivers JavaDatabase Connectivity (JDBC) no local apropriado antes de iniciar a ferramenta deconfiguração.

Em sistemas operacionais UNIX ou Linux, não inicie oIBM Cognos Configurationna última página do assistente de instalação. Configuração adicional é necessáriaantes de ser possível configurar o IBM Cognos BI. Por exemplo, você deveatualizar seu ambiente Java.

Assegure-se de que a conta do usuário ou do serviço usada para executar o IBMCognos tenha sido configurada.

Procedimento1. No Microsoft Windows, clique em Iniciar > IBM Cognos Configuration.

Se estiver usando um computador Windows Vista, Windows 7 ou Windows2008 e tiver instalado o produto no diretório Arquivos de Programas (x86),inicie o IBM Cognos Configuration como um Administrador.

2. Nos sistemas operacionais UNIX ou Linux, acesse o diretórioc10_location/bin64 e, em seguida, digite o seguinte comando:./cogconfig.sh

Se o IBM Cognos Configuration não abrir, certifique-se de que você configuroua variável de ambiente DISPLAY.Se você vir uma mensagem JAVA.Lang.unsatisfied link, verifique se estáusando uma versão suportada do Java.Se você vir uma mensagem Java.lang.unsupportedClassVersionError,certifique de que está usando uma versão de 64 bits do Java.

Definição de propriedades de conexão com o banco de dadospara o armazenamento de conteúdo

Deve-se especificar as informações do servidor de banco de dados para garantirque o Content Manager possa ser conectado ao banco de dados que você utilizapara o armazenamento de conteúdo. O Content Manager usa o logon do banco de

124 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 137: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

dados para acessar o armazenamento de conteúdo. Após definir as propriedadesde conexão com o banco de dados, é possível testar a conexão entre o ContentManager e o armazenamento de conteúdo.

Se o Banco de Dados de Conteúdo do Cognos foi instalado, as propriedades deconexão do banco de dados usarão o Banco de Dados de Conteúdo do Cognos, porpadrão. Não é necessário alterar as propriedades de conexão padrão. Entretanto, oBanco de Dados de Conteúdo do Cognos é apenas para sistemas de teste ou provade conceito. Ao mudar para um ambiente de produção, deve usar um banco dedados de nível empresarial para armazenamento do conteúdo.

Se estiver atualizando a partir do ReportNet ou de uma versão anterior do IBMCognos BI, configure o IBM Cognos BI para apontar para uma cópia do banco dedados de armazenamento de conteúdo existente. Após salvar a configuração einiciar o serviço do IBM Cognos, os dados no armazenamento de conteúdo serãoautomaticamente atualizados e não poderão ser usados pela versão anterior. O usode uma cópia do banco de dados original com a nova versão permite manter oReportNet ou a versão anterior em execução com os dados originais.

Configurando as Propriedades de Conexão do Banco de Dadospara um Armazenamento de Conteúdo DB2Deve-se especificar as informações do servidor de banco de dados para garantirque o Content Manager possa ser conectado ao banco de dados que você utilizapara o armazenamento de conteúdo.

Procedimento1. No local em que 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:v Clique na caixa de seleção Valor próxima à propriedade ID do usuário e

senha e clique no botão de edição quando ele aparecer.Se você estiver se conectando a um banco de dados no DB2 no z/OS,assegure-se de especificar o mesmo ID do usuário que o valor especificadopara CMSCRIPT_USERNAME quando criou os espaços de tabela.

v Digite os valores apropriados e clique em OK.5. No campo Servidor de Banco de Dados e Número da Porta, insira o nome do

seu computador e número de porta no qual o DB2 está sendo executado. Porexemplo, localhost:50000. 50000 é o número de porta padrão usado pelo DB2.Se você estiver usando um número de porta diferente, certifique-se de usar talvalor.

6. Se você estiver se conectando a um banco de dados no DB2 no z/OS:a. Na janela Explorer, clique em Configuração Local.b. Na janela Propriedades, próxima a Propriedades avançadas, clique dentro

da caixa Valor e clique no ícone de edição.c. Clique em Incluir para incluir os parâmetros que usou para criar os espaços

de tabela. Inclua todos os parâmetros, exceto CMSCRIPT_USERNAME.7. No menu Arquivo, clique em Salvar.

Capítulo 6. Instalação e Configuração dos Componentes do Servidor em Diferentes Computadores 125

Page 138: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Configurando as Propriedades de Conexão do Banco de Dadospara um Armazenamento de Conteúdo Microsoft SQL Server,Oracle, Informix ou SybaseDeve-se especificar as informações do servidor de banco de dados para garantirque o Content Manager possa ser conectado ao banco de dados que você utilizapara o armazenamento de conteúdo.

Procedimento1. 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.Esta etapa exclui a conexão para o recurso padrão. O Content Manager podeacessar apenas um armazenamento de conteúdo.

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

4. Na caixa Nome, digite um nome para o recurso.5. Na caixa de seleção Tipo, selecione o tipo de banco de dados e clique em OK.

Dica: Se desejar usar um par de valores da palavra-chave do Oracle Net8 paragerenciar a conexão do banco de dados, selecione Banco de Dados Oracle(Avançado).

6. Na janela Propriedades, forneça valores para o seu tipo de banco de dados:v Se você usa um banco de dados Microsoft SQL Server, digite os valores

apropriados para as propriedades Servidor de banco de dados com númeroda porta ou nome da instância e Nome do banco de dados.Para um banco de dados Microsoft SQL Server, é possível escolher usar umnúmero da porta, como 1433, uma instância denominada como valor para apropriedade Servidor de banco de dados com número da porta ou nome dainstância.Para a propriedade Servidor de banco de dados com número da porta ounome da instância, inclua o nome da instância, se houver diversas instânciasdo Microsoft SQL Server.Para conectar-se a uma instância denominada, você deve especificar o nomeda instância como uma propriedade URL Java Database Connectivity (JDBC)ou uma propriedade de origem de dados. Por exemplo, é possível digitarlocalhost\instance1. Se não forem especificadas propriedades de nome deinstância, é criada uma conexão com a instância padrão.As propriedades especificadas para a instância denominada, junto com a ID esenha de usuário e nome do banco de dados, são usados para criar um JDBCURL. Eis um exemplo:jdbc:JSQLConnect://localhost\\instance1/user=sa/more properties as required

Para se conectar a uma instância nomeada, é necessário especificar o nomeda instância. Por exemplo, é possível digitar localhost\instance1. Se o nomede uma instância não for especificado, será criada uma conexão com ainstância padrão.

v Se você usar um banco de dados Oracle, digite os valores apropriados paraas propriedades Servidor de Banco de Dados e Número da Porta e SID.

v Se usar um banco de dados avançado do Oracle, para a propriedadeEspecificador do banco de dados, digite o par de valores de palavra-chaveOracle Net8 para a conexão.Eis um exemplo:

126 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 139: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

(description=(address=(host=myhost)(protocol=tcp)(port=1521)(connect_data=(sid=(orcl)))))

Ao selecionar o banco de dados Oracle avançado, o IBM Cognos BI usarárecursos do Oracle orientados para empresa para selecionar um ouvinte,alternar para outro ouvinte se o primeiro ouvinte falhar, conectar-senovamente ao banco de dados automaticamente se a conexão falhar,equilibrar solicitações de conexão entre ouvintes e equilibrar as solicitaçõesde conexão entre dispatchers.

v Se estiver usando um banco de dados Informix, digite os valores apropriadospara as propriedades Servidor de banco de dados e número da porta eNome do banco de dados.

v Se usar um banco de dados Sybase, digite os valores apropriados para aspropriedades Servidor de banco de dados e número da porta e Nome dobanco de dados.

7. Para configurar credenciais de logon, especifique uma ID e senha de usuário:v Clique na caixa Valor próxima à propriedade ID do usuário e senha e clique

no ícone de edição quando ele aparecer.v Digite os valores apropriados e clique em OK.

8. Se hospedar mais de um banco de dados de armazenamento de conteúdo emuma instância do Informix, crie a propriedade avançada CMSCRIPT_CS_ID eespecifique a conta na qual a instância será executada:v Na janela Explorer, clique em Configuração Local.v Na janela Propriedades, clique na coluna Valor de Propriedades Avançadas

e, em seguida, clique no ícone de edição.v Na caixa de diálogo Valor - Propriedades avançadas, clique em Adicionar.v Na coluna Nome, digite CMSCRIPT_CS_ID

v Na coluna Valor, digite o ID do usuário da conta na qual a instância doarmazenamento de conteúdo é executada.Use uma conta do usuário diferente para cada instância do banco de dadosde armazenamento de conteúdo do Informix.

9. No menu Arquivo, clique em Salvar.As credenciais de logon são imediatamente criptografadas.

Resultados

Agora o Content Manager poderá criar as tabelas necessárias no armazenamentode conteúdo quando o serviço IBM Cognos for iniciado pela primeira vez. Se aspropriedades da conexão não estiverem especificadas corretamente, não serápossível iniciar os serviços do IBM Cognos.

Configuração de propriedades do ambiente paracomputadores com Content Manager

Os computadores do Content Manager devem conhecer a localização doarmazenamento de conteúdo, outros computadores com Content Manager e obanco de dados utilizado para notificação.

Depois de instalar o Content Manager em computadores utilizados para proteçãode failover, é preciso configurar o Content Manager nesses computadores. Se maisde um Content Manager foi instalado, liste todos os URIs de Content Manager emcada computador com Content Manager.

Capítulo 6. Instalação e Configuração dos Componentes do Servidor em Diferentes Computadores 127

Page 140: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Após a conclusão das tarefas de configuração necessárias e o início do serviço doIBM Cognos BI, o serviço de autoridade de certificação estará disponível para aemissão de certificados para outros computadores. É possível então executar astarefas de configuração exigidas em outros computadores, como o computador deApplication Tier Components e computadores de gateway. Caso contrário, épossível continuar configurando os computadores com Content Manager alterandoas configurações de propriedade padrão (consulte “Alteração de definições deconfiguração padrão” na página 208) para adequá-las ao seu ambiente. Porexemplo, é possível configurar os componentes do IBM Cognos BI para usar umprovedor de autenticação (consulte Capítulo 8, “Configurando Componentes doIBM Cognos para Usar um Provedor de Autenticação”, na página 165), ativar edesativar serviços (consulte “Ativação e desativação de serviços” na página 220)nos computadores com Content Manager ou alterar configurações globais (consulte“Alteração de definições globais” na página 263).

Observe que, caso as configurações globais sejam alteradas em um computadorcom Content Manager, é necessário fazer as mesmas mudanças nos outroscomputadores com Content Manager.

Configurando o Content Manager AtivoOs computadores do Content Manager devem conhecer a localização doarmazenamento de conteúdo, outros computadores com Content Manager e obanco de dados utilizado para notificação.

Procedimento1. No computador com Content Manager que você quer designar como o Content

Manager ativo padrão, inicie o IBM Cognos Configuration.

Dica: Use o computador com a velocidade de processador mais alta para oContent Manager ativo padrão.

2. Na janela Explorer, clique em Ambiente.3. Na janela Propriedades, clique no valor para URIs do Content Manager e

clique no botão de edição.4. Especifique os URIs para os outros computadores com Content Manager:

v Na caixa de diálogo Valor - URIs do Content Manager, clique em Adicionar.v 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 localcom Content Manager e é solicitado.Substitua a parte do localhost do URI por um nome do host ou endereço IP.Todas as propriedades do URI devem usar o mesmo formato: todos osnomes de host ou todos os endereços IP.

v Repita as duas etapas anteriores para cada URI a ser adicionado.É necessário incluir todos os URIs do Content Manager na lista.

v Clique em OK.5. Na janela Explorer, em Segurança, clique emCriptografia.6. Na janela Propriedades, em Configurações CSK, defina Armazenar chave

simétrica localmente para Verdadeiro.7. No menu Arquivo, clique em Salvar.

128 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 141: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Configurando Content Managers em EsperaOs computadores do Content Manager devem conhecer a localização doarmazenamento de conteúdo, outros computadores com Content Manager e obanco de dados utilizado para notificação.

Procedimento1. Certifique-se de já ter configurado as propriedades de Ambiente em pelo

menos um computador com Content Manager e de que os componentes doIBM Cognos BI estejam em execução nesse computador.

2. No computador com Content Manager em espera, inicie o IBM CognosConfiguration.

3. Na janela Explorer, clique em Ambiente.4. Na janela Propriedades, clique no valor de URIs do Content Manager e no

botão de edição.5. Especifique os URIs para os outros computadores com Content Manager:

v Na caixa de diálogo Valor - URIs do Content Manager, clique emAdicionar.

v Na linha em branco da tabela, clique e digite o URI completo docomputador com Content Manager.Não exclua o primeiro valor na tabela. O valor identifica o computadorlocal com Content Manager e é solicitado.Substitua a parte do localhost do URI por um nome do host ou endereço IP.Todas as propriedades do URI devem usar o mesmo formato: todos osnomes de host ou todos os endereços IP.

v Repita as duas etapas anteriores para cada URI a ser adicionado.É necessário incluir todos os URIs do Content Manager na lista.

v Clique em OK.6. Na janela Explorer, em Segurança > Criptografia, clique em Cognos, o

provedor de criptografia padrão.7. Certifique-se de que as definições criptográficas correspondam ao que foi

definido no computador ativo padrão com Content Manager.8. Na janela Explorer, em Acesso a Dados > Content Manager, clique em

Armazenamento de Conteúdo.9. Certifique-se de que os valores para todas as propriedades coincidam com o

que foi configurado no computador ativo padrão com Content Manager.10. No menu Arquivo, clique em Salvar.

Especificação de uma conexão para uma conta do servidor decorreio

Se desejar enviar relatórios por e-mail, é necessário configurar conexão com umaconta de servidor de correio.

É necessário alterar a parte do nome do host do URI do gateway de localhost parao endereço IP do computador ou para o nome do computador. Do contrário, oURL no e-mail irá conter localhost e os usuários remotos não poderão abrir orelatório.

Procedimento1. No local em que o Content Manager está instalado, inicie o IBM Cognos

Configuration.

Capítulo 6. Instalação e Configuração dos Componentes do Servidor em Diferentes Computadores 129

Page 142: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

2. Na janela Explorer, em Acesso a dados, clique em Notificação.3. 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).

Dica: Para conseguir abrir os relatórios enviados como links, certifique-se deque a URI do Gateway nos servidores de relatório e nos servidores denotificação especifique um servidor da Web acessível que hospeda o conteúdodo IBM Cognos. Se tiver usuários móveis acessando os links remotamente,considere o uso de um URI externo.

4. Clique na caixa de seleção Valor próxima à propriedade Conta e senha e cliqueno botão de edição quando aparecer.

5. Digite os valores adequados na caixa de diálogo Valor - Conta e senha e cliqueem OK.

Dica: Se as credenciais de logon não forem necessárias para o servidor SMTP,remova as informações padrão da propriedade Conta e senha. Quando forsolicitada a confirmação para deixar essa propriedade em branco, clique emOK. Certifique-se o nome de usuário padrão foi removido. Do contrário, aconta padrão é usada e as notificações não funcionarão corretamente.

6. Na janela Propriedades, digite o valor apropriado para a conta do remetentepadrão.

7. Teste as conexões de servidores de correio. Na janela Explorer, clique com obotão direito em Notificação e clique em Testar.O IBM Cognos Business Intelligence testa a conexão de servidores de correio.

Resultados

Se não planeja enviar relatórios por e-mail ou não deseja configurar uma conta deservidor de correio imediatamente, não é necessário. Entretanto, ao salvar aconfiguração e depois iniciar os serviços no IBM Cognos Configuration, apareceráuma mensagem de aviso quando a conexão de servidores de correio for testada.Ignore, com segurança, o aviso.

Ativação da segurançaPor padrão, o IBM Cognos Business Intelligence permite acesso anônimo. Se quiserusar segurança em seu ambiente do IBM Cognos BI, você deverá desativar oacesso anônimo e configurar o IBM Cognos BI para usar um provedor deautenticação.

Procedimento1. Na janela IBM Cognos Configuration Explorer, 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 em 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, nocomponente Autenticação.

6. Na janela Propriedades, na propriedade ID do namespace, especifique umidentificador exclusivo para o namespace.

7. No menu Arquivo, clique em Salvar.

130 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 143: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Configurar um Namespace do IBM Cognos Series 7 no IBMCognos BI

Se quiser migrar informações de segurança ou conteúdo assegurado do IBMCognos Series 7 para o IBM Cognos Business Intelligence, você deve configurar umnamespace no IBM Cognos BI que seja idêntico ao namespace do IBM CognosSeries 7.

É possível configurar diversos namespaces para autenticação no IBM Cognos BI.Para obter mais informações, consulte Capítulo 8, “Configurando Componentes doIBM Cognos para Usar um Provedor de Autenticação”, na página 165.

Nota: Não é possível usar um arquivo Local Authentication Export (LAE) do IBMCognos Series 7 para autenticação com componentes do IBM Cognos BI.

Todos os namespaces IBM Cognos Series 7 devem usar o mesmo Servidor doChamado principal do IBM Cognos Series 7. Do contrário, podem ser recebidoserros ou avisos de autenticação mais de uma vez.

Se alterar as informações de configuração armazenadas no servidor de diretóriousado para o IBM Cognos Series 7, você deve reiniciar o serviço do IBM Cognos BIantes das mudanças entrarem em vigor na instalação do IBM Cognos.

Um usuário deve estar em pelo menos uma classe de usuário do Access Managerpara poder efetuar logon nos componentes do IBM Cognos BI.

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

Cognos.3. Clique na caixa Valor para Permitir acesso anônimo e selecione Falso.4. Na janela Explorer, clique com o botão direito em Autenticação e selecione

Novo recurso, Namespace.5. Na caixa Nome, digite um nome para o namespace de autenticação.6. Na lista Tipo, clique em IBM Cognos Series 7 e depois em OK.

O novo recurso provedor de autenticação aparece na janela Explorer, nocomponente Autenticação.

7. Na janela Propriedades do Recurso, especifique os valores obrigatórios.Determinados valores devem corresponder aos valores usados ao configurar onamespace do IBM Cognos Series 7 no Gerenciador de Configuração. NoConfiguration Manager, as propriedades estão localizadas em Serviços, AccessManager - Runtime, Directory Server.v Para ID do Namespace, especifique um identificador exclusivo para o

namespace.v Para Host e porta, digite o mesmo valor usado para a propriedade

Computador no Configuration Manager.O formato deve ser idêntico. Se você usar um endereço IP no IBM CognosSeries 7, digite o mesmo endereço IP. Se usar um nome de host de rede noIBM Cognos Series 7, digite o mesmo nome de host de rede.

v Para Nome Distinto Base, digite o mesmo valor usado para a propriedadeNome Distinto Base (DN) no Configuration Manager.

v Para Nome do namespace, digite o mesmo valor usado para a propriedadeNamespace padrão no Configuration Manager.

Capítulo 6. Instalação e Configuração dos Componentes do Servidor em Diferentes Computadores 131

Page 144: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Este valor diferencia maiúsculas de minúsculas e deve corresponderexatamente.

8. Especifique os valores para todas as demais propriedades necessárias paraassegurar que componentes do IBM Cognos BI possam localizar e usar seuprovedor de autenticação existente.Se a versão do namespace IBM Cognos Series 7 for 16.0, certifique-se de que apropriedade Codificação de dados esteja configurada como UTF-8. Alémdisso, os computadores onde o Content Manager está instalado devem usar omesmo código do idioma que os dados no namespace do IBM CognosSeries 7.

9. Se o ambiente do namespace incluir a versão 15.2 do namespace IBM CognosSeries 7, você deverá desativar a configuraçãoSeries7NamespacesAreUnicode.v Na janela Propriedades, no valor Propriedades Avançadas, clique no ícone

de edição.v Na janela Valor - Propriedades avançadas, clique em Adicionar.v Na caixa Nome, digite Series7NamespacesAreUnicode.v Na caixa Valor, digite Falso e depois clique em OK.

10. Na janela Propriedades, em Configurações de Cookie, certifique-se de que aspropriedades Caminho, Domínio e Sinalizador Seguro Ativadocorrespondam às configurações feitas para o IBM Cognos Series 7.

11. No menu Arquivo, clique em Salvar.

Início do Content ManagerDepois de ter definido as propriedades de conexão com o banco de dados para oarmazenamento de conteúdo, inicie o computador com o Content Manager.

Antes de Iniciar

Certifique-se de que a conta de usuário ou serviço esteja definida. Para obter maisinformações, consulte “Configuração de uma Conta de Usuário ou Conta deServiço de Rede para o IBM Cognos Business Intelligence” na página 43.

Procedimento1. Inicie o IBM Cognos Configuration.

Se estiver atualizando, será exibida uma mensagem indicando que os arquivosde configuração foram detectados e atualizados para a nova versão.

2. Certifique-se de que suas configurações foram salvas, caso contrário, não serápossível iniciar o serviço do IBM Cognos.

3. No menu Ações, clique em Testar.O IBM Cognos Configuration verifica a disponibilidade da chave simétricacomum (CSK), testa a configuração do namespace e testa as conexões com oarmazenamento de conteúdo e outros recursos.

Dica: Se Teste não estiver disponível para seleção, na janela Explorer, cliqueem Configuração Local.

4. Se o teste falhar, configure novamente as propriedades afetadas e faça o testede novo.É possível testar alguns componentes individualmente clicando com o botãodireito no componente na área de janela Explorer e selecionando Testar.Não inicie o serviço até que haja aprovação em todos os testes.

132 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 145: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

5. No menu Ações, clique em Iniciar.Pode levar alguns minutos para o serviço do IBM Cognos iniciar.Essa ação inicia todos os serviços instalados que não estão em execução eregistra o serviço do IBM Cognos no Windows.

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

Procedimento1. Abra um navegador web.2. Teste se o Content Manager está sendo executado digitando a URI do Content

Manager. Por exemplo, http://host_name:port/p2pd/servletO valor padrão para nome_host:porta é localhost:9300.O Content Manager está disponível quando o valor Estado está em Execução.

Instalação e configuração do Application Tier ComponentsInstale o Application Tier Components no mesmo computador ou emcomputadores diferentes.

Componentes da camada de aplicativos incluem o PowerPlay Server e oPowerPlay Administration. Ambos são selecionados por padrão.

Para instalações distribuídas que incluem somente o PowerPlay, instale ambos, oPowerPlay Server e o PowerPlay Administration juntos em um ou maiscomputadores. Para instalações distribuídas que incluem ambos, o PowerPlay e oIBM Cognos Business Intelligence, é possível instalar os Componentes de Camadade Aplicativo do PowerPlay nos mesmos computadores dos Componentes deCamada de Aplicativo do IBM Cognos BI ou em computadores separados. Se vocêinstalar Componentes da camada de aplicativos do PowerPlay em um computadorseparado dos Componentes da camada de aplicativos do IBM Cognos BI, faça oseguinte:v Instale apenas o componente PowerPlay Administration em todos os

computadores que incluem os Componentes da camada de aplicativos do IBMCognos BI.

v No computador no qual os Componentes da camada de aplicativos doPowerPlay foram instalados (o PowerPlay Server e o PowerPlay Administration),abra o Cognos Configuration e sob IBM Cognos Services, desative o serviço deapresentação e o serviço de relatório. Opcionalmente, para reduzir a demandados recursos do sistema, é possível desativar o serviço de consulta.

O computador com componentes da camada de aplicativos deve conhecer alocalização de computadores com o Content Manager e o banco de dados denotificação para utilizar para informações de tarefa e de programação. Verifique seo computador onde instalou o Content Manager ativo está configurado edisponível antes de configurar computadores com Application Tier Components. Semais de um Content Manager foi instalado, liste todos os URIs de ContentManager em cada computador com Application Tier Components.

Instalação do Application Tier ComponentsInstale os componentes do Application Tier Components em um ou maiscomputadores, dependendo do ambiente.

Capítulo 6. Instalação e Configuração dos Componentes do Servidor em Diferentes Computadores 133

Page 146: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Componentes da camada de aplicativos incluem o PowerPlay Server e oPowerPlay Administration. Ambos são selecionados por padrão.

Se você estiver atualizando do ReportNet ou uma versão anterior do IBM CognosBI, o IBM Cognos BI usará os dados de configuração existentes para oscomputadores de Componentes da Camada de Aplicativos. Entretanto, se tiverinstalado o Application Tier Components em um novo local, configure aspropriedades do ambiente.

Verifique se o computador onde instalou o Content Manager ativo está configuradoe disponível antes de configurar computadores com Application Tier Components.

Instalando os Componentes da Camada de Aplicativos nosSistemas Operacionais UNIX ou LinuxInstale os componentes do Application Tier Components em um ou maiscomputadores, dependendo do ambiente.

Antes de Iniciar

Vá para o página Relatórios de Compatibilidade de Produto IBM Software(www.ibm.com/support/docview.wss?uid=swg27042164). Verifique se você tem ascorreções requeridas instaladas em seu computador antes de instalar o produto.

Procedimento1. Se estiver instalando em um diretório com outros componentes do IBM

Cognos BI, pare o serviço do IBM Cognos.2. Configure a variável de ambiente JAVA_HOME para apontar para o local da

instalação do seu Java Runtime Environment (JRE).Um exemplo do local da instalação de um Java Runtime Environment é/directory/java/java_version/jre.O IBM Cognos BI requer uma JVM, como o Java fornecido pela IBM paraexecução em um sistema operacional Linux.Se você estiver instalando em um local com outros componentes do IBMCognos BI, use a variável de ambiente JAVA_HOME existente.

3. No HP-UX, defina a variável de ambiente _M_ARENA_OPTS da seguinteforma:_M_ARENA_OPTS 1:4

Isso aumenta a alocação de memória para HP-UX para corresponder melhor àde outras plataformas UNIX.

4. No AIX, se você estiver usando um gateway de servlet, configure a variávelde ambiente AIXTHREAD_SCOPE da seguinte forma:AIXTHREAD_SCOPE=S

Isso define o escopo de contenção de 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 osarquivos de instalação foram baixados e extraídos.

6. Se estiver instalando de um disco, monte o disco usando extensões de arquivoRock Ridge.Para montar o disco em HP-UX, faça o seguinte:v Inclua o diretório pfs_mount no seu caminho.

Por exemplo,PATH=/usr/sbin/:$PATH

134 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 147: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

exporte PATH

v Para iniciar os daemons NFS necessários e executar os daemons no planode fundo, digite bg pfs_mountd e digite bg pfsd

v Para montar a unidade, digitepfs_mount -t rrip <device><mount_dir> -o xlat=unix

Por exemplo,pfs_mount /dev/dsk/c0t2d0 /cdrom -o xlat=unix

Agora é possível instalar ou copiar arquivos como um usuário não raizusando um disco IBM Cognos a partir dessa unidade.

v Ao concluir a instalação, digite pfs_umount /cdrom e finalize os daemonspfsd e pfs_mountd para desmontar o disco.

7. Para iniciar o assistente de instalação, vá para o diretório do sistemaoperacional e digite./issetup

Nota: Ao usar o comando issetup com XWindows, os caracteres japoneses nasmensagens e arquivos de log poderão ficar corrompidos. Ao instalar emjaponês no UNIX ou Linux, primeiro configure as variáveis de ambienteLANG=C e LC_ALL=C (em que C é o código de idioma, por exemplo,ja_JP.PCK no Solaris) e inicie o assistente de instalação.Se não estiver usando XWindows, execute uma instalação não assistida(consulte “Usar um Arquivo de Resposta a partir de uma Instalação em OutroComputador” na página 308).Se não estiver usando o XWindows, execute uma instalação não assistida. Paraobter mais informações, consulte o Guia de instalação e configuração.Se estiver instalando nos sistemas operacionais Linux e receber mensagens deerro sobre bibliotecas openmotif ausentes, será possível usar uma instalaçãonão assistida com o comando issetupnx.

8. Siga as instruções do assistente de instalação e copie os arquivos necessáriospara seu computador.v Ao selecionar o diretório, considere o seguinte:

Instale os Application Tier Components em um diretório que contenhaapenas caracteres ASCII no nome do caminho. Alguns servidores da WebUNIX e Linux não suportam caracteres não ASCII em nomes de diretório.

v Ao selecionar os componentes, desmarque todos, exceto Application TierComponents.

9. Na página Concluir do assistente de instalação, faça o seguinte:v Se desejar ver os arquivos de log, clique em Visualização para o arquivo de

log adequado.v Se quiser ver as últimas informações sobre o produto, selecione a caixa de

seleção das Notas sobre o Release do IBM Cognos.v Não configure o IBM Cognos BI imediatamente, pois você deve executar

outras tarefas primeiro para garantir que seu ambiente esteja configuradocorretamente. Certifique-se de que a caixa de seleção IBM CognosConfiguration esteja limpa.É possível configurar posteriormente o IBM Cognos BI usando o IBMCognos Configuration, digitando cogconfig.sh no diretórioc10_location/bin64.

v Clique em Concluir.

Capítulo 6. Instalação e Configuração dos Componentes do Servidor em Diferentes Computadores 135

Page 148: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

10. Anexe o diretório c10_location/bin na variável de ambiente do caminho dabiblioteca adequada.v Para Solaris e Linux, LD_LIBRARY_PATHv Para AIX, LIBPATHv Para HP-UX, SHLIB_PATH

Instalando os Componentes da Camada de Aplicativos noSistema Operacional WindowsInstale os componentes do Application Tier Components em um ou maiscomputadores, dependendo do ambiente.

Para computadores com o Windows Vista, Windows 7 ou Windows 2008, o localde instalação padrão usa o diretório Program Files (x86). Se você instalar nesselocal, assegure que você execute o IBM Cognos Configuration como umAdministrador. Como alternativa, é possível instalar o produto fora do diretórioProgram Files (x86). Por exemplo, é possível alterar o diretório de instalação paraalgo como C:\IBM\cognos\c10.

Procedimento1. Se estiver instalando em um diretório com outros componentes do IBM Cognos

BI, pare o serviço do IBM Cognos.2. Execute um dos seguintes procedimentos:

v Insira o disco do produto IBM Cognos.Se o assistente de instalação não for aberto automaticamente, acesse odiretório do sistema operacional e clique duas vezes em issetup.exe.

v Acesse o local em que os arquivos de instalação foram transferidos pordownload e extraídos e clique duas vezes em issetup.exe.

3. Selecione o idioma para utilizar na instalação.Essa seleção determina o idioma da interface com o usuário. Todos os idiomassuportados são instalados. É possível alterar a interface com o usuário paraqualquer um dos idiomas instalados depois de concluída a instalação.

4. Siga as instruções do assistente de instalação e copie os arquivos necessáriospara seu computador.v Ao selecionar o diretório, considere o seguinte:

Instale os Application Tier Components em um diretório que contenhaapenas caracteres ASCII no nome do caminho. Alguns servidores web nãosuportam caracteres que não sejam ASCII nos nomes dos diretórios.

v Ao selecionar os componentes, desmarque todos, exceto Application TierComponents.

5. Na página Concluir do assistente de instalação, faça o seguinte:v Se desejar ver os arquivos de log, clique em Visualização para o arquivo de

log adequado.v Se quiser ver as últimas informações sobre o produto, selecione a caixa de

seleção das Notas sobre o Release do IBM Cognos.v Se você iniciar o IBM Cognos Configuration a partir do assistente de

instalação, certifique-se de seguir as tarefas adicionais nessa seção paraassegurar que o seu ambiente esteja apropriadamente configurado antes deiniciar os serviços.É possível iniciar o IBM Cognos Configuration usando o atalho IBM CognosConfiguration do menu Iniciar.

v Clique em Concluir.

136 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 149: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Instalando fix packs do IBM CognosO IBM fornece pacotes de manutenção temporários que contêm atualizações paraum ou mais componentes para o seu produto IBM Cognos. Fix packs sãoatualizações de produto que contêm correções de códigos acumulativas realizadasdesde a última liberação do produto. Se um fix pack estiver disponível ao instalarou atualizar seu produto, é necessário instalá-lo após instalar os componentes doIBM Cognos. Os fix packs do IBM Cognos são instalados no mesmo local que oproduto existente.

Os fix packs são acumulativos. Quando se instala um fix pack, ele incluiatualizações de todos os fix packs anteriores. Os fix packs estão disponíveis paradownload a partir do Suporte IBM (www.ibm.com/support/entry/portal/overview).

Nota:

v Os fix packs não são instalações independentes. É necessário instalá-los noscomputadores que possuem componentes do IBM Cognos instalados. Instale osfix packs que são apropriados para sua versão do produto. Para verificar suaversão, abra o arquivo da lista de componentes no c10_location\cmplst.txt everifique a linha que inicia com C8PPCLIENT_version= para o PowerPlay Client eC8PPES_version= para a versão do servidor PowerPlay.

v Se você usou a opção Configuração Rápida para a instalação do Cognos BIoriginal (versão 10.2.2), isso significa que o DB2 Advanced Workgroup ServerEdition foi instalado e configurado como o banco de dados de armazenamentode conteúdo. A opção Configuração Rápida não estará disponível para instalar ofix pack. Use a opção de instalação do IBM Cognos Business Inteliigence Server.Além disso, os fix packs ou correções para o DB2 Advanced Workgroup ServerEdition precisarão ser instalados usando os métodos de instalação de fix pack doDB2.

Procedimento1. Acesse o local onde os arquivos de instalação foram transferidos por download

ou insira o disco se você tiver um.2. Inicie o assistente de instalação:

v Em computadores executando sistemas operacionais Linux ou UNIX, acesseo diretório do sistema operacional e execute ./issetup.

v Em computadores executando sistemas operacionais Microsoft Windows,acesse o diretório do sistema operacional e clique duas vezes emissetup.exe.

3. Siga as instruções do assistente de instalação para que os arquivos de fix packsejam instalados no mesmo local que os componentes do IBM Cognos.

4. Se necessário, atualize os novos arquivos de instalação com todas as mudançasdas cópias de backup de seus arquivos customizados.Para evitar erros, antes de copiar os arquivos customizados, compare ambas asversões dos arquivos. Esta validação determina se é possível substituir oarquivo.

5. Se você tiver um ambiente distribuído, repita estas etapas para todos osservidores IBM Cognos restantes.

Início do IBM Cognos ConfigurationUse IBM Cognos Configuration para configurar os componentes do IBM CognosBusiness Intelligence e iniciar e parar serviços do IBM Cognos.

Capítulo 6. Instalação e Configuração dos Componentes do Servidor em Diferentes Computadores 137

Page 150: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Se você estiver usando um servidor de aplicativos diferente do fornecido, deve-seiniciar e parar os serviços do IBM Cognos por meio do servidor de aplicativos.

Antes de Iniciar

Antes de iniciar o IBM Cognos Configuration, certifique-se de que o ambienteoperacional esteja devidamente configurado. Por exemplo, certifique-se de quetodas as variáveis de ambiente foram definidas.

Em um sistema operacional Microsoft Windows, é possível iniciar o IBM CognosConfiguration na última página do assistente de instalação somente se não fornecessário fazer nenhuma configuração adicional. Por exemplo, se você usar umservidor de banco de dados que não seja Microsoft SQL ou Banco de dados deconteúdo do Cognos para o armazenamento de conteúdo, copie os drivers JavaDatabase Connectivity (JDBC) no local apropriado antes de iniciar a ferramenta deconfiguração.

Em sistemas operacionais UNIX ou Linux, não inicie oIBM Cognos Configurationna última página do assistente de instalação. Configuração adicional é necessáriaantes de ser possível configurar o IBM Cognos BI. Por exemplo, você deveatualizar seu ambiente Java.

Assegure-se de que a conta do usuário ou do serviço usada para executar o IBMCognos tenha sido configurada.

Procedimento1. No Microsoft Windows, clique em Iniciar > IBM Cognos Configuration.

Se estiver usando um computador Windows Vista, Windows 7 ou Windows2008 e tiver instalado o produto no diretório Arquivos de Programas (x86),inicie o IBM Cognos Configuration como um Administrador.

2. Nos sistemas operacionais UNIX ou Linux, acesse o diretórioc10_location/bin64 e, em seguida, digite o seguinte comando:./cogconfig.sh

Se o IBM Cognos Configuration não abrir, certifique-se de que você configuroua variável de ambiente DISPLAY.Se você vir uma mensagem JAVA.Lang.unsatisfied link, verifique se estáusando uma versão suportada do Java.Se você vir uma mensagem Java.lang.unsupportedClassVersionError,certifique de que está usando uma versão de 64 bits do Java.

Configuração de propriedades do ambiente paracomputadores com Application Tier Components

Se instalar o componente Application Tier Components em um computadordiferente do Content Manager, configure o computador com Application TierComponents para que saiba a localização do Content Manager. Os componentesdistribuídos podem então se comunicar um com o outro.

O computador com Application Tier Components deve conhecer a localização decomputadores com o Content Manager e o banco de dados de notificação parautilizar para informações de tarefa e de programação. O computador doApplication Tier Components deve utilizar o mesmo banco de dados de notificaçãoque o computador do Content Manager usa. Para obter mais informações, consulte“Alterar o Banco de Dados de Notificação” na página 231.

138 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 151: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Se mais de um Content Manager foi instalado, liste todos os URIs de ContentManager em cada computador com Application Tier Components.

Procedimento1. Inicie o IBM Cognos Configuration.2. Na janela Explorer, clique em Ambiente.3. Na janela Propriedades, altere a porção localhost da propriedade URIs do

Content Manager para o nome de qualquer computador com o ContentManager.

4. Especifique os URIs para os outros computadores com Content Manager:v Na caixa de diálogo Valor - URIs do Content Manager, clique em

Adicionar.v Na linha em branco da tabela, clique e digite o URI completo do

computador com Content Manager.Substitua a parte do localhost do URI por um nome do host ou endereço IP.Todas as propriedades do URI devem usar o mesmo formato: todos osnomes de host ou todos os endereços IP.

v Repita as duas etapas anteriores para cada URI a ser adicionado.É necessário incluir todos os URIs do Content Manager na lista.

v 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 arelatórios e áreas de trabalho enviados por e-mail.

6. Altere a parte localhost das propriedades de URI restantes para o mesmonome ou endereço IP do seu servidor IBM Cognos BI.

7. Na janela Explorer, em Segurança > Criptografia, clique em Cognos, oprovedor de criptografia padrão.

8. No grupo de propriedades Configuração da autoridade de certificação, definaa propriedade Senha para coincidir com as configurações do computador comContent Manager ativo padrão.

9. Certifique-se de que as definições criptográficas coincidam com o que foidefinido no computador com Content Manager ativo padrão.

10. No menu Arquivo, clique em Salvar.

Instalação do Application Tier ComponentsDepois de ter configurado as propriedades do ambiente, inicie os serviços nocomputador com Application Tier Components.

Antes de Iniciar

Para usar o IBM Cognos BI para relatório, você deve instalar e configurar oscomponentes do servidor, iniciar o serviço do IBM Cognos e ter um pacote quefaça referência a uma origem de dados disponível. Observe que se estiveratualizando, é possível continuar a usar as mesmas origens de dados.

Certifique-se de que a conta de usuário ou serviço esteja definida. Para obter maisinformações, consulte “Configuração de uma Conta de Usuário ou Conta deServiço de Rede para o IBM Cognos Business Intelligence” na página 43.

Capítulo 6. Instalação e Configuração dos Componentes do Servidor em Diferentes Computadores 139

Page 152: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Procedimento1. Inicie o IBM Cognos Configuration.

Se estiver atualizando, será exibida uma mensagem indicando que os arquivosde configuração foram detectados e atualizados para a nova versão.

2. Certifique-se de que suas configurações foram salvas, caso contrário, não serápossível iniciar o serviço do IBM Cognos.

3. No menu Ações, clique em Testar.O IBM Cognos Configuration verifica a disponibilidade da chave simétricacomum (CSK), testa a configuração do namespace e testa as conexões com oarmazenamento de conteúdo e outros recursos.

Dica: Se Teste não estiver disponível para seleção, na janela Explorer, cliqueem Configuração Local.

4. Se o teste falhar, configure novamente as propriedades afetadas e faça o testede novo.É possível testar alguns componentes individualmente clicando com o botãodireito no componente na área de janela 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 do IBM Cognos iniciar.Essa ação inicia todos os serviços instalados que não estão em execução eregistra o serviço do IBM Cognos no Windows.

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

Procedimento1. Abra um navegador da Web.2. Teste a disponibilidade do dispatcher digitando o valor URI do dispatcher

externo do IBM Cognos Configuration. Por exemplo,http://host_name:port/p2pd/servlet/dispatch

O valor padrão para nome_host:porta é localhost:9300.O dispatcher está disponível quando o IBM Cognos Connection aparece, massem exibir nenhum gráfico ou imagem.

Teste o Serviço de Migração do IBM Cognos BIÉ possível testar a instalação do serviço de migração do IBM Cognos BusinessIntelligence verificando se o ícone do Migration Assistant aparece no IBM CognosAdministration.

Procedimento1. 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 ícone Assistente de Migração aparece na barra de ferramentas.

140 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 153: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Resultados

Antes que possa usar o Assistente de Migração para migra o conteúdo do IBMCognos Series 7 do Upfront, PowerPlay Enterprise Server e IBM CognosConnection, deverá instalar os componentes de migração com o IBM Cognos Series7. Para obter informações adicionais sobre o conteúdo de migração, consulte o Guiade Migração e Administração do PowerPlay.

Métodos de instalação e configuração de componentes docliente do IBM Cognos Mobile

Após instalar e configurar os componentes do servidor do IBM Cognos Mobile, osusuários podem instalar o aplicativo IBM Cognos Mobile em seus dispositivosmóveis ou usar uma versão da web para acessar os relatórios do análises do IBMCognos Business Intelligence.

Para usar o aplicativo, os usuários fazem o download da versão iOS na Loja deaplicativos da Apple, ou da versão Android na Loja Google Play.

Para usar a versão da web, os usuários acessam o IBM Cognos Mobile a partir deuma URL.v Para a localização padrão do IBM Cognos BI, a URL é http://servername/

ibmcognos e, quando solicitado, selecione o portal Móvel ou o portal da área detrabalho

v Para o gateway CGI, a URL é http://servername/ibmcognos/m

v Para um gateway ISAPI, a URL é http://servername/ibmcognos/m/isapi

v Para um módulo Apache, a URL é http://servername/ibmcognos/m/mod

Dica: Após a abertura do aplicativo da web no navegador, os usuários podemincluir a página à sua tela inicial.

Executando o Cognos Mobile sem um servidor da web

A instalação padrão do Cognos BI agora instala o WebSphere Application ServerLiberty Profile como o servidor de aplicativos. Dessa maneira, é possível executar oCognos Mobile sem um servidor da web configurado, se algumas mudanças foremfeitas.

Procedimento1. Configure o URI do Gateway para o mesmo valor que o URI do dispatcher

externo. Esses valores são especificados no Cognos Configuration,Configuração Local, Ambiente. Configure o URI do dispatcher externo e oURI de Gateway usando o padrãohttp://<server-name>:<port>/p2pd/servlet/dispatch. Por exemplo, http://myhostserver:9300/p2pd/servlet/dispatch

2. Use o seguinte padrão de URL para executar os clientes nativos do CognosMobile, incluindo iOS e Android:http(s)://<server-name>:<port>/p2pd

3. Use o seguinte padrão de URL para iniciar o ativador do Cognos Mobile emum navegador em um dispositivo móvel:http(s)://<server-name>:<port>/p2pd

4. Use o seguinte padrão de URL para executar o aplicativo da web do CognosMobile diretamente em um navegador em um dispositivo móvel oucomputador pessoal:

Capítulo 6. Instalação e Configuração dos Componentes do Servidor em Diferentes Computadores 141

Page 154: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

http(s)://<server-name>:<port>/p2pd/m/index.html

Instalação e configuração do gatewayÉ possível instalar o gateway em um ou mais computadores, dependendo doambiente. Caso tenha um Web farm, você pode querer instalar um gateway doIBM Cognos BI em cada servidor da Web. O uso de diversos servidores web paragerenciar solicitações recebidas oferece o melhor serviço. Se instalar apenas ocomponente de gateway no mesmo computador como servidor web, o servidorweb gerenciará os principais serviços da Web e não processará solicitações deusuário. Essa separação do processamento pode ser necessária se houver umfirewall de rede entre o servidor web e os componentes do outro servidor.

Verifique se o computador onde instalou o Content Manager ativo está configuradoe disponível antes de configurar computadores com gateway.

Realize as seguintes tarefas para instalar e configurar o gateway:v Instale os componentes do gatewayv Instale os fix packs, se disponíveisv Inicie o IBM Cognos Configurationv Configure propriedades de ambiente e segurança para o gatewayv Configure seu servidor da Webv Teste o computador do gateway

Instalando os Componentes de Gateway nos SistemasOperacionais UNIX ou Linux

É possível instalar o gateway em um ou mais computadores, dependendo doambiente. Caso tenha um Web farm, você pode querer instalar um gateway doIBM Cognos BI em cada servidor da Web.

Se estiver instalando o PowerPlay para funcionar com o IBM Cognos BusinessIntelligence, instale os componentes de gateway do PowerPlay nos mesmoscomputadores que incluem os componentes de gateway do IBM Cognos BusinessIntelligence.

Antes de Iniciar

Vá para o página Relatórios de Compatibilidade de Produto IBM Software(www.ibm.com/support/docview.wss?uid=swg27042164). Verifique se você tem ascorreções requeridas instaladas em seu computador antes de instalar o produto.

Procedimento1. Se estiver instalando em um diretório com outros componentes do IBM

Cognos BI, pare o serviço do IBM Cognos.2. Configure a variável de ambiente JAVA_HOME para apontar para o local da

instalação do seu Java Runtime Environment (JRE).Um exemplo do local da instalação de um Java Runtime Environment é/directory/java/java_version/jre.O IBM Cognos BI requer uma JVM, como o Java fornecido pela IBM paraexecução em um sistema operacional Linux.Se você estiver instalando em um local com outros componentes do IBMCognos BI, use a variável de ambiente JAVA_HOME existente.

142 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 155: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

3. No HP-UX, defina a variável de ambiente _M_ARENA_OPTS da seguinteforma:_M_ARENA_OPTS 1:4

Isso aumenta a alocação de memória para HP-UX para corresponder melhor àde outras plataformas UNIX.

4. No AIX, se você estiver usando um gateway de servlet, configure a variávelde ambiente AIXTHREAD_SCOPE da seguinte forma:AIXTHREAD_SCOPE=S

Isso define o escopo de contenção de 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 osarquivos de instalação foram baixados e extraídos.

6. Se estiver instalando de um disco, monte o disco usando extensões de arquivoRock Ridge.Para montar o disco em HP-UX, faça o seguinte:v Inclua o diretório pfs_mount no seu caminho.

Por exemplo,PATH=/usr/sbin/:$PATH

exporte PATH

v Para iniciar os daemons NFS necessários e executar os daemons no planode fundo, digite bg pfs_mountd e digite bg pfsd

v Para montar a unidade, digitepfs_mount -t rrip <device><mount_dir> -o xlat=unix

Por exemplo,pfs_mount /dev/dsk/c0t2d0 /cdrom -o xlat=unix

Agora é possível instalar ou copiar arquivos como um usuário não raizusando um disco IBM Cognos a partir dessa unidade.

v Ao concluir a instalação, digite pfs_umount /cdrom e finalize os daemonspfsd e pfs_mountd para desmontar o disco.

7. Para iniciar o assistente de instalação, vá para o diretório do sistemaoperacional e digite./issetup

Nota: Ao usar o comando issetup com XWindows, os caracteres japoneses nasmensagens e arquivos de log poderão ficar corrompidos. Ao instalar emjaponês no UNIX ou Linux, primeiro configure as variáveis de ambienteLANG=C e LC_ALL=C (em que C é o código de idioma, por exemplo,ja_JP.PCK no Solaris) e inicie o assistente de instalação.Se não estiver usando o XWindows, execute uma instalação não assistida(consulte Capítulo 12, “Usando instalação e configuração não assistidas”, napágina 307).Se não estiver usando o XWindows, execute uma instalação não assistida. Paraobter mais informações, consulte o Guia de instalação e configuração.Se estiver instalando nos sistemas operacionais Linux e receber mensagens deerro sobre bibliotecas openmotif ausentes, será possível usar uma instalaçãonão assistida com o comando issetupnx.

8. Siga as instruções do assistente de instalação e copie os arquivos necessáriospara seu computador.v Ao selecionar o diretório, considere o seguinte:

Capítulo 6. Instalação e Configuração dos Componentes do Servidor em Diferentes Computadores 143

Page 156: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Instale os componentes de gateway em um diretório que contenha apenascaracteres ASCII no nome do caminho. Alguns servidores da Web UNIX eLinux não suportam caracteres não ASCII em nomes de diretório.

v Ao selecionar os componentes, desmarque todos, exceto Gateway.9. Na página Concluir do assistente de instalação, faça o seguinte:

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

v Se quiser ver as últimas informações sobre o produto, selecione a caixa deseleção das Notas sobre o Release do IBM Cognos.

v Não configure o IBM Cognos BI imediatamente, pois você deve executaroutras tarefas primeiro para garantir que seu ambiente esteja configuradocorretamente. Certifique-se de que a caixa de seleção IBM CognosConfiguration esteja limpa.É possível configurar posteriormente o IBM Cognos BI usando o IBMCognos Configuration, digitando cogconfig.sh no diretórioc10_location/bin64.

v Clique em Concluir.10. Anexe o diretório c10_location/bin na variável de ambiente do caminho da

biblioteca adequada.v Para Solaris e Linux, LD_LIBRARY_PATHv Para AIX, LIBPATHv Para HP-UX, SHLIB_PATH

O que Fazer Depois

Se desejar que os usuários vejam a documentação do produto em um idiomadiferente do inglês, será necessário instalar o componente SupplementaryLanguage Documentation no local em que os componentes de gateway foraminstalados. Para obter mais informações, consulte “Instalando a Documentação doProduto Traduzida” na página 72.

Instalando os Componentes de Gateway nos SistemasOperacionais Windows

É possível instalar o gateway em um ou mais computadores, dependendo doambiente. Caso tenha um Web farm, você pode querer instalar um gateway doIBM Cognos BI em cada servidor da Web.

Procedimento1. Se estiver instalando em um diretório com outros componentes do IBM Cognos

BI, pare o serviço do IBM Cognos.2. Execute um dos seguintes procedimentos:

v Insira o disco do produto IBM Cognos.Se o assistente de instalação não for aberto automaticamente, acesse odiretório do sistema operacional e clique duas vezes em issetup.exe.

v Acesse o local em que os arquivos de instalação foram transferidos pordownload e extraídos e clique duas vezes em issetup.exe.

3. Selecione o idioma para utilizar na instalação.Essa seleção determina o idioma da interface com o usuário. Todos os idiomassuportados são instalados. É possível alterar a interface com o usuário paraqualquer um dos idiomas instalados depois de concluída a instalação.

144 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 157: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

4. Siga as instruções do assistente de instalação e copie os arquivos necessáriospara seu computador.v Ao selecionar o diretório, considere o seguinte:

Instale os componentes de gateway em um diretório que contenha apenascaracteres ASCII no nome do caminho. Alguns servidores da Web do sistemaoperacional Microsoft Windows não suportam caracteres não ASCII emnomes de diretórios.

v Ao selecionar os componentes, desmarque todos, exceto Gateway.5. Na página Concluir do assistente de instalação, faça o seguinte:

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

v Se quiser ver as últimas informações sobre o produto, selecione a caixa deseleção das Notas sobre o Release do IBM Cognos.

v Se desejar iniciar o IBM Cognos Configuration agora, selecione Iniciar o IBMCognos Configration.Também é possível iniciar o IBM Cognos Configuration usando o atalho IBMCognos Configuration do menu Iniciar.

v Clique em Concluir.

O que Fazer Depois

Se desejar que os usuários vejam a documentação do produto em um idiomadiferente do inglês, será necessário instalar o componente SupplementaryLanguage Documentation no local em que os componentes de gateway foraminstalados. Para obter mais informações, consulte “Instalando a Documentação doProduto Traduzida” na página 72.

Instalando fix packs do IBM CognosO IBM fornece pacotes de manutenção temporários que contêm atualizações paraum ou mais componentes para o seu produto IBM Cognos. Fix packs sãoatualizações de produto que contêm correções de códigos acumulativas realizadasdesde a última liberação do produto. Se um fix pack estiver disponível ao instalarou atualizar seu produto, é necessário instalá-lo após instalar os componentes doIBM Cognos. Os fix packs do IBM Cognos são instalados no mesmo local que oproduto existente.

Os fix packs são acumulativos. Quando se instala um fix pack, ele incluiatualizações de todos os fix packs anteriores. Os fix packs estão disponíveis paradownload a partir do Suporte IBM (www.ibm.com/support/entry/portal/overview).

Nota:

v Os fix packs não são instalações independentes. É necessário instalá-los noscomputadores que possuem componentes do IBM Cognos instalados. Instale osfix packs que são apropriados para sua versão do produto. Para verificar suaversão, abra o arquivo da lista de componentes no c10_location\cmplst.txt everifique a linha que inicia com C8PPCLIENT_version= para o PowerPlay Client eC8PPES_version= para a versão do servidor PowerPlay.

v Se você usou a opção Configuração Rápida para a instalação do Cognos BIoriginal (versão 10.2.2), isso significa que o DB2 Advanced Workgroup ServerEdition foi instalado e configurado como o banco de dados de armazenamentode conteúdo. A opção Configuração Rápida não estará disponível para instalar ofix pack. Use a opção de instalação do IBM Cognos Business Inteliigence Server.

Capítulo 6. Instalação e Configuração dos Componentes do Servidor em Diferentes Computadores 145

Page 158: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Além disso, os fix packs ou correções para o DB2 Advanced Workgroup ServerEdition precisarão ser instalados usando os métodos de instalação de fix pack doDB2.

Procedimento1. Acesse o local onde os arquivos de instalação foram transferidos por download

ou insira o disco se você tiver um.2. Inicie o assistente de instalação:

v Em computadores executando sistemas operacionais Linux ou UNIX, acesseo diretório do sistema operacional e execute ./issetup.

v Em computadores executando sistemas operacionais Microsoft Windows,acesse o diretório do sistema operacional e clique duas vezes emissetup.exe.

3. Siga as instruções do assistente de instalação para que os arquivos de fix packsejam instalados no mesmo local que os componentes do IBM Cognos.

4. Se necessário, atualize os novos arquivos de instalação com todas as mudançasdas cópias de backup de seus arquivos customizados.Para evitar erros, antes de copiar os arquivos customizados, compare ambas asversões dos arquivos. Esta validação determina se é possível substituir oarquivo.

5. Se você tiver um ambiente distribuído, repita estas etapas para todos osservidores IBM Cognos restantes.

Início do IBM Cognos ConfigurationUse IBM Cognos Configuration para configurar os componentes do IBM CognosBusiness Intelligence e iniciar e parar serviços do IBM Cognos.

Se você estiver usando um servidor de aplicativos diferente do fornecido, deve-seiniciar e parar os serviços do IBM Cognos por meio do servidor de aplicativos.

Antes de Iniciar

Antes de iniciar o IBM Cognos Configuration, certifique-se de que o ambienteoperacional esteja devidamente configurado. Por exemplo, certifique-se de quetodas as variáveis de ambiente foram definidas.

Em um sistema operacional Microsoft Windows, é possível iniciar o IBM CognosConfiguration na última página do assistente de instalação somente se não fornecessário fazer nenhuma configuração adicional. Por exemplo, se você usar umservidor de banco de dados que não seja Microsoft SQL ou Banco de dados deconteúdo do Cognos para o armazenamento de conteúdo, copie os drivers JavaDatabase Connectivity (JDBC) no local apropriado antes de iniciar a ferramenta deconfiguração.

Em sistemas operacionais UNIX ou Linux, não inicie oIBM Cognos Configurationna última página do assistente de instalação. Configuração adicional é necessáriaantes de ser possível configurar o IBM Cognos BI. Por exemplo, você deveatualizar seu ambiente Java.

Assegure-se de que a conta do usuário ou do serviço usada para executar o IBMCognos tenha sido configurada.

146 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 159: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Procedimento1. No Microsoft Windows, clique em Iniciar > IBM Cognos Configuration.

Se estiver usando um computador Windows Vista, Windows 7 ou Windows2008 e tiver instalado o produto no diretório Arquivos de Programas (x86),inicie o IBM Cognos Configuration como um Administrador.

2. Nos sistemas operacionais UNIX ou Linux, acesse o diretórioc10_location/bin64 e, em seguida, digite o seguinte comando:./cogconfig.sh

Se o IBM Cognos Configuration não abrir, certifique-se de que você configuroua variável de ambiente DISPLAY.Se você vir uma mensagem JAVA.Lang.unsatisfied link, verifique se estáusando uma versão suportada do Java.Se você vir uma mensagem Java.lang.unsupportedClassVersionError,certifique de que está usando uma versão de 64 bits do Java.

Configuração de propriedades de ambiente e de segurançapara computadores de gateway

Se instalar o componente de gateway em um computador diferente do ContentManager ou Application Tier Components, configure o computador do gatewaypara que saiba a localização de um dispatcher. Um dispatcher está instalado emcada computador com o Content Manager e Application Tier Components.Configure o gateway para utilizar o dispatcher em um computador comApplication Tier Components.

Para obter proteção de failover, configure mais de um dispatcher para umcomputador com gateway. Quando vários dispatchers estão configurados, assolicitações são normalmente roteadas para o primeiro dispatcher da lista. Se essedispatcher tornar-se indisponível, o gateway determinará o próximo dispatcherfuncional na lista e fará o roteamento de solicitações para ele. O status dodispatcher principal é monitorado pelo gateway, e as solicitações são roteadas devolta para esse componente quando retorna ao serviço.

Depois de executar as tarefas de configuração exigidas, o computador comgateway pode trabalhar no ambiente.

Antes de Iniciar

Verifique se os computadores onde o Content Manager foi instalado estãoconfigurados e o computador com o Content Manager ativo padrão está disponívelantes de configurar computadores com gateway.

Procedimento1. Inicie o IBM Cognos Configuration.2. Na janela Explorer, clique em Ambiente.3. Na janela Propriedades, em Configurações de Gateway, especifique os valores

de URIs de dispatchers do gateway:v Clique na coluna valor.v Clique no botão de edição.v Altere a porção localhost do URI para o nome ou endereço IP de um

computador com Application Tier Components.Isso garantirá que os usuários em locais diferentes possam se conectar arelatórios e áreas de trabalho enviados por e-mail.

Capítulo 6. Instalação e Configuração dos Componentes do Servidor em Diferentes Computadores 147

Page 160: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Dica: Se quiser enviar solicitações para o dispatcher a partir de umaplicativo Software Development Kit ou de uma ferramenta de modelagemIBM Cognos BI fora de um firewall de rede, conecte-se a um gatewaydedicado que esteja configurado para se conectar ao dispatcher usando oURI do dispatcher interno para o ambiente (por exemplo,http://localhost:9300/p2pd/servlet/dispatch). Por questões de segurança, aconfiguração padrão da propriedade URI de dispatchers de gateway impedeo dispatcher de aceitar solicitações para um aplicativo Software DevelopmentKit ou ferramenta de modelagem que esteja fora do firewall. Certifique-se deconfigurar a segurança apropriada para esse gateway dedicado, como SSL(consulte “Configurando o Protocolo SSL para Componentes do IBMCognos” na página 240). Não altere o gateway principal para utilizar o URIdo dispatcher interno. Isso reduzirá a segurança do portal e dos Studios doIBM Cognos BI.

v Se deseja adicionar outro URI, clique em Adicionar e altere a porçãolocalhost do novo URI para o nome ou endereço IP de outro computadorcom Application Tier Components.

Dica: Se quiser usar o dispatcher em um computador do Content Managerem espera, certifique-se de incluí-lo após incluir os computadores dosComponentes da Camada de Aplicativos. Se adicionar o dispatcher docomputador com Content Manager ativo, verifique se é o último da lista.

v Depois de especificar todos os URIs, clique em OK.4. Na janela Explorer, em Segurança > Criptografia, clique em Cognos, o

provedor de criptografia padrão.5. No grupo de propriedades Configuração da autoridade de certificação, defina

a propriedade Senha para coincidir com as configurações do computador comContent Manager ativo padrão.

6. Certifique-se de que as definições criptográficas coincidam com o que foidefinido 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 das chavessimétricas comuns (CSK).

8. No menu Arquivo, clique em Salvar.

Configurando o Servidor da WebVocê deve configurar o servidor da web antes que os usuários possam se conectarao portal IBM Cognos BI.

Para o IBM Cognos BI para relatórios, você também deve configurar a validade doconteúdo para o diretório de imagens em seu servidor da Web para que onavegador da Web não verifique o status da imagem após o primeiro acesso.

Nos sistemas operacionais UNIX e Linux, a conta sob a qual o servidor da web éexecutado deve ter acesso de leitura ao arquivo cogstartup.xml no diretórioc10_location/configuration. Por padrão, o arquivo cogstartup.xml tem permissãode leitura para outros. Se o servidor da web é executado em um grupo específico,é possível alterar as permissões do arquivo cogstartup.xml para garantir que elepertença ao mesmo grupo do servidor da web. É possível então remover apermissão de leitura para os outros.

148 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 161: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Usar Gateways Compilados para Sistemas de ProduçãoPara sistemas de produção, é possível melhorar o desempenho alterando ogateway a partir do gateway CGI padrão.

Os gateways compilados incluem:v Microsoft Internet Server Application Programming Interface (ISAPI) para

Microsoft Internet Information Services (IIS)v Módulo Apache para Servidor da Web Apache ou IBM HTTP Serverv Aplicativo Java do gateway de servlet, se desejar usar um servidor de

aplicativos para entregar as páginas do portal no lugar de um servidor da web

Usar Módulos Apache no Servidor Apache ou IBM HTTP Server:

É possível usar os módulos Apache para Apache Server 2.2.x ou Apache Server2.0.x ou para IBM HTTP Server 8, 7 ou 6.1.

Importante: Não é possível usar os módulos Apache com a versão do ApacheServer 2.2 que é fornecida com o Red Hat Enterprise Linux versão 5.3 e posterior.

Procedimento

1. Anexe o diretório c10_location/cgi-bin à variável de ambiente apropriada:v No Solaris ou Linux, LD_LIBRARY_PATHv Em HP-UX, SHLIB_PATH e LD_LIBRARY_PATHv No AIX, LIBPATH

2. Acesse o diretório Webserver_installation/conf.3. Abra o arquivo httpd.conf em um editor.4. Certifique-se de que tanto o nome do servidor quanto o número da porta de

servidor da web sejam especificados para a propriedade ServerName.5. Adicione o seguinte ao final da lista de carregamento de módulo:

LoadModule cognos_module "c10_location/cgi-bin/mod2_2_cognos.suffix"

Onde suffix é listado conforme a tabela a seguir.

Tabela 30. Sufixo de Módulo para o seu Sistema Operacional

Sistema operacional Sufixo

Windows dll

Solaris, AIX, HP-UX IA, Linux so

Módulos Apache são fornecidos para versões diferentes do Servidor Apacheou do IBM HTTP Server:v Use o módulo mod2_2_cognos para Apache Server 2.2.x ou IBM HTTP

Server 8 e 7.v Use o módulo mod2_cognos para o Servidor Apache 2.0.x e IBM HTTP

Server 6.1.6. Inclua o seguinte:

ScriptAlias /ibmcognos/cgi-bin "c10_location/cgi-bin"

<Directory "c10_location/cgi-bin">AllowOverride NoneOptions NoneOrder allow,denyAllow from all

</Directory>

Capítulo 6. Instalação e Configuração dos Componentes do Servidor em Diferentes Computadores 149

Page 162: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Alias /ibmcognos "c10_location/webcontent"

<Directory "c10_location/webcontent">Options Indexes MultiViewsAllowOverride NoneOrder allow,denyAllow from all

</Directory>

A diretiva <Directory> é opcional.

Nota: Assegure-se de definir o alias /ibmcognos/cgi-bin antes do alias/ibmcognos.

Importante: O ibmcognos é o valor padrão usado nos valores URI doGateway e URI do Controlador para o gateway no IBM CognosConfiguration. Se você não usar o ibmcognos para os valores de ScriptAlias eAlias, certifique-se de mudar os valores de URI do Gateway e URI doControlador para o gateway para corresponder aos valores que você usa.Também, certifique-se de utilizar o mesmo valor para a parte ibmcognos dosvalores ScriptAlias e Alias conforme mostrado nos exemplos.

7. Adicione o seguinte à seção de relatórios de status do servidor:<Location /ibmcognos/cgi-bin/module_alias>SetHandler cognos-handlerOrder allow,denyAllow from all</Location>

Onde module_alias for um nome que é possível escolher.8. 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_module_alias>SetHandler cognos-handlerOrder allow,denyAllow from all</Location>

Onde diag_module_alias for um nome que é possível escolher.9. Adicione o seguinte à seção de diretório do usuário:

<IfModule mod2_2_cognos.c>CGIBinDir "c10_location/cgi-bin"</IfModule>

Arquivos de módulo Apache são fornecidos por diferentes versões doServidor Apache ou do IBM HTTP Server:v Use mod2_2_cognos.c para Apache Server 2.2.x ou IBM HTTP Server 8 e 7.v Use mod2_cognos.c para Servidor Apache 2.0.x e IBM HTTP Server 6.1.

10. Salve e feche o arquivo.11. No HP-UX, ative a procura por SHLIB_PATH executando o seguinte comando

no diretório Apache_installation/bin:chatr +s enable +b enable httpd

12. Reinicie o servidor da Web.13. Inicie o IBM Cognos Configuration.14. No painel Explorer, clique em Configuração Local > Ambiente.15. Na caixa URI do Gateway, altere a parte cognos.cgi da URI para

module_alias.Por exemplo, http://host_name:port/ibmcognos/cgi-bin/module_alias.

150 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 163: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

16. Salve as mudanças.

Resultados

Os usuários podem acessar o servidor inserindo a URI do módulo do Apache emseu navegador. Por exemplo,

http://servername:port/ibmcognos/cgi-bin/module_alias.

Use o Gateway ISAPI no Microsoft Internet Information Services (IIS) Versão 7ou 8:

Se você estiver usando um servidor da web Microsoft Internet Information Services(IIS), configure o IBM Cognos para usar o gateway ISAPI em vez do gateway CGIpadrão.

Sobre Esta Tarefa

Se estiver usando o Microsoft IIS como seu servidor da web e planejar executarmais de um produto do IBM Cognos BI, ou várias instâncias do mesmo produto,em um computador, deverá criar um conjunto de aplicativos separado para cadaproduto ou instância e, em seguida, associar os aliases desse produto ou instânciapara o conjunto de aplicativos.

Para obter mais informações sobre como criar um conjunto de aplicativos, consultesua documentação do servidor da web.

Importante: Se você estiver usando a versão de 32 bits do gateway ISAPI, deveativar o aplicativo de 32 bits para o conjunto de aplicativos usado para o gatewaydo IBM Cognos. No Internet Information Services (IIS) Manager, selecione oconjunto de aplicativos usado para o IBM Cognos e clique em ConfiguraçõesAvançadas. Altere o valor para Ativar Aplicativos de 32 Bits para True.

Procedimento

1. No Painel de Controle do Microsoft Windows, clique em Programas >Programas e Recursos.Se estiver usando o Microsoft Windows 8 ou 2012 Server, Programas eRecursos está disponível diretamente no Painel de Controle.

2. Clique em Ativar ou desativar recursos.3. Se você estiver usando o Microsoft Windows 2008 Server, use as etapas a

seguir:a. Clique em Gerenciador de Servidor > Funções > Servidor da Web (IIS).b. Assegure que Recursos de HTTP Comuns, ou os recursos que você requer

são ativados.c. Se as extensões ISAPI estiverem configuradas para Não instaladas,

selecione extensões ISAPI e clique em Incluir Serviço de Função.4. Se você estiver usando o Microsoft Windows 2012 Server, use as etapas a

seguir:a. No Assistente Incluir Funções e Recursos, clique em Instalação baseada

em função ou em recurso, e clique em Avançar.b. Selecione seu servidor e clique em Avançar.

Capítulo 6. Instalação e Configuração dos Componentes do Servidor em Diferentes Computadores 151

Page 164: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

c. Selecione Web Server (IIS), se ele ainda não estiver instalado, assegure queRecursos HTTP Comuns está selecionado e clique em Avançar até chegarà seção Serviços de Função do assistente.

d. Expanda Desenvolvimento de Aplicativo.e. Selecione extensões ISAPI se ainda não estiver selecionado e clique em

Avançar.f. Clique em Instalar.

5. Se estiver usando o Microsoft Windows 7 ou 8, use as etapas a seguir:a. Selecione Internet Information Services se ainda não estiver selecionado.b. Expanda Internet Information Services > World Wide Web Services.c. Assegure que Recursos de HTTP Comuns, ou os recursos que você requer

são ativados.d. Expanda Recursos de Desenvolvimento de Aplicativo.e. Se asextensões ISAPI não estiverem selecionadas, selecione extensões

ISAPI.f. Clique em OK.

6. No console Gerenciador do Internet Information Services (IIS), emConexões, selecione seu nome de servidor.v Se você estiver usando o Microsoft Windows 2012 Server, no Gerenciador

de Servidor, selecione IIS, e depois dê um clique direito no nome do seuservidor e clique em Gerenciador do Internet Information Services (IIS).

v Se você estiver usando o Microsoft Windows 2008 Server, no Gerenciadorde Servidor, expanda Funções > Web Server (IIS), e depois clique emGerenciador do Internet Information Services (IIS).

v Caso esteja usando o Microsoft Windows 8, a partir do Painel de Controle,clique em Ferramentas Administrativas para acessar o console do InternetInformation Services (IIS) Manager.

v Caso esteja usando o Microsoft Windows 7, a partir do Painel de Controle,clique em Sistema e Segurança > Ferramentas Administrativas paraacessar o console do Internet Information Services (IIS) Manager.

7. Expanda Sites e em seu website, inclua os diretórios virtuais conformemostrado na tabela:

Tabela 31. Diretórios Virtuais Necessários

Alias Localização

ibmcognos c10_location/webcontent

ibmcognos/cgi-bin c10_location/cgi-bin

Importante: O ibmcognos é o valor padrão usado nos valores URI doGateway e URI do Controlador para o gateway no IBM CognosConfiguration. Se você não usar o ibmcognos para os valores de Alias,certifique-se de ter mudado para os valores URI do Gateway e URI doControlador para gateway para corresponder aos valores que você usa.

8. Selecione o diretório virtual cgi-bin que você criou.9. Clique duas vezes em Mapeamentos do Manipulador.

10. Sob Ações, clique em Incluir Mapeamento de Módulo.a. Em Solicitar Caminho, digite cognosisapi.dll.b. Em Módulo, selecione IsapiModule.c. Em Executável, insira o caminho para o arquivo cognosisapi.dll.

152 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 165: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Por exemplo, digite:C:\Program Files\ibm\cognos\c10\cgi-bin\cognosisapi.dll

d. Em Nome, insira um nome para a entrada, como CognosISAPI.e. Clique em OK.f. Clique em Sim na caixa de diálogo para permitir a extensão ISAPI.

11. Inicie o IBM Cognos Configuration.12. No painel Explorer, clique em Configuração Local > Ambiente.13. Na caixa URI do Gateway, altere a parte cognos.cgi da URI para

cognosisapi.dll.

Resultados

Os usuários podem acessar o gateway ISAPI inserindo http://servername/ibmcognos/isapi em seus navegadores da web.

Configurar o Gateway de Servlet para um Servidor de Aplicativos:

É possível usar o gateway de servlet para entregar as páginas do portal em vez dese usar um servidor da web.

Antes de Iniciar

Assegure-se de que as tarefas a seguir estejam concluídas:v O servidor de aplicativos está instalado e em execução em cada computador em

que o gateway de servlet está instalado.v Os componentes de gateway IBM Cognos BI estão instalados no mesmo sistema

que o servidor de aplicativos.v Os Componentes da Camada de Aplicativos IBM Cognos BI e Content Manager

estão instalados e em execução no ambiente.v A conta do usuário do servidor de aplicativos tem permissão de acesso total

para instalação IBM Cognos.

Sobre Esta Tarefa

Em vez de rotear solicitações diretamente para o dispatcher, implemente o gatewayde servlet para uma instância JVM (Java Virtual Machine) diferente das instânciasJVM que executam os servlets do IBM Cognos BI Application Tier Components eContent Manager. Executar esse tipo de implementação separa o carregamentopara entregar o conteúdo estático dos aplicativos principais.

Procedimento

1. Crie uma instância JVM separada, se necessário.Caso pretenda executar o IBM Cognos BI e o IBM Cognos Servlet Gateway nomesmo servidor de aplicativos, o gateway de servlet deverá ser implementadoem uma instância de JVM separada.

2. Verifique se os componentes do IBM Cognos estão configurados corretamente.3. Defina variáveis de ambiente.4. Configure IBM Cognos Servlet Gateway para execução no servidor de

aplicativos.5. Mudança do script de inicialização do servidor de aplicativos, se necessário.6. Configure propriedades do servidor de aplicativo e implemente o IBM Cognos

Servlet Gateway.

Capítulo 6. Instalação e Configuração dos Componentes do Servidor em Diferentes Computadores 153

Page 166: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

7. Ative o SSL, se necessário.

Resultados

Agora é possível acessar os componentes IBM Cognos usando o gateway de servletinserindo o URI do gateway. Por exemplo, http[s]:host_name:port/ServletGateway.

O URI do IBM Cognos Servlet Gateway faz distinção entre maiúsculas eminúsculas.

Usar o Gateway CGIÉ possível usar o gateway CGI no IBM HTTP Server, Apache Web Server ouMicrosoft Internet Information Services (IIS) Server.

Usar o gateway do CGI no Servidor Apache ou IBM HTTP Server:

O gateway padrão configurado no IBM Cognos Configuration e o gateway do CGI.Para usar o gateway do CGI, você deve configurar aliases para o Servidor Apacheou o IBM HTTP Server.

Procedimento

1. Acesse o diretório Webserver_installation/conf.2. Abra o arquivo httpd.conf em um editor.3. Certifique-se de que tanto o nome do servidor quanto o número da porta de

servidor da web sejam especificados para a propriedade ServerName.4. Inclua o seguinte:

ScriptAlias /ibmcognos/cgi-bin "c10_location/cgi-bin"

<Directory "c10_location/cgi-bin">AllowOverride NoneOptions NoneOrder allow,denyAllow from all

</Directory>

Alias /ibmcognos "c10_location/webcontent"

<Directory "c10_location/webcontent">Options Indexes MultiViewsAllowOverride NoneOrder allow,denyAllow from all

</Directory>

A diretiva <Directory> é opcional.

Nota: Assegure-se de definir o alias /ibmcognos/cgi-bin antes do alias/ibmcognos.

Importante: O ibmcognos é o valor padrão usado nos valores URI do Gatewaye URI do Controlador para o gateway no IBM Cognos Configuration. Se vocênão usar o ibmcognos para os valores de ScriptAlias e Alias, certifique-se demudar os valores de URI do Gateway e URI do Controlador para o gatewaypara corresponder aos valores que você usa. Também, certifique-se de utilizar omesmo valor para a parte ibmcognos dos valores ScriptAlias e Alias conformemostrado nos exemplos.

5. Salve e feche o arquivo.

154 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 167: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

6. Reinicie o servidor da Web.

Resultados

Os usuários podem acessar o portal em http://servername:port/ibmcognos.

Use gateway do CGI no Microsoft Internet Information Services (IIS) versão 7ou 8:

Se você estiver usando Microsoft Internet Information Services (IIS) versão 7 ouposterior, use a seguinte tarefa para configurar o gateway do CGI.

O gateway do CGI é fornecido para ambos os servidores da web, o de 32 bits e ode 64 bits.

Sobre Esta Tarefa

Caso esteja usando o Microsoft IIS como seu servidor da web e planeje executarmais do que um produto IBM Cognos BI ou várias instâncias do mesmo produto,em um computador, você deve criar um conjunto de aplicativos separado paracada produto ou instância e, em seguida, associar os aliases para este produto ouinstância para o conjunto de aplicativos.

Para obter informações adicionais sobre criação de um conjunto de aplicativo,consulte a documentação de seu servidor.

Procedimento

1. No Painel de Controle do Microsoft Windows, clique em Programas >Programas e Recursos.Caso esteja usando o Microsoft Windows 8 ou 2012 Server, o Programas eRecursos está disponível diretamente do Painel de Controle.

2. Clique em Ativar ou desativar recursos.3. Caso esteja usando o Microsoft Windows 2008 Server, use as etapas a seguir:

a. Clique em Gerenciador do Servidor > Funções > Servidor da Web (IIS).b. Assegure-se de que o Common HTTP Features ou os recursos solicitados

estejam ativados.c. Se CGI estiver configurado como Não Instalado, selecione CGI e clique

em Incluir Serviço de Função.4. Caso esteja usando o Microsoft Windows 2012 Server, use as etapas a seguir:

a. No Incluir Funções e Assistente de Recursos, clique em Instalação baseadaem função ou baseada em recursos, e clique em Avançar.

b. Selecione seu servidor e clique em Avançar.c. Selecione Servidor da Web (IIS), caso ele não esteja instalado ainda,

assegure-se de que o Common HTTP Features esteja selecionado e cliqueem Avançar até que você chegue à seção Serviços da Função do assistente.

d. Expanda Desenvolvimento de Aplicativo.e. Selecione CGI caso ele não esteja ainda selecionado e clique em Avançar.f. Clique em Instalar.

5. Caso esteja usando Microsoft Windows 7 ou 8, use as etapas a seguir:a. Selecione Internet Information Services caso ele ainda não esteja

selecionado.b. Expanda Internet Information Services > World Wide Web Services.

Capítulo 6. Instalação e Configuração dos Componentes do Servidor em Diferentes Computadores 155

Page 168: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

c. Assegure-se de que o Common HTTP Features ou os recursos solicitadosestejam ativados.

d. Expanda Recursos de Desenvolvimento de Aplicativo.e. Se CGI não estiver selecionado, selecione CGI.f. Clique em OK.

6. No console Gerenciador do Internet Information Services (IIS), emConexões, selecione seu nome de servidor.v Caso esteja usando o Microsoft Windows 2012 Server, no Server Manager,

selecione IIS e, em seguida, clique com o botão direito do mouse no nomede seu servidor e clique em Internet Information Services (IIS) Manager.

v Caso esteja usando o Microsoft Windows 2008 Server, no Gerenciador deServidor, expanda Funções > Web Server (IIS) e, em seguida, clique emInternet Information Services (IIS) Manager.

v Caso esteja usando o Microsoft Windows 8, a partir do Painel de Controle,clique em Ferramentas Administrativas para acessar o console do InternetInformation Services (IIS) Manager.

v Caso esteja usando o Microsoft Windows 7, a partir do Painel de Controle,clique em Sistema e Segurança > Ferramentas Administrativas paraacessar o console do Internet Information Services (IIS) Manager.

7. Clique duas vezes em Restrições ISAPI e CGI.8. Em Ações, clique em Incluir.9. Insira o caminho até o arquivo cognos.cgi. O arquivo está no diretório

c10_location\cgi-bin.Você deve inserir o caminho completo, incluindo o nome do arquivo. Se ocaminho incluir espaços, certifique-se de usar as aspas ao redor do caminho.Por exemplo, digite:“C:\Program Files\ibm\cognos\c10\cgi-bin\cognos.cgi”

10. Insira uma Descrição, como CognosCGI.11. Selecione Permitir que o caminho de extensão seja executado e clique em

OK.12. Em Conexões, expanda Sites e em seu website, inclua os diretórios virtuais

conforme mostrado na tabela:

Tabela 32. Diretórios Virtuais Necessários

Alias Local

ibmcognos c10_location/webcontent

ibmcognos/cgi-bin c10_location/cgi-bin

13. Selecione o diretório virtual cgi-bin que você criou.14. Clique duas vezes em Mapeamentos Manipuladores.15. Em Ações, clique em Incluir Mapeamento de Módulo.

a. Em Caminho de Solicitação, digite cognos.cgi.b. Em Módulo, selecione CgiModule.c. Deixe Executável (opcional) em branco.d. Em Nome, insira um nome para a entrada, tal como CognosCGI.e. Clique em OK.

156 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 169: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Resultados

Os usuários podem acessar o gateway CGI inserindo http://servername/ibmcognosem seus navegadores da web.

Use o gateway CGI em versões mais antigas do Microsoft IIS:

Para versões do Microsoft Internet Information Services (IIS) anteriores à versão 7,use estas etapas para configurar o gateway CGI.

Procedimento

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

Tabela 33. Diretórios Virtuais Necessários

Alias Localização Permissão

ibmcognos local_c10/webcontent Leitura

ibmcognos/cgi-bin local_c10/cgi-bin Execução

Importante: O ibmcognos é o valor padrão usado nos valores URI do Gateway eURI do Controlador para o gateway no IBM Cognos Configuration. Se você nãousar o ibmcognos para os valores de ScriptAlias e Alias, certifique-se de mudar osvalores de URI do Gateway e URI do Controlador para o gateway paracorresponder aos valores que você usa.

Configurando o WebDAV para Visualizar e Navegar pelasImagensPara visualizar e navegar pelas imagens no Report Studio, configure o WebDistributed Authoring and Versioning (WebDAV) em seu servidor da web. Osautores de relatório podem navegar pelas imagens para incluir nos relatórios deuma maneira semelhante à navegação pelo sistema de arquivos.

Configurando WebDAV em Servidores da Web Microsoft IIS:

Nos servidores da web Microsoft Internet Information Services (IIS), você deveprimeiro ativar o recurso WebDAV e, em seguida, configurar seu servidor da webpara acessar o local da imagem.

Procedimento

1. No Painel de Controle do Microsoft Windows, clique em Programas >Programas e Recursos.Se estiver usando o Microsoft Windows 8 ou 2012 Server, Programas eRecursos está disponível diretamente no Painel de Controle.

2. Clique em Ativar ou desativar recursos.3. Se você estiver usando o Microsoft Windows 2008 Server, use as etapas a

seguir:a. Clique em Gerenciador de Servidor > Funções > Servidor da Web (IIS).b. Na seção Serviços de Função, selecione Incluir Serviços de Função.c. Em Servidor da Web > Recursos HTTP Comuns, selecione Publicação

WebDAV.d. Clique em Avançar e, em seguida, clique em Instalar.

Capítulo 6. Instalação e Configuração dos Componentes do Servidor em Diferentes Computadores 157

Page 170: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

4. Se você estiver usando o Microsoft Windows 2012 Server, use as etapas aseguir:a. No Assistente de Incluir Funções e Recursos, clique em Instalação

baseada em função ou baseada em recurso, e clique em Avançar.b. Selecione seu servidor e clique em Avançar.c. Expanda Servidor da Web (IIS) > Servidor da Web > Recursos HTTP

Comuns, e selecione Publicação WebDAV.d. Clique em Avançar > Avançar, e depois clique em Instalar.

5. Se estiver usando o Microsoft Windows 7 ou 8, use as etapas a seguir:a. Expanda Internet Information Services > World Wide Web Services >

Recursos HTTP Comuns.b. Selecione Publicação WebDAV e clique em OK.

6. No console Gerenciador do Internet Information Services (IIS), emConexões, selecione seu nome de servidor.v Se você estiver usando o Microsoft Windows 2012 Server, no Gerenciador

de Servidor, selecione IIS, e depois dê um clique direito no nome do seuservidor e clique em Gerenciador do Internet Information Services (IIS).

v Se você estiver usando o Microsoft Windows 2008 Server, no Gerenciadorde Servidor, expanda Funções > Web Server (IIS), e depois clique emGerenciador do Internet Information Services (IIS).

v Se você estiver usando o Microsoft Windows 8, no Painel de Controle,clique em Ferramentas Administrativas para acessar o console doGerenciador do Internet Information Services (IIS).

v Se você estiver usando o Microsoft Windows 7, no Painel de Controle,clique em Sistema e Segurança > Ferramentas Administrativas paraacessar o console do Gerenciador do Internet Information Services (IIS).

7. Em Conexões, expanda seu servidor da web, Sites e selecione seu website.Por exemplo, selecione Website Padrão.

8. Dê um clique duplo em Autoria WebDAV.9. Clique em Ativar WebDAV.

10. Clique em Configurações de WebDAV.11. Se você tiver acesso anônimo ativado, selecione True para Permitir Consultas

de Propriedade Anônimas e clique em Aplicar.12. Selecione o diretório ou diretório virtual para o qual deseja permitir acesso ao

WebDAV.13. Dê um clique duplo em Autoria WebDAV.14. Clique em Incluir Regra de Autoria e inclua as regras apropriadas para o seu

ambiente. Por exemplo, se você instalou as amostras e deseja utilizar ocaminho padrão, sob o diretório virtual ibmcognos, expanda amostras, eselecione imagens e inclua uma regra de autoria para os arquivos de imagem.

15. Clique com o botão direito no diretório ou diretório virtual no qual incluiuregras de autoria e clique em Editar Permissões.

16. Clique em Segurança e inclua as permissões apropriadas. Por exemplo, sevocê permitir acesso anônimo para seu servidor da web, inclua permissõespara o usuário de acesso anônimo. Você pode localizar esse usuárioselecionando o website, dando um clique duplo em Autenticação evisualizando as propriedades para os usuários exibidos.

158 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 171: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Resultados

Com o WebDAV ativado, os usuários do Report Studio podem incluir imagens emseus relatórios. Quando os usuários clicam em Navegar no navegador de imagens,o local padrão para navegar é http://servername/ibmcognos/samples/images. Sevocê tiver criado outro local, os usuários podem inserir esse local.

Configurando o IIS com um tipo MIME para relatórios Ativos queusam JSONSe você usar o Microsoft Internet Information Services (IIS) como o servidor daweb, então, para suportar os relatórios Ativos contendo visualizações de lado docliente que usam JSON, deve-se definir o tipo JSON MIME para IIS.

Procedimento1. Abra o console de gerenciamento do Microsoft IIS.2. Selecione o nome do computador local.3. Clique em Tipos de MIME.4. Clique em Novo ou Incluir.5. Na caixa Extensão, digite .json.6. Na caixa Tipo MIME, digite application/json.

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

Procedimento1. Verifique se o servidor web está em execução.2. Abra um navegador web.3. Na caixa de endereço, digite URI do Gateway no IBM Cognos Configuration.

Por exemplo,http://host_name:port/ibmcognos

A página de Boas-vindas do portal do IBM Cognos BI aparece.

Instalando e Configurando a Migração no IBM CognosSeries 7

Antes que você possa usar o Migration Assistant no IBM Cognos PowerPlay paramigrar conteúdo do IBM Cognos Series 7 do PowerPlay Enterprise Server, Upfrontou IBM Cognos Connection, você deve instalar componentes de migração noscomputadores com o IBM Cognos Series 7. Os componentes de migração do IBMCognos Series 7 estão disponíveis no Microsoft Windows e no UNIX, no CD doIBM Cognos PowerPlay Server.

Use a lista de verificação a seguir para guiá-lo pelas tarefas para instalar econfigurar o IBM Cognos Migration__ v Instale os componentes de migração do IBM Cognos Series 7.__ v Configure os componentes de migração do IBM Cognos Series 7, se

necessário.__ v Inicie o serviço de migração do IBM Cognos Series 7.

Para obter informações sobre como migrar conteúdo do IBM Cognos Series 7 parao IBM Cognos BI, inclusive recomendações de configuração para o processo demigração, consulte o Guia de Migração e Administração do IBM Cognos PowerPlay.

Capítulo 6. Instalação e Configuração dos Componentes do Servidor em Diferentes Computadores 159

Page 172: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Instalar Componentes de Migração do IBM Cognos Series 7Certifique-se de que as instalações do IBM Cognos Series 7 estejam funcionandocorretamente antes de instalar os componentes de migração do IBM Cognos Series7. Isso inclui assegurar que o serviço do IBM Cognos Series 7 PowerPlayEnterprise Server e os serviços do Upfront, incluindo os serviços IBM CognosUpfront Administration Service, IBM Cognos Upfront Data Store e IBM CognosUpfront Dispatcher, estejam em execução.

Instale os componentes de migração do IBM Cognos Series 7 nos computadoresIBM Cognos Series 7.v Para migrar conteúdo de um PowerPlay Enterprise Server, você deve instalar

componentes de migração do IBM Cognos Series 7 no computador com oPowerPlay Enterprise Server. Se o Upfront estiver localizado no mesmocomputador também é possível migrar conteúdo do Upfront. A instalação decomponentes de migração no computador PowerPlay Enterprise Server tambémsuporta a migração de conteúdo PowerPlay publicado no Cognos Connection.

v Para migrar conteúdo do Upfront é necessário instalar o IBM Cognos Series 7Migration Components no computador Upfront. Quando o Upfront e oPowerPlay Enterprise Server forem instalados em computadores separados, vocêdeve instalar os componentes de migração do IBM Cognos Series 7 em ambos ocomputador com o PowerPlay Enterprise Server e o computador com o Upfront.Além disso, é necessário configurar uma localização de rede compartilhada parasuportar o processamento da migração.

Procedimento1. Insira o CD do IBM Cognos PowerPlay Server apropriado para seu sistema

operacional. No UNIX, é necessário montar o CD utilizando as extensões dearquivo Rock Ridge

2. Se a página Bem-vindo não aparecer, execute um dos procedimentos a seguir:v No Windows , no diretório win32 no CD, clique duas vezes no arquivo

issetup.exe.v Em UNIX, no diretório que é apropriado para o seu sistema operacional,

digite ./issetup

3. Selecione o idioma para utilizar na instalação.O idioma selecionado determina o idioma do assistente de instalação.

4. Siga as instruções do assistente de instalação.5. Na página Seleção do componente, desmarque todos os componentes, exceto

Componentes de migração do IBM Cognos Series 7.6. Na página Vários locais de instalação, especifique a localização do IBM

Cognos Series 7 para instalar os componentes.O IBM Cognos Series 7 Migration Components deve ser instalado no mesmodiretório do IBM Cognos Series 7 versão 4 (7.4).Se estiver instalando os componentes de migração do IBM Cognos Series 7 emum computador com o Microsoft Windows, o local de instalação deve ser umaunidade física e não uma unidade mapeada. Caso contrário, não será possíveliniciar o serviço de migração.Se for solicitado um local de instalação para o IBM Cognos BI, é possívelaceitar o local padrão ou inserir um novo local. Essa localização é usada paragravar arquivos instalados. Não é necessário inserir o caminho em umainstalação do IBM Cognos BI em um computador diferente e componentes doIBM Cognos BI não são necessários no computador com o IBM Cognos Series 7.

160 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 173: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

7. Na página Informações de configuração para migração, para o Número daporta do serviço de migração, digite o número da porta que o serviço demigração do IBM Cognos Series 7 deve usar. O padrão é 21567.

8. Na página Concluir , clique em Concluir.

Resultados

Assim como outros produtos IBM Cognos , o processo de instalação cria arquivosde log que incluem informações como detalhes sobre arquivos transferidos e errosde instalação. Os arquivos de log estão localizados no diretórioinstallation_location\instlog.

Configurando o Serviço de Migração em um AmbienteDistribuído do IBM Cognos Series 7Se tiver instalado componentes de migração do IBM Cognos Series 7 em umcomputador com o PowerPlay Enterprise Server e em um computador separadocom o Upfront, você deve definir e configurar um local de rede compartilhada. Oserviço de migração grava arquivos temporariamente neste local durante oprocesso de migração.

As limitações a seguir serão aplicadas à migração do Upfront quando o PowerPlayEnterprise Server e Upfront estiverem em computadores separados.

O PowerPlay Enterprise Server e o Upfront devem acessar PowerCubes usando omesmo caminho, como \\machine_name\cubes. Se os cubos estiverem localizadosno mesmo computador que o PowerPlay Enterprise Server, o PowerPlay EnterpriseServer acessará os cubos usando um caminho local e o Upfront acessará os cubosusando um caminho que inclua o nome do computador com o PowerPlayEnterprise. A migração do Upfront não funcionará nesta situação.

Procedimento1. Crie uma pasta em uma localização de rede compartilhada que esteja acessível

dos computadores PowerPlay Enterprise Server e Upfront.Assegure que os serviços para migração do PowerPlay Enterprise Server, doUpfront e do IBM Cognos Series 7 sejam executados sob contas denominadasque tenham acesso de gravação para a pasta.

2. Conclua as etapas a seguir em cada computador que inclua os componentes demigração do IBM Cognos Series 7.v No local_instalação/mig7service, abra o arquivo

migs7service_configuration.xml em um editor XML ou de texto.v 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 pastacompartilhada”>\\bott93\shareT\s7migration</series7-shared-location>

v Salve e feche o arquivo.3. Reinicie o serviço de migração do IBM Series 7.

Resultados

A configuração para suportar a migração de computadores PowerPlay EnterpriseServer e Upfront separados foi concluída.

Capítulo 6. Instalação e Configuração dos Componentes do Servidor em Diferentes Computadores 161

Page 174: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Início do Serviço de Migração do IBM Cognos Series 7Antes de migrar o conteúdo do IBM Cognos Series 7 PowerPlay para o IBMCognos PowerPlay, você deve iniciar o serviço de migração do IBM CognosSeries 7. No Windows, o serviço de migração do IBM Cognos Series 7 iniciaautomaticamente quando é instalado pela primeira vez.

Procedimento

Inicie o serviço de migração:v No Windows, se o serviço for interrompido, reinicie o serviço de migração

usando a entrada do IBM Cognos Migration Series 7 Service na lista Serviçosem Ferramentas Administrativas.

v No UNIX, acesse o diretório c10_location/migs7 e inicie o serviço digitando./configure.sh --start

162 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 175: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Capítulo 7. Instalando as Amostras do Cognos PowerPlay

Para usar as amostras, instale-as a partir do disco IBM Cognos BusinessIntelligence Samples ou do local no qual transferiu por download e extraiu osarquivos.

Sobre Esta Tarefa

As amostras incluem origens de dados, modelos, cubos, relatórios e outros tipos deconteúdo, para suportar todos os componentes do IBM Cognos BusinessIntelligence.

Procedimento1. Insira o disco de amostras do IBM Cognos ou acesse o local no qual os

arquivos de instalação foram transferidos por download e extraídos.2. Clique duas vezes no arquivo issetup.exe.

A página Bem-vindo do assistente de instalação aparece.3. Selecione o idioma para utilizar na instalação.4. Siga as instruções do assistente de instalação.

Instale as amostras em um diretório diferente dos outros componentes do IBMCognos PowerPlay.

O que Fazer Depois

Para configurar as amostras, você deve criar uma conexão de origem de dados eimportar as amostras. Depois de configurar as amostras, é possível usá-las paraaprender a usar o software Cognos PowerPlay.

Criando uma Conexão de Origem de Dados para Amostras doPowerCube

O IBM Cognos Business Intelligence PowerPlay usa as conexões de origem dedados para conectar-se às amostras do PowerCube e executar os relatórios deamostra ou usar os pacotes de amostra. Você deve criar uma conexão de origem dedados para que o IBM Cognos PowerCube use as amostras.

Procedimento1. Abra o IBM Cognos Administration conectando-se ao portal do IBM Cognos BI

e clicando em Administrar Conteúdo do IBM Cognos na página de BoasVindas.

2. Clique na guia Configuração e clique em Conexões de Origens de Dados.

3. Clique no ícone de nova origem de dados .4. 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.5. Na página de conexão, selecione IBM Cognos Power Cube.6. Na caixa de local, digite o caminho e o nome do arquivo para o

great_outdoors_sales_en.mdc. Por exemplo, se você estiver criando umaconexão para as amostras instaladas no local padrão no computador local,

© Copyright IBM Corp. 2005, 2014 163

Page 176: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

digite C:\Program_Files\ibm\cognos\c10\webcontent\samples\datasources\cubes\PowerCubes\EN\great_outdoors_sales_en.mdc.

7. Para confirmar que todos os parâmetros foram inseridos corretamente, cliqueem Testar a conexão.

8. Na página Concluir, não selecione Criar um Pacote.

Importando as Amostras do Cognos PowerPlayPara usar o pacote de amostras e outros conteúdos, você deve importá-los doarquivo de implementação de amostras.

Antes de Iniciar

Antes de importar o conteúdo, certifique-se de ter criado uma conexão de origemde dados ao IBM Cognos PowerCube.

Procedimento1. Copie o arquivo IBM_Cognos_PowerPlay.zip a partir do diretório

c10_location/webcontent/samples/content para o diretórioc10_location/deployment.

2. Conecte-se ao portal IBM Cognos BI e na página Bem-vindo, clique emAdministrar o IBM Cognos Content.

3. Na guia Configuração, clique em Administração de Conteúdo.4. Na barra de ferramentas, clique no botão Nova Importação.5. Na caixa Arquivo de Implementação, selecione IBM_Cognos_PowerPlay.6. Clique em Avançar.7. Na caixa Conteúdo de Pastas Públicas, selecione a pasta Samples.

Resultados

IBM_Cognos_PowerPlay aparece na Administração de Conteúdo e uma pastaSamples aparece nas Pastas Públicas no IBM Cognos Connection.

Testando um Relatório de AmostraPara testar se suas amostras foram importadas com êxito, abra um relatório deamostra no Cognos Viewer. O Cognos Viewer é o visualizador padrão quando umrelatório é aberto no IBM Cognos Connection.

Procedimento1. No IBM Cognos Administration, na barra de ferramentas, clique em Iniciar,

IBM Cognos Connection.2. Na lista Pastas públicas, abra Amostras, PowerPlay.3. Clique em great_outdoors_sales_en.4. Clique em qualquer relatório da lista. O relatório é aberto no IBM Cognos

Viewer.

164 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 177: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Capítulo 8. Configurando Componentes do IBM Cognos paraUsar um Provedor de Autenticação

Os componentes do IBM Cognos são executados com 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 utilizarsomente logon autenticado, desative o acesso anônimo.

Para o logon autenticado, você deve configurar os componentes do IBM Cognoscom um namespace apropriado para o tipo de provedor de autenticação em seuambiente. É possível configurar vários namespaces para autenticação e, emseguida, escolha no tempo de execução qual namespace deseja utilizar. Para obtermais informações, consulte o Guia de administração e segurança.

Os componentes do IBM Cognos suportam os seguintes tipos de servidores comofontes de autenticação:v Namespace do IBM Cognos Series 7v Servidor Active Directoryv Provedor de Autenticação Customizadav LDAPv CA SiteMinderv RACF

Se utilizar mais de um computador com Content Manager, configure provedoresde autenticação idênticos em cada local com o Content Manager. Isso significa queo tipo de provedor de autenticação selecionado e a forma como foi configuradodevem ser idênticos em todos os locais para todas as plataformas. A configuraçãodeve conter informações que sejam acessíveis a todos os Content Managers.

Quando o IBM Cognos é instalado em um único computador baseado em Linux,ou quando o Content Manager é instalado em um computador baseado em Linux,o IBM Cognos pode ser configurado para usar apenas servidores de diretóriocompatíveis com LDAP V3 e provedores customizados como fontes deautenticação.

Alguns provedores de autenticação requerem que bibliotecas externas para oambiente do IBM Cognos estejam disponíveis. Se essas bibliotecas não estiveremdisponí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árioinstalar o Content Manager em um computador Microsoft Windows:v Namespace do IBM Cognos Series 7v Servidor Active Directory

Se ativar a segurança, será preciso configurar definições de segurançaimediatamente depois de completar os processos de instalação e configuração. Paraobter mais informações, consulte o Guia de administração e segurança.

© Copyright IBM Corp. 2005, 2014 165

Page 178: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Importante: Não desative a segurança após ativá-la. Se excluir um namespace, aspreferências de usuário, as entradas de Minhas Pastas e de Minhas Páginas serãopermanentemente perdidas. Configurações de permissão existentes farão referênciaa usuários, grupos ou papéis que não mais existem. Embora isso não afete como aspermissões funcionam, um usuário administrando as configurações de permissãopode 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.

Após você configurar um provedor de autenticação para componentes do IBMCognos, é possível ativar a conexão única entre o ambiente do provedor deautenticação e os componentes do IBM Cognos. Isso significa que um usuário fazlogon uma vez e pode, depois, trocar para um outro aplicativo sem que precisefazer logon novamente.

Usuários podem selecionar namespaces quando efetuarem login no portal do IBMCognos. É possível ocultar namespaces Java Customizados e namespaces CASiteMinder dos usuários. Para obter mais informações, consulte “Ocultação donamespace dos usuários durante o login” na página 182.

Para utilizar um provedor de autenticação e para solicitar aos usuários que façamautenticação, faça o seguinte:__ v Desative o acesso anônimo, se necessário.__ v Configure os componentes do IBM Cognos para usar um provedor de

autenticação.

Desativação do acesso anônimoSe quiser usar apenas logon autenticado, é possível usar o IBM CognosConfiguration para desativar o acesso anônimo.

Por padrão, os componentes do IBM Cognos não requerem autenticação dousuário. Os usuários podem fazer logon anonimamente.

Procedimento1. Em cada local em que o Content Manager está 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 Cognos. O namespaceCognos armazena informações sobre grupos do IBM Cognos, como UsuárioAnônimo, contatos e listas de distribuição, além de fazer referência a objetosem outros namespaces de segurança. Para obter informações adicionais,consulte o Guia de Administração e Segurança do IBM Cognos Business Intelligence.

3. Na janela Propriedades, clique na caixa próxima à propriedade Permitir acessoanônimo e selecione Falso.

4. No menu Arquivo, clique em Salvar.

Resultados

Agora você deve configurar um namespace para que os usuários sejam obrigados afornecer credenciais de logon quando acessarem os recursos do IBM Cognos.

166 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 179: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Acesso de Usuário Restrito ao Namespace CognosÉ possível restringir o acesso para os usuários que pertencem a qualquer grupo oufunção definido no namespace integrado Cognos.

Por padrão, todos os usuários pertencem a vários grupos ou papéis internos. Pararestringir o acesso, faça o seguinte:v Ative a propriedade para restringir o acesso usando IBM Cognos Configuration.v Remova o grupo Todos das funções e grupos integrados usando IBM Cognos

Administration.v Certifique-se de que usuários autorizados pertençam a pelo menos uma função

ou grupo usando o IBM Cognos Administration.

Procedimento1. Em cada local do Content Manager, inicie o IBM Cognos Configuration.2. Na janela Explorer, em Segurança, clique emAutenticação.3. Na janelaPropriedades, altere o valor de Restringir o acesso de membros ao

namespace interno? para Verdadeiro.4. No menu Arquivo, clique em Salvar.

Resultados

Utilize agora o portal para remover o grupo Todos das funções e grupos internose, em seguida, assegure que usuários autorizados pertençam a pelo menos umpapel ou grupo interno.

Para obter informações sobre como incluir ou remover os membros de um grupoou uma função, consulte IBM Cognos Business Intelligence: Guia de Administração eSegurança.

Configurando Componentes do IBM Cognos para Usar o ActiveDirectory Server

Se instalar o Content Manager em um computador de sistema operacionalMicrosoft Windows, é possível configurar um namespace do Active Directory comouma fonte de autenticação.

Se instalar o Content Manager em um computador baseado em UNIX, você deveem vez disso usar um namespace do LDAP para configurar o Active Directorycomo sua fonte de autenticação. Se instalar um Content Manager em umacombinação de computadores Windows e UNIX, você deve usar um namespaceLDAP para configurar o Active Directory para todos os Content Managers. Aoutilizar o namespace de LDAP para autenticar em relação ao Servidor do ActiveDirectory, ficará limitado somente aos recursos do LDAP. Você não tem acesso arecursos do Active Directory, como propriedades avançadas para domínios econexão única com delegação de Kerberos.

Se instalar o Content Manager em um computador baseado em Linux, as mesmasrestrições se aplicam ao UNIX. É preciso utilizar um namespace do LDAP paraconfigurar o Active Directory como origem de autenticação.

Se quiser usar Microsoft SQL Server ou Microsoft Analysis Server como umaorigem de dados e usar conexão única para autenticação, você deverá usar oActive Directory como fonte de autenticação.

Capítulo 8. Configurando Componentes do IBM Cognos para Usar um Provedor de Autenticação 167

Page 180: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Não é possível conectar ao Catálogo global do Active Directory, que é um servidorde 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 porta389.

Procedimento1. Configure os componentes do IBM Cognos para usarem um namespace Active

Directory Server2. Ative a comunicação segura para o servidor do Active Directory, se necessário.3. Ative a conexão única entre o Active Directory e os componentes do IBM

CognosConceitos relacionados:“Ativar a Conexão Única entre o Active Directory Server e os Componentes doIBM Cognos” na página 172Por padrão, o provedor do Active Directory usa a autenticação do Kerberos. Eleintegra-se com o servidor da web Microsoft Internet Information Services (IIS) paraconexão única se a autenticação do Windows (anteriormente denominadaDesafio/Resposta do NT) estiver ativada no servidor da web IIS.Tarefas relacionadas:“Inclusão ou exclusão de domínios utilizando Propriedades avançadas” na página171Quando você configura um namespace de autenticação para IBM Cognos, osusuários de apenas um domínio podem efetuar login. Usando as propriedadesAvançadas para Active Directory Server, os usuários de domínios relacionados(pai/filho) e de árvores de domínios não relacionados na mesma floresta tambémpodem efetuar login.“Configurando um namespace do LDAP para o Active Directory Server” na página185Se configurar um novo namespace LDAP para uso com um Servidor do ActiveDirectory, será preciso modificar as configurações e alterar os valores para todas aspropriedades dos objetos do Active Directory.

Configurando um namespace do Active DirectoryÉ possível utilizar o Servidor do Active Directory como seu provedor deautenticação.

Você também tem a opção de disponibilizar propriedades de usuário customizadasa partir do Active Directory Server para componentes do IBM Cognos.

Antes de Iniciar

Para o IBM Cognos trabalhar corretamente com o Active Directory Server,certifique-se de que o grupo Usuários Autenticados tenha privilégios de Leiturapara a pasta do Active Directory em que os usuários estão armazenados.

Se estiver configurando um namespace do Active Directory para suportar conexãoúnica com uma origem de dados do Microsoft SQL Server ou Microsoft AnalysisServer, certifique-se da seguinte configuração:v O gateway do IBM Cognos está instalado em um servidor da Web IIS que está

configurado para Autenticação Integrada no sistema operacional MicrosoftWindows.

v O gateway é designado ao website intranet local em seu navegador da web.

168 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 181: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

v O Content Manager está instalado em um servidor Windows 2000 ou Windows2003.

v O Content Manager, os Componentes da Camada de Aplicativos, o servidor daweb IIS e o servidor de origem de dados (Microsoft SQL Server ou MicrosoftAnalysis Server) pertencem ao domínio do Active Directory.

v A conexão de origem de dados para o Microsoft SQL Server ou MicrosoftAnalysis Server está configurada para Namespace Externo e o namespace deveser o namespace do Active Directory.

Para obter informações adicionais sobre as origens de dados, consulte IBM CognosBusiness Intelligence: Guia de Administração e Segurança.

Procedimento1. Em cada local em que você instalou o Content Manager, abra o IBM Cognos

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

Autenticação e, em seguida, clique em Novo Recurso > Namespace.3. Na caixa Nome, digite um nome para o namespace de autenticação.4. Na lista Tipo, clique no namespace apropriado e clique em OK.

O novo recurso do provedor de autenticação aparece na janela Explorer, nocomponente Autenticação.

5. Na janela Propriedades, na propriedade ID do namespace, especifique umidentificador exclusivo para o namespace.

6. Especifique os valores para todas as outras propriedades necessárias paragarantir que os componentes do IBM Cognos possam localizar e usar seuprovedor 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 especificaro nome do domínio em vez de um controlador de domínio específico. Porexemplo, utilize mydomain.com:389 em vez de dc1.mydomain.com:389.

8. Se desejar procurar detalhes quando a autenticação falhar, especifique a ID esenha do usuário para a propriedade Credenciais de ligação.Utilize as credenciais de um usuário do Servidor do Active Directory quetenha privilégios de busca e leitura para esse servidor.

9. No menu Arquivo, clique em Salvar.10. Teste a conexão em um novo namespace. Na janela Explorer, em

Autenticação, clique com o botão direito no novo recurso de autenticação eclique em Testar.É solicitado que insira credenciais para um usuário no namespace paraconcluir o teste.Dependendo de como o namespace está configurado, será possível inserir umID do usuário e senha válidos para um usuário no namespace ou o DN e asenha de usuário de ligação.

Resultados

IBM Cognos carrega, inicializa e configura as bibliotecas do provedor para onamespace.

Capítulo 8. Configurando Componentes do IBM Cognos para Usar um Provedor de Autenticação 169

Page 182: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Disponibilizando Propriedades de Usuário Customizadas parao Active Directory para Componentes do IBM Cognos

É possível usar atributos de usuário arbitrários do Active Directory Server noscomponentes do IBM Cognos. Para tal configuração, é preciso adicionar essesatributos como propriedades customizadas para o namespace do Active Directory.

As propriedades customizadas estão disponíveis como parâmetros de sessão noFramework Manager. Para obter informações adicionais sobre os parâmetros desessão, consulte o Guia do Usuário do Framework Manager

Utilize também as propriedades customizadas dentro dos blocos de comando paraconfigurar sessões e conexões do Oracle. Utilize blocos de comando com conexõesleves do Oracle e bancos de dados privados virtuais. Para obter informaçõesadicionais, consulte o Guia de Administração e Segurança do IBM Cognos BusinessIntelligence.

Procedimento1. Em cada local em que você instalou o Content Manager, abra o IBM Cognos

Configuration.2. Na janela Explorer, em Segurança > Autenticação, clique no namespace do

Active Directory.3. Na janela Propriedades, clique na coluna Valor para Propriedades

Customizadas e clique no ícone de edição.4. Na janela Valor - Propriedades customizadas, clique em Adicionar.5. Clique na coluna Nome e digite o nome que você quer que os componentes do

IBM Cognos usem para o parâmetro de 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 customizada.8. Clique em OK.9. No menu Arquivo, clique em Salvar.

Ativação da comunicação segura para o Servidor do ActiveDirectory

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

Procedimento1. Em cada computador com Content Manager, utilize o navegador web para

conectar ao Servidor do Active Directory e copie o certificado raiz da CA paraum local com o Content Manager.

2. Inclua o certificado raiz CA no armazenamento de certificados da conta quevocê está usando para a atual sessão do IBM Cognos:v Se estiver executando a sessão do IBM Cognos sob uma conta do usuário,

use o mesmo navegador da Web da etapa 1 para importar o certificado raizCA no armazenamento de certificados para sua conta do usuário.Para obter informações, consulte a documentação de seu navegador web.

v Se estiver executando a sessão do IBM Cognos sob a conta local, use oMicrosoft Management Console (MMC) para importar o certificado raiz CAno armazenamento de certificados para o computador local.

170 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 183: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Para obter mais informações, consulte a documentação do MMC.3. No IBM Cognos Configuration, reinicie o serviço:

v Na janela Explorer, clique em Serviço do IBM Cognos, IBM Cognos.v No menu Ações, clique em Reiniciar.

Inclusão ou exclusão de domínios utilizando Propriedadesavançadas

Quando você configura um namespace de autenticação para IBM Cognos, osusuários de apenas um domínio podem efetuar login. Usando as propriedadesAvançadas para Active Directory Server, os usuários de domínios relacionados(pai/filho) e de árvores de domínios não relacionados na mesma floresta tambémpodem efetuar login.

Se você configurar um parâmetro denominado chaseReferrals como true, osusuários no domínio autenticado original e todos os domínios-filhos da árvore dedomínio poderão efetuar login no IBM Cognos. Os usuários de um domínio pai dodomínio autenticado original ou em uma árvore de domínio diferente não podemefetuar login.

Se você configurar o parâmetro denominado MultiDomainTrees como true, osusuários em todas as árvores de domínio na floresta poderão efetuar login no IBMCognos.

Procedimento1. Em cada local em que você instalou o Content Manager, abra o IBM Cognos

Configuration.2. Na janela Explorer, em Segurança > Autenticação, clique no namespace do

Active Directory.3. Na janela Propriedades, especifique a propriedade Host e porta:

v Para usuários em um domínio, especifique o host e a porta de umcontrolador de domínio para o domínio único.

v Para usuários em uma árvore de domínio, especifique o host e a porta docontrolador de nível superior para a árvore de domínio.

v Para usuários em todas as árvores de domínio na floresta, especifique o hoste a porta de qualquer controlador de domínio na floresta.

4. Clique na coluna Valor de Propriedades Avançadas e clique no ícone 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 seguinte tabela:

Tabela 34. Configurações de Propriedades Avançadas

Autenticação para chaseReferrals MultiDomainTrees

Um domínio Falso Falso

Uma árvore de domínio Verdadeiro Falso

Todas as árvores de domíniona floresta

Verdadeiro Verdadeiro

7. Clique em OK.

Capítulo 8. Configurando Componentes do IBM Cognos para Usar um Provedor de Autenticação 171

Page 184: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

8. No menu Arquivo, clique em Salvar.Tarefas relacionadas:“Configurando Componentes do IBM Cognos para Usar o Active Directory Server”na página 167Se instalar o Content Manager em um computador de sistema operacionalMicrosoft Windows, é possível configurar um namespace do Active Directory comouma fonte de autenticação.

Autenticando Árvores de DomínioProcedimento1. Em cada local em que você instalou o Content Manager, abra o IBM Cognos

Configuration.2. Na janela Explorer, em Segurança > Autenticação, clique no namespace do

Active Directory.3. Na janela Propriedades, especifique a propriedade Host e porta:

v Para usuários em um domínio, especifique o host e a porta de umcontrolador de domínio para o domínio único.

v Para usuários em uma árvore de domínio, especifique o host e a porta docontrolador de nível superior para a árvore de domínio.

v Para usuários em todas as árvores de domínio na floresta, especifique o hoste a porta de qualquer controlador de domínio na floresta.

4. Clique na coluna Valor de Propriedades Avançadas e clique no ícone 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 seguinte tabela:

Tabela 35. Propriedades para Configuração de Árvores de Domínio de Autenticação

Autenticação para chaseReferrals MultiDomainTrees

Um domínio Falso Falso

Uma árvore de domínio Verdadeiro Falso

Todas as árvores de domíniona floresta

Verdadeiro Verdadeiro

7. Clique em OK.8. No menu Arquivo, clique em Salvar.

Ativar a Conexão Única entre o Active Directory Server e osComponentes do IBM Cognos

Por padrão, o provedor do Active Directory usa a autenticação do Kerberos. Eleintegra-se com o servidor da web Microsoft Internet Information Services (IIS) paraconexão única se a autenticação do Windows (anteriormente denominadaDesafio/Resposta do NT) estiver ativada no servidor da web IIS.

Se a autenticação do Windows for ativada, será solicitado que reinsira asinformações de autenticação ao acessar o conteúdo do IBM Cognos que éassegurado pelo namespace do Active Directory.

172 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 185: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Se usar a autenticação do Kerberos, será possível escolher usar o Service for User(S4U). O S4U permite que os usuários acessem o IBM Cognos BI a partir decomputadores que não estejam no domínio do Active Directory. Para ativar o S4U,você deve usar a delegação restrita.

Por exemplo, tenha usuários cujos computadores não pertençam ao domínio, masque tenham a conta de domínio. Quando eles abrem seus navegadores da web, sãopromovidos para sua conta de domínio. No entanto, eles obtêm o ticket Kerberosapenas com o privilégio de Identidade, que evita que eles sejam autenticados paraIBM Cognos BI. Para resolver esse problema, é possível usar o S4U.

Se não desejar a autenticação do Kerberos, será possível configurar o provedorpara acessar a variável de ambiente REMOTE_USER para atingir a conexão única.

Importante: Certifique-se de usar apenas a variável REMOTE_USER. Utilizar outravariável pode causar uma vulnerabilidade de segurança.

Para ativar a conexão única para usar a autenticação do Kerberos, você devegarantir a conclusão das seguintes tarefas:1. Configure a autenticação do Windows no servidor da web Microsoft IIS para o

aplicativo ibmcognos/cgi-bin.2. Instale o Content Manager em um computador que faça parte do domínio do

Active Directory para os Content Managers ativo e em espera.3. Configure os computadores, ou a conta de usuário na qual o Content Manager

é executado, para que sejam confiáveis.

Para obter mais informações, consulte os seguintes documentos de nota técnica:v Nota técnica Ativando a conexão única para o CRN ou Cognos protegida contra

o Active Directory (www.ibm.com/support/docview.wss?uid=swg21341889)v Nota técnica Ao usar conexão única (SSO) do Kerberos com Active Directory no

Cognos, é solicitado que o usuário forneça credenciais (www.ibm.com/support/docview.wss?uid=swg21659267)

Tarefas relacionadas:“Configurando Componentes do IBM Cognos para Usar o Active Directory Server”na página 167Se instalar o Content Manager em um computador de sistema operacionalMicrosoft Windows, é possível configurar um namespace do Active Directory comouma fonte de autenticação.

Ativando a Conexão Única para Usar a Autenticação doKerberosSe o servidor da web IIS for configurado para a autenticação do Windows, nãoserá necessário incluir nenhuma configuração adicional. A autenticação doKerberos é usada como o padrão.

Ativando a Conexão Única para Usar a Autenticação doKerberos com a Delegação RestritaPara poder usar a delegação restrita, você deve definir os nomes principais doserviço (SPN) para os usuários configurados para executar os componentes doIBMCognos e o conjunto de aplicativos da web do Microsoft Internet InformationServices (IIS) no domínio do Diretório Ativo.

Capítulo 8. Configurando Componentes do IBM Cognos para Usar um Provedor de Autenticação 173

Page 186: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Se usar o Kerberos com a delegação restrita, você deverá incluir um usuário dosAMAccountName para o Content Manager ao configurar o gateway. Todos osContent Managers ativos e de espera devem ser configurados para seremexecutados na mesma conta.

Se estiver configurando a conexão única para os servidores do banco de dados,você deverá configurar o sAMAccountName para o usuário que executa osComponentes da Camada de Aplicativos ao incluir o namespace do ActiveDirectory. Todos os Componentes da Camada de Aplicativos devem serconfigurados para serem executados na mesma conta.

Os SPNs são os usuários inseridos nos campos do sAMAccountName na Configuraçãodo IBM Cognos.

Por exemplo, suponha que tenha um usuário que executa o componente doContent Manager, outro que executa os Componentes da Camada de Aplicativos eoutro que executa o conjunto de aplicativos do servidor da web. O usuário doContent Manager é CognosCMUser. O usuário dos Componentes da Camada deAplicativos é CognosATCUser. O usuário do conjunto de aplicativos é IISUser. Cadausuário está no domínio MyDomain.1. Você deve configurar o IIS para que o MyDomain\IISUser seja a identidade do

conjunto de aplicativos2. Execute o comando setspn para o computador em que o IIS está sendo

executado.Por exemplo:setspn -A http/IISServerName MyDomain\IISUsersetspn -A http/IISServerName.MyDomain.com MyDomain\IISUser

3. Execute o comando setspn para os usuários do IBM Cognos.Por exemplo:setspn -A ibmcognosba/CognosCMUser MyDomain\CognosCMUsersetspn -A ibmcognosba/CognosATCUser MyDomain\CognosATCUser

Nesses comandos, você deve usar o ibmcognosba conforme mostrado nosexemplos. Os nomes de usuários e os domínios devem corresponder a seuambiente.

Nota: Neste exemplo, os usuários do sAMAccountName que você deve inserir sãoCognosCMUser e CognosATCUser.

4. Se estiver configurando a conexão única para o servidor de banco de dados doMicrosoft SQL Server ou do Microsoft SQL Server Analysis Services, você deveconfigurar o SPN para o servidor de banco de dados. Para obter maisinformações, consulte a documentação do servidor de banco de dados.

5. Finalmente, você deve configurar a delegação restrita nos Usuários do ActiveDirectory e na Ferramenta de administração do computador. Na guiaDelegação de todos os usuários (IISUser, CognosCMUser e CognosATCUser), vocêdeve selecionar Confiar neste usuário para delegação somente a serviçosespecificados e Usar somente o Kerberos para usar o Kerberos com adelegação restrita. Selecione Confiar neste usuário para delegação somente aserviços especificados e Usar o protocolo de autenticação se estiver usando aextensão do Kerberos do S4U.Em seguida, você deve incluir os SPNs necessários. Por exemplo, incluaibmcognosba como um tipo de serviço. Em seguida, inclua DomainController1 eDomainController2 como um tipo de serviço ldap.

174 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 187: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Se estiver configurando a conexão única para a origem de dados, inclua oserviço MSOLAPSvc3 ou MSQLSVC.

Procedimento1. No computador em que você instalou o Content Manager, abra o IBM Cognos

Configuration.2. Na janela Explorer, em Segurança > Autenticação, e selecione o namespace

Active Directory.3. Clique na coluna Valor de Propriedades avançadas e, em seguida, clique no

ícone 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, insira um dos valores a seguir:

v Insira KerberosS4UAuthentication se você desejar usar a autenticação doKerberos primeiro. Se o Kerberos falhar, a autenticação Service For User(S4U) será tentada. Se S4U falhar, serão solicitadas as credenciais para ousuário.

v Insira S4UAuthentication se você desejar usar a autenticação S4U primeiro.Se S4U falhar, serão solicitadas as credenciais para o usuário.

7. Na caixa de diálogo Valor - Propriedades avançadas, clique em Adicionar.8. Na coluna Nome, digite trustedCredentialType.9. Na coluna Valor, insira um dos valores a seguir:

v Insira CredentialForTC se você desejar salvar as credenciais do usuáriocomo uma credencial confiável. Por exemplo, se você desejar usar ascredenciais para executar as tarefas planejadas.

v Insira S4UForTC se você desejar salvar apenas o nome de usuárioautenticado como uma credencial confiável. O nome do usuário é salvo noformato UPN e as tarefas planejadas podem ser executadas com o UPN semrequerer a senha do usuário.

10. Clique em OK.11. Clique na coluna Valor para sAMAccountName dos Componentes da

Camada de Aplicativos e insira o sAMAccountName do usuário que executa osComponentes da Camada de Aplicativos.

Importante: Esse valor será necessário somente se estiver configurando aconexão única do servidor de banco de dados do Microsoft SQL Server ou doMicrosoft SQL Server Analysis Services. Se não estiver configurando a conexãoúnica para o servidor de banco de dados, não altere esse valor.

12. Clique em Arquivo > Salvar.13. Reinicie o serviço do IBM Cognos.14. No computador em que você instalou os componentes do Gateway, abra o

IBM Cognos Configuration.15. Na janela Explorer, clique em Ambiente.16. Clique na coluna Valor para sAMAccountName do Content Manager e insira

o sAMAccountName do usuário que executa o Content Manager.17. Clique em Arquivo > Salvar.

Ativando a conexão única entre os componentes do ActiveDirectory Server e do IBM Cognos para usar o REMOTE_USERSe não desejar a autenticação do Kerberos, será possível configurar o provedorpara acessar a variável de ambiente REMOTE_USER para atingir a conexão única.

Capítulo 8. Configurando Componentes do IBM Cognos para Usar um Provedor de Autenticação 175

Page 188: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Você deve configurar a propriedade avançada singleSignOnOption no valorIdentityMapping. É preciso também especificar credenciais de ligação para onamespace do Active Directory.

O Microsoft IIS configura o REMOTE_USER por padrão ao ativar a autenticação doWindows. Se a autenticação do Kerberos não for usada, a conexão única com asorigens de dados do Microsoft OLAP (MSAS) não será possível.

Ao definir o REMOTE_USER, também é possível escolher salvar o REMOTE_USER comouma credencial confiável. Salvar como uma credencial confiável significa que astarefas planejadas autenticam o REMOTE_USER com os privilégios da Credencial deLigação.

Importante: Certifique-se de usar apenas a variável REMOTE_USER. Utilizar outravariável pode causar uma vulnerabilidade de segurança.

Procedimento1. No computador em que você instalou o Content Manager, abra o IBM Cognos

Configuration.2. Na janela Explorer, em Segurança > Autenticação, e selecione o namespace

Active Directory.3. Clique na coluna Valor de Propriedades avançadas e, em seguida, clique no

ícone 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. Se você desejar salvar o REMOTE_USER como uma credencial confiável, na

caixa de diálogo Valor - Propriedades Avançadas, clique em Incluir.8. Na coluna Nome, digite trustedCredentialType.9. Na coluna Valor, digite IdentityMappingForTC.

10. Clique em OK.11. Clique na coluna Valor para Credenciais de Ligação e, em seguida, clique no

ícone de edição.12. Na caixa de diálogo Valor - Credenciais de ligação, especifique uma ID do

usuário e senha e, em seguida, clique em OK.

Configurando o IBM Cognos para Usar Namespace IBM Cognos Series7

É possível configurar componentes do IBM Cognos para usar um namespace IBMCognos Series 7 como o provedor de autenticação. Os usuários são autenticadoscom base na autenticação e configuração de conexão do namespace do IBMCognos Series 7.

Um namespace IBM Cognos Series 7 é necessário se você quiser usar os modelosde PowerCubes e do Transformer do IBM Cognos Series 7 no IBM CognosBusiness Intelligence. O namespace deve estar configurado antes de carregar osmodelos do Transformer.

Nota: Não é possível usar um arquivo Local Authentication Export (LAE) do IBMCognos Series 7 para autenticação com componentes do IBM Cognos.

176 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 189: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

É possível configurar componentes do IBM Cognos para usar diversos provedoresde autenticação do IBM Cognos Series 7. Todos os namespaces IBM Cognos Series7 devem usar o mesmo Servidor do Chamado principal do IBM Cognos Series 7.Caso contrário, é possível receber erros ou solicitações de autenticação mais deuma vez. Para manter o desempenho, verifique também se o Ticket Server está emexecução.

Se alterar as informações de configuração armazenadas no servidor de diretóriousado para o IBM Cognos Series 7, você deve reiniciar o serviço do IBM Cognosantes de as mudanças entrarem em vigor na instalação do IBM Cognos.

Um usuário deve estar em pelo menos uma classe de usuário do Access Managerpara efetuar logon nos componentes do IBM Cognos.

Procedimento1. Configurar um Namespace do Series 72. Ative a comunicação segura para o servidor de diretório usado pelo namespace

IBM Cognos Series 7, se necessário3. Ative conexão única entre o IBM Cognos Series 7 e o IBM Cognos

Configurando um namespace do IBM Cognos Series 7É possível configurar o IBM Cognos para usar um ou mais namespaces IBMCognos Series 7 para autenticação.

Procedimento1. Em cada local em que você instalou o Content Manager, abra o IBM Cognos

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

Autenticação e, em seguida, clique em Novo Recurso > Namespace.3. Na caixa Nome, digite um nome para o namespace de autenticação.4. Na lista Tipo, clique no namespace apropriado e clique em OK.

O novo recurso do provedor de autenticação aparece na janela Explorer, nocomponente Autenticação.

5. Na janela Propriedades, na propriedade ID do namespace, especifique umidentificador exclusivo para o namespace.

6. Especifique os valores para todas as outras propriedades necessárias paragarantir que os componentes do IBM Cognos possam localizar e usar seuprovedor de autenticação existente.Se a versão de seu namespace IBM Cognos Series 7 for 16.0, assegure que apropriedade Codificação de Dados esteja configurada para UTF-8. Alémdisso, os locais onde o Content Manager está instalado devem usar o mesmocódigo do idioma que os dados no namespace IBM Cognos Series 7.O valor do host pode ser um nome de servidor ou um endereço IP. Se estiverpublicando a partir do PowerPlay Enterprise Server para o IBM Cognos BI,você deve usar o mesmo formato de valor usado no IBM Cognos Series 7Configuration Manager para o local do servidor de diretório. Por exemplo, seo nome do servidor for usado no Gerenciador de Configuração do IBMCognos Series 7, você também deve usar o nome do servidor no IBM CognosConfiguration para o IBM Cognos BI.

7. Se seu ambiente de namespace incluir a versão 15.2 do namespace IBMCognos Series 7, você deve desativar a configuraçãoSeries7NamespacesAreUnicode.

Capítulo 8. Configurando Componentes do IBM Cognos para Usar um Provedor de Autenticação 177

Page 190: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

v Na janela Propriedades, no valor Propriedades Avançadas, clique no íconede edição.

v Na janela Valor - Propriedades avançadas, clique em Adicionar.v Na caixa Nome, digite Series7NamespacesAreUnicode.v Na caixa Valor, digite Falso e depois clique em OK.

8. Na janela Propriedades, nas Configurações de cookies, assegure-se de que aspropriedades Caminho, Domínio e Sinalizador seguro ativado, correspondaàs configurações configuradas para o IBM Cognos Series 7.

9. No menu Arquivo, clique em Salvar.10. Teste a conexão em um novo namespace. Na janela Explorer, em

Autenticação, clique com o botão direito no novo recurso de autenticação eclique em Testar.É solicitado que insira credenciais para um usuário no namespace paraconcluir o teste.Dependendo de como o namespace está configurado, será possível inserir umID do usuário e senha válidos para um usuário no namespace ou o DN e asenha de usuário de ligação.

Ativando Comunicação Segura para o Servidor de DiretórioUsado pelo Namespace IBM Cognos Series 7

Se estiver usando uma conexão SSL para o Servidor de Diretório usado pelonamespace IBM Cognos Series 7, você deve copiar o certificado do Servidor deDiretório para o local de cada Content Manager.

Para obter mais informações, consulte o Guia do Administrador do IBM CognosAccess Manager e a documentação do Directory Server.

Ativando Conexão Única entre o IBM Cognos Series 7 e o IBMCognos

Se seu namespace IBM Cognos Series 7 tiver sido configurado para integração comseus mecanismos de autenticação externa para conexão única, o provedor do IBMCognos Series 7 usará automaticamente essa configuração.

Ao configurar conexão única, não será solicitado reinserir informações deautenticação ao acessar o conteúdo do IBM Cognos assegurado pelo namespaceIBM Cognos Series 7.

Procedimento1. Assegure-se de que os componentes do IBM Cognos tenham sido configurados

para usar um namespace IBM Cognos Series 7 como um provedor deautenticação.

2. Para o IBM Cognos Series 7, inicie o Gerenciador de Configuração.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, assegure-se de que as propriedades Caminho,

Domínio e Sinalizador Seguro Ativado correspondam às definiçõesconfiguradas para o IBM Cognos BI.

6. Salve e feche o Configuration Manager.

178 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 191: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

7. Se o namespace IBM Cognos Series 7 usar o plug-in de Conexão Confiável paraconexão única, você deve definir agora a funçãoSaferAPIGetTrustedSignonWithEnv.

Resultados

Agora é possível incluir NewsBoxes do IBM Cognos Upfront Series 7 nas páginasde portal do IBM Cognos Connection.

Namespaces IBM Cognos Series 7 e o Plug-in de ConexãoConfiável do IBM Cognos Series 7

Se o namespace IBM Cognos Series 7 usar o plug-in de Conexão Confiável paraconexão única, você deve definir a função SaferAPIGetTrustedSignonWithEnv emseu plug-in. Em seguida, você deverá recompilar e reimplementar a biblioteca paraobter uma conexão única entre os componentes do IBM Cognos e seu mecanismode autenticação.

A função SaferAPIGetTrustedSignonWithEnv é uma versão atualizada da funçãoSaferAPIGetTrustedSignon. Essa atualização é necessária, pois o logon do IBMCognos não é executado no servidor da Web, como é o caso para aplicativos IBMCognos Series 7. Portanto, não é possível para o plug-in fazer uma chamadagetenv() API para recuperar variáveis de ambiente do servidor web. O plug-inpode solicitar que variáveis de ambiente específicas sejam removidas do servidorweb utilizando a função SaferAPIGetTrustedSignonWithEnv.

Se você estiver executando produtos IBM Cognos Series 7 e IBM Cognos usando omesmo plug-in, as funções SaferAPIGetTrustedSignonWithEnv eSaferAPIGetTrustedSignon são necessárias. Para obter informações sobre a funçãoSaferAPIGetTrustedSignon, consulte a documentação do IBM Cognos Series 7.

Função SaferAPIGetTrustedSignonWithEnvPara que os usuários sejam autenticados com sucesso pelo Access Manager, ossignons 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 AccessManager 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 oSaferAPIFreeBuffer() para liberar a memória alocada.

Implemente tanto a função SaferAPIGetTrustedSignon como a SaferAPIFreeBufferpara registrar com sucesso a biblioteca quando oSaferAPIGetTrustedSignonWithEnv 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]*/

Capítulo 8. Configurando Componentes do IBM Cognos para Usar um Provedor de Autenticação 179

Page 192: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

unsigned long *trustedDomainNameLength, /*[OUT]*/

SAFER_USER_TYPE *userType, /*[OUT]*/

void **implementerData); /*[IN/OUT]*/

Parâmetros para a função SaferAPIGetTrustedSignonWithEnv

Tabela 36. Parâmetros e Descrição para a Função SaferAPIGetTrustedSignonWithEnv

Parâmetro Descrição

[in] envVar Uma matriz de nomes e valores de variável de ambienteque foram recuperados do servidor da Web. O final damatriz é representado por uma entrada com umenvVarName nula e um envVarValue nula. Observe que naprimeira vez que essa API é chamada, a matriz envVarcontém apenas o final do marcador de matriz.

[in] reqEnvVarList Uma sequência que contém uma lista separada por vírgulade nomes de variáveis de ambiente solicitadas pelaimplementação mais segura. O fim da lista deve ser nãoterminado.

[out] trustedSignonName Uma sequência de bytes que identifica o usuárioatualmente autenticado. Este valor não precisa serterminado nulo. Este valor é obrigatório.

[out]trustedSignonNameLength

Um valor de número inteiro que indica o comprimento detrustedSignonName. Este comprimento deve ser excluídodo terminador nulo, se houver. Este valor é obrigatório.

[out] trustedDomainName Uma sequência de bytes que identifica o domínio dousuário atualmente autenticado. Não é necessário terminaresse valor nulo. Se não houver trustedDomainName, oretorno será nulo. Este valor é opcional.

[out]trustedDomainNameLength

Um valor de número inteiro que indica o comprimento detrustedDomainName. Este comprimento deve ser excluídodo terminador nulo, se houver. Este valor é obrigatório edeve ser definido como zero se não houvertrustedDomainName.

[out] userType Um valor que indica o tipo de usuário que o AccessManager autenticará. Este valor é obrigatório.

Os valores de retorno a seguir são necessários para oAccess Manager autenticar usuários com sucesso:

SAFER_NORMAL_USERUm usuário nomeado. Os signons de OS devemexistir e estar ativados no namespace atual.

SAFER_GUEST_USERUm usuário convidado. Uma conta de usuárioconvidado deve existir e estar ativada nonamespace atual.

SAFER_ANONYMOUS_USERUm usuário anônimo. Uma conta de usuárioanônimo deve existir e estar ativada no namespaceatual.

180 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 193: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Tabela 36. Parâmetros e Descrição para a FunçãoSaferAPIGetTrustedSignonWithEnv (continuação)

Parâmetro Descrição

[in/out] implementerData Um ponteiro utilizado para preservar dados específicos daimplementação entre invocações. Uma chamada ocorresempre que o Access Manager chama o plug-in de conexãoconfiável. Este valor será válido apenas se o plug-in deconexão confiável tiver sido chamado e se você configurouum valor para ele.

Configurando o IBM Cognos para Usar um Provedor de AutenticaçãoCustomizada

Se tiver implementado um provedor de autenticação Java customizado com suainfraestrutura de segurança existente, é possível configurar componentes do IBMCognos para usá-lo.

É possível usar um provedor de autenticação customizada para acessar e autenticarusuários em uma fonte de autenticação. Também é possível usá-lo como ummecanismo de conexão única para integrar componentes do IBM Cognos com suainfraestrutura de segurança. É possível ocultar namespaces de usuários durante ologon.

Para obter mais informações, consulte o Custom Authentication Provider DeveloperGuide.

Configuração de namespaces de autenticação customizadaÉ possível configurar os componentes do IBM Cognos para usar um namespace deautenticação customizado. Qualquer configuração adicional para acesso a fonte deautenticação, conexão única ou atributos customizados dependem daimplementação do provedor de autenticação customizada.

Certifique-se de que as versões do Java Runtime Environment (JRE) e JavaSoftware Development Kit usadas sejam compatíveis uma com a outra. Se vocêusar versões suportadas do JRE e Java Software Development Kit que não sãocompatíveis uma com a outra, o provedor de autenticação Java customizadoconfigurado não aparecerá na lista de namespaces no IBM Cognos Configuration.

Procedimento1. Em cada local em que o Content Manager está instalado, abra o IBM Cognos

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

Autenticação e, em seguida, clique em Novo Recurso > Namespace.3. Na caixa Nome, digite um nome para o namespace de autenticação.4. Na lista Tipo, selecione Custom Java Provider e clique em OK.

O novo recurso provedor de autenticação aparece na janela Explorer, nocomponente Autenticação.

5. Na janela Propriedades, na propriedade ID do Namespace, especifique umidentificador exclusivo para o namespace.

Dica: Não use dois pontos (:) na propriedade ID do namespace.

Capítulo 8. Configurando Componentes do IBM Cognos para Usar um Provedor de Autenticação 181

Page 194: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

6. Especifique os valores para todas as propriedades necessárias para garantir queo IBM Cognos possa localizar e usar seu provedor de autenticação existente.

7. No menu Arquivo, clique em Salvar.8. Teste a conexão em um novo namespace. Na janela Explorer, em Autenticação,

clique com o botão direito no novo recurso de autenticação e clique em Testar.É solicitado que insira credenciais para um usuário no namespace para concluiro teste.Dependendo de como o namespace está configurado, será possível inserir umID do usuário e senha válidos para um usuário no namespace ou o DN e asenha de usuário de ligação.

Resultados

IBM Cognos carrega, inicializa e configura as bibliotecas do provedor para onamespace.

Ocultação do namespace dos usuários durante o loginÉ possível ocultar namespaces de usuários durante o login. É possível ternamespaces de conxão confiável sem exibi-los na lista de seleção de namespaceque é apresentada aos usuários durante o login.

Por exemplo, talvez você queira integrar a conexão única entre os sistemas, masmanter a capacidade dos clientes de se autenticarem diretamente no IBM Cognossem precisar escolher um namespace.

Procedimento1. Em cada local onde você configurou um provedor de autenticação Java

customizado, abra o IBM Cognos Configuration.2. Na janela Explorer, em Segurança > Autenticação, clique no provedor de

autenticação Java customizado.3. Na janela Propriedades, clique na caixa próxima a Selecionável para

autenticação e selecione Falso.4. No menu Arquivo, clique em Salvar.

Resultados

O namespace não é mostrado na lista de seleção apresentada no login.

Configurando componentes do IBM Cognos para uso com LDAPÉ possível configurar os componentes do IBM Cognos para usar um namespaceLDAP como provedor de autenticação. É possível usar um namespace LDAP parausuários que estão armazenados em um diretório do usuário LDAP, ActiveDirectory Server, IBM Directory Server, Novell Directory Server ou OracleDirectory Server.

Também é possível usar autenticação LDAP com origens de dados do DB2 eEssbase OLAP especificando o namespace LDAP durante a configuração daconexão de origem de dados. Para obter informações adicionais, consulte o Guia deAdministração e Segurança do IBM Cognos Business Intelligence.

Você também tem a opção de disponibilizar propriedades de usuário customizadasa partir do namespace LDAP para componentes do IBM Cognos.

182 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 195: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Caso queira vincular os usuários ao servidor LDAP, consulte “Mapeamento deLDAP”.

Procedimento1. “Configurando um Namespace LDAP” na página 1842. Disponibilize as propriedades de usuário customizadas para componentes do

IBM Cognos, se necessário3. Ative a comunicação segura para o servidor LDAP, se necessário4. Ative a conexão única entre LDAP e componentes do IBM Cognos, se

necessário

Mapeamento de LDAPPara vincular um usuário ao servidor LDAP, o provedor de autenticação do LDAPdeve construir o nome distinto (DN). Se a propriedade Utilizar identidade externaestiver definida como Verdadeira, usará a propriedade Mapeamento de identidadeexterna para tentar resolver o DN do usuário. Se não puder encontrar a variáveldo ambiente ou o DN no servidor LDAP, tentará utilizar a propriedade Consultade usuário para construir o DN.

Se os usuários estão hierarquicamente armazenados dentro do servidor dediretórios, será possível configurar as propriedades Consulta de usuário eMapeamento de identidade externa para utilizar filtros de busca. Quando oprovedor de autenticação LDAP executa estas procuras, ele usa os filtrosespecificados para a Consulta do usuário e Propriedades de mapeamento deidentidade externas. Ele também liga-se ao servidor de diretório usando o valorespecificado para a propriedade DN de usuário de ligação e senha ou usandoanônimo se nenhum valor for especificado.

Quando um namespace do LDAP for configurado para usar a propriedade demapeamento de identidade externo para autenticação, o provedor de LDAP liga-seao servidor de diretórios usando o DN de usuário de ligação e senha ou usandoanônimo se nenhum valor for especificado. Todos os usuários que efetuam logonno IBM Cognos usando o mapeamento de identidade externo veem os mesmosusuários, grupos e pastas como o usuário de ligação.

Se não utilizar o mapeamento de identidade externa, será possível especificar seserão utilizadas credenciais de ligação para procurar o servidor de diretórios LDAPconfigurando a propriedade Usar credenciais de vinculação para a busca. Quandoa propriedade é ativada, as procuras são executadas usando as credenciais deusuário de ligação ou usando o anônimo se nenhum valor for especificado.Quando a propriedade é desativada, que é a configuração padrão, as procuras sãoexecutadas usando as credenciais do usuário conectado. O benefício de utilizarcredenciais de ligação é que em vez de alterar direitos administrativos para váriosusuários, é possível alterar os direitos administrativos somente para o usuáriovinculado.

Nota: Se usar uma sintaxe de DN, como uid=${userID}, ou=mycompany.com, paraas propriedades Consulta de usuário, Mapeamento de identidade externo ou DNde usuário ligação e senha, você deve escapar todos os caracteres especiais usadosno DN. Se usar uma sintaxe de procura, como (uid=${userID}), para aspropriedades Consulta de usuário ou Mapeamento de identidade externo, vocênão deve escapar caracteres especiais usados no DN.

Capítulo 8. Configurando Componentes do IBM Cognos para Usar um Provedor de Autenticação 183

Page 196: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Configurando um Namespace LDAPÉ possível configurar componentes do IBM Cognos para usarem um namespaceLDAP quando os usuários estiverem armazenados em um diretório do usuárioLDAP. O diretório de usuário LDAP pode ser acessado de outro ambiente deservidor, como o Servidor do Active Directory ou CA SiteMinder.

Se estiver configurando um namespace LDAP para um servidor de diretóriosdiferente do LDAP, consulte a seção adequada:v Para Active Directory Server, consulte Configurando um Namespace LDAP para

Active Directory Server.v Para IBM Directory Server, consulte Configurando um Namespace LDAP para

IBM Directory Server.v Para Novell Directory Server, consulte Configurando um Namespace LDAP para

Novell Directory Server.v Para Oracle Directory Server, consulte Configurando um Namespace LDAP para

Oracle Directory Server.

Também é possível usar autenticação LDAP com origens de dados do DB2 eEssbase OLAP especificando o namespace LDAP durante a configuração daconexão de origem de dados. Para obter informações adicionais, consulte o Guia deAdministração e Segurança do IBM Cognos Business Intelligence.

Procedimento1. Em cada local em que você instalou o Content Manager, abra o IBM Cognos

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

Autenticação e, em seguida, clique em Novo Recurso > Namespace.3. Na caixa Nome, digite um nome para o namespace de autenticação.4. Na lista Tipo, clique no namespace apropriado e clique em OK.

O novo recurso do provedor de autenticação aparece na janela Explorer, nocomponente Autenticação.

5. Na janela Propriedades, na propriedade ID do namespace, especifique umidentificador exclusivo para o namespace.

6. Especifique os valores para todas as outras propriedades necessárias paragarantir que os componentes do IBM Cognos possam localizar e usar seuprovedor de autenticação existente.

7. Se desejar que o provedor de autenticação LDAP se vincule ao servidor dediretório usando Ligar DN de usuário e senha quando executar procuras, emseguida, especifique esses valores.Se não houver valores especificados, o provedor de autenticação LDAPvincula como anônimo.Se o mapeamento de identidade externa estiver ativado, Vincular DN dousuário e senha é utilizado para todos os acessos LDAP. Se o mapeamento deidentidade externa não estiver ativado, Vincular DN do usuário e senha sãousados apenas quando um filtro de procura for especificado para apropriedade Consulta de usuário. Nesse caso, quando o DN de usuário estáestabelecido, solicitações subsequentes para o servidor LDAP são executadassob o contexto de autenticação do usuário.

8. Se não usar o mapeamento de identidade externo, use credenciais de ligaçãopara procurar o servidor de diretório LDAP concluindo a etapa seguir:v Certifique-se de que Utilizar identidade externa esteja definido como Falso.

184 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 197: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

v Defina Usar credenciais de ligação para buscar como Verdadeiro.v Especifique a ID e a senha do usuário para Vincular DN do usuário e

senha.Se não especificar um ID do usuário e senha e o acesso anônimo for ativado, aprocura será feita usando anônimo.

9. Verifique as configurações de mapeamento para os objetos e atributosnecessários.Dependendo da configuração do LDAP, você pode precisar alterar algunsvalores padrão para garantir a comunicação bem-sucedida entre componentesdo IBM Cognos e o servidor LDAP.Os atributos LDAP mapeados para a propriedade Nome em Mapeamento depastas, Mapeamentos de grupos e Mapeamentos de contas devem estaracessíveis a todos os usuários autenticados. Além disso, a propriedade Nomenão pode ficar em branco.

10. No menu Arquivo, clique em Salvar.11. Teste a conexão em um novo namespace. Na janela Explorer, em

Autenticação, clique com o botão direito no novo recurso de autenticação eclique em Testar.É solicitado que insira credenciais para um usuário no namespace paraconcluir o teste.Dependendo de como o namespace está configurado, será possível inserir umID do usuário e senha válidos para um usuário no namespace ou o DN e asenha de usuário de ligação.

Resultados

IBM Cognos carrega, inicializa e configura as bibliotecas do provedor para onamespace.

Configurando um namespace do LDAP para o Active DirectoryServer

Se configurar um novo namespace LDAP para uso com um Servidor do ActiveDirectory, será preciso modificar as configurações e alterar os valores para todas aspropriedades dos objetos do Active Directory.

Procedimento1. Em cada local em que você instalou o Content Manager, abra o IBM Cognos

Configuration.2. Na janela Explorer, em Segurança, clique com o botão direito em

Autenticação e, em seguida, clique em Novo recurso > Namespace.3. Na caixa Nome, digite um nome para o namespace de autenticação.4. Na lista Tipo, clique no namespace apropriado e clique em OK.

O novo recurso provedor de autenticação aparece na janela Explorer, nocomponente Autenticação.

5. Na janela Propriedades, na propriedade ID do Namespace, especifique umidentificador exclusivo para o namespace.

Dica: Não use dois pontos (:) na propriedade ID do namespace.6. Especifique os valores para todas as outras propriedades necessárias para

garantir que os componentes do IBM Cognos possam localizar e usar seuprovedor de autenticação existente.

Capítulo 8. Configurando Componentes do IBM Cognos para Usar um Provedor de Autenticação 185

Page 198: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

As configurações seguintes são exemplos:v Para Consulta de Usuário, insira (sAMAccountName=${userID})

v Caso utilize um único signon, em Utilizar identidade externa defina o valorcomo Verdadeiro.

v Se você usar conexão única, para Mapeamento de identidade externa,especifique (sAMAccountName=${environment("REMOTE_USER")})

Se quiser remover o nome de domínio da variável REMOTE_USER,especifique (sAMAccountName=${replace(${environment("REMOTE_USER")},"domain\\","")}).

Importante: Certifique-se de usar apenas a variável REMOTE_USER.Utilizar outra variável pode causar uma vulnerabilidade de segurança.

v Para Senha e DN do usuário de ligação, insira [email protected] Para Identificador Exclusivo, insira objectGUID

7. Se desejar que o provedor de autenticação LDAP se vincule ao servidor dediretório usando Ligar DN de usuário e senha quando executar procuras, emseguida, especifique esses valores.Se não houver valores especificados, o provedor de autenticação LDAPvincula como anônimo.

8. Se você não usar o mapeamento de identidade externa, use as credenciais deligação para procurar o servidor de diretório LDAP fazendo o seguinte:v Certifique-se de que Utilizar identidade externa esteja definido como Falso.v Defina Usar credenciais de ligação para buscar como Verdadeiro.v Especifique a ID e a senha do usuário para Vincular DN do usuário e

senha.9. Para configurar as propriedades de mapeamento avançadas LDAP para uso

com os objetos Active Directory Server, use os valores especificados naseguinte tabela.

Tabela 37. Valores de Mapeamento Avançado do LDAP para Uso com Objetos do ActiveDirectory Server

Mapeamentos Propriedade LDAP Valor LDAP

Pasta Classe do objeto organizationalUnit,organization,contêiner

Descrição descrição

Nome ou,o,cn

Grupo Classe do objeto grupo

Descrição descrição

Membro membro

Nome cn

Conta Classe do objeto usuário

Telefone comercial telephonenumber

Código do idioma doconteúdo

(deixar em branco)

Descrição descrição

E-mail correio

Fax/telefone facsimiletelephonenumber

Nome fornecido givenname

186 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 199: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Tabela 37. Valores de Mapeamento Avançado do LDAP para Uso com Objetos do ActiveDirectory Server (continuação)

Mapeamentos Propriedade LDAP Valor LDAP

Telefone residencial homephone

Telefone celular dispositivo móvel

Nome displayName

Pager pager

Senha unicodePwd

Endereço postal postaladdress

Código do idioma doproduto

(deixar em branco)

Sobrenome sn

Nome de usuário sAMAccountName

Essas propriedades de mapeamento representam mudanças com base em umainstalação padrão do Active Directory Server. Se modificar o esquema, poderáter de fazer mais mudanças de mapeamento.Os atributos LDAP mapeados para a propriedade Nome em Mapeamento depastas, Mapeamentos de grupos e Mapeamentos de contas devem estaracessíveis a todos os usuários autenticados. Além disso, a propriedade Nomenão pode ficar em branco.

10. No menu Arquivo, clique em Salvar.11. Teste a conexão em um novo namespace. Na janela Explorer, em

Autenticação, clique com o botão direito no novo recurso de autenticação eclique em Testar.É solicitado que insira credenciais para um usuário no namespace paraconcluir o teste.Dependendo de como o namespace está configurado, será possível inserir umID do usuário e senha válidos para um usuário no namespace ou o DN e asenha de usuário de ligação.

Resultados

IBM Cognos carrega, inicializa e configura as bibliotecas do provedor para onamespace.Tarefas relacionadas:“Configurando Componentes do IBM Cognos para Usar o Active Directory Server”na página 167Se instalar o Content Manager em um computador de sistema operacionalMicrosoft Windows, é possível configurar um namespace do Active Directory comouma fonte de autenticação.

Configurando um namespace LDAP para o IBM DirectoryServer

Se configurar um novo namespace LDAP para usar com um IBM Directory Server,você deverá modificar as configurações necessárias e alterar os valores para todasas propriedades dos objetos do IBM Directory.

Capítulo 8. Configurando Componentes do IBM Cognos para Usar um Provedor de Autenticação 187

Page 200: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Procedimento1. Em cada local em que você instalou o Content Manager, abra o IBM Cognos

Configuration.2. Na janela Explorer, em Segurança, clique com o botão direito em

Autenticação e, em seguida, clique em Novo recurso > Namespace.3. Na caixa Nome, digite um nome para o namespace de autenticação.4. Na lista Tipo, clique em LDAP e depois em OK.

O novo recurso de namespace de autenticação aparece na janela Explorer, sobo componente Autenticação.

5. Na janela Propriedades, na propriedade ID do Namespace, especifique umidentificador exclusivo para o namespace.

Dica: Não use dois pontos (:) na propriedade ID do namespace.6. Especifique os valores para todas as outras propriedades obrigatórias para

garantir que o IBM Cognos possa localizar e usar seu namespace deautenticação existente.v Para Consulta de usuário, especifique (cn=${userID})

v Para Ligar DN de usuário e senha, especifique cn=root

7. Se desejar que o provedor de autenticação LDAP se vincule ao servidor dediretório usando Ligar DN de usuário e senha quando executar procuras, emseguida, especifique esses valores.Se não houver valores especificados, o provedor de autenticação LDAPvincula como anônimo.

8. Se você não usar o mapeamento de identidade externa, use as credenciais deligação para procurar o servidor de diretório LDAP fazendo o seguinte:v Certifique-se de que Utilizar identidade externa esteja definido como Falso.v Defina Usar credenciais de ligação para buscar como Verdadeiro.v Especifique a ID e a senha do usuário para Vincular DN do usuário e

senha.9. Para configurar a propriedades de mapeamento avançadas do LDAP para uso

com os objetos do IBM Directory Server, use os valores especificados na tabelaa seguir.

Tabela 38. Valores de Mapeamento Avançado do LDAP para Uso com Objetos do IBMDirectory Server

Mapeamentos Propriedade LDAP Valor LDAP

Pasta Classe do objeto organizationalunit,organization,contêiner

Descrição descrição

Nome ou,o,cn

Grupo Classe do objeto groupofnames

Descrição descrição

Membro membro

Nome cn

Conta Classe do objeto inetorgperson

Telefone comercial telephonenumber

Código do idioma doconteúdo

(deixar em branco)

Descrição descrição

188 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 201: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Tabela 38. Valores de Mapeamento Avançado do LDAP para Uso com Objetos do IBMDirectory Server (continuação)

Mapeamentos Propriedade LDAP Valor LDAP

E-mail correio

Fax/telefone facsimiletelephonenumber

Nome fornecido givenname

Telefone residencial homephone

Telefone celular mobile

Nome cn

Pager pager

Senha userPassword

Endereço postal postaladdress

Código do idioma doproduto

(deixar em branco)

Sobrenome sn

Nome de usuário uid

Essas propriedades de mapeamento representam mudanças com base em umainstalação padrão do Active Directory Server. Se modificar o esquema, poderáter de fazer mais mudanças de mapeamento.Os atributos LDAP mapeados para a propriedade Nome em Mapeamento depastas, Mapeamentos de grupos e Mapeamentos de contas devem estaracessíveis a todos os usuários autenticados. Além disso, a propriedade Nomenão pode ficar em branco.

10. No menu Arquivo, clique em Salvar.

Configurando um namespace LDAP para o Novell DirectoryServer

Se configurar um novo namespace LDAP para uso com um Novell DirectoryServer, será preciso modificar as configurações e alterar os valores para todas aspropriedades dos objetos do Novell Directory.

Procedimento1. Em cada local em que você instalou o Content Manager, abra o IBM Cognos

Configuration.2. Na janela Explorer, em Segurança, clique com o botão direito em

Autenticação e, em seguida, clique em Novo recurso > Namespace.3. Na caixa Nome, digite um nome para o namespace de autenticação.4. Na lista Tipo, clique em LDAP e em OK.

O novo recurso de namespace de autenticação aparece na janela Explorer, sobo componente Autenticação.

5. Na janela Propriedades, na propriedade ID do namespace, especifique umidentificador exclusivo para o namespace.

Dica: Não use dois pontos (:) na propriedade ID do namespace.6. Especifique os valores para todas as outras propriedades obrigatórias para

garantir que o IBM Cognos possa localizar e usar seu namespace deautenticação existente.

Capítulo 8. Configurando Componentes do IBM Cognos para Usar um Provedor de Autenticação 189

Page 202: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

v Para Consulta de usuário, especifique (cn=${userID})

v Para Ligar DN de usuário e senha, especifique o DN base para um usuáriode administração, como cn=Admin,o=COGNOS

7. Se desejar que o provedor de autenticação LDAP se vincule ao servidor dediretório usando Ligar DN de usuário e senha quando executar procuras, emseguida, especifique esses valores.Se não houver valores especificados, o provedor de autenticação LDAPvincula como anônimo.

8. Se você não usar o mapeamento de identidade externa, use as credenciais deligação para procurar o servidor de diretório LDAP fazendo o seguinte:v Certifique-se de que Utilizar identidade externa esteja definido como Falso.v Defina Usar credenciais de ligação para buscar como Verdadeiro.v Especifique a ID e a senha do usuário para Vincular DN do usuário e

senha.9. Para configurar as propriedades de mapeamento avançadas do LDAP para

uso com objetos do Novell Directory Server, utilize valores especificados naseguinte tabela.

Tabela 39. Valores de Mapeamento Avançado do LDAP para Uso com Objetos do NovellDirectory Server

Mapeamentos Propriedade LDAP Valor LDAP

Pasta Classe do objeto organizationalunit,organization,contêiner

Descrição descrição

Nome ou,o,cn

Grupo Classe do objeto groupofnames

Descrição descrição

Membro membro

Nome cn

Conta Classe do objeto inetOrgPerson

Telefone comercial telephonenumber

Código do idioma doconteúdo

Idioma

Descrição descrição

E-mail correio

Fax/telefone facsimiletelephonenumber

Nome fornecido givenname

Telefone residencial homephone

Telefone celular mobile

Nome cn

Pager pager

Senha (deixar em branco)

Endereço postal postaladdress

Código do idioma doproduto

Idioma

Sobrenome sn

Nome de usuário uid

190 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 203: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Essas propriedades de mapeamento representam mudanças com base em umainstalação padrão do Active Directory Server. Se modificar o esquema, poderáter de fazer mais mudanças de mapeamento.Os atributos LDAP mapeados para a propriedade Nome em Mapeamento depastas, Mapeamentos de grupos e Mapeamentos de contas devem estaracessíveis a todos os usuários autenticados. Além disso, a propriedade Nomenão pode ficar em branco.Para que os usuários efetuem login com sucesso no IBM Cognos Connection,eles devem ter permissão para ler os atributos ou e o.

10. No menu Arquivo, clique em Salvar.

Configurando um namespace LDAP para o Oracle DirectoryServer

Se configurar um novo namespace LDAP para ser usado com o Oracle DirectoryServer, você deverá modificar as configurações necessárias e alterar os valores paratodas as propriedades dos objetos do Oracle Directory Server.

Procedimento1. Em cada local em que você instalou o Content Manager, abra o IBM Cognos

Configuration.2. Na janela Explorer, em Segurança, clique com o botão direito em

Autenticação e, em seguida, clique em Novo recurso > Namespace.3. Na caixa Nome, digite um nome para o namespace de autenticação.4. Na lista Tipo, clique em LDAP e em OK.

O novo recurso de namespace de autenticação aparece na janela Explorer, sobo componente Autenticação.

5. Na janela Propriedades, na propriedade ID do namespace, especifique umidentificador exclusivo para o namespace.

Dica: Não use dois pontos (:) na propriedade ID do namespace.6. Especifique os valores para todas as outras propriedades obrigatórias para

garantir que o IBM Cognos possa localizar e usar seu namespace deautenticação existente.As configurações seguintes são exemplos:v Para Consulta de Usuário, digite (uid=${userID})

v Caso utilize um único signon, em Utilizar identidade externa defina o valorcomo Verdadeiro.

v Se utilizar conexão única para Mapeamento de identidade externa,especifique qualquer atributo, como a ID de domínio do usuário ou a ID dousuário:(ntuserdomainid=$environment("REMOTE_USER")})

(uid=${environment("REMOTE_USER")})

Importante: Certifique-se de usar apenas a variável REMOTE_USER.Utilizar outra variável pode causar uma vulnerabilidade de segurança.

v Para Identificador exclusivo, digite nsuniqueid

7. Se desejar que o provedor de autenticação LDAP se vincule ao servidor dediretório usando Ligar DN de usuário e senha quando executar procuras, emseguida, especifique esses valores.

Capítulo 8. Configurando Componentes do IBM Cognos para Usar um Provedor de Autenticação 191

Page 204: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

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

8. Se você não usar o mapeamento de identidade externa, use as credenciais deligação para procurar o servidor de diretório LDAP fazendo o seguinte:v Certifique-se de que Utilizar identidade externa esteja definido como Falso.v Defina Usar credenciais de ligação para buscar como Verdadeiro.v Especifique a ID e a senha do usuário para Vincular DN do usuário e

senha.9. Para configurar as propriedades de mapeamento avançadas do LDAP para

uso com objetos Oracle Directory Server, use os valores especificados na tabelaa seguir.

Tabela 40. Valores de Mapeamento Avançado do LDAP para Uso com Objetos do OracleDirectory Server

Mapeamentos Propriedade LDAP Valor LDAP

Pasta Classe do objeto organizationalUnit,organization

Descrição descrição

Nome ou,o

Grupo Classe do objeto groupofuniquenames

Descrição descrição

Membro uniquemember

Nome cn

Conta Classe do objeto inetorgperson

Telefone comercial telephonenumber

Código do idioma doconteúdo

preferredlanguage

Descrição descrição

E-mail correio

Fax/telefone facsimiletelephonenumber

Nome fornecido givenname

Telefone residencial homephone

Telefone celular dispositivo móvel

Nome cn

Pager pager

Senha userPassword

Endereço postal postaladdress

Código do idioma doproduto

preferredlanguage

Sobrenome sn

Nome de usuário uid

Essas propriedades de mapeamento representam mudanças com base em umainstalação padrão do Active Directory Server. Se modificar o esquema, poderáter de fazer mais mudanças de mapeamento.

192 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 205: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Os atributos LDAP mapeados para a propriedade Nome em Mapeamento depastas, Mapeamentos de grupos e Mapeamentos de contas devem estaracessíveis a todos os usuários autenticados. Além disso, a propriedade Nomenão pode ficar em branco.

10. No menu Arquivo, clique em Salvar.

Tornar propriedades de usuário customizadas para LDAPdisponíveis para componentes do IBM Cognos

É possível usar atributos de usuário arbitrários do provedor de autenticação LDAPnos componentes do IBM Cognos. Para configurar isso, é preciso adicionar essesatributos como propriedades customizadas para o namespace LDAP. Aspropriedades customizadas estão disponíveis como parâmetros de sessão noFramework Manager.

Utilize também as propriedades customizadas dentro dos blocos de comando paraconfigurar sessões e conexões do Oracle. Utilize blocos de comando com asconexões leves do Oracle e bancos de dados privados virtuais. Para obterinformações adicionais, consulte o Guia de Administração e Segurança do IBM CognosBusiness Intelligence.

Para obter informações adicionais sobre os parâmetros de sessão, consulte o Guiado Usuário do Framework Manager.

Procedimento1. Em cada local em que instalou o Content Manager, abra o Cognos

Configuration.2. Na janela Explorer, em Segurança > Autenticação e selecione o namespace do

LDAP.3. Na janela Propriedades, clique na coluna Valor para Propriedades

Customizadas e clique no ícone de edição.4. Na janela Valor - Propriedades customizadas, clique em Adicionar.5. Clique na coluna Nome e digite o nome que deseja que os componentes IBM

Cognos usem para o parâmetro de 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 customizado.8. Clique em OK.9. No menu Arquivo, clique em Salvar.

Ativando a comunicação segura para o servidor LDAPO protocolo LDAP seguro (LDAPS) criptografa a comunicação entre o componentedo Access Manager do Content Manager e o servidor de diretórios. O LDAPSimpede que informações delicadas no servidor de diretórios e as credenciais doLDAP sejam enviadas como texto simples.

Para ativar o LDAPS, instale um certificado de servidor que tenha sido assinadopor uma autoridade de certificação no servidor de diretórios. Em seguida, crie umbanco de dados de certificados para armazenar os certificados. Finalmente,configure o servidor de diretório e o namespace IBM Cognos LDAP para usarLDAPS.

O certificado do servidor deve ser uma cópia de

Capítulo 8. Configurando Componentes do IBM Cognos para Usar um Provedor de Autenticação 193

Page 206: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

v O certificado de raiz confiável e todos os outros certificados que compõem acadeia de confiança para o certificado do servidor de diretórioO certificado raiz confiável é o certificado da autoridade de certificação raiz queassinou o certificado do servidor de diretórios.

v O certificado do servidor de diretório apenas

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

Antes de Iniciar

O IBM Cognos funciona com ambas as versões cert8.db e cert7.db do banco dedados do certificado de cliente. Você deve usar a ferramenta certutil do kit deferramentas Netscape OpenSource NSS_3_11_4_RTM para criar o banco de dadosde certificados. O IBM Cognos não aceita outras versões dos arquivos cert8.db,incluindo esses arquivos da ferramenta certutil fornecida com o Microsoft ActiveDirectory. A ferramenta certutil apropriada está disponível a partir do websiteFTP no Mozilla.

Você também deve usar a versão 4.6.7 da biblioteca NSPR, que está disponível nowebsite FTP no Mozilla.

Procedimento1. Crie um diretório para o banco de dados de certificados.2. Crie o banco de dados de certificados digitando o comando a seguir:

certutil -N -d certificate_directory

Em que certificate_directory é o diretório que criou na etapa 1.Este comando cria um arquivo cert8.db e um arquivo key3.db no novodiretório.

3. Adicione o certificado da autoridade de certificação (CA) ou o certificado doservidor de diretórios ao banco de dados de certificado digitando o comandoadequado para o tipo de certificado:v Para um certificado CA:

certutil -A -n certificate_name -d certificate_directory -i CA.cert-t C,C,C

v Para um certificado de servidor de diretório:certutil -A -n certificate_name -d certificate_directory -iserver_certificate.cert -t P

Em que certificate_name é um alias que você designa, como o nome de CAou nome do host; e server_certificate é o prefixo do arquivo de certificadodo servidor de diretório.

4. Copie o diretório de banco de dados de certificados para o diretórioc10_location/configuration em cada local em que o Content Manager estáinstalado.

5. Configure o servidor de diretórios para utilizar LDAPS e reinicie o servidor dediretórios.Para obter mais informações, consulte a documentação do servidor dediretórios.

6. Em cada local do Content Manager em que você configurou o namespaceLDAP para usar um servidor de diretório, inicie o IBM Cognos Configuration.

194 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 207: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

7. Na janela Explorer, em Segurança > Autenticação, clique no namespace doLDAP.

8. Na janela Propriedades, para a propriedade Host e porta, altere a porta paraproteger a porta LDAPS.Para a propriedade Banco de dados de certificado SSL, especifique o caminhopara o arquivo cert7.db.

9. Na janela Explorer, clique com o botão direito no namespace do LDAP eclique em Testar.Se o teste falhar, revise as propriedades, garantindo que o certificado corretoseja utilizado.

10. No menu Arquivo, clique em Salvar.11. No menu Ações, clique em Reiniciar.12. Repita as etapas de 6 a 11 em um local sim, um não, em que o Content

Manager estiver instalado.

Ative a conexão única entre o LDAP e componentes IBMCognos

A conexão única com componentes do IBM Cognos é obtida por meio daconfiguração da propriedade Mapeamento de Identidade Externa.

O Mapeamento de identidade externa pode referir-se a uma variável de ambienteCGI ou uma variável de cabeçalho HTTP. Para um gateway de servidor deaplicativos ou entrada de dispatcher que estiver apontando para componentes IBMCognos, o Mapeamento de identidade externo pode se referir à variável de sessãouserPrincipalName. O valor resolvido da propriedade Mapeamento de identidadeexterno no tempo de execução deve ser um DN de usuário válido.

Quando um namespace do LDAP é configurado para usar a propriedadeMapeamento de identidade externo para autenticação, o provedor do LDAP liga-seao servidor de diretórios usando o DN de usuário de ligação e senha ou usandoanônimo se nenhum valor for especificado. Todos os usuários que efetuam logonno IBM Cognos usando o mapeamento de identidade externo veem os mesmosusuários, grupos e pastas como o usuário de ligação.

Se você quiser que os componentes do IBM Cognos trabalhem com aplicativos queusam Java ou segurança de servidor de aplicativos, é possível configurar apropriedade Mapeamento de Identidade Externa para obter o ID do usuário dousuário principal de Java. Inclua o token ${environment("USER_PRINCIPAL")} novalor para a propriedade. Para obter mais informações, consulte a ajuda on-linepara o IBM Cognos Configuration.

É possível aplicar a edição de expressão limitada à propriedade Mapeamento deidentidade externo usando a operação de substituição.

Operação de SubstituiçãoA operação de substituição retorna uma cópia da sequência com todas asocorrências da antiga subsequência substituída pela nova subsequência.

As seguintes regras aplicam-se:v O caractere \ escapa os caracteres nos parâmetros da função. Caracteres como \

e " precisam escapar.v Chamadas de funções aninhadas não são suportadas.

Capítulo 8. Configurando Componentes do IBM Cognos para Usar um Provedor de Autenticação 195

Page 208: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

v Caracteres especiais não são suportados.

Sintaxe

${replace(str , old , new)}

Parâmetros para a operação de substituição

Tabela 41. Parâmetros e Descrição para a Operação de Substituição

Parâmetro Descrição

str A string de busca.

old A subsequência a ser substituída pela nova.

new A subsequência que substitui a antiga.

Exemplos

${replace(${environment("REMOTE_USER")},"NAMERICA\\",)}

${replace(${environment("REMOTE_USER")},"NAMERICA\\","")}

Configure os Componentes do IBM Cognos para Usar o CA SiteMinderÉ possível configurar os componentes do IBM Cognos para usar um namespace doCA SiteMinder como uma origem de autenticação.

Nota: O provedor de autenticação usa um CA SiteMinder Software DevelopmentKit para implementar um agente customizado. A implementação do agentecustomizado requer a configuração de Propriedades de agente no consoleadministrativo do servidor de políticas CA SiteMinder para suportar agentes 4.x.

CA SiteMinder Configurado Para Mais de um Diretório doUsuário

Se o seu ambiente do CA SiteMinder estiver configurado para mais de umdiretório de usuário, é necessário utilizar o tipo de namespace SiteMinder no IBMCognos Configuration.

Após configurar o namespace SiteMinder no IBM Cognos Configuration, seránecessário também incluir um LDAP correspondente ou o namespace ActiveDirectory Server no IBM Cognos Configuration para cada diretório do usuáriodefinido no CA SiteMinder.

Ao configurar um namespace LDAP correspondente, certifique-se de que apropriedade Mapeamento de identidade externa esteja ativada e que o tokenREMOTE_USER seja incluído no valor da propriedade. Isso não significa que o CASiteMinder deve ser configurado para definir o REMOTE_USER.

Ao configurar um namespace do Active Directory correspondente, é precisogarantir que a propriedade singleSignOnOption esteja definida paraIdentityMapping.

196 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 209: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

O namespace SiteMinder transmite informações sobre o usuário internamente parao namespace LDAP correspondente usando a variável de ambiente REMOTE_USERquando ele recebe uma identificação de usuário bem-sucedida do ambiente do CASiteMinder.

Para obter mais informações, consulte “Ativando a conexão única entre oscomponentes do Active Directory Server e do IBM Cognos para usar oREMOTE_USER” na página 175.

Importante: Certifique-se de usar apenas a variável REMOTE_USER. Utilizar outravariável pode causar uma vulnerabilidade de segurança.

CA SiteMinder Configurado com Apenas um Diretório do Usuário

Se o seu ambiente do CA SiteMinder estiver configurado com apenas um diretóriode usuário, não é necessário utilizar o tipo de namespace SiteMinder no IBMCognos Configuration.

Nesse caso, é possível utilizar o diretório de usuário como sua fonte deautenticação configurando o namespace adequado, ou é possível configurar oSiteMinder com um diretório de usuário. Por exemplo, se o diretório do usuárioCA SiteMinder é LDAP, é possível configurar os componentes do IBM Cognos comum namespace LDAP ou com um namespace SiteMinder, referindo-se a umdiretório do usuário que é um namespace LDAP.

Se o diretório de usuário do CA SiteMinder é o Active Directory, é possível utilizarum namespace do Active Directory ou um namespace LDAP que é configuradopara uso com o Active Directory.

Se deseja usar diretamente o diretório do usuário como fonte de autenticação aoinvés de configurar um namespace SiteMinder, é possível configurar o namespaceLDAP ou Active Directory apropriado. Nesse caso, verifique as propriedades doObjeto de Configuração do Agente no servidor de políticas do CA SiteMinder.Certifique-se de que o SetRemoteUser esteja ativado.

Ao configurar o namespace do Active Directory, certifique-se de que a propriedadesingleSignOnOption esteja definida para IdentityMapping.

Ao configurar um namespace LDAP correspondente, certifique-se de que apropriedade Mapeamento de identidade externa esteja ativada e que o tokenREMOTE_USER seja incluído no valor da propriedade.

Para obter mais informações, consulte “Ativando a conexão única entre oscomponentes do Active Directory Server e do IBM Cognos para usar oREMOTE_USER” na página 175.

Importante: Certifique-se de usar apenas a variável REMOTE_USER. Utilizar outravariável pode causar uma vulnerabilidade de segurança.

Configurando o Namespace SiteMinderSe você configurou o CA SiteMinder para mais de um diretório do usuário, énecessário utilizar o tipo de namespace SiteMinder no IBM Cognos Configuration.Após incluir o namespace SiteMinder, você também deve incluir um namespaceLDAP correspondente para cada diretório do usuário em seu ambiente do CASiteMinder.

Capítulo 8. Configurando Componentes do IBM Cognos para Usar um Provedor de Autenticação 197

Page 210: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Você também pode utilizar o tipo de namespace SiteMinder se os usuários estãoarmazenados em um servidor LDAP ou em um servidor Active Directory.

É possível ocultar namespaces de usuários durante o login. É possível ternamespaces de conxão confiável sem exibi-los na lista de seleção de namespaceque é apresentada aos usuários durante o login. Por exemplo, talvez você queiraintegrar a conexão única entre os sistemas, mas manter a capacidade dos clientesde se autenticarem diretamente no IBM Cognos sem precisar escolher umnamespace.

Antes de Iniciar

Para utilizar o namespace SiteMinder, você deve obter os arquivos de bibliotecarequeridos do CA SiteMinder, que são mostrados na tabela a seguir, e incluir osarquivos no caminho de biblioteca apropriado para o seu sistema operacional.

Tabela 42. Arquivos de Biblioteca do CA SiteMinder

Sistema operacional arquivo de biblioteca do CA SiteMinder

Solaris e AIX libsmagentapi.so

Microsoft Windows de 64 bits smagentapi.dll

Microsoft Windows de 32 bits smagentapi.dll

smerrlog.dll

Procedimento1. No computador no qual instalou o Content Manager, anexe o diretório que

contém o arquivo de biblioteca do CA SiteMinder para a variável de ambientedo caminho de biblioteca apropriada.v Para sistemas operacionais Solaris, LD_LIBRARY_PATHv Para sistemas operacionais AIX, LIBPATHv Para sistemas operacionais Microsoft Windows, PATH

2. Abra o IBM Cognos Configuration.3. 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 Nome, digite um nome para o namespace de autenticação.5. Na lista Tipo, selecione o SiteMinder e depois em OK.6. Selecione o namespace que você incluiu.7. Para a propriedade ID do Namespace, especifique um identificador exclusivo

para o namespace.

Nota: Não utilize dois pontos (:) no identificador.8. Especifique valores para as outras propriedades necessárias.

Nota: Se você não deseja que o nome do namespace apareça para os usuáriosquando eles efetuarem login, configure a propriedade Selecionável paraautenticação para False.

9. Na janela Explorer, em Segurança > Autenticação, dê um clique direito nonamespace que você incluiu e clique em Novo recurso > Servidor de Políticasdo SiteMinder.

10. Na caixa Nome, digite um nome para o servidor de políticas e clique em OK.

198 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 211: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

11. Na janela Propriedades, especifique a propriedade Host e qualquer outrosvalores de propriedade que deseja alterar.

12. Na janela Explorer, dê um clique com o botão direito no novo servidor depolíticas do SiteMinder que você incluiu e clique em Novo recurso >Diretório do usuário.

13. Na caixa Nome, digite um nome para o diretório de usuário e clique em OK.

Importante: O nome do diretório do usuário deve corresponder ao nome doservidor de políticas.

14. Na janela Propriedades, digite um valor para a propriedade Referência à IDdo namespace.

15. Configure um diretório do usuário para cada diretório do usuário noSiteMinder Policy Server.

16. Clique em Arquivo > Salvar.17. 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 eclique em Testar.É solicitado que insira credenciais para um usuário no namespace paraconcluir o teste.Dependendo de como o namespace está configurado, será possível inserir umID do usuário e senha válidos para um usuário no namespace ou o DN e asenha de usuário de ligação.

18. Configure um LDAP correspondente ou um namespace Active Directory paracada diretório de usuário.Certifique-se de utilizar o mesmo valor para a propriedade ID do namespaceutilizada para a propriedade ID do Namespace para o namespace SiteMinder.

Configurando o IBM Cognos para Usar um Provedor RACF paraAutenticação

Se você usar um provedor Resource Access Control Facility (RACF) paraautenticação em seu ambiente corporativo, também será possível usá-lo paraautenticação em produtos IBM Cognos.

Procedimento1. Configure componentes do IBM Cognos para usar um namespace RACF2. Configure comunicações seguras3. Ativa a conexão única entre o provedor RACF e os componentes do IBM

Cognos

Configurando um Namespace RACFÉ possível configurar um namespace Resource Access Control Facility (RACF)usando IBM Cognos Configuration.

Antes de Iniciar

Antes de configurar o namespace RACF, você deve fazer o seguinte:v Você deve estar executando o Tivoli Directory Server.v O Tivoli Directory Server deve estar configurado para LDAP para acessar o

banco de dados SDBM (RACF).

Capítulo 8. Configurando Componentes do IBM Cognos para Usar um Provedor de Autenticação 199

Page 212: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Para obter mais informações, consulte o tópico sobre como configurar o TivoliAccess Manager para LDAP no Centro de Informações da IBM.

Procedimento1. No local em que você instalou o Content Manager, abra o IBM Cognos

Configuration.2. Para criar o namespace, faça o seguinte:

v Na janela Explorer, em Segurança, clique com o botão direito do mouse emAutenticação e clique em Novo Recurso > Namespace.

v Na caixa Nome, digite um nome para o namespace de autenticação.v Na lista Tipo, clique em RACF e depois em OK.

O novo recurso do provedor de autenticação aparece na janela Explorer, nocomponente Autenticação.

3. Na janela Propriedades, na propriedade ID do namespace, especifique umidentificador exclusivo para o namespace.Não use dois pontos (:) na propriedade ID do namespace.

4. Para a propriedade Host e Porta, digite o valor que corresponde ao TivoliDirectory Server.

5. Para a propriedade Nome Distinto de Base, digite o valor que corresponde aosufixo configurado para SDBM no Tivoli Directory Server.

6. Se estiver usando uma conexão SSL com o provedor RACF, configure apropriedade Ativar SSL como true.

7. Para mapear para as propriedades da conta RACF, como e-mail e número dotelefone, para as propriedades DATA do segmento base e USERDATA dosegmento TSO em Mapeamentos da Conta, clique na coluna de valor eselecione o valor da lista suspensa.

8. No menu Arquivo, clique em Salvar.9. 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.É solicitado que insira credenciais para um usuário no namespace para concluiro teste.Dependendo de como o namespace está configurado, será possível inserir umID do usuário e senha válidos para um usuário no namespace ou o DN e asenha de usuário de ligação.

Ativando a Conexão Única entre o RACF e o IBM CognosAtive a conexão única entre o provedor Resource Access Control Facility (RACF) eos componentes do IBM Cognos para simplificar o processo de autenticação paraos usuários, evitar a necessidade de diversas conexões únicas e simplificar ogerenciamento de identidades de usuários na rede.

Uma conexão única é obtida configurando-se o mapeamento de identidade no IBMCognos Configuration, configurando o IBM WebSphere Application Server paradefinir REMOTE_USER e configurando o WebSphere para autenticação comrelação ao RACF.

Importante: Certifique-se de usar apenas a variável REMOTE_USER. Utilizar outravariável pode causar uma vulnerabilidade de segurança.

Quando um namespace RACF é configurado para usar mapeamento de identidadepara autenticação, o namespace RACF se liga ao provedor RACF usando as

200 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 213: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

credenciais de ligação ou anoninamente se nenhuma credencial de ligação estiverespecificada. Todos os usuários que efetuam logon no IBM Cognos usandomapeamento de identidade vêem os mesmos usuários, grupos e pastas que ousuário de ligação.

Procedimento1. Em cada local em que você instalou o Content Manager, abra o IBM Cognos

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

Autenticação e clique no namespace RACF.3. Na janela Propriedades do Recurso, altere Habilitar o mapeamento de

identidade para Verdadeiro.4. Clique na coluna de valor para Credenciais de Ligação e clique no ícone de

edição.5. Na caixa de diálogo Valor- Credenciais de ligação, especifique a ID do usuário

e a Senha.6. No IBM Cognos Configuration, reinicie o serviço:

v Na janela Explorer, expanda Serviço do IBM Cognos e selecione o serviço.v No menu Ações, clique em Reiniciar.

7. Usando a documentação do WebSphere, configure WebSphere para definirREMOTE_USER.

8. Usando a documentação do WebSphere, configure WebSphere para autenticaçãousando o provedor RACF.

Configurando o IBM Cognos para Usar SAPPara utilizar um servidor SAP como provedor de autenticação, é preciso utilizaruma versão de SAP BW suportada.

Os direitos de autorização requeridos pelo usuário do SAP dependem de quem usaos componentes do IBM Cognos: usuários ou administradores.

Configurações de Autorização do SAP para Usuários do IBMCognos

Os objetos de autorização na tabela a seguir são requeridos para qualquer usuáriodo IBM Cognos.

Tabela 43. Configurações de Autorização do SAP para Usuários do IBM Cognos

Objeto de autorização Campo Valor

S_RFC

Verificação de autorização doacesso RFC

Atividade

Nome do RFC a serprotegido

RFC1 RS_UNIFICATION,SDTX, SH3A, SU_USER,SYST, SUSO

Nome do RFC a serprotegido

FUGR

S_USER_GRP

Manutenção mestre deusuário: Grupos de usuário

Atividade 03

Capítulo 8. Configurando Componentes do IBM Cognos para Usar um Provedor de Autenticação 201

Page 214: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Tabela 43. Configurações de Autorização do SAP para Usuários do IBMCognos (continuação)

Objeto de autorização Campo Valor

Nome do grupo de usuários *

Alguns dos valores apresentados, tais como *, são valores padrão que se podedesejar modificar para o ambiente.

Configurações de Autorização do SAP para Administradores doIBM Cognos

Se os usuários executarem as tarefas administrativas e as procuras por usuários efunções, os valores da seguinte tabela deverão ser incluídos no objeto deautorização S_RFC além dos valores para os usuários do IBM Cognos.

Tabela 44. Configurações de Autorização do SAP para Administradores do IBM Cognos

Objeto de autorização Campo Valor

S_RFC

Verificação de autorização doacesso RFC

Atividade 16

RFC_NAME PRGN_J2EE, SHSS, SOA3

Tipo de objeto RFC a serprotegido

FUGR

Alguns dos valores mostrados, como *, são valores padrão que você poderá desejarmodificar para seu ambiente.

Configuração de namespaces SAPÉ possível configurar componentes do IBM Cognos para usar um servidor SAPcomo fonte de autenticação.

Antes de Iniciar

Se tiver instalado seu produto IBM Cognos em um servidor de 64 bits, vocêtambém deverá copiar os arquivos de biblioteca SAP RFC no diretório deinstalação do IBM Cognos.

Procedimento1. Se estiver sendo executado em um servidor 64 bits, faça o seguinte:

v Acesse o diretório de instalação do SAP no servidor 64 bits.v Copie todos os arquivos de biblioteca SAP RFC de 64 bits no

c10_64_location\bin64, em que c10_64_location é o diretório no qual vocêinstalou o servidor IBM Cognos.

v Copie todos os arquivos de biblioteca SAP RFC de 32 bits emc10_64_location\bin.

2. Se estiver em execução em um servidor de 32 bits, copie todos os arquivos debiblioteca SAP de 32 bits do diretório de instalação SAP no diretórioc10_64_location\bin64.

3. No local em que você instalou o Content Manager, abra o IBM CognosConfiguration.

202 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 215: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

4. Na janela Explorer, em Segurança, clique com o botão direito do mouse emAutenticação e clique em Novo Recurso > Namespace.

5. Na caixa Nome, digite um nome para o namespace de autenticação.6. Na lista Tipo, clique em SAP e depois em OK.

O novo recurso do provedor de autenticação aparece na janela Explorer, nocomponente Autenticação.

7. Na janela Propriedades, na propriedade ID do namespace, especifique umidentificador exclusivo para o namespace.

Importante: Não use dois pontos (:) na propriedade ID do namespace.8. Especifique os valores para todas as propriedades necessárias para garantir

que os componentes do IBM Cognos possam localizar e usar seu provedor deautenticação existente.Dependendo do ambiente, para a propriedade Host, pode ser necessárioadicionar a string roteadora de SAP ao nome host SAP.

9. Se o sistema SAP codifica o conteúdo de cookies, ative o recurso dedecodificação de chamados:v Na janela Propriedades, de Propriedades Avançadas, clique no Valor e, em

seguida, clique no ícone de edição.v Clique em Incluir.v Insira o nome URLDecodeTickets e o valor true

v Clique em OK.Todos os chamados de logon SAP serão decodificados pelo namespace SAPantes de estabelecer uma conexão.

10. No menu Arquivo, clique em Salvar.11. Teste a conexão em um novo namespace. Na janela Explorer, em

Autenticação, clique com o botão direito no novo recurso de autenticação eclique em Testar.É solicitado que insira credenciais para um usuário no namespace paraconcluir o teste.Dependendo de como o namespace está configurado, será possível inserir umID do usuário e senha válidos para um usuário no namespace ou o DN e asenha de usuário de ligação.

Ativar Conexão Única entre SAP e IBM CognosÉ possível ativar conexão única entre SAP Enterprise Portal e componentes do IBMCognos, bem como ao usar a função de namespace externa de conexões de origemde dados SAP BW.

Para isso, certifique-se de definir os seguintes parâmetros do sistema no servidorSAP BW:v login/accept_sso2_ticket = 1

v login/create_sso2_ticket = 1

v login/ticket_expiration_time = 200

Exclusão de provedores de autenticaçãoCaso não sejam mais necessários, é possível excluir os namespaces incluídos oudesconfigurar os detectados pelos componentes do IBM Cognos.

Capítulo 8. Configurando Componentes do IBM Cognos para Usar um Provedor de Autenticação 203

Page 216: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Você não deve excluir o namespace Cognos. Ele contém dados de autenticação quepertencem 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 dadosde segurança para o namespace permanecem no Content Manager até serempermanentemente excluídos no portal. Para obter informações adicionais, consulteo Guia de Administração e Segurança do IBM Cognos Business Intelligence.

Procedimento1. Em cada local em que instalou o Content Manager, abra o Cognos

Configuration.2. Na janela Explorer, em Segurança > Autenticação, clique com o botão direito

do mouse 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 logonno namespace nesse local.

4. No menu Arquivo, clique em Salvar.5. Repita as etapas 1 a 4 para cada local onde o Content Manager foi instalado.

É preciso agora fazer logon no portal e excluir permanentemente os dados donamespace. Para obter informações adicionais, consulte o Guia de Administraçãoe Segurança do IBM Cognos Business Intelligence.

Resultados

Após a exclusão de um namespace, ele aparece como Inativo no portal.

204 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 217: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Capítulo 9. Opções de Configuração

Após você instalar e configurar os componentes do IBM Cognos, é possível alterara configuração do seu ambiente. Inicialmente, as configurações padrão sãoutilizadas para configurar os componentes. No entanto, é possível alterar asconfigurações padrão se as condições existentes tornarem as opções padrãoinapropriadas, ou para adequar melhor seu ambiente.

Por exemplo, é possível configurar recursos para o IBM Cognos ApplicationFirewall ou especificar a quantidade de recursos usada pelos componentes do IBMCognos. Além disso, é possível entregar conteúdo do IBM Cognos usando outroportal configurando o Portal Services.

É possível configurar componentes do IBM Cognos para usar outros recursos,como usar um provedor de autenticação e depois ativar a conexão única para aconexão do banco de dados e os usuários.

Se utilizar um esquema de balanceamento de carga no ambiente, será possívelalterar as configurações e melhorar o desempenho. Por exemplo, é possívelbalancear solicitações entre dispatchers alterando sua capacidade de processamentoou definindo um número máximo e mínimo de processos e conexões. Para obtermais informações sobre ajuste de desempenho de servidor, consulte o Guia deadministração e segurança.

Para todas as instalações de sistema operacional Microsoft Windows e a maioriadas instalações do sistema operacional UNIX e Linux, use o IBM CognosConfiguration para fazer suas configurações. No entanto, se o console conectado aocomputador UNIX ou Linux no qual você está instalando os componentes IBMCognos não suportar uma interface gráfica de usuário baseada em Java, seránecessário editar manualmente o arquivo cogstartup.xml no diretórioc10_location/configuration e, em seguida, executar o IBM Cognos Configurationno modo silencioso.

Use essas tarefas de configuração opcionais para customizar sua configuração paraque os componentes do IBM Cognos se integrem facilmente ao seu ambienteexistente.

Início do IBM Cognos ConfigurationUse a ferramenta de configuração, IBM Cognos Configuration, para configurar oIBM Cognos ou para iniciar e parar os serviços do IBM Cognos.

Antes de iniciar o IBM Cognos Configuration, certifique-se de que o ambienteoperacional esteja devidamente configurado. Por exemplo, certifique-se de quetodas as variáveis foram definidas.

Você deve iniciar o IBM Cognos Configuration na última página do assistente deinstalação nos sistemas operacionais Microsoft Windows, UNIX ou Linux somentese a configuração adicional não for necessária. Por exemplo, se você usar umservidor de banco de dados diferente do Microsoft SQL para o armazenamento deconteúdo, copie os drivers JDBC no local apropriado antes de iniciar a ferramentade configuração.

© Copyright IBM Corp. 2005, 2014 205

Page 218: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Para iniciar o IBM Cognos Configuration em um computador Windows,v No menu Iniciar, clique em Programas > IBM Cognos 10 > IBM Cognos

Configuration.

Para iniciar o IBM Cognos Configuration em um computador UNIX ou Linux,v Acesse o diretório c10_location/bin e digite

./cogconfig.sh

Alterando a Versão do Java Usada pelos Componentes do IBMCognos BI

Os componentes do IBM Cognos Business Intelligence precisa que um JavaRuntime Environment (JRE) opere.

É possível mudar a versão do Java em situações nas quais deseja usar oscomponentes do IBMCognos BI com um servidor de aplicativos que requer umaversão JRE específica ou você já usa uma versão do JRE com outros aplicativos.

Execute as etapas a seguir para alterar a versão do Java:1. Faça backup das chaves de criptografia e dos dados existentes do IBMCognos,

se necessário.2. Atualize o ambiente Java.Conceitos relacionados:“Requisitos Java” na página 32Para suportar os serviços criptográficos no IBM Cognos Business Intelligence, podeser necessário atualizar sua versão do Java ou configurar uma variável de ambienteJAVA_HOME. Dependendo dos requisitos da sua política de segurança, tambémpoderá ser necessário instalar o arquivo de políticas Java Cryptography Extension(JCE) não restrito.

Fazendo backup de informações existentes do IBM CognosDeve-se fazer backup de informações existentes do IBM Cognos se você estiveralterando seu Java.

Nota: Faça backup de informações do IBM Cognos dentro do ambiente de trabalhoantes de alterar seu Java.

Antes de configurar componentes do IBM Cognos BI para execução em um novoJava, deve-se fazer backup dev Dados de armazenamento de conteúdo criando uma exportação de implantação.v Informações de configuração por meio de sua exportação. Qualquer dado

criptografado é descriptografado durante a exportação.v chaves criptográficas salvando-as em um local diferente. Novas chaves

criptográficas devem ser criadas usando o mesmo Java que o usado peloservidor de aplicativos. Como essas chaves só podem ser criadas se as chavesanteriores forem excluídas, é importante fazer backup das chaves anteriores.

Para garantir a segurança e a integridade dos dados do IBM Cognos, faça backupdo armazenamento de conteúdo, das informações de configuração e das chavescriptográficas em um diretório protegido contra acesso desautorizado ouimpróprio.

206 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 219: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Dica: Para verificar se existe alguma chave criptográfica, consulte o diretórioc10_location/configuration. Chaves criptográficas existirão se o diretório incluiros seguintes subdiretórios: csk, encryptkeypair ou signkeypair.

Procedimento1. Se existirem dados no armazenamento de conteúdo, inicie o serviço do IBM

Cognos e exporte o armazenamento de conteúdo inteiro usando a ferramentade Implementação.Para obter informações adicionais, consulte o tópico sobre a criação de umaespecificação de implementação de exportação no IBM Cognos BusinessIntelligence: Guia de Administração e Segurança.

2. No IBM Cognos Configuration, no menu Arquivo, clique em Exportar como esalve as informações de configuração em um formato decriptografado. Aonomear um arquivo, use um nome como decrypted.xml.Exporte os dados para um diretório que esteja protegido contra acesso nãoautorizado ou indevido, pois as senhas são armazenadas como texto comum. Ésolicitado o reconhecimento de que a exportação é uma operação insegura.

3. Pare o serviço do IBM Cognos:v Se você usar o servidor de aplicativos fornecido com IBM Cognos BI, pare o

serviço do IBM Cognos e feche o IBM Cognos Configuration.v Se você usar um servidor de aplicativos além do fornecido com o IBM

Cognos BI, encerre o IBM Cognos BI em seu ambiente.4. Faça backup de quaisquer chaves criptográficas existentes salvando os arquivos

e diretórios apropriados em um local diferente que seja seguro.Os arquivos sãov c10_location/configuration/cogstartup.xml

v c10_location/configuration/caSerial

v c10_location/configuration/cogconfig.prefs

v c10_location/configuration/coglocale.xml

Os diretórios sãov c10_location/configuration/csk

v c10_location/configuration/encryptkeypair

v c10_location/configuration/signkeypair

5. Exclua os arquivos caSerial e cogconfig.prefs e os três diretórios: csk,encryptkeypair e signkeypair.

6. Substitua o arquivo c10_location/configuration/cogstartup.xml pelo arquivoque contém os dados exportados do IBM Cognos Configuration (por exemplo,decrypted.xml).No diretório c10_location/configuration, o arquivo deve usar o nomecogstartup.xml.As informações neste arquivo são automaticamente criptografadas novamenteusando novas chaves criptográficas quando se salva a configuração no IBMCognos Configuration.

Mude a sua Versão do JavaÉ possível mudar a versão do Java em situações nas quais deseja usar oscomponentes do IBM Cognos BI com um servidor de aplicativos que requer umaversão JRE específica ou você já usa uma versão do JRE com outros aplicativos.Mude as versões do Java configurando a variável de ambiente JAVA_HOME.

Capítulo 9. Opções de Configuração 207

Page 220: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

JAVA_HOME

Defina uma variável de ambiente JAVA_HOME se:v Estiver instalando em um sistema operacional UNIX ou Linux.v Estiver instalando em sistemas operacionais Microsoft Windows e desejar usar o

seu próprio Java ou um pacote configurável Java com outro software. Porexemplo, se estiver instalando o IBM Cognos BI no WebSphere ApplicationServer.

Certifique-se de que a versão do JRE é suportada pelos produtos IBM Cognos.

Em sistemas operacionais Microsoft Windows, se não tiver uma variávelJAVA_HOME, os arquivos JRE que são fornecidos com a instalação são usados.

Para verificar se o JRE é suportado, consulte página Relatórios de Compatibilidadede Produto IBM Software (www.ibm.com/support/docview.wss?uid=swg27042164).

Arquivo de política irrestrita do JCE

Os JREs incluem um arquivo de políticas restrito que limita a determinadosalgoritmos criptográficos e conjuntos de cifras. Se você precisar de uma gamamaior de algoritmos criptográficos e conjuntos de cifras do que a mostrada no IBMCognos Configuration, é possível fazer o download e instalar o arquivo depolíticas irrestritas JCE.

Para o Java, que é fornecido pela IBM, o arquivo de política JCE irrestrito estádisponível no website na IBM (https://www14.software.ibm.com/webapp/iwm/web/preLogin.do?source=jcesdk).

Alteração de definições de configuração padrãoQuando você instala componentes do IBM Cognos, a instalação usa as definiçõesde configuração padrão. Se você tiver alguma razão para não usar esses valorespadrão, como uma porta sendo usada por outro processo, use IBM CognosConfiguration para alterar o valor.

Se alterar o valor de uma propriedade, você deverá salvar a configuração e depoisreiniciar o serviço do IBM Cognos para aplicar as novas configurações em seucomputador.

Para instalações distribuídas, certifique-se de ter configurado todos oscomputadores nos quais instalou o Content Manager antes de alterar as definiçõesde configuração padrão nos outros computadores com o IBM Cognos. Porexemplo: é possívelv alterar a senha e o usuário padrão para o Banco de dados de conteúdo do

Cognosv alterar um URIv definir configurações criptográficasv configurar componentes do IBM Cognos para usar o IBM Cognos Application

Firewallv configurar propriedades de arquivo temporáriov configurar o gateway para usar um namespacev ativar e desativar serviços

208 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 221: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

v configurar fontesv alterar a fonte padrão para relatóriosv salvar saída de relatório em um sistema de arquivosv Configuração do banco de dados de notificação.

Após você alterar o comportamento padrão dos componentes do IBM Cognos paraadequá-los ao seu ambiente IBM Cognos, é possível configurar o Portal Services,configurar um provedor de autenticação ou testar a instalação.

Para IBM Cognos BI, é possível instalar e configurar o Framework Manager. Para oMetric Studio, é possível instalar e configurar o Metric Designer.

Alterando Senha e Usuário Padrão para o Banco de Dados deConteúdo do Cognos

Se instalar o Cognos Content Database, o banco de dados padrão criado ganharáuma ID e 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ãorealizadas usando um utilitário chamado ij. Para obter informações sobre esteutilitário, consulte a documentação do Apache Derby. A documentação estádisponível no diretório c10_location/derby10.8.2.3/docs onde o Banco de Dados deConteúdo do Cognos foi instalado.

Alterando a senha de usuário padrão para o Banco de Dados deConteúdo do CognosSe você instalar o Banco de dados de conteúdo do Cognos, o banco de dadospadrão que é criado receberá um ID do usuário e uma senha. Altere essa ID esenha de usuário.

Procedimento1. No computador onde o Banco de Dados de Conteúdo do Cognos está

instalado, acesse o diretório c10_location/derby10.8.2.3/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 comandos para criar e gerenciar oBanco de dados de conteúdo do Cognos.

3. Conecte-se ao bando de dados padrão digitando o seguinte comando doutilitário ij:connect 'jdbc:derby://localhost:1527/cm;user=cognos;password=cognos';

Se você alterou o número da porta do padrão 1527, use o número da portacorreto para seu Banco de dados de conteúdo do Cognos.O banco de dados padrão é denominado cm. O nome do banco de dadosdiferencia maiúsculas de minúsculas.

4. Mude a senha padrão do usuário cognos digitando o seguinte comando doutilitá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:

disconnect;

Capítulo 9. Opções de Configuração 209

Page 222: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Criando um novo usuário e senha para o Banco de Dados doConteúdo do CognosSe você instalar o Banco de dados de conteúdo do Cognos, o banco de dadospadrão que é criado receberá um ID do usuário e uma senha. Altere essa ID esenha de usuário.

Procedimento1. No computador onde o Banco de Dados de Conteúdo do Cognos está

instalado, acesse o diretório c10_location/derby10.8.2.3/bin.2. Inicie o utilitário ij usando o arquivo de script ij.bat ou ij.ksh.3. Conecte-se ao bando de dados padrão digitando o seguinte comando do

utilitário ij:connect 'jdbc:derby://localhost:1527/cm;user=cognos;password=cognos';

Se você alterou o número da porta do padrão 1527, use o número da portacorreto para seu Banco de dados de conteúdo do Cognos.O banco de dados padrão é denominado cm. O nome do banco de dadosdiferencia maiúsculas de 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 oseguinte 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 delimitadopor vírgulas. Nesta etapa, um novo usuário está sendo incluído na lista deusuários com acesso total. O usuário padrão, cognos, ainda é parte da lista deusuários com acesso total. É possível remover esse usuário.

6. Feche o utilitário ij digitando o seguinte comando:disconnect;

Removendo um UsuárioSe você possuir contas de usuário que não esteja usando mais para o CognosContent Database, poderá removê-las.

Procedimento1. No computador em que o Banco de Dados de Conteúdo do Cognos está

instalado, acesse o diretórioc10_location/derby10.8.2.3/bin.2. Inicie o utilitário ij usando o arquivo de script ij.bat ou ij.ksh.3. Conecte-se ao bando de dados padrão digitando o seguinte comando do

utilitário ij:connect 'jdbc:derby://localhost:1527/cm;user=NewUser;password=NewUserPassword';

4. Escolha o tipo de usuário que deseja remover:v 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. Porexemplo, o comando anterior remove o usuário do Cognos padrão e mantémo novo usuário que acabou de ser criado.

210 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 223: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

v Para remover um usuário do banco de dados, digite o seguinte comando ij eomita 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émremove o usuário do banco de dados.

5. Feche o utilitário ij digitando o seguinte comando:disconnect;

Configurações de Porta e URIÉ possível mudar alguns elementos em um URI dependendo de seu ambiente. UmURI do IBM Cognos contém os seguintes elementos:v Para o URI do Content Manager URI, URI do dispatcher para aplicativos

externos, ou URI do dispatcherprotocol://host_name_or_IP:port/context_root/alias_path

v Para o URI do gateway ou o URI do conteúdo na webprotocol://host_name_or_IP:port/virtual_directory/gateway_application

ouprotocol://host_name_or_IP:port/context_root/alias_path

Os elementos estão descritos na tabela a seguir:

Tabela 45. Elementos e Descrições da URI do IBM Cognos

Elemento Descrição

protocolo Especifica o protocolo usado para solicitar e transmitirinformações, Hyper Text Transfer Protocol ou Hyper TextTransfer Protocol (Seguro).

Exemplo: http ou https

nome ou IP do host Especifica a identidade do host na rede. É possível usar umendereço IP, um nome de computador ou um nome dedomínio totalmente qualificado.

Em uma instalação distribuída, é necessário alterar oelemento de localhost de um URI.

Em um ambiente misto dos servidores de sistema operacionalUNIX e Microsoft Windows, certifique-se de que os nomes dehost possam ser resolvidos para os endereços IP por todos osservidores no ambiente.

Exemplo: localhost ou 192.168.0.1 ou[2001:0db8:0000:0000:0000:148:57ab]:80

porta Especifica a porta em que o sistema de host ouve pedidos.

A porta padrão para os serviços do IBM Cognos BI é 9300. Aporta padrão de um servidor web é 80.

Exemplo: 9300 ou 80

raiz do contexto Usada pelo servidor de aplicativos para determinar ocontexto do aplicativo para que a solicitação possa serencaminhada para o aplicativo da web correto paraprocessamento.

Exemplo: p2pd

Capítulo 9. Opções de Configuração 211

Page 224: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Tabela 45. Elementos e Descrições da URI do IBM Cognos (continuação)

Elemento Descrição

caminho do alias Usado pelo servidor de aplicativos para distribuir umasolicitação ao componente padrão em um aplicativo web.

O caminho do alias não deve ser modificado ou oscomponentes do IBM Cognos não funcionarão corretamente.

Exemplo: servlet/dispatch

diretório virtual Usado pelo servidor web para mapear um diretório virtualou alias em um local físico.

Por exemplo, no URI do gateway padrão dehttp://localhost:80/ibmcognos/cgi-bin/cognos.cgi, odiretório virtual é ibmcognos/cgi-bin.

Exemplo: ibmcognos/

aplicativo do gatewayEspecifica o nome do aplicativo gateway do Cognos usado.

Por exemplo, se você estiver acessando componentes do IBMCognos usando uma Interface Gateway Comum (CGI), oaplicativo gateway padrão será cognos.cgi.

Exemplo: cognos.cgi

Mudança de uma configuração de porta ou de URIUse o seguinte procedimento para alterar as propriedades de URI no IBM CognosConfiguration.

Procedimento1. Inicie o IBM Cognos Configuration.2. Na janela Explorer, clique no grupo ou componente apropriado:

v Para alterar um elemento para o dispatcher, clique em Ambiente.v Para alterar um elemento do servidor de log local, em Ambiente, clique em

Criação de 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:

v Para alterar a porta usada pelo dispatcher local, mude o valor dapropriedade do URI do dispatcher interno. Você deve alterar os URI de todosos componentes locais devido ao fato da mudança afetar todos os URIbaseados no dispatcher local.

v Se a porta do dispatcher for alterada, verifique se o novo número de portafoi especificado durante a configuração dos computadores remotos que usameste recurso, o Content Manager ou serviços Software Development Kit nestesistema.

5. No menu Arquivo, clique em Salvar.

212 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 225: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Configuração de definições criptográficasOs componentes do IBM Cognos requerem um provedor de criptografia; casocontrário, não serão executados. 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:v definições criptográficas geraisv definições para o provedor de criptografia padrãov definições para um provedor de criptografia em uma infraestrutura de

segurança Entrust

Configuração de definições criptográficas geraisEm uma instalação distribuída, os computadores IBM Cognos se comunicam com oContent Manager para estabelecer a confiança e obter algumas chavescriptográficas do Content Manager.

Se alterar as chaves criptográficas no Content Manager, como alterando osservidores de aplicativos ou reinstalando o Content Manager, você deverá excluiras chaves criptográficas nos outros computadores IBM Cognos. Então é necessáriosalvar as configurações em cada computador para que possam obter as novaschaves criptográficas do Content Manager. Além disso, todos os componentes doIBM Cognos em uma instalação distribuída devem ser configurados com asmesmas definições do provedor de criptografia.

Também, em um ambiente de distribuição, a chave simétrica deve ser armazenadasomente nos computadores em que o Content Manager foi instalado.

É possível configurar as seguintes definições criptográficas gerais:v conformidade de normas

Especifica qual norma criptográfica será usada, IBM Cognos ou NIST SP800-131A.

v propriedades de armazenamento de chave simétrica comum (CSK)A CSK é usada pelo IBM Cognos para criptografar e decriptografar dados.

v definições do secure sockets layer (SSL)Essas definições incluem autenticação mútua e confidencialidade.

v definições avançadas de algoritmoEsses incluem algoritmos de resumo e de logon.

Procedimento1. Inicie o IBM Cognos Configuration.2. Na janela Explorer, em Segurança, clique emCriptografia.3. Na janela Propriedades, mude os valores padrão clicando na caixa de diálogo

Valor e selecionando o valor adequado:v As opções para cumprimento de conformidade de normas incluem o IBM

Cognos e o NIST SP 800-131A. Este valor pode fazer com que a operação desalvamento falhe se outros parâmetros não forem permitidos no padrãoselecionado. Deve-se alterar o algoritmo selecionado ou a conformidade dasnormas. Talvez seja necessário instalar arquivos de política de jurisdiçãoilimitada do JRE para permitir todos os algoritmos suportados. Eles estãodisponíveis a partir daIBM.

Capítulo 9. Opções de Configuração 213

Page 226: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

v Nos computadores que não contêm o Content Manager, se não desejararmazenar as CSKs localmente, altere Armazenar chave simétrica localmentepara Falso, em Configurações CSK.Quando Armazenar chave simétrica localmente for Falso, a chave érecuperada do Content Manager quando solicitado. A propriedadeLocalização do keystore simétricas comuns é ignorada.

v Se deseja que os computadores de ambos os lados de uma transmissãoprovem sua identidade, mude Utilizar autenticação mútua para Verdadeiro,em Configurações SSL.Não altere a configuração Utilizar confidencialidade.

v Se desejar mudar o algoritmo de resumo, selecione outro valor napropriedade Algoritmo digest.

4. No menu Arquivo, clique em Salvar.5. Teste o provedor de criptografia somente em um computador de gateway. Na

janela Explorer, clique com o botão direito em Criptografia e clique em Testar.Os componentes do IBM Cognos verificam a disponibilidade da chavesimétrica.

Resultados

Depois de ter configurado as definições criptográficas, as senhas em suasconfigurações e todos os dados criados são criptografados.

Configuração das definições para o provedor de criptografiapadrãoÉ possível fazer algumas configurações criptográficas para o provedor decriptografia.

As definições configuráveis incluem o seguinte:v algoritmos e conjuntos de códigosv definições do nome de identidadev propriedades do keystore de assinatura

O par de chaves de assinatura inclui a chave privada usada para gerar aassinatura digital e a chave pública usada para verificar a autenticidade.

v propriedades do keystore de assinaturaO par de chaves de criptografia inclui a chave privada usada para criptografardados e a chave pública usada para descriptografar dados.

v configuração da autoridade de certificaçãoIncluem propriedades da autoridade de certificação fornecida ou de uma CA deterceiros.

Procedimento1. Se você estiver usando um JRE diferente daquele fornecido com o servidor IBM

Cognos, acesse o c10_location/bin/jre/version/lib/ext.Se você estiver usando componentes de 64 bits, acesse o diretórioc10_location/bin64/jre/version/lib/ext.

2. Copie bcprov-jdkversion.jar no JRE_location/lib/ext.3. Se estiver usando um JRE diferente do fornecido pela IBM, você também deve

fazer download e instalar o arquivo de políticas irrestrito Java Cryptograph

214 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 227: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Extension (JCE) para seu JRE para assegurar que todos os algoritmos econjuntos de códigos disponíveis sejam mostrados em IBM CognosConfiguration.

4. Inicie o IBM Cognos Configuration.5. Na janela Explorer, em Segurança, Criptografia, clique em Cognos.6. Na janela Propriedades, altere as propriedades, conforme necessário.

v Para configurar o algoritmo de confidencialidade, na propriedade adequada,Algoritmo de confidencialidade ou Algoritmo de confidencialidade PDF,clique na coluna Valor e selecione o algoritmo na lista suspensa.O valor do algoritmo de confidencialidade determina como os dados sãocriptografados pelos componentes do IBM Cognos. Por exemplo, senhas dobanco de dados inseridas no IBM Cognos Configuration são criptografadasquando você salva a configuração. O algoritmo selecionado quando os dadossão criptografados também devem estar disponíveis para os dados paraserem criptografados mais tarde.A disponibilidade dos algoritmos de confidencialidade podem mudar sehouver mudanças em seu ambiente Por exemplo, se seu Java RuntimeEnvironment (JRE) tiver mudado ou se você tiver instalado outro softwarecriptográfico no computador. É necessário verificar se o Algoritmo deconfidencialidade selecionado quando os dados foram criptografadostambém está disponível quando desejar acessar os dados.Se foram feitas mudanças em um computador, como uma atualização no JREou a instalação de um software que atualizou o JRE, isto pode afetar adisponibilidade dos algoritmos de confidencialidade. Para garantir que osconjuntos de códigos e algoritmos disponíveis sejam mostrados no IBMCognos Configuration, faça o download e instale o arquivo de políticas JavaCryptography Extension (JCE) irrestrito. Para o Java que a IBM fornece, oarquivo de políticas JCE restrito pode ser transferido por download dosArquivos de Política JCE Irrestritos (https://www14.software.ibm.com/webapp/iwm/web/preLogin.do?source=jcesdk).

v Para ajustar os conjuntos de cifras, em Conjuntos de Cifras Suportados,

clique na coluna Valor e, em seguida, clique no ícone de edição .Remova os conjuntos de códigos que não são aplicáveis e mova os conjuntosremanescentes para cima ou para baixo na lista para que aqueles conjuntosde códigos na faixa mais alta estejam na posição mais alta da lista.Não misture conjuntos de códigos na faixa de 40 a 56 bits com conjuntos decódigos na faixa de 128 a 168 bits.

v Para mudar o local das chaves de assinatura, em Configurações das chavesde assinatura, mude a propriedade Localização do keystore de assinaturapara o novo local.

v Para mudar o local das chaves de criptografia, em Configurações da chavede criptografia, mude Localização do keystore de criptografia para o novolocal.

v Para usar outra autoridade de certificação, em Configuração da autoridadede certificação, altere Utilizar CA de terceiros para Verdadeiro.Também é necessário garantir o uso dos mesmos valores para o parâmetro -kusados nas propriedades Localização do keystore de assinatura eLocalização do keystore de criptografia.Para obter mais informações, consulte “Configurando Componentes do IBMCognos para Usar Outra Autoridade de Certificação” na página 234.

7. No menu Arquivo, clique em Salvar.

Capítulo 9. Opções de Configuração 215

Page 228: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Resultados

Se você usar outro servidor de Autoridade de Certificação (CA), configure oscomponentes do IBM Cognos para usar o CA. Para obter mais informações,consulte “Configurando Componentes do IBM Cognos para Usar OutraAutoridade de Certificação” na página 234.

Configuração das definições do provedor de criptografia em umainfraestrutura de segurança EntrustPara configurar a criptografia em uma infraestrutura de segurança Entrust,substitua o provedor de criptografia padrão no IBM Cognos Configuration por umprovedor que você configurar para Entrust e atualize os arquivos de segurança noambiente do IBM Cognos.

Antes de Iniciar

Verifique se as senhas dos bancos de chaves correspondem às do Perfil Entrust(EPF)

Para evitar erros de gateway, assegure-se de que a Conta Guest da Internet tenhapermissão de leitura e gravação ao arquivo .epf do Entrust e permissão de leituraao arquivo .ual do Entrust.

Procedimento1. Se você estiver usando um JRE diferente daquele fornecido com o servidor

IBM Cognos, acesse o c10_location/bin/jre/version/lib/ext.Se você estiver usando componentes de 64 bits, acesse o diretórioc10_location/bin64/jre/version/lib/ext.

2. Copie bcprov-jdkversion.jar no JRE_location/lib/ext.3. Assegure-se de que os seguintes arquivos do IBM Cognos e Entrust existam

no local em que o JRE está instalado:v No Entrust Authority Security Toolkit do qual foi feito download a partir

do Entrust, copie o arquivo .jar file, como enttoolkit.jar, noJRE_location/lib/ext.

4. Para garantir que todos os conjuntos de códigos e algoritmos disponíveissejam mostrados no IBM Cognos Configuration, faça o download e instale oarquivo de políticas Java Cryptography Extension (JCE) irrestrito. Para o Javaque a IBM fornece, o arquivo de políticas JCE restrito pode ser transferido pordownload dos Arquivos de Política JCE Irrestritos (https://www14.software.ibm.com/webapp/iwm/web/preLogin.do?source=jcesdk).

5. Inicie o IBM Cognos Configuration.6. Na janela Explorer, no grupo Segurança, clique emCriptografia.7. Na janela Propriedades, em Configurações avançadas de algoritmo, altere o

Algoritmo digest para o algoritmo digest de mensagem adequado ou para oalgoritmo hash seguro para a sua política de segurança.

8. Na janela Explorer, no grupo Segurança e no componente Criptografia, cliquecom o botão direito no recurso IBM Cognos e clique em Excluir.

9. No grupo Segurança, clique com o botão direito do mouse em Criptografia eclique em Novo Recurso > Provedor.

10. No campo Nome, digite um nome para o serviço de criptografia que estácriando.

11. No campo Tipo, clique na seta e em Entruste, em seguida, clique em OK.Uma ramificação com o nome designado aparece em Criptografia.

216 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 229: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

12. Clique na ramificação criou.As propriedades de recursos aparecerão na janela de propriedades.

13. Na janela Propriedades do Recurso, insira os valores apropriados, conformelistados na tabela a seguir:

Tabela 46. Valores e Descrições das Propriedades de Criptografia

Propriedade Descrição

Localização do arquivo INI A localização do arquivo de inicialização(.ini) do Entrust.

Nome distinto de arquivo de identidade(DN)

O nome distinto associado ao perfil daidentidade do Entrust.

Localização do arquivo de identidade A localização do arquivo de perfil (.epf) daidentidade do Entrust.

Utilizar login do servidor Entrust O parâmetro que controla se os usuáriosdevem digitar uma senha para fazer logonno Entrust PKI.

Senha do arquivo de identidade A senha do Entrust Profile, que devecorresponder à senha no Entrust Profile(EPF).

Algoritmo de confidencialidade O nível de criptografia que é necessário paraficar em conformidade com a política desegurança.

Algoritmo de confidencialidade PDF O algoritmo de criptografia a ser usadoquando criptografar dados PDF.

Ciphersuites com suporte Os conjuntos de códigos que são suportadosem seu ambiente de segurança. Remova osque não se aplicam e reorganize osconjuntos de códigos restantes do mais altopara o mais baixo. Isso garante que oconjunto de códigos mais seguro seja usadoprimeiro.

Localização do keystore de assinatura A localização do banco de dados de chavesque contém os pares de chaves deassinatura.

Localização do keystore de criptografia A localização do keystore que contém ospares de chaves de criptografia.

Importante: Registre as senhas em um local seguro.14. No menu Arquivo, clique em Salvar.15. Atualize para o Entrust Java Toolkit 7.2 SP2 Patch 170072.

IBM Cognos Application FirewallIBM Cognos Application Firewall analisa e valida solicitações de HTTP e XMLantes de elas serem processadas pelos servidores IBM Cognos. IBM CognosApplication Firewall pode modificar essas solicitações de HTTP e XML.

IBM Cognos Application Firewall protege produtos da Web do IBM Cognos contradados dolosos. As formas mais comuns de dados mal-intencionados são de estourode buffer e ataques de scripts de cross-site scripting (XSS), através de injeção descripts em páginas válidas ou redirecionamento para outro Web site.

Capítulo 9. Opções de Configuração 217

Page 230: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

É possível rastrear atividades de firewall verificando o arquivo de log, que contémsolicitações rejeitadas. Por padrão, as mensagens de log são armazenadas noarquivo c10_location/logs/cogserver.log.

Todas as configurações do Cognos Application Firewall devem ser as mesmas paratodos os computadores nos quais os Componentes da Camada de Aplicativos doIBM Cognos estão instalados em um ambiente distribuído. Por exemplo, se oCognos Application Firewall estiver desativado em alguns computadores e ativadoem outros, o resultado poderá ser um comportamento inesperado e erros doproduto.

Os seguintes tipos de URLs são aceitos pela validação do Cognos ApplicationFirewall:v 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

v URLs relativos ao diretório de instalação webno formato /raiz_instalação_web/.* em que raiz_instalação_web é o diretório degateway web, baseado no alias ibmcognos configurado em seu servidor web.Por exemplo,/ibmcognos/ps/portal/images/action_delete.gif

v URLs específicos permitidos, incluindo o seguinte (nenhum diferenciamaiúsculas de minúsculas)about:blankJavaScript:window.close( )JavaScript:parent.close( )JavaScript:history.back( )parent.cancelErrorPage( )doCancel( )

Configurando Componentes do IBM Cognos para Usar IBMCognos Application FirewallUsando IBM Cognos Configuration, é possível alterar configurações para o suportede outra ferramenta XSS e incluir nomes de host e domínio na lista do IBMCognos de nomes válidos.

Procedimento1. Em cada local em que os Componentes da Camada de Aplicativos IBM Cognos

BI estão instalados, inicie o IBM Cognos Configuration.2. Na janela Explorer, em Segurança, clique em IBM Cognos Application

Firewall.3. Na janela Propriedades, na propriedade Habilitar a validação do CAF, defina

os valores adequados.Por padrão, o IBM Cognos Application Firewall fica ativado.

Importante: O IBM Cognos Application Firewall é um componente essencialpara a segurança do IBM Cognos, ajudando a fornecer proteção contravulnerabilidades de invasão. A desativação do IBM Cognos ApplicationFirewall removerá a proteção. Sob circunstâncias normais, não desative o IBMCognos Application Firewall.

218 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 231: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

4. Se estiver usando outra ferramenta XSS que verifica caracteres específicos nosparâmetros de solicitação GET, na janela Propriedades, para a propriedade Averificação XSS de terceiros está habilitada, altere o valor para Verdadeiro.Os caracteres padrão que são proibidos incluem >, < e '.

5. Inclua nomes de host e domínio na lista do IBM Cognos de nomes válidos:v Para a propriedade Domínios e Hosts Válidos, clique no valor e, em

seguida, clique no ícone de edição .v Na caixa de diálogo Valor - Domínios ou hosts válidos, clique em

Adicionar.Você deve incluir os domínios de todos os hyperlinks que estão incluídos noIBM Cognos Connection. Para obter informações adicionais, consulte o tópicosobre a criação de uma URL no IBM Cognos Business Intelligence: Guia deAdministração e Segurança.

Dica: Se estiver usando drill through do IBM Cognos Series 7 para relatóriosno IBM Cognos BI, inclua os nomes de host dos servidores gateway do IBMCognos Series 7 na lista.

v 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 caracterecuringa no início do nome do domínio.Por exemplo, *.mycompany.com

v Repita as duas etapas anteriores marcadas para cada nome a ser adicionado.v Clique em OK.IBM Cognos Application Firewall valida nomes de host e domínio paraproteger as URLs que são criadas. Por padrão, o IBM Cognos ApplicationFirewall considera nomes de domínio derivados das propriedades deconfiguração de ambiente como nomes de domínio seguros. A inclusão denomes à lista de nomes e hosts válidos é útil quando você precisa redirecionarsolicitações para computadores não IBM Cognos usando as funções Voltar ouCancelar ou ao usar drill through em instalações de diferentes produtos IBMCognos.

6. Salve a configuração.7. Reinicie os serviços.

Criptografia de propriedades de arquivo temporárioArquivos temporários são usados no IBM Cognos BI para armazenar relatóriosvisualizados recentemente e para armazenar dados usados pelos serviços durante oprocessamento. É possível alterar o local dos arquivos temporários e optar porcriptografar seu conteúdo.

Por padrão, os componentes do IBM Cognos armazenam arquivos temporários nodiretório c10_location\temp e os arquivos não são criptografados.

Para otimizar a segurança, negue todos os acessos ao diretório temporário, excetopara a conta do serviço usada para iniciar os serviços do IBM Cognos. Sãonecessárias permissões de leitura e gravação para a conta do serviço.

Procedimento1. Inicie o IBM Cognos Configuration.2. Na janela Explorer, clique em Ambiente.

Capítulo 9. Opções de Configuração 219

Page 232: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

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 do usuário sob a qual os componentes do IBMCognos BI são executados tenha os privilégios apropriados para o local dosarquivos temporários. Por exemplo:v nos sistemas operacionais Microsoft Windows, privilégios de controle integralv nos sistemas operacionais UNIX ou Linux, privilégios de leitura/gravação

Configuração do gateway para usar um namespaceSe os componentes do IBM Cognos usarem diversos namespaces, ou se o acessoanônimo estiver ativado e os componentes do IBM Cognos usarem um namespace,é possível configurar o gateway para se conectar a um namespace. Os usuárioslogados no servidor web em que o gateway está localizado não são avisados paraescolher uma fonte de autenticação. Por exemplo, se tiver dois servidores web, épossível configurar cada servidor web para usar um namespace diferente.

Procedimento1. No computador no qual gateway está localizado, inicie o IBM Cognos

Configuration.2. Na janela Explorer, clique em Ambiente.3. Na janela Propriedades, na caixa Valor ao lado da propriedade Namespace do

gateway, digite a ID do namespace que deseja usar.4. No menu Arquivo, clique em Salvar.5. Reinicie seu servidor web.

Ativação e desativação de serviçosEm uma instalação de distribuição, é possível enviar certos tipos de solicitaçõespara 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 TierComponents. Para indicar que um computador em uma instalação distribuída paraprocessar solicitações do aplicativo Metric Studio, desative o Serviço de integraçãode dados no computador.

Nota: Os valores padrão para o serviço do dispatcher e o serviço de apresentaçãosão "false" em computadores que têm apenas o Content Manager instalado. Emtodos os outros tipos de instalação, os valores padrão são verdadeiros.

Se foram instalados todos os componentes em diversos computadores, é possíveldesativar serviços adequados em cada computador para obter a configuração dedistribuição solicitada. Solicitações são enviadas somente para dispatchers em quedado serviço é ativado.

Desativar um serviço impede-o de carregar na memória. Ao serem desativados, osserviços não são iniciados e em consequência não consomem recursos. O serviçovirtual não executa até que seja ativado.

Se desativar o serviço do dispatcher, os serviços relacionados ao dispatcher sãodesativados. Somente os serviços do dispatcher que são ativados podem processarsolicitações.

220 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 233: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Ativando e Desativando ServiçosUse o seguinte procedimento para desativar serviços selecionados em componentesem uma instalação distribuída.

Procedimento1. Inicie o IBM Cognos Configuration.2. Na janela Explorer, em Ambiente, clique em Serviços do IBM Cognos.3. Na janela Propriedades, clique em Valor próximo ao serviço que deseja ativar

ou desativar.Por padrão, todos os serviços estão ativados.

4. Clique no estado adequado para os serviços:v Para desativar o serviço, clique em Falso.v Para ativar o serviço, clique em Verdadeiro.

5. No menu Arquivo, clique em Salvar.

Configurando FontesOs componentes do IBM Cognos usam fontes para renderizar relatórios PDF noservidor IBM Cognos. Os componentes do IBM Cognos também usam fontes pararenderizar gráficos em relatórios PDF e HTML.

Para mostrar a saída corretamente, as fontes devem estar disponíveis onde orelatório ou gráfico são processados. Para gráficos e relatórios em PDF, as fontesdevem ser instaladas no servidor IBM Cognos. Se uma fonte solicitada não estiverdisponível, os componentes do IBM Cognos substituirão uma fonte diferente.

Como os relatórios HTML são renderizados em um navegador, as fontesnecessárias devem ser instaladas no computador de cada usuário do IBM Cognosque visualiza o relatório. Caso uma fonte solicitada não esteja disponível, onavegador a substituirá por uma fonte diferente.

Utilize a seguinte lista de verificação se deseja utilizar uma nova fonte nosrelatórios.__ v Adição da fonte à lista de fontes suportadas.__ v Especificação do local do arquivo da nova fonte.__ v Mapeamento da nova fonte para o nome da fonte física, se solicitado.

Considerações para Suportar o Chinês Simplificado

Os produtos do IBM Cognos BI suportam o conjunto de caracteres GB18030-2000,que é usado na codificação de códigos do idioma chinês simplificado.

Se você instalar no Microsoft Windows, o suporte será fornecido para o conjuntode caracteres GB18030-2000 na fonte SimSun-18030, fornecida pela Microsoft.

Em sistemas operacionais diferentes do Windows, você deve instalar uma fonteque suporte GB18030-2000.

Incluindo Fontes no Ambiente do IBM CognosÉ possível incluir fontes na lista de fontes suportadas no ambiente do IBM Cognosse você quiser gerar relatórios que usem fontes que não estão disponíveisatualmente. Também é possível remover fontes. Por padrão, os componentes doIBM Cognos usam um conjunto global de fontes, que estão disponíveis em todosos computadores servidores IBM Cognos.

Capítulo 9. Opções de Configuração 221

Page 234: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Procedimento1. Em cada computador que tiver 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 Incluir.

Dica: Para remover uma fonte da lista de fontes suportadas, clique na caixapróxima do nome da fonte e clique em Remover.

5. Na caixa Nome da Fonte com Suporte, digite o nome da fonte e clique em OK.6. No menu Arquivo, clique em Salvar.

Todas as fontes globais, incluindo as novas fontes incluídas, devem serinstaladas em todos os computadores do ambiente que tenham o IBM Cognos.

Resultados

Se uma fonte global não estiver instalada em todos os computadores IBM Cognos,você deverá mapear a fonte global para uma fonte física instalada.

Especificando o local das fontes disponíveisÉ necessário especificar o local de instalação de todas as fontes, incluindo aquelasque foram adicionadas à lista de fontes suportadas.

Por padrão, a lista de fontes consiste nas fontes instaladas no diretórioc10_location\bin\fonts do computador do IBM Cognos. Se os componentes doIBM Cognos estiverem instalados em um computador de sistema operacionalMicrosoft Windows, eles também usarão as fontes que estão instaladas no diretóriode fonte do Windows.

Você especifica o local da fonte em todos os computadores em que o ApplicationTier Components está instalado.

Procedimento1. Em cada computador com Componentes da Camada de Aplicativos, inicie o

IBM Cognos Configuration.2. Na janela Explorer, clique em Ambiente.3. Na janela Propriedades, na propriedade Locais de fontes físicas, especifique o

local das fontes.Se houver diversos caminhos de fontes, separe cada caminho por umponto-e-vírgula (;).Se você estiver usando um servidor de aplicativos além do fornecido com oIBM Cognos BI, insira o caminho completo para o local da fonte. Por exemplo:c10_location\bin\fonts.

4. No menu Arquivo, clique em Salvar.

Mapeamento de fontes suportadas para fontes instaladasÉ possível substituir fontes globais, que não estão instaladas no computador, porfontes físicas.

Mapeie as fontes em cada computador onde o Application Tier Componentsestejam instalados.

222 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 235: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Por exemplo, inclua uma fonte na lista de fontes suportadas que não está instaladano computador IBM Cognos. É possível especificar qual fonte usar comosubstituto.

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, comoHelvetica-PDF, seguindo as etapas abaixo. Também é possível selecionar uma dasfontes de PDF integradas para um objeto de texto no Report Studio ou no QueryStudio. Para obter informações adicionais, consulte o Guia do Usuário do QueryStudio ou o Guia do Usuário do Report Studio.

Nenhum mapeamento será necessário se você incluir uma fonte na lista de fontessuportadas que não está instalada em computadores IBM Cognos. Entretanto, épreciso especificar a localização das fontes.

Procedimento1. Em cada computador com Componentes da Camada de Aplicativos, inicie o

IBM Cognos Configuration.2. Na janela Explorer, clique em Ambiente.3. Na janela Propriedades, clique na caixa Valor próxima à propriedade Mapa

de Fontes Físicas e, em seguida, clique no ícone de edição .A caixa de diálogo Valor - Mapa de fontes físicas aparece.

4. Clique em Incluir.

Dica: Para remover uma fonte, selecione a caixa de seleção próxima da fontee clique em Remover.

5. Na caixa de diálogo Nome da Fonte Global, digite o nome da fonteadicionada à 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 ícone de

edição .Na caixa de diálogo Nome da Fonte Física, clique em Procurar Agora e cliqueem um nome de fonte nos resultados.

8. Repita as etapas 4 a 7 para cada fonte global que necessita de mapeamento.9. Clique em OK.

10. No menu Arquivo, clique em Salvar.

Resultados

Agora, se necessário, especifique a localização de instalação das fontes.

Usando fontes de sistema no IBM Cognos ConfigurationÉ possível configurar o IBM Cognos Configuration para usar suas fontes dosistema em sistemas operacionais Microsoft Windows.

Nota: Se ativar configurações de fonte do sistema, não será possível alterá-las noIBM Cognos Configuration.

Capítulo 9. Opções de Configuração 223

Page 236: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Procedimento1. Acesse o diretório c10_location/configuration.2. Abra o arquivo cogconfig.prefs em um editor de texto.3. Inclua a linha a seguir:

UseSystemDisplaySetting=true

4. Salve e feche o arquivo.5. Reinicie IBM Cognos Configuration.

Alterar a Fonte Padrão de Relatórios em PDFÉ possível alterar a fonte padrão que os componentes do IBM Cognos BI usampara 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.Em seguida, a fonte torna-se o padrão para todos os computadores em suainstalação. Altere a fonte usada para relatórios em PDF usando o IBM CognosConfiguration.

Certifique-se de que a fonte padrão esteja instalada em todos os computadores emsua instalação do IBM Cognos.

Para garantir que os caracteres GB18030 sejam exibidos corretamente em relatóriosem PDF, configure a fonte padrão como SimSun-GB18030.

Procedimento1. Em cada computador que tiver o Content Manager, inicie o IBM Cognos

Configuration.2. No menu Ações, clique em Editar Configuração Global.3. Clique na guia Geral.4. Na caixa de diálogo Valor, em Fonte padrão, digite a fonte que deseja utilizar

como o padrão para relatórios.5. Clique em OK.6. No menu Arquivo, clique em Salvar.7. Em todos os computadores com Componentes da Camada de Aplicativos,

certifique-se de que o local de instalação da fonte padrão esteja especificado napropriedade Locais de fontes físicas (em Ambiente na janela Explorer) ou deque a fonte esteja em um diretório de fonte do Windows.

Configuração de fontes integradas a relatórios em PDFQuando um relatório em PDF é aberto no Adobe Reader, todas as fontes usadasnesse relatório devem estar disponíveis. As fontes devem estar integradas norelatório ou instaladas no computador do usuário. Se uma fonte não estiverdisponível em nenhum desses locais, o Adobe Reader tentará substituir uma fonteapropriada. Essa substituição pode causar mudanças na apresentação do relatórioou alguns caracteres podem não ser exibidos.

Para garantir que relatórios PDF apareçam corretamente no Adobe Reader, o IBMCognos BI integra as fontes necessárias em relatórios por padrão. Para minimizar otamanho do arquivo, o IBM Cognos BI integra apenas os caracteres (tambémchamados de glifos) usados no relatório em vez de todos os caracteres no conjuntode fontes. O IBM Cognos BI integra fontes somente se elas estiverem licenciadaspara integração. As informações sobre licença são armazenadas na própria fonte esão lidas pelo IBM Cognos BI.

224 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 237: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Se tiver certeza de que as fontes usadas nos relatórios estão disponíveis noscomputadores dos usuários, é possível limitar ou eliminar fontes integradas parareduzir o tamanho dos relatórios PDF. Ao limitar fontes, você especifica se umafonte sempre é ou nunca é integrada usando uma lista de fontes integradas no IBMCognos Configuration.

Procedimento1. No computador com Content Manager, inicie o IBM Cognos Configuration.2. Na janela Explorer, clique em Ambiente.3. Na janela Propriedades, em Configurações de Fonte, clique no valor de Fontes

a Serem Integradas (serviço de relatório em lotes) ou em Fontes a SeremIntegradas (serviço de relatório) e, em seguida, clique no ícone 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 SeremIncorporadas nos Relatórios no Formato PDF, especifique o novo caminho nacaixa de diálogo de caminhos de fontes.Dica: clique em Buscar Agora para obter uma lista de fontes disponíveis nocaminho especificado.

5. Para uma fonte que sempre estará disponível nos computadores dos usuários,role até o nome da fonte e clique na caixa de seleção Nunca.O IBM Cognos BI não integra a fonte a nenhum relatório. O Adobe Readerseleciona a fonte do computador do usuário quando o relatório é aberto.

6. Para uma fonte que pode nem sempre estar disponível nos computadores dosusuários, role até o nome da fonte e clique na caixa de seleção Sempre.O IBM Cognos BI integra a fonte a todos os relatórios que a usam. AdobeReader usa a fonte integrada 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 deconteúdo. Você tem a opção de salvar uma cópia da saída de relatório em outrolocal de arquivo que seja fora ou dentro do IBM Cognos BI. Se usar esta opção, umarquivo descritor com a extensão an _descr também é salvo. Arquivos salvos nãosão gerenciados pelo IBM Cognos BI.

Salvando Saída de Relatório Fora do IBM Cognos BISe você configurar um local de sistema de arquivos fora do IBM Cognos BI, épossível compartilhar a saída de relatório com aplicativos externos ou pessoas quenão têm o IBM Cognos BI. É assim que se salva a maioria dos arquivos de saída derelatório.

Para usar esse recurso, primeiro você deve configurar um diretório-raiz no IBMCognos Configuration. Um administrador deve configurar o local do arquivo noIBM Cognos Administration. Para obter informações adicionais, consulte o tópicosobre a configuração de um local de arquivo para a saída de relatório salva fora doIBM Cognos BI, no IBM Cognos Business Intelligence: Guia de Administração eSegurança.

Procedimento1. Crie um diretório para o sistema de arquivos.

Capítulo 9. Opções de Configuração 225

Page 238: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Dica: Certifique-se de que o diretório esteja acessível para os usuários eseparado do diretório de instalação. Por exemplo, em uma instalaçãodistribuída no Microsoft Windows, uma pasta de archive como\\servername\directory poderia ser usada.

2. No computador com Content Manager, inicie o IBM Cognos Configuration.3. No menu Ações, clique em Editar Configuração Global.4. Na janela Configuração global, clique na guia Geral.5. Para Raiz do sistema de arquivos da localização de archive, digite um URI

usando o formatofile://directory

em que diretório é o diretório criado na etapa 1.A parte arquivo:// do URI é necessária. Nomes UNC do Windows como\\servername\directory podem ser usados. Se for o caso, o URI deve serformatado como segue:file://\\servername\directory

Dica: Assegure-se de não usar uma unidade mapeada ao executar o Cognoscomo um serviço do Microsoft Windows.

6. Para confirmar que o local correto será usado, clique em Testar.7. Clique em OK.8. No menu Arquivo, clique em Salvar.

Resultados

O administrador agora deve configurar o local do arquivo. Para obter informações,consulte o tópico sobre a configuração de um local de arquivo para a saída derelatório salva fora do IBM Cognos BI, no IBM Cognos Business Intelligence: Guia deAdministração e Segurança.

Salvando Saída de Relatório Dentro do IBM Cognos BISe você configurar um local de sistema de arquivos dentro do IBM Cognos BI, épossível usar o saída de relatório novamente. Isto pode ser útil também para afinalidade de archive, pois os arquivos salvos no Armazenamento de conteúdopodem ser excluídos regularmente devido a regras de retenção.

Para usar esse recurso, primeiro você deve ativar a propriedade Salvar saídas derelatório em um sistema de arquivos no IBM Cognos Configuration. Umadministrador deve configurar o local do arquivo usando o parâmetroCM.OutPutLocation no IBM Cognos Administration. Para obter informaçõesadicionais, consulte o tópico sobre a configuração de um local de arquivo para asaída de relatório salva dentro do IBM Cognos BI, no IBM Cognos BusinessIntelligence: Guia de Administração e Segurança.

Para proteger a segurança da saída de relatório quando usar esse recurso, osistema de arquivos deve ter criptografia de terceiros.

Procedimento1. Crie um diretório para o sistema de arquivos.

Dica: Certifique-se de que o diretório esteja acessível somente para usuáriosautorizados.

2. No computador com Content Manager, inicie o IBM Cognos Configuration.3. Na janela Explorer, clique em Acesso a Dados > Content Manager.

226 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 239: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

4. Na propriedade Salvar saídas de relatórios em um sistema de arquivos, cliqueem Verdadeiro.

5. Para testar a conexão com o diretório de saída de relatório, no menu Ações,clique em Testar.

6. No menu Arquivo, clique em Salvar.

Resultados

O administrador agora deve configurar o local do arquivo usando o parâmetroCM.OutPutLocation. Para obter informações, consulte o tópico sobre aconfiguração de um local de arquivo para a saída de relatório salva dentro do IBMCognos BI, no IBM Cognos Business Intelligence: 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 sistemalocal do arquivo de relatórios. É possível alterar o local do cache de sessãotemporário para um computador remoto, como um diretório compartilhado em umsistema baseado em Microsoft Windows ou um diretório montado comum em umsistema baseado em UNIX ou Linux.

Por padrão, o local do cache de sessão temporária no sistema de arquivo derelatório é c10_location/temp/Session. O diretório Sessão é criado pelo servidor dorelatório quando a primeira solicitação da sessão do usuário é recebida.

Para configurar se a saída de relatório temporário está armazenada no ContentManager ou no sistema de arquivos de relatório local, consulte o tópico sobre oarmazenamento dos arquivos de sessão do usuário em um sistema de arquivos derelatório local no IBM Cognos Business Intelligence: Guia de Administração e Segurança.

Procedimento1. No computador em que Componentes da Camada de Aplicativos estão

instalados, inicie o IBM Cognos Configuration.2. Na janela Explorer, clique em Ambiente.3. Na janela Propriedades, clique no valor do Local de Arquivos Temporários e,

em seguida, clique no ícone de edição .4. Na caixa de diálogo Selecionar pasta, use a caixa Salvar em para localizar o

computador e o diretório e, em seguida, clique em Selecionar.5. No menu Arquivo, clique em Salvar.

Quando um usuário executa uma sessão de relatório interativa, a saída derelatórios temporários será armazenada no novo local.

Ajustando o WebSphere Liberty ProfileEm ambientes de produção, ajuste o the WebSphere Liberty Profile para permitir omáximo de usuários simultâneos esperado, ajustando os valores do coreThreadsand maxThreads nas propriedades Avançadas dos recursos. Estes valoresconfiguram as contagens principais e máximas do encadeamento do executor.

Procedimento1. Inicie o IBM Cognos Configuration.

Capítulo 9. Opções de Configuração 227

Page 240: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

2. Na janela Explorer em Environment, em serviços do IBM Cognos clique nonome dos Recursos (o padrão é IBM Cognos).

3. Na janela Propriedades, próxima à Propriedades Avançadas, clique na caixa

Valor e, em seguida, clique no ícone de edição .4. Ajuste os valores de parâmetro conforme necessário.

Tabela 47. Nomes e valores do parâmetro Recurso de Serviço

Nome doparâmetro Valor

coreThreads O número principal de encadeamentos com os quais o servidor doWebSphere Liberty Profile é iniciado. Se este valor for menor que 0, umvalor padrão será usado. Este valor padrão é calculado com base nonúmero de encadeamentos de hardware no sistema.

maxThreads O número máximo de encadeamentos que podem ser associados aoservidor do WebSphere Liberty Profile.

Para obter mais informações, consulte o WebSphere Liberty Profile KnowledgeCenter, Ajustando o perfil Liberdade (http://www.ibm.com/support/knowledgecenter/?lang=en#!/SSEQTP_8.5.5/com.ibm.websphere.wlp.doc/ae/twlp_tun.html?cp=SSEQTP_8.5.5%2F1-3-11-0-7).

5. No menu Arquivo, clique em Salvar.

Ativando replicação de sessão para serviços do Content Manager emespera

O recurso de replicação de sessão permite o failover direto do IBM CognosContent Manager entre um serviço do Content Manager ativo e um serviço doContent Manager em espera.

Com a replicação de sessão ativada, os dados da sessão do usuário são replicadosentre todas as instâncias do Content Manager. Se o Content Manager ativo falhar,os dados da sessão do usuário serão preservados e os usuários continuarão usandoo aplicativo sem interrupção.

A replicação de sessão usa duas portas para se comunicar com segurança comdiferentes IBM Cognos Content Managers configurados dentro de um únicoambiente.

Procedimento1. Em um computador no qual o IBM Cognos Content Manager está instalado,

inicie o IBM Cognos Configuration.2. Na área de janela Explorer, em Segurança, clique em Replicação.3. Especifique as propriedades a seguir:

a. Configure Ativar replicação para Verdadeiro.b. Na caixa de valor Número da porta do listener peer, insira um número de

porta.Um valor de 0 seleciona a primeira porta dinâmica disponível durante ainicialização do serviço do IBM Cognos.

c. Na caixa de valor Número da porta de replicação de RMI, insira umnúmero de porta.

228 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 241: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Nota: A Propriedades avançadas deve ser usada apenas sob orientação doSuporte Técnico IBM.

4. Salve a configuração e reinicie o serviço do IBM Cognos.5. Repita as etapas para cada instância do Content Manager em seu ambiente.

Os números de porta especificados não precisam ser idênticos para cadainstância do Content Manager.

Utilize um Armazenamento de Objeto Externo para Saída de RelatórioVocê pode configurar o Content Manager para armazenamento de saída dorelatório para uma unidade local ou compartilhamento de rede definindo umarmazenamento de objeto externo. A saída de relatório está disponível por meio doIBM Cognos Connection e IBM Cognos SDK, mas a saída de relatório não éarmazenada no banco de dados de armazenamento de conteúdo.

Utilizar um armazenamento de objeto externo para saída de relatório reduz otamanho do armazenamento de conteúdo e fornece aprimoramentos dedesempenho para o Content Manager.

Antes de Iniciar

Certifique-se de fazer o seguinte antes de criar uma conexão de armazenamento deobjeto externo.v Forneça aos computadores do Content Manager acesso ao local do arquivo do

armazenamento de objeto externo.v Forneça a conta de usuário que executa o serviço do IBM Cognos com acesso de

leitura e gravação para o local do arquivo.v Crie o armazenamento de conteúdo.

Procedimento1. Inicie o IBM Cognos Configuration.2. Na janela Explorer, em Acesso a Dados > Content Manager, clique com o

botão direito no nome do seu Content Store, e depois clique em Novo recurso> Armazenamento de Objeto Externo.

3. Na janela Novo Recurso - Armazenamento de Objeto Externo, digite um nomeexclusivo para o seu repositório do sistema de arquivos e clique em OK.É possível ter apenas um armazenamento de objeto externo.

4. Clique no nome para o repositório.5. Na janela Armazenamento de Objeto Externo - Propriedades do Recurso,

clique dentro do campo de valor, clique em Editar e quando a janela Valores deURI se abrir, digite o caminho para o local do seu sistema de arquivos, em quefile-system-path é o caminho completo para um local de arquivo existente.

Tabela 48. Exemplos de Valores de URI

Sistema de Arquivos Valor da URI

Windows file:///c:/file-system-path

file://host/share/file-system-path

UNIX ou Linux file:///file-system-path

Nota: Caminhos relativos, como file:///../file-system-path e mapeamentosde unidade não são suportados.

Capítulo 9. Opções de Configuração 229

Page 242: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Em uma instalação distribuída, todos os Content Managers devem ter acesso deleitura e gravação para o local do sistema de arquivos. Para melhorar odesempenho ao ler saídas, os Componentes da Camada de Aplicativo,essencialmente o serviço de repositório, deve ter acesso de leitura ao local dosistema de arquivos. Se eles não tiverem acesso de leitura, os pedidos sãoroteados para o Content Manager ativo.

6. Reinicie o serviço do IBM Cognos.

Verifique o Acesso ao Objeto de Armazenamento ExternoUse o IBM Cognos Configuration para verificar se os componentes do IBM Cognospodem se conectar ao armazenamento de objeto externo.

Procedimento1. Inicie o IBM Cognos Configuration.2. No Explorer > Acesso a Dados, dê um clique direito no nome da sua conexão

de armazenamento de objeto externo.3. Clique em Teste.

O IBM Cognos Configuration verifica o acesso ao local do arquivo dearmazenamento de objeto externo.Você também pode testar essa conexão clicando com o botão direito emConfiguração Local e selecionando Testar.

Customizando a Impressão no Lado do Servidor para PlataformasUNIX e Linux

A maneira como o portal do IBM Cognos Connection lida com a impressão doservidor pode diferir dependendo da plataforma.

Por essa razão, é possível customizar a maneira como o portal do IBM CognosConnection lida com a impressão de relatórios de formato PDF para plataformasUNIX e Linux configurando o arquivo rsprintpdf.sh.

O arquivo rsprintpdf.sh não deve ser configurado para servidores de impressão dosistema operacional Microsoft Windows.

Quando um usuário seleciona Executar com Opções, altera o Formato para PDF,seleciona Imprimir o Relatório na seção Entrega e, em seguida, especifica formatosadicionais por meio de opções avançadas, como orientação Paisagem, tamanho depapel A4 ou um Hora e Modo para executar o relatório, podem ocorrer problemasao imprimir em um servidor de impressão UNIX ou Linux. A saída pode não sercriada ou pode aparecer truncada ou com a orientação incorreta.

Procedimento1. Abra o arquivo rsprintpdf.sh localizado no diretório local_c10/bin.2. Em um editor de texto, customize a seção específica para a plataforma do seu

servidor de impressão, por exemplo, AIX, HP-UX ou Linux.3. Use a informações a seguir para a customização. A informações é transmitida

ao script rsprintpdf.sh pelo processo do servidor como as opções da linha decomandos.

230 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 243: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Tabela 49. Opções de Customização para a Impressão de Relatórios em Formato PDF

Opção Nome Descrição

-p impressora

Especifica a fila de impressão. Se nenhuma fila de impressão forespecificada, a fila padrão será usada.

-o orientação

Especifica a orientação da página de um arquivo, como retrato oupaisagem. Se nenhuma orientação for especificada, a orientação retratoserá usada.

-m Mídia Especifica o tamanho da mídia de saída, como tamanho carta ou A4.Se a mídia, a altura e a largura não forem especificadas, a bandeja depapel padrão será usada.

-h Altura Para tamanhos de página customizados. Especifica a altura da página,em pontos. Só será válida se especificada com a opção -w, sem aopção -m.

-w largura Para tamanhos de página customizados. Especifica a largura dapágina, em pontos. Só será válida se especificada com a opção -h, sema opção -m.

-L Arquivode log

Especifica um caminho para um arquivo especificado pelo usuáriopara a criação de log das mensagens de erro. O nome de arquivopadrão para o arquivo de log é rsprintpdf.errors.log.

4. Dica: mantenha uma cópia do arquivo rsprintpdf.sh para o caso de substituiçãoem uma atualização de software futura.

Alterar o Banco de Dados de NotificaçãoPor padrão, o servidor de notificações usa o mesmo banco de dados que o ContentManager usa para o armazenamento de conteúdo. É possível usar um banco dedados separado para notificações em situações em que se executa um grandevolume de relatórios em lote e e-mails.

Usar um banco de dados separado para notificações compreende as seguintestarefas:v Criando um banco de dados de notificação.

Para DB2, Oracle, Microsoft SQL Server ou Sybase, use o mesmo procedimentoque foi usado para criar o banco de dados de armazenamento de conteúdo.Utilize as instruções em “Diretrizes para Criar o Armazenamento de Conteúdo”na página 34.

Nota: Se você estiver usando o DB2, não será possível gerar um script para criaro banco de dados de notificação da mesma maneira que o armazenamento deconteúdo.

v Configurando a conectividade do banco de dados.É possível usar o mesmo procedimento usado para configurar a conectividadedo banco de dados do armazenamento de conteúdo, “Configure a conectividadedo banco de dados para o banco de dados de armazenamento de conteúdo.” napágina 72.

v Alterando as propriedades da conexão para o banco de dados de notificação.Utilize as instruções em “Alterar as propriedades de conexão para o banco dedados de notificação” na página 232.

Conceitos relacionados:

Capítulo 9. Opções de Configuração 231

Page 244: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

“Usar o protocolo secure sockets layer (SSL) para conexões com o banco de dadosno IBM Cognos Configuration” na página 245É possível configurar o IBM Cognos Business Intelligence para usar o protocolosecure sockets layer (SSL) para comunicação com bancos de dados usados peloIBM Cognos BI, incluindo armazenamento de conteúdo, notificação e criação delog de bancos de dados.

Alterar as propriedades de conexão para o banco de dados denotificação

Após criar uma banco de dados separado para notificação, você deve configurarcomponentes do IBM Cognos para usar o novo banco de dados.

É necessário configurar todos os Content Managers e Application Tier Componentspara utilizar o mesmo banco de dados de notificação.

Procedimento1. Na janela Explorer, em Acesso a dados, clique em Notificação.2. No menu Arquivo, clique em Salvar.3. 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 com o banco de dados e do servidor decorreio.Se o banco de dados de armazenamento de conteúdo estava sendo usado paranotificação, as programações serão replicadas nas tabelas do novo banco dedados de notificação.

Criando um Novo Armazenamento de Conteúdo Usando Banco deDados de Conteúdo do Cognos

Use as etapas a seguir para criar outro banco de dados de armazenamento deconteúdo usando o Cognos Content Database. Isso poderá ser necessário, se vocêinstalar mais de uma instância do produto IBM Cognos no local de teste e desejarexecutar as instâncias separadamente.

Antes de Iniciar

Use o Banco de dados de conteúdo do Cognos apenas para fins de teste edemonstração. O Banco de dados de conteúdo do Cognos colca um sistema deteste em execução rapidamente. Ao mover para um ambiente de produção com seuproduto IBM Cognos, configure o armazenamento de conteúdo para usar umbanco de dados suportado que possa ser protegido e ajustado para melhorar odesempenho.

Antes de criar o novo armazenamento de conteúdo, faça o seguinte:v 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áginaSeleção do componente do assistente de instalação.

v Crie um novo usuário e senha para o novo banco de dados de armazenamentode conteúdo.

232 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 245: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Procedimento1. No local em que a nova instância do Banco de Dados de Conteúdo do Cognos

foi instalada, no diretório c10_location/derby10.8.2.3/bin, use o script ij.batou 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 onovo armazenamento de conteúdo.Por exemplo, para criar um banco de dados chamado contentstore2 nocomputador localhost na porta número 1527 como um usuário chamadocognos2 com uma senha cognos2, digita-seconnect '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 de banco de dados estão localizados no diretórioc10_location\contentstore.

2. Quando você terminar de usar o utilitário ij, desconecte através do seguintecomando:disconnect;

Mude a Conformidade Padrão de Segurança para os ArmazenamentosConfiáveis do IBM Cognos

Por padrão, os armazenamentos confiáveis do IBM Cognos versão 10.2.2 que sãousados para comunicações de SSL incluem somente certificados que sãoqualificados para o padrão NIST SP800-131a. Você pode alterar os certificadosdisponíveis para você utilizando o ThirdPartyCertificateTool.

Você pode incluir padrões não NIST SP800-131a e também pode remover ospadrões não NIST SP800-131a que tiver incluído.

Restaure Certificados Padrão Não NIST SP800-131a paraArmazenamentos Confiáveis do IBM Cognos

Por padrão, os armazenamentos confiáveis do IBM Cognos versão 10.2.2 incluemsomente certificados de autoridade de certificação (CA) que estão qualificados parao padrão NIST SP800-131a. Se utilizar outros certificados, como os certificados deCA SHA1 ou 1024-bit, você deve incluir esses certificados no armazenamentoconfiável individualmente. Ou, você inclui esses certificados do armazenamentoconfiável do JRE que estiver utilizando com o comando de restauraçãoThirdPartyCertificateTool.

Nota: Os exemplos nessa tarefa usam a senha padrão, NoPassWordSet. Se vocêalterar a Senha de armazenamento de chaves de assinatura, a Senha dearmazenamento de chaves de criptografia e a Senha de armazenamento dechaves de autoridade no IBM Cognos Configuration, certifique-se de usar a senhaque você configurou.

Antes de Iniciar

Nos sistemas operacionais UNIX ou Linux, certifique-se de configurar umavariável de ambiente JAVA_HOME antes de usar o ThirdPartyCertificateTool.

Capítulo 9. Opções de Configuração 233

Page 246: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Em instalações do Microsoft Windows, é possível executar a ferramenta com o-java:local para usar o JRE que é fornecido com a instalação. Por exemplo,ThirdPartyCertificateTool.bat -java:local -R -D ...

Procedimento1. Acesse o diretório c10_location\bin.2. Restaure os certificados padrão não NIST SP800-131a digitando o seguinte

comando:Nos sistemas operacionais UNIX ou Linux, digiteThirdPartyCertificateTool.sh -R -D ../configuration -p NoPassWordSet

Nos sistemas operacionais Windows, digiteThirdPartyCertificateTool.bat -R -D ..\configuration -p NoPassWordSet

Remova Certificados Padrão Não NIST SP800-131a dosArmazenamentos Confiáveis do IBM Cognos

Se você tiver incluído certificados não NIST SP800-131a nos armazenamentosconfiáveis do IBM Cognos, como certificados CA SHA1 ou 1024-bit, é possívelremover esses certificados com o ThirdPartyCertificateTool.

Nota: Os exemplos nessa tarefa usam a senha padrão, NoPassWordSet. Se vocêalterar a Senha de armazenamento de chaves de assinatura, a Senha dearmazenamento de chaves de criptografia e a Senha de armazenamento dechaves de autoridade no IBM Cognos Configuration, certifique-se de usar a senhaque você configurou.

Antes de Iniciar

Nos sistemas operacionais UNIX ou Linux, certifique-se de configurar umavariável de ambiente JAVA_HOME antes de usar o ThirdPartyCertificateTool.

Em instalações do Microsoft Windows, é possível executar a ferramenta com o-java:local para usar o JRE que é fornecido com a instalação. Por exemplo,ThirdPartyCertificateTool.bat -java:local -N -D ...

Procedimento1. Acesse o diretório c10_location\bin.2. Digite o seguinte comando:

Nos sistemas operacionais UNIX ou Linux, digiteThirdPartyCertificateTool.sh -N -D ../configuration -p NoPassWordSet

Nos sistemas operacionais Windows, digiteThirdPartyCertificateTool.bat -N -D ..\configuration -p NoPassWordSet

Configurando Componentes do IBM Cognos para Usar OutraAutoridade de Certificação

Por padrão, os componentes do IBM Cognos BI usam seu próprio serviço deautoridade de certificação (CA) para estabelecer a raiz da confiança nainfraestrutura de segurança do IBM Cognos. No entanto, é possível configurar oscomponentes do IBM Cognos para usar um certificado de outra autoridade decertificação, como iPlanet ou Microsoft.

234 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 247: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Para usar outro certificado CA, você deve usar o processo a seguir:1. “Criar Arquivos Certificate Signing Request (CSR)” na página 236.

Parte dessa tarefa requer que você submeta os CSRs para a autoridade decertificação e gere os certificados. Para obter informações adicionais sobre esseprocesso, consulte a documentação do CA.

2. “Importar os Certificados CA nos Componentes do IBM Cognos” na página 2383. “Configurar Componentes do IBM Cognos BI para Usar Certificados Gerados

pelo CA” na página 240.

Comandos e exemplos de ThirdPartyCertificateToolAlgumas tarefas usam uma ferramenta de linha de comandos nomeadaThirdPartyCertificateTool. As tabelas a seguir listam as opções para essaferramenta de linha de comandos.

Comandos ThirdPartyCertificateTool

Tabela 50. Modo principal de operação

Comando Descrição

-c Cria uma certificate signing request (CSR).

-i Importa um certificado.

-E Exporta um certificado.

Tabela 51. Modificadores de operação

Comando Descrição

-s Trabalha com a identidade de assinatura.

-e Trabalha com a identidade de criptografia.

-T Trabalha com o armazenamento confiável (usado apenascom -i e -E).

Tabela 52. Sinalizadores de Informações

Comando Descrição

-d Nome distinto (DN) a ser usado para o certificado.

-r Local do arquivo de certificado ou CSR (depende domodo).

-t Arquivo de cadeia da autoridade de certificação. Pode serPEM, cadeia de certificado de autoridade de certificaçãoPKCS#7 ou certificado de autoridade de certificação deformato DER único.

-p Senha do keystore. Se -p não estiver incluída,NoPassWordSet será usada como senha padrão.

-a Algoritmo de par de chaves: RSA ou DSA. RSA é o valorpadrão.

-P Cria um keystore de CA que inclui as autoridades decertificação confiáveis pelo atual JRE.

-N Configura o armazenamento confiável da CA para usar anorma NIST SP800-131a.

-R Restaura os certificados não NIST SP800-131a de volta parao armazenamento confiável.

Capítulo 9. Opções de Configuração 235

Page 248: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Os valores de amostra da tabela a seguir são usados:

Tabela 53. Valores de Amostra

Propriedade Valor

Nome distinto do certificadode assinatura (DN)

Um valor exclusivo, formatado como:

CN=SignCert,O=MyCompany,C=CA

DN de certificado decriptografia

Um valor exclusivo, formatado como:

CN=EncryptCert,O=MyCompany,C=CA

Senha do keystore A senha padrão: NoPassWordSet

Esse valor deve corresponder às senhas no IBM CognosConfiguration em Segurança > Criptografia > Cognos. Sevocê alterar os valores padrão para Senha dearmazenamento de chaves de assinatura, Senha dearmazenamento de chaves de criptografia e Senha dearmazenamento de chaves de Autoridade de Certificação,certifique-se de usar as senhas que você configurou.

Exemplos de ThirdPartyCertificateTool

Tabela 54. Exemplos de ThirdPartyCertificateTool

Exemplo Comando

Para criar um novo par de chavesde assinatura e CSR PKCS#10

ThirdPartyCertificateTool.bat -c -s-d cn=Me,o=MyCompany,c=CA -r sign.csr-a DSA -p password

Para importar o certificado decriptografia gerado pela CA deterceiros e uma cadeia de certificadode autoridade de certificaçãoPKCS#7

ThirdPartyCertificateTool.bat -i -e-r encr.cer -p password -t cacert.p7b

Para importar o certificado deassinatura gerado pela CA deterceiros e uma cadeia de certificadode autoridade de certificação PEM

ThirdPartyCertificateTool.bat -i -e-r encr.cer -p password -t cacert.p7b

Para incluir um arquivo cer comoum certificado confiável

ThirdPartyCertificateTool.bat -i -T-r ca.cer -p password -t cacert.cer

Para exportar o certificado deassinatura para um arquivo cer

ThirdPartyCertificateTool.bat -E -s-r sign.cer -p password

Para exportar o certificado deautoridade de certificação do IBMCognos para um arquivo cer, casonão esteja usando uma CA deterceiros

ThirdPartyCertificateTool.bat -E -T-r ca.cer -p password

Criar Arquivos Certificate Signing Request (CSR)Para obter um certificado a partir de uma autoridade de certificação (CA), vocêdeverá gerar primeiro os arquivos Certificate Signing Request (CSR) para as chavesde assinatura e as chaves de criptografia a partir de keystores do IBM Cognos. ACA usa esses arquivos para produzir um certificado de assinatura, um certificadode criptografia e um certificado de CA que você importa em seus armazenamentosde chaves.

236 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 249: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Nota: Os exemplos nessa tarefa usam a senha padrão, NoPassWordSet. Se vocêalterar a Senha de armazenamento de chaves de assinatura, a Senha dearmazenamento de chaves de criptografia e a Senha de armazenamento dechaves de autoridade no IBM Cognos Configuration, certifique-se de usar a senhaque você configurou.

Antes de Iniciar

Nos sistemas operacionais UNIX ou Linux, certifique-se de que você configurouuma variável de ambiente JAVA_HOME antes de utilizar oThirdPartyCertificateTool.

Em instalações do Microsoft Windows, é possível executar a ferramenta com o-java:local para usar o JRE que é fornecido com a instalação. Por exemplo,ThirdPartyCertificateTool.bat -java:local -c -s -d ...

Procedimento1. Faça backup de seus dados de chave:

a. Acesse o diretório c10_location\configuration.b. Faça backup do arquivo cogstartup.xml em um local seguro.c. Faça backup do conteúdo dos seguinte diretórios em uma localização

segura:v c10_location\configuration\signkeypair

v c10_location\configuration\encryptkeypair

2. Acesse o diretório c10_location\bin.3. Crie a solicitação de assinatura de certificado para as chaves de assinatura

digitando o seguinte comando:Nos sistemas operacionais UNIX ou Linux, digiteThirdPartyCertificateTool.sh -c -s -d "CN=SignCert,O=MyCompany,C=CA" -rsignRequest.csr -D ../configuration/signkeypair -p NoPassWordSet

No sistema operacional Microsoft Windows, digiteThirdPartyCertificateTool.bat -c -s -d "CN=SignCert,O=MyCompany,C=CA" -rsignRequest.csr -D ..\configuration\signkeypair -p NoPassWordSet

O valor do nome distinto (DN) no comando ("CN=SignCert,O=MyCompany,C=CA")identifica exclusivamente a instalação do IBM Cognos. Os atributos usadosrefletem uma estrutura hierárquica em sua organização.A senha que você insere para essa chave deve ser usada novamente aoimportar o certificado e novamente no IBM Cognos Configuration.É possível ignorar com segurança todos os avisos sobre criação de log.O comando cria o arquivo jSignKeystore no diretório signkeypair, configura ocaminho especificado, cria um novo par de chave e armazena-o noarmazenamento de chaves e exporta o arquivo signRequest.csr para odiretório c10_location\bin.

4. Crie a solicitação de assinatura de certificado para as chaves de criptografiadigitando o seguinte comando:No UNIX ou Linux, digiteThirdPartyCertificateTool.sh -c -e -d "CN=EncryptCert,O=MyCompany,C=CA"-r encryptRequest.csr -D ../configuration/encryptkeypair -pNoPassWordSet

No Windows, digite

Capítulo 9. Opções de Configuração 237

Page 250: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

ThirdPartyCertificateTool.bat -c -e -d "CN=EncryptCert,O=MyCompany,C=CA"-r encryptRequest.csr -D ..\configuration\encryptkeypair -pNoPassWordSet

O valor do nome distinto (DN) no comando ("CN=SignCert,O=MyCompany,C=CA")identifica exclusivamente a instalação do IBM Cognos. Os atributos usadosrefletem uma estrutura hierárquica em sua organização.A senha que você insere para essa chave deve ser usada novamente aoimportar o certificado e novamente no IBM Cognos Configuration.É possível ignorar com segurança todos os avisos sobre criação de log.O comando cria o arquivo jEncKeystore no diretório encryptkeypair, configuraa senha especificada, cria um par de chaves e armazena-o no armazenamentode chaves e exporta o arquivo encryptRequest.csr para o diretórioc10_location\bin.

5. Copie os arquivos signRequest.csr e encryptRequest.csr em um diretório queseja acessível à autoridade de certificação.

6. Insira os arquivo signRequest.csr e encryptRequest.csr na autoridade decertificação e gere os certificados.A autoridade de certificação produz um certificado de chave de assinatura, umcertificado de chave de criptografia e um certificado CA.

Importante: Os certificados gerados pelo seu CA devem estar no formato PEM(ASCII com odificação Base-64).

Resultados

Agora é possível importar os certificados gerados nos componentes do IBMCognos na tarefa a seguir.

Importar os Certificados CA nos Componentes do IBMCognos

Após ter obtido os certificados do CA, você deverá importá-los para oscomponentes do seu IBM Cognos.

Você deve importar os certificados em cada computador em que existamcomponentes do IBM Cognos instalados; incluindo o Content Manager, osComponentes da Camada de Aplicativo, o gateway e os componentes demodelagem.

Nota: Os exemplos nessa tarefa usam a senha padrão, NoPassWordSet. Se vocêalterar a Senha de armazenamento de chaves de assinatura, a Senha dearmazenamento de chaves de criptografia e a Senha de armazenamento dechaves de autoridade no IBM Cognos Configuration, certifique-se de usar a senhaque você configurou.

Antes de Iniciar

Nos sistemas operacionais UNIX ou Linux, certifique-se de que você configurouuma variável de ambiente JAVA_HOME antes de utilizar oThirdPartyCertificateTool.

Em instalações do Microsoft Windows, é possível executar a ferramenta com o-java:local para usar o JRE que é fornecido com a instalação. Por exemplo,ThirdPartyCertificateTool.bat -java:local -c -s -d ...

238 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 251: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Procedimento1. Crie uma cópia do arquivo de certificado de assinatura e nomeie-o como

signCertificate.cer.2. Crie uma cópia do certificado de criptografia e nomeie-o como

encryptCertificate.cer.3. Crie uma cópia do certificado CA raiz e nomeie-o como ca.cer.4. Copie os arquivos signCertificate.cer, encryptCertificate.cer e ca.cer no

diretório c10_location/bin.5. Importe o certificado de assinatura no armazenamento de chaves de assinatura

do IBM Cognos digitando o seguinte comando:Nos sistemas operacionais UNIX ou Linux, digiteThirdPartyCertificateTool.sh -i -s -r signCertificate.cer -D../configuration/signkeypair -p NoPassWordSet -t ca.cer

Nos sistemas operacionais Windows, digiteThirdPartyCertificateTool.bat -i -s -r signCertificate.cer -D..\configuration\signkeypair -p NoPassWordSet -t ca.cer

Importante: Assegure-se de usar a senha inserida quando exportou a chave deassinatura na tarefa anterior.É possível ignorar com segurança todos os avisos sobre criação de log.O comando lê os arquivos signCertificate.cer e ca.cer no diretórioc10_location\bin e importa os certificados dos dois arquivos no arquivojSignKeystore no diretório signkeypair usando a senha especificada.

6. Importe o certificado de criptografia no armazenamento de chaves decriptografia do IBM Cognos digitando o seguinte comando:Nos sistemas operacionais UNIX ou Linux, digiteThirdPartyCertificateTool.sh -i -e -r encryptCertificate.cer -D../configuration/encryptkeypair -p NoPassWordSet -t ca.cer

Nos sistemas operacionais Windows, digiteThirdPartyCertificateTool.bat -i -e -r encryptCertificate.cer -D..\configuration\encryptkeypair -p NoPassWordSet -t ca.cer

Importante: Assegure-se de usar a senha inserida quando exportou a chave decriptografia na tarefa anterior.É possível ignorar com segurança todos os avisos sobre criação de log.O comando lê os arquivos encryptCertificate.cer e ca.cer no diretórioc10_location\bin e importa os certificados dos dois arquivos no arquivojEncKeystore no diretório encryptkeypair usando a senha especificada.

7. Importe o certificado CA no armazenamento confiável do IBM Cognosdigitando o seguinte comando:Nos sistemas operacionais UNIX ou Linux, digiteThirdPartyCertificateTool.sh -i -T -r ca.cer -D ../configuration/signkeypair -p NoPassWordSet

Nos sistemas operacionais Windows, digiteThirdPartyCertificateTool.bat -i -T -r ca.cer -D ..\configuration\signkeypair -p NoPassWordSet

O comando lê o arquivo ca.cer e importa o conteúdo no arquivo jCAKeystoreno diretório signkeypair usando a senha especificada.

Capítulo 9. Opções de Configuração 239

Page 252: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Resultados

Agora é possível configurar os componentes do IBM Cognos para usar oscertificados CA.

Configurar Componentes do IBM Cognos BI para UsarCertificados Gerados pelo CA

Após ter importado os certificados CA, use o IBM Cognos Configuration paraconfigurar cada computador em que um componente do IBM Cognos estejainstalado para usar o certificado.

Nota: Certifique-se de que os locais e senhas de armazenamento de chaves no IBMCognos Configuration correspondam aos digitados na ferramenta de linha decomandos. Por exemplo, se você alterar a Senha de armazenamento de chaves deassinatura, a Senha de armazenamento de chaves de criptografia e a Senha dearmazenamento de chaves de autoridade no IBM Cognos Configuration,certifique-se de usar a senha que você configurou.

Procedimento1. Inicie o IBM Cognos Configuration.2. Na janela Explorer, em Segurança > Criptografia, clique em Cognos.3. Clique na caixa Valor próxima a Usar CA de Terceiro e selecione True.

Quando você configura essa propriedade como verdadeira, todas aspropriedades para a autoridade de certificação e nome de identidade sãoignoradas.

4. Insira a senha usada para a chave de assinatura em Senha de armazenamentode chaves de assinatura e insira o caminho para o Local de armazenamento dechaves de assinatura. Se os mesmos valores foram usados nos exemplos, nastarefas anteriores, não será necessário alterar o caminho.

5. Insira a senha usada para a chave de criptografia em Senha de armazenamentode chaves de criptografia e insira o caminho para o Local de armazenamentode chaves de criptografia. Se os mesmos valores foram usados nos exemplos,nas tarefas anteriores, não será necessário alterar o caminho.

6. Insira a Senha do Armazenamento de Chaves da Autoridade de Certificação.7. Clique em Arquivo > Salvar.8. Reinicie os serviços do IBM Cognos.

Configurando o Protocolo SSL para Componentes do IBM CognosÉ possível usar o protocolo Secure Sockets Layer (SSL) para a comunicação entreos componentes do IBM Cognos em instalações distribuídas e de único servidor.

Conectores do IBM WebSphere Liberty Profile

Se o URI do dispatcher interno for prefixado com http, mas o URI do dispatcherexterno for prefixado com https, ou vice-versa, os conectores não SSL LibertyHTTP/1.1 e SSL Liberty HTTP/1.1 serão ativados no arquivo server.xml.

Se as URIs do dispatcher interno e externo usarem protocolos e portas diferentes, aporta do dispatcher interno será acessível apenas para os componentes nocomputador local. O URI do dispatcher interno também deve especificar olocalhost.

240 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 253: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Instalações de Computador Único

Em uma instalação de computador único, se você não estiver usando SSL, deveráparar o serviço antes de alterar o protocolo para https. Após salvar a configuraçãocom as definições de SSL, você poderá reiniciar os serviços.

Instalações Distribuídas

Na instalação distribuída, você deve configurar primeiro o computador do ContentManager ativo padrão para usar o protocolo SSL e iniciar os serviços nessecomputador antes de configurar os componentes da Camada do Aplicativo e ogateway para usar o SSL.

Incluir um Computador em uma Instalação

Se adicionar um computador a um ambiente com o SSL ativado, aparecerá umaviso para aceitar temporariamente a confiança para um certificado ao salvar asconfigurações. Aceitar o certificado temporário permitirá que a confiançapermanente seja estabelecida com os componentes existentes.

Incluir um Componente em um Computador

Se incluir um componente em uma instalação já configurada no SSL, a confiançaserSSL, a confiança para os certificados SSL será herdada a partir dos componentesexistentes. Se você incluir o componente em um local diferente no mesmocomputador, mas em um ambiente já configurado para SSL, será solicitado queaceite temporariamente a confiança para um certificado ao salvar a configuração.Aceitar o certificado temporário permitirá que a confiança permanente sejaestabelecida com os componentes existentes.

Configurando SSL para componentes do IBM CognosPara componentes do IBM Cognos, é possível usar SSL para conexões internas,conexões externas ou as duas.

Se você configurar SSL apenas para conexões internas, os componentes do IBMCognos no computador local se comunicarão usando esse protocolo. O dispatcherrecebe conexões seguras em uma porta diferente das solicitações de HTTP remotas.Desta forma, é necessário configurar dois URIs de dispatcher.

Se você configurar SSL apenas para conexões externas, as comunicações decomponentes IBM Cognos remotos com o computador local usarão o protocoloSSL. É necessário configurar o dispatcher para procurar por solicitações seguras eremotas em uma porta diferente em relação a solicitações locais, HTTP. Também énecessário configurar os URIs do Content Manager e do dispatcher para aplicativosexternos usarem o mesmo protocolo e porta que o dispatcher local.

Se configurar o SSL para todas as conexões, o dispatcher pode usar a mesma portapara conexões internas e externas. Da mesma forma, se não usar o SSL para acomunicação local ou remota, o dispatcher pode usar a mesma porta para todas ascomunicações.

Por padrão, os componentes do IBM Cognos BI usam uma autoridade decertificação (CA) interna para estabelecer a raiz de confiança na infraestrutura desegurança do IBM Cognos. Isso se aplica às duas conexões, SSL e não SSL. Se

Capítulo 9. Opções de Configuração 241

Page 254: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

desejar usar certificados gerenciados por outro serviço, consulte “ConfigurandoComponentes do IBM Cognos para Usar Outra Autoridade de Certificação” napágina 234.

Na instalação distribuída, você deve configurar primeiro o computador do ContentManager ativo padrão para usar o protocolo SSL e iniciar os serviços nessecomputador antes de configurar o computador de Componentes da camada deaplicativos.

Procedimento1. Inicie o IBM Cognos Configuration.2. Na janela Explorer, clique em Ambiente.3. Na janela Propriedades, digite os valores apropriados para os valores da URI.

v Para configurar o SSL apenas para conexões internas, insira https e umnúmero da porta para a comunicação SSL na propriedade URI doDispatcher Interno.Para as propriedades URI do Dispatcher Externo e URI do Dispatcher paraAplicativos Externos, deixe http como o protocolo e use o número da portapadrão ou outro número da porta disponível.Se você usar o servidor de aplicativos que é fornecido com o IBM Cognos BI,a propriedade URI de dispatcher interno deverá especificar localhost.O número da porta nas duas URIs do dispatcher deve ser diferente.

v Para configurar o SSL apenas para conexões externas, insira https e umnúmero da porta para a comunicação SSL nas propriedades URI doDispatcher Externo e URI do Dispatcher para Aplicativos Externos.Para a propriedade URI do Dispatcher Interno, deixe http como o protocoloe use o número da porta padrão ou outro número da porta disponível.Se você usar o servidor de aplicativos que é fornecido com o IBM Cognos BI,a propriedade URI de dispatcher interno deverá especificar localhost.O número da porta nas duas URIs do dispatcher deve ser diferente.

v Para configurar o SSL para todas as conexões, insira a mesma URI para aspropriedades URI do Dispatcher Interno, URI do Dispatcher Externo e URIdo Dispatcher para Aplicativos Externos. Insira https e um número daporta para a comunicação SSL.

v Adicionalmente, é possível inserir https e um número da porta para acomunicação SSL na propriedade URI do Content Manager.

v Se você instalou o gateway em um computador separado e estiver usandoSSL para conexões externas, no IBM Cognos Configuration no computadorde gateway, insira https e o número da porta para comunicação SSL napropriedade URIs de dispatcher para gateway.

4. No menu Arquivo, clique em Salvar.5. Reinicie os serviços.

Em ambiente distribuído, inicie os serviços no computador com ContentManager primeiro, seguido pelos serviços nos computadores dos Componentesda camada de Aplicativos.

Configure a Confiança Compartilhada entre Servidores IBMCognos e Outros Servidores

Se quiser usar a autoridade de certificação do IBM Cognos e quiser usar SSL paraconexões de outros servidores com servidores IBM Cognos, você deverá incluir ocertificado do IBM Cognos no armazenamento confiável nos outros servidores.

242 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 255: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Nota: Se usar navegadores para se conectar aos componentes do IBM Cognos, osnavegadores solicitarão automaticamente que os usuários atualizem seusarmazenamentos confiáveis.

Se quiser que a conexão entre os servidores IBM Cognos e o outro servidor sejammutuamente autenticada, você também deverá copiar o certificado da autoridadede certificação no armazenamento confiável para os servidores IBM Cognos.

Se tiver configurado componentes do IBM Cognos para usar outra autoridade decertificação (CA), você não precisará configurar a confiança compartilhada entre oservidor IBM Cognos e os outros servidores.

Copiando o Certificado do IBM Cognos em outro ServidorA primeira tarefa de inclusão do certificado do IBM Cognos no armazenamentoconfiável em outros servidores é copiar o certificado no servidor.

Procedimento1. Acesse o diretório c10_location/bin.2. Extraia o certificado do IBM Cognos digitando o seguinte comando:

v Em sistemas operacionais UNIX ou Linux, digiteThirdPartyCertificateTool.sh -E -T -r destination_file -kc10_location/configuration/signkeypair/jCAKeystore -p NoPassWordSet

v Nos sistemas operacionais Microsoft Windows, digiteThirdPartyCertificateTool.bat -E -T -r destination_file -kc10_location\configuration\signkeypair\jCAKeystore -p NoPassWordSet

3. Importe o certificado para o armazenamento confiável em seu servidor.Para obter informações em como atualizar o armazenamento confiável, consultea documentação de seu servidor.

Copiando o Certificado CA em Servidores IBM CognosApós copiar o certificado do IBM Cognos em outros servidores, copie o certificadoda autoridade de certificação no servidor IBM Cognos.

Procedimento1. Copie o certificado da autoridade de certificação em um local seguro no

servidor IBM Cognos.Verifique se a autoridade de certificação CA está no formato X.509 codificadona base 64.

2. Importe a autoridade de certificação CA digitando o seguinte comando:v Em sistemas operacionais UNIX ou Linux, digite o seguinte:

ThirdPartyCertificateTool.sh -T -i -r CA_certificate_file -kc10_location/configuration/signkeypair/jCAKeystore -p NoPassWordSet

v Nos sistemas operacionais Microsoft Windows, digiteThirdPartyCertificateTool.bat -T -i -r CA_certificate_file -kc10_location\configuration\signkeypair\jCAKeystore -p NoPassWordSet

Selecionar e Classificar Conjuntos de Cifras para SecureSocket Layer

Uma conexão SSL começa com uma negociação onde o cliente e o servidorapresentam uma lista de conjuntos de códigos suportados em uma sequênciaprioritária. O conjunto de códigos fornece a qualidade de proteção para a conexão.

Capítulo 9. Opções de Configuração 243

Page 256: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Ele contém algoritmos criptográficos, de autenticação, hash e de troca de chaves. Oprotocolo SSL seleciona o conjunto de prioridade mais alta que o cliente e oservidor suportam.

Uma lista de conjuntos de códigos para SSL é fornecida. É possível eliminarconjuntos de códigos que não correspondem a exigências e então atribuir umaprioridade, ou preferência, aos conjuntos de códigos restantes. Os conjuntos decódigos selecionados são apresentados por ordem de prioridade para as partes docliente e servidor da negociação. No mínimo um dos conjuntos de códigosselecionados entre as plataformas do cliente e servidor devem corresponder.

A lista de conjuntos de códigos suportados é gerada dinamicamente em cadacomputador e depende do Java Runtime Environment (JRE) ou se você tem outrosoftware criptográfico instalado no computador. Se foram feitas mudanças em umcomputador, como atualização no JRE ou a instalação de um software queatualizou o JRE, isto pode afetar os conjuntos de códigos suportados nessecomputador. Se não possuir mais um conjunto de códigos suportado quecorresponda a outros computadores em seu ambiente, pode ser necessário alterar oJRE no computador para corresponder aos outros computadores em seu ambiente.

Procedimento1. Inicie o IBM Cognos Configuration.2. Na janela Explorer, clique em Criptografia > Cognos.3. Na janela Propriedades, clique na coluna Valor na propriedade Conjuntos de

códigos com suporte.

4. Clique no ícone de edição .v Para mover um conjunto de códigos para a lista Valores atuais, clique na

caixa de seleção na lista Valores disponíveis e em Adicionar.v Para mover um conjunto de códigos para cima ou para baixo na lista Valores

atuais, clique na caixa de seleção e depois nas setas para cima ou para baixo.v Para remover um conjunto de códigos da lista Valores atuais, clique na caixa

de seleção e em Remover.5. Clique em OK.6. No menu Arquivo, clique em Salvar.

Configurar Servidores da Web Ativados pelo IBM Cognos para SSLSe você estiver usando Secure Sockets Layer (SSL) em seu servidor da web, deveráalterar os valores da URI do Gateway no IBM Cognos Configuration para poderacessar o portal.

Para ativar o SSL no servidor da web, você deverá obter um certificado doservidor da web assinado por um Certificate Authority (CA) e instalá-lo noservidor da web. Para obter informações adicionais sobre como usar certificadoscom o servidor da web, consulte a documentação do servidor da web. Essescertificados não são fornecidos com os produtos IBM Cognos.

Para permitir que os usuários acessem o portal do IBM Cognos usando SSL, vocêdeverá alterar os valores da URI do Gateway no IBM Cognos Configuration paracada computador em que os Componentes da camada de aplicativos e oFramework Manager estiverem instalados.

244 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 257: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Procedimento1. Configure o servidor da web para SSL e inicie o servidor da web.2. Em cada computador em que os Componentes da camada de aplicativos ou o

Framework Manager estejam instalados, inicie o IBM Cognos Configuration.3. Em Configuração Local, clique em Ambiente e altere o valor da URI do

Gateway de http para https.4. No valor da URI do Gateway, altere o número da porta para o número da

porta SSL definido para o servidor da web. Por exemplo, o número da portapadrão para conexões SSL é normalmente 443.

5. Em cada computador no qual os Componentes da Camada de Aplicativos ou oFramework Manager está instalado, acesse o diretório c10_location/bin eimporte todos os certificados que formam a cadeia de confiança, por ordem,começando com o certificado de CA raiz, para o armazenamento confiável doIBM Cognos.Importe os certificados digitando o seguinte comando:No UNIX ou LINUX, digiteThirdPartyCertificateTool.sh -T -i -r path/certificate_fileName -Dc10_location/configuration/signkeypair -p password

No Windows, digiteThirdPartyCertificateTool.bat -T -i -r path\certificate_fileName -Dc10_location\configuration\signkeypair -p password

Nota: A senha já deve ter sido configurada. Caso contrário, a senha padrão éNoPassWordSet.

6. Salve sua configuração e reinicie os serviços.

Resultados

Ao acessar o portal usando https://servername:443/ibmcognos, será solicitado quevocê instale um certificado.

Para evitar prompts de alerta de segurança para cada nova sessão, instale ocertificado em um dos armazenamentos de certificados do navegador da Web.

Usar o protocolo secure sockets layer (SSL) para conexões com obanco de dados no IBM Cognos Configuration

É possível configurar o IBM Cognos Business Intelligence para usar o protocolosecure sockets layer (SSL) para comunicação com bancos de dados usados peloIBM Cognos BI, incluindo armazenamento de conteúdo, notificação e criação delog de bancos de dados.

O SSL deve ser ativado no servidor de banco de dados e os clientes do banco dedados devem ser configurados para usar conexões SSL com o servidor de banco dedados antes de ativá-lo no IBM Cognos Configuration.

O suporte de SSL está disponível para todos os bancos de dados suportados,exceto para IBM DB2 for z/OS. Também não é possível usar uma conexão SSL seusar o Cognos Content Database para o banco de dados de armazenamento deconteúdo.

Capítulo 9. Opções de Configuração 245

Page 258: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

IBM DB2

É possível usar o SSL para o IBM DB2 versão 9.1 Fix Pack 2 e versões posteriores.

Para obter informações sobre configurar conexões do IBM DB2 for SSL, consulte adocumentação para sua versão do IBM DB2.

Por exemplo, para a versão 10.5, consulte documentação do IBM DB2 versão 10.5(pic.dhe.ibm.com/infocenter/db2luw/v10r5/index.jsp?topic=%2Fcom.ibm.db2.luw.admin.sec.doc%2Fdoc%2Fc0053514.html).

IBM Informix

Para obter informações sobre configurar conexões do IBM Informix for SSL,consulte a documentação para sua versão do IBM Informix.

Por exemplo, para a versão 12.10, consulte a documentação do IBM Informixversão 12.10 (pic.dhe.ibm.com/infocenter/informix/v121/index.jsp?topic=%2Fcom.ibm.sec.doc%2Fids_ssl_001.htm).

Sybase

Para obter informações sobre configurar conexões do Sybase for SSL, consulte adocumentação para sua versão do Sybase.

Por exemplo, para a versão 15, consulte documentação do Sybase versão 15(infocenter.sybase.com/archive/index.jsp?topic=/com.sybase.help.ase_15.0.sag1/html/sag1/sag1877.htm).

Oracle

Para obter informações sobre configurar conexões do Oracle for SSL, consulte adocumentação para sua versão do Oracle.

O White Paper SSL com Oracle JDBC Thin Driver (www.oracle.com/technetwork/database/enterprise-edition/wp-oracle-jdbc-thin-ssl-130128.pdf) publicado pelaOracle fornece informações para configurar a SSL para o servidor de banco dedados e o cliente.

Microsoft SQL Server

Para obter informações sobre configurar conexões do Microsoft SQL Server for SSL,consulte a documentação para sua versão do Microsoft SQL Server.

Por exemplo, para a versão 2012, consulte a documentação do Microsoft SQLServer versão 2012 (technet.microsoft.com/en-us/library/bb879949.aspx).

Nota: Para o Microsoft SQL Server, não há configuração de cliente necessária seestiver usando o IBM Cognos BI em um sistema operacional Microsoft Windows.Após ativar a SSL no servidor de banco de dados, é possível configurarCriptografia SSL Ativada para True no IBM Cognos Configuration.Conceitos relacionados:

246 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 259: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

“Alterar o Banco de Dados de Notificação” na página 231Por padrão, o servidor de notificações usa o mesmo banco de dados que o ContentManager usa para o armazenamento de conteúdo. É possível usar um banco dedados separado para notificações em situações em que se executa um grandevolume de relatórios em lote e e-mails.“Configurando um Repositório para Mensagens de Log” na página 254O protocolo BI bus inclui processamento de mensagens de log, uma ferramenta dediagnóstico importante para investigar o comportamento dos IBM Cognos BIs.“Definição de propriedades de conexão com o banco de dados para oarmazenamento de conteúdo” na página 85Deve-se especificar as informações do servidor de banco de dados para garantirque o Content Manager possa ser conectado ao banco de dados que você utilizapara o armazenamento de conteúdo. O Content Manager usa o logon do banco dedados para acessar o armazenamento de conteúdo. Após definir as propriedadesde conexão com o banco de dados, é possível testar a conexão entre o ContentManager e o armazenamento de conteúdo.“Configure a conectividade do banco de dados para o banco de dados dearmazenamento de conteúdo.” na página 72Se estiver usando um banco de dados diferente do Cognos Content Database, oIBM DB2 Advanced Workgroup Server Edition (da opção Configuração Rápida) ouMicrosoft SQL Server como o armazenamento de conteúdo, pode ser necessárioinstalar o software do cliente de banco de dados ou drivers Java DatabaseConnectivity (JDBC), ou ambos, em cada computador no qual o Content Managerfor instalado. Fazer isso permite que o Content Manager acesse o banco de dadosde armazenamento de conteúdo.

Usando SSL para conexões com o banco de dados no IBMCognos Configuration para um banco de dados IBM DB2,Informix ou Sybase

Para usar secure sockets layer (SSL) para conexões com o banco de dados no IBMCognos Configuration, você deve importar o certificado SSL para o keystore Java emodificar alguns arquivos de configuração do IBM Cognos.

É possível usar a SSL para conexões com o banco de dados no IBM CognosConfiguration, incluindo o armazenamento de conteúdo, notificação e bancos dedados de criação de log.

Antes de Iniciar

Assegure-se de ativar a SSL em seu servidor de banco de dados antes deconfigurar o IBM Cognos para usar a SSL para conexões com o banco de dados.

Assegure-se de exportar o certificado SSL do seu servidor de banco de dados e otenha disponível no computador em que estiver configurando a conexão com obanco de dados no IBM Cognos Configuration.

Importante: Se estiver usando o Sybase, só será possível usar o driver jconn4.jarpara conexões SSL para conexões com o banco de dados.

Procedimento1. Siga a documentação para sua versão do banco de dados a fim de ativar a SSL

para o servidor de banco de dados e exporte o certificado SSL.2. No computador em que estiver configurando a conexão com o banco de

dados, importe o certificado SSL com o keytool para o JRE que estiver usando

Capítulo 9. Opções de Configuração 247

Page 260: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

para IBM Cognos Business Intelligence. Por exemplo, se estiver usando o JREfornecido com instalações do IBM Cognos BI em sistemas operacionaisMicrosoft Windows, execute as etapas a seguir:a. Acesse o diretório c10_location/bin64/jre/7.0/bin.b. Execute o seguinte comando.

keytool -import -file path/filename -keystore keystorename -alias aliasname

Em que keystorename é um nome para um novo keystore e aliasname éum alias escolhido para o certificado.

c. Insira uma senha para sua keystore. Se estiver incluindo o certificado emum keystore existente, insira a senha do keystore. Se estiver criando umnovo keystore, insira uma senha para o novo keystore.

Importante: O certificado SSL deve ser importado para o keystore para o JREque estiver usando para o IBM Cognos BI.

3. Edite o arquivo java.security para incluir o provedor de SSL.a. Se estiver usando o JRE fornecido com instalações do IBM Cognos BI em

sistemas operacionais Microsoft Windows, acesse o diretórioc10_location/bin64/jre/7.0/lib/security. Caso contrário, acesse odiretório lib/security para o JRE que estiver usando para o IBM CognosBI.

b. Abra java.security em um editor de texto.c. Inclua a linha a seguir na lista da seção de provedores do arquivo.

security.provider.2=com.ibm.crypto.fips.provider.IBMJCEFIPS

Importante: Assegure-se de incluir a linha antes desecurity.provider.2=com.ibm.crypto.provider.IBMJCE.

d. Altere os números para as entradas security.provider subsequentes paraque sejam sequenciais após incluirsecurity.provider.2=com.ibm.crypto.fips.provider.IBMJCEFIPS na lista.

e. Localize as linhas a seguir no arquivo.ssl.KeyManagerFactory.algorithm=IbmX509ssl.TrustManagerFactory.algorithm=PKIX

f. Inclua as linhas a seguir após as linhas anteriores.ssl.SocketFactory.provider=com.ibm.jsse2.SSLSocketFactoryImplssl.ServerSocketFactory.provider=com.ibm.jsse2.SSLServerSocketFactoryImpl

g. Salve e feche o arquivo.4. Edite o arquivo startup.bat do IBM Cognos. Esse arquivo é usado ao iniciar

o IBM Cognos BI.a. Acesse o diretório c10_location/bin64.b. Abra o arquivo startup.bat em um editor de texto. Em sistemas

operacionais UNIX ou Linux, abra o arquivo startup.sh.c. Localize a linha a seguir no arquivo.

set JVM_ARGS=-Dcom.ibm.cognos.disp.useDaemonThreads=true %JVM_ARGS%

d. Inclua as linhas a seguir após as linhas anteriores.set JVM_ARGS=-Dcom.ibm.jsse2.JSSEFIPS=true %JVM_ARGS%set JVM_ARGS=-Djavax.net.ssl.trustStore=path/keystorename %JVM_ARGS%

Em que path é o caminho para o keystore e keystorename é o nome dokeystore.

e. Salve e feche o arquivo.

248 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 261: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

5. Edite o arquivo bootstrap_osversion.xml. Esse arquivo é usado ao iniciar oIBM Cognos BI como um serviço do IBM Cognos Configuration.a. Acesse o diretório c10_location/bin64.b. Abra o arquivo bootstrap_osversion.xml em um editor de texto.c. Inclua as seguintes linhas no arquivo.

<param>"-Dcom.ibm.jsse2.JSSEFIPS=true"</param><param>"-Djavax.net.ssl.trustStore=path/keystorename"</param>

Em que path é o caminho para o keystore e keystorename é o nome dokeystore.

d. Salve e feche o arquivo.6. Edite o arquivo cogconfig do IBM Cognos.

a. Acesse o diretório c10_location/bin64.b. Abra o arquivo cogconfig.bat em um editor de texto. Em sistemas

operacionais UNIX ou Linux, abra o arquivo cogconfig.sh.c. Localize a linha a seguir no arquivo.

set J_OPTS=%DD_OPTS% %J_OPTS%

d. Inclua as linhas a seguir após as linhas anteriores.set J_OPTS=-Dcom.ibm.jsse2.JSSEFIPS=true %J_OPTS%set J_OPTS=-Djavax.net.ssl.trustStore=path/keystorename %J_OPTS%

Em que path é o caminho para o keystore e keystorename é o nome dokeystore.

e. Salve e feche o arquivo.7. Inicie o IBM Cognos Configuration usando o arquivo cogconfig que você

modificou.v Em sistemas operacionais Microsoft Windows, clique duas vezes no arquivo

cogconfig.bat que você modificou.v Em sistemas operacionais UNIX ou Linux, execute o arquivo cogconfig.sh

que você modificou.8. Em Acesso a Dados, sob o tipo de conexão com o banco de dados, selecione a

conexão com o banco de dados.É possível usar a SSL para conexões com o banco de dados dearmazenamento de conteúdo, banco de dados de notificação, banco de dadosde criação de log, tarefa manual e bancos de dados de anotação.

9. Selecione True para Criptografia SSL Ativada.10. Teste a conexão.11. Salve sua configuração e reinicie os serviços.

Usando SSL para conexões com o banco de dados no IBMCognos Configuration para um banco de dados Oracle

Para usar secure sockets layer (SSL) para conexões com o banco de dados no IBMCognos Configuration, você deve importar o certificado SSL para o keystore Java emodificar alguns arquivos de configuração do IBM Cognos.

É possível usar a SSL para conexões com o banco de dados no IBM CognosConfiguration, incluindo o armazenamento de conteúdo, notificação e bancos dedados de criação de log.

Capítulo 9. Opções de Configuração 249

Page 262: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Antes de Iniciar

Assegure-se de ativar a SSL em seu servidor de banco de dados antes deconfigurar o IBM Cognos para usar a SSL para conexões com o banco de dados.

Procedimento1. Edite o arquivo startup.bat do IBM Cognos.

a. Acesse o diretório c10_location/bin64.b. Abra o arquivo startup.bat em um editor de texto. Em sistemas

operacionais UNIX ou Linux, abra o arquivo startup.sh.c. Inclua as seguintes linhas no arquivo.

set JVM_ARGS=-Doracle.net.ssl_version=3 %JVM_ARGS%set JVM_ARGS=-Doracle.net.ssl_client_authentication=false %JVM_ARGS%set JVM_ARGS=-Doracle.net.wallet_location=(SOURCE=(METHOD=file)(METHOD_DATA=(DIRECTORY=path/client_wallet))) %JVM_ARGS%

Em que path é o caminho para o diretório da carteira eletrônica Oracle parao cliente e client_wallet é o nome do diretório da carteira eletrônica para ocliente.

d. Salve e feche o arquivo.2. Edite o arquivo bootstrap_osversion.xml. Esse arquivo é usado ao iniciar o

IBM Cognos BI como um serviço do IBM Cognos Configuration.a. Acesse o diretório c10_location/bin64.b. Abra o arquivo bootstrap_osversion.xml em um editor de texto.c. Inclua as seguintes linhas no arquivo.

<param>"-Dcom.ibm.jsse2.JSSEFIPS=true"</param><param>"-Djavax.net.ssl.trustStore=path/client_wallet"</param>

d. Salve e feche o arquivo.3. Edite o arquivo cogconfig do IBM Cognos.

a. Acesse o diretório c10_location/bin64.b. Abra o arquivo cogconfig.bat em um editor de texto. Em sistemas

operacionais UNIX ou Linux, abra o arquivo cogconfig.sh.c. Inclua as seguintes linhas no arquivo.

set J_OPTS=-Doracle.net.ssl_version=3 %J_OPTS%set J_OPTS=-Doracle.net.wallet_location=(SOURCE=(METHOD=file)(METHOD_DATA=(DIRECTORY=path/client_wallet))) %J_OPTS%set J_OPTS=-Doracle.net.ssl_client_authentication=false %J_OPTS%

d. Salve e feche o arquivo.4. Copie os arquivos do driver Oracle a seguir nos diretórios c10_location/bin64

e c10_location/webapps/p2pd/WEB-INF/lib.v jssl-1_1.jar

v oraclepki.jar

v osdt_cert.jar

v osdt_core.jar

5. Inicie o IBM Cognos Configuration.6. Em Acesso a Dados, sob o tipo de conexão com o banco de dados, selecione a

conexão com o banco de dados.É possível usar a SSL para conexões com o banco de dados de armazenamentode conteúdo, banco de dados de notificação, banco de dados de criação de log,tarefa manual e bancos de dados de anotação.

250 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 263: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Nota: Assegure-se de que a conexão use o tipo Banco de dados Oracle(Avançado). Se você não selecionar o tipo Banco de dados Oracle (Avançado),exclua a conexão com o banco de dados e crie uma nova que use Banco dedados Oracle (Avançado).

7. Selecione True para Criptografia SSL Ativada.8. Teste a conexão.9. Salve sua configuração e reinicie os serviços.

Configure conexões da origem de dados JDBC para conexão únicausando Kerberos

É possível configurar conexão única usando o protocolo Kerberos para conexões daorigem de dados JDBC que são usadas para o modo de consulta dinâmica.

Exceto para Microsoft SQL Server, a autenticação de origem de dados de conexãoúnica é suportada apenas para modo de consulta dinâmica.

Para configurar conexão única, deve-sev Criar um arquivo de inicialização Kerberos.v Configurar um service principal name (SPN) para a origem de dados do modo

de consulta dinâmica.v Criar um arquivo keytab.v Configurar um módulo de login Kerberos.v Configure as conexões de origem de dados.

Antes de iniciar, deve-se assegurar que as condições a seguir sejam atendidas:1. O serviço do IBM Cognos é configurado para conexão única usando um

namespace do Microsoft Active Directory.2. O banco de dados é configurado para usar o protocolo do Kerberos.3. Os usuários do Active Directory também são configurados no servidor de base

de dados.

Usando autenticação do Kerberos sem conexão única

Se você configurar a conexão de origem de dados para autenticação do Kerberos,mas não configurar o namespace do Active Directory, o serviço de consulta domodo de consulta dinâmica interpretará as credenciais que você fornecer (nome deusuário e senha) como credenciais para obtenção de um chamado da concessão dechamado (TGT) do servidor Kerberos (Active Directory ou outro provedor deautenticação). Nesse caso, não é preciso registrar o SPN ou criar o arquivo keytabpara Serviço de Consulta. Deve-se ainda configurar o módulo de login do Kerberospara que o serviço de consulta possa obter um TGT do servidor Kerberos.

Criando arquivos de inicialização do KerberosDeve-se criar arquivos de inicialização do Kerberos e colocá-los em locaisespecíficos em todos os computadores com o Application Tier Componentsinstalado. Os arquivos de inicialização do Kerberos, krb5.conf e krb5.ini, sãousados pelo JRE nos computadores nos quais o Application Tier Components estáinstalado.

Capítulo 9. Opções de Configuração 251

Page 264: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Para obter mais informações sobre arquivos de inicialização do Kerberos, consultea Documentação do MIT Kerberos (web.mit.edu/kerberos/krb5-devel/doc/admin/conf_files/krb5_conf.html).

Procedimento1. Em computadores executando UNIX e Linux em que o Application Tier

Components está instalado, copie o arquivo krb5.conf para o diretórioJAVA_HOME/lib/security.Em computadores executando UNIX, copie o arquivo krb5.conf para odiretório /etc/krb5.Em computadores executando Linux, copie o arquivo krb5.conf para odiretório /etc.

2. Em computadores executando o Microsoft Windows, copie o arquivo krb5.inipara o diretório JAVA_HOME\lib\security ou para o diretório C:\winnt.

Criando um SPN para o serviço de consultaDeve-se criar um service principal name (SPN) para o serviço de consulta usar. OSPN deve ser configurado com um usuário do domínio do Active Directoryconfiável para delegação.

O SPN deve ser formatado como spn@REALM. O valor spn é formatado comoservice name/fully qualified domain name. E REALM é o nome da regiãoconfigurado no arquivo de inicialização do Kerberos. Por exemplo, se dqm for onome do serviço, dqm/[email protected].

Se o usuário do domínio do Active Directory for denominado dqmuser, o SPNseria registrado usando o comando a seguir:

setspn -s dqm/myserver.mydomain.com mywindowsdomain\dqmuser

É possível usar os parâmetros -L e -Q para verificar se o SPN foi criadocorretamente. Por exemplo:

setspn -L mywindowsdomain\dqmuser

setspn -Q dqm/myserver.mydomain.com

Criando um arquivo keytabApós a criação do SPN, deve-se criar um arquivo keytab para o serviço. O arquivokeytab permite que o serviço efetue login sem uma senha. O arquivo keytabdeverá ser recriado se a senha da conta do serviço mudar.

Procedimento

Use o comando a seguir para criar um arquivo keytab:ktpass -out krb5.keytab -princ SPN -mapUser username -mapOp set -passpassword -pType KRB5_NT_PRINCIPAL -crypto RC4-HMAC-NTPor exemplo,ktpass -out krb5.keytab -princ dqm/[email protected] -mapUser dqmuser@mywindowsdomain-mapOp set -pass password -pType KRB5_NT_PRINCIPAL -crypto RC4-HMAC-NT

252 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 265: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Configurando o módulo de login do KerberosDeve-se configurar o módulo de login do Kerberos para permitir que o serviço deconsulta do IBM Cognos efetue login no domínio do Active Directory. Parapermitir o login no Java Authentication and Authorization Service (JAAS), o pacoterequer um arquivo de configuração. O arquivo de configuração deve ser incluídono arquivo java.security no diretório JRE_HOME/lib/security.

Deve-se incluir uma linha como a seguinte no arquivo java.security.

login.config.url.1=file:///${java.home}/lib/security/jaas.conf

Exemplos de configuração do JAAS são fornecidos na instalação do IBM Cognos.Os arquivos de exemplo são denominados jaas-ibm.config e jaas-oracle.config,e os arquivos estão no diretório c10_location\configuration.

Nos arquivos de exemplo, deve-se substituir os valores a seguir:v <principal name> é o SPN que você criou.v <keytab file specification> é o caminho e o nome do arquivo keytab que

você criou.

Se você não estiver usando uma conexão ao banco de dados configurada paraautenticação do Kerberos para modelagem, em vez de modificar o arquivojava.security, é possível especificar o arquivo de configuração de login do JAAScomo um parâmetro de inicialização adicional para o serviço de consulta no IBMCognos Administration. No IBM Cognos Administration, em Sistema, expanda seuservidor, selecione Serviço de consulta > Configurar propriedades >Configurações e insira o valor em Argumentos adicionais da JVM para o serviçode consulta no formato -Djava.security.auth.login.config=<configuration file>

Configurando conexões de origem de dados usando oKerberos

Use as diretrizes neste tópico ao configurar as sequências de conexões paraconexões de origem de dados usando conexão única do Kerberos.

Procedimento1. Na seção Efetuar sign on, selecione namespace externo e selecione o namespace

Active Directory a partir da lista. Para sequências de conexões de guias dual(Nativa e JDBC), a seção Efetuar sign on está na guia Nativa.

2. No campo Propriedades de conexão, especifiqueibmcognos.authentication=java_krb5 e, em seguida, inclua as propriedadesrequeridas pelo driver JDBC para autenticação do Kerberos, se houver. Paraconexões de origem de dados com guias dual (Nativa e JDBC), este campo estána guia JDBC e é chamada de Parâmetros de Conexão JDBC.Se o IBM Cognos BI estiver instalado em um computador que está executandoos sistemas operacionais Microsoft Windows, não será necessário especificaribmcognos.authentication=java_krb5 para conexões de origem de dados doMicrosoft SQL Server e Teradata.

3. Teste a conexão de origem de dados.

Exemplo

A seguir estão exemplos de propriedades de conexão de origem de dados paraalgumas origens de dados:

Capítulo 9. Opções de Configuração 253

Page 266: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

v Para conexões de origem de dados do Teradata:ibmcognos.authentication=java_krb5;LOGMECH=KRB5;

v Para conexões de origem de dados do SAP-HANA:ibmcognos.authentication=java_krb5;

v Para conexões de origem de dados do Microsoft SQL Server:ibmcognos.authentication=java_krb5;authenticationScheme=JavaKerberos;

Configurando um Repositório para Mensagens de LogO protocolo BI bus inclui processamento de mensagens de log, uma ferramenta dediagnóstico importante para investigar o comportamento dos IBM Cognos BIs.

Além das mensagens de erro, as mensagens de log oferecem informações sobre ostatus dos componentes e uma visão de alto nível de eventos importantes. Porexemplo: as mensagens de log podem fornecer informações sobre tentativas deinicializar e encerrar serviços, finalização de solicitações de processamento eindicadores de erros fatais. Os logs de auditoria, que estão disponíveis em umbanco de dados de criação de log, fornecem informações sobre a atividade dousuário e do relatório.

Os serviços do IBM Cognos em cada computador enviam informações sobre errose eventos para um servidor de log local. Um servidor de log local é instalado napasta c10_location/logs em cada computador IBM Cognos BI que contém oContent Manager ou os Componentes da Camada de Aplicativos. Como o servidorde log usa uma porta diferente dos outros componentes do IBM Cognos BI, elecontinua a processar os eventos mesmo se outros serviços no computador local,como o dispatcher, estiverem desativados.

O fluxo de trabalho a seguir exibe as tarefas necessárias para preparar-se para acriação de log.

v Durante o planejamento, determine a configuração de criação de log adequadapara seu ambiente. Por exemplo, avalie diversos repositórios de mensagens delog, como servidores de log remotos e arquivos de log, como o syslog do UNIXou do 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 criação de log de auditoriapara um banco de dados. Considere a segurança, tal como os métodosdisponíveis para proteção dos arquivos de log contra as falhas do sistema e aadulteração do usuário.Para obter informações sobre o planejamento, consulte IBM Cognos BusinessIntelligence Architecture e o Guia de Implementação.

v Durante a configuração, defina as propriedades de inicialização para criação delog, como configurações de conexão para bancos de dados. Você também devecriar um banco de dados de criação de log se houver planos de coletar os logsde auditoria. Se a comunicação entre um servidor de log local e um servidor delog remoto precisar ser assegurada, faça as mudanças apropriadas na

Configurar criação de logPlanejar processamento de mensagem de log Configurar criação de log

254 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 267: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

configuração em ambos os computadores do IBM Cognos BI. Também é possívelhabilitar certos recursos de criação de log, como a criação de log específica paraum usuário.

v Ao configurar a criação de log, especifique o nível de detalhe para concentrar asmensagens nas informações relevantes em sua organização. O relatórios deauditoria também podem ser configurados para controlar as atividades deusuário e relatório.

Para obter informações sobre uso de mensagens de log para resolver problemas eresolver problemas relacionados à criação de log, consulte o Guia de Resolução deProblemas do IBM Cognos Business Intelligence.Conceitos relacionados:“Usar o protocolo secure sockets layer (SSL) para conexões com o banco de dadosno IBM Cognos Configuration” na página 245É possível configurar o IBM Cognos Business Intelligence para usar o protocolosecure sockets layer (SSL) para comunicação com bancos de dados usados peloIBM Cognos BI, incluindo armazenamento de conteúdo, notificação e criação delog de bancos de dados.

Diretrizes para Criar um Banco de Dados de Criação de LogÉ possível criar um banco de dados para armazenar mensagens de log. A criaçãode um banco de dados de criação de log envolve as seguintes tarefas:v Crie um banco de dados de criação de log.

Para DB2, Oracle, Microsoft SQL Server ou Sybase, use o mesmo procedimentoque foi usado para criar o banco de dados de armazenamento de conteúdo.Utilize as instruções em “Diretrizes para Criar o Armazenamento de Conteúdo”na página 34.

Nota: Se você estiver usando o DB2, não será possível gerar um script para criaro banco de dados de notificação da mesma maneira que o armazenamento deconteúdo.

v Configure a conectividade do banco de dados.Utilize as instruções em “Conectividade do Banco de Dados para o Banco deDados de Criação de Log”.

v Especifique o repositório das mensagens de log.Utilize as instruções em “Repositório de Mensagens de Log” na página 257.

Conectividade do Banco de Dados para o Banco de Dados deCriação de Log

Após você criar um banco de dados para logs de auditoria, etapas adicionais serãorequeridas para a configuração do cliente de banco de dados se você usar Oracle,DB2, Informix Dynamic Server ou Sybase como servidor de banco de dados.

Não é possível usar Banco de dados de conteúdo do Cognos como banco de dadosde criação de log.

Em um ambiente distribuído, o servidor de log local em um computadorComponentes da Camada de Aplicativos pode enviar mensagens de log para umservidor de log remoto, que então envia as mensagens para o banco de dados decriação de log. Para Oracle, Sybase e DB2, o driver JDBC apropriado e/ou software

Capítulo 9. Opções de Configuração 255

Page 268: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

do cliente de banco de dados é necessário apenas no computador de Componentesda Camada de Aplicativos com o servidor de log remoto que se conecta ao bancode dados de criação de log.

Microsoft SQL Server

Se você usar um banco de dados Microsoft SQL Server, o arquivo JSQLConnect.jarserá instalado no local apropriado, por padrão. A única etapa adicional serágarantir que o Microsoft SQL Server use conectividade TCP/IP.

Configurar conectividade do banco de dados para um banco dedados de criação de log DB2Você deve configurar o software do cliente de banco de dados e o driver JDBC emtodos os computadores de Componentes da Camada de Aplicativos com umaconexão com o banco de dados de criação de log. Você deve configurar o driverJDBC no computador com Content Manager, a menos que você esteja usando omesmo tipo de banco de dados para as mensagens de log que usa para oarmazenamento de conteúdo.

A versão do driver deve ser pelo menos JCC 3.7 para um sistema operacionalLinux ou UNIX, ou para um sistema operacional Microsoft Windows versão 9.1 fixpack, ou JCC 3.42 para um sistema operacional Linux, UNIX, ou para um sistemaoperacional Microsoft Windows versão 9.5 fix pack 2.

Procedimento

Copie os arquivos a seguir a partir do diretório DB2_installation\sqllib\javapara o diretório c10_location\webapps\p2pd\WEB-INF\lib:v O arquivo do driver universal, db2jcc.jarv O arquivo de licença:

Para DB2 nos sistemas operacionais Linux, UNIX ou Windows, usedb2jcc_license_cu.jar.Para DB2 no z/OS, use db2jcc_license_cisuz.jar.Se estiver se conectando ao DB2 no z/OS, use a versão do 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 path\db2jcc.jar com.ibm.db2.jcc.DB2Jcc -version

Configurar a Conectividade para o Banco de Dados de Criaçãode Log OracleVocê deve configurar o driver JDBC em todos os computadores de Componentesda Camada de Aplicativos com uma conexão com o banco de dados de criação delog. Também é preciso configurar o driver JDBC no computador com o ContentManager, a menos que esteja utilizando o mesmo tipo de banco de dados para asmensagens de log que utiliza para o armazenamento de conteúdo.

Procedimento1. No computador onde está instalado o cliente Oracle, acesse o diretório

ORACLE_HOME/jdbc/lib.2. Copie o arquivo de biblioteca completo da sua versão do cliente Oracle para o

diretório c10_location\webapps\p2pd\WEB-INF\lib no computador onde oContent Manager está instalado e onde a notificação é enviada para um bancode dados Oracle.

256 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 269: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Se estiver usando o Oracle 10g, você deve ter ojdbc14.jar.Se estiver usando o Oracle 11g, você deve ter ojdbc5.jar.Os arquivos estão disponíveis de uma instalação do cliente ou servidor Oracle etambém podem ser transferidos por download do Web site de tecnologiaOracle.

Configurar a Conectividade do Banco de Dados para um Bancode Dados de Criação de Log InformixVocê deve configurar o driver JDBC em todos os computadores de Componentesda Camada de Aplicativos com uma conexão com o banco de dados de criação delog. Também é preciso configurar o driver JDBC no computador com o ContentManager, a menos que esteja utilizando o mesmo tipo de banco de dados para asmensagens de log que utiliza para o armazenamento de conteúdo.

Procedimento1. No computador onde o Informix está instalado, acesso o diretório

Informix_location/sqllib/java.2. Copie os seguintes arquivos para o diretório c10_location/webapps/p2pd/WEB-

INF/lib em cada computador em que o Content Manager estiver instalado.v o arquivo do driver universal, db2jcc.jarv o arquivo de licença, db2jcc_license_cisuz.jar

Configurar a Conectividade do Banco de Dados para um Bancode Dados de Criação de Log SybaseVocê deve configurar o driver JDBC em todos os computadores de Componentesda Camada de Aplicativos com uma conexão com o banco de dados de criação delog. Também é preciso configurar o driver JDBC no computador com o ContentManager, a menos que esteja utilizando o mesmo tipo de banco de dados para asmensagens de log que utiliza para o armazenamento de conteúdo.

Procedimento1. 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 c10_location/webapps/p2pd/WEB-

INF/lib em cada computador onde o Content Manager estiver instalado e ondea notificação é enviada para um banco de dados do Sybase.

Repositório de Mensagens de LogUm servidor de log é automaticamente instalado junto com o Content Manager ouo Application Tier Components. É possível especificar um ou mais repositórios emque o servidor de log local envia mensagens de log.

Enviando Mensagens de Log a um Servidor de Log Remoto

Em uma instalação distribuída, é possível configurar o servidor de log em cadacomputador com IBM Cognos para enviar mensagens de log para um únicoservidor de log remoto, que age como um servidor de log comum. Em seguidapode-se configurar o servidor de log comum para enviar as mensagens de log aum arquivo ou banco de dados comum, no mesmo ou em outro computador.

Se o servidor de log remoto se tornar indisponível, as mensagens de log serãoredirecionadas para arquivos de recuperação no computador local no diretórioc10_location/logs/recovery/remote. Esses arquivos de recuperação possueminformações de registro de data e hora em seus nomes de arquivo, e não são lidos

Capítulo 9. Opções de Configuração 257

Page 270: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

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 oservidor de log remoto e exclui os arquivos de log locais.

Salvando Mensagens de Log em um Arquivo

O servidor de log é configurado por padrão para enviar mensagens de log para oarquivo c10_location/logs/cogserver.log. Se o arquivo de log padrão não existirquando 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 umarquivo diferente. Se você configurar um arquivo de log diferente, o IBM Cognostentará criar automaticamente esse arquivo na inicialização, além do arquivo de logpadrão. Se o local do arquivo de log configurado for diferente do diretórioc10_location/logs, você deve assegurar que o caminho para o arquivo de logexiste antes de iniciar o serviço do IBM Cognos. Por exemplo, se você configurar oservidor de log para enviar mensagens para o arquivo /usr/lpp/logfiles/cognos.log, o IBM Cognos tenta criar automaticamente o arquivo cognos.log napasta /usr/lpp/logfiles. Se essa pasta não existir, o IBM Cognos não cria oarquivo cognos.log e nenhuma mensagem de log pode ser registrada no mesmo.Observe que essas mensagens de log não são registradas no arquivo de log padrão.Embora o IBM Cognos crie automaticamente o arquivo de log padrão mesmoquando outro arquivo de log está configurado, o arquivo de log padrão não éusado como um backup.

Salvando Mensagens de Log em um Banco de Dados

O servidor de log também pode enviar logs de auditoria a um banco de dados nomesmo ou em outro computador. Os logs de auditoria fornecem informações sobreatividade do usuário e de relatório.

O banco de dados de criação de log possui a mesma configuração e requisitos deconta de usuário que o banco de dados de armazenamento de conteúdo. Apósvocê configurar os componentes do IBM Cognos para enviar mensagens para umbanco de dados de criação de log, e reiniciar o serviço do IBM Cognos, oscomponentes do IBM Cognos criam as tabelas e os campos de tabelas obrigatórios.É possível testar a conexão com o banco de dados de criação de log antes de vocêreiniciar o serviço do IBM Cognos.

Especificando o Log Messages Repository for DB2 em UNIX,Linux ou WindowsÉ possível configurar um tipo de repositório para as mensagens de log, e depoisconfigurar propriedades para o repositório específico. Também é possívelconfigurar mais de um repositório de mensagens de log.

Antes de Iniciar

Antes de especificar um banco de dados como um repositório, verifique se__ v criou o banco de dados de criação de log__ v tenha configurado o cliente de banco de dados

Procedimento1. No computador onde você instalou o Content Manager ou Componentes da

Camada de Aplicativos, inicie o IBM Cognos Configuration.2. Na janela Explorer, em Ambiente, clique emCriação de log.

258 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 271: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

3. Na janela Propriedades, use a tabela a seguir para ajudar a configurar aspropriedades do servidor de log.

Tabela 55. Propriedades do Servidor de Log

Tarefa Ação

Use TCP entre componentes do IBM Cognosem um computador e seu servidor de loglocal

Configure a propriedade Habilitar TCPcomo Verdadeiro.

O UDP fornece uma comunicação maisrápida com um risco menor de conexõesperdidas que o TCP. Entretanto, o risco deperder uma conexão local de TCP é baixo. OTCP sempre é usado na comunicação entreum servidor de log local e um remoto.

Altere o número de threads disponíveis parao servidor de log local.

Digite o valor na propriedade Segmentos detrabalho do servidor de log local.

Mantenha o valor padrão de 10. O intervalovai de 1 a 20.

Entretanto, se tiver um número alto demensagens de log, é possível alocar maisthreads para melhorar o desempenho.

4. Na janela Explorer, em Ambiente, clique com o botão direito do mouse emCriação de Log e clique 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 dispatcher interno do computador do repositório de destinoestiver configurada para usar SSL, na janela Propriedades, defina apropriedade Ativação do SSL como Verdadeira.Mais tarde á necessário especificar o repositório das mensagens de log aoconfigurar o servidor de log remoto.

9. Se o repositório for um banco de dados, na janela Explorer, em Criação delog, especifique o tipo de banco de dados e suas propriedades da seguinteforma:v Clique com o botão direito do mouse no nome do banco de dados e clique

em Novo Recurso > Banco de Dados.v ??Na caixa Nome, digite o nome do repositório.v Na lista Tipo, clique no tipo de banco de dados e depois clique em OK.v Na janela Propriedades, digite os valores apropriados para as propriedades

obrigatórias e opcionais.Para um banco de dados Microsoft SQL Server, é possível escolher usar umnúmero da porta, como 1433, uma instância denominada como valor para apropriedade Servidor de banco de dados com número da porta ou nomeda instância. Inclua o número da porta se portas que não são padrão foremutilizadas. Inclua o nome da instância se houver várias instâncias doMicrosoft SQL Server.

Capítulo 9. Opções de Configuração 259

Page 272: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Para se conectar a uma instância denominada, você deve especificar o nomeda instância como uma propriedade URL JDBC ou de origem de dados. Porexemplo, é possível digitar localhost\instance1. Se não forem especificadaspropriedades de nome de instância, é criada uma conexão com a instânciapadrã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 usadospara criar um URL JDBC. Eis um exemplo:jdbc:JSQLConnect://localhost\\instance1/user=sa/mais propriedadesconforme necessário

v Teste a conexão ao novo banco de dados. Na janela Explorer, em Ambiente,clique com o botão direito em Criação de log e clique em Teste.Os componentes do IBM Cognos se conectam ao banco de dados. Se vocêconfigurou mais de um banco de dados para mensagens de criação 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 oservidor de log envie mensagens.

11. No menu Arquivo, clique em Salvar.12. Na janela Explorer, clique em Serviços do IBM Cognos > IBM Cognos.13. No menu Arquivo, clique em Reiniciar.

Se você selecionou um banco de dados como repositório, os componentes doIBM Cognos criarão as tabelas e os campos obrigatórios no banco de dadoscriado.

Resultados

Se o repositório era um servidor de log remoto, configure e inicie esse servidor. Emseguida, reinicie o serviço do IBM Cognos no computador local.

Se o repositório era um banco de dados, é possível usar componentes do IBMCognos para executar relatórios de log a partir do banco de dados.

Também é possível definir o nível de criação de log, que controla a quantidade e otipo de mensagens que são enviadas para um arquivo ou banco de dados de log.Para obter instruções, consulte IBM Cognos Business Intelligence: Guia deAdministração e Segurança.

Especifique o Repositório de Mensagens de Log para o InformixÉ possível configurar um tipo de repositório para as mensagens de log, e depoisconfigurar propriedades para o repositório específico. Também é possívelconfigurar mais de um repositório de mensagens de log.

Procedimento1. Na janela Explorer, em Ambiente, clique emCriação de log.2. Na janela Propriedades, use a tabela a seguir para ajudar a configurar as

propriedades do servidor de log.

260 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 273: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Tabela 56. Propriedades do Servidor de Log

Tarefa Ação

Use TCP entre componentes do IBM Cognosem um computador e seu servidor de loglocal

Configure a propriedade Habilitar TCPcomo Verdadeiro.

O UDP fornece uma comunicação maisrápida com um risco menor de conexõesperdidas que o TCP.

O TCP é usado na comunicação entre umservidor de log local e um remoto.

Altere o número de threads disponíveis parao servidor de log local.

Digite o valor na propriedade Segmentos detrabalho do servidor de log local.

Mantenha o valor padrão de 10. O intervalovai de 1 a 20. Entretanto, se tiver umnúmero alto de mensagens de log, é possívelalocar mais threads para melhorar odesempenho.

3. Na janela Explorer, em Ambiente, clique com o botão direito do mouse emCriação de Log e clique em Novo Recurso > Destino.

4. ??Na caixa Nome, digite o nome do repositório.5. Na lista Tipo, clique em Banco de dados e depois em OK.6. Na janela Explorer, em Criação de Log, clique com o botão direito do mouse

no nome do banco de dados e clique em Novo Recurso > Banco de Dados.7. ??Na caixa Nome, digite o nome do repositório.8. Na lista Tipo, clique em Banco de dados do Informix Dynamic Server e, em

seguida, clique em OK.9. Na janela Propriedades, digite os valores para Servidor de banco de dados e

número da porta, ID do usuário e senha e o Nome do banco de dados.10. Se você tiver diversas instâncias de um banco de dados de criação de log do

Informix, crie a propriedade avançada IPFSCRIPTIDX e especifique a contasob a qual a instância é executada:v Na janela Explorer, clique em Configuração Local.v Na janela Propriedades, clique na coluna Valor de Propriedades Avançadas

e, em seguida, clique no ícone de edição .v Na caixa de diálogo Valor - Propriedades avançadas, clique em Adicionar.v Na coluna Nome, digite IPFSCRIPTIDX

v Na coluna Valor, digite a ID do usuário da conta na qual a instância dobanco de dados de criação de log é executada.Use uma conta do usuário diferente para cada instância do banco de dadosde criação de log do Informix.

v Repita cada instância do IBM Cognos Configuration que usa uma instânciade um banco de dados de criação de log do Informix.

11. No menu Arquivo, clique em Salvar.12. Teste a conexão ao novo banco de dados. Na janela Explorer, em Ambiente,

clique com o botão direito em Criação de log e clique em Teste.

Capítulo 9. Opções de Configuração 261

Page 274: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Os componentes do IBM Cognos se conectam ao banco de dados. Se vocêconfigurou mais de um banco de dados para mensagens de criação de log, oscomponentes 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 criação de log paramonitorar 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 a criação de log normal. Para ativar acriação de log específica do usuário, use o IBM Cognos Configuration paraconfigurar informações de conexão para Java Management Extensions (JMX), umatecnologia que fornece ferramentas para gerenciar e monitorar aplicativos e redesorientadas a serviços. Depois configure as informações de conexão JMX em umarquivo de propriedades de implantação.

Após ativar a criação de log específica do usuário para os componentes do IBMCognos, ative a criação de log para um usuário específico usando o serviçoProcesso Remoto para JMX. Para obter informações, consulte o tópico sobre o usoda criação de log para diagnosticar um problema para um usuário específico noIBM Cognos Business Intelligence: Guia de Administração e Segurança.

Você deve instalar o Oracle Java SE Development Kit ou o Java SoftwareDevelopment Kit for IBM antes de poder ativar a criação de log específica dousuário.

Configurando Informações de Conexão de JMX Usando o IBMCognos ConfigurationAs informações de conexão de Java Management Extensions (JMX) sãoconfiguradas no IBM Cognos Configuration especificando um valor de cookie e,em seguida, configurando a porta e as credenciais JMX.

Procedimento1. No computador em que o Content Manager está instalado, inicie o IBM Cognos

Configuration.2. Na janela Explorer, clique em Ambiente.3. Na janela Propriedades, configure as propriedade JMX em Configurações de

dispatcher:v Para Porta JMX externa, digite um número de porta disponível.

v Para a Credencial JMX Externa, clique no ícone de edição na colunade Valor, digite um ID do usuário e senha e, em seguida, clique em OK.O ID do usuário e a senha garantem que apenas um usuário autorizadopossa se conectar ao ambiente Java para especificar o usuário ou usuários aefetuarem login usando a porta especificada em Porta JMX externa.

4. Salve a configuração.

Configure as informações de conexão JMX de um arquivo depropriedades de implantaçãoPara que o servidor de aplicativos suporte as configurações de Java ManagementExtensions (JMX), especifique a porta JMX no arquivo de propriedades deimplantação p2pd.

262 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 275: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Procedimento1. Em um editor de texto, abra o arquivo p2pd.deploy_defaults.properties

localizado em c10_location/webapps/p2pd/WEB-INF.2. Remova o comentário da linha rmiregistryport e configure o valor para Porta

JMX externa configurada no IBM Cognos Configuration.3. Salve o arquivo p2pd.deploy_defaults.properties.4. Reinicie os serviços para o IBM Cognos.

Resultados

Agora o IBM Cognos suporta criação de logs para um ou mais usuáriosespecíficos. Para obter informações adicionais, consulte o tópico sobre o uso dacriação de log para diagnosticar um problema para um usuário específico no IBMCognos Business Intelligence: Guia de Administração e Segurança.

Alteração de definições globaisPor padrão, os componentes do IBM Cognos garantem que todos os códigos doidioma, que podem vir de diferentes fontes e em vários formatos, usem uma formanormalizada. Isto significa que todos os códigos do idioma expandidos se adaptamàs configurações de idioma e código da região. Cada computador possui umcódigo do idioma de sistema padrão e um código do idioma de usuário porusuário. Os códigos do idioma de usuário podem ser diferentes do código doidioma de sistema padrão. Caso as configurações globais sejam alteradas em umcomputador com Content Manager, é necessário fazer as mesmas mudanças nosoutros computadores com Content Manager.

As configurações globais são alteradas para os seguintes propósitosv customizar o suporte ao idioma para a interface com o usuáriov customizar o suporte à moedav customizar o suporte ao código do idioma do conteúdov mapear o idioma usado na interface com o usuário do produtov mapear códigos do idioma do conteúdov incluir fontes no ambiente do IBM Cognosv customizar o fuso horário padrãov alterar a codificação dos e-mailsv Personalização de configurações de cookie.

Personalização do suporte ao idioma na interface com ousuário

Use a tabela Códigos do Idioma do Produto para adicionar ou remover o suporteao idioma da interface com o usuário. Por exemplo, se não solicitar uma interfacecom o usuário em alemão, é possível remover o idioma da lista.

Se o idioma da interface com o usuário do produto for alterada, os dados não sãoatingidos.

Se desejar que os usuários vejam a documentação de produtos em um idiomadiferente de inglês, é necessário instalar a Supplementary LanguagesDocumentation. Para obter mais informações, consulte “Instalando aDocumentação do Produto Traduzida” na página 72.

Capítulo 9. Opções de Configuração 263

Page 276: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Antes de Iniciar

Certifique-se de que instalou as fontes adequadas para suportar os conjuntos decaracteres e símbolos de moedas que forem utilizados. Para que os símbolos dasmoedas japonesa e coreana sejam exibidos corretamente, é necessário instalarfontes adicionais do disco Supplementary Languages Documentation.

Procedimento1. Em cada computador que tiver o Content Manager, inicie o IBM Cognos

Configuration.2. No menu Ações, clique em Editar Configuração Global.3. Clique na guia Códigos do idioma do produto.

Todos os códigos do idioma suportados são exibidos.4. Clique em Incluir.

Dica: Para remover o suporte, selecione a caixa de seleção próxima de Códigodo Idioma Suportado e clique em Remover.

5. Na segunda coluna, digite a porção do idioma de um código do idioma.6. Repita as etapas 3 a 5 em outros idiomas suportados que deseja adicionar.7. Clique em OK.8. No menu Arquivo, clique em Salvar.

Personalização do suporte de moedaSe forem necessárias moedas adicionais ou se desejar remover algumas da interfacecom o 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 queos caracteres do Iene japonês e do Won coreano sejam exibidos corretamente..

Por padrão, os componentes do IBM Cognos mostram apenas um subconjunto demoedas suportadas na interface com o usuário. As moedas são identificadas pelocódigo de unidade monetária ISO 4217. A lista completa de moedas suportadasque podem ser adicionadas está no arquivo i18n_res.xml no diretório local_c10/bin.

A inclusão de moedas no ambiente do IBM Cognos não garante que seucomputador tenha uma fonte com os caracteres necessários para exibir a moeda.Certifique-se de ter instalado as fontes adequadas para suportar os símbolos demoedas utilizados. Por exemplo, para exibir o símbolo de moeda indiana (rúpia)corretamente, é necessário instalar uma fonte que contenha aquele caractere. Alémdisso, para que os símbolos das moedas japonesa e coreana sejam exibidoscorretamente, é necessário instalar fontes adicionais do disco SupplementaryLanguages Documentation.

Adição de moedas à interface com o usuárioÉ possível adicionar moedas suportadas ou não na interface com o usuário. Incluaas moedas suportadas no IBM Cognos Configuration. Inclua moedas nãosuportadas no arquivo i18n_res.xml que é fornecido no IBM Cognos.

Se incluir um código de unidade monetária que não é suportado pelo IBM Cognos,você deverá incluí-lo manualmente no arquivo i18n_res.xml no diretórioc10_location/bin. Copie esse arquivo em cada computador IBM Cognos em suainstalação.

264 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 277: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Procedimento1. Em cada computador que tiver o Content Manager, inicie o IBM Cognos

Configuration.2. No menu Ações, clique em Editar Configuração Global.3. Clique na guia Moedas.4. Clique em Incluir.

Dica: Para remover o suporte, selecione a caixa de seleção próxima do itemsuportado e clique em Remover.

5. Na segunda coluna, digite o valor apropriado.O valor adicionado deve corresponder aos códigos ISO 4217 para arepresentação de moedas e formatos. Em geral, o valor adicionado é um códigoalfabético de três letras. Os dois primeiros caracteres são letras representando ocódigo do país ou região ISO 3166 para o país ou região de onde a moeda é. Aletra adicional representa a primeira letra da moeda.

6. Repita as etapas 3 a 5 para os outros tipos de suporte que deseja adicionar.7. No menu Arquivo, clique em Salvar.

Customizar Suporte do Código de Idioma do ConteúdoPara garantir que os usuários visualizem relatórios, dados ou metadados noidioma preferido ou específico da região, adicione códigos do idioma parciais(idioma) ou códigos do idioma completos (idioma - região) à tabela Códigos doIdioma do Conteúdo. Desta forma, se o conteúdo estiver disponível em idiomas oucódigos do idioma diferentes será processado para os usuários com base no códigodo idioma do usuário. Por padrão, o código do idioma do conteúdo substitui ocódigo do idioma do produto no portal por algum conteúdo.

Se visualizar relatórios no idioma tailandês, os dígitos não são suportados.

Antes de Iniciar

Se um código do idioma não for solicitado, é possível removê-lo da lista. Deixepelo menos um código do idioma do conteúdo na lista para Application TierComponents operar.

A inclusão de códigos do idioma incompletos (idiomas) no ambiente do IBMCognos não garante que seu computador tenha uma fonte que possa exibir páginasda Web em seus idiomas preferenciais. Certifique-se de que instalou as fontesadequadas para suportar os conjuntos de caracteres e símbolos de moedas queforem utilizados. Para que os símbolos das moedas japonesa e coreana sejamexibidos corretamente, é necessário instalar fontes adicionais do discoSupplementary Languages Documentation.

Procedimento1. Em cada computador que tiver o Content Manager, inicie o IBM Cognos

Configuration.2. No menu Ações, clique em Editar Configuração Global.3. Clique na guia Códigos do idioma do conteúdo.

Todos os códigos do idioma suportados são exibidos.4. Clique em Incluir.

Capítulo 9. Opções de Configuração 265

Page 278: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Dica: Para remover o suporte, selecione a caixa de seleção próxima do itemsuportado e clique em Remover.

5. Na segunda coluna, digite o valor apropriado.v Para adicionar um suporte ao idioma para dados e metadados de relatório,

digite uma definição de localidade parcial (idioma).v Para adicionar suporte específico de uma região, digite uma definição de

código do idioma completo (idioma - região).6. Repita as etapas 3 a 5 para cada código do idioma adicional de que deseja o

suporte.7. No menu Arquivo, clique em Salvar.

Códigos do idioma do conteúdoUse a tabela Mapeamentos de Localidade do Conteúdo para mapear código doidioma do usuário em um código do idioma completo (idioma - região) ou parcial(idioma). Também é possível mapear o idioma preferencial do usuário para outroidioma se o conteúdo não estiver disponível no idioma preferencial do usuário.

Por exemplo, se um relatório ou scorecard não estiver disponível em um idiomapreferido, 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órioou scorecard no idioma mapeado.

Por padrão, a tabela Mapeamentos de Localidade do Conteúdo inclui os códigosdo idioma que não contêm a região. Isto permite usar somente a porção do idiomado código do idioma ao especificar as configurações do código de idioma, egarante que sejam vistas sempre as informações corretas. Por exemplo, em umbanco de dados multilíngue, os dados geralmente estão disponíveis em idiomasdiferentes, como francês (fr), espanhol (es) e inglês (en), ao invés de estaremdisponíveis em diferentes códigos do idioma, 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 Cognosusam para determinar qual relatório ou scorecard o usuário verá se houverdiversas versões de idioma disponíveis.

Exemplo 1

Um relatório está disponível no Content Manager em dois códigos do idioma,como com en-us (inglês dos Estados Unidos) e fr-fr (francês da França), mas ocódigo do idioma do usuário está definido para fr-ca (francês do Canadá). O IBMCognos usa o mapeamento de código do idioma para determinar qual relatório ousuário vê.

Primeiro, o IBM Cognos verifica se o relatório está disponível no Content Managerno código do idioma do usuário. Se ele não estiver disponível no código do idiomado usuário, o IBM Cognos mapeará o código do idioma do usuário para umcódigo do idioma normalizado na guia Mapeamento de Código do Idioma doConteúdo. Como o código do idioma do usuário é fr-ca, ele será mapeado para fr.O IBM Cognos usa o valor mapeado para ver se o relatório está disponível em fr.Nesse caso, o relatório estará disponível em en-us e fr-fr, e não em fr.

Em seguida, o IBM Cognos mapeia cada um dos relatórios disponíveis para umcódigo do idioma normalizado. Desta forma, en-us se torna en e fr-fr se torna fr.

266 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 279: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Já que o relatório e o código do idioma do usuário mapeiam para fr, o usuário como código do idioma do usuário fr-ca verá o relatório salvo com o código do idiomafr-fr.

Exemplo 2

O código do idioma do usuário e os códigos do idioma do relatório são todosmapeados para o mesmo código do idioma. O IBM Cognos escolhe qual código doidioma usar. Por exemplo, se o código do idioma do usuário for en-ca (inglês doCanadá) e os relatórios estiverem disponíveis em en-us (inglês dos Estados Unidos)e en-gb (inglês do Reino Unido), o IBM Cognos mapeará cada código do idiomapara en. O usuário verá o relatório na configuração do código de idioma escolhidapelo IBM Cognos.

Exemplo 3

Os códigos do idioma do relatório e do usuário não mapeiam para um idiomacomum. O IBM Cognos escolhe o idioma. Neste caso, pode ser necessárioconfigurar um mapeamento. Por exemplo, se um relatório estiver disponível emen-us (inglês dos Estados Unidos) e fr-fr (francês da França), mas o código doidioma do usuário for es-es (espanhol da Espanha), o IBM Cognos escolherá oidioma.

Mapeamento de código do idioma do conteúdoUse a tabela Mapeamentos de Localidade do Conteúdo para mapear código doidioma do usuário em um código do idioma completo (idioma - região) ou parcial(idioma). Também é possível mapear o idioma preferencial do usuário para outroidioma se o conteúdo não estiver disponível no idioma preferencial do usuário.

Procedimento1. Em cada computador que tiver o Content Manager, inicie o IBM Cognos

Configuration.2. No menu Ações, clique em Editar Configuração Global.3. Clique na guia Mapeamentos de Localidade do Conteúdo.4. Clique em Incluir.5. Na caixa Chave, digite o código do idioma do usuário:

v Para se certificar de que todas as regiões de um código do idioma de usuáriovejam o conteúdo em um idioma específico, digite a porção do idioma docódigo do idioma, seguida de um travessão e (-) um asterisco (*).Por exemplo, digite fr-*

v Para se certificar de que um código do idioma de usuário (idioma - região)veja o conteúdo em um idioma específico, digite o código do idiomacompleto.Por exemplo, digite fr-ch

v Para mapear um idioma preferido a outro idioma, digite a porção do idiomapreferido do código do idioma.Por exemplo, digite zh

Dica: Para especificar o código do idioma para usar para um intervalo dechaves, use o caractere curinga (*) com o valor Chave e, em seguida, na caixaMapeamento de Código do Idioma, digite o código do idioma. Por exemplo,se desejar que todas as chaves alemãs usem código do idioma alemão, digitede* na caixa Chave e digite na caixa Mapeamento de Localidade.

Capítulo 9. Opções de Configuração 267

Page 280: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

6. Na caixa Mapeamento de Localidade, digite a porção do idioma do código doidioma.Os usuários locais especificados na caixa Chave visualizarão o conteúdo noreferido idioma.

7. Repita as etapas 3 a 5 em outros mapeamentos que deseja fazer.8. Clique em OK.9. No menu Arquivo, clique em Salvar.

Mapeamento de códigos do idioma do produtoUse a tabela Mapeamentos de Código de Idioma do Produto para especificar oidioma usado na interface com o usuário quando o idioma especificado no códigodo idioma do usuário não estiver disponível.

Certifique-se de que todas as regiões de um código do idioma usam o mesmoidioma, ou que um código do idioma específico e completo (idioma - região) useum idioma em particular.

Por padrão, o usuário vê a interface do produto no idioma que corresponde àconfiguração de idioma do código do idioma do usuário.

Procedimento1. Em cada computador que tiver o Content Manager, inicie o IBM Cognos

Configuration.2. No menu Ações, clique em Editar Configuração Global.3. Clique na guia Mapeamentos de Código de idioma do produto.4. Clique em Incluir.5. Na caixa Chave, digite o código do idioma do usuário:

v Para se certificar de que todas as regiões de um código do idioma de usuáriovejam a interface com o usuário em um idioma específico, digite a porção doidioma do código do idioma, seguida de um travessão e (-) um asterisco (*).Por exemplo, digite es-*

v Para se certificar de que um código do idioma completo (idioma - região)veja a interface com o usuário em um idioma específico, digite o código doidioma completo.Por exemplo, digite es-es

v Para mapear um idioma preferido a outro idioma, digite a porção do idiomapreferido do código do idioma.Por exemplo, digite zh

Dica: Para especificar qual código do idioma usar como padrão, use o caracterecuringa (*) para o valor Chave e, em seguida, na caixa Mapeamento de Códigodo Idioma, digite o código do idioma.

6. Na caixa Mapeamento de Localidade, digite a porção do idioma do código doidioma.Os usuários locais especificados na caixa Chave visualizarão o conteúdo noreferido idioma.

7. Repita as etapas 3 a 5 em outros mapeamentos que deseja fazer.8. Clique em OK.9. No menu Arquivo, clique em Salvar.

268 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 281: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Personalização do fuso horário do servidorÉ possível customizar o fuso horário usado pelo Content Manager selecionandoum fuso horário do servidor diferente no IBM Cognos Configuration.

Para instalações em UNIX que não suportam uma interface gráfica de usuáriobaseada em Java, é possível visualizar a lista de fusos horários aceitáveis abrindo oIBM Cognos Configuration no computador Windows onde o Framework Managerestá instalado.

O Content Manager está configurado para usar o fuso horário de seu sistemaoperacional por padrão. Todas as atividades planejadas no IBM Cognos sãoconfiguradas com o uso desse fuso horário. Além disso, os usuários no IBMCognos Connection usarão esse mesmo fuso horário se configurarem suaspreferências para o fuso horário padrão. Para obter informações adicionais sobre aconfiguração das preferências de usuário no IBM Cognos Connection, consulte IBMCognos Business Intelligence: Guia de Administração e Segurança.

Procedimento1. Inicie o IBM Cognos Configuration.2. No menu Ações, clique em Editar Configuração Global.3. Na janela Configuração global, clique na guia Geral.4. Clique na coluna Valor de Fuso horário do servidor e selecione outro fuso

horário na lista.5. No menu Arquivo, clique em Salvar.

Codificação para E-mailsPor padrão, os componentes do IBM Cognos usam codificação UTF-8 em e-mails.Este valor define a codificação padrão usada pelo serviço de entrega nestainstância para todos os e-mails. Você pode ter clientes de e-mail mais antigos oue-mails enviados do IBM Cognos para telefones celulares e PDAs que nãoreconhecem UTF-8. Se for o caso, mude a codificação de e-mail para um valor quefuncione com todos os clientes de e-mail (por exemplo, ISO-8859-1, Shift-JIS). Cadainstância do IBM Cognos que tem um serviço de entrega disponível deve seralterada.

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:

Tabela 57. Valores de Codificação Suportados

Conjunto de caracteres Valor de codificação suportado

UTF-8 utf-8

Europa Ocidental (ISO 8859-1) iso-8859-1

Europa Ocidental (ISO 8859-15) iso-8859-15

Europa Ocidental (Windows-1252) windows-1252

Europa Central e Oriental (ISO 8859-2) iso-8859-2

Europa Central e Oriental (Windows-1250) windows-1250

Cirílico (ISO 8859-5) iso-8859-5

Cirílico (Windows-1251) windows-1251

Capítulo 9. Opções de Configuração 269

Page 282: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Tabela 57. Valores de Codificação Suportados (continuação)

Conjunto de caracteres Valor de codificação suportado

Turco (ISO 8859-9) iso-8859-9

Turco (Windows-1254) windows-1254

Grego (ISO 8859-7) iso-8859-7

Grego (Windows-1253) windows-1253

Japonês (EUC-JP) euc-jp

Japonês (ISO-2022-JP) iso-2202-jp

Japonês (Shift-JIS) shift_jis

Chinês tradicional (Big5) big5

Chinês simplificado (GB-2312) gb2312

Coreano (EUC-KR) euc-kr

Coreano (ISO 2022-KR) ISO 2022-KR

Coreano (KSC-5601) ksc_5601

Tailandês (Windows-874) windows-874

Tailandês (TIS-620) tis-620

Mudança da codificação de e-mailsÉ possível alterar a codificação de e-mail para um valor que funcione em todos osclientes de e-mail.

Procedimento1. Inicie o IBM Cognos Configuration.2. No menu Ações, clique em Editar Configuração Global.3. Na janela Configuração global, clique na guia Geral.4. Clique na coluna Valor na propriedade Codificação de e-mail.5. Role a tela até a definição desejada e clique nela.6. No menu Arquivo, clique em Salvar.

Customizando as configurações de cookieCom base nos requisitos do ambiente do IBM Cognos, você pode precisarmodificar as configurações usadas pelos componentes do IBM Cognos para criarcookies. É possível usar o IBM Cognos Configuration para customizar o domíniodo cookie, o caminho e o sinalizador seguro.

Os componentes do IBM Cognos determinam o domínio do cookie a partir dasolicitação de HTTP enviada pelo cliente, que normalmente é um navegador daWeb. Na maioria das configurações de rede, as solicitações de HTTP passam porintermediários como servidores proxy e firewalls conforme viajam do navegadorpara os componentes do IBM Cognos. Alguns intermediários modificam asinformações que os componentes do IBM Cognos usam para calcular o domínio docookie e esses componentes do IBM Cognos não podem configurar cookies. Osintoma comum deste problema é os usuários serem solicitados repetidamente parafazer 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 querepresentam a maior cobertura para o host, conforme sugerido a seguir:

270 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 283: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

v Para o valor de Domínio, use o nome do computador ou servidor independente.Especifique este nome sem qualquer ponto. Por exemplo, mycompany

v O valor de Domínio pode também especificar um sufixo. Os sufixos incluem.com, .edu, .gov, .int, .mil, .net ou .org. Inclua um ponto de prefixo. Por exemplo,.mycompany.com

v Outros níveis podem ser usados em um valor de Domínio. Inclua um ponto deprefixo. Por exemplo, .accounts.mycompany.com

v Um valor do Caminho pode restringir ainda mais os cookies. O caminho maiscomum é /. Um caminho de /payables restringe o cookie para todos oscaminhos que se iniciam com "payable" (e todos os subdiretórios). Um caminhode /payables/ restringe o cookie ao diretório "payables" (e todos ossubdiretórios).

Além disso, para segurança, os administradores podem configurar o atributoHTTPOnly para bloquear scripts de leitura ou manipulação do cookie depassaporte do CAM durante uma sessão do usuário com seu navegador da Web.Para obter mais informações sobre este atributo, consulte IBM Cognos BusinessIntelligence: Guia de Administração e Segurança.

Procedimento1. Em cada computador que tiver o Content Manager, inicie o IBM Cognos

Configuration.2. No menu Ações, clique em Editar Configuração Global.3. Clique na guia Geral.4. Clique na coluna Valor em Configurações de cookie, para cada propriedade

que deseja mudar e especifique o novo valor.Se deixar a propriedade Domínio em branco, o dispatcher obtém o domínio donome do host ou da solicitação.

5. Clique em OK.

Mudança da versão do endereço IPO IBM Cognos suporta duas versões de endereço IP: IPv4 e IPv6. O IPv4 usaendereços IP de 32 bits e o IPv6 usa endereços IP de 128 bits. Por exemplo:v IPv4: 192.168.0.1:80v IPv6: [2001:0db8:0000:0000:0000:148:57ab]:80

No IBM Cognos Configuration, é possível selecionar IPv4 ou IPv6 paracomunicação do IBM Cognos usando a propriedade Versão IP para Resolução doNome do Host. Como padrão, usa-se IPv4.

A configuração é aplicada somente ao computador em que foi definida. Se vocêselecionar Usar endereços IPv4, todas as conexões de saída do IBM Cognos nessecomputador serão estabelecidas usando IPv4 e o dispatcher aceitará apenasconexões IPv4 recebidas. Se você selecionar Usar endereços IPv6, todas asconexões de saída do IBM Cognos nesse computador serão estabelecidas usandoIPv6 e o dispatcher aceitará conexões IPv4 e IPv6 recebidas.

Os computadores do cliente IPv4 conseguem se comunicar com computadores dedispatcher configurados para IPv6.

Os nomes do host especificados dentro de um URI são resolvidos com base novalor da propriedade Versão IP para resolução do nome do host. Entretanto, se

Capítulo 9. Opções de Configuração 271

Page 284: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

um URI tiver sido especificado com um endereço numérico, ele terá precedênciasobre essa configuração e a comunicação ocorrerá utilizando IPv4.

Para o IBM Cognos Configuration aceitar endereços IPv6 nas propriedades do URIlocal, você deve iniciar o IBM Cognos Configuration com a opção -ipv6. É possívelespecificar a opção cada vez que você abre o IBM Cognos Configuration a partirda linha de comandos.

No Windows, é possível configurar a opção permanentemente incluindo a opçãono atalho do menu Iniciar.

Configurando a Versão IPUse o IBM Cognos Configuration para selecionar a versão IP.

Procedimento1. Inicie o IBM Cognos Configuration.2. Na janela Explorer, clique em Ambiente.3. Clique na caixa Valor para Versão IP para resolução do nome do host e, a

seguir. em Use endereços IPv4 ou Use endereços IPv6.4. No menu Arquivo, clique em Salvar.5. Feche o IBM Cognos Configuration.

Configurando Manualmente o IBM Cognos Configuration paraIniciar com a Opção IPv6

É possível configurar manualmente o IBM Cognos Configuration para usar a opçãoIPv6 especificando a opção no comando start.

Procedimento1. Acesse o diretório c10_location/bin ou c10_location/bin64.2. Inicie o IBM Cognos Configuration incluindo a opção IPv6 no comando da

seguinte forma:v No Windows, digite

cogconfig.bat -ipv6

v No UNIX ou Linux, digite./cogconfig.sh -ipv6

3. Edite as propriedades do URI que utilizam o formato IPv6, especifique osvalores e, no menu Arquivo, clique em Salvar.

Configurando o IBM Cognos Configuration para SempreComeçar com a Opção IPv6 no Windows

É possível configurar o IBM Cognos Configuration para sempre começar usando aopção IPv6 em sistemas operacionais Microsoft Windows configurando a opção noatalho do menu Iniciar.

Procedimento1. No menu Iniciar, selecione Programas > IBM Cognos 10 e clique com o botão

direito do mouse em IBM Cognos Configuration, Propriedades.2. Na guia Atalho, na caixa Destino, digite "c10_location\bin\cogconfigw.exe

-ipv6"

3. Clique em OK.

272 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 285: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Propriedades do Local do Arquivo no Windows VistaSe você instalar componentes do cliente IBM Cognos em um ambiente que incluaWindows Vista, você deverá alterar propriedades do local do arquivo no IBMCognos Configuration para que o IBM Cognos possa usar um único local de dadospara todos os usuários. As mudanças devem ser feitas em todos os computadoresem que os componentes do cliente IBM Cognos estão instalados.

O Windows Vista possui um aprimoramento de segurança que restringe ocompartilhamento de dados de diversos locais entre diversos usuários. É possíveldefinir variáveis de ambiente e usá-las no IBM Cognos Configuration ao especificaros locais de arquivos. Isso permite direcionar os arquivos aplicáveis a uma áreaque possa ser acessada pelos usuários do IBM Cognos. No Windows, sãopredefinidas duas variáveis de ambiente para os usuários: uma para todos osusuários e uma para um usuário específico.

Como as variáveis de ambiente representam locais raiz do sistema, inclua tambémo nome do diretório-raiz do local de instalação ao especificar locais de arquivo noIBM Cognos Configuration. O diretório-raiz padrão para o IBM Cognos é c10.

Atualização das Propriedades de Localização de Arquivos noWindows Vista

Você deve alterar propriedades do local do arquivo no IBM Cognos Configurationpara que o IBM Cognos possa usar um único local de dados para todos osusuários. As mudanças devem ser feitas em todos os computadores em que oscomponentes do cliente IBM Cognos estão instalados.

Procedimento1. Inicie o IBM Cognos Configuration.2. Na janela Explorer, clique em Ambiente.3. Na janela Propriedades, clique em Localização de arquivos de implementação.4. Substitua o elemento do caminho relativo, "..", pela variável de ambiente e o

diretório-raiz apropriados:v Para uma localização de arquivo única por usuário, %LOCALAPPDATA%v 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 ocaminho %LOCALAPPDATA%/c10/deployment.

5. Repita a etapa 4 para as seguintes propriedades:v Em Ambiente,

- Localização dos arquivos de dados

- Localização dos arquivos de mapeamento

- Localização dos arquivos temporários

v Em Ambiente, Criação de log, Arquivo,- Localização dos arquivos de log

v Em Criptografia,- Local do armazenamento da chave simétrica comum

v Em Criptografia, Cognos,- Localização do certificado

Capítulo 9. Opções de Configuração 273

Page 286: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

- Local do armazenamento da chave de assinatura

- Local do armazenamento de chave de criptografia

6. No menu Arquivo, clique em Salvar.

Resultados

As variáveis de ambiente são resolvidas quando os locais do arquivo são acessadosdurante as atividades de sistema.

Alterando Definições de Configuração para o Serviço do IBM CognosSeries 7 Migration

Se for necessário, é possível alterar o número da porta de serviço usada peloserviço do IBM Cognos Series 7 Migration.

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

v No Windows, reinicie o serviço de migração usando a entrada Serviço doIBM Cognos Migration Series 7 na lista Serviços em FerramentasAdministrativas.

v No UNIX, pare e depois inicie o serviço de migração digitando os seguintescomandos no diretório migs7service: ./configure.sh --stop./configure.sh --start

Incluindo uma Conta do Usuário no PowerPlay e Serviços de Migraçãopara Migração

Por padrão, o serviço do IBM Cognos PowerPlay Enterprise Server e o serviço demigração usam uma conta do sistema. Se diversos servidores do PowerPlay irãocompartilhar locais de dados durante a migração, primeiro é necessário atribuiruma conta de usuário aos serviços.

Uma conta do usuário deve ser configurada em cada computador Windows emque o componente Series 7 Migration Components ou PowerPlay está instalado.

Antes de Iniciar

Antes de atribuir a conta de usuário aos serviços, verifique se uma conta deusuário foi definida com uma senha que nunca expira.

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

274 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 287: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

3. Na área de janela 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 9. Opções de Configuração 275

Page 288: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

276 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 289: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Capítulo 10. Configuração do Portal Services

Portal Services fornece um conjunto de portlets do IBM Cognos que pode serusado no IBM Cognos Connection e em outros portais. É possível usar os portletspara navegar, procurar e visualizar relatórios do IBM Cognos em seu ambiente detrabalho. Outros usuários podem visualizar informações do IBM Cognos sem anecessidade de saber como usar produtos IBM Cognos.

Para obter informações adicionais, consulte o Guia de Administração e Segurança doIBM Cognos Business Intelligence.

O Portal Services é instalado automaticamente com os componentes do IBMCognos. Em um ambiente distribuído, ele está incluído com o Application TierComponents. A instalação inclui os arquivos de implementação parav Portal IBM WebSpherev Oracle WebCenter Interaction Portalv SharePoint Portal

Para algumas implementações do Portal Services, você deve modificar algumasconfigurações de propriedade do Portal Services e preparar o ambiente do IBMCognos para suportar o outro portal.

Quando utilizado em um outro portal, o Portal Services pode autenticar usuáriosem apenas um namespace. Se os componentes do IBM Cognos estiveremconfigurados com mais de um namespace, você deverá instalar um gatewayseparado para cada namespace que será usado para autenticar usuários do portal.É preciso configurar cada gateway para utilizar o namespace adequado e, emseguida, configurar os portlets implantados para utilizar esse gateway.

Após configurar as propriedades necessárias, você deverá implementar os portletsdo Cognos para o outro portal. Para obter informações adicionais, consulte o Guiade Administração e Segurança do IBM Cognos Business Intelligence.

Para usar o Portal Services com componentes do IBM Cognos, faça o seguinte:v Especifique a localização do arquivo applications.xml, se necessário.v Instale e teste os portlets no outro portal.

Para obter informações adicionais, consulte o Guia de Administração e Segurançado IBM Cognos Business Intelligence.

v Configure a segurança para o outro ambiente de portal.

Especificação da localização do arquivo applications.xmlSe utilizar o arquivo applications.xml como parte de um portlet de aplicativocustomizado, todos os computadores com Application Tier Components em umambiente distribuído deverão utilizar o mesmo arquivo applications.xml. Se tiverdiversas instâncias do arquivo applications.xml, elas deverão ser idênticas.

Nota: As etapas são necessárias somente se você quiser usar o portlet ExtendedApplications, que está incluído no kit de desenvolvimento de software do IBMCognos Business Intelligence.

© Copyright IBM Corp. 2005, 2014 277

Page 290: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Procedimento1. No computador com Componentes da Camada de Aplicativos, 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 de Local do

'applications.xml'.4. Substitua o localhost por um nome do host ou endereço IP válido e, se

necessário, substitua o número da porta padrão.5. No menu Arquivo, clique em Salvar.

Resultados

Agora é possível implementar os portlets do IBM Cognos em seu servidor deportal. Para obter instruções, consulte IBM Cognos Business Intelligence: Guia deAdministração e Segurança.

Configuração da segurança para o Portal ServicesAo usar o Portal Services em outro portal, você deve ativar conexão única parafornecer integração direta entre o outro portal e os componentes do IBM Cognos.

O Portal Services usa uma conexão única para autenticar usuários. Isto significaque os usuários não devem fazer logon para outros aplicativos separadamente noportal.

Você deve configurar um URI nos componentes do IBM Cognos para cada portletno Portal Services.

Para ativar a segurança entre os componentes do IBM Cognos e o outro portal,faça o seguinte:v Desative o acesso anônimo aos componentes do IBM Cognos.

Caso a infra-estrutura de segurança necessite de outro método de conexão única,utilize um dos métodos seguintes:

v Ative uma conexão única para o outro portal usando o shared secret.v Configure os componentes do IBM Cognos para acesso SSL, se necessário.

Desativar Acesso Anônimo a Componentes do IBM CognosO Portal Services usa uma conexão única para a autenticação. Se o logon anônimoestiver ativado nos componentes do IBM Cognos, o Portal Services registrará todosos usuários do portal como anônimos. Você deve assegurar que o acesso anônimoesteja desativado nos componentes do IBM Cognos para que a conexão única noPortal Services seja bem-sucedida. Entretanto, teste as conexões do Portal Servicesusando o logon anônimo para garantir que os portlets estejam funcionando nooutro portal.

Se o Portal Services não for capaz de autenticar um usuário, este recebe umamensagem de erro no outro portal.

Procedimento1. Inicie o IBM Cognos Configuration.2. Na janela Explorer, em Segurança > Autenticação, clique em Cognos.

278 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 291: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

3. Na janela Propriedades, verifique se Permitir acesso anônimo está configuradocomo Falso.

4. No menu Arquivo, clique em Salvar.5. Repita as etapas 1 a 4 em todos os servidores nos quais você instalou os

componentes do IBM Cognos.

Ativação de conexão única com Shared secretÉ possível usar o segredo compartilhado para conexão única entre portlets do IBMCognos e componentes do IBM Cognos. Os portlets do Cognos enviam umamensagem que contém uma versão criptografada do ID do usuário do portal. Achave de criptografia é determinada pelo valor de uma sequência de caracteressecretos compartilhada entre os portlets e o provedor de segurança Javacustomizado no servidor IBM Cognos.

É possível usar o segredo compartilhado para o outro portal se os IDs de usuáriodo portal puderem ser pesquisados em um namespace compartilhado peloscomponentes do IBM Cognos.

Os componentes do IBM Cognos devem ter acesso a um servidor de diretório quecontenha IDs de usuário para todos os usuários do portal. Usando o IBM CognosConfiguration, você deve configurar um namespace de autenticação para que oscomponentes do portal e do IBM Cognos compartilhem a mesma fonte deautenticação.

Você deve também criar um namespace de Provedor Java Customizado pararegistrar o provedor Java do segredo compartilhado que é fornecido comcomponentes do IBM Cognos. Nos portlets ou iViews, você deve vincular osportlets ou iViews ao namespace de Provedor Java Customizado no respectivoportal:v Cognos Portlet Application (WebSphere Portal)v Servidor remoto (Oracle WebCenter Interaction Portal)v Web Parts do Cognos (Portal do SharePoint)

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 acessopara um URI alternativo para as imagens e conteúdo web do Portal Services.

Configurar os Namespaces NecessáriosOs componentes do IBM Cognos devem ter acesso a um servidor de diretório quecontenha IDs de usuário para todos os usuários do portal. Usando o IBM CognosConfiguration, você deve configurar um namespace de autenticação para que oscomponentes do portal e do IBM Cognos compartilhem a mesma fonte deautenticação.

Procedimento1. No IBM Cognos Configuration, configure um namespace para autenticar

usuários do portal.2. Para um namespace LDAP, configure as seguintes propriedades:

v Para a propriedade Utilizar identidade externa, altere a configuração paraVerdadeiro.

v Para a propriedade Mapeamento de identidade externa, defina-a como(uid=${environment("REMOTE_USER")})

Capítulo 10. Configuração do Portal Services 279

Page 292: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Para o SharePoint Portal, se o SharePoint estiver em uma máquina diferentedo servidor LDAP, defina Mapeamento de identidade externa como(uid=${replace(${environment("REMOTE_USER")},"SharePoint_Server\\","")})

3. Para um namespace IBM Cognos Series 7, mapeie os IDs do usuário do portalpara IDs do usuário do IBM Cognos Series 7 usando conexões de S.O.Para obter informações adicionais, consulte a documentação do IBM CognosSeries 7.

4. No IBM Cognos Configuration, crie e configure um namespace de Custom JavaProvider.v 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.v Para a propriedade Nome da classe Java, digite

com.cognos.cps.auth.CPSTrustedSignon

Os nomes de classes Java fazem distinção entre maiúsculas e minúsculas.5. No IBM Cognos Configuration, em Ambiente > Portal Services, configure as

seguintes propriedades:v Para ID de Namespace de Conexão Confiável, digite o ID do namespace

configurado na etapa 1.

Dica: O namespace de conexão confiável atua como um intermediário e deveser conectado a um namespace real baseado em diretório.

v Para Shared Secret, digite a chave a ser usada para o único signon.Este parâmetro representa o segredo de autorização que deve sercompartilhado entre os portlets do Cognos e o servidor IBM Cognos.Considere isto uma senha secreta. Você deve usar a mesma sequência decaracteres ao configurar o aplicativo de portlet. Você deve usar uma únicapalavra 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 Permitirsubstituição do namespace como verdadeira.

7. No menu Arquivo, clique em Salvar.8. Reinicie o serviço do IBM Cognos.

Configurar Acesso ao Portal Services Web ContentDepois de criar os namespaces necessários, você deve configurar o acesso para queesses usuários possam acessar o Web content.

Procedimento1. No computador no qual foram instalados os Componentes da Camada de

Aplicativos, 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 formatohost_or_IP_address:port

5. No menu Arquivo, clique em Salvar.

280 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 293: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Configurar o Cognos iViews para SAP EPNo iViews, você deve vincular o iViews ao namespace Custom Java Provider emseu respectivo portal.

Configurar os Portlets do Cognos para WebSphere PortalNos portlets, você deve vincular os portlets ao namespace Custom Java Providerem seu respectivo portal.

Procedimento1. Para cada aplicativo de portlet do Cognos, clique no ícone do valor de edição.2. Para a propriedade cps_auth_secret, insira a sequência de caracteres secretos

usada para a propriedade Segredo Compartilhado quando você configurou onamespace Custom Java Provider.

3. Para a propriedade cps_auth_namespace, insira o ID do namespace CustomJava Provider.

4. Para a propriedade CPS Endpoint, insira o caminho do URL para acessar oscomponentes do Portal Services no gateway.O formato do URL é o seguinte:v Para portlets de conteúdo do Cognos

Gateway_URI/wsrp/cps4/portlets/nav?wsdl&b_action=cps.wsdlExemplo de um gateway CGI:http://myserver/ibmcognos/cgi-bin/cognos.cgi/wsrp/cps4/portlets/nav?wsdl&b_action=cps.wsdlExemplo de um gateway de servlet:http://172.0.16.1:9500/wsrp/cps4/portlets/nav?wsdl&b_action=cps.wsdl

v Para Cognos Extended ApplicationsGateway_URI/wsrp/cps4/portlets/sdk?wsdl&b_action=cps.wsdlExemplo de um gateway CGI:http://myserver/ibmcognos/cgi-bin/cognos.cgi/wsrp/cps4/portlets/sdk?wsdl&b_action=cps.wsdlExemplo de um gateway de servlet:http://172.0.16.1:9500/wsrp/cps4/portlets/sdk?wsdl&b_action=cps.wsdl

v Para portlets de Lista de observação do Metrics ManagerGateway_URI/wsrp/cps4/portlets/cmm?wsdl&b_action=cps.wsdlExemplo de um gateway CGI:http://myserver/ibmcognos/cgi-bin/cognos.cgi/wsrp/cps4/portlets/cmm?wsdl&b_action=cps.wsdlExemplo de um gateway de servlet:http://172.0.16.1:9500/wsrp/cps4/portlets/cmm?wsdl&b_action=cps.wsdl

Configurar o Servidor Remoto para Oracle WebCenter InteractionPortalNos portlets, você deve vincular os portlets ao namespace Custom Java Providerem seu respectivo portal.

Procedimento1. Usando um editor de ASCII simples, como Bloco de Notas, edite o arquivo

cpsalui.properties no diretório c10_location/cps/oracle/webapps/gadgets/WEB-INF/classes.

2. Configure as definições mostradas na tabela a seguir.

Capítulo 10. Configuração do Portal Services 281

Page 294: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Tabela 58. Configurações para o Arquivo cpsalui.properties

Parâmetro Valor

cps_endpoint O URL para conectar-se ao Application TierComponents e extrair as informações WSDL.

Especifique o URI do gateway

Para um servlet ou gateway ISAPI, substituaa parte localhost/ibmcognos/cgi-bin/cognos.cgi pelos valores paradirecionamento do gateway.

Por exemplo,

http://host_name/ibmcognos/cgi-bin/cognosisapi.dll/wsrp/cps4/portlets/[package]?wsdl&b_action=cps.wsdl

forward_cookies= Os nomes do cookie que devem serenviados ao Application Tier Componentspara um único signon.

Deixar em branco.

cps_auth_secret O código do segredo compartilhado usadopelo IBM Cognos para criptografar umavariável de cabeçalho HTTP que carrega aidentidade do usuário.

Este parâmetro representa o segredo deautorização que deve ser compartilhadoentre os portlets do Cognos e o servidorIBM Cognos. Considere isto uma senhasecreta. Use o mesmo valor usado paraSegredo Compartilhado no IBM CognosConfiguration.

Por razões de segurança, especifique umvalor não nulo.

cps_auth_namespace O ID do namespace para o Custom JavaProvider.

3. Acesse o diretório c10_location/cps/oracle e execute o arquivo de construçãoa seguir:v Em computadores executando um sistema operacional UNIX ou Linux,

build.sh

v Em computadores executando um sistema operacional Microsoft Windows,build.bat

Isto cria um arquivo cps-wci.war no diretório c10_location/cps/oracle/gadgets.

4. Se os componentes do IBM Cognos BI estiverem usando o servidor deaplicativos fornecido com o IBM Cognos BI,v Pare o IBM Cognos BI.v Copie o arquivo cps-wci.war para o diretórioc10_location/webapps.v Inicie o IBM Cognos BI.

5. Se os componentes do IBM Cognos BI estiverem em execução sob outroservidor de aplicativos, copie o arquivo cps-wci.war para o servidor deaplicativos.

282 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 295: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Para obter instruções, consulte o guia de administração de seu servidor deaplicativos.

Resultados

A conexão única está configurada.

Configurar Propriedades para o Web Parts do Cognos para oPortal do SharePointNos portlets, você deve vincular os portlets ao namespace Custom Java Providerem seu respectivo portal.

Procedimento1. Usando um editor de ASCII simples, como o Bloco de Notas, edite o arquivo

web.config no drive\inetpub\wwwroot\wss\VirtualDirectories\virtual_directory_sharepoint _is_running_under.

2. Localize a seguinte sequência:<SSO cps_auth_namespace="" cps_auth_secret="" />

3. Defina cps_auth_namespace para o ID de namespace para o namespace CustomJava Provider.

4. Defina cps_auth_secret para o valor usado para Segredo Compartilhado noIBM Cognos Configuration.

Ativar Conexão Única com Sharepoint Usando Autenticaçãodo Kerberos

Para usar o protocolo Kerberos para os seus aplicativos da web, você deveconfigurar o Internet Information Services (IIS), o Sharepoint Portal, o MicrosoftSQL Server, seu navegador da web e o IBM Cognos BI.

Resumo da configuração

Use a tabela a seguir para ajudá-lo a ativar a conexão única com Sharepointusando autenticação do Kerberos.

Tabela 59. Resumo de Configuração para Ativar Conexão Única com Sharepoint UsandoAutenticação do Kerberos

Software Tarefas de configuração

Servidor Microsoft Windows Permita que os usuários sejam confiáveis paradelegação.

Microsoft Internet InformationServices (IIS)

v Associe o website que é usado para o Cognos BIcom um conjuntos de aplicativos e assegure que oconjunto de aplicativos seja executado por umaconta de serviço do domínio que tenha delegaçãoativada.

v Certifique-se de que autenticação anônima estádesativado.

v Ative a autenticação do Windows

v Ative o provedor de autenticação do Kerberos paraautenticação do Windows.

v Desative a autenticação de modo Kernel.

v Configure o Service Principal Names (SPN) para oservidor da web IIS.

Capítulo 10. Configuração do Portal Services 283

Page 296: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Tabela 59. Resumo de Configuração para Ativar Conexão Única com Sharepoint UsandoAutenticação do Kerberos (continuação)

Software Tarefas de configuração

Microsoft Internet Explorer Certifique-se de que as URLs para os aplicativos daweb estejam na zona da intranet ou em uma zonaque esteja configurada para autenticar-seautomaticamente com a Autenticação do WindowsIntegrada.

Firefox Ative o suporte para autenticação do Kerberos emseu navegador da web Firefox.

Active Directory v Crie contas de serviço para o conjunto deaplicativos IIS para os aplicativos da web.

v Registre o Service Principal Names (SPN) para osaplicativos da web na conta do serviço que é criadapara o conjunto de aplicativos do IIS para oaplicativo da web.

v Configure delegação restrita do Kerberos paracontas do serviço.

Aplicativo da web do SharePoint Para ativar a autenticação do Kerberos em SharePoint,você deve:

v Crie contas gerenciadas do SharePoint Server eassegure que a conta do serviço do domínio estejaregistrada como uma conta gerenciada.

v Configure o Service Principal Names (SPN) noservidor SharePoint.

v Associe o site do SharePoint a um conjunto deaplicativos, certifique-se de que o aplicativo sejaexecutado por uma conta de serviço de domínio eque a conta de domínio tenha a delegação ativada.

v Use o SharePoint Central Administration paraindicar que a autenticação do Kerberos é usadapara definir como os usuários interagem com umserviço de rede para obter acesso aos recursos darede.

v Desative a autenticação Anônima.

v Desative a autenticação de modo Kernel.

Para obter informações adicionais sobre a ativação daautenticação do Kerberos em Sharepoint, consulte adocumentação do SharePoint da Microsoft(technet.microsoft.com/en-us/library/ee806870.aspx).

Microsoft SQL Server v Certifique-se de que os serviços estejam emexecução usando a conta do domínio.

v Conceda aos usuários permissões apropriadas paraa origem de dados.

v Configure o SPN no servidor SQL.

IBM Cognos BI v Crie um namespace de autenticação e desative oAcesso Anônimo.

v Crie uma origem de dados e a proteja contra onamespace ativo.

284 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 297: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Configurando o IBM Cognos BI para Usar um Namespace doActive Directory para Autenticação do KerberosVocê pode utilizar o servidor Active Directory como sua origem de autenticação epara conexão única utilizando a delegação Kerberos. Use o IBM CognosConfiguration para configurar o namespace para autenticação do Kerberos.

Sobre Esta Tarefa

Por padrão, o fornecedor do Active Directory usa delegação do Kerberos e seintegra com o servidor da web Microsoft IIS para conexão única se a autenticaçãointegrada (anteriormente nomeada NT Challenge Response) em um sistemaoperacional Microsoft Windows estiver ativada no servidor da web IIS.

Configure os computadores ou a conta de usuário sob a qual o SharePoint executapara serem confiáveis para delegação. Ao configurar os computadores utilizando aferramenta de usuário do Active Directory, não selecione o atributo Conta, que ésensível e não pode ser delegado.

Procedimento1. Em cada local em que o SharePoint está instalado, abra o IBM Cognos

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

Autenticação e clique em Novo Recurso, Namespace.3. Na caixa Nome, digite um nome para o namespace de autenticação.4. Na lista Tipo, clique em Active Directory e, em seguida, clique em OK.

O novo recurso do provedor de autenticação aparece na janela Explorer, sob ocomponente de Autenticação.

5. Na janela Propriedades, na propriedade ID do Namespace, especifique umidentificador exclusivo para o namespace.

Restrição: Não use dois pontos (:) na propriedade ID do namespace.6. Especifique os valores para todas as propriedades necessárias para garantir que

o IBM Cognos possa localizar e usar seu provedor de autenticação existente.7. Clique em Arquivo > Salvar.8. Teste a conexão em um novo namespace. Na janela Explorer, em Autenticação,

clique com o botão direito no novo recurso de autenticação e clique em Testar.9. Para desativar a autenticação Anônima, execute as seguintes etapas:

a. Na janela Explorer, em Segurança Autenticação, clique no namespace deautenticação que você criou.

b. Na janela Propriedades, verifique se Permitir acesso anônimo estáconfigurado como Falso.

c. Clique em Arquivo > Salvar.d. Repita as etapas a até c em todos os servidores de aplicativos da web que

usam autenticação Kerberos.

Criando uma Origem de Dados Ativada para KerberosVocê pode criar uma origem de dados autenticada pelo protocolo Kerberosutilizando o IBM Cognos Administration. A origem de dados define a conexãofísica ao banco de dados. A origem de dados especifica os parâmetros que sãonecessários para se conectar ao banco de dados, incluindo conexão.

Capítulo 10. Configuração do Portal Services 285

Page 298: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Procedimento1. No IBM Cognos Connection, selecione Ativar > IBM Cognos Administration.2. Na guia Configuração, selecione Conexões de Origens de Dados.

3. Selecione o botão Nova origem de dados .4. Na página Nome e Descrição, digite um nome exclusivo para a origem de

dados.5. Na página Conexão, no menu Tipo, selecione o tipo de origem de dados que

deseja criar, como Microsoft SQL Server ou Microsoft Analysis Services.6. Em nível de Isolamento, selecione Usar o gateway do objeto padrão e clique

em OK.7. Especifique os parâmetros de conexão para a origem de dados do Microsoft

SQL Server.Para obter informações sobre os parâmetros da conexão para a origem dedados, consulte o Guia de Administração e Segurança do IBM Cognos BusinessIntelligence.

8. Em Conexão,selecione Um namespace externo e escolha o namespace que vocêcriou para autenticar usuários em relação à origem de dados do Kerberos.As credenciais utilizadas para autenticar na origem de dados são obtidas donamespace especificado ao qual o usuário autenticou anteriormente.

9. Para testar se os parâmetros estão corretos, clique em Testar a conexão e, emseguida, clique em Testar.Na coluna Status, é possível ver se a conexão foi bem-sucedida. Se foi malsucedida, clique em Fechar, retorne às etapas anteriores e verifique seusparâmetros de conexão.

Resultados

A nova origem de dados ativada para Kerberos é exibida na lista Conexões daOrigem de Dados na guia Configuração e pode ser selecionada quando vocêestiver usando o assistente de Metadados no Framework Manager.

Ativando Conexão Única para WebSphere Portal Usando oServidor de Aplicativos

Os portlets do Portal Services podem usar os objetos do Active Credentialsfornecidos pelo WebSphere Portal para conexão com os componentes do IBMCognos. 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 esteobjeto. Para obter informações adicionais sobre os objetos Active Credential,consulte a documentação para o IBM WebSphere Portal.

Para usar conexão única de servidor de aplicativos, consulte a documentação parao IBM WebSphere Application Server.

286 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 299: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Ativação de conexão única para o portal Oracle WebCenterInteraction Portal usando autenticação básica

É possível configurar um portlet no WebCenter Interaction Portal para enviar onome de usuário e senha como um cabeçalho de autenticação HTTP Basic. Ocabeçalho pode ser usado com um namespace de autenticação para fornecerconexão única.

Procedimento1. No IBM Cognos Configuration, configure um namespace para autenticar

usuários do portal.2. Instale um gateway CGI ou ISAPI ou de servlet alternativo no IBM Cognos.3. Configure o gateway.4. No console administrativo 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 do WebCenter Interaction para acessar o IBMCognos BI:v Edite o arquivo cpsalui.properties no diretório local_c10/cps/oracle/

webapps/gadgets/WEB-INF/classes.v Altere a propriedade cps_endpoint para indicar a URL do gateway.

Para gateways de CGI, é possível utilizar a configuração padrão se ogateway e o servidor remoto estiverem no mesmo computador. Casocontrário, substitua a parte localhost por 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://host_name:port/ibmcognos/cgi-bin/cognosisapi.dll/wsrp/cps4/portlets/[package]?wsdl&b_action=cps.wsdl

v Defina a propriedade cps_auth_namespace para o namespace que você desejausar para autenticação.

Ative a conexão única para o Portal Oracle WebCenterInteraction Usando CA SiteMinder

Se usar o CA SiteMinder para fornecer a conexão única em sua infraestrutura desegurança, também é possível usá-lo para a conexão única com o WebCenterInteraction Portal.

Você deve configurar um namespace de autenticação do CA SiteMinder no IBMCognos BI. O WebCenter Interaction Portal envia o token de autenticação ativo doCA SiteMinder para o servidor remoto, que envia o token para o gateway do IBMCognos.

Procedimento1. No IBM Cognos Configuration, configure um namespace de autenticação do

CA SiteMinder.2. Configure o servidor remoto para encaminhar a token de autenticação:

v Edite o cpsalui.properties arquivo no diretórioc10_location/cps/oracle/webapps/gadgets/WEB-INF/classes.

v Mude a propriedade forward_cookies para incluir o nome do token deautenticação ativo que o CA SiteMinder fornece.

Capítulo 10. Configuração do Portal Services 287

Page 300: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

v Altere a propriedade cps_endpoint para indicar a URL do gateway.Para gateways de CGI, é possível utilizar a configuração padrão se ogateway e o servidor remoto estiverem no mesmo computador. Do contrário,substitua a porção de localhost com host_name:port.Para um servlet ou gateway ISAPI, substitua a parte localhost/ibmcognos/cgi-bin/cognos.cgi pelos valores para direcionamento do gateway.Por exemplo,http://host_name:port/ibmcognos/cgi-bin/cognosisapi.dll/wsrp/cps4/portlets/[package]?wsdl&b_action=cps.wsdl

v Altere a propriedade cps_auth_namespace para o namespace que você desejausar para autenticação.

288 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 301: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Capítulo 11. Implementar IBM Cognos em outro servidor deaplicativos

IBM Cognos Business Intelligence instala e usa WebSphere Application ServerLiberty Profile como o servidor de aplicativos. Mas é possível implementar IBMCognos BI em outro servidor de aplicativos suportado.

Os servidores de aplicativos que podem ser usados incluemv IBM WebSphere Application Serverv Oracle WebLogic Serverv Red Hat JBoss

Para IBM Cognos BI para Linux no System z, o IBM WebSphere ApplicationServer é suportado.

Para assegurar que seu produto funcione corretamente, aplique todas as correçõesde sistema operacional necessárias e use apenas as versões de outros softwares quesejam suportadas para um produto IBM Cognos.

Também é possível escolher executar o IBM Cognos Servlet Gateway em umservidor de aplicativos suportado em vez de usar um servidor da web. Quando seusa o gateway de servlet, seu ambiente não requer um servidor da web. Oservidor de aplicativos e o gateway de servlet substituem as funções que sãofornecidas pelo servidor da web e outros gateways IBM Cognos.

Criar uma Instância JVM SeparadaQuando possível, o IBM Cognos Business Intelligence deve ser instalado em umainstância do Java Virtual Machine (JVM) que é separada dos processos deadministração do servidor de aplicativos para isolar o IBM Cognos BI e as funçõesadministrativas do servidor de aplicativos.

Executar o IBM Cognos BI em uma instância JVM separada elimina potenciaisconflitos de recursos de sistema ou classe Java e assegura que o IBM Cognos BInão afete qualquer aplicativo de cliente existente.

Uma instância JVM isolada pode ser estabelecida criando um dos seguintes:v Uma instância de servidor separada no WebSphere Application Serverv Um servidor gerenciado separado no Oracle WebLogicv Uma instância de servidor separada para Red Hat JBoss.

Se estiver usando o IBM Cognos Servlet Gateway, ele deverá ser executado emuma instância separada do IBM Cognos BI.

Configurar Parâmetros JVM para DesempenhoPara melhorar o desempenho do IBM Cognos BI em seu servidor de aplicativos, épossível aplicar algumas ou todas as configurações Java virtual machine (JVM) aseguir.

© Copyright IBM Corp. 2005, 2014 289

Page 302: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Não é necessário alterar essas configurações se você estiver usando o servidor deaplicativos fornecido com IBM Cognos BI.

Por exemplo:v Inclua a opção -Xcompressedrefs se estiver usando um servidor de aplicativos

de 64 bits. Esta opção faz com que as referências de objeto sejam armazenadascomo uma representação de 32 bits, que reduz o tamanho do objeto de 64 bitspara que seja igual ao de um objeto de 32 bits.

v Inclua a opção -Xdump para controlar como os agentes de dump e os dumps sãousados. Por exemplo, inclua as opções a seguir:– -Xdump:heap+system:none– -Xdump:system:events=gpf+abort,range=1..2,request=

serial+compact+prepwalk– -Xdump:system:events=systhrow+throw,filter=java/lang/OutOfMemory*,

range=1..2,request=serial+compact+prepwalk

Verificar a Configuração de Componentes IBM CognosCertifique-se de fazer o seguinte antes da configuração dos componentes do IBMCognos para executar o servidor de aplicativos:v Os componentes do IBM Cognos estão instalados.v Antes de você iniciar o IBM Cognos Business Intelligence, o banco de dados

para o armazenamento de conteúdo deve ser configurado. Instale e configureclientes de banco de dados, se necessário, e, em seguida, teste a conectividadedo banco de dados.

v O servidor de aplicativos está instalado e operacional em cada computador emque os componentes do IBM Cognos estão instalados.Para obter mais informações sobre a instalação, consulte a documentação doservidor de aplicativos.

v A localização da instalação totalmente qualificada de todas as fontes éespecificada em todos os computadores de Application Tier Component.Especifique esse local no IBM Cognos Configuration. Por padrão, a localizaçãoda instalação não utiliza um caminho totalmente qualificado.

v A conta do usuário do servidor de aplicativos em permissões de acesso totalpara a instalação do IBM Cognos.

Dica: Crie um novo grupo de sistema operacional UNIX ou Linux denominadocognos. Esse grupo deve conter o usuário que inicia o servidor de aplicativos e ousuário proprietário dos arquivos do IBM Cognos. Altere a propriedade dogrupo dos arquivos IBM Cognos para o grupo cognos e altere as permissões dearquivo para todos os arquivos IBM Cognos para GROUP READABLE/WRITABLE/EXECUTABLE. Para simplificar, também é possível usar a conta dousuário do servidor de aplicativos para instalar e executar componentes do IBMCognos.

Fazendo backup de informações existentes do IBM CognosDeve-se fazer backup de informações existentes do IBM Cognos se você estiveralterando seu Java.

Nota: Faça backup de informações do IBM Cognos dentro do ambiente de trabalhoantes de alterar seu Java.

290 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 303: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Antes de configurar componentes do IBM Cognos BI para execução em um novoJava, deve-se fazer backup dev Dados de armazenamento de conteúdo criando uma exportação de implantação.v Informações de configuração por meio de sua exportação. Qualquer dado

criptografado é descriptografado durante a exportação.v chaves criptográficas salvando-as em um local diferente. Novas chaves

criptográficas devem ser criadas usando o mesmo Java que o usado peloservidor de aplicativos. Como essas chaves só podem ser criadas se as chavesanteriores forem excluídas, é importante fazer backup das chaves anteriores.

Para garantir a segurança e a integridade dos dados do IBM Cognos, faça backupdo armazenamento de conteúdo, das informações de configuração e das chavescriptográficas em um diretório protegido contra acesso desautorizado ouimpróprio.

Dica: Para verificar se existe alguma chave criptográfica, consulte o diretórioc10_location/configuration. Chaves criptográficas existirão se o diretório incluiros seguintes subdiretórios: csk, encryptkeypair ou signkeypair.

Procedimento1. Se existirem dados no armazenamento de conteúdo, inicie o serviço do IBM

Cognos e exporte o armazenamento de conteúdo inteiro usando a ferramentade Implementação.Para obter informações adicionais, consulte o tópico sobre a criação de umaespecificação de implementação de exportação no IBM Cognos BusinessIntelligence: Guia de Administração e Segurança.

2. No IBM Cognos Configuration, no menu Arquivo, clique em Exportar como esalve as informações de configuração em um formato decriptografado. Aonomear um arquivo, use um nome como decrypted.xml.Exporte os dados para um diretório que esteja protegido contra acesso nãoautorizado ou indevido, pois as senhas são armazenadas como texto comum. Ésolicitado o reconhecimento de que a exportação é uma operação insegura.

3. Pare o serviço do IBM Cognos:v Se você usar o servidor de aplicativos fornecido com IBM Cognos BI, pare o

serviço do IBM Cognos e feche o IBM Cognos Configuration.v Se você usar um servidor de aplicativos além do fornecido com o IBM

Cognos BI, encerre o IBM Cognos BI em seu ambiente.4. Faça backup de quaisquer chaves criptográficas existentes salvando os arquivos

e diretórios apropriados em um local diferente que seja seguro.Os arquivos sãov c10_location/configuration/cogstartup.xml

v c10_location/configuration/caSerial

v c10_location/configuration/cogconfig.prefs

v c10_location/configuration/coglocale.xml

Os diretórios sãov c10_location/configuration/csk

v c10_location/configuration/encryptkeypair

v c10_location/configuration/signkeypair

5. Exclua os arquivos caSerial e cogconfig.prefs e os três diretórios: csk,encryptkeypair e signkeypair.

Capítulo 11. Implementar IBM Cognos em outro servidor de aplicativos 291

Page 304: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

6. Substitua o arquivo c10_location/configuration/cogstartup.xml pelo arquivoque contém os dados exportados do IBM Cognos Configuration (por exemplo,decrypted.xml).No diretório c10_location/configuration, o arquivo deve usar o nomecogstartup.xml.As informações neste arquivo são automaticamente criptografadas novamenteusando novas chaves criptográficas quando se salva a configuração no IBMCognos Configuration.

Configurar Variáveis de AmbienteVocê deve configurar variáveis de ambiente para identificar o local do ambiente daJava Virtual Machine (JVM) e o caminho da biblioteca.

É possível definir variáveis de ambiente utilizando qualquer um dos seguintesmétodos:v No sistema operacional Microsoft Windows, configure uma variável de usuário

ou sistema 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 deusuário que executará o servidor de aplicativos ou console administrativo.

v Em sistemas operacionais UNIX e Linux, configure uma variável de ambiente noperfil 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 de um servidor deaplicativos, consulte “Alterar o Script de Inicialização do Servidor de Aplicativos”na página 297.

Dica: A maioria das versões de servidor de aplicativos é fornecida com um scriptdestinado especificamente para a configuração de variáveis de ambiente. Porexemplo, algumas versões do IBM WebSphere são fornecidas comsetupCmdLine.bat ou setupCmdLine.sh. Esses scripts podem ser modificados paraconfigurar os valores apropriados para uso com componentes do IBM Cognos. Amaioria desses scripts definem a variável de ambiente JAVA_HOME por padrão.

Procedimento1. Defina a variável de ambiente JAVA_HOME para apontar ao JVM utilizado

pelo servidor de aplicativos.

Dica: Se o servidor de aplicativos for fornecido com uma JVM, a variável deambiente JAVA_HOME deverá ser configurada para fazer referência a ele.O IBM Cognos Configuration usa essa variável para criar chaves de criptografiapara componentes do IBM Cognos que são compatíveis com a JVM usada peloservidor de aplicativos.Por exemplo, para WebLogic sob Windows, a JVM usada pelo servidor deaplicativos é especificada como:drive:/WebLogic_location/jdkversion

2. Anexe c10_location/bin à variável de ambiente apropriada a partir da tabela aseguir.

Tabela 60. Variáveis de Ambiente do Servidor de Aplicativos

Sistema operacional Variável do ambiente

Windows PATH

292 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 305: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Tabela 60. Variáveis de Ambiente do Servidor de Aplicativos (continuação)

Sistema operacional Variável do ambiente

AIX LIBPATH

Solaris e Linux LD_LIBRARY_PATH

HP-UX SHLIB_PATH

A variável de ambiente do caminho da biblioteca é usada para localizar osarquivos de biblioteca do IBM Cognos.

Nota: Certifique-se de que os arquivos de biblioteca de 32 bits ou 64 bitsestejam configurados em suas variáveis de ambiente. Para uma versão de 64bits do IBM Cognos BI, os arquivos de biblioteca de 64 bits deverão ser listadosprimeiro. Para uma versão de 32 bits, os arquivos de biblioteca de 32 bitsdevem ser listados primeiro.

Dica: Para instalar diversas instâncias do IBM Cognos Business Intelligence emum único servidor, configure a variável PATH, LIBPATH, LD_LIBRARY_PATHou SHLIB_PATH no escopo da instância do servidor de aplicativos, e não comouma variável global, para garantir que cada instância tenha um valor exclusivo.

Ajustando o Valor de Tempo Limite de Conexão Padrão para IBMCognos Business Intelligence

A configuração padrão para o valor de tempo limite de conexão usado no IBMCognos Business Intelligence é 25 segundos. Alguns servidores de aplicativo, comoIBM WebSphere, usam um valor menor. Para evitar conflitos entre as configuraçõesde tempo limite de conexão, altere o valor de tempo limite de conexão no IBMCognos BI. O valor deve ser menor que a configuração definida no servidor deaplicativos.

Procedimento1. Abra o arquivo c10_location/configuration/BIBusTK_Config.xml em um editor

de texto.2. Localize a seguinte sequência:

<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 de conexão padrão de30 segundos. Calcule 90% dos 30 segundos, que é 27 segundos. Altere asequência para:<BIBUSTK_CONNECTION_TIMEOUT>27000</BIBUSTK_CONNECTION_TIMEOUT>

4. Salve o arquivo.5. Repita essas etapas em cada local em que instalou o IBM Cognos BI.

Configurando componentes do IBM Cognos para execução dentro doservidor de aplicativos

O IBM Cognos Business Intelligence deve ser configurado com informações deconfiguração do servidor de aplicativos, e a configuração deve ser salva para criarnovas chaves criptográficas. O IBM Cognos Configuration usa a Java VirtualMachine (JVM) que é definida pela variável de ambiente JAVA_HOME.

Capítulo 11. Implementar IBM Cognos em outro servidor de aplicativos 293

Page 306: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Você deve configurar a variável de ambiente JAVA_HOME para o JVM fornecidoou usado pelo servidor de aplicativos antes de executar o IBM CognosConfiguration.

Se você estiver usando WebSphere Application Server, é possível usar o assistentepara construção de aplicativo para criar o aplicativo, bem como para instalá-lo.Não é preciso usar o console administrativo do WebSphere para configurarpropriedades ou instalar o aplicativo. Para obter mais informações, consulte “Use oAssistente para Construção de Aplicativo para construir e instalar o IBM Cognosno IBM WebSphere Application Server” na página 295.

Procedimento1. Pare o serviço do IBM Cognos se estiver em execução.2. Inicie o IBM Cognos Configuration:

Se houver chaves de criptografia incompatíveis existentes, será solicitado quevocê gere automaticamente novas chaves agora.

Dica: Certifique-se de que as chaves existentes tenham um backup em um localseguro antes de continuar. Não há ação de desfazer disponível após a geraçãode novas chaves.

3. Use o assistente para construção de aplicativo para criar o arquivo de aplicativoque é implementado no servidor de aplicativos. Para iniciar o assistente paraconstrução de aplicativo a partir do IBM Cognos Configuration, em Ações,clique em Construir Arquivos de Aplicativo. Use o assistente para selecionar otipo de aplicativo para construir e a raiz de contexto usada para acessar oaplicativo.Deve-se construir o arquivo de aplicativo no mesmo computador em que seestá implementando o arquivo.O valor da raiz de contexto inserido no assistente deve ser o mesmo que oinserido na guia Ambiente e usado para implementação no servidor deaplicativos. Para o IBM Cognos BI, a raiz de contexto e o nome do diretório doaplicativo padrão é p2pd, que pode ser usado na maioria dos casos. Para o IBMCognos Servlet Gateway, a raiz de contexto e o nome do diretório do aplicativopadrão é ServletGateway. Outros valores de implementação do aplicativopadrão, como o nome do aplicativo, podem ser alterados para melhor seadequar ao seu ambiente.

Dica: Não é necessário reconstruir ou reimplementar o archive quando vocêfaz mudanças na configuração, pois as informações de configuração sãoarmazenadas externamente ao aplicativo.Para WebLogic e JBoss, é possível usar o assistente Construção de Aplicativo noIBM Cognos Configuration para construir o aplicativo em um diretórioexpandido.Por exemplo, para WebLogic, você coloca o aplicativo em C:\bea\user_projects\domains\apps\p2pd, em que p2pd é o nome do aplicativo.Quando se implementa o aplicativo a partir do WebLogic AdministrationConsole, o diretório p2pd é selecionado.Para JBoss, se você usar a opção Expandir arquivos para uma pasta, deve-seincluir a extensão .war no nome da pasta na qual o assistente cria o aplicativop2pd. Quando o assistente solicitar o local da pasta, acesseJBoss_location/server/instance_name/deploy e crie uma pasta denominadap2pd.war.

294 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 307: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Para obter informações sobre qual tipo de arquivo de aplicativo, WAR, EAR oudiretório expandido é suportado em seu ambiente, consulte a documentação doservidor de aplicativos.

4. Na janela Explorer do IBM Cognos Configuration, expanda Ambiente e altereas seguintes propriedades para usar o número da porta e os nomes do host ouendereço IP do servidor onde o componente IBM Cognos BI e um servidor deaplicativos estão instalados.v Todos os URIs para o dispatcher, incluindo

– URIs de dispatchers do gateway

– URI do dispatcher externo

– URI do dispatcher interno

– URI do dispatcher para aplicativos externos

v URI do Gateway

v URIs do Content Manager

O servidor de aplicativos deve ser configurado para atender no nome do hostou endereço IP inserido no URI. Para obter mais informações, consulte adocumentação do servidor de aplicativos.Se mudar a raiz do contexto para um valor diferente do padrão de p2pd, mudetambém a parte da raiz do contexto do URI.

5. Em Ambiente > Serviços do IBM Cognos, clique com o botão direito domouse em IBM Cognos e em Excluir.A entrada para o serviço do IBM Cognos é usada para configurar definições deambiente para usar o WebSphere Application Server Liberty Profile padrão. Aentrada não é obrigatória durante o uso de um servidor de aplicativosdiferente.

6. Conclua as outras mudanças na configuração comov Especificar propriedades para o banco de dados do Content Managerv Inserir IDs de usuário e senhasSe você usou as configurações padrão para a instalação do IBM Cognos, talvezseja necessário fazer apenas pequenas mudanças nas definições de configuraçãopadrão.

7. Salve a configuração.Novas chaves criptográficas são criadas utilizando o JVM que é definido pelavariável JAVA_HOME.

8. Feche o IBM Cognos Configuration.

Use o Assistente para Construção de Aplicativo para construire instalar o IBM Cognos no IBM WebSphere ApplicationServer

Use o Assistente de Construção de Aplicativo para construir, instalar e configurar oIBM Cognos Application no IBM WebSphere Application Server.

É possível executar todas as ações em sequência ou é possível executá-lasindividualmente. A tarefa a seguir descreve o processo em sequência.

Antes de Iniciar

O IBM WebSphere Application Server deve ser instalado no mesmo computadorem que o IBM Cognos BI foi instalado.

Capítulo 11. Implementar IBM Cognos em outro servidor de aplicativos 295

Page 308: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Você deve configurar a variável de ambiente JAVA_HOME para a JVM fornecida ouusada pelo servidor de aplicativos antes de executar o IBM Cognos Configuration.

O IBM WebSphere Application Server não precisa estar em execução para usar oAssistente para Construção de Aplicativo para instalar o IBM Cognos BI.

Procedimento1. Inicie o IBM Cognos Configuration.2. Na janela Explorer, sob Serviços do IBM Cognos, clique com o botão direito

do mouse em IBM Cognos e clique em Excluir.3. Clique com o botão direito do mouse em IBM Cognos Service, clique em

Novo Recurso > Configuração.4. Insira um Nome e selecione WebSphere na caixa Tipo.5. Clique em OK.6. Na caixa Local do WebSphere Application Server, clique no ícone de

navegação e selecione o local da instalação do IBM Websphere ApplicationServer.

7. Na caixa Perfil, selecione o nome do perfil no qual deseja que o IBM CognosBI seja instalado.É possível inserir um novo nome na caixa Perfil. O IBM CognosConfiguration criará um novo perfil usando o nome inserido.Se uma instalação anterior do IBM Cognos existir no perfil selecionado, oAssistente para Construção de Aplicativo permitirá desinstalar a instalaçãoanterior antes de instalar a nova.

8. Na caixa Instância do Servidor, selecione a instância do servidor para seuperfil do IBM WebSphere.

9. Clique com o botão direito do mouse no nome fornecido para suaconfiguração do IBM WebSphere e clique em Construir.O Assistente para Construção de Aplicativo é exibido. Siga as instruções noassistente e clique no ícone de Ajuda para obter informações adicionais paracada página. O assistente permitirá que você construa o aplicativo e instale-ono perfil do IBM WebSphere.O aplicativo será configurado para executar. Por exemplo, os valores docaminho serão incluídos e as configurações JVM corretas serão aplicadas.Na página Configurar o IBM Cognos para WebSphere, certifique-se deinserir o número da porta correto para o perfil do IBM WebSphere. Os valoressão fornecidos na página. Estes valores serão aplicados nas configurações doIBM Cognos Configuration Environment.

Dica: Para testar sua configuração do IBM WebSphere, clique com o botãodireito do mouse no nome fornecido para a configuração do IBM WebSphere eclique em Testar. O diálogo mostrará quaisquer erros de configuração. Cliqueno ícone Detalhes para visualizar as mensagens.

10. Reinicie seu perfil do IBM WebSphere.É possível desinstalar seu aplicativo IBM Cognos do IBM WebSphere do IBMCognos Configuration. Clique com o botão direito do mouse no nomefornecido para sua configuração do IBM WebSphere e clique em Desinstalar.

296 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 309: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Identificando o JDK para WebLogic 9 no AIXO WebLogic 9 requer Java Development Kit (JDK) 1.5. Se usar WebLogic Server 9no AIX, você deverá atualizar as opções Java no arquivo commEnv.sh paraespecificar o identificador exclusivo (UID) da versão serial apropriada. Se você nãofizer essa atualização, ocorrerá uma incompatibilidade de UID da versão serialquando você usar o WebLogic Server 9 com o IBM Java 5.

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

Alterar o Script de Inicialização do Servidor de AplicativosAlguns servidores de aplicativos têm requisitos específicos que você deve atenderantes de poder executar o IBM Cognos Business Intelligence. Dependendo doservidor de aplicativos, pode ser necessário definir variáveis de ambiente, copiararquivos e adicionar ou mudar códigos em arquivos.

Se estiver usando o Red Hat JBoss ou o Oracle WebLogic Server, você deverá fazermudanças no script de inicialização do servidor de aplicativos.

Se estiver usando o WebSphere Application Server, não é necessário alterar o scriptde inicialização, a menos que queira incluir as mudanças na variável de ambiente.Se você realmente efetuar as mudanças, use o console de administração.

Alterando o script de inicialização do servidor de aplicativospara WebLogic

Se estiver usando o Servidor Oracle WebLogic, o script de inicialização deverá sermodificado para especificar configurações da Java virtual machine (JVM). Para oWebLogic 9, use o console administrativo para modificar o ambiente WebLogic.

Procedimento1. Crie um domínio WebLogic Server (WLS) para o IBM Cognos BI.

Se estiver configurando o IBM Cognos Servlet Gateway, crie um segundodomínio para esse aplicativo.Para obter informações sobre a criação de domínios, consulte a documentaçãodo WebLogic.

2. Acesse o diretório WebLogic9_location/user_projects/domains/domain_name/bin e abra o script de inicialização do servidor de aplicativo em um editor.O nome do script de inicialização pode variar dependendo do tipo deinstalação do WebLogic executado. Por exemplo, em uma instalação doservidor gerenciado, o nome do script de inicialização éstartManagedWebLogic.sh ou startManagedWebLogic.cmd.

3. Para versões não IBM JRE, selecione o modo de execução da JVM e altere aconfiguração padrão de JAVA_VM= para JAVA_VM=-server.

4. Modifique JAVA_OPTIONS para configurar o analisador XML configurado paraIBM Cognos BI. Adicione a terceira linha, como mostra o exemplo a seguir:

Capítulo 11. Implementar IBM Cognos em outro servidor de aplicativos 297

Page 310: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

JAVA_OPTIONS=-Dweblogic.security.SSL.trustedCAKeyStore=%WL_HOME%\server\lib\cacerts

5. Configure o mínimo e o máximo de memória usados pela JVM.Geralmente, a memória é configurada usando dois parâmetros da JVM: -Xms e-Xmx. Como valores iniciais, são sugeridos no mínimo 256 MB e no máximo768 MB. É possível alterar esses valores para melhor se adequarem aoambiente.O parâmetro MaxPermSize também deve ser configurado. Eis um exemplo:-XX:MaxPermSize=128m

Para obter informações sobre os parâmetros JVM, consulte a documentação doJVM ou do servidor do aplicativo.

6. Assegure que o modo de produção esteja ativado alterando o PRODUCTION_MODE=para PRODUCTION_MODE=true.

7. Salve e feche o arquivo.

Alterar o Script de Inicialização do Servidor de Aplicativospara JBoss

Se estiver usando Red Hat JBoss, o script de inicialização deverá ser modificadopara especificar configurações de Java Virtual Machine (JVM). Você também deveespecificar um argumento log4j.

Para Red Hat JBoss, crie uma cópia da instância do servidor padrão para quepossa utilizar a instância de servidor padrão original como backup. Dê à cópia umnome que não utilize espaços, como cognos.

Procedimento1. Acesse o diretório JBoss_location/bin e abra o run.bat ou run.sh em um

editor.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 valoresiniciais. É possível alterar esses valores para melhor se adequarem ao ambiente.Para obter informações sobre os parâmetros, consulte a documentação do JVMou do servidor do aplicativo.

3. Para HP Itanium 64 bits, inclua também os seguintes parâmetros:-Djava.library.path=/install_location/bin64-d64-Xss4m

Se SSL estiver ativado, aumente a pilha de encadeamentos de Java para 12 MB.Por exemplo, -Xss12m.

4. Salve e feche o arquivo.

Configurar Propriedades do Servidor de Aplicativos e InstalarComponentes IBM Cognos

Você deve configurar as propriedades do servidor de aplicativos e instalar oscomponentes IBM Cognos em seu servidor de aplicativos.

298 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 311: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Instalar o IBM Cognos no WebSphereSiga estas etapas para instalar no WebSphere.

Procedimento1. Inicie o WebSphere Application Server e depois acesse o Console

Administrativo do WebSphere.2. Crie uma nova instância do servidor na qual o aplicativo IBM Cognos Business

Intelligence será implementado, caso essa opção esteja disponível na versão queestá sendo executada.Se estiver implementando o IBM Cognos Servlet Gateway, crie uma segundainstância do servidor separada.

3. Instale um novo Enterprise Application usando o arquivo de aplicativo que foiconstruído pelo IBM Cognos Configuration.Para IBM Cognos BI, a raiz de contexto padrão é p2pd, que pode ser usada namaioria dos casos. Para o IBM Cognos Servlet Gateway, a raiz de contextopadrão é ServletGateway. Outros valores de implantação do aplicativo, taiscomo o nome do aplicativo, podem ser alterados para melhor se adequarem aoambiente do sistema. O valor da raiz de contexto usado para implementar oaplicativo deve ser o mesmo que o valor da raiz de contexto inserido no IBMCognos Configuration durante a execução do assistente Construção deAplicativo.

4. Defina a memória utilizada pelo JVM.Geralmente a memória é configurada pela inclusão ou mudança dos tamanhosde heap Java inicial e máximo. Para obter informações sobre os parâmetros,consulte a documentação do JVM ou do servidor do aplicativo.

Dica: Como valores iniciais, são sugeridos no mínimo 256 MB e no máximo768 MB. É possível alterar esses valores para melhor se adequarem aoambiente.

5. Configure outras opções da JVM, se necessário.O processo da JVM pode ser ajustado, especificando várias opções comoargumentos para o processo Java. Para obter informações sobre os parâmetrospossíveis, consulte a documentação da JVM.

6. Nas propriedades do servidor, adicione uma variável de ambiente, como listadona tabela a seguir, que se refira ao diretório installation_location/bin.

Tabela 61. Variáveis de Ambiente do Sistema Operacional

Sistema operacional Variável do ambiente

Microsoft Windows PATH

AIX LIBPATH

Solaris LD_LIBRARY_PATH

HP-UX SHLIB_PATH

Certifique-se de usar os arquivos de biblioteca apropriados para a versão doservidor IBM Cognos BI instalada. O IBM Cognos BI requer arquivos debiblioteca de 32 bits ao ser executado em um servidor de aplicativos de 32 bitse requer arquivos de biblioteca de 64 bits ao ser executado em um servidor deaplicativos de 64 bits. Dependendo da versão instalada do DB2, talvez seja

Capítulo 11. Implementar IBM Cognos em outro servidor de aplicativos 299

Page 312: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

necessário alterar os arquivos de biblioteca ou alterar a ordem na qual osarquivos de biblioteca são listados, para que o servidor do IBM Cognos BIpossa localizar os arquivos corretos. Independentemente da versão, os arquivosde biblioteca necessários devem ser listados primeiro.

7. Pare e reinicie a instância do servidor de aplicativos WebSphere usada para oscomponentes do IBM Cognos.

8. Verifique se os componentes do IBM Cognos estão em execução procurando aseguinte mensagem no console administrativo do servidor de aplicativos ou noarquivo de log do servidor de aplicativos:O dispatcher está pronto para processar solicitações.

Instalando o IBM Cognos no WebLogicSiga estas etapas para instalar no WebLogic.

Procedimento1. Se tiver usado a opção do diretório expandido ao construir o aplicativo no

IBM Cognos Configuration, acesse a etapa 2. Se tiver criado o arquivo WAR,expanda o aplicativo manualmente:v 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 IBM Cognos BI, nome do diretório do aplicativo e da raiz de contextopadrão é p2pd, que pode ser usado na maioria dos casos. Para o IBMCognos Servlet Gateway, a raiz de contexto padrão é ServletGateway.Outros valores de implementação do aplicativo padrão, como o nome doaplicativo, podem ser alterados para melhor se adequar ao seu ambiente. Ovalor da raiz de contexto que é usado para implementar o aplicativo deveser o mesmo que o valor de raiz de contexto inserido no IBM CognosConfiguration.

v No diretório criado, extraia o arquivo WAR de aplicativo para a instalaçãodo WebLogic usando o comando a seguir de um prompt de comandos: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 Servidor de Administração WebLogic e o Servidor GerenciadoWebLogic associado ao domínio do IBM Cognos.O Gerenciador de Nó deve ser iniciado antes de poder iniciar e pararinstâncias Servidor Gerenciado usando o Console de Administração

3. Você deve modificar o ambiente no Console de Administração WebLogic antesde implementar o IBM Cognos BI. Efetue logon no Console de Administraçãoe acesse a instância do Servidor Gerenciado que hospeda o aplicativo do IBMCognos BI. Selecione a guia Início do Servidor para a instância do ManagedServer e ative o modo de edição.

4. Na caixa Java Home, digite o caminho para o JVM. Esse valor deve ser omesmo que o usado para o IBM Cognos BI. Utilize o JVM que está incluídona instalação do WebLogic.

5. Configure os argumentos Java.Os argumentos Java incluem todas as configurações da JVM, comoconfigurações de memória especificadas usando dois parâmetros de JVM: -Xmse -Xmx.

300 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 313: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

O parâmetro MaxPermSize também deve ser definido. Você também deveconfigurar o analisador XML apropriado para o IBM Cognos BI.Por exemplo: na caixa Argumentos, digite-Xms768m -Xmx768m -XX:MaxPermSize=128m

Se usar WebLogic no AIX, você também deverá especificar o UID da versãoserial apropriada nos argumentos Java. Se não fizer esta atualização, umaincompatibilidade de UID de versão serial ocorrerá ao usar o WebLogic comJava 5, porque o WebLogic requer JDK 1.5.Por exemplo: na caixa Argumentos, digite-Xms768m -Xmx768m -XX:MaxPermSize=128m-Dcom.sun.xml.namespace.QName.useCompatibleSerialVersionUID=1.0

Para obter informações sobre os parâmetros JVM, consulte a documentação doJVM ou do servidor do aplicativo.

6. Salve e aplique as mudanças.É possível agora iniciar e parar a instância do Managed Server na guiaControle.

7. Inicie a instância do servidor. A instância do servidor deve ser iniciada antesde implementar o IBM Cognos BI ou o IBM Cognos Servlet Gateway.

8. Implemente o aplicativo IBM Cognos BI ou IBM Cognos Servlet Gateway noconsole WebLogic usando um novo aplicativo da web como a seguir:v Defina o nome do aplicativo.

Por exemplo, ibmcognos.v Defina o caminho para o diretório onde os arquivos de aplicativo

expandidos estão localizados.

Nota: O IBM Cognos BI usa um utilitário de carga customizado. Você deveusar a opção do diretório expandido ao implementar.

v Selecione a instância de servidor de destino.Use o Administration Server apenas para tarefas de administração doWebLogic e implemente o aplicativo IBM Cognos BI em sua própriainstância do Managed Server.

9. Após a implementação ser concluída, configure o período de recarregamentopara o aplicativo da web como -1 para melhorar o desempenho. Essaconfiguração evita que o WebLogic verifique arquivos de aplicativoatualizados usados somente em um ambiente de desenvolvimento.

10. Pare e reinicie o Servidor Gerenciado WebLogic associado ao domínio do IBMCognos para ativar as mudanças.

11. Verifique se os componentes do IBM Cognos estão em execução procurando aseguinte mensagem na janela do console do servidor de aplicativos ou noarquivo de log do servidor de aplicativos:O dispatcher está pronto para processar solicitações.

Instalando o IBM Cognos no SAP NetWeaverSiga estas etapas para instalar o IBM Cognos Business Intelligence no SAPNetWeaver.

Procedimento1. Abra a ferramenta de configuração digitando

Capítulo 11. Implementar IBM Cognos em outro servidor de aplicativos 301

Page 314: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

drive:\usr\sap\sapid\JCxx\j2ee\configtool\configtool.bat Por exemplo, seo ID do SAP for J2E e a instalação estiver na unidade D, digiteD:\usr\sap\J2E\JC00\j2ee\configtool\configtool.bat.

2. Quando o uso das definições de DB padrão for solicitado, clique em Sim.3. Em cluster-data, instance_IDxxxxxxx, Dispatcher_IDxxxxxxx, services, em que

xxxxxxx é o número de ID para sua instalação, destaque http.4. Em Propriedades Globais, destaque KeepAliveTimeout e digite um número

mais alto e, em seguida, clique em Definir.

Dica: Configure o número inicialKeepAliveTimeout para pelo menos 60.5. Em cluster-data, instance_IDxxxxxxx, destaque Server_IDxxxxxxx.6. Configure a memória usada pela JVM.

Siga as recomendações no SAP. Para obter mais informações, consulte SAPNote 723909 no SAP Support Portal.Se seu computador tiver menos de 1,5 GB de memória, é possível terproblemas ao executar o SAP NetWeaver. Um valor mínimo de 768 MB ésugerido.

7. Para ambientes IBM Cognos BI que usam Report Studio, em cluster-data,instance_IDxxxxxxx, destaque Server_IDxxxxxxx, services e destaque http.

8. Em Propriedades Globais, destaque CompressedOthers, digite false e cliqueem Configurar.

9. Salve as mudanças.10. Reinicie o servidor utilizando o console de gerenciamento SAP ou reiniciando

os serviços em Serviços.11. Utilize a ferramenta Implantar para criar um novo projeto.12. Carregue o arquivo de aplicativo IBM Cognos que criou no IBM Cognos

Configuration. Por padrão, o arquivo é chamado p2pd.ear para o IBM CognosBI e ServletGateway.ear para o IBM Cognos Servlet Gateway.

13. Utilizando a ferramenta Implantar, conecte-se à ferramenta Administração eimplante o arquivo do aplicativo.

14. Quando for solicitado que inicie o aplicativo, clique em Sim.15. Salve o projeto.

Instalar o IBM Cognos no JBossSiga essas etapas para instalar no JBoss.

Procedimento1. Se não quiser usar a porta padrão de 8080, abra o arquivo JBoss_location/

server/instance_name/deploy/jbossweb-tomcat55.sar/server.xml.2. No arquivo server.xml, altere o número da porta padrão de 8080 usado pela

instância do servidor para a porta especificada no IBM Cognos Configuration.Por exemplo,<Service name="jboss.web"className="org.jboss.web.tomcat.tc5.StandardService"><!-- A HTTP/1.1 Connector on port 8080 --><Connector port="8080" address="${jboss.bind.address}"maxThreads="250" strategy="ms" maxHttpHeaderSize="8192"emptySessionPath="true"enableLookups="false" redirectPort="8443" acceptCount="100"connectionTimeout="20000" disableUploadTimeout="true"/>

3. Salve e feche o arquivo server.xml.

302 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 315: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

4. Coloque o aplicativo p2pd na pasta JBoss_location/server/instance_name/deployse 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 pode causar erros quando você acessar seuaplicativo IBM Cognos BI. Para evitá-los, adicione o atributo -b ao iniciar oservidor. Por exemplo, use um comando comorun.bat -c <server_name> -b #.#.#.#

Em um ambiente de teste, para executar jBoss 5.0 com o comportamentolegado, é possível usar -b 0.0.0.0, que é vinculado a todas as interfacesdisponíveis.

Importante: Para um ambiente de produção, certifique-se de proteger oservidor de aplicativos corretamente e de não usar -b 0.0.0.0 como endereço deligação. Para obter mais informações, consulte a documentação do jBoss.O aplicativo p2pd é automaticamente detectado e iniciado pelo servidor deaplicativos.

6. Verifique se os componentes do IBM Cognos estão em execução procurando aseguinte mensagem na janela do console do servidor de aplicativos ou noarquivo de log do servidor de aplicativos:The dispatcher is ready to process requests.

Ativando o Secure Socket LayerSe usar Secure Socket Layer (SSL) para componentes do IBM Cognos, você tambémdeverá ativar SSL no ambiente de servidor de aplicativos. Em seguida, identifiqueo certificado do servidor SSL para componentes do Cognos.

Antes de Iniciar

Nos sistemas operacionais UNIX ou Linux, certifique-se de que você configurouuma variável de ambiente JAVA_HOME antes de utilizar oThirdPartyCertificateTool.

Nos sistemas operacionais Microsoft Windows, execute a ferramenta com-java:local para usar o JRE fornecido com a instalação. Por exemplo,ThirdPartyCertificateTool.bat -java:local -T -i -r ...

Procedimento1. Configure o servidor de aplicativos para utilizar o SSL.

Um certificado do servidor SSL é gerado por 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 aplicativospara utilizar SSL, consulte a documentação do servidor de aplicativos. Paraobter informações sobre o uso de certificados de CA para seu servidor deaplicativos, consulte a documentação da CA.

2. Copie o certificado CA para o diretório c10_location/bin e renomeie o arquivopara ca.cer.Esse arquivo deve ter o formato X.509 codificado em Base 64.

3. No diretório c10_location/bin:v No sistema operacional Microsoft Windows, digite:

Capítulo 11. Implementar IBM Cognos em outro servidor de aplicativos 303

Page 316: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

ThirdPartyCertificateTool.bat -T -i -r ca.cer -k ../configuration/signkeypair/jCAKeystore -p NoPassWordSet

v Em sistemas operacionais UNIX ou Linux, digite:ThirdPartyCertificateTool.sh -T -i -r ca.cer -k ../configuration/signkeypair/jCAKeystore -p NoPassWordSet

Restrição: Certifique-se de que o usuário que executa o script tenha acessode leitura ao diretório no qual o certificado está armazenado e acesso deleitura ao arquivo de certificado. Do contrário, você poderá ver um errosemelhante à seguinte mensagem de erro: Exceção no erro "principal" doencadeamento java.lang.NullPointerException ao importar o certificado.

Você deve digitar jCAKeystore como o nome do keystore da CA.

Configurando Comunicação da WebPara a maioria dos tipos de servidores de aplicativo suportados, use um servidorda Web e um gateway IBM Cognos para comunicação da web.

Para obter informações sobre como configurar o servidor da web, consulte“Configurando o Servidor da Web” na página 91.

Para obter informações sobre como configurar o plug-in do servidor da webWebSphere, consulte Central do Cliente IBM Cognos (http://www.ibm.com/software/data/cognos/customercenter/).

Se você estiver usando o SAP NetWeaver no Microsoft Windows e não estiverusando um servidor da web e um gateway IBM Cognos para comunicação da web,siga as etapas para configurar um diretório virtual.

Configurar Diretório Virtual para SAP NetWeaverSe estiver usando o SAP NetWeaver e não estiver usando um Servidor da Web eum gateway IBM Cognos para comunicação da web, você deve criar um diretóriovirtual, também conhecido como um alias da web.

O diretório virtual é necessário para permitir que o conteúdo estático (páginashtml, imagens, entre outros) seja carregado. Ao construir o arquivo de aplicativoIBM Cognos, selecione a opção para incluir os arquivos estáticos a partir da pastawebcontent. Crie um diretório virtual que use o valor de raiz de contexto como umnome (por padrão, p2pd para IBM Cognos Business Intelligence ou ServletGatewaypara IBM Cognos Servlet Gateway). Assegure-se de que o diretório virtual apontapara a pasta c10_location/webcontent.

Procedimento

Crie o diretório virtual listado na tabela a seguir:

Tabela 62. Diretórios Virtuais para SAP NetWeaver

Alias Localização Permissão

context_root (por exemplo,p2pd)

c10_location/webcontent Leitura

304 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 317: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Cancelando o registro de dispatchers que foram configurados para oservidor de aplicativos padrão

Se você estiver instalando IBM Cognos BI em um servidor de aplicativos após játer iniciado o produto com o servidor de aplicativos padrão, os dispatchers serãoregistrados no armazenamento de conteúdo. Deve-se cancelar o registro de todosos dispatchers que foram registrados anteriormente para a configuração padrão.

Os dispatchers são removidos usando IBM Cognos Administration.

Procedimento1. Abra o IBM Cognos Connection conectando-se ao portal do IBM Cognos

Business Intelligence e clicando em IBM Cognos Content na páginaBoas-vindas.

2. Clique em Ativar > IBM Cognos Administration.3. Na guia Configuração, clique em Dispatchers e Serviços.4. Para o dispatcher 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.

Upgrade para IBM Cognos BI em um Ambiente de Servidor deAplicativos

Se estiver atualizando de um release suportado para o IBM Cognos BusinessIntelligence, execute as seguintes etapas.

Procedimento1. Faça backup das informações IBM Cognos existentes.2. Use as ferramentas administrativas para seu servidor de aplicativos e remova a

implementação do aplicativo IBM Cognos existente.Para obter informações sobre como remover aplicativos, consulte adocumentação do servidor de aplicativos.Se o diretório no qual o aplicativo IBM Cognos existente foi originalmenteimplementado não for removido durante o processo de remoção deimplementação, exclua o diretório.Além disso, remova os arquivos IBM Cognos .jar que estão em cache noambiente de servidor de aplicativos.

3. Desinstale a versão existente.4. Instale a nova versão de 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:v “Configurando componentes do IBM Cognos para execução dentro do

servidor de aplicativos” na página 293v Configure propriedades do servidor de aplicativo e implemente o IBM

Cognos BI.6. Para ativar novos recursos após a atualização, salve a configuração no IBM

Cognos Configuration e reinicie os serviços.

Capítulo 11. Implementar IBM Cognos em outro servidor de aplicativos 305

Page 318: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

306 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 319: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Capítulo 12. Usando instalação e configuração não assistidas

Use uma instalação e uma configuração não assistidas para fazer o seguinte:v Instalar uma configuração idêntica em vários computadores da rede.v Automatizar o processo de instalação e configuração especificando opções e

definições para usuários.v Instalar e configurar componentes em um ambiente UNIX ou Linux que não tem

XWindows

Antes de configurar uma instalação e configuração autônomas, verifique se todasas exigências e os pré-requisitos do sistema sejam cumpridos e que todos os outrossoftwares necessários estejam instalados e configurados.

Também é possível configurar uma desinstalação autônoma.

Procedimento1. Configure um arquivo de especificação de transferência (.ats) para especificar

opções de instalação.2. Execute a ferramenta de instalação no modo silencioso.3. Utilize um arquivo de configuração pré-configurado de outro computador.4. Execute a ferramenta de configuração no modo silencioso.

Resultados

Após a conclusão dessas tarefas, certifique-se de que o diretório de instalação doIBM Cognos Business Intelligence em todos os computadores esteja protegidocontra acesso desautorizado ou inadequado. Em seguida, você estará pronto parausar o IBM Cognos BI.

Instalações Não AssistidasUse um arquivo de especificação de transferência para copiar os componentes doIBM Cognos BI para o seu computador sem que informações sejam solicitadas.

Cada vez que você instalar os componentes do IBM Cognos BI usando o assistentede instalação, as opções selecionadas são registradas em um arquivo deespecificação de transferência. Portanto, se você já tiver instalado componentes doIBM Cognos BI em um computador de amostra, é possível usar o arquivo deespecificação de transferência gerado como um modelo para instalações nãoassistidas em diferentes computadores.

Se você não usar o assistente de instalação para instalar os componentes, é possívelusar o arquivo de transferência padrão chamado response.ats. Você devemodificar o arquivo response.ats para seu ambiente antes que possa usá-lo parauma instalação não assistida.

Verifique se a instalação não assistida foi bem-sucedida analisando o status deretorno. Um valor igual a zero (0) indica êxito e todos os outros valores indicamque ocorreu um erro.

© Copyright IBM Corp. 2005, 2014 307

Page 320: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Usar um Arquivo de Resposta a partir de uma Instalação emOutro Computador

Use as seguintes etapas para duplicar uma instalação de um computador paraoutro sem que as informações sejam solicitadas.

Procedimento1. Use o assistente de instalação para instalar componentes do IBM Cognos BI

em um computador.2. Depois de concluída a instalação, acesso c10_location/instlog.3. Localize o arquivo de especificação de transferência (.ats) gerado durante a

instalação.O formato do nome do arquivo é ts-product_code-version-yyyymmdd_hhmm.ats.Onde product_code é listado conforme a tabela a seguir:

Tabela 63. Transferir Códigos do Produto do Arquivo de Especificação

Código_do_produto Produto

BISRVR IBM Cognos BI Server

CRNSRVR IBM Cognos BI Reporting Server

BIMODEL IBM Cognos Framework Manager

BISAMPLES Amostras

LP Supplementary Languages Documentation

4. Copie o arquivo de especificação de transferência gerado para o computadoronde planeja instalar IBM Cognos BI.

5. No computador onde planeja instalar o software, faça o seguinte:v Insira o disco de instalação do produto apropriado e copie os conteúdos do

disco em seu computador.v Copie os arquivos de instalação do produto transferidos por download em

seu computador.6. Abra o arquivo de especificação de transferência em um editor de texto.7. Nos diálogos do Contrato de Licença, altere a propriedade I Agree para y.

Essa ação significa que você está aceitando o contrato de licença. Para ler ostermos do contrato de licença, consulte os arquivos LA_language_code e deavisos em qualquer um destes locais:v No disco do produto no diretório de instalação raiz do sistema operacionalv no computador do qual foi copiado o arquivo de especificação de

transferência no diretório c10_location\license\produto

8. Salve o arquivo de especificação de transferência no diretório onde osarquivos de instalação foram copiados.

9. Em um comando ou em uma janela do terminal, acesse o diretório do sistemaoperacional onde os arquivos de instalação foram copiados.

10. Digite o seguinte comando:v No Windows, digite o seguinte, onde local é o diretório em que foi

copiado o arquivo nome do arquivo.ats:issetup -s local\nome do arquivo.ats

v No UNIX ou no Linux, digite:./issetup -s location/filename.ats

308 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 321: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

v No UNIX ou Linux onde você não tem XWindows, digite:./issetupnx -s local/nome do arquivo.ats

Resultados

Se um status de retorno diferente de zero (0) é apresentado, verifique os arquivosde registros para mensagens de erro. Erros são registrados no diretórioc10_location\instlog em um arquivo de log de erros do resumo. O formato donome do arquivo é tl-product_code-versão-yyyymmdd-hhmm_summary-error.txt.

Se ocorrerem erros antes de ocorrer inicialização suficiente, mensagens de log serãoenviadas para um arquivo de log no diretório Temp. O formato do nome doarquivo é tl-product_code-versão-yyyymmdd-hhmm.txt.

Depois de resolver todos os erros, é possível definir uma configuração nãoassistida.

Modificando um Arquivo de RespostaGere e modifique um arquivo de resposta para especificar e registrar suaspreferências de instalação. É possível modificar o modelo do arquivo de respostafornecido.

Procedimento1. No computador onde planeja instalar o software, faça o seguinte:

v Insira o disco de instalação do produto apropriado e copie os conteúdos dodisco em seu computador.

v Copie os arquivos de instalação do produto transferidos por download emseu computador.

2. Use um arquivo response.ats.v Para usar o arquivo de resposta fornecido com a instalação, acesse o diretório

do seu sistema operacional e localize o arquivo response.ats.v Em computadores UNIX, para gerar um arquivo response.ats, acesse o

diretório de seu sistema operacional e digite ./issetup -ats nome doarquivo

v Em computadores Windows, para gerar um arquivo response.ats, acesse odiretório de seu sistema operacional e digite issetup -ats nome do arquivo

3. Abra o arquivo response.ats em um editor de texto.Cada seção do arquivo corresponde a uma caixa de diálogo no assistente deinstalação.

4. Nos diálogos do Contrato de Licença, altere a propriedade I Agree para y.Essa ação significa que você está aceitando o contrato de licença. Para ler ostermos do contrato de licença, consulte os arquivos LA_language_code e deavisos em qualquer um destes locais:v No disco do produto no diretório de instalação raiz do sistema operacionalv no computador do qual foi copiado o arquivo de especificação de

transferência no diretório c10_location\license\produto

5. Digite o local de instalação em APPDIR=location.

Dica: Não deve haver espaço em nenhum lado do sinal de igual (=).6. Na seção [Component List], insira 1 para cada componente que deseja instalar.

Insira 0 se não deseja instalar o componente.

Capítulo 12. Usando instalação e configuração não assistidas 309

Page 322: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

7. Para uma instalação do Windows, para a propriedade APPFOLDER=, digite umnome de atalho para o menu Iniciar.

Dica: Para garantir que a pasta de atalho esteja visível para todos os usuários,digite 1 para a propriedade ALLUSERS_FLAG=.

8. Para as informações de instalação na seção [Install Conditions], insira 1 se acondição for verdadeira. Insira 0 se a condição for falsa.

9. Salve o arquivo response.ats em um diretório local depois de fazer asmudanças necessárias.

O que Fazer Depois

Quando estiver pronto para executar a instalação silenciosa, acesse o “Iniciandouma Instalação não Assistida”.

Iniciando uma Instalação não AssistidaÉ possível iniciar uma instalação não assistida e escolher exibir ou não asmensagens durante o processo de instalação.

Procedimento1. Acesse o diretório em que salvou o arquivo response.ats.2. No prompt de comandos, digite um dos seguintes comandos:

v No Windows, digite o seguinte, onde local é o diretório em que foi copiadoo arquivo nome do arquivo.ats:issetup -s local\nome do arquivo.ats

Para ignorar a exibição de mensagens na tela, é possível incluir a opção-nomsgboxes para o comando issetup. Por exemplo, para iniciar umainstalação silenciosa usando o arquivo response.ats padrão sem a exibiçãode nenhuma mensagem durante a instalação, digite: issetup -s-nomsgboxes.

v No UNIX ou no Linux, digite:./issetup -s location/filename.ats

v No UNIX ou no Linux nos quais não há o XWindows:./issetupnx -s local/nome do arquivo.ats

Nota: Em um ambiente UNIX ou Linux, para visualizar o status da instalaçãona tela, é possível incluir a opção -displayLog no comando issetupnx. Porexemplo, para iniciar uma instalação silenciosa usando o arquivo response.atspadrão e exibir o status, digite: ./issetup -s -displayLog.

Resultados

Se for apresentado um status de retorno diferente de 0 (zero), verifique a existênciade mensagens de erro nos arquivos de log. Erros são registrados no diretórioc10_location\instlog em um arquivo de log de erros do resumo. O formato donome do arquivo é tl-product_code-versão-yyyymmdd-hhmm_summary-error.txt.

Se ocorrerem erros antes de ocorrer inicialização suficiente, mensagens de log serãoenviadas para um arquivo de log no diretório Temp. O formato do nome doarquivo é tl-product_code-versão-yyyymmdd-hhmm.txt.

Depois de resolver todos os erros, é possível definir uma configuração nãoassistida.

310 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 323: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Usar uma Configuração Não AssistidaPara usar uma configuração não assistida, você deve exportar uma configuração apartir de uma instalação existente que possua os mesmos componentes IBMCognos BI instalados. É possível então executar o IBM Cognos Configuration nomodo silencioso.

A configuração exportada contém as propriedades dos componentes do IBMCognos BI instalados em um computador. Se você realizar mudanças nasdefinições de configurações globais, será necessário copiar também o arquivo deconfiguração global para o computador onde você planeja usar a configuração nãoassistida. A configuração global inclui configurações como código do idioma doconteúdo, do produto, moedas, fontes e cookies.

Para obter mais informações, consulte “Alteração de definições globais” na página263.

Antes de Iniciar

Certifique-se de que as definições de configuração no computador para ondeestiver exportando a configuração sejam apropriadas para uso em outrocomputador com os mesmos componentes instalados. Por exemplo, se você alteroua parte do nome do host da propriedade URI do Gateway de localhost para umendereço IP ou nome de computador, certifique-se de que esta configuração sejaapropriada para a configuração do novo computador.

Procedimento1. No IBM Cognos Configuration, no menu File, 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.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 para o diretório

c10_location/configuration no computador em que você planeja usar aconfiguração não assistida.

7. Renomeie o arquivo para cogstartup.xml.8. Se você alterou a configuração global no computador de origem, copie o

arquivo coglocale.xml para o diretório c10_location/configuration nocomputador onde planeja executar a configuração não assistida.

9. Acesse o diretório c10_location/bin ou c10_location/bin64.10. Digite o seguinte comando:

v No UNIX ou Linux, digite./cogconfig.sh -s

v No Windows, digitecogconfig.bat -s

Dica: Para visualizar as mensagens de log geradas durante uma configuraçãonão assistida, consulte o arquivo cogconfig_response.csv no diretórioc10_location/logs.

Capítulo 12. Usando instalação e configuração não assistidas 311

Page 324: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Verifique se a configuração não assistida foi bem-sucedida analisando o statusde retorno. Um valor igual a zero (0) indica êxito e todos os outros valoresindicam que ocorreu um erro.

Resultados

O IBM Cognos Configuration aplica as definições de configuração especificadas noarquivo cogstartup.xml, criptografa credenciais, gera certificados digitais e, seaplicável, inicia o serviço ou processo do IBM Cognos.

Use uma Desinstalação Não AssistidaUse uma desinstalação não assistida para automatizar uma remoção decomponentes em diversos computadores que possuem os mesmos componentes ouremovem os componentes em um ambiente UNIX ou Linux que não temWindows.

Procedimento1. Acesse o diretório c10_location/uninstall.2. Abra o arquivo chamado uninst.ini em um editor de texto.3. Na seção denominada [Package List], insira 1 para cada componente que

deseja instalar. Insira 0 se deseja deixar o componente instalado.Por padrão, todos os componentes instalados estão configurados para seremremovidos.Os pacotes listado na seção [Package List] são descritos na seguinte tabela:

Tabela 64. Pacotes na Lista de Pacotes

Código de pacote Produto

BISRVR IBM Cognos BI Server

CRNSRVR IBM Cognos BI Reporting Server

BIMODEL Framework Manager

BISAMPLES Amostras

LP Supplementary Languages Documentation

4. Salve e feche o arquivo.5. Na linha de comandos, acesse o diretório c10_location\uninstall.6. No prompt de comandos, digite o seguinte comando:

v No Windows, digiteuninst -u -s

v No UNIX ou Linux, digite./uninst -u -s

v No UNIX ou Linux sem XWindows, digite./uninstnx -u -s

312 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 325: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Capítulo 13. Manutenção do desempenho

Esta seção inclui tópicos sobre como usar o IBM Cognos Business Intelligence eoutras ferramentas e métricas para manter o desempenho do ambiente do IBMCognos Business Intelligence.

Métricas de desempenho do sistemaO IBM Cognos BI fornece métricas do sistema que podem ser usadas paramonitorar o funcionamento do sistema inteiro e de cada servidor, dispatcher eserviço. Também é possível definir limites para as pontuações das métricas. Algunsexemplos de métricas de desempenho do sistema são o número de sessões em seusistema, há quanto tempo o relatório está em uma fila, por quanto tempo uma JavaVirtual Machine (JVM) esteve em execução e o número de solicitações e processosno sistema.

As métricas de desempenho do sistema residem no ambiente Java, mas podem sermonitoradas no IBM Cognos Administration por meio do IBM Cognos Connection.Para obter informações adicionais sobre as métricas de desempenho do sistema demonitoramento, consulte IBM Cognos Business Intelligence: Guia de Administração eSegurança.

É possível fazer um instantâneo das métricas do sistema atual para poderacompanhar tendências ao longo do tempo ou rever detalhes sobre o estado dosistema em determinado momento. Para obter informações adicionais, consulte otópico sobre o arquivo dump de métrica no Guia de Resolução de Problemas do IBMCognos Business Intelligence.

Também é possível monitorar métricas do sistema externamente para o IBMCognos Administration usando Java Management Extensions (JMX), umatecnologia que fornece ferramentas para o gerenciamento e o monitoramento deaplicativos e redes orientadas a serviços.

Monitoramento das métricas do sistema externamenteÉ possível monitorar métricas do sistema fora do IBM Cognos Administrationusando Java Management Extensions (JMX) padrão de mercado. Primeiro,configure duas propriedades JMX no IBM Cognos Configuration para ativar oacesso seguro às métricas no ambiente Java. Em seguida, use uma ID e senha dousuário seguras para conectar-se às métricas por meio de uma ferramenta deconexão JMX.

Antes de Iniciar

Você deve instalar o Oracle Java SE Development Kit ou Java SoftwareDevelopment Kit da IBM antes de poder usar o recurso de monitoramento externo.

Procedimento1. No local em que o Content Manager está instalado, inicie o IBM Cognos

Configuration.2. Na janela Explorer, clique em Ambiente.

© Copyright IBM Corp. 2005, 2014 313

Page 326: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

3. Na janela Propriedades, em Configurações de dispatcher, clique em Porta JMXexterna.

4. Na coluna Valor, digite um número de porta disponível.5. Clique em Credencial JMX externa.6. Na coluna Valor, clique no ícone de edição, digite um ID do usuário e senha e,

em seguida, clique em OK.O ID do usuário e a senha garantem que apenas um usuário autorizado possase conectar aos dados de métrica do sistema no ambiente Java usando a portaespecificada na Porta JMX externa.

7. Salve as mudanças 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:v 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 uselocalhost, mesmo se estiver se conectando localmente.

v 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óriosSe alguns serviços do IBM Cognos BI não forem requeridos em seu 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 TierComponents. Quando o serviço de apresentação é desativado, o desempenho dosApplication Tier Components melhora.

Nota:

v O serviço de Apresentação deve permanecer ativado em pelo menos umcomputador em seu ambiente do IBM Cognos BI.

v Se deseja utilizar o Query Studio, ative o Serviço de apresentação.v Se deseja utilizar o Analysis Studio, ative o Serviço de relatório.v Se alguns componentes do IBM Cognos BI não estiverem instalados em um

computador, você deverá desativar os serviços associados aos componentesausentes. Caso contrário, os componentes do IBM Cognos BI falharãoaleatoriamente.

Serviços do IBM Cognos

Após você instalar e configurar o IBM Cognos BI, um dispatcher estará disponívelem cada computador por padrão. Cada dispatcher possui um conjunto de serviçosassociados, listados na tabela a seguir.

314 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 327: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Tabela 65. Serviços do IBM Cognos

Serviço Finalidade

Serviço do agenteExecuta agentes. Se as condições para umagente forem atendidas durante suaexecução, o serviço do agente solicitará queo serviço do monitor execute as tarefas.

Serviço de anotaçãoAtiva a adição de comentário para relatóriospor meio da Área de Trabalho do IBMCognos. Esses comentários permanecem nasversões do relatório.

Serviço de relatórios em loteGerencia solicitações de plano de fundo paraexecutar os relatórios e oferece resultados doserviço de monitoração.

Serviço de cache do Content ManagerAprimora o desempenho geral do sistema ea escalabilidade do Content Manager aoarmazenar em cache os resultados dasconsultas frequentes em cada dispatcher.

Serviço Content Managerv Desempenha funções de manipulação de

objetos no armazenamento de conteúdocomo adição, consulta, atualização,exclusão, movimentação e cópia.

v Desempenha funções de gerenciamento doarmazenamento de conteúdo comoimportação e exportação.

Serviço de deslocamento de dadosGerencia a execução de tarefas demovimentação de dados no IBM Cognos BI.As tarefas de movimentação de dados, comoBuilds e JobStreams, são criadas no DataManager Designer e publicadas no IBMCognos BI.

Serviço de entregaEnvia e-mails para um servidor SMTPexterno em nome de outros serviços, como oserviço de relatórios, serviço de tarefa,serviço do agente ou serviço de integraçõesde dados.

Serviço de gerenciamento de eventosCria, programa e gerencia objetos de eventoque representam relatórios, tarefas, agentes,manutenção de armazenamento deconteúdo, importações e exportações deimplantações e métricas.

Serviço do GraphicsGera gráficos em nome do serviço derelatório. Gráficos podem ser gerados em 4formatos diferentes: Raster, Vector, MicrosoftExcel XML ou PDF.

Serviço Human taskPermite a criação e o gerenciamento detarefas realizadas por usuários. Uma tarefarealizada por usuários, como a aprovação derelatórios, pode ser atribuída à indivíduosou grupos em uma base ad hoc ou porqualquer outro serviço.

Serviço de dados do índiceFornece funções básicas de texto completopara o armazenamento e a recuperação determos e documentos resumidos indexados.

Capítulo 13. Manutenção do desempenho 315

Page 328: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Tabela 65. Serviços do IBM Cognos (continuação)

Serviço Finalidade

Serviço de procura do índiceFornece funções de procura e drill through,incluindo listas de aliases e exemplos.

Serviço de atualização do índiceFornece funções de gravação, atualização,exclusão e administração.

Serviço de tarefaExecuta tarefas ao sinalizar o serviço domonitor para executar as etapas da tarefa emplano de fundo. As etapas incluemrelatórios, outras tarefas, importações,exportações, etc.

Serviço de LogRegistra mensagens de log geradas pelodispatcher e por outros serviços. O serviçode log pode ser configurado para registrarinformação de log em um arquivo, banco dedados, servidor de log remoto, WindowsEvent Viewer ou log do sistema UNIX. Asinformação de log podem ser analisadas porclientes ou pelos Cognos Software Services,incluindo:

v Eventos de segurança.

v Informações do erro do sistema e doaplicativo.

v Informações de diagnóstico selecionadas.

Serviço de metadadosFornece suporte para informações delinhagem de dados exibidas no CognosViewer, Report Studio, Query Studio eAnalysis Studio. As informações delinhagem incluem informações como origemde dados e expressões de cálculo.

Serviço Metric StudioFornece a interface com o usuário do MetricStudio para o monitoramento e a inserção deinformações de desempenho.

Serviço de migraçãoGerencia a migração do IBM CognosSeries 7 para o IBM Cognos BI.

316 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 329: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Tabela 65. Serviços do IBM Cognos (continuação)

Serviço Finalidade

serviço do MobileGerencia atividades relacionadas ao clienteIBM Cognos Mobile:

v Transforma relatórios e análises doCognos Business Intelligence paraconsumo móvel.

v Compacta o conteúdo de relatório e deanálise do Cognos BI para rápidadistribuição over-the-air para dispositivosmóveis e acesso a partir dessesdispositivos.

v Envia por push o conteúdo de relatório ede análise para os dispositivos móveis.

v Facilita solicitações relacionadas arelatórios e a análises de entrada e saídaentre o dispositivo móvel e o ambientepara procurar, navegar ou executarrelatórios.

v Sincroniza o armazenamento de conteúdomóvel no servidor com o banco de dadosmóvel no dispositivo móvel.

v Converte mensagens do Cognos BI SimpleObject Access Protocol (SOAP) emmensagens convenientes wireless.

v Comunica-se com o dispositivo móvel.

Serviço de monitorv Gerencia o monitoramento e a execução

de tarefas que estão programadas, queforam enviadas para execução posteriorou executadas como uma tarefa desegundo plano.

v Atribui um serviço meta para manipularuma tarefa programada. Por exemplo, oserviço do monitor pode solicitar que oserviço de relatórios em lote execute umrelatório, que o serviço de tarefa executeuma tarefa ou que o serviço do agenteexecute um agente.

v Cria objetos do histórico dentro doContent Manager e gerencia o failover e arecuperação para executar entradas.

Serviço do PowerPlay Gerencia solicitações para a execução derelatórios do PowerPlay.

Serviço de apresentaçãov Transforma respostas genéricas em XML

de outro serviço no formato de saída,como HTML ou PDF.

v Fornece recursos de exibição, navegação eadministração no IBM Cognos Connection

Serviço de consultaGerencia as solicitações de consultasdinâmicas e exibe o resultado no serviço emlotes ou de relatórios solicitante.

Capítulo 13. Manutenção do desempenho 317

Page 330: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Tabela 65. Serviços do IBM Cognos (continuação)

Serviço Finalidade

Serviço de dados de relatórioGerencia a transferência de dados dorelatório entre o IBM Cognos BI e osaplicativos que consomem dados, como IBMCognos BI para Microsoft Office e IBMCognos Mobile.

Serviço de RelatórioGerencia solicitações interativas paraexecutar relatórios e fornece saída para umusuário no IBM Cognos Connection ouStudio.

Serviço de repositórioGerencia solicitações para recuperar a saídado relatório arquivado de um repositório dearchive ou de um armazenamento de objeto.

Ajustando um Armazenamento de Conteúdo do DB2Se você usar um banco de dados do DB2 para armazenamento de conteúdo, épossível executar algumas etapas para melhorar a velocidade com que assolicitações são processadas.

Por padrão, o DB2 designa tabelas contendo objetos grandes (LOBS) para umespaço de tabela gerenciado por banco de dados. Como resultado, os LOBS nãosão gerenciados pelos buffer pools do DB2. Isso resulta em solicitações de E/Sdiretas nos LOBS, que afeta o desempenho. Ao reatribuir as tabelas que contêmLOBS a um tablespace gerenciado pelo sistema, o número de solicitações diretas deE/S é reduzido.

Antes de alterar o armazenamento de conteúdo do DB2, aloque espaço de logsuficiente para reestruturar o banco de dados.

Para reconfigurar o armazenamento de conteúdo do DB2, faça o seguinte:v Exporte os dados das tabelas que contêm pelo menos um objeto grande (LOB).v Crie as tabelas em um tablespace gerenciado pelo sistema.v Importe os dados em tabelas.

Ajustando os recursos de memória para o serviço do IBM CognosPara melhorar o desempenho em um ambiente distribuído, é possível alterar aquantidade de recursos que o serviço do IBM Cognos usa.

Por padrão, o serviço do IBM Cognos é configurado para usar recursos mínimosde memória para otimizar o tempo de inicialização.

As definições de configuração para o serviço do IBM Cognos aplicam-se apenas aoservidor de aplicativos que o IBM Cognos BI usa por padrão. Se quiser configuraro IBM Cognos BI para execução em outro servidor de aplicativos, não o use IBMCognos Configuration para configurar os recursos. Ao invés disso, configure osrecursos naquele ambiente do servidor de aplicativos.

O serviço do IBM Cognos está disponível apenas nos computadores em que vocêinstalou o Content Manager ou os Componentes da Camada de Aplicativos.

318 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 331: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Procedimento1. Inicie o IBM Cognos Configuration.2. Na janela Explorer, expanda Ambiente > Serviços do IBM Cognos e clique em

IBM Cognos.3. Na janela Propriedades, altere o valor para Memória máxima em MB.

v Para reduzir o tempo de inicialização, a área de cobertura da memória e osrecursos usados, use a configuração padrão de 768.

v Para fazer um balanço entre o tempo as velocidades rápidas do tempo deinicialização e operacionais, digite um valor que seja cerca de 1,5 vezes ovalor padrão, como 1152.

v Para maximizar as velocidades operacionais, se o desempenho for maisimportante que o tempo de inicialização e se seu computador tiver recursossuficientes, digite um valor que seja aproximadamente duas vezes o valorpadrão, como 1536.

4. No menu Arquivo, clique em Salvar.

Reduzindo o Número de Solicitações por ProcessoUse as etapas a seguir para reduzir o número de solicitações por processo em umainstância de serviço do IBM Cognos.

Procedimento1. Acesse o diretório c10_location/webapps/p2pd/WEB-INF/services.2. Abra o arquivo reportservice.xml em um editor XML.3. Altere o valor de default_process_use_limit de 0 (ilimitado) para um número

fixo de solicitações.4. Salve o arquivo.5. Reinicie o serviço do IBM Cognos.6. Se o IBM Cognos BI foi implementado em um servidor de aplicativos,

reconstrua o arquivo de aplicativo e implemente-o no servidor de aplicativos.Por exemplo, para o WebSphere, gere novamente o arquivo EAR eimplemente-o no WebSphere Application Server.

Aumentando a Capacidade de Manipulação 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 com umsistema pequeno. Se você usar o Banco de dados de conteúdo do Cognos em umsistema grande, no qual o número de solicitações simultâneas é maior que dez,você deverá ajustar as configurações de memória da JVM padrão e aumentar otamanho do cache de página para o Derby.

Procedimento1. No computador onde o componente Banco de dados de conteúdo do Cognos

foi instalado, acesse o diretório c10_location\bin.2. Abra o arquivo derby.bat (no Windows) ou o arquivo derby.sh (no UNIX ou no

Linux).3. Localize a seguinte linha:

set MEM_SETTINGS=-Xmx256m

e altere-a para o seguinte:

Capítulo 13. Manutenção do desempenho 319

Page 332: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

set MEM_SETTINGS="-Xmx1152m -XX:MaxPermSize=128M -XX:MaxNewSize=576m-XX:NewSize=288m"

4. No diretório c10_location\configuration, renomeie derby.properties.sample comoderby.properties.

5. No mesmo diretório, abra o arquivo derby.properties.6. Comente a seguinte linha:

derby.storage.pageCacheSize=15000

Desempenho do IBM Cognos MobileÉ possível usar vários métodos para estimar e controlar o desempenho doambiente do IBM Cognos Mobile.

Estimar a largura da banda requerida pelo IBM Cognos MobileO IBM Cognos Mobile envia versões compactadas de relatórios do servidor para odispositivo móvel. O tamanho de um relatório compactado pode variar de 2 KBpara um relatório de página simples que contém texto e uma crosstab, atépossivelmente 500 KB para um relatório de 10 páginas que contém diversosgráficos detalhados em cada página.

Cada versão de um relatório é enviada somente uma vez. Então ele é armazenadoem cache no dispositivo móvel. Um usuário móvel pode então visualizar orelatório quantas vezes quiser no dispositivo sem consumir largura da bandaadicional.

Outras operações, como navegar no armazenamento de conteúdo e responder aprompts, também consomem largura da banda. A largura da banda consumida éproporcional àquela utilizada pelo navegador da área de trabalho que executa amesma ação, mas menor porque não são trocadas informações extras deformatação.

O IBM Cognos Mobile empenha-se em uma pesquisa inteligente para detectarmudanças no servidor. Em um estado inativo, cada dispositivo móvel envia umapequena mensagem de dados ao servidor a cada 24 horas. (Observe que esse valoré configurável). Se houver uso intenso, onde um usuário do dispositivo móvelexecuta muitos relatórios durante todo o dia e programa muitos relatórios paraentregar ao dispositivo móvel, o dispositivo automaticamente conecta-se aoservidor mais frequentemente.

Para estimar os custos de largura da banda, um administrador pode usar aseguinte fórmula como um guia:

(número de usuários) x (tamanho médio de um relatório) x (número de relatóriosad hoc executados em cada dia por usuário + número de relatórios planejados paraenvio a cada usuário por dia).

Estimar o número necessário de servidoresA carga gerada por um usuário que está usando o IBM Cognos Mobile em umservidor (dispatcher) é semelhante à carga gerada pelo mesmo usuário que estáusando os produtos para desktop IBM Cognos.

Os recursos necessários a um usuário de desktop para pesquisar pastas, executarrelatórios, responder a avisos e visualizar o relatório resultante sãoaproximadamente os mesmos recursos necessários a um usuário móvel para

320 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 333: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

executar as mesmas ações. Como resultado, para se estimar o número deservidores requeridos pelos usuários móveis, é possível usar a mesma fórmulausada para estimar o número de servidores requeridos para os usuários da área detrabalho.

Estimando o tamanho de um relatórioÉ possível usar os relatórios típicos para determinar o tamanho do conteúdo que étransferido pela rede da operadora de serviços wireless para o dispositivo móvel.

Procedimento1. Remova todos os relatórios do dispositivo móvel.2. Execute o relatório do qual você deseja saber o tamanho.3. No navegador da sua área de trabalho, digite a solicitação a seguir:

http://servername/alias/cgi-bin/cognos.cgi/mobileService?mob_op=about

4. Se a segurança estiver ativada, efetue logon.Certifique-se de efetuar logon com o mesmo usuário que executou o relatóriono dispositivo móvel.Um pequeno documento XML é exibido. Dentro do documento há uma seçãoque se parece com o exemplo a seguir, mostrando o número 28. O número realque você vê depende seu relatório:<s2><inbox>28</inbox></s2>

Dica: Como você possui somente um relatório, apenas um número deveaparecer. Se houver diversos números separados por dois pontos, isso significaque você não excluiu todos os relatórios. Deve-se excluir todos os relatórios erepetir as etapas 1 a 3.

5. Digite a solicitação a seguir, substituindo o número 28 pelo número obtido naetapa 4: http://servername/alias/cgi-bin/cognos.cgi/mobileService?mob_op=downloadDB&mob_ir=28

A resposta dessa solicitação é o conteúdo do relatório real.6. Salve esta resposta como um arquivo e registre seu tamanho.

Esse arquivo é o que foi transferido pela rede.7. Repita essas etapas para diversos relatórios típicos para ter uma ideia da

quantidade de dados que seus usuários móveis usam.

Melhoria do desempenho do banco de dados de armazenamento demétricas

O IBM Cognos BI fornece um script chamado cmm_update_stats que atualiza seusíndices de banco de dados de armazenamento de métricas, que melhoram odesempenho. Esse script é utilizado normalmente antes ou depois de carregardados quando o volume ou a distribuição de dados mudou significativamente. Porexemplo, o desempenho pode melhorar se esse script for executado depois deaumentar o número de scorecards de 100 para 1000.

Procedimento1. Certifique-se de que não haja atividade no banco de dados de armazenamento

de métricas.2. Vá para o seguinte diretório:

c10_location\configuration\schemas\cmm3. Acesse o diretório apropriado do banco de dados.

Capítulo 13. Manutenção do desempenho 321

Page 334: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

4. Dependendo do tipo de banco de dados, execute um dos seguintes scripts dalinha de comandos:v Para Microsoft SQL Server ou DB2:

cmm_update_stats host_name metric_store_name Admin_user_name password

v 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 emlocais remotos do que para abrir localmente. Além disso, os relatórios HTMLlevam mais tempo para abrir que relatórios em PDF porque mais solicitações sãoprocessadas para relatórios HTML.

É possível reduzir a quantidade de tempo para abrir relatórios em locais remotosde duas maneiras. É possível reduzir o número de solicitações entre o navegador eo servidor executando o relatório em formato PDF. Se relatórios HTML foremobrigatórios, é possível acelerar a entrega do relatório configurando gatewaysadicionais em alguns locais remotos. O conteúdo estático, como gráficos e folhas deestilo, será entregue mais rapidamente.

Aumento do limite de tempo assíncrono em ambiente de carregamentode uso intenso

Se tiver uma carga de usuário intensa (mais de 165) e os relatórios interativosestiverem em execução contínua em uma instalação distribuída, pode sernecessá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. Paraobter informações, consulte IBM Cognos Business Intelligence: Guia de Administração eSegurança.

Para resolver esse problema, aumente o timeout de espera.

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

322 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 335: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Capítulo 14. Configurando Manualmente o IBM CognosBusiness Intelligence nos Sistemas Operacionais UNIX eLinux

O console conectado ao computador do sistema operacional UNIX ou Linux noqual você está instalando o IBM Cognos Business Intelligence pode não suportaruma interface gráfica de usuário baseada em Java.

Você deve executar as tarefas a seguir manualmente:__ v Alterar as definições de configuração padrão editando o arquivo

cogstartup.xml, localizado no diretório c10_location/configuration.__ v Alterar o suporte ao idioma ou à moeda, ou mapeamento de localidade

editando o arquivo coglocale.xml, localizado no diretórioc10_location/configuration.

__ v Aplicar a configuração e as configurações do código de idioma aocomputador executando o IBM Cognos Configuration no modo silencioso.

Para todas as instalações, algumas tarefas de configuração são necessárias para queo IBM Cognos BI funcione em seu ambiente. Se você distribuir componentes doIBM Cognos BI em vários computadores, a ordem de configuração e de início doscomputadores será 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 arquivocogstartup.xml para alterar os valores de propriedade. Também é possível usararquivos de amostra que ativam o IBM Cognos BI para usar recursos que jáexistem em seu ambiente.

Alterar Manualmente Definições de Configuração PadrãoSe o console conectado ao computador do sistema operacional UNIX ou Linux nãosuportar uma interface gráfica de usuário baseada em Java, você deve editar ocogstartup.xml para configurar o IBM Cognos Business Intelligence para funcionarem seu ambiente.

Importante: Algumas definições de configuração não são salvas no arquivocogstartup.xml a menos que você use a interface gráfica com o usuário. Porexemplo, o fuso horário do servidor não é configurado para os componentes doIBM Cognos quando você modifica o arquivo cogstartup.xml diretamente e, emseguida, executa IBM Cognos Configuration no modo silencioso. Neste caso, outrasconfigurações de usuário que dependem do fuso horário do servidor podem nãofuncionar como o esperado.

Se quiser que o IBM Cognos BI use um recurso, como um provedor deautenticação que já existe em seu ambiente, é possível incluir um componente emsua configuração. Isso é feito copiando o código XML necessário de arquivos deamostra no arquivo cogstartup.xml e, em seguida, editando os valores para seadaptarem ao ambiente.

Por padrão, o arquivo cogstartup.xml é codificado usando UTF-8. Quando salvaro arquivo cogstartup.xml, assegure-se de alterar a codificação da localidade do

© Copyright IBM Corp. 2005, 2014 323

Page 336: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

usuário para que corresponda à codificação usada. A codificação do código doidioma do usuário é definida pelas variáveis de ambiente.

Ao editar o arquivo cogstartup.xml, lembre-se de que o XML faz distinção entremaiúsculas e minúsculas. Essa sensibilidade é importante em todos os usos detexto, incluindo rótulos de elemento e de atributos, elementos e valores.

Antes de editar o arquivo cogstartup.xml, assegure-se dev Fazer uma cópia de backup.v Criar o armazenamento de conteúdo em um computador disponível na rede.v Revisar os requisitos de configuração para seu tipo de instalação.

Procedimento1. Acesse o diretório c10_location/configuration.2. Abra o arquivo cogstartup.xml em um editor.3. Localize a definição de configuração que deseja alterar consultando a ajuda e os

comentários da descrição que aparecem antes da tag inicial dos elementos<crn:parameter>.

4. Altere o valor do elemento <crn:value> para adequá-lo ao seu ambiente.

Dica: Use o atributo type para ajudá-lo a determinar o tipo de dado para apropriedade de configuração.

5. Repita as etapas 3 e 4 até que os valores da configuração sejam adequados aoambiente.

6. Salve e feche o arquivo.

Resultados

Agora você deve usar um editor XML de validação para validar suas mudançascom relação às regras no arquivo cogstartup.xsd, localizado emc10_location/configuration.

Incluindo um Componente em Sua ConfiguraçãoO arquivo cogstartup.xml contém as definições de configuração usadas pelo IBMCognos Business Intelligence e por componentes padrão. É possível alterar oscomponentes que o IBM Cognos BI usa copiando os elementos XML dos arquivosde amostra no arquivo cogstartup.xml. É possível editar os valores deconfiguração para que se adaptem ao ambiente.

Por exemplo, para usar um banco de dados Oracle para o armazenamento deconteúdo, é possível usar o arquivo de amostra ContentManager_language code.xmlpara substituir as informações de conexão com o banco de dados.

O IBM Cognos BI só pode usar uma instância por vez dos seguintes elementos:v O banco de dados para o armazenamento de conteúdov Um provedor criptográficov 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 decomeçar a editá-los.

324 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 337: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Procedimento1. Acesse o diretório c10_location/configuration/samples.2. Escolha um arquivo de amostra para abrir em um editor:

v Para usar o Oracle, o DB2 ou o Sybase para o armazenamento de conteúdo,abra o arquivo ContentManager_language_code.xml.

v Para usar um provedor de autenticação, abra o arquivoAuthentication_language_code.xml.

v Para usar um provedor criptográfico, abra o arquivoCryptography_language_code.xml.

v Para enviar mensagens de log para algum lugar diferente de um arquivo,abra o arquivo Logging_language_code.xml.

v Para usar um modelo médio ou grande para a quantia de recursos que oprocesso do IBM Cognos BI usa, abra o arquivoCognosService_language_code.xml.

3. Copie os elementos de que precisa.

Dica: Certifique-se de copiar o código incluindo as tags inicial e final para oelemento <crn:instance>.Por exemplo, consulte os comentários (Begin of) e (End of):<!--

(Begin of) DB2 template--><crn:instance ...>...</crn:instance><!--End of) DB2 template

-->

4. Acesse o diretório c10_location/configuration.5. Abra o arquivo cogstartup.xml em um editor.6. Cole o código do arquivo de amostra no arquivo cogstartup.xml e substitua o

elemento <crn:instance> apropriado.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ívelalterar esses valores para melhor se adaptarem ao ambiente.Por exemplo, se utilizar um banco de dados Oracle para o armazenamento deconteúdo, mude apenas o nome do atributo para se adaptar ao ambiente.<crn:instance class="Oracle" name="MyContentStore">

8. Salve e feche o arquivo.9. Execute o IBM Cognos Configuration no modo silencioso digitando o seguinte

comando:./cogconfig.sh -s

Isso garante que o arquivo seja válido e que as senhas estejam criptografadas.

Alterando as Configurações Criptografadas ManualmenteÉ possível alterar manualmente as configurações criptografadas, como senhas ecredenciais de usuário, no arquivo cogstartup.xml.

Capítulo 14. Configurando Manualmente o IBM Cognos Business Intelligence nos Sistemas Operacionais UNIX e Linux 325

Page 338: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Para solicitar que o IBM Cognos Configuration salve uma configuraçãocriptografada, altere o valor e configure o sinalizador de criptografia como false.

Procedimento1. Acesse o diretório c10_location/configuration.2. Abra o arquivo cogstartup.xml em um editor.3. Localize a configuração criptografada que deseja alterar consultando a ajuda e

os comentários da descrição que aparecem antes da tag inicial dos elementos<crn:parameter>.

4. Altere o valor do elemento <crn:value> para adequá-lo ao seu ambiente.

Dica: Use o atributo de tipo para ajudá-lo a determinar o tipo de dado para apropriedade 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 aoambiente.

7. Salve e feche o arquivo.8. Digite o seguinte comando de configuração:

./cogconfig.sh -s

Resultados

As novas configurações são salvas e criptografadas.

Configurações Globais em Sistemas Operacionais UNIX e LinuxSe o console conectado ao computador do sistema operacional UNIX ou Linux nãosuporta uma interface gráfica de usuário baseada em Java, você deve editarmanualmente o arquivo coglocale.xml.

É possível alterar as configurações globaisv Para especificar o idioma usado na interface com o usuário quando o idioma no

código do idioma do usuário não está disponívelv Para especificar o código do idioma usado em relatórios quando o código do

idioma do usuário não está disponívelv Para adicionar suporte à moeda ou código do idioma para reportar dados ou

metadados.v Para adicionar suporte ao idioma à interface com o usuário.

Por padrão, os componentes do IBM Cognos BI garantem que todos os códigos doidioma, que podem vir de diferentes fontes e em vários formatos, usem uma formanormalizada. Isto significa que todos os códigos do idioma expandidos se adaptamàs configurações de idioma e código da região.

Antes de adicionar um suporte ao idioma à interface com o usuário é necessárioinstalar os arquivos de idiomas em todos os computadores da instalaçãodistribuída. Para obter mais informações, consulte o representante de suporte.

326 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 339: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Exemplo 1

Um relatório está disponível no Content Manager em dois códigos do idioma,como com en-us (inglês dos Estados Unidos) e fr-fr (francês da França), mas ocódigo do idioma do usuário está definido para fr-ca (francês do Canadá). O IBMCognos usa o mapeamento de código do idioma para determinar qual relatório ousuário vê.

Primeiro, o IBM Cognos verifica se o relatório está disponível no Content Managerno código do idioma do usuário. Se ele não estiver disponível no código do idiomado usuário, o IBM Cognos mapeará o código do idioma do usuário para umcódigo do idioma normalizado na guia Mapeamento de Código do Idioma doConteúdo. Como o código do idioma do usuário é fr-ca, ele será mapeado para fr.O IBM Cognos usa o valor mapeado para ver se o relatório está disponível em fr.Nesse caso, o relatório estará disponível em en-us e fr-fr, e não em fr.

Em seguida, o IBM Cognos mapeia cada um dos relatórios disponíveis para umcódigo do idioma normalizado. Desta forma, en-us se torna en e fr-fr se torna fr.

Já que o relatório e o código do idioma do usuário mapeiam para fr, o usuário como código do idioma do usuário fr-ca verá o relatório salvo com o código do idiomafr-fr.

Exemplo 2

O código do idioma do usuário e os códigos do idioma do relatório são todosmapeados para o mesmo código do idioma. O IBM Cognos escolhe qual código doidioma usar. Por exemplo, se o código do idioma do usuário for en-ca (inglês doCanadá) e os relatórios estiverem disponíveis em en-us (inglês dos Estados Unidos)e en-gb (inglês do Reino Unido), o IBM Cognos mapeará cada código do idiomapara en. O usuário verá o relatório na configuração do código de idioma escolhidapelo IBM Cognos.

Exemplo 3

Os códigos do idioma do relatório e do usuário não mapeiam para um idiomacomum. O IBM Cognos escolhe o idioma. Neste caso, pode ser necessárioconfigurar um mapeamento. Por exemplo, se um relatório estiver disponível emen-us (inglês dos Estados Unidos) e fr-fr (francês da França), mas o código doidioma do usuário for es-es (espanhol da Espanha), o IBM Cognos escolherá oidioma.

Alterando Manualmente as Configurações Globais nosSistemas Operacionais UNIX e Linux

Use as etapas a seguir para alterar as configurações globais nos sistemasoperacionais UNIX e Linux usando o arquivo coglocale.

Procedimento1. Em cada computador no qual você instalou o Content Manager, acesse o

diretório c10_location/configuration.2. Abra o arquivo coglocale.xml em um editor.3. Adicione ou modifique o elemento e o atributos requeridos entre as tags de

início e fim adequados.Os elementos, atributos e tags inicial e final estão listados na tabela a seguir.

Capítulo 14. Configurando Manualmente o IBM Cognos Business Intelligence nos Sistemas Operacionais UNIX e Linux 327

Page 340: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Tabela 66. Tags para Configurações Globais

Tipo de elemento Tag de início Tag de fim

Idioma <supportedProductLocales> </supportedProductLocales>

Códigos do idioma doconteúdo

<supportedContentLocales> </supportedContentLocales>

Moeda <supportedCurrencies> </supportedCurrencies>

Mapeamento de Código deidioma do produto

<productLocaleMap> </productLocaleMap>

Mapeamento de Localidadedo Conteúdo

<contentLocaleMap> </contentLocaleMap>

Fontes <supportedFonts> </supportedFonts>

Configurações de cookie,localização de archive pararelatórios

<parameter name="setting"> </parameter>

Dica: Para remover o suporte, exclua o elemento.4. Salve e feche o arquivo.

Resultados

Dica: Use um editor XML de validação para validar suas mudanças com relação àsregras no arquivo cogstartup.xsd, localizadas em c10_location/configuration.

Se você incluir um código de unidade monetária que não seja suportado, deveráincluí-lo manualmente no arquivo i18n_res.xml no diretório c10_location/bin/.Copie esse arquivo em cada computador IBM Cognos em sua instalação.

Iniciando e Parando o Cognos BI em Modo Silencioso em SistemasOperacionais UNIX e Linux

Execute o IBM Cognos Configuration no modo silencioso para aplicar as definiçõesde configuração e iniciar os serviços em computadores com sistema operacionalUNIX ou Linux que não suportam uma interface gráfica de usuário baseada emJava.

Antes de executar a ferramenta de configuração no modo silencioso, você deveassegurar que o arquivo cogstartup.xml seja válido de acordo com as regrasdefinidas no arquivo cogstartup.xsd. O arquivo cogstartup.xsd está localizado nodiretório c10_location/configuration.

Iniciando o Cognos BI em Modo Silencioso em SistemasOperacionais UNIX e Linux

Use as seguintes etapas para iniciar o software IBM Cognos Business Intelligenceno modo silencioso.

328 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 341: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Procedimento1. Assegure-se de que o arquivo cogstartup.xml, localizado no diretório

c10_location/configuration, foi modificado para o seu ambiente.Para obter mais informações, consulte “Alterar Manualmente Definições deConfiguração Padrão” na página 323.

2. Acesse o diretório c10_location/bin64.3. Digite o seguinte comando

./cogconfig.sh -s

Dica: Para visualizar as mensagens de log geradas durante uma configuraçãonão assistida, consulte o arquivo cogconfig_response.csv no diretórioc10_location/logs.

Resultados

O IBM Cognos Configuration se aplica às definições de configuração especificadasno arquivo cogstartup.xml, criptografa as credenciais, gera os certificados digitaise, se aplicável, inicia o serviço ou o processo Cognos.

Parando o Cognos BI em Modo Silencioso em SistemasOperacionais UNIX e Linux

Use as seguintes etapas para parar o software IBM Cognos Business Intelligence nomodo silencioso.

Procedimento1. Acesse o diretório c10_location/bin64.2. Digite o seguinte comando

./cogconfig.sh -stop

Criar Manualmente um Arquivo de Aplicativo IBM CognosO IBM Cognos Business Intelligence e o gateway de servlet devem sercompactados em um arquivo de aplicativo para implementação nos servidores deaplicativos suportados. O IBM Cognos Business Intelligence fornece um assistentepara Construção de Aplicativo que é possível usar para criar o arquivo deaplicativo.

É possível criar um archive web (.war), um archive Enterprise (.ear) ou umdiretó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 qualdeles é suportado pelo servidor de aplicativos, consulte a documentação fornecidajunto com o servidor de aplicativos.

Se escolher não utilizar o Assistente para Construção de Aplicativo, será necessárioconcluir as seguintes etapas para criar o arquivo de aplicativo.

Se o servidor de aplicativos não estiver sendo usado como um servidor da Web,não é necessário incluir conteúdo estático do IBM Cognos (páginas html, imagens,entre outras coisas) no arquivo de aplicativo. A exclusão do conteúdo estático aocriar o arquivo de aplicativo reduz o tamanho do arquivo.

Capítulo 14. Configurando Manualmente o IBM Cognos Business Intelligence nos Sistemas Operacionais UNIX e Linux 329

Page 342: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Criando Arquivo de Aplicativo IBM Cognos para o SoftwareBusiness Intelligence

Se escolher não utilizar o Assistente para Construção de Aplicativo, será necessárioconcluir as seguintes etapas para criar o arquivo de aplicativo.

Procedimento1. Pare o serviço do IBM Cognos se estiver em execução.2. Acesse o diretório c10_location/war/p2pd.3. Execute o script de estrutura utilizando a seguinte sintaxe de comando:

v Para sistema operacional Microsoft Windows,build.bat file_type option

v Para sistemas operacionais UNIX ou Linux,build.sh file_type option

Em que file_type pode ser um dos valores listados na tabela a seguir:

Tabela 67. Uma lista de opções de tipo de arquivos e descrições para um arquivo deaplicativo para o software Business Intelligence

Valor Descrição

war Arquivo WAR com conteúdo estático

war_without_webcontent Arquivo WAR sem conteúdo estático

war_without_docsamples Arquivo WAR com conteúdo estático e semarquivos de documentação ou amostra

ear Arquivo EAR com conteúdo estático

ear_without_webcontent Arquivo EAR sem conteúdo estático

ear_without_docsamples Arquivo EAR com conteúdo estático e semarquivos de documentação ou amostra

expand O diretório que contém o aplicativo comconteúdo estático

expand_without_webcontent O diretório que contém o aplicativo semconteúdo estático

expand_without_docsamples O diretório que contém o aplicativo comconteúdo estático e sem documentação earquivos de amostra

E, em que option pode ser um ou mais dos valores listados na tabela a seguir:

330 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 343: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Tabela 68. Uma lista de opções, valores e descrições para um arquivo de aplicativo para osoftware Business Intelligence

Opção Valor Descrição

-Dappserver_type=value jboss

sap

sjsas

other (padrão)

O tipo de servidor deaplicativos.

Use jboss para o servidor deaplicativos Red Hat JBoss.

Use sap para o servidor deaplicativos SAP NetWeaver.

Use sjsas para o servidor deaplicativos Sun Java Systems.

Use other para qualqueroutro servidor de aplicativos.

-Dcontext_root=value p2pd (padrão) O valor da raiz de contextopara o aplicativo.

-Dwar_name=value caminho/nome de arquivo

O padrão é ../../p2pd.war

O caminho e o nome doarquivo WAR a ser criado.

-Dear_name=value caminho/nome de arquivo

O padrão é ../../p2pd.ear

O caminho e o nome doarquivo EAR a ser criado.

-Dexpand_location=value

(Para tipos de arquivos deexpansão)

path/directory

O padrão é../../temp/expand

O caminho e o diretório emque os arquivos de aplicativodevem ser expandidos.

-Dcogroot_path=value caminho

O padrão é o caminho dainstalação atual.

O caminho para o diretóriode instalação do IBM CognosBI.

Criando Arquivo de Aplicativo IBM Cognos para um Gatewayde Servlet

Se escolher não utilizar o Assistente para Construção de Aplicativo, será necessárioconcluir as seguintes etapas para criar o arquivo de aplicativo.

Procedimento1. Pare o serviço do IBM Cognos se estiver em execução.2. Acesse o diretório c10_location/war/gateway.3. Execute o script de estrutura utilizando a seguinte sintaxe de comando:

v Para sistema operacional Microsoft Windows,build.bat file_type option

v Para sistemas operacionais UNIX ou Linux,build.sh file_type option

Em que file_type pode ser um dos valores listados na tabela a seguir:

Tabela 69. Valores e Descrições de Tipo de Arquivo de um Arquivo de Aplicativo para umGateway de Servlet

Valor Descrição

gateway_war Arquivo WAR com conteúdo estático

Capítulo 14. Configurando Manualmente o IBM Cognos Business Intelligence nos Sistemas Operacionais UNIX e Linux 331

Page 344: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Tabela 69. Valores e Descrições de Tipo de Arquivo de um Arquivo de Aplicativo para umGateway de Servlet (continuação)

Valor Descrição

gateway_war_without_docsamples Arquivo WAR com conteúdo estático e semarquivos de documentação ou amostra

gateway_ear Arquivo EAR com conteúdo estático

gateway_ear_without_docsamples Arquivo EAR com conteúdo estático e semarquivos de documentação ou amostra

expand O diretório que contém o aplicativo comconteúdo estático

expand_without_docsamples O diretório que contém o aplicativo comconteúdo estático e sem documentação earquivos de amostra

E, em que option pode ser um ou mais dos valores listados na tabela a seguir:

Tabela 70. Valores e Descrições de Opções de um Arquivo de Aplicativo para um Gatewayde Servlet

Opção Valor Descrição

-Dappserver_type=value jboss

sap

sjsas

other (padrão)

O tipo de servidor deaplicativos.

Use jboss para o servidor deaplicativos Red Hat JBoss.

Use sap para o servidor deaplicativos SAP NetWeaver.

Use sjsas para o servidor deaplicativos Sun Java Systems.

Use other para qualqueroutro servidor de aplicativos.

-Dcontext_root=value ServletGateway (padrão) O valor da raiz de contextopara o aplicativo.

-Dwar_name=value caminho/nome de arquivo

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

O caminho e o nome doarquivo WAR a ser criado

-Dear_name=value caminho/nome de arquivo

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

O caminho e o nome doarquivo EAR a ser criado

-Dexpand_location=value

(Para tipos de arquivos deexpansão)

path/directory

O padrão é../../temp/expand

O caminho e o diretório emque os arquivos de aplicativodevem ser expandidos.

-Dcogroot_path=value caminho

O padrão é o caminho dainstalação atual.

O caminho para o diretóriode instalação do IBM CognosBI.

332 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 345: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Capítulo 15. Desinstalando o IBM Cognos BI

É importante utilizar os programas de desinstalação para remover completamentetodos os arquivos e as modificações dos arquivos do sistema. Para desinstalar oIBM Cognos Business Intelligence, você desinstala componentes do servidor eferramentas de modelagem.

Se estiver executando o IBM Cognos BI em um ambiente de servidor deaplicativos, use a ferramenta de administração fornecida com o servidor deaplicativos para parar o aplicativo se ele estiver em execução e remover aimplementação da parte Java dos componentes do IBM Cognos BI. Muitosservidores de aplicativos não removem completamente todos os arquivos oudiretórios de aplicativos implantados durante a desinstalação; desta forma, estaação deverá ser feita manualmente. Após ter removido a implementação doscomponentes do IBM Cognos BI, conclua as etapas nesta seção para desinstalar nossistemas operacionais UNIX e Microsoft Windows.

Importante: Não exclua os arquivos de configuração e de dados se estiveratualizando para uma nova versão do IBM Cognos BI e desejar usar os dados deconfiguração com a nova versão.

Importante: Se estiver usando Banco de dados de conteúdo do Cognos, o localpadrão para os arquivos de banco de dados será o diretório c10_location/contentstore. Se deseja manter seu banco de dados depois da desinstalação, nãoexclua esse diretório.

Desinstalar o IBM Cognos Business Intelligence nos SistemasOperacionais UNIX ou Linux

Se o IBM Cognos Business Intelligence não for mais necessário ou se seu sistemaoperacional UNIX ou Linux estiver sendo atualizado, 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çãocontinua no computador, e os arquivos ficam retidos até que sejam excluídosmanualmente.

Procedimento1. Se o console conectado ao seu computador não suportar uma interface gráfica

de usuário baseada em Java, determine a identificação do processo (pid) doprocesso do IBM Cognos BI ao digitar o seguinte comando:ps -ef | grep cogbootstrapservice

2. Pare o processo do IBM Cognos BI:v Se o XWindows for executado, inicie o IBM Cognos Configuration e no menu

Ações, clique em Parar.v Se não utilizar o XWindows, digite

kill -TERM pid

3. Para desinstalar o IBM Cognos BI, acesse o diretório c10_location/uninstall edigite o comando apropriado:v Caso utilize o XWindows, digite

© Copyright IBM Corp. 2005, 2014 333

Page 346: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

./uninst -u

v Se não estiver usando o XWindows, execute uma desinstalação autônoma .Para obter informações adicionais, consulte o Guia de Instalação e Configuraçãodo IBM Cognos Business Intelligence.

4. Siga os prompts para completar a desinstalação.5. Exclua todos os arquivos de Internet temporários dos computadores de

navegadores web.

Desinstale o IBM Cognos Business Intelligence em SistemasOperacionais Windows

Se o IBM Cognos Business Intelligence não for mais necessário ou se estiver sendoatualizado, desinstale todos os componentes do IBM Cognos BI e o serviço do IBMCognos.

Se tiver instalado mais de um componente no mesmo local, escolha os pacotespara desinstalação utilizando o assistente para desinstalação. Todos oscomponentes do pacote serão desinstalados. Você deve repetir o processo dedesinstalação em cada computador que contenha os componentes do IBM CognosBI.

Não é necessário fazer backup dos arquivos de configuração e dados em umsistema operacional Microsoft Windows. Estes arquivos são preservados durante adesinstalação.

Feche todos os programas antes de desinstalar o IBM Cognos BI. Do contrário,alguns arquivos poderão não ser removidos.

A desinstalação não remove os arquivos que foram alterados desde a instalação,tais como os de configuração e dados dos usuários. A localidade da instalaçãocontinua no computador e os arquivos ficam retidos até que sejam excluídosmanualmente. Não exclua os arquivos de configuração e de dados se estiveratualizando para uma nova versão do IBM Cognos BI e desejar usar os dados deconfiguração com a nova versão.

Procedimento1. No menu Iniciar, clique em Programas , IBM Cognos 10 , Desinstalar IBM

Cognos , Desinstalar IBM Cognos.Exibe-se o assistente Desinstalação.

Dica: O IBM Cognos BI é o nome padrão da Pasta do Programa criadadurante a instalação. Caso escolha outro nome, acesse a pasta para encontrar oprograma.No Microsoft Windows 8 ou 2012 Server, acesse o diretórioc10_location\uninstall e dê um clique duplo em Desinstalar o IBM Cognos.

2. Siga as instruções de desinstalação dos componentes.O arquivo cognos_uninst_log.htm registra as atividades que o assistente deDesinstalação executa ao desinstalar os arquivos.

Dica: Para localizar o arquivo de log, verifique o diretório temporário.Se você usou a opção Configuração Rápida para a instalação do Cognos BI, oassistente de Desinstalação fornece uma opção para desinstalar o DB2

334 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 347: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Advanced Workgroup Server Edition. Se você optar por desinstalar o DB2, seráexibido um aviso de que todos os dados do armazenamento de conteúdo serãoperdidos.

3. Exclua todos os arquivos de Internet temporários dos computadores denavegadores web.Para obter mais informações, consulte a documentação do navegador web.

Capítulo 15. Desinstalando o IBM Cognos BI 335

Page 348: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

336 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 349: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Apêndice A. Recursos de Acessibilidade

Os recursos de acessibilidade ajudam usuários com alguma deficiência, comomobilidade reduzida ou visão limitada, a utilizar produtos de tecnologia dainformações.

Consulte o Centro de Acessibilidade IBM (http://www.ibm.com/able) para obterinformações adicionais sobre a confirmação que a IBM tem para acessibilidade.

Atalhos de teclado do assistente de instalaçãoOs atalhos de teclado, ou teclas de atalho, oferecem um método mais fácil enormalmente mais rápido para navegar e usar o software

O assistente de instalação usa as teclas de navegação padrão do sistemaoperacional Microsoft Windows juntamente com as teclas específicas do aplicativo.

Nota: 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 executaralgumas das principais tarefas no assistente de instalação no sistema operacionalWindows.

Tabela 71. Lista de Atalhos de Teclado em um Sistema Operacional Windows

Ações Pressione

Mover para o próximo campo em umapágina

Tab

Mover para o campo anterior em umapágina

Shift+Tab

Encerrar o assistente de instalação Alt+F4

Mover para a próxima etapa de configuração Alt+N

Retornar para a etapa de configuraçãoanterior

Alt+B

Mover para a próxima seleção em uma lista Seta para baixo

Mover para a seleção anterior em uma lista Seta para cima

A tabela a seguir lista os atalhos de teclado que podem ser usados para executaralgumas das principais tarefas no assistente de instalação nos sistemas operacionaisUNIX ou Linux.

Tabela 72. Lista de Atalhos de Teclado em um Sistema Operacional UNIX ou Linux

Ações Pressione

Mover para o próximo campo em umapágina

Tab

Mover para o campo anterior em umapágina

Shift+Tab

Encerrar o assistente de instalação Alt+F4

Mover para a próxima seleção em uma lista Seta para baixo

© Copyright IBM Corp. 2005, 2014 337

Page 350: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Tabela 72. Lista de Atalhos de Teclado em um Sistema Operacional UNIX ouLinux (continuação)

Ações Pressione

Mover para a seleção anterior em uma lista Seta para cima

A tabela a seguir lista os atalhos de teclado que podem ser usados para executaralgumas das principais tarefas na página do contrato de licença do assistente deinstalação.

Tabela 73. Lista de Atalhos de Teclado na Página Contrato de Licença

Ações Pressione

Aceitar o contrato de licença Alt+A

Recusar o acordo de licença Alt+D

Encerrar o assistente de instalação Alt+x

A tabela a seguir lista os atalhos de teclado que podem ser usados para executaralgumas das principais tarefas no IBM Cognos Configuration em um sistemaoperacional Windows.

Tabela 74. Lista de Atalhos de Teclado para IBM Cognos Configuration em um SistemaOperacional Windows

Ações Pressione

Salvar a configuração atual Crtl+S

Fechar o IBM Cognos Configuration Alt+F4

Renomear o item selecionado F2

Exibir o menu Arquivo Alt+F

Exibir o menu Editar Alt+E

Exibir o menu Visualizar Alt+V

Exibir o menu Ações Alt+A

Exibir o menu Ajuda Alt+H

A tabela a seguir lista os atalhos de teclado que podem ser usados para executaralgumas das principais tarefas no IBM Cognos Configuration em um sistemaoperacional UNIX ou Linux.

Tabela 75. Lista de Atalhos de Teclado para o IBM Cognos Configuration em um SistemaOperacional UNIX ou Linux

Ações Pressione

Salvar a configuração atual Crtl+S

Fechar o IBM Cognos Configuration Alt+F4

Renomear o item selecionado F2

338 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 351: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Apêndice B. Opções da Linha de Comandos do IBM CognosConfiguration

Use as opções da linha de comandos com o comando de configuração paramodificar o comportamento do IBM Cognos Configuration quando ele for iniciado.

Tabela 76. Opções e Descrições da Linha de Comandos

Opção Descrições

-h Exibe os comandos para IBM CognosConfiguration.

-s Executa o IBM Cognos Configuration nomodo silencioso.

Usa valores de propriedade especificados noarquivo cogstartup.xml para configurarcomponentes instalados e, em seguida, iniciatodos os serviços.

./cogconfig.sh -s

cogconfig.bat -s

-stop Para todos os serviços do IBM Cognos.

./cogconfig.sh -stop

cogconfig.bat -stop

-startupfile path/filename.xml Executa o IBM Cognos Configurationusando um arquivo diferente do arquivocogstartup.xml no diretórioc10_location/configuration.

-test Usa os valores de propriedade especificadosno arquivo cogstartup.xml para testar asdefinições de configuração.

./cogconfig.sh -test

cogconfig.bat -test

-notest Inicia o IBM Cognos Configuration com astarefas de teste automáticas desativadas.

./cogconfig.sh -notest

cogconfig.bat -notest

Esta opção não deve ser usada para aprimeira vez que você inicia o produto ou sevocê estiver fazendo mudanças naconfiguração.

-utf8 Salva a configuração na codificação UTF-8.

./cogconfig.sh -s -utf8

cogconfig.bat -s -utf8

© Copyright IBM Corp. 2005, 2014 339

Page 352: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Tabela 76. Opções e Descrições da Linha de Comandos (continuação)

Opção Descrições

-l language ID Executa o IBM Cognos Configurationusando o idioma especificado peloidentificador de idioma.

Para executar a ferramenta de configuraçãoem modo silencioso usando chinêssimplificado

./cogconfig.sh -l zh-cn

cogconfig.bat -l zh-cn

-e filename.xml Exporta as definições de configuração atualpara o arquivo especificado.

./cogconfig.sh -e filename.xml

cogconfig.bat -e filename.xml

-log Cria um arquivo do log de erroscogconfig.timestamp.log no diretóriocognos_location/logs.

./cogconfig.sh -log

cogconfig.bat -log

-java:{local|env} Executa o IBM Cognos Configuration nossistemas operacionais do Microsoft Windowsusando o Java Runtime Environment versãoque é definido como

v env: ambientalmente usando a variável deambiente JAVA_HOME

v local: localmente a partir do diretórioc10_location/bin/jre

Caso este sinalizador não seja configurado, oIBM Cognos usará a configuração davariável de ambiente JAVA_HOME.

Para executar o IBMCognos Configurationem modo silencioso, usando a JVM local,digite o seguinte comando:

./cogconfig.sh -s -java:local

cogconfig.bat -s -java:local

É possível usar mais de uma opção de linha de comandos por vez. Por exemplo, épossível executar o IBM Cognos Configuration no modo silencioso e enviar todasas mensagens de erro para um arquivo de log.

340 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 353: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Apêndice C. Resolução de problemas

Use essas informações de referência de resolução de problemas e essas soluçõescomo um recurso para ajudá-lo a resolver problemas específicos que podem serencontrados durante a instalação dos componentes do IBM Cognos BusinessIntelligence.

Os problemas se caracterizam por seus sintomas. Cada sintoma pode ser rastreadopara uma ou mais causas utilizando ferramentas e técnicas específicas de soluçãode problemas. Após identificado, o problema pode ser solucionado através daimplementação de uma série de ações.

Durante a solução de problemas, os arquivos de log podem ajudar. Outra valiosaferramenta de resolução de problemas é a Base de Conhecimento, que estádisponível no Portal de Suporte IBM (http://www-01.ibm.com/software/analytics/support/finding-answers/kb.html). A Base de Conhecimento é um bancode dados de problemas e soluções para todos os produtos IBM Cognos.

Quando não puder solucionar um problema, o recurso final é seu representante desuporte técnico. Para analisar um problema, o representante do suporte técniconecessita 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 emcontato com o representante.

Resolvendo um ProblemaResolução de problemas é uma abordagem sistemática para resolver um problema. Oobjetivo da resolução de problemas é determinar por que algo não funciona comoo esperado e como resolver o problema.

A primeira etapa no processo de resolução de problemas é descrever o problemacompletamente. As descrições de problema ajudam você e o representante desuporte técnico da IBM a saber onde começar a procurar a causa do problema. Estaetapa inclui perguntar a si mesmo questões básicas:v Quais são os sintomas do problema?v Onde o problema ocorre?v Quando o problema ocorre?v Sob quais condições o problema ocorre?v O problema pode ser reproduzido?

As respostas a estas questões geralmenthe levam a uma boa descrição doproblema, que pode então, levar a uma resolução do problema.

Quais são os sintomas do problema?

Quando começar a descrever um problema, a questão mais óbvia é “Qual é oproblema?” Esta questão pode parecer direta, no entanto, é possível dividi-la emvárias questões focadas que criam uma imagem mais descritiva do problema. Estasquestões podem incluir:v Quem, ou o que, está relatando o problema?v Quais são os códigos e mensagens de erro?

© Copyright IBM Corp. 2005, 2014 341

Page 354: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

v Como o sistema falha? Por exemplo, o problema é um loop, uma interrupção,um travamento, uma degradação de desempenho ou um resultado incorreto?

Onde o problema ocorre?

Determinar onde o problema se origina nem sempre é fácil, mas é uma das etapasmais importantes na resolução de um problema. Muitas camadas de tecnologiapodem existir entre os componentes de relatório ou com falha. Redes, discos edrivers são apenas alguns dos componentes a se considerar ao investigarproblemas.

As seguintes questões ajudam a isolar a camada do problema:v O problema é específico a uma plataforma ou sistema operacional ou é comum

entre diversas plataformas ou sistemas operacionais?v O ambiente e a configuração atuais são suportados?

Se uma camada relatar o problema, o problema não necessariamente se originanessa camada. Parte da identificação de onde um problema se origina é entender oambiente no qual ele existe. Reserve um tempo para descrever completamente oambiente do problema, incluindo o sistema operacional e a versão, todos ossoftwares e versões correspondentes e o hardware. Confirme que está executandoem um ambiente que seja suportado; muitos problemas podem ser rastreados devolta a níveis incompatíveis de software que não são destinados a executar juntosou não foram testados juntos totalmente.

Quando o problema ocorre?

O desenvolvimento de uma linha de tempo detalhada leva a uma falha,especialmente para casos que são ocorrências únicas. É possível desenvolver maisfacilmente uma linha de tempo trabalhando em retrocesso: inicie no horário queum erro foi relatado (o mais preciso possível, mesmo cada milissegundo) e trabalheem retrocesso por meio dos logs e informações disponíveis. Geralmente, énecessário observar apenas o alcance do primeiro evento suspeito que localizar emum log de diagnóstico.

Para desenvolver uma linha de tempo de eventos detalhada, responda estasquestões:v O problema acontece apenas em um determinado horário do dia ou da noite?v Com que frequência o problema acontece?v Que sequência de eventos leva ao horário que o problema é relatado?v O problema acontece após uma mudança de ambiente, como um upgrade ou

uma instalação de software ou hardware?

Sob quais condições o problema ocorre?

Saber quais sistemas e aplicativos estão em execução no horário que um problemaocorre é uma parte importante da resolução de problemas. Essas questões sobreseu ambiente podem ajudar a identificar a causa do problema:v O problema sempre ocorre quando a mesma tarefa está sendo executada?v Uma certa sequência de eventos precisa ser feita para que o problema ocorra?v Outros aplicativos falham ao mesmo tempo?

Responder estes tipos de questões pode ajudar a explicar o ambiente no qual oproblema ocorre e correlacionar quaisquer dependências. Lembre-se de que

342 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 355: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

somente porque diversos problemas podem ter ocorrido mais ou menos no mesmohorário, os problemas não são necessariamente relacionados.

O problema pode ser reproduzido?

Os problemas que podem ser reproduzidos geralmente são mais fáceis de resolver.Entretanto, os problemas que podem ser reproduzidos podem ter umadesvantagem. Se o problema tiver um impacto significativo nos negócios, você nãodeseja que ele ocorra novamente. Se possível, crie novamente o problema em umambiente de teste ou desenvolvimento, que normalmente oferece mais flexibilidadee controle durante sua investigação. Responda às questões a seguir:v O problema pode ser recriado em um sistema de teste?v Diversos usuários ou aplicativos estão encontrando o mesmo tipo de problema?v O problema pode ser recriado executando um único comando, um conjunto de

comandos ou um determinado aplicativo?

Procurando em Bases de ConhecimentoÉ possível localizar soluções com frequência procurando nas bases deconhecimento IBM. É possível otimizar seus resultados usando recursosdisponíveis, ferramentas de suporte e métodos de procura.

Sobre Esta Tarefa

É possível localizar informações úteis procurando no centro de informações doIBM Cognos, mas às vezes é necessário ver além do centro de informações pararesolver problemas.

Procedimento

Para procurar as informações de que precisa nas bases de conhecimento, use umaou mais das seguintes abordagens:v Localize o conteúdo necessário usando o IBM Support Portal.

O IBM Support Portal é uma visualização unificada e centralizada de todas asferramentas de suporte técnico e informações para todos os sistemas, software eserviços IBM. O IBM Support Portal permite acessar o portfólio de suporteeletrônico IBM a partir de um local. É possível padronizar as páginas para focarnas informações e recursos necessários para prevenção de problemas e umaresolução de problemas mais rápida. Familiarize-se com o IBM Support Portalvisualizando os vídeos demo (https://www.ibm.com/blogs/SPNA/entry/the_ibm_support_portal_videos) sobre esta ferramenta. Esses vídeos apresentama você o IBM Support Portal, exploram outros a resolução de problemas e outrosrecursos e demonstram como é possível padronizar a página movendo,incluindo e excluindo portlets.

v Procure conteúdo sobre o IBM Cognos usando um dos seguintes recursostécnicos adicionais:– APARs do IBM Cognos BI (relatórios de problema)– Procurando notas técnicas.– Fóruns e comunidades do IBM Cognos.

v Procure conteúdo usando a procura de cabeçalho da IBM. É possível usar aprocura do cabeçalho principal da IBM digitando a sua sequência de procura nocampo Procura em qualquer página ibm.com.

v Procure conteúdo usando qualquer mecanismo de procura externo, comoGoogle, Yahoo ou Bing. Se usar um mecanismo de procura externo, é mais

Apêndice C. Resolução de problemas 343

Page 356: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

provável que seus resultados incluam informações que estejam fora do domínioibm.com. Entretanto, às vezes, é possível localizar informações úteis de soluçãode problema sobre produtos IBM em newsgroups, fóruns e blogs que nãoestejam no ibm.com.

Dica: Inclua “IBM” e o nome do produto em sua procura se estiver procurandoinformações sobre um produto IBM.

Obtendo CorreçõesUma correção de produto pode estar disponível para resolver seu problema.

Procedimento

Para localizar e instalar correções:1. Determine qual correção é necessária (Fix Central) (abre na nova janela)

(http://www.ibm.com/support/fixcentral/)2. Faça download da correção. Abra o documento de download e siga o link na

seção “Pacote de Download”.3. Aplique a correção seguindo as instruções na seção “Instruções de Instalação”

do documento de download.4. Assine para receber notificações por e-mail semanalmente sobre correções e

outras informações do Suporte IBM.

Entrando em Contato com o Suporte IBMO suporte IBM fornece acesso a uma variedade de recursos IBM para ajuda comquestões de software.

Antes de Iniciar

Após tentar localizar sua resposta ou solução usando outras opções de autoajudacomo notas técnicas, é possível entrar em contato com o Suporte IBM. Antes deentrar em contato com o Suporte IBM, sua empresa deve ter um contrato demanutenção ativo da IBM e você deve ser autorizado a enviar problemas à IBM.Você também deve ter as seguintes informações em mãos:v Seu número de identificação de cliente.v Seu número de solicitação de serviço, se for uma solicitação de serviço em

progresso.v O número de telefone onde você pode ser encontrado.v A versão do software utilizada.v A versão do ambiente operacional usada.v Uma descrição do que estava fazendo quando o problema ocorreu.v O que as mensagens de erro exibidas dizem, exatamente.v As ações tomadas para tentar resolver o problema.

Para obter informações sobre os tipos de suporte disponíveis, consulte o tópicoPortfólio de Suporte no Software Support Handbook (abre na nova janela).

Procedimento

Conclua as seguintes etapas para entrar em contato com o Suporte IBM com umproblema:

344 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 357: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

1. Defina o problema, reúna informações complementares e determine agravidade do problema. Para obter informações adicionais, consulte o tópicoObtendo o Suporte IBM (abre na nova janela) no Software Support Handbook.

2. Reúna as informações de diagnóstico.3. Envie o problema para o Suporte IBM de uma das seguintes formas:

v Usando o IBM Support Assistant (ISA): Use este recurso para abrir, atualizare visualizar uma Solicitação de Serviço Eletrônica com a IBM. Quaisquerdados que tenham sido coletados podem ser conectados à solicitação deserviço. Isso agiliza a análise e reduz o tempo para resolução.

v Online através do IBM Support Portal (abre na nova janela): é possível abrir,atualizar e visualizar todas as Solicitações de Serviço a partir do portletSolicitação de Serviço na página Solicitação de Serviço.

v Por telefone: para obter o número do telefone a ser chamado, consulte apágina da web Diretório de Contatos no Mundo Todo (abre na nova página).

Resultados

Se o problema que enviou for um defeito de software ou documentação ausente ouinexata, o Suporte IBM cria um Authorized Program Analysis Report (APAR). OAPAR descreve o problema em detalhes. Sempre que possível, o Suporte IBMfornece uma solução alternativa que é possível de ser implementada até que oAPAR seja resolvido e uma correção seja entregue. A IBM publica APARsresolvidos no Web site de suporte IBM diariamente, para que outros usuários quetêm o mesmo problema possam se beneficiar da mesma resolução.

Trocando Informações com a IBMPara diagnosticar ou identificar um problema, talvez seja necessário fornecer aoSuporte IBM dados e informações do seu sistema.

Em outros casos, o Suporte IBM pode fornecer ferramentas ou utilitários para usarpara determinação de problema.

Enviando Informações ao Suporte IBMPara reduzir o tempo que leva para resolver seu problema, é possível enviarinformações de rastreio e diagnóstico ao Suporte IBM.

Procedimento

Para enviar informações de diagnóstico ao Suporte IBM:1. Abra um problem management record (PMR). É possível usar o IBM Support

Assistant (abre na nova janela) ou a ferramenta IBM Service Request (abre nanova janela).

2. Colete os dados diagnósticos necessários. Os dados diagnósticos ajudam areduzir o tempo que leva para resolver seu PMR. É possível coletar os dadosdiagnósticos manual ou automaticamente.

3. Compacte os arquivos usando o programa TRSMAIN ou AMATERSE. Façadownload do utilitário gratuito da IBM para o sistema IBM Cognos BI e, emseguida, instale o utilitário usando o comando TSO RECEIVE.

4. Transfira os arquivos para a IBM. É possível usar um dos seguintes métodospara transferir os arquivos para a IBM:v A ferramenta Service Request (abre na nova janela)v Métodos de upload de dados padrão: FTP, HTTPv Métodos seguros de upload de dados: FTPS, SFTP, HTTPS

Apêndice C. Resolução de problemas 345

Page 358: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

v E-mailSe você estiver usando um produto IBM Cognos e usar ServiceLink / IBMLinkpara enviar PMRs, poderá enviar dados diagnósticos para o suporte IBM emum e-mail ou usando FTP.Todos esses métodos de troca de dados são explicados no site de Suporte IBM(abre na nova janela).

Recebendo Informações do Suporte IBMOcasionalmente, um representante de suporte técnico da IBM pode pedir que façadownload das ferramentas de diagnóstico ou de outros arquivos. É possível usarFTP para fazer download desses arquivos.

Antes de Iniciar

Certifique-se de que seu representante de suporte técnico da IBM tenha fornecido oservidor preferencial para usar para o download dos arquivos e os nomes exatosdo diretório e do arquivo para acessar.

Procedimento

Para fazer download desses arquivos a partir do Suporte IBM:1. Use FTP para conectar ao site que seu representante de suporte técnico da IBM

forneceu e efetue login como anonymous. Use seu endereço de e-mail como asenha.

2. Altere para o diretório apropriado:a. Altere para o diretório /fromibm.

cd fromibm

b. Altere para o diretório que seu representante de suporte técnico da IBMforneceu.cd nameofdirectory

3. Ative o modo binário para sua sessão.binary

4. Use o comando get para fazer download do arquivo que seu representante desuporte técnico da IBM especificou.get filename.extension

5. Encerre a sessão FTP.quit

Assinando Atualizações de SuportePara se manter informado sobre informações importantes sobre os produtos IBMque usar, é possível assinar as atualizações.

Sobre Esta Tarefa

Ao assinar para receber atualizações, é possível receber informações técnicasimportantes e atualizações para ferramentas e recursos específicos do Suporte. Épossível assinar atualizações usando uma das duas abordagens:

Alimentações RSS e assinaturas de mídia socialAs seguintes alimentações RSS e assinaturas de mídia social estãodisponíveis para o IBM Cognos BI:v Feed RSS para um fórum do developerWorks (abre em nova janela).

346 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 359: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

v Feed de RSS para o site do Suporte para o IBM Cognos BusinessIntelligence (abre em nova janela)

Para obter informações gerais sobre RSS, incluindo as etapas de introduçãoe uma lista de páginas da web da IBM ativadas por RSS, visite o site FeedsRSS de Suporte de Software IBM (abre na nova janela).

Minhas NotificaçõesCom o My Notifications, é possível assinar atualizações de Suporte paraqualquer produto IBM. É possível especificar que deseja recebercomunicados por e-mail diária ou semanalmente. É possível especificar quetipo de informações deseja receber, como publicações, dicas e sugestões,atualizações de produtos (também conhecidos como alertas), downloads edrivers. O My Notifications permite customizar e categorizar os produtossobre os quais deseja ser informado e os métodos de entrega que mais bemse adequam a suas necessidades.

Procedimento

Para assinar atualizações do Suporte:1. Assine as alimentações RSS do Product.2. Para assinar em Minhas Notificações, inicie acessando o IBM Support Portal

(abre na nova janela) e clicando em Minhas Notificações no portletNotificações.

3. Se já tiver se registrado no My support, efetue sign in e pule para a próximaetapa. Se ainda não tiver se registrado, clique em Registrar agora. Conclua oformulário de registro usando seu endereço de e-mail como seu ID IBM eclique em Enviar.

4. Clique em Editar perfil.5. Clique em Incluir produtos e escolha uma categoria de produto; por exemplo,

Software.6. Na segunda lista, selecione um segmento de produto; por exemplo,

Gerenciamento de Dados & Informações.7. Na terceira lista, selecione um subsegmento de produto; por exemplo, Bancos

de Dados.8. Selecione os produtos dos quais deseja receber atualizações.9. Clique em Incluir produtos.

10. Após selecionar todos os produtos que sejam do seu interesse, clique emAssinar por e-mail na guia Editar perfil.

11. Selecione Enviar estes documentos por e-mail semanalmente.12. Atualize seu endereço de e-mail conforme necessário.13. Na Lista de documentos, selecione a categoria do produto; por exemplo,

Software.14. Selecione os tipos de documentos dos quais deseja receber informações.15. Clique em Atualizar.

Resultados

Até que modifique suas preferências de alimentação RSS e do My Notifications,você receberá notificações de atualizações que solicitou. É possível modificar suaspreferências quando necessário (por exemplo, se parar de usar um produto ecomeçar a usar outro).

Apêndice C. Resolução de problemas 347

Page 360: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Arquivos de logOs arquivos de log podem ajudá-lo a resolver problemas registrando as atividadesque acontecem ao trabalhar com um produto.

Operações executadas no IBM Cognos BI são registradas em vários arquivos de logpara fins de rastreamento. Por exemplo, se você enfrentar problemas com ainstalação do IBM Cognos BI, consulte o arquivo de log de transferência para saberquais atividades o assistente de instalação executou durante a transferência dearquivos.

Antes de começar a visualizar os arquivos de log, certifique-se de que eles contêmas informações de que precisa. O número de arquivos de log e as informaçõescontidas por eles são configurados pelos parâmetros no IBM Cognos Connection eno IBM Cognos Configuration.

Use o IBM Cognos Administration para configurar o nível de detalhes pararegistrar para cada categoria.

Para obter informações adicionais, consulte o Guia de Administração e Segurança doIBM Cognos Business Intelligence.

Use IBM Cognos Configuration para especificar o tamanho, o número e o local dosarquivos de log e para configurar as propriedades do servidor de log.

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

O arquivo de transferência de log está localizado no diretório de logc10_location\instlog. O nome do arquivo identifica o nome, a versão e o númeroda construção do produto, e possui um carimbo de data/hora. A seguir, umexemplo 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ções de espaço emdisco, as seleções realizadas em diálogos de transferência e qualquer erro que oassistente de instalação encontrou ao transferir os componentes.

O arquivo de log de erro de resumo está no c10_location/instlog. O nome doarquivo identifica o nome, a versão e o número da construção do produto, e possuium 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 depropriedades são salvas. O nome de arquivo é cogstartup.xml.

348 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 361: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Se não conseguir salvar suas configurações, ou se estiver tendo problemas épossível reverter para um arquivo de configuração previamente salvo. Os arquivosde configuração de backup estão localizados no diretório c10_location/configuration. A seguir, um exemplo do formato de nome de arquivo para obackup dos arquivos de configuração:

cogstartup_200811231540.xml

Arquivo de bloqueio da configuração da inicialização

Esse arquivo é criado cada vez que você abre o IBM Cognos Configuration. Issoevita que você abra mais de uma janela do IBM Cognos Configuration.

Se tiver problemas para abrir IBM Cognos Configuration, é possível verificar odiretório c10_location/configuration para o arquivo cogstartup.lock. Se oarquivo existir e o IBM Cognos Configuration não estiver aberto, isso significa queo IBM Cognos Configuration não foi encerrado corretamente na última vez quevocê o usou. É possível excluir o arquivo de bloqueio e abrir o IBM CognosConfiguration.

O arquivo de configuração de código do idioma

Esse arquivo registra as opções de configuração feitas no IBM CognosConfiguration para códigos do idioma de produto e conteúdo, mapeamento delocalidade e suporte à moeda.

Se tiver problemas com o suporte ao idioma na interface com o usuário ou emrelatórios, use esses arquivos para controlar as mudanças. Os arquivos deconfiguração de backup estão localizados no diretório c10_location/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, denominado de arquivo cogserver.logou outros arquivos de log configurados para receber mensagens de log do servidorde log, registram informações após iniciar o serviço do IBM Cognos BI. Eles estãolocalizados no diretório c10_location/logs. Se foi configurado outro destino paraas mensagens de log, verifique o arquivo ou banco de dados adequado.

Algumas mensagens de log indicam problemas. A maioria das mensagens somentefornece informações, mas outras podem ajudá-lo a diagnosticar problemas em seuambiente de tempo de execução.

Arquivo de log do gateway

Os gateways registram erros no arquivo de log do gateway, localizado no diretórioc10_location/logs.

É possível usar o arquivo de log do gateway para solucionar problemas queevitam que o gateway processe solicitações ou use criptografia. Os sintomas dessesproblemas são os seguintes:v IDs e senhas dos usuários não funcionam.v A conexão única não funciona.

Apêndice C. Resolução de problemas 349

Page 362: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

v O dispatcher está em execução, mas os usuários recebem uma mensagem de erroavisando que o servidor IBM Cognos BI não está disponível.

O arquivo de log do gateway usa o seguinte formato de nomenclatura, ondegateway_interface é cgi, 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 aodesinstalar os arquivos. O arquivo de log é chamado de cognos_uninst_log.htm eestá localizado no diretório Temp. É possível usar o arquivo de log para solucionarproblemas 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 executoudurante a execução no modo silencioso. Este arquivo de log é chamado decogconfig_response.csv e está localizado no diretório c10_location/logs.

Não é Possível Executar issetup em Sistemas Operacionais LinuxExecute issetup para instalar o IBM Cognos BI, mas você receberá a mensagem deerro a seguir: Error while loading shared libraries: libXm.so.4: cannot openshared object file: No such file or directory.

Procedimento1. Acesse o diretório /usr/lib.2. Criar um link simbólico para outra versão de libXm.so nomeie o link simbólico

libXm.so.4.Por exemplo, crie um link simbólico para libXm.so.3 conforme mostrado noseguinte comando:ln -s libXm.so.3 libXm.so.4

3. Execute o issetup novamente.

Problemas ao Iniciar o IBM Cognos Business IntelligenceÉ possível executar as seguintes tarefas ao encontrar problemas ao iniciar o IBMCognos Business Intelligence.

É possível que se depare com problemas ao:v iniciar o serviço do IBM Cognos BIv abrir a página de boas vindas para o portal do IBM Cognos BI pela primeira vezv iniciar um servidor de aplicativos, como o WebLogic ou o WebSphere

A tabela a seguir mostra alguns sintomas comuns e suas soluções.

Tabela 77. Sintomas e Soluções Sugeridas para Iniciar o IBM Cognos Business Intelligence

Sintomas Solução

Você não vê a tela inicial do portal do IBMCognos BI quando inicia o IBM Cognos BI.

Verifique as configurações do servidor web.

350 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 363: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Tabela 77. Sintomas e Soluções Sugeridas para Iniciar o IBM Cognos BusinessIntelligence (continuação)

Sintomas Solução

O serviço inicia, mas nenhuma tabela écriada no banco de dados dearmazenamento de conteúdo.

Verifique as configurações doarmazenamento de conteúdo.

O serviço não inicia. Certifique-se de aguardar alguns momentosantes de enviar uma solicitação.

O servidor de aplicativo não inicia. Verifique as permissões de arquivo e osnomes de diretórios do local de instalaçãodo servidor de aplicativos.

Para revisar uma lista atualizada de ambientes suportados pelos produtos IBMCognos Business Intelligence, incluindo informações sobre sistemas operacionais,correções, navegadores, servidores da web, servidores de diretórios, servidores debanco de dados e servidores de aplicativos, consulte a página Relatórios deCompatibilidade de Produto IBM Software (www.ibm.com/support/docview.wss?uid=swg27042164).

CFG-ERR-0106 Erro ao Iniciar o Serviço do IBM Cognos noIBM Cognos Configuration

Ao iniciar o serviço do IBM Cognos Business Intelligence, você recebe a mensagemde erro CFG-ERR-0106.

A mensagem de erro aparece como:v CFG-ERR-0106. IBM Cognos Configuraton received no response from the IBM

Cognos service in the allotted time. Check that the IBM Cognos service isavailable and properly configured.

v Unable to start IBM Cognos service. Execution of the external processreturns an error code value of ’-1’.

Existem três possíveis causas para esse problema:v O serviço IBM Cognos precisa de mais tempo para iniciar.v Um computador Content Manager em espera está configurado incorretamente.v Uma versão de 32 bits do IBM Cognos BI foi instalada com relação a uma versão

de 64 bits do Java.

Alterando o Tempo de Espera para o Serviço do IBM CognosSe você recebeu o erro CFG-ERR-0106 porque o serviço do IBM Cognos precisa demais tempo para iniciar, altere a quantidade de tempo que o IBM CognosConfiguration aguarda para receber uma resposta do serviço do IBM Cognos.

Por padrão, o IBM Cognos Configuration verifica o progresso da solicitação deinicialização a cada meio segundo durante três minutos. Se o IBM CognosConfiguration não receber uma resposta dentro desse período de tempo, amensagem de erro será exibida.

A quantidade de tempo que o IBM Cognos Configuration aguarda para receberuma resposta do serviço do IBM Cognos é controlada pelas propriedadesServiceWaitInterval e ServiceMaxTries.

Apêndice C. Resolução de problemas 351

Page 364: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

A propriedade ServiceWaitInterval representa o intervalo de tempo, emmilissegundos, em que o IBM Cognos Configuration verifica o progresso dasolicitação de inicialização. Por padrão, seu valor é 500, que é equivalente a meiosegundo.

A propriedade ServiceMaxTries representa o número de vezes que o IBM CognosConfiguration verifica o progresso da solicitação de inicialização. Por padrão, ovalor é 360.

Procedimento1. 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 CognosConfiguration for aberto.

3. Adicione os seguintes códigos ao arquivo:ServiceWaitInterval=number of milliseconds

ServiceMaxTries=number of times

Dica: Inclua os valores numéricos que correspondem às suas necessidades deconfiguração.

4. Salve o arquivo.5. Usando o IBM Cognos Configuration, inicie o serviço do IBM Cognos.

Alterando o Local em que as Chaves Simétricas EstãoArmazenadasSe você recebeu o erro CFG-ERR-0106 em um computador com Content Managerem espera, configure o computador para armazenar as chaves simétricaslocalmente.

A configuração para armazenamento das chaves simétricas pode estar incorreta.

Procedimento1. No computador com Content Manager em espera, inicie o IBM Cognos

Configuration.2. Na janela Explorer, em Segurança, clique emCriptografia.3. Na janela Propriedades, em Configurações CSK, defina Armazenar chave

simétrica localmente para Verdadeiro.4. No menu Arquivo, clique em Salvar.5. No menu Ações, clique em Iniciar.

Esta ação inicia todos os serviços instalados que não estiverem em execução.Caso deseje iniciar determinado serviço, selecione o nó do serviço na janela doExplorer e clique em Iniciar no menu Ações.

Usando uma Versão Apropriada de JavaSe você recebeu o erro CFG-ERR-0106 porque uma versão de 32 bits do serviçoIBM Cognos Business Intelligence foi instalada em relação a uma versão de 64 bitsda Java, você deve renomear JAVA_HOME ou configurá-lo para apontar para umaversão de 32 bits suportada da Java.

Uma versão de 32 bits do serviço IBM Cognos BI deve ser instalada em relação auma versão de 32 bits compatível daJava. Não é possível configurar uma versão de32 bits do serviço IBM Cognos BI para executar em relação a uma versão de 64 bitsda Java.

352 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 365: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Antes de Iniciar

Para revisar uma lista atualizada de ambientes suportados pelos produtos IBMCognos Business Intelligence, incluindo informações sobre sistemas operacionais,correções, navegadores, servidores da web, servidores de diretórios, servidores debanco de dados e servidores de aplicativos, consulte a página Relatórios deCompatibilidade de Produto IBM Software (www.ibm.com/support/docview.wss?uid=swg27042164).

Procedimento1. Apesar de não ter iniciado adequadamente, pare o serviço IBM Cognos, e saia

da ferramenta IBM Cognos Configuration.2. Exclua o conteúdo do diretório C10_location\temp.3. Execute uma das seguintes etapas:

v Renomeie JAVA_HOMEv Configure JAVA_HOME para apontar para uma versão de 32 bits suportada

da Java.4. Se necessário, reinicie seu computador.5. No IBM Cognos Configuration, inicie o serviço IBM Cognos.

Erro Criptográfico ao Iniciar o IBM Cognos BusinessIntelligence

Se o seguinte erro ocorrer quando você tentar iniciar o serviço do IBM CognosBusiness Intelligence depois de instalar componentes do servidor ou do cliente, seuJava Runtime Environment (JRE) não terá as rotinas de criptografia e dedecriptografia.

Se receber este erro, você deverá copiar o arquivo Java Archive (.jar) fornecido parao JRE director, pois ele é requerido pelo IBM Cognos BI.[Cryptography]1. [ ERROR ] java.lang.NoClassDefFoundError:javax/net/ServerSocketFactory:

Seu Java Runtime Environment (JRE) não contém as rotinas de criptografia e dedecriptografia que são requeridas pelo IBM Cognos BI. Você deve copiar o arquivoJava Archive (.jar) fornecido para o diretório do JRE.

Procedimento

Copie bcprov-jdkversion.jar do diretório c10_location/bin/jre/version/lib/extno diretório JRE_location/lib/ext.Se estiver usando componentes de 64 bits, copie os arquivos doc10_location/bin64.

Não É Possível Iniciar o Serviço do IBM Cognos Porque aPorta Está Sendo Usada por Outro Processo

Talvez você não possa iniciar o serviço ou processo do IBM Cognos BusinessIntelligence se uma das portas padrão for usada por outro processo.

Dica: Para visualizar as conexões de rede TCP/IP da rede atual, use o comandonetstat.

Apêndice C. Resolução de problemas 353

Page 366: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Use o IBM Cognos Configuration para alterar a porta padrão usada pelo IBMCognos BI.

Ao alterar a porta usada pelo dispatcher local, você deve alterar o valor daspropriedades do URI do dispatcher. Você deve alterar os URI de todos oscomponentes locais devido ao fato da mudança afetar todos os URI baseados nodispatcher local. Por padrão, os componentes locais possuem um localhost no URI.

Por exemplo, se instalar todos os componentes em um computador e quiser alterara porta do dispatcher, substitua 9300 em todos os URIs de dispatcher e do ContentManager pelo novo número de porta.

Procedimento1. Inicie o IBM Cognos Configuration.2. Na janela Explorer, clique no grupo ou componente apropriado:

v Para acessar o número de porta nos URIs de dispatcher e de ContentManager, clique em Ambiente.

v Para acessar o número de porta do servidor de log local, sob Ambiente,clique em Criação de log.

v Para acessar o número da porta de encerramento, em Ambiente, clique emServiços do IBM Cognos > IBM Cognos BI.

v Para acessar o número da porta para o local do arquivo applications.xmlusado pelo Portal Services, em Ambiente, clique em Portal Services.

3. Na janela Propriedades, clique na caixa Valor próxima à propriedade quedeseja alterar.

4. Altere o valor de 9300 para o novo valor.Certifique-se de alterar as portas em todos os URIs que contenhamlocalhost:9300.

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

O Serviço do IBM Cognos não Inicia ou Falha após IniciarVocê iniciou o serviço IBM Cognos Business Intelligence, mas os serviços não sãoiniciados corretamente ou são muito lentos para serem iniciados. O sistema falhapouco tempo depois da inicialização do sistema. Enquanto os serviços estãoiniciando, o Java usa 100 por cento do tempo de CPU.

Também poderão aparecer várias ocorrências das seguintes mensagens de erro:v DPR-DPR-1035 O dispatcher detectou um erro.

v CAM-CRP-1157 Impossível sincronizar o arquivo local da chave simétrica comum como Content Manager.

Procedimento

Se você usa um banco de dados DB2 para armazenamento de conteúdo,certifique-se de que a versão do banco de dados e a versão de Java sejamcompatíveis.Para DB2 versão 8.2, Java 1.5 não é suportado. Para o DB2 versão 9, o Java 1.5 ésuportado em todos os sistemas operacionais, exceto no HP-UX e Solaris.

354 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 367: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Servidor IBM Cognos Business Intelligence Falha ao Iniciar eNão Fornece Mensagem de Erro

Um servidor IBM Cognos BI pode falhar ao iniciar após um upgrade ou uma novainstalação, mas nenhuma mensagem de erro é exibida. Isso pode ocorrer quandoum servidor IBM Cognos BI novo ou anteriormente em execução estiverconfigurado para usar uma grande quantidade de memória.

Se o servidor no qual o IBM Cognos BI está instalado contiver a versão 1.0 daatualização de segurança 921883 do Microsoft, pode ocorrer um problema quandouma grande quantidade de memória contígua for solicitada pelo aplicativo.

Esse é um problema conhecido da versão 1.0 da correção de segurança 921883 daMicrosoft. A Microsoft distribuiu uma segunda versão da correção para corrigir oproblema. Como alternativa, desinstale a primeira correção de segurança ou instalea versão 2.0. Alternativamente, é possível configurar o servidor IBM Cognos BIpara usar menos memória.

Para obter mais informações, consulte o artigo da base de conhecimento daMicrosoft sobre programas usando uma grande quantidade de memória contíguacom falha no Web site de suporte da Microsoft.

Servidor Não Disponível ao Iniciar o IBM Cognos BusinessIntelligence

Após configurar os componentes do IBM Cognos e iniciar os serviços do IBMCognos, quando você se conecta ao portal do IBM Cognos Business Intelligence, aseguinte mensagem de erro pode aparecer:

O Cognos Gateway não pode 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 registro do servidor IBM Cognos para obter maisinformações. Por padrão, o arquivo cogserver.log está localizado no diretórioc10_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 deconteúdo se este último não estiver configurado corretamente. Isso pode ocorrer se:v O armazenamento de conteúdo usa uma codificação de caracteres incompatível.v O armazenamento de conteúdo usa uma sequência de ordenação de banco de

dados que faz distinção entre maiúsculas e minúsculas.v As definições de configuração especificadas no IBM Cognos Configuration não

são válidas

Codificação de Caracteres Não Suportada

Se as seguintes mensagens forem exibidas no arquivo de log, o banco de dadoscriado para o armazenamento de conteúdo não usa uma codificação de caracterescompatível:v Para Oracle:

CM-CFG-5063 Foi detectado um erro de configuração do Content Manager durante aconexão ao armazenamento de conteúdo.

Apêndice C. Resolução de problemas 355

Page 368: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

CM-SYS-5121 O Content Manager não pode ser iniciado porque o conjunto decaracteres do banco de dados do armazenamento de conteúdo não é suportado.CM-SYS-5126 O servidor banco de dados de armazenamento de conteúdo usa oconjunto de caracteres US7ASCII.CM-SYS-5125 O cliente banco de dados de armazenamento de conteúdo usa o conjuntode caracteres US7ASCII.

v Para DB2 UDB:CM-CFG-5063 Foi detectado um erro de configuração do Content Manager durante aconexão ao armazenamento de conteúdo.CM-SYS-5121 O Content Manager não pode ser iniciado porque o conjunto decaracteres do banco de dados do armazenamento de conteúdo não é suportado.CM-SYS-5124 O servidor de banco de dados de armazenamento de conteúdo usa apágina de códigos US7ASCII.

v Para Sybase:CM-CFG-5063 Foi detectado um erro de configuração do Content Manager durante aconexão ao armazenamento de conteúdo.CM-SYS-5121 O Content Manager não pode ser iniciado porque o conjunto decaracteres do banco de dados do armazenamento de conteúdo não é suportado.

Para que o Content Manager conecte-se ao armazenamento de conteúdo, esteúltimo deve usar uma codificação de caracteres apropriada, conforme listado natabela a seguir.

Tabela 78. Codificação de caracteres usada pelo armazenamento de conteúdo paraconectar-se a um tipo de banco de dados específico

Banco de Dados Codificação de caracteres

Oracle 9i AL32UTF8

AL32UTF16

DB2 UDB Codeset UTF-8

Sybase ASE UTF-8

Microsoft SQL Server UTF8

UTF16

Para solucionar este problema, você deve recriar o banco de dados dearmazenamento de conteúdo usando a codificação de caracteres correta ouconverter a codificação de caracteres. Para obter mais informações, consulte adocumentação do banco de dados.

Sequência de Ordenação com Distinção entre Maiúsculas eMinúsculas

Se as seguintes mensagens forem exibidas no arquivo de log, o banco de dadoscriado para o armazenamento de conteúdo utiliza uma sequência de ordenação debanco de dados que faz distinção entre maiúsculas e minúsculas:

356 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 369: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

CM-CFG-5063 Foi detectado um erro de configuração do Content Manager durante aconexão ao armazenamento de conteúdo.

CM-SYS-5122 O banco de dados de armazenamento de conteúdo tem uma ordenaçãopadrão com distinção entre maiúsculas e minúsculas. O Content Manager requer umarmazenamento de conteúdo que possua uma ordenação que faça a distinção de maiúsculase minúsculas.

CM-SYS-5123 O servidor de banco de dados de armazenamento de conteúdo usa aordenação de <parâmetro>.

CM-SYS-5007 A construção do Content Manager @cm_build_version@ falhou ao iniciar!Revise os arquivos de log do Content Manager e, em seguida, entre em contato com oadministrador do sistema ou suporte ao cliente.

Para solucionar este problema, você deve recriar o banco de dados dearmazenamento de conteúdo usando uma sequência de ordenação de banco dedados que não faça distinção entre maiúsculas e minúsculas. Para obter maisinformações, consulte a documentação do banco de dados.

Definições de Configuração Inválidas

Se a seguinte mensagem ou uma mensagem semelhante estiver no arquivo de log,você não configurou o armazenamento de conteúdo corretamente no IBM CognosConfiguration.v Para Microsoft SQL Server:

CM-CFG-5063 Foi detectado um erro de configuração do Content Manager durante aconexão ao armazenamento de conteúdo.CM-CFG-5036 Falha do Content Manager ao conectar-se com o armazenamento deconteúdo. A sequência de conexões é "jdbc:JSQLConnect://localhost:1433/cm".Falha de Logon:com.jnetdirect.jsql.x: Não é possível abrir o banco de dados solicitado nologin 'cm'. Falha de login. url:jdbc:JSQLConnect://localhost:1433/cm.

v Para DB2:CM-CFG-5063 Foi detectado um erro de configuração do Content Manager durante aconexão ao armazenamento de conteúdo.CM-SYS-5003 O Content Manager não pode acessar o armazenamento de conteúdo.Verifique os parâmetros de conexão com o banco de dados e entre em contato com oadministrador de banco de dados.[IBM][CLI Driver] SQL1013N O nome alternativo do banco de dados ou o nome dobanco de dados "CM123" não foi encontrado.

v Para Oracle:CM-CFG-5063 Foi detectado um erro de configuração do Content Manager durante aconexão ao armazenamento de conteúdo.CM-CFG-5036 Falha do Content Manager ao conectar-se com o armazenamento deconteúdo. A sequência de conexões é "jdbc:oracle:thin:@localhost:1521:pb1".ORA-01017: nome de usuário/senha inválido; logon negado.

v Para Sybase:CM-CFG-5063 Foi detectado um erro de configuração do Content Manager durante aconexão ao armazenamento de conteúdo.CM-CFG-5036 Falha do Content Manager ao conectar-se com o armazenamento deconteúdo. A sequência de conexões é "jdbc:sybase:Tds:localhost:5000/cm".JZ006: IOException obtida: java.net.ConnectException: Conexão negada: conectar.

Apêndice C. Resolução de problemas 357

Page 370: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Se estiver usando um banco de dados Oracle, não use caracteres ilegais, comosublinhado, no IBM Cognos Configuration para a propriedade Nome do Serviço.Se Nome do Serviço incluir caracteres ilegais, as tabelas não serão criadas no bancode dados de armazenamento de conteúdo quando o serviço do IBM Cognos foriniciado.

Configurando um Armazenamento de Conteúdo no IBM CognosConfigurationSe você recebeu um código de erro CM-CFG-5036 ou CM-CFG-5063, oarmazenamento de conteúdo pode não estar configurado corretamente.

Para resolver o problema, reconfigure o armazenamento de conteúdo (consulte“Configurando as Propriedades de Conexão do Banco de Dados para umArmazenamento de Conteúdo Microsoft SQL Server, Oracle, Informix ou Sybase”na página 86).Conceitos relacionados:“Configure a conectividade do banco de dados para o banco de dados dearmazenamento de conteúdo.” na página 72Se estiver usando um banco de dados diferente do Cognos Content Database, oIBM DB2 Advanced Workgroup Server Edition (da opção Configuração Rápida) ouMicrosoft SQL Server como o armazenamento de conteúdo, pode ser necessárioinstalar o software do cliente de banco de dados ou drivers Java DatabaseConnectivity (JDBC), ou ambos, em cada computador no qual o Content Managerfor instalado. Fazer isso permite que o Content Manager acesse o banco de dadosde armazenamento de conteúdo.

Não É Possível Efetuar Logon em um Namespace ao Usar oIBM Cognos Connection

Abra o IBM Cognos Business Intelligence por meio do IBM Cognos Connection.No entanto, ao tentar criar uma origem de dados e fazer logon em um namespace,as seguintes mensagens de erro são exibidas:v PRS-CSE-1255 Erro de exceção encontrado na decriptografia de dados.

v CAM-CRP-1064 Não é possível processar os dados PKCS #7 por causa de um errointerno. Razão: java.lang.IndexOutOfBoundsException.

Esse problema poderá ocorrer, se você não possuir permissões necessárias para osseguintes diretórios:v c10_location\configuration

v c10_location\configuration\csk

v c10_location\configuration\encryptkeypair

v c10_location\configuration\signkeypair

Ative as permissões de leitura e execução nesses diretórios listados para qualquerpessoa que deva iniciar o serviço do IBM Cognos.

Os Serviços do IBM Cognos Falham ao Reiniciar após umaIndisponibilidade da Rede

O IBM Cognos Bootstrap Service reinicia os serviços do IBM Cognos após umaindisponibilidade da rede.

Para instalações em que o WebSphere Application Server Liberty Profile padrão éusado e em que um endereço IP de rede é especificado no URI do dispatcher

358 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 371: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

interno, os serviços IBM Cognos podem não ser inicializados com êxito durante areinicialização. Nesse caso, reinicie manualmente os serviços após a rede serrestaurada.

Procedimento

Para resolver o problema, configure a propriedade URI de dispatcher interno noIBM Cognos Configuration para usar localhost ou o nome do host da rede.

Nenhum aviso de que a instalação da versão mais recenteatualizará automaticamente a versão mais antiga doarmazenamento de conteúdo

Você tem uma versão do IBM Cognos BI instalada em seu computador. Ocorre ainstalação de uma versão posterior em um novo local. O mesmo banco de dadosdo armazenamento de conteúdo é usado para as duas versões. Depois deconfigurar a versão mais recente e iniciar o serviço IBM Cognos, a versão maisantiga do IBM Cognos BI não funcionará mais porque todo o conteúdo éatualizado automaticamente.

Se desejar usar versões diferentes do IBM Cognos BI depois do upgrade,antes deinstalar a versão mais recente assegure-se de que,v foi realizado o backup do banco de dados em uso para o armazenamento de

conteúdov o backup foi restaurado em um novo local

Também é possível usar a ferramenta de implantação para importar todo oarmazenamento 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 sobreisto.

Falha no Download do RecursoSe o recurso de download falhar, isto pode ser causado por atualizações recentesdo Microsoft XMLHTTP, se você não tiver uma preferência de idioma definida noInternet Explorer.

Ao iniciar o Report Studio no Internet Explorer, as seguintes mensagens de errosão exibidas:

Falha no download do recurso especificado.

Procedimento

Para solucionar este problema, especifique uma preferência de idioma no InternetExplorer.

DB2 Retorna Erro SQL1224N ao se Conectar do AIXSe seu armazenamento de conteúdo for um banco de dados DB2 e você receberum erro SQL1224N no AIX, verifique o arquivo db2diag.log para obter informaçõesadicionais sobre o erro.

Apêndice C. Resolução de problemas 359

Page 372: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Se o erro incluir o código de razão 18, você pode precisar alterar a configuração doDB2 para aceitar mais conexões. Para obter mais informações, consulte as páginasde suporte do IBM DB2 para o erro SQL1224N.

Erro do Content Manager ao Iniciar o IBM Cognos BusinessIntelligence

Depois de iniciar o IBM Cognos BI, nenhum processo BIBUSTKSERVMA éiniciado. Os erros estão listados nos arquivos pogo******.log e cogserver.log. Osusuários recebem erros no navegador ao conectar-se ao portal 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 dispatcher no Content Manager foi malsucedida. Serão feitastentativas periódicas.

Ao conectar-se a http://nome do computador/ibmcognos, a seguinte mensagem deerro é exibida no navegador:v DPR-ERR-2058 O dispatcher não pode atender à solicitação neste momento. O

dispatcher ainda está sendo inicializado

v SoapSocketException: Conexão negada

O IBM Cognos Configuration usa um ID do usuário para ligar-se ao banco dedados LDAP. Se este ID do usuário for movido para outro grupo, o IBM CognosConfiguration não poderá mais localizá-lo.

Procedimento

Para corrigir o problema, mova a ID do usuário para o grupo original.

Content Manager Falha ao Iniciar ou Leva Muito Tempo paraIniciar

No Microsoft Windows, você tenta iniciar o serviço no computador no qualinstalou o Content Manager. À medida que o serviço estiver sendo iniciado, osdetalhes incluirão erros semelhantes aos seguintes:

DPR-CMI-4006 Não é possível determinar o Content Manager ativo. Serão feitastentativas periódicas.

CM-SYS-5007 Falha na construção do Content Manager x.x.x.x ao iniciar!

Os detalhes no log de erro também poderão incluir referências aOutOfMemoryError.

Para solucionar esse problema, inicie o serviço usando o parâmetroDuseCMLargeResultSet. É possível incluir o parâmetro no arquivo de configuraçãode autoinicialização e iniciar o serviço usando o IBM Cognos Configuration ouincluir o parâmetro no arquivo de configuração de autoinicialização e executar oarquivo.

360 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 373: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Resolvendo um Erro de Falta de Memória Usando o Arquivo deConfiguração de AutoinicializaçãoInicie o serviço do IBM Cognos incluindo o parâmetro DuseCMLargeResultSet noarquivo de configuração de autoinicialização.

Procedimento1. Acesse o diretório c10_location\bin e abra bootstrap_wlp.xml em um editor

XML.2. Encontre a seção que começa com <param>"${install_path}.3. Remova o comentário do parâmetro DuseCMLargeResultSet para esta seção, no

local mostrado pelo texto em negrito no exemplo a seguir.<param>"-Dcatalina.base=${install_path}/tomcat"</param>

<param>"-Dcatalina.home=${install_path}/tomcat"</param>

<param>"-Djava.io.tmpdir=${temp}"</param>

<param>"-DuseCMLargeResultSet=true"</param>

4. Salve e feche o arquivo.5. Inicie o IBM Cognos Configuration e inicie o serviço.

Resolvendo um Erro de Falta de Memória Usando o Arquivo deConfiguração de InicializaçãoInicie o serviço do IBM Cognos incluindo o parâmetro DuseCMLargeResultSet noarquivo de configuração de inicialização.

Procedimento1. Acesse o diretório c10_location\bin e abra startup.bat em um editor de texto.2. Localize a seguinte linha:

set CATALINA_OPTS=-Xmx768m -XX:MaxNewSize=384m -XX:NewSize=192m-XX:MaxPermSize=128m%DEBUG_OPTS%

3. Anexe o parâmetro DuseCMLargeResultSet à linha, conforme mostrado pelotexto em negrito no exemplo a seguir:set CATALINA_OPTS=-Xmx768m -XX:MaxNewSize=384m -XX:NewSize=192m-XX:MaxPermSize=128m%DEBUG_OPTS%-DuseCMLargeResultSet=true

4. Salve e feche o arquivo.5. Inicie o serviço ao executar o arquivo startup.bat.

Erro DPR-ERR-2014 no arquivo de log no computador comContent Manager

Este erro é exibido se o Content Manager estiver instalado em um computadorseparado e o serviço de gerenciamento de eventos no computador com ContentManager estiver ativado ou se tiver uma instalação de servidor único e o serviçode gerenciamento de eventos estiver desativado.

A mensagem de erro a seguir pode ser exibida no arquivo cogserver.log:

DPR-ERR-2014 Não é possível balancear a carga da solicitação porque não há nósdisponíveis no cluster ou não há nós configurados para o serviço: eventManagementService

Para corrigir o problema, desative o serviço de gerenciamento de eventos em umainstalação distribuída com Content Manager em um computador separado ou ativeo serviço em uma instalação de servidor único.

Apêndice C. Resolução de problemas 361

Page 374: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Procedimento1. Execute umas das seguintes etapas:

v Em uma instalação distribuída com o Content Manager em um computadorseparado, inicie o IBM Cognos Configuration no computador com ContentManager.

v Em uma instalação de servidor único, inicie o IBM Cognos Configuration.2. Na área de janela Explorer, acesse Ambiente > Serviços IBM Cognos.3. Execute umas das seguintes etapas:

v Para uma instalação distribuída, configure a propriedade Serviço degerenciamento de eventos ativado como False.

v Para uma instalação de servidor único, configure a propriedade Serviço degerenciamento de eventos ativado como True.

4. Salve as mudanças.5. Reinicie os serviços.

Caracteres Não ASCII no Diretório de Instalação CausamErros de Tempo de Execução

Em todos os sistemas operacionais, se você usar caracteres não ASCII no diretóriode instalação para o IBM Cognos Business Intelligence, isso causa erros de tempode execução. Isto também causa falha em algumas funções de produto, como aexecução do relatório.

Instale o IBM Cognos BI no diretório padrão ou use um nome de diretório quecontenha apenas caracteres ASCII Latin-1.

Não É Possível Abrir um Microsoft Cube ou PowerCubeNão é possível abrir um Microsoft Cube ou PowerCube, ou é possível abrir umMicrosoft Cube, mas apenas os metadados são mostrados. Para um MicrosoftCube, você pode receber a mensagem de erro a seguir:

MO-ERR-0030

Não é possível se conectar à origem de dados. Configure o serviço para serexecutado como um usuário do domínio com os privilégios corretos.

Para resolver esse problema, certifique-se de que o usuário executando o serviçoIBM Cognos Business Intelligence tenha direitos de acesso ao cubo.

Os PowerCubes são acessados a partir de unidades mapeadas ou nomes decaminho UNC.

Designando Direitos de Acesso a Cubos da MicrosoftPara que uma conta do usuário abra os cubos da Microsoft, ela deve ter osprivilégios apropriados designados nas ferramentas administrativas do sistema.

Procedimento1. Inclua a conta do usuário do domínio que inicia o serviço do IBM Cognos no

privilégio Agir como parte do sistema operacional:v Sob Ferramentas Administrativas, selecione Política de segurança local.v Expanda Configurações de Segurança, Diretivas locais e clique em

Designação de direitos do usuário.

362 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 375: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

v Clique com o botão direito do mouse na política Agir como parte do sistemaoperacional e selecione Propriedades.

v Clique em Incluir Usuário ou Grupo e inclua a conta do usuário que inicia oserviço do IBM Cognos.

2. Se você usar o método de autenticação de ID do usuário e senha do domínio,inclua a conta do usuário que inicia o serviço do IBM Cognos no domínio queinclui o Content Manager, os Componentes da Camada de Aplicativos, oservidor da Web IIS e o servidor de origem de dados (Microsoft SQL Server ouMicrosoft Analysis Server).

3. Se você usar um namespace externo, como o Active Directory Server paraautenticação, inclua a conta do usuário que inicia o serviço do IBM Cognos nodomínio que inclui o provedor de autenticação.Este domínio também deve incluir o Content Manager, os Componentes daCamada de Aplicativos, o servidor da Web IIS e o servidor de origem de dados(Microsoft SQL Server ou Microsoft Analysis Server).Para obter informações adicionais sobre a configuração de namespaces externospara autenticação, consulte os tópicos sobre os provedores de autenticação noIBM Cognos Business Intelligence: Guia de Instalação e Configuração.

Designando Direitos de Acesso a PowerCubesPara que uma conta do usuário abra PowerCubes, a ela devem ser designados osprivilégios apropriados no IBM Cognos Administration.

Procedimento

Certifique-se de que o perfil do usuário do IBM Cognos tenha direitos de acessosuficientes ao sistema operacional ou ao domínio para abrir o arquivo doPowerCube.Para obter informações adicionais, consulte o Guia de Administração e Segurança doIBM Cognos Business Intelligence.

A Página não Pode Ser Localizada ao Iniciar o IBM CognosBusiness Intelligence no Windows 2003

Instalar o IBM Cognos Business Intelligence no sistema operacional MicrosoftWindows 2003 pode causar uma mensagem de erro ao tentar iniciar o IBM CognosBI.

O seguinte erro é causado por um recurso de segurança no Internet InformationServices (IIS) do Windows 2003. Esse recurso de segurança não permite extensõesde arquivo cgi desconhecidas.

A página não pode ser localizada. A página que você está procurando pode ter sidoremovida, teve seu nome alterado ou está temporariamente indisponível. HTTP Error 404 -Arquivo ou diretório não encontrado.

Procedimento

Para solucionar o problema, adicione uma nova extensão de arquivo no IIS para oarquivo cognos.cgi. Para obter mais informações, consulte a documentação do IIS.

Apêndice C. Resolução de problemas 363

Page 376: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

A página não é mostrada ao abrir um portal após instalar oIBM Cognos Business Intelligence

Após a instalação e configuração do IBM Cognos Business Intelligence, não épossível conectar ao portal do Cognos BI.

Isso pode ocorrer porque o servidor web não está configurado corretamente. Porexemplo, os diretórios virtuais exigidos para o IBM Cognos BI podem não existirou podem apontar para as pastas físicas erradas.

Para obter informações sobre a configuração do servidor da web, consulte IBMCognos Business Intelligence: Guia de Instalação e Configuração.

DPR-ERR-2058 Erro Exibido no Navegador da Web ao Iniciar oIBM Cognos Business Intelligence

Após você iniciar os serviços no IBM Cognos Configuration e tentar abrir o portal,uma mensagem semelhante a uma das seguintes pode aparecer:DPR-ERR-2058 The dispatcher encountered an error while servicing a request.XTS handler must be initialized before being invoked.DPR-ERR-2058 The dispatcher cannot service the request at this time.The dispatcher is still initializing. Please try again or contact youradministrator.

Geralmente, essas mensagens de erro ocorrerão quando o dispatcher não puder secomunicar com o Content Manager. Para ajudá-lo a determinar a causa específica,examine o arquivo cogserver.log no diretório c10_location/logs. As seguintescausas são as mais comuns com suas soluções.

Os Serviços do IBM Cognos Não São Concluídos ao InicializarApós iniciar os serviços no IBM Cognos Configuration e a ferramenta deconfiguração mostrar que os serviços estão em execução, aguarde alguns minutospara que todos os serviços sejam iniciados 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 outroscomputadores IBM Cognos estejam configurados com o URI do Content Managercorreto.

O armazenamento de conteúdo não está disponível ou não foiconfigurado corretamenteCertifique-se de que o banco de dados de armazenamento de conteúdo foi criado ede que você o configurou corretamente no IBM Cognos Configuration.

As tabelas não foram criadas no armazenamento de conteúdoCertifique-se de estar usando uma versão do DB2, Microsoft SQL Server, Oracle ouSybase que seja suportada pelos componentes IBM Cognos.

As credenciais de logon para o armazenamento de conteúdoestão incorretasVerifique se as informações foram alteradas. Por exemplo, o DB2 lê informações dogerenciamento de usuários do NT. Se a senha para a conta do NT tiver sidoalterada, você deve alterar também as credenciais de logon para o armazenamentode conteúdo no IBM Cognos Configuration.

364 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 377: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Verifique se não há caracteres especiais na senha de logon. Às vezes, o driver JDBCnão aceita caracteres reservados para xml, como %, !, < e >.

O usuário não possui as permissões apropriadasCertifique-se de que o usuário possui as permissões apropriadas.

Sem memória no HP-UXSe estiver usando o servidor de aplicativos fornecido com o IBM Cognos BI, épossível determinar se o problema está relacionado à configuração do servidorHP-UX. Você pode estar excedendo o número máximo esperado de encadeamentossimultâneos ativos por processo.

Aumentando o Número Máximo de Encadeamentos por Processo no HP-UX:

Se estiver excedendo o número máximo esperado de encadeamentos ativossimultaneamente por processo no HP-UX, aumente o número de encadeamentosativos.

Procedimento

Peça para o administrador do sistema alterar o parâmetro Kernel da seguinteforma:v max_thread_proc = 512v nkthread = 1024

Verificando um Problema de Configuração do HP-UX:

Se aumentar o número máximo de encadeamentos ativos por processo não resolvero erro de falta de memória no HP-UX, execute as seguintes etapas.

Procedimento

1. No arquivo /bin/startup.sh, procure por../tomcat/bin/catalina.sh start "$@"

2. e altere para:../tomcat/bin/catalina.sh run "$@"O comando de execução faz a saída do Tomcat ser exibida na janela do consolepara o IBM Cognos BI.

3. Pare e reinicie o IBM Cognos BI usando os comandos ./shutdown.sh e./startup.sh.

4. Se a seguinte mensagem de erro for exibida na janela de console para qualquerdos 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 HP-UX 11.0 e 11i estão definidoscomo muito baixos para a maioria dos aplicativos Java.

Dica: É possível verificar o número de encadeamentos em seu processo usandoa opção -eprof disponível no JDK 1.1.8 e analisando o arquivo Java.eprofusando HPjmeter, selecionando a métrica de encadeamentos.

O Content Manager não consegue conectar-se aoarmazenamento de conteúdo no OracleSe estiver usando um banco de dados Oracle como armazenamento de conteúdo, oerro DPR-ERR-2058 poderá ser gerado durante login no portal: Todas as tabelassão criadas no banco de dados.

Apêndice C. Resolução de problemas 365

Page 378: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

As seguintes mensagens de erro também podem ser recebidas:v CM-CFG-5036 Falha do Content Manager ao conectar-se com o armazenamento de

conteúdo.v ORA-01017: nome de usuário/senha inválidos; logon negado

Definindo o Nome do Servidor de Banco de Dados Oracle:

O Content Manager pode falhar ao conectar-se a um banco de dados Oracledevido a inconsistências entre o nome do servidor Oracle no IBM CognosConfiguration e o nome do servidor no arquivo tsnnames.ora.

Procedimento

1. Inicie o IBM Cognos Configuration.2. Na janela Explorer, clique em Acesso a dados, Content Manager,

Armazenamento de conteúdo.3. Altere o nome do servidor de banco de dados Oracle para um nome totalmente

adequado, como host_name.companyname:1534, para corresponder ao nome noarquivo tnsnames.ora.

DPR-ERR-2022 Erro Exibido no Navegador da Web ao Iniciar oIBM Cognos Business Intelligence

Após você iniciar os serviços no IBM Cognos Configuration e tentar abrir o portal,uma mensagem semelhante à seguinte pode aparecer:

DPR-ERR-2022 Nenhuma resposta gerada. Isso pode ocorrer devido a uma configuraçãoincorreta, a uma instalação danificada ou a um dispatcher que não acabou de inicializar.

Esse problema pode ocorrer sev Você tentar abrir o portal antes de os serviços do IBM Cognos serem

inicializados.v Um arquivo system.xml tiver sido editado.

Neste caso, substitua o arquivo system.xml editado no subdiretório apropriadoem c10_location\templates\ps por uma cópia de backup ou use um editor XMLpara editá-lo.Há várias instâncias do system.xml nos diretórios em c10_location\templates\ps.Assegure-se de substituir o arquivo correto.

Caracteres Corrompidos na Instalação de alguns Idiomas noLinux

Ao executar o assistente de instalação no Linux em coreano, chinês (simplificadoou tradicional) ou japonês, é possível ver caracteres corrompidos nas caixas dediálogo da interface com o usuário ou nas mensagens que são exibidas durante ainstalação.

Para evitar o problema de caracteres corrompidos na interface com o usuáriodurante a instalação, use uma das seguintes soluções:v Configure fontes asiáticas no servidor Linux:

– Defina o código do idioma como utf8.Por exemplo,ko_KR.utf8, ja_JP.utf8, zh_CN.utf8, ou zh_TW.utf8

366 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 379: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

– Verifique se o conjunto de fontes de idioma asiático *medium-r*--14* estádisponível no servidor X.

v Execute uma instalação não assistida usando o arquivo response.ats padrão queé fornecido com seu produto IBM Cognos BI. Para obter informações sobre umainstalação não assistida, consulte IBM Cognos Business Intelligence: Guia deInstalação e Configuração.

Não É Possível Fazer o Download do Arquivo cognos.xtsApós instalar o IBM Cognos BI, é solicitado que você faça o download do arquivocognos.xts ao conectar ao portal do IBM Cognos Business Intelligence. A seguintemensagem pode ser exibida:

Você escolheu fazer o download de um arquivo desta local. cognos.xts de servername

Este problema ocorre quando as permissões dos diretórios virtuais não estãoconfiguradas corretamente. Você deve fornecer o diretório virtual cgi-bin noMicrosoft Internet Information Service (IIS) com permissões de execução.

Para solucionar este problema, recrie os diretórios virtuais em IIS com aspermissões da tabela a seguir, em que local_c10 representa o local da instalação.

Tabela 79. Alias, Caminho e Permissões para Criar Diretórios Virtuais do IIS

Alias Caminho Permissões

ibmcognos c10_location\webcontent Leitura

ibmcognosbin c10_location\cgi-bin Ler Executar

Por exemplo, o local de instalação padrão é C:\Program Files\IBM\Cognos\c10.

Falha do Script de Inicialização do Servidor de AplicativosPode haver problemas ao executar os scripts de inicialização para um servidor deaplicativos implementar o aplicativo IBM Cognos se os componentes do IBMCognos Business Intelligence estiverem instalados em um diretório com um nomeque inclua espaços.

Procedimento1. Reinstale em um novo diretório e não inclua espaços no novo nome.2. 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 ouusar a convenção de nomes do DOS 8.3.

O IBM Cognos Business Intelligence Falha em Execução noWebLogic Application Server no AIX

A instância do servidor do IBM Cognos Business Intelligence pode entrar em umestado FAILED_NOT_RESTARTABLE no WebLogic Administration Console noAIX.

Muitos arquivos principais e arquivos principais Java são gravados no diretório dedomínio do IBM Cognos BI. O IBM Cognos BI é finalizado e não fica acessível pormeio do portal. Este comportamento ocorre apenas quando o Nó Gerenciado doIBM Cognos BI é iniciado com o WebLogic Administration Console.

Apêndice C. Resolução de problemas 367

Page 380: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Procedimento

Inicie o Nó Gerenciado do IBM Cognos BI usando então os scripts de inicializaçãodo WebLogic.

Falha na Implementação do IBM Cognos Business IntelligenceIBM WebSphere Application Server

A implementação de IBM Cognos BI para um IBM WebSphere Application Serverpode falhar.

Esses erros podem ocorrer porque o arquivo do aplicativo que está tentandoimplantar é muito grande. Se a implementação falhar, pode ocorrer qualquer umdos seguintes erros:v Tempo limite do navegador no console administrativo

v Erro Interno HTTP 500

v Retorne à página de seleção de arquivo de aplicativo

Procedimento

Se estiver utilizando o Assistente para Construção de Aplicativo, limpe a caixa deseleção Incluir arquivos estáticos da pasta Webcontent quando selecionar oaplicativo a ser criado.Isso reduzirá o tamanho do arquivo do aplicativo. Se o conteúdo estático fornecessário, será possível copiá-lo manualmente para o local do aplicativoimplementado depois de implementar com êxito o IBM Cognos BI no servidor deaplicativos.

Não é possível desserializar o erro de atributo de contexto aoimplementar o arquivo p2pd.war no WebLogic

Pode ocorrer um erro ao implementar o arquivo p2pd.war no WebLogic.

Esse erro não afeta a implantação do arquivo p2pd.war.

Erro [context]Não foi possível desserializar o atributo de contexto

java.io.NotSerializableException: com.cognos.logserver.LogService

Procedimento

Para evitar esse problema, inclua pelo menos uma preferência de arquivo noInternet Explorer.

Exibido Erro após a Atualização do IBM Cognos BusinessIntelligence em um WebLogic Application Server

Você está usando WebLogic e atualiza o IBM Cognos BI de um release anterior.

Após implantar o arquivo p2pd.war para a nova instalação, uma mensagem comoa seguinte pode ser exibida:

<BEA-101215> <Solicitação Malformada "nula". Falha na análise dasolicitação, Código: -10>

368 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 381: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Sobre Esta Tarefa

Isto pode ocorrer se você remover a implementação do IBM Cognos BI doWebLogic e alguns arquivos da versão anterior não forem removidos do sistema.

Para resolver o problema, faça o seguinte:

Procedimento1. Use as ferramentas administrativas para seu servidor de aplicativos para

assegurar que o IBM Cognos BI tenha tido sua implementação removida.Para obter informações sobre como remover aplicativos, consulte adocumentação do servidor de aplicativos.

2. Se o diretório no qual o IBM Cognos BI foi originalmente implementado nãofor removido durante o processo de remoção de implementação, exclua odiretório.Além disso, remova os arquivos .jar do IBM Cognos BI que estão armazenadosem cache no ambiente de servidor de aplicativos.

3. Depois de remover todos os arquivos da instalação anterior, reimplemente oIBM Cognos BI.

Caracteres Chineses, Japoneses ou Coreanos FicamDiferentes após a Atualização

Se você usa caracteres chineses, japoneses ou coreanos, poderá notar diferenças emalguns caracteres após a atualização do ReportNet para o IBM Cognos BusinessIntelligence.

Exemplosv Você executa um relatório existente. Ao comparar a saída para o mesmo relatório

no ReportNet, você vê que alguns dos caracteres são diferentes.v Você faz uma procura que fazia no ReportNet e obtém resultados diferentes.

As diferenças ocorrem porque as tabelas de conversão usadas para chinês, japonêse coreano foram modificadas para atender os padrões globais. Se as especificaçõesde relatório ou filtros de procura contêm expressões que utilizam valoresconstantes, os resultados podem ser afetados.

Procedimento

Se desejar usar a mesma tabela de conversão usada no ReportNet, execute oseguinte script no diretório c10_location\bin:v No UNIX, digite

conv_compat.sh

v No Linux, digiteconv_compat.sh

v No sistema operacional Microsoft Windows, digiteconv_compat.cdm

Apêndice C. Resolução de problemas 369

Page 382: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Caracteres Acentuados ou de Byte Duplo Podem Não SerExibidos Corretamente ao Instalar o IBM Cognos BusinessIntelligence no Linux

Se estiver usando o issetup em um código do idioma UTF-8, os caracteres de doisbytes ou acentuados podem não ser exibidos corretamente.

Procedimento

Para resolver este problema ao instalar em alemão ou francês, use um código doidioma não UTF-8 e inicie issetup para instalar o IBM Cognos BI.

Erros "RSV-SRV-0066 Uma Falha de SOAP Foi Retornada" ou"RQP-DEF-0114 O Usuário Cancelou a Solicitação" SãoExibidos em Ambientes de Alta Carga de Usuários

Esses erros podem estar no cogserver.log do IBM Cognos se você tiver um altacarga de usuários (mais de 165 usuários) e os relatórios interativos estiverem emexecução contínua em uma instalação distribuída.

Procedimento1. Aumente o parâmetro async_wait_timeout_ms no arquivo webapps/p2pd/

WEB-INF/services/reportservice.xml.Para obter informações adicionais, consulte o Guia de Instalação e Configuração doIBM Cognos Business Intelligence.

2. Aumente a configuração de Limite de Tempo da Fila para 360.Para obter informações, consulte IBM Cognos Business Intelligence: Guia deAdministração e Segurança.

Não é Possível Iniciar o Serviço IBM Cognos ao AtualizarInstalações Multitenant

Ao atualizar instalações multitenant do software IBM Cognos, você pode nãoconseguir iniciar o serviço IBM Cognos se instâncias de objetos que violam asregras de consistência de arrendatário forem detectadas no Content Manager.

Sobre Esta Tarefa

As regras de consistência para ocupação variada requerem que cada objeto doarrendatário no armazenamento de conteúdo tenha o mesmo ID de arrendatárioque seu pai, a menos que o objeto-pai seja público.

Para identificar e resolver as instâncias de violação de regras de consistência dearrendatário, você deve efetuar logon no IBM Cognos BI e executar a verificaçãode consistência do armazenamento de conteúdo. Para fazer isso, você deve iniciaro serviço IBM Cognos apesar do erro de configuração. Isso é possível somente sevocê configurar a ignoreInvalidTenantContainmentAtStartup propriedade doContent Manager para true.

Após resolver as instâncias da violação das regras de consistência de arrendatário,essa propriedade deve ser removida.

Procedimento1. Inicie o IBM Cognos Configuration no computador no qual o seu Content

Manager está instalado.

370 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 383: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

2. Em Acesso a Dados, clique em Content Manager.3. Para Propriedades avançadas, clique no ícone Editar na coluna Valor.4. Clique em Incluir.5. Na coluna Nome, digite ignoreInvalidTenantContainmentAtStartup.6. Na coluna Valor, digite verdadeiro.7. Clique em OK.8. Inicie o serviço IBM Cognos no computador no qual o Content Manager está

instalado.Supondo que não haja mais nenhum erro de configuração, agora você deveconseguir iniciar o serviço IBM Cognos.

9. Efetue logon no IBM Cognos BI e execute uma verificação de consistênciapara detectar e resolver os problemas relacionados a arrendatário.Para obter informações adicionais, consulte o tópico sobre criação e execuçãode uma verificação de consistência de armazenamento de conteúdo nocapítulo sobre ambientes multitenant no Guia de Administração e Segurançado IBM Cognos Business Intelligence.

10. Após resolver os problemas relacionados a arrendatário, remova apropriedade ignoreInvalidTenantContainmentAtStartup do IBM CognosConfiguration.

11. Reinicie o serviço do IBM Cognos.

Definições de configuração de serviço do IBM Cognos Mobile sãoreconfiguradas ao padrão após a atualização

As definições de configuração e configurações avançadas do IBM Cognos Mobilepodem ser reconfiguradas para os padrões após o upgrade do IBM CognosBusiness Intelligence.

Para resolver esse problema, reaplique as configurações.

As tabelas do banco de dados do Cognos Mobile não são criadasDepois que o IBM Cognos Mobile foi instalado com o IBM Cognos BusinessIntelligence, os scripts para criar as tabelas MOB_* não foram executados.

Sob circunstâncias normais, as tabelas do Cognos Mobile são criadasautomaticamente depois que o serviço do Mobile é iniciado pela primeira vez.

Esse problema pode ocorrer quando os componentes da camada do aplicativo doCognos Mobile e o Cognos BI Content Manager são instalados em locais diferentes,e o banco de dados do Cognos Mobile não está configurado adequadamente.

Assegure-se de que o banco de dados do Cognos Mobile está configuradoconforme documentado no Guia de Instalação e Configuração do IBM Cognos BusinessIntelligence.

O IBM Cognos Mobile falha ao conectar-se com o banco de dadosO IBM Cognos Mobile acessa o Microsoft SQL Server por meio do driver JavaDatabase Connectivity (JDBC), que usa um soquete TCP para conectar-se ao bancode dados.

Apêndice C. Resolução de problemas 371

Page 384: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Se o Microsoft SQL Server não estiver configurado para permitir conexões TCP, oIBM Cognos Mobile não se conectará ao banco de dados e relatará erros nos logs.

Para resolver esse problema, ative a conectividade TCP no Microsoft SQL Server.

Alterar o gateway padrão o redireciona caso não esteja usando ogateway CGI

Caso você não esteja usando o gateway do CGI com o IBM Cognos BI, é possívelmodificar as páginas da web do gatway padrão para assegurar que todos osredirecionamentos automáticos de páginas da web que são utilizados no IBMCognos Mobile acessem o gateway correto. Você pode alterar as páginas da webpadrão caso esteja usando o gateway de módulo ISAPI ou Apache como seugateway padrão.

Importante: Se pretende usar o gateway CGI como, por exemplo, uma alternativapara o gateway do ISAPI, modificar a página web padrão obriga qualquerredirecionamento automático a usar o gateway que você identificar na página daweb padrão.

Procedimento1. Acesse o diretório c10_location\webcontent onde os componentes de gateway

do IBM Cognos BI estão instalados.2. Abra a página default.htm ou index.html no editor de texto, dependendo de

qual seja o documento padrão de seu servidor da web.3. Localize a seguinte linha:

window.setTimeout("window.location.replace(’cgi-bin/cognos.cgi?b_action=xts.run&m=portal/main.xts&startwel=yes’)",5);

4. Edite o valor cognos.cgi para redirecionar o gateway adequado.Caso esteja usando o ISAPI, altere cognos.cgi para cognosisapi.dll. Casoesteja usando módulos Apache, altere o cognos.cgi para o valor apache_moduleque foi definido.Por exemplo, caso esteja usando o ISAPI como seu gatway padrão, a linha deveser:window.setTimeout("window.location.replace(’cgi-bin/cognosisapi.dll?

b_action=xts.run&m=portal/main.xts&startwel=yes’)",5);

5. Salve e feche o arquivo.

Problemas ao Configurar o IBM Cognos Business IntelligenceApós a instalação dos componentes do IBM Cognos Business Intelligence, épossível encontrar problemas ao salvar as mudanças no IBM CognosConfiguration.

Certifique-se de:v Configurar e inicializar os serviços no computador em que o Content Manager

está localizado antes de configurar outros componentes.v reiniciar o serviço do IBM Cognos após fazer mudanças na configuração

372 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 385: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Executando Scripts de Limpeza do Banco de Dados e deÍndice

Em algumas situações de resolução de problemas, você poderá ser aconselhado ainiciar com novos dados de configuração.

É possível executar scripts SQL para excluir todas as tabelas em qualquer um dosseguintes bancos de dados usados pelos componentes do IBM Cognos BI:v armazenamento de conteúdo para dados de que o IBM Cognos BI precisa para

operarv Banco de dados de entrega para notificações de relatório.v Armazenamento de métricas para conteúdos de pacotes de métricas e

preferências do usuário do Metric Studio.v Banco de dados para human tasks e anotações.

É possível executar scripts SQL para excluir todas as tabelas e índices no banco dedados de criação de log para mensagens de log.

Ao excluir uma tabela, a definição estrutural e os dados são excluídospermanentemente do banco de dados. Para o armazenamento de métricas, osobjetos do banco de dados também poderão ser excluídos.

Ao excluir os índices de um banco de dados de criação de log, eles são excluídospermanentemente do banco de dados.

Ao reiniciar o serviço do IBM Cognos, um novo conjunto de tabelas de banco dedados e índices necessários é criada automaticamente no local especificado pelasdefinições de configuração.

Procedimento1. Em cada computador no qual o Content Manager está localizado, pare o

serviço do IBM Cognos.2. Acesse o diretório apropriado:

v Para excluir tabelas e índices do banco de dados de criação de log, acessec10_location\configuration\schemas\logging.

v Para excluir tabelas do armazenamento de conteúdo, acessec10_location\configuration\schemas\content.

v Para excluir tabelas do banco de dados de notificação, acessec10_location\configuration\schemas\delivery.

v Para excluir tabelas do armazenamento de métricas, acessec10_location\configuration\schemas\cmm.

v Para excluir tabelas do banco de dados de tarefas manuais e de anotações,acesse c10_location\configuration\schemas\hts.

3. Acesse o diretório apropriado do banco de dados.4. Dependendo do banco de dados e do seu tipo, execute os seguintes scripts na

ferramenta de banco de dados adequada para excluir as tabelas.A tabela a seguir lista os nomes de script para o banco de dados dearmazenamento de conteúdo.

Apêndice C. Resolução de problemas 373

Page 386: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Tabela 80. Tipo de Banco de Dados e Nome do Script para o Banco de Dados deArmazenamento de Conteúdo

Tipo de banco de dados Nome do script

DB2 dbClean_db2.sql

DB2 no z/OS dbClean_db2zOS.sql

Derby dbClean_derby.sql

Informix dbClean_informix.sql

Microsoft SQL Server dbClean_mssqlserver.sql

Oracle dbClean_oracle.sql

Sybase dbClean_sybase.sql

A tabela a seguir lista os nomes de script para o banco de dados de notificação.

Tabela 81. Tipos de Banco de Dados e Nomes de Script para o Banco de Dados deNotificação

Tipo de banco de dados Nome do script

DB2 NC_DROP_DB2.sql

DB2 no z/OS NC_DROP_DB2.sql

Derby NC_DROP_Derby.sql

Informix NC_DROP_IFX.sql

Microsoft SQL Server NC_DROP_MS.sql

Oracle NC_DROP_ORA.sql

Sybase NC_DROP_SYBASE.sql

A tabela a seguir lista os nomes dos scripts para limpar tabelas e índices dobanco de dados de criação de log.Para Informix, o script de limpeza de índice deve ser editado se você hospedarmais de um banco de dados de criação de log de auditoria na instânciaInformix e usá-los ao mesmo tempo. Consulte a etapa 5.

Tabela 82. Nomes de Script para Limpar Tabelas e Índices para o Banco de Dados deCriação de Log.

Tipo de banco de dados Nome do script

DB2 LS_dbClean_db2.sql

LS_dbCleanIndexes_db2.sql

374 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 387: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Tabela 82. Nomes de Script para Limpar Tabelas e Índices para o Banco de Dados deCriação de Log. (continuação)

Tipo de banco de dados Nome do script

DB2 no z/OS LS_dbClean_db2zOS.sql

LS_dbCleanIndexes_db2zOS.sql

Derby LS_dbClean_derby.sql

LS_dbCleanIndexes_derby.sql

Informix LS_dbClean_informix.sql

LS_dbCleanIndexes_informix.sql

Microsoft SQL Server LS_dbClean_mssql.sql

LS_dbCleanIndexes_mssql.sql

Oracle LS_dbClean_oracle.sql

LS_dbCleanIndexes_oracle.sql

Sybase LS_dbClean_sybase.sql

LS_dbCleanIndexes_sybase.sql

A tabela a seguir lista os nomes de script para o banco de dados dearmazenamento de métricas.

Tabela 83. Nomes de Script para o Banco de Dados de Armazenamento de Métricas

Tipo de banco de dados Nome do script

DB2 cmm_uninstall dbalias username password

Especifique o dbalias apenas se um banco dedados com o mesmo nome já estivercatalogado.

Microsoft SQL cmm_uninstall metric_store_namedatabase_name Admin_user_name password

Oracle cmm_uninstalldatabase_namedatabase_user_name password

Substitua database_name pelo nome noarquivo tnsnames.ora que se refere ao bancode dados SID para o Metric Studio

A tabela a seguir lista os nomes de script para o banco de dados Human Task eAnotação.

Apêndice C. Resolução de problemas 375

Page 388: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Tabela 84. Nomes de Script para o Banco de Dados de Tarefas Manuais e de Anotação

Tipo de banco de dados Nome do script

todos os tipos humanTaskService-dropScript.sql

5. Se você tiver mais de um banco de dados de criação de log de auditoria nainstância Informix, execute o seguinte:v Acesse c10_location\configuration\schemas\logging\informix e abra o

arquivo LS_dbCleanIndexes_informix.sql em um editor de texto.v Substitua cada instância de IPFSCRIPTIDX pelo valor especificado durante a

criação da propriedade IPFSCRIPTIDX no IBM Cognos Configuration. Paraobter mais informações, consulte o tópico sobre a especificação de umrepositório de mensagens de log no IBM Cognos Business Intelligence: Guia deInstalação e Configuração.

v Salve e feche o arquivo.6. Inicie o serviço do IBM Cognos.

Erro ao Tentar Criptografar Informações ao Salvar suaConfiguração

Ao salvar as configurações usando a ferramenta de configuração, é possível queapareça uma mensagem de erro de que as informações criptográficas não podemser criptografadas. Ocorreu um erro ao solicitar um certificado da Autoridade deCertificação.

As informações de criptografia não podem ser criptografadas. Deseja salvar a configuraçãoem texto simples?

Antes de criptografar as configurações, o computador onde o Content Managerestá instalado deve estar configurado e em execução. Em sistemas operacionaisUNIX, certifique-se de ter copiado os arquivos .jar apropriados no local deinstalação do Java Runtime Environment. Além disso, certifique-se de que oambiente Java esteja configurado corretamente, os URIs estejam corretos e a mesmasenha de autoridade de certificação esteja configurada para todos os computadorescom Content Manager.

Em sistemas operacionais Linux, certifique-se de ter copiado os arquivos .jarapropriados no 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 criptográfico geralmente significa que o ambiente Java não está configuradocorretamente. Certifique-se de que a variável de ambiente JAVA_HOME estejaconfigurada corretamente e de que os provedores de segurança apropriadosestejam instalados, como JSSE para JRE 1.5.

Verificando as Propriedades de URI e a Senha da Autoridade deCertificaçãoPara assegurar que as definições de configuração possam ser criptografadas,certifique-se de que as propriedades de URI e a senha da autoridade decertificação no IBM Cognos Configuration estejam corretas.

376 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 389: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Procedimento1. No computador com Content Manager, inicie o IBM Cognos Configuration.2. Na janela Explorer, clique em Ambiente.3. No janela Propriedades, verifique as seguintes propriedades:

v Em Configurações de Gateway > URI de Gateway

v Em Configurações de Dispatcher > URI de Dispatcher Externo e URI deDispatcher Interno

v Em Outras Configurações de URI > URI de Dispatcher para AplicativosExternos e URIs do Content Manager

4. Na janela Explorer, clique em Segurança > Criptografia > Cognos.5. Na janela Propriedades, sob Configuração da autoridade de certificação, clique

no valor de Senha.Certifique-se de que a mesma senha seja utilizada em todos os computadorescom Content Manager.

6. Salve a configuração e reinicie o IBM Cognos BI.

CAM-CRP-1315 Erro ao salvar configuraçãoAo salvar sua configuração, um erro ocorre quando houve uma mudança nodomínio de confiança do ambiente.

O domínio de confiança é gerenciado pela autoridade de certificação associada aoarmazenamento de conteúdo. O seguinte erro ocorre se o armazenamento deconteúdo usado originalmente tiver sido removido ou se você modificou suaconfiguração para usar um Content Manager associado a um armazenamento deconteúdo diferente depois de salvar a configuração original.

CAM-CRP-1315 A configuração atual aponta para um Domínio de Confiança diferente doconfigurado originalmente.

Para resolver o problema, altere sua configuração para usar o armazenamento deconteúdo original ou gere novamente as chaves criptográficas usando as etapas aseguir.

Procedimento1. No computador com Content Manager, faça backup das chaves criptográficas

existentes salvando os seguintes diretórios em uma localização alternativa queseja segura:v c10_location/configuration/cskv c10_location/configuration/encryptkeypairv c10_location/configuration/signkeypair

2. Exclua os diretórios csk, encryptkeypair e signkeypair.3. No IBM Cognos Configuration, salve a configuração e reinicie os serviços.4. Repita as etapas 1 a 3 em todos os computadores que possuem os componentes

do IBM Cognos BI instalados.

CAM-CRP-0221 Erro ao Efetuar Login no PortalApós instalar o IBM Cognos Business Intelligence no sistema operacional MicrosoftWindows (seja um sistema de 32 bits ou de 64 bits) e configurar o IBM HTTPServer como o gateway, as tentativas de efetuar login no portal do IBM Cognos BIresultam em uma mensagem de erro que contém o seguinte:

Apêndice C. Resolução de problemas 377

Page 390: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

CAM-CRP-0221 Não é 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ãocarregadas. Para resolver o problema, carregue as bibliotecas OpenSSL fornecidascom o IBM Cognos BI.

Procedimento1. No computador de gateway, acesse 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 IBMCognos BI.

Alterar Manualmente o Nome do Diretório de Instalação AfetaInstalações em Execução em um Servidor de Aplicativos

Após instalar o IBM Cognos Business Intelligence usando o assistente de instalaçãoe depois renomear o diretório de instalação ou copiar manualmente o conteúdo emoutro diretório, você tentou executar o IBM Cognos Business Intelligence em umservidor de aplicativos.

Um dos seguintes problemas ocorre:v O IBM Cognos BI não inicia.v Os diretórios de log estão vazios.v 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-raizdo IBM Cognos BI se tornam inválidas. Para resolver o problema, você deveatualizar o diretório-raiz do IBM Cognos BI antes de criar o arquivo de aplicativodo IBM Cognos BI para implementar no servidor de aplicativos ou deve reinstalaro IBM Cognos BI no local original. Se você reinstalar o IBM Cognos BI, siga oprocesso para atualização.

Procedimento1. 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 construir o arquivo de aplicativo a ser implementado no servidor de

aplicativos, no IBM Cognos Configuration, no menu Ações, selecione ConstruirArquivos de Aplicativo.

4. Se a criação e implantação do arquivo de aplicativo no servidor de aplicativosfor 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 informações adicionais sobre a configuração do IBM Cognos BI paraoutro servidor de aplicativos, consulte IBM Cognos Business Intelligence: Guia deInstalação e Configuração.

378 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 391: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Os Dados de Configuração estão Bloqueados por OutraInstância do IBM Cognos Configuration

É possível obter uma mensagem de erro de que os dados de configuração estãobloqueados por outra instância do IBM Cognos Configuration.

Ao iniciar, o IBM Cognos Configuration, verifica se o arquivo cogstartup.lock existeno diretório c10_location/configuration. É possível que o arquivo exista caso umainstância anterior não tenha sido encerrada adequadamente ou caso uma instânciado IBM Cognos Configuration esteja em execução.

Procedimento1. Se outra instância do IBM Cognos Configuration estiver em execução, feche-a.

Caso contrário, qualquer mudança feita nas configurações locais podem resultarem erros.

2. Se nenhuma outra instância do IBM Cognos Configuration estiver em execução,exclua o arquivo cogstartup.lock do diretório c10_location/configuration.

3. Se o serviço do IBM Cognos for interrompido, clique em Iniciar.

Não é Possível Sair de uma Sequência de Tabs UsandoSomente a Navegação pelo Teclado no IBM CognosConfiguration

Se estiver usando a tecla tab para navegar no IBM Cognos Configuration, épossível que ocorram problemas ao sair de uma sequência de tabs. Por exemplo,na janela Propriedade, é possível pressionar a tecla Tab para mover entre aspropriedades.

Entretanto, como o IBM Cognos Configuration é um aplicativo Java, quando quiserfechar a janela Propriedades, você deverá pressionar Ctrl+Tab.

Não É Possível Salvar sua ConfiguraçãoPode não ser possível salvar as configurações porque um recurso está faltando. Porexemplo, você exclui um recurso como o namespace Cognos, um provedor decriptografia ou o armazenamento de conteúdo. É possível especificar um tipo debanco de dados diferente para o armazenamento de conteúdo com Oracle,Microsoft SQL Server, Informix ou Sybase. É possível também configurar um novoprovedor de criptografia. Não é possível especificar um novo namespace Cognos,mas é possível recriá-lo. No entanto, você deve recriar os grupos e funções doCognos.

Para obter informações adicionais sobre a criação de grupos e funções no IBMCognos Connection, consulte IBM Cognos Business Intelligence: Guia de Administraçãoe Segurança.

Recriando o Namespace CognosSe tiver excluído o namespace Cognos, você deverá recriá-lo e, em seguida, recriaros grupos e funções do Cognos.

Procedimento1. Inicie o IBM Cognos Configuration.2. Na janela Explorer, em Segurança, clique com o botão direito do mouse em

Autenticação e, em seguida, clique em Novo Recurso > Namespace.3. Na caixa Nome, digite um nome para o recurso.

Apêndice C. Resolução de problemas 379

Page 392: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

4. Na caixa Tipo, clique em Cognos e depois em OK.O namespace Cognos é exibido na janela Explorer.

5. No menu Arquivo, clique em Salvar.6. Recrie os grupos e funções do Cognos usando o IBM Cognos Administration.

Para obter informações adicionais, consulte o Guia de Administração e Segurançado IBM Cognos Business Intelligence.

Erro do Java ao Iniciar o IBM Cognos ConfigurationQuando inicia o IBM Cognos Configuration, é possível receber uma mensagem deerro de que o Java Runtime Environment (JRE) foi alterado e as informações decriptografia atuais não são compatíveis com o novo JRE. Poderá ser entãosolicitada a nova geração das informações de criptografia para o novo JRE ou sairpara voltar ao JRE anterior.

Este erro pode ocorrer por um dos seguintes motivos:v Seus dados de configuração foram criptografados usando um JRE diferente

daquele que os componentes do IBM Cognos BI estão usando atualmente.v As informações de criptografia podem estar corrompidas.

Se você clicar Gerar Novamente no 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 no diálogo de erro, defina a variável de ambiente JAVA_HOMEpara apontar para o JRE utilizado para salvar a configuração.

No sistema operacional Microsoft Windows, se quiser que os componentes do IBMCognos BI usem o JRE que é instalado por padrão, desconfigure JAVA_HOME ouconfigure JAVA_HOME como c10_location/bin/jre.

Nota: Se quiser alterar de um JRE para outro, consulte o tópico sobre a mudançada versão da JVM usada pelos componentes do IBM Cognos BI. Para obterinformações adicionais, consulte o Guia de Instalação e Configuração do IBM CognosBusiness Intelligence.

Erro Criptográfico ao Iniciar o IBM Cognos ConfigurationQuando você inicia o IBM Cognos Configuration, a seguinte mensagem de erropode ser exibida:

As informações de criptografia podem ter sido corrompidas ou o arquivo cogstartup.xml éinválido. É possível ter que corrigir esse arquivo ou removê-lo do disco. Para obter maisinformações, consulte o Guia de instalação e configuração.

Esse erro ocorre quando componentes do IBM Cognos BI detectam um erro noarquivo cogstartup.xml. Isso pode ocorrer quando o arquivo cogstartup.xml émanualmente editado e há um erro no texto alterado.

Para resolver o problema, substitua o arquivo cogstartup.xml file por uma cópia dobackup.

380 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 393: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Reinício do Serviço do IBM Cognos para Aplicação dasDefinições de Configuração

Após alterar os valores da propriedade padrão ou incluir um recurso na instalaçãono IBM Cognos Configuration e, em seguida, salvar a configuração, talvez não sejapossível ver as mudanças ou usar o recurso no ambiente de tempo de execução.

Para aplicar as novas configurações no computador, é necessário reiniciar o serviçodo IBM Cognos.

Procedimento1. Inicie o IBM Cognos Configuration.2. No menu Ações, clique no comando apropriado.

v 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çãoe reinicia os serviços em execução. Se quiser reiniciar um determinadoserviço, selecione o nó de serviço na janela do Explorer e, em seguida, cliqueem Reiniciar no menu Ações.

v 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 janelado Explorer e clique em Iniciar no menu Ações.

Teste do servidor de correio SMTP falha em computadoresWindows 7

Você instalou o IBM Cognos BI em um computador que está executando umsistema operacional Microsoft Windows 7 e o teste do servidor de correio SMTPfalha.

Para resolver esse problema, inicie o IBM Cognos Configuration com uma opçãoda linha de comandos para usar IPV4 em vez de o padrão IPV6.

Procedimento1. Em uma janela de comando, acesse o diretório c10_location\bin64 e execute o

comando a seguir:cogconfig.bat -ipv4

2. Teste a conexão com o servidor de correio SMTP.

CM-CFG-029 Erro ao Tentar Salvar uma Configuração queEspecifica Armazenamento de Conteúdo do Microsoft SQLServer

No IBM Cognos Configuration, você tenta salvar uma configuração e a seguintemensagem de erro aparece no arquivo cogserver.log:

CM-CFG-5003 O Content Manager não pode determinar se o armazenamento de conteúdofoi 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 umarmazenamento de conteúdo ou criar uma tabela no banco de dados.

Apêndice C. Resolução de problemas 381

Page 394: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Certifique-se de que o usuário do armazenamento de conteúdo tenha permissõespara usar o procedimento armazenado sp_tables no banco de dados principal.

Erro DB2 não Localizado para Linux no System zVocê instalou o IBM Cognos Business Intelligence e depois de executar o scriptC8DB2.sh, um erro indicando que o DB2 não pode ser localizado é exibido ougravado nos arquivos de log.

Procedimento1. Crie um perfil que seja originado do sqllib/db2profile a partir do diretório

inicial do usuário para o usuário inserido ao executar o script.Um exemplo .profile conteria algo similar a :if [ -f /home/db2user/sqllib/db2profile ]; then

./home/db2user/sqllib/db2profilefi

2. Execute o script C8DB2.sh novamente.

DPR-ERR-2079 Quando o Content Manager Está Configuradopara Failover

Vários computadores foram configurados para ficar em espera, a fim de garantirfailover para o Content Manager.

No entanto, a seguinte mensagem de erro é exibida ao usuário:DPR-ERR-2079 Firewall Security Rejection. Your request was rejectedby the security firewall

Essa mensagem de erro pode ocorrer se você não tiver configurado todos oscomputadores em espera como hosts válidos para o IBM Cognos ApplicationFirewall.

Para resolver este problema, em cada computador distribuído, inicie o IBM CognosConfiguration e insira os nomes de todos os computadores que estão sendoconfigurados para failover.

Procedimento1. Na área de janela Explorer, clique em Segurança > IBM Cognos Application

Firewall.2. Na janela IBM Cognos Application Firewall - Propriedades do Componente,

clique na coluna Valor próxima aos Domínios ou Hosts Válidos.3. Clique no ícone 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údono Solaris Usando o JRE 1.5

Se exportar um armazenamento de conteúdo maior que 2 GB quando exportado e,em seguida, tentar importá-lo no Solaris usando o JRE 1.5, a importação falharácom a seguinte mensagem de erro:

CM-SYS-5001 Ocorreu um erro interno do Content Manager.

382 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 395: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Isto se deve a um bug no JRE 1.5 do Solaris. Use então o JRE 1.4.2.

A Importação de uma Grande Implementação no WindowsTrava a Java Virtual Machine

A Java Virtual Machine no sistema operacional Microsoft Windows pode travar sobas seguintes circunstâncias.v A configuração máxima de memória Java é 1152 MB ou superior.v Você está importando um archive grande de um release anterior do IBM Cognos

Business Intelligence.v O archive contém modelos grandes que requerem atualização.

Procedimento1. Inicie o IBM Cognos Configuration.2. No Explorer, em Ambiente, Serviços do IBM Cognos, clique em IBM Cognos.3. Defina a propriedade Máximo de Memória em MB como 768.

Erro DPR-ERR-2008 Ao Abrir um RelatórioAo executar um relatório, você obtém a seguinte mensagem de erro:DPR-ERR-2008 The dispatcher is unable to process the request. Therequest is directed to an unknown service name: local.xts.run

Esse erro pode ocorrer se o serviço da Apresentação não estiver ativado. Porexemplo, em um ambiente multisservidor no qual você utiliza regras deroteamento para enviar determinados relatórios para um conjunto de servidoresque possui apenas o serviço de relatórios em Lote, o serviço de Relatórios e oserviço Dispatcher ativados. Se o relatório deve ser atualizado antes da execução, eo serviço de Apresentação não estiver disponível no conjunto de servidores, o erroserá exibido.

Para resolver esse problema, certifique-se de que o serviço de Apresentação estejaativado em pelo menos um servidor no grupo de servidores. Em seguida, tenteexecutar novamente o relatório.

Não é Possível Carregar o TM1 Cubeviewer ou WebSheetiWidget no Business Insight

Você inclui um TM1 Cubeviewer ou WebSheet iWidget no Business Insight, erecebe a seguinte mensagem:There was an error loading the TM1Web required to run this iWidget.

One possible reason why this type of error may occur is if you are runningTM1Web from a different domain.

Esse erro pode ocorrer se você estiver usando um navegador da web MicrosoftInternet Explorer e os componentes do seu TM1 Web estão instalados em umcomputador diferente dos componentes do seu IBM Cognos BI.

Para solucionar esse problema, é possível executar uma das seguintes opções:v Instale o TM1 Web no mesmo computador do IBM Cognos BI.v Use o Firefox como seu navegador.v Alterar as opções de segurança do seu Internet Explorer para incluir o

computador no qual o TM1 Web está em execução para seus Sites Confiáveis de

Apêndice C. Resolução de problemas 383

Page 396: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

navegadores da web e depois ative Acessar origens de dados em domínios paraseus Sites Confiáveis, conforme descrito nas seguintes etapas.

Procedimento1. No Internet Explorer, clique em Ferramentas > Opções da Internet > Security.2. Clique em Sites Confiáveis e clique em Sites.3. Digite a URL para o TM1 Web Server e clique em Incluir.4. Clique em Fechar.5. Clique em Nível Personalizado.6. Em Diversos,selecione Ativar ou Prompt para Acessar origens de dados em

domínios.7. Clique em OK.

Usuários Devem Fornecer Credenciais do Active DirectoryO mecanismo de conexão única não funciona quando o IBM Cognos BusinessIntelligence está configurado da seguinte forma:v O Microsoft Internet Explorer é executado em um computador com sistema

operacional Microsoft Windows NT.v O namespace de autenticação está configurado com o provedor do Active

Directory.v O Microsoft Internet Explorer em um servidor Windows 2000 ou Windows 2003

é configurado para Windows Integrated Authentication.

Como resultado, as credenciais para o Active Directory são solicitadas aos usuários.

Esse problema ocorre porque o provedor IBM Cognos BI Active Directory usaprotocolo ADSI e delegação Kerberos para autenticação em um ambiente deconexão única. Quando o Microsoft Internet Explorer é executado no Windows NT,ele não pode se autenticar para o servidor IIS usando delegação Kerberos.

Quando seu sistema é configurado para Windows Integrated Authentication, paraa conexão única funcionar com IIS, você devev configurar o IBM Cognos BI para se comunicar com o Active Directory Server

usando o provedor LDAP.v Configurar a propriedade de mapeamento de identidade externa para ler a

variável de ambiente REMOTE_USER.

A Fonte do UNIX não foi Localizada ao Iniciar o IBM CognosConfiguration

Ocorre um problema comum no UNIX ao iniciar o IBM Cognos Configuration.

A seguinte mensagem pode ser exibida:

A fonte especificada em font.properties não foi encontrada...

Este erro ocorre se a Java Virtual Machine (JVM) estiver tentando usar uma oumais fontes que não estão instaladas no computador. Entretanto, a JVM deveriausar o padrão do sistema e o IBM Cognos Configuration deveria iniciar e executarnormalmente.

384 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 397: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Procedimento

Inclua as fontes ausentes no Java Runtime Environment editando o arquivofont.properties.Vários arquivos font.properties, que contêm informações de ambiente de fontespadrão, são instaladas com o Java Software Development Kit. É possível encontraresses arquivos no diretório local_JRE/lib.Para obter informações adicionais, consulte a documentação do Java.

ESSBASEPATH Não Pode Ser DetectadoPara plataformas Microsoft Windows e UNIX, o software Oracle Essbase usa avariável de ambiente ESSBASEPATH para localizar o software cliente Essbase 11. OOracle Hyperion Enterprise Performance Management (EPM) System Installer criao ESSBASEPATH como uma variável de ambiente de usuário.

Se o serviço do IBM Cognos estiver configurado para executar ou efetuar logoncomo uma conta do sistema, você deverá incluir manualmente ESSBASEPATHcomo uma variável de ambiente do sistema, caso ela não exista. Quando o IBMCognos Software não puder localizar a variável de ambiente ESSBASEPATH, vocêreceberá 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 resolver esse problema, execute uma das ações a seguir e reinicie o serviço doIBM Cognos:v Dê um clique duplo no serviço do IBM Cognos, e na guia Efetuar Logon,

especifique uma conta do usuário que tenha acesso à ESSBASEPATH.v 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,você deve instalar o cliente adequado e editar o arquivo qfs_config.xml para alteraro nome da biblioteca.

Alterando o Nome da Biblioteca no Arquivo qfs_config.xmlSe estiver atualizando para o software Essbase 11 do software Essbase 9, depois deinstalar o cliente apropriado, você deve alterar o nome da biblioteca no arquivoqfs_config.xml.

Procedimento1. No diretório local_c10/configuration, abra o arquivo qfs_config.xml.2. Localize a linha de código <provider name="DB2OlapODP"

libraryName="essodp93" connectionCode="DO"/> e altere o nome da bibliotecade essodp93 para essodp111.

3. Salve as mudanças.

Falha na Consulta ao Usar o Servidor Oracle EssbaseAo executar uma consulta para recuperar os metadados ou dados do servidorOracle Essbase, recebe-se uma mensagem similar às seguintes:v O gateway do IBM Cognos não consegue se conectar ao servidor IBM Cognos

BI. É possível que o servidor não esteja disponível ou que o gateway não estejaconfigurado corretamente.

Apêndice C. Resolução de problemas 385

Page 398: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

v DB2-ERR-0005 Ocorreu um erro desconhecido durante o login. Código de errodo banco de dados: 1,042,006.

v XQE-DS-0006 Não foi possível fazer logon na origem de dados.

Esses erros do IBM Cognos podem resultar do fato de o Windows não ter soquetesou portas suficientes disponíveis no sistema operacional Microsoft Windows. Afalta de portas suficientes pode causar falha na recuperação de dados do Essbasedevido a erros de comunicação de rede.

Para resolver esse problema, aumente o número de soquetes ou portas doWindows disponíveis para uso do programa.

Aumentando o Número de Soquetes ou Portas do WindowsPara resolver erros de conexão com um Oracle Essbase Server, aumente o númerode soquetes ou portas no sistema operacional Microsoft Windows que estãodisponíveis para uso do programa, incluindo duas entradas no Editor de Registrodo Microsoft.

Importante: Use o Editor de Registro da Microsoft sob sua responsabilidade. Ouso incorreto pode causar problemas que exigem a reinstalação do sistemaoperacional. A Microsoft não pode garantir que os problemas resultantes do usoincorreto do Editor de Registro sejam resolvidos.

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

3. Defina as propriedades de MaxUserPort para usar um valor de 65534 e umabase de Decimal.O intervalo do valor é de 30.000 a 65.534.

4. No mesmo diretório, adicione outro valor DWORD nomeadoTcpTimedWaitDelay.

5. Defina as propriedades de TcpTimedWaitDelay para usar um valor de 50 euma base de Decimal.O intervalo do valor é de 30 a 300 segundos, com valor padrão de 240segundos (4 minutos).

6. Depois de fechar o aplicativo regedit, reinicie o servidor Microsoft CRM oureinicie seu computador.

Resultados

Para obter mais informações, visite o Web site technet2.microsoft.com e pesquise ostermos MaxUserPort e TcpTimedWaitDelay.

Associação ao Grupo Ausente do Namespace do ActiveDirectory

Se um namespace do Active Directory estiver configurado para utilizar a mesmafloresta e um usuário estiver autenticado usando uma credencial, o membro dogrupo ficará faltando.

386 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 399: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

A identidade de processo do IBM Cognos Business Intelligence, durante a execuçãocomo uma conta do sistema local ou um usuário do domínio, deve ter um destesprivilégios:v representar um cliente após a autenticaçãov atuar como parte do sistema operacional

Se o privilégio estiver ausente, não existe membro de grupo para o usuárioautenticado.

Incluindo Associação ao Grupo para um Namespace do ActiveDirectoryPara incluir a associação ao grupo para um namespace do Active Directory, vocêdeve incluir a identidade do processo para o IBM Cognos Business Intelligence napolítica de segurança local.

Procedimento1. A partir do menu Iniciar, clique em Configurações, Painel de Controle.2. Clique em Ferramentas administrativas e depois dê um clique duplo em

Política 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. Inclua a identidade do processo do IBM Cognos BI em uma das seguintes

políticas:v Representar um cliente após autenticação.

O padrão é Administradores, Serviço.Para obter informações adicionais, consulte o artigo da bibliotecafe1fb475-4bc8-484b-9828-a096262b54ca1033.mspx no Web site da Microsoft.

v Agir como parte do sistema operacional.O padrão é Sistema local.Para obter informações adicionais, consulte o artigo da bibliotecaec4fd2bf-8f91-4122-8968-2213f96a95dc1033.mspx no Web site da Microsoft.

Ambos os privilégios oferecem à conta a capacidade de agir com outro usuário.O privilégio Impersonate a client after authentication é parecido com o Agircomo parte do sistema operacional, exceto pelo fato de que só permitirá queum processo represente após a autenticação, enquanto o privilégio Agir comoparte do sistema operacional permite que o processo represente antes daautenticação.Para obter informações adicionais, consulte o artigo da biblioteca tkerbdel.mspxno Web site da Microsoft.

Erros Exibidos ao Implementar no Oracle 10G ApplicationServer

Você está implementando o IBM Cognos Business Intelligence em um Oracle 10GApplication Server.

As seguintes mensagens de erro podem ocorrer:CMM-APP-3254 A inicialização do armazenamento de métricas falhou. DIS-ERR-3115A execução da tarefa falhou

Apêndice C. Resolução de problemas 387

Page 400: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

MDS-RUN-3213 Não é possível localizar o utilitário de carregamento emmassa do banco de dados. Instale aferramenta apropriada do banco de dados para esta plataforma(’bcp’ para SQL Server, ’sqlldr’para Oracle)

Estes erros ocorrem porque os utilitários de carregamento em massa (SQL Loaderno Oracle) não estão incluídos no arquivo de implementação criado pelo IBMCognos Configuration.

Procedimento

Para instalar os componentes ausentes, use o software cliente Oracle nocomputador em que foi instalado o Oracle 10G Application Server.Certifique-se de instalar o SQL Loader.

Erro de Tempo Limite do CGI durante a Conexão com o IBMCognos Business Intelligence por meio de um Navegador daWeb

Ao desempenhar operações por meio do navegador web, recebe-se a seguintemensagem de erro:

Limite de tempo CGI, o processo será excluído do servidor.

O erro ocorre quando você usa Microsoft Internet Information Services (IIS) comoservidor da Web e o gateway está configurado para usar CGI. O IIS possui umtempo limite padrão para aplicativos CGI.

Para resolver esse problema, é possível configurar o gateway para usar ISAPI ouaumentar o tempo limite do CGI no IIS.

O IIS não tem um tempo limite padrão para aplicativos ISAPI. Ou, se desejarmanter a utilização do gateway CGI, pode-se aumentar o tempo limite de CGI noIIS.

Alterando o Gateway para ISAPIPara resolver um erro de tempo limite de CGI no navegador da Web, é possívelalterar o gateway de CGI para ISAPI.

Procedimento1. No computador de gateway, inicie o IBM Cognos Configuration.2. Em Ambiente, para a propriedade URI do gateway, altere a parte cognos.cgi

do URI paracognosisapi.dll

3. No navegador, especifique o URI do ISAPI:http://computer_name/ibmcognos/isapi

Aumentando o Tempo Limite de CGIPara resolver um erro de tempo limite de CGI no navegador da Web, é possívelaumentar a duração do tempo limite de CGI no IIS.

Procedimento1. Nas ferramentas administrativas para o sistema operacional Microsoft

Windows, abra o Internet Information Services.

388 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 401: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

2. No nó do computador local, clique com o botão direito em Websites e selecionePropriedades.

3. Na guia Home Directory, clique em Configuração.4. Na guia Opções de processo, aumente o tempo limite do script CGI.

Falha da Classe de Servlet ao Carregar no WebLogicÉ possível que ocorram problemas ao configurar uma instalação de servidordistribuída e usar o WebLogic como servidor de aplicativos para o IBM Cognos BI.

Ao implantar o p2pd.war para o computador com Application Tier Components,poderão ser apresentadas exceções de servlet e o dispatcher não iniciará. O arquivocogserver.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 classcom.cognos.pogo.isolation.ServletWrapper for servletcfgss could not be loaded because therequested class was not found in the 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 PM EDT> <Error> <HTTP> <BEA-101216> <Servlet: "cfgss"failed to preload on startup in Web application: "p2pd".

javax.servlet.ServletException:[HTTP:101249][ServletContext(id=19023494,name=p2pd,context-path=/p2pd)]: Servletclass com.cognos.pogo.isolation.ServletWrapperfor servlet cfgss could not be loaded becausethe requested class was not found in the classpath /host2/bea812/user_projects/domains/c10/applications/p2pd/WEB-INF/classes.java.lang.ClassNotFoundException:com.cognos.pogo.isolation.ServletWrapper. atweblogic.servlet.internal.ServletStubImpl.prepareServlet (ServletStubImpl.java:799)

at weblogic.servlet.internal.WebAppServletContext.preloadServlet(WebAppServletContext.java:3252)

Para evitar este problema, não implante o aplicativo p2pd a partir do diretório deaplicativos do WebLogic. Crie o diretório p2pd em outro local e implante do novolocal.

Implementando o Aplicativo p2pd Fora do Diretório deAplicativos do WebLogicPara resolver problemas com a classe de servlet que falha ao carregar durante aimplementação do IBM Cognos Business Intelligence no WebLogic, implemente oaplicativo p2pd em um diretório diferente do diretório de aplicativos do WebLogic.

Procedimento1. Abra o IBM Cognos Configuration e configure o computador de Componentes

da 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

Apêndice C. Resolução de problemas 389

Page 402: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

4. Crie o arquivo p2pd.war.5. No diretório p2pd, extraia o arquivo p2pd.war para a instalação do WebLogic

utilizando o seguinte comando:%JAVA_HOME%/bin/jar xvfm "c10_location/p2pd.war

6. Inicie o WebLogic.7. No console do servidor do WebLogic, implante o aplicativo p2pd.

Ícones de Área de Trabalho ou da Janela do IBM CognosConfiguration Cintilam no Windows

Ao executar o IBM Cognos Configuration no sistema operacional MicrosoftWindows, você talvez note que os ícones da área de trabalho ou a janela do IBMCognos Configuration cintilam.

Procedimento

Inicie o IBM Cognos Configuration usando a opção da linha de comandos-noddraw.

A migração não funcionaDepois de instalar e configurar o IBM Cognos PowerPlay, não é possível encontraro Assistente de migração ou a migração é executada e nada acontece.

Procedimento

Para resolver o problema, faça o seguinte:v Os componentes do PowerPlay Server e PowerPlay Administration são

instalados no servidor do IBM Cognos PowerPlay .v Se instalar o IBM Cognos PowerPlay com o IBM Cognos Business Intelligence,

instale o componente Content Manager do IBM Cognos PowerPlay no mesmocomputador que o componente Content Manager do IBM Cognos BI.

v No computador em que o Content Manager está instalado, no IBM CognosConfiguration, em Ambiente, Serviço IBM Cognos BI, verifique se apropriedade Serviço de migração ativado está definida como Verdadeiro.

v Os componentes de migração do IBM Cognos Series 7 estão instalados nocomputador com o IBM Cognos Series 7 PowerPlay Server .

v O serviço de migração do IBM Cognos Series 7 é iniciado no computador doIBM Cognos Series 7 PowerPlay Server .

v Os usuários não conseguem executar uma tarefa de migração. Para obterinformações adicionais, consulte o Guia de Migração e Administração do IBMCognos PowerPlay.

Além disso, verifique se os usuários que executarão tarefas de migração têm aspermissões adequadas para criar uma tarefa de migração. No IBM CognosAdministration,– Clique em Configuração, Administração de Conteúdo.

– Clique no ícone Configurar Propriedades - Administração .– Clique na guia Permissões

– Assegure-se de que os usuários que executarem tarefas de migração tenhampermissões de Leitura, Gravação, Execução e Acesso à hierarquia.

390 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 403: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Traduções Ausentes para Nomes de Objetos em algunsCódigos de Idioma

Depois de atualizar o IBM Cognos Business Intelligence ou importar um archive,alguns nomes de objetos podem não ser localizados para determinados códigos deidioma. Por exemplo, Pastas Públicas, Minhas Pastas ou nomes de grupos sãoexibidos em inglês e não no idioma especificado.

Esse problema pode ocorrer nas seguintes situações:v O Cognos BI foi atualizado para uma versão mais nova, mas uma versão do

armazenamento de conteúdo mais antiga foi configurada como o ContentManager.

v Um archive que foi criado com uma versão anterior do Cognos BI foi importadapara uma versão mais recente do Cognos BI.

Por exemplo, você poderá encontrar nomes de objetos não traduzidos no código deidioma catalão, croata, dinamarquês, grego, casaque, norueguês, eslovaco, eslovenoou tailandês se a instalação do Cognos BI 10.2 for configurada com a versão 10.1do Content Manager. O suporte para os códigos de idioma supramencionados foiincluído nas versões 10.1.1 e 10.2 do Cognos BI, portanto a versão 10.1 do ContentManager não tem essas traduções.

Para incluir as traduções no ambiente Cognos BI, execute o seguinte procedimento.

Procedimento1. Inicie a Configuração do IBM Cognos no computador em que o Serviço do

Content Manager está instalado.2. No menu Ações, clique em Editar Configuração Global.3. Confirme se os códigos de idioma necessários estão listados nas guias Códigos

de Idioma de Conteúdo e Códigos de Idioma de Produto. Se os códigos deidioma estiverem ausentes, inclua-os e salve as mudanças.

4. Acesse o diretório c10_location/webapps/p2pd/WEB-INF/classes e confirme seexiste um arquivo de mensagens cmmsgsRL_locale.properties para cada códigode idioma necessário. Por exemplo, para o esloveno, esse arquivo demensagens é o arquivo cmmsgsRL_sl.properties.

5. No diretório c10_location\configuration, copie o arquivoupdateInitialContentNames.xml.sample e salve-o comoupdateInitialContentNames.xml.

6. Edite o arquivo updateInitialContentNames.xml:a. Especifique os códigos de idiomas que deseja incluir. Por exemplo,

modifique o arquivo da seguinte forma para exibir os nomes de objetos emcroata e esloveno:<updateInitialContentNames><locales><locale>hr</locale><locale>sl</locale></locales></updateInitialContentNames>

b. Remova ou comente a linha em qualquer outro código de idioma que nãoseja afetado pelo problema de localização.

c. Salve as mudanças.7. Inicie o serviço do IBM Cognos.8. Para incluir outro código de idioma posteriormente, repita essas etapas.

Apêndice C. Resolução de problemas 391

Page 404: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Resultados

Os nomes de objetos localizados são incluídos durante o processo de inicializaçãodo serviço IBM Cognos. É possível visualizar os resultados da operação do arquivocogserver.log. O arquivo updateInitialContentNames.xml é excluído no processopara evitar atualizações desnecessárias em cada reinicialização.

392 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 405: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Avisos

Estas informações foram desenvolvidas para produtos e serviços oferecidos nomundo inteiro.

Esse material pode ser disponibilizado pela IBM em outros idiomas. No entanto,pode ser requerido possuir uma cópia do produto ou da versão do produto nesteidioma a fim de acessá-lo.

É possível que a IBM não ofereça os produtos, serviços ou recursos discutidosnesta publicação em outros países. Consulte um representante IBM local para obterinformações sobre os produtos e serviços disponíveis atualmente em sua área.Qualquer referência a produtos, programas ou serviços IBM não significa queapenas produtos, programas ou serviços IBM possam ser usados. Qualquerproduto, programa ou serviço funcionalmente equivalente, que não infrinjanenhum direito de propriedade intelectual da IBM poderá ser usado emsubstituição a este produto, programa ou serviço. Entretanto, a avaliação everificação da operação de qualquer produto, programa ou serviço não IBM são deresponsabilidade do Cliente. Este documento pode descrever produtos, serviços ourecursos que não estão incluídos no Programa ou autorização de licença que vocêcomprou.

A IBM pode ter patentes ou solicitações de patentes pendentes relativas a assuntostratados nesta publicação. O fornecimento desta publicação não lhe concede direitoalgum sobre tais patentes. Consultas sobre licença devem ser enviadas, por escrito,para:

Gerência de Relações Comerciais e Industriais da IBM BrasilAv. Pasteur, 138-146BotafogoRio de Janeiro, RJCEP 22290-240

Para consultas sobre licença relacionadas a informações de DBCS (Conjunto deCaracteres de Byte Duplo), entre em contato com o Departamento de PropriedadeIntelectual da IBM em seu país ou envie consultas, por escrito, para:

Licenciamento de Propriedade IntelectualLei de Propriedade Legal e IntelectualIBM World Trade Asia Corporation Licensing19-21, Nihonbashi-Hakozakicho, Chuo-kuTokyo 103-8510, Japan

O parágrafo a seguir não se aplica a nenhum país em que tais disposições nãoestejam de acordo com a legislação local: > A INTERNATIONAL BUSINESSMACHINES CORPORATION FORNECE ESTA PUBLICAÇÃO “NO ESTADO EMQUE SE ENCONTRA”, SEM GARANTIA DE NENHUM TIPO, SEJA EXPRESSAOU IMPLÍCITA, INCLUINDO, MAS A ELAS NÃO SE LIMITANDO, ASGARANTIAS IMPLÍCITAS DE NÃO INFRAÇÃO, COMERCIALIZAÇÃO OUADEQUAÇÃO A UM DETERMINADO PROPÓSITO. Alguns países não permitema renúncia de responsabilidade de garantias expressas ou implícitas em certastransações; portanto, essa disposição pode não se aplicar ao Cliente.

© Copyright IBM Corp. 2005, 2014 393

Page 406: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Essas informações podem conter imprecisões técnicas ou erros tipográficos. Sãofeitas mudanças periódicas nas informações aqui contidas; tais mudanças serãoincorporadas em futuras edições desta publicação. A IBM pode, a qualquermomento, aperfeiçoar e/ou alterar os produtos e/ou programas descritos nestapublicação, sem aviso prévio.

Referências nestas informações a Web sites não IBM são fornecidas apenas porconveniência e não representam de forma alguma um endosso a esses Web sites.Os materiais contidos nesses Web sites não fazem parte dos materiais desteproduto IBM e o uso desses Web sites é de inteira responsabilidade do Cliente.

A IBM pode usar ou distribuir as informações fornecidas da forma que julgarapropriada sem incorrer em qualquer obrigação para com o Cliente.

Licenciados deste programa que desejam obter informações sobre este assunto compropósito de permitir: (i) a troca de informações entre programas criadosindependentemente e outros programas (incluindo este) e (ii) o uso mútuo dasinformações trocadas, devem entrar em contato com:

Gerência de Relações Comerciais e Industriais da IBM BrasilAv. Pasteur, 138-146BotafogoRio de Janeiro, RJCEP 22290-240

Tais informações podem estar disponíveis, sujeitas a termos e condiçõesapropriadas, incluindo em alguns casos o pagamento de uma taxa.

O programa licenciado descrito nesta publicação e todo o material licenciadodisponível são fornecidos pela IBM sob os termos do IBM Customer Agreement,do Contrato Internacional de Licença do Programa IBM ou de qualquer outrocontrato equivalente.

Todos os dados de desempenho aqui contidos foram determinados em umambiente controlado. Portanto, os resultados obtidos em outros ambientesoperacionais podem variar significativamente. Algumas medidas podem ter sidotomadas em sistemas em nível de desenvolvimento e não há garantia de que estasmedidas serão iguais em sistemas geralmente disponíveis. Além disso, algumasmedidas podem ter sido estimadas por extrapolação. Os resultados reais podemvariar. Os usuários deste documento devem verificar os dados aplicáveis para seuambiente específico.

As informações relativas a produtos não IBM foram obtidas junto aos fornecedoresdos respectivos produtos, de seus anúncios publicados ou de outras origensdisponíveis publicamente. A IBM não testou estes produtos e não pode confirmar aprecisão de seu desempenho, compatibilidade nem qualquer outra reivindicaçãorelacionada a produtos não IBM. Dúvidas sobre os recursos de produtos não IBMdevem ser encaminhadas diretamente a seus fornecedores.

Todas as declarações relacionadas aos objetivos e intenções futuras da IBM estãosujeitas a mudanças ou retirada sem aviso prévio e representam apenas metas eobjetivos.

Estas informações contêm exemplos de dados e relatórios usados nas operaçõesdiárias de negócios. Para ilustrá-los da forma mais completa possível, os exemplos

394 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 407: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

podem incluir nomes de indivíduos, empresas, marcas e produtos. Todos estesnomes são fictícios e qualquer semelhança com nomes e endereços usados por umaempresa real é mera coincidência.

Se estas informações estiverem sendo visualizadas em formato eletrônico, asfotografias e ilustrações coloridas podem não aparecer.

Dependendo das configurações implementadas, esta Oferta de Software pode usarcookies de sessão e persistentes coletadas de cada usuáriov nomev nome do usuáriov senha

para propósito dev gerenciamento de sessãov autenticaçãov usabilidade aprimorada do usuáriov configuração de conexão únicav rastreamento de uso ou propósitos funcionais diferentes de gerenciamento de

sessões, autenticação, usabilidade do usuário aprimorada e a configuração deconexão única

Estes cookies não podem ser desativados.

Se as configurações implementadas para essa Oferta de Software fornecem a você,como usuário, a capacidade de coletar informações pessoalmente identificáveis deusuários finais por meio de cookies e outras tecnologias, deve-se buscar o próprioconselho jurídico sobre quaisquer leis aplicáveis a tal coleta de dados, incluindoquaisquer requerimentos para aviso e consentimento.

Para obter mais informações sobre o uso de várias tecnologias, incluindo cookies,para estes propósitos, consulte a Política de Privacidade da IBMemhttp://www.ibm.com/privacy e a Declaração de Privacidade Online da IBM emhttp://www.ibm.com/privacy/details na seção intitulada "Cookies, Web Beacons eOutras Tecnologias" e "Produtos de Software IBM e a Declaração de Privacidade deSoftware como Serviço" em http://www.ibm.com/software/info/product-privacy.

Marcas Registradas

IBM, o logotipo IBM e ibm.com são marcas ou marcas registradas da InternationalBusiness Machines Corp., registradas em várias jurisdições em todo o mundo.Outros nomes de produtos e serviços podem ser marcas registradas da IBM ou deoutras empresas. Uma lista atual de marcas registradas da IBM está disponível naWeb na seção “ Copyright and trademark information ” no endereçowww.ibm.com/legal/copytrade.shtml.

Os termos a seguir são marcas ou marcas registradas de outras empresas:v Adobe, o logotipo Adobe, PostScript e o logotipo PostScript são marcas ou

marcas registradas da Adobe Systems Incorporated nos Estados Unidos e/ou emoutros países.

v Microsoft, Windows, Windows NT e o logotipo Windows são marcas registradasda Microsoft Corporation nos Estados Unidos, e/ou em outros países.

Avisos 395

Page 408: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

v Linux é uma marca registrada de Linus Torvalds nos Estados Unidos e/ou emoutros países.

v UNIX é marca registrada do The Open Group nos Estados Unidos e/ou emoutros países.

v Java e todas as marcas registradas e logotipos baseados em Java são marcas oumarcas registradas da Oracle e/ou de suas afiliadas.

396 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 409: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Glossário

Este glossário fornece termos e definições parasoftware e produtos IBM Cognos BusinessIntelligence.

As seguintes referências cruzadas são usadasneste glossário:v Consulte o encaminha de um termo não

preferencial para o termo preferencial ou deuma abreviação para a forma por extenso.

v Consulte também encaminha a um termorelacionado ou contrastante.

Para outros termos e definições, consulte owebsite IBM Terminology (abre em uma novajanela).

“A” “B” na página 398 “C” na página 398 “D” napágina 400 “E” na página 400 “F” na página 401“G” na página 401 “H” na página 401 “I” napágina 401 “L” na página 402 “M” na página 402“N” na página 403 “O” na página 403 “P” napágina 403 “R” na página 404 “S” na página 405“T” na página 405 “U” na página 406 “V” napágina 406 “W” na página 406

Aacesso anônimo

Um tipo de acesso que permite queusuários e servidores acessem umservidor sem serem autenticadosprimeiro.

agente Um processo que executa uma ação emnome de um usuário ou outro programasem intervenção do usuário ou em umaprogramação regular e relata osresultados de volta para o usuário ouprograma.

Agrupamento.Em relatórios, o processo de organizarvalores idênticos de itens de consultajuntos e exibir o valor somente uma vez.

alias Um nome alternativo usado em vez deum nome primário.

AnalyticsZoneUma comunidade online da IBM parabusiness analytics. Os usuários podemfazer download de produtos e

visualizações extensíveis, visualizarpublicações e materiais de treinamento,saber sobre eventos futuros da IBM eexecutar outras funções.

área de janela de informaçõesNo Analysis Studio, uma área de janelaque ajuda o usuário a confirmar suaseleção na árvore de dados, exibindoinformações relacionadas, como nível eatributos.

área de janela de propriedadesEm um studio, uma área de janela queoferece visão geral das propriedades deum dado selecionado. A área de janelapropriedades também pode ser usadapara fazer várias mudanças e aplicá-las aomesmo tempo, ao invés de repetir oscomandos diversas vezes.

área de trabalhoConsulte painel.

área de trabalhoA área de um studio onde se encontram orelatório, a análise, a consulta ou o agenteatual.

armazenamento de conteúdoUm repositório que é usado para conterespecificações de relatórios, modelos eorigens de dados.

armazenamento de métricaBanco de dados que contém conteúdopara pacotes de métrica. Oarmazenamento de métrica tambémcontém as configurações do Metric Studio,tais como preferências do usuário.

armazenamento localUm dispositivo acessado diretamente(sem telecomunicações) a partir dosistema do usuário, em que asinformações podem ser retidas erecuperadas posteriormente.

arquivo de respostaUm arquivo que pode ser customizadocom os dados de instalação econfiguração que automatizam umainstalação. Durante uma instalaçãointerativa, os dados de instalação econfiguração devem ser inseridos, mas

© Copyright IBM Corp. 2005, 2014 397

Page 410: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

com um arquivo de resposta, a instalaçãopode continuar sem qualquer intervenção.

arquivos de implementaçãoArquivo usado para implementação. Oarquivo de implementação contém osdados do armazenamento de conteúdoque estão sendo movidos.

árvore de dadosConsulte árvore de metadados.

árvore de metadadosNo studio, uma estrutura que contémobjetos como assuntos de consultas, itensde consultas, dimensões, níveis emembros. Uma árvore de metadados éusada como uma paleta dos dadosdisponíveis que podem ser inseridos emcálculos, filtros, áreas de exibição e outrasações de autoria.

atributoEm Modelagem BI, uma característica deuma entidade que é descritiva em vez deum identificador exclusivo ou umamedida agregativa.

autenticação (AuthN)O processo de validação da identidade deum usuário ou servidor.

AuthNConsulte autenticação.

autoridade de certificação (CA)Um componente que emite certificadospara cada computador no qual oscomponentes são instalados.

Bbiblioteca de visualizações

Uma coleção de visualizações extensíveisque são importadas para o IBM CognosAdministration para uso no Report Studioe no Cognos Workspace Advanced.

burst Criar diversos resultados de relatórioexecutando um único relatório uma sóvez. Por exemplo, o usuário pode criarum relatório que mostra as vendas decada funcionário e executá-lo uma só vez,enviando resultados diferentes paragerentes regionais escolhendo a região.

Ccapacidade

Um grupo de funções e recursos quepodem ser ocultados ou exibidos parasimplificar a interface com o usuário. Ascapacidades podem ser ativadas oudesativadas alterando os ajustes depreferência, ou controladas pela interfacede administração.

cardinalidade

1. Para origens de dados relacionais,uma indicação numérica dorelacionamento entre dois assuntos deconsulta, itens de consulta ou outrosobjetos modelo.

2. Para origens de dados OLAP, onúmero de membros em umahierarquia. A propriedade decardinalidade para uma hierarquia éusada para atribuir ordens deresolução a expressões.

cartão de informaçõesUma exibição de informações de altonível sobre conteúdo de painel, área detrabalho ou relatório, como proprietário,informações de contato, data demodificação e uma visualização miniaturaopcional do painel, área de trabalho ourelatório.

certificadoNa segurança do computador, umdocumento digital que une uma chavepública à identidade do proprietário docertificado, dessa forma possibilitandoque o proprietário do certificado sejaautenticado. Um certificado é emitido poruma autoridade de certificação que oassina digitalmente. Consulte tambémautoridade de certificação.

CGI Consulte Interface Gateway Comum.

chave burstDimensão ou nível de consulta naespecificação do relatório utilizada paracriar ou alternar um conjunto deresultados de relatório.

chave de eventoCombinação de itens da dados que defineexclusivamente uma instância de evento.Identificar uma instância de eventopermite que o agente determine se énovo, em andamento ou parado.

398 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 411: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

chave de leaseUm mecanismo de criptografia de tempodefinido que controla o acessoautenticado ao conteúdo armazenado emum dispositivo móvel.

CM Consulte Content Manager.

código do idiomaUm ajuste que identifica idioma e localgeográfico e determina convenções deformatação como ordenação, conversão decasos, classificação de caracteres, idiomadas mensagens, representação numérica ede data e hora.

código do idioma do conteúdoCódigo usado para configurar o idiomaou dialeto usado para navegadores e textode relatório; e as preferências regionais,como formatos de hora, data, dinheiro,expressões de dinheiro e período do dia.

código do idioma do produtoCódigo ou configuração que especificaidioma, configurações locais ou ambospara usar em partes da interface doproduto, como comandos do menu.

coluna definida pelo usuárioEm gerenciamento de métricas, a colunausada para representar um valor diferentedo verdadeiro ou do visado. Pode ser otamanho real ou qualquer outrainformações numérica adicional de umperíodo, inclusive cálculo baseado emoutros valores da métrica. As colunasdefinidas pelo usuário podem serdiferentes para cada tipo de métrica.

compatible query mode (CQM)O modo de processamento de consultaque é consistente com a versão 8.4.1 doCognos Business Intelligence, e que émantido para o sucesso do upgrade.Consulte também modo de consultadinâmica.

componente de camadas dos aplicativosPara a instalação, é o conjunto deprocessadores que acessam os bancos dedados de consultas para reunirinformações e transformar os resultadosem relatórios e métricas PDF e HTML. Oscomponentes de camadas de aplicativostambém passam as solicitações ao ContentManager e devolvem os resultados que oeste recupera do armazenamento deconteúdo.

condiçãoUma expressão que pode ser avaliadacomo verdadeira, falsa ou desconhecida.Ela pode ser expressa em texto de idiomanatural, em notação matematicamenteformal ou em um idioma legível pormáquina.

conexão da origem de dadosInformações nomeada que define o tipode origem de dados, sua localização físicae solicitações de entrada no sistema. Umaorigem de dados pode ter mais de umaconexão.

conjuntoUma coleção de itens ou membrosrelacionados. Os membros em umconjunto podem ser escolhidosespecificamente ou selecionados por umaou mais regras de filtro. Emprocessamento de consulta relacional, umconjunto é produzido por váriasoperações, como UNION, INTERSECT eEXCEPT. Consulte também conjuntocustomizado, conjunto baseado emdetalhes, conjunto de páginas, conjuntopredefinido, conjunto baseado na seleção,conjunto empilhado.

conjunto baseado em detalhesUm conjunto baseado em um item e seusdetalhes imediatos. Consulte tambémconjunto.

conjunto baseado na seleçãoUma coleção de itens individuaisselecionados explicitamente. Os itens oumembros podem ser selecionados de umou mais níveis da mesma hierarquia.Consulte também conjunto.

conjunto customizadoNo Analysis Studio, um objeto nomeadoque pode incluir regras de filtros eclassificação e cálculos. Conjuntoscustomizados podem definir um conjuntode membros que é diferente de qualqueroutro conjunto definido originalmente nomodelo de cubo. Consulte tambémconjunto predefinido, conjunto.

conjunto de códigosA combinação de autenticação, algoritmode troca de chave e especificações decodificação do SSL (Secure Sockets Layer)usada para a troca de dados segura.

Glossário 399

Page 412: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

conjunto de páginasNo Report Studio, um conjunto de umaou mais páginas criadas que se repete nosresultados de relatórios para cadainstância de um item de consultaescolhido. Consulte também conjunto.

conjunto designadoConsulte conjunto predefinido.

conjunto de uniãoConsulte conjunto empilhado.

conjunto empilhadoDois ou mais conjuntos arranjados unssobre os outros nas linhas ou lado a ladonas colunas. Consulte também conjunto.

conjunto pré-definidoConjunto de membros definido dentro deuma origem de dados OLAP como listaou por uma expressão. Conjuntospredefinidos podem ser usados na criaçãode análises e relatórios. Consulte tambémconjunto customizado, conjunto.

consultaUma questão de negócios formulada noCognos Business Intelligence é umaferramenta de estúdio ou modelagem querecupera dados de uma origem de dados.

contatoUm endereço de email nomeado para oqual os relatórios e emails de agentespodem ser enviados. Os contatos nuncasão autenticados.

Content Manager (CM)O serviço que recupera e salvainformações no armazenamento deconteúdo.

CQM Consulte compatible query mode.

credencialUm conjunto de informações que concedea um usuário ou processo determinadosdireitos de acesso.

criptografiaEm segurança de computador, o processode transformar dados em um formatoininteligível de forma que os dadosoriginais não possam ser obtidos oupossam ser obtidos somente usando umprocesso de decriptografia.

cubo Uma representação multidimensional dedados necessários para processamentoanalítico on-line, relatórios

multidimensionais ou aplicativos deplanejamento multidimensional.

cubo dinâmicoUma representação multidimensionalcontida na memória de um subconjuntode um data warehouse.

Ddados relacionais modelados dimensionais(DMR)

Metadados que foram modelados paraapresentar dados relacionais (tabelas,colunas, junções) como dimensões(membros, medidas).

desempenhoNúmero ou classificação que expressa aaplicabilidade em relação a um padrão.

dimensãoUm grupo amplo de dados descritivossobre um aspecto principal de negócios,como produtos, datas ou locais. Cadadimensão inclui níveis diferentes demembros em uma ou mais hierarquias eum conjunto de membros calculados oucategorias especiais.

DMR Consulte dados relacionais modeladosdimensionais.

DQM Consulte modo de consulta dinâmica.

drill downEm uma representação multidimensionalde dados, o acesso a informaçõesiniciando com uma categoria geral paramais específicas pela hierarquia deinformações, por exemplo, de Anos paraTrimestres para Meses.

Eespecificação de implementação

Uma definição de quais objetos mover(implementar) entre um ambiente deorigem e de destino, as preferências deimplementação e o nome do archive. Asespecificações de implementação sãousadas para importação e exportação.

especificação do relatórioUma definição executável de um relatório,incluindo regras de consulta e layout, quepode ser combinada com dados paraproduzir uma saída de relatório. Consultetambém relatório.

400 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 413: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

estilo de classeCombinação de características deformatação, como fonte, tamanho de fontee margem, que o usuário nomeia earmazena como um conjunto.

estratégiaO plano geral de ação (como umaunidade de marca, unidade de negócios,canal ou empresa) para atingir umobjetivo estabelecido. Estratégiasgeralmente cobrem período maior do queum ano.

estrutura do scorecardHierarquia dos scorecards que refletecomo uma empresa organiza suasmétricas.

etapa de tarefaA menor parte de uma tarefa que podeser executada separadamente. A etapa detarefa pode ser um relatório ou outratarefa.

eventoUma mudança para um estado, como aconclusão ou fracasso de uma operação,processo de negócios ou uma tarefamanual, que pode desencadear uma açãocomo manter os dados do evento em umdepósito de dados ou trazer outrosprocessos de negócios.

extração de métricaUm conjunto de mapeamentos entre umaorigem de dados existente do Cognos eum valor ou objeto do Metric Studio. Porexemplo, uma medida de cubo chamadaRevenue é mapeada para uma métrica doMetric Studio chamada Revenue ActualValue.

extração de objetoUma extração que define os metadadospara um objeto do Metric Studio, comouma coluna definida pelo usuário, umscorecard ou uma origem de dados.

Ffato Consulte medida.

Ggateway

Extensão de um programa do servidor daWeb que transfere informações doservidor da Web para um outro servidor.

As gateways em geral são programasCGI, mas podem seguir outros padrões,como módulos ISAPI e Apache.

glifo O formato real (padrão de bits, contorno)de uma imagem de caractere. Porexemplo, A em itálico e A romano sãodois glifos diferentes que representam omesmo caractere base. Resumindo,quaisquer duas imagens que diferem emformato constituem glifos diferentes.Neste uso, glifo é sinônimo de imagem docaractere ou simplesmente imagem (OPadrão Unicode – Versão 1.0).

grupo Uma coleção de usuários que podecompartilhar permissões de acesso derecursos protegidos.

Hhierarquia

A organização de um conjunto deentidades em uma estrutura de árvore,em que cada entidade (exceto a raiz)possui uma ou mais entidades pais e umnúmero arbitrário de entidades filhas.

Iimplementação

Processo de transferência de aplicativos(como um relatório ou modelo) para umainstância diferente. Por exemplo, comfrequência os relatórios são criados emum ambiente de teste e, em seguida,implementados para a produção. Quandoum aplicativo é implementado, ele éexportado, transferido e importado.

índice derivadoMétrica calculada que fornece status epontuação baseados em outras métricas.

iniciativaUma tarefa desenvolvida para alcançarobjetivos ou preencher o vazio entredesempenho e metas. As iniciativas sãoassociadas a objetivos individuais efrequentemente conhecidas como projetos,ações ou atividades.

Interface Gateway Comum (CGI)Um padrão da Internet para a definiçãode scripts que passam informações doservidor web para um programa deaplicativo, por meio de solicitação HTTP,e vice-versa.

Glossário 401

Page 414: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

item Consulte membro.

item de consultaUma referência nomeada em um modeloou relatório a uma coluna de banco dedados, um cálculo ou item de consulta emoutro assunto de consulta.

item de notíciasEntrada única em um formato RSS (reallysimple syndication) compatível. Podeincluir título, texto e um link para maisinformações. Uma tarefa de item denotícias em um agente pode ser usadapara criar itens de notícias a seremexibidos em um portlet do CognosConnection.

Llayout A disposição de material exibido em uma

tela ou página, incluindo margens,espaçamento entre linhas, especificação detipo, informações de cabeçalho e rodapé eindentações.

lista de eventosConjunto de instâncias detectadas deevento avaliadas por regras de execuçãode tarefa, para determinar quais tarefas deagentes devem ser realizadas.

lista de observaçãoLista de métricas que cada usuárioescolheu para monitorar mais de perto. Sea notificação estiver ativada no MetricStudio, o usuário receberá umanotificação por email de mudanças nessasmétricas. Os usuários também podemescolher exibir a lista de observação comoum portlet no Cognos Connection.

Mmacro Um fragmento de código que pode ser

inserido em diversos locais em modelos erelatórios, como expressões de cálculo ede filtro e instruções SQL. As macrospodem incluir referências a parâmetros desessão, mapas do parâmetro, entradas domapa do parâmetro e funções de uso paracustomizar aplicativos dinamicamente.Com macros, um único relatório podetratar diferentes cenários de negócios.

mapa de estratégiaNo Metric Studio, mapa de estratégia éuma representação visual da estratégia e

dos objetivos da mesma para umaorganização. Por exemplo: um mapa deestratégia pode mostrar aos funcionáriosse suas tarefas estão de acordo com osobjetivos gerais da organização.

MDX Consulte Linguagem de ExpressãoMultidimensional.

medidaIndicador quantificável de desempenhousado para determinar a qualidade dofuncionamento do negócio. Por exemplo:as medidas podem ser Receita,Receita/Funcionário e porcentagem deMargem de Lucro.

membroUm item único dentro de uma hierarquia.Por exemplo: Materiais de acampamentoe barraca 4 Man são membros dahierarquia Produtos.

membro calculadoMembro de uma dimensão cujos valoresde medida não são armazenados, mascalculados no tempo de execução usandouma expressão.

métricaUma medida que avalia uma área denegócios principal.

miniaturaUm processamento em tamanho de íconede uma imagem gráfica maior quepermite que o usuário visualize a imagemsem abrir uma visualização ou um editorgráfico.

modeloRepresentação física ou comercial daestrutura de dados de uma ou maisorigens de dados. O modelo descreve osobjetos, estrutura e agrupamento dedados, bem como relacionamentos esegurança. No Cognos BI, um modelo écriado e mantido no Framework Manager.O modelo ou subconjunto do modelodeve ser publicado no servidor Cognoscomo um pacote para os usuários criareme executarem relatórios.

modelosNa criação de relatórios, layout ou estilode relatório reutilizável que pode serusado para configurar a apresentação deuma consulta ou relatório.

402 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 415: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

modo de consulta dinâmica (DQM)Um modo de execução de consultabaseado em Java que fornece acessonativo a origens de dados. Ele otimizaconsultas para tratar a complexidade daconsulta e grandes volumes de dados.Fornece recursos de consulta avançados,como armazenamento em cache contidona memória, que beneficia oplanejamento, execução e resultados daconsulta. Consulte também compatiblequery mode.

Multidimensional Expression Language (MDX)Uma linguagem de consulta para origensdimensionais.

Nnamespace

Uma parte do modelo em que os nomespodem ser definidos e usados. Dentro deum namespace, cada nome possui umsignificado exclusivo.

NC Consulte autoridade de certificação.

nível Um conjunto de entidades ou membrosque formam uma seção de hierarquia emuma dimensão e que representam omesmo tipo de objeto. Por exemplo, umadimensão geográfica pode conter níveispara região, estado e cidade.

número de identificação pessoal (PIN)Em Cryptographic Support, um númeroexclusivo designado por uma organizaçãoa uma pessoa e usado como prova deidentidade. Os PINs são comumentedesignados por instituições financeiras aseus clientes.

Oobjeto No Report Studio, um contêiner de

informações vazio que pode ser arrastadoa relatórios da guia Caixa de ferramentase preenchido com dados. Os relatórios sãocompostos por objetos, que incluemtabelas cruzadas, itens de texto, cálculos,gráficos e tabelas.

origem de dadosA própria origem de dados, como umbanco de dados ou arquivo XML, e asinformações de conexão necessárias paraacessar os dados.

origem de dados dimensionalUma origem de dados contendo dadosmodelados usando conceitosmultidimensionais OLAP, incluindodimensões, hierarquias e medidas.

origem de dados multidimensionaisConsulte origem de dados dimensional.

Ppacote Um subconjunto de um modelo, que pode

ser o modelo inteiro, a ser disponibilizadoao servidor Cognos. Consulte tambémpacote de métricas.

pacote configurável de visualizaçãoUm arquivo compactado que contéminformações necessárias para autores derelatórios incluírem uma visualizaçãoextensível em relatórios.

pacote de métricaNo Cognos Connection, umarepresentação de um aplicativo MetricStudio. O pacote de métrica contéminformações de conexão, relatórios etarefas de gerenciamento de métrica paraesse aplicativo. Consulte também pacote.

painel Uma página da web que pode conter umou mais widgets que representam dadosde negócios graficamente.

passaporteInformações baseadas em sessões,armazenadas e criptografadas na memóriado Content Manager, relativas a usuáriosautenticados. Um passaporte é criado naprimeira vez que o usuário acessa oCognos 8 e é retido até o termino dasessão, seja quando o usuário efetualogoff ou após um período de inatividadeespecificado.

perfil de interface com o usuárioUm perfil que define o comportamentopadrão, conjunto de recursos e afuncionalidade que está disponível paraum usuário nas interfaces com o usuáriodo Report Studio e do Cognos WorkspaceAdvanced.

permissões de acessoUm privilégio que permite o acesso ouuso de um objeto.

PIN Consulte número de identificação pessoal.

Glossário 403

Page 416: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

portletComponente reutilizável que é parte doaplicativo web que fornece informaçõesou serviços específicos a seremapresentados no contexto do portal.

projeto

1. No Metric Designer, um grupo deextrações. Cada extração contém osmetadados usados para povoar oarmazenamento de dados do MetricStudio ou criar aplicativos.

2. No Metric Studio, uma tarefa ouconjunto de tarefas executadas poruma equipe e monitoradas em umscorecard. Um projeto controla asdatas, os recursos e o status.

promptElemento do relatório que solicita valoresde parâmetro antes de executar orelatório.

prompt em cascataUm prompt que usa valores de umprompt anterior para filtrar valores noprompt atual ou na lista de seleção.

provedor de autenticaçãoMecanismo de comunicação a umaorigem de autenticação externa.Funcionalidades como autenticação deusuário, filiações de grupos e procuras denamespace ficam disponíveis por meio deprovedores de autenticação.

provedor de segurançaConsulte provedor de autenticação.

proxy reversoUma topologia de encaminhamento de IPem que o proxy está em nome doservidor HTTP de backend. É um proxyde aplicativo para servidores que usamHTTP.

publicaçãoNo Cognos Business Intelligence, exporinformações no servidor Cognos para queos dados possam ser usados para criarrelatórios e outro conteúdo.

RRapidly Adaptive Visualization Engine (RAVE)

Um sistema para a visualização geral detodos os formatos de dados. O RAVE éintegrado no IBM Cognos Business

Intelligence e permite visualizaçõesinovadoras e interativas.

RAVE Consulte Rapidly Adaptive VisualizationEngine.

Really Simple Syndication (RSS)Um formato de arquivo XML parawebcontent sindicado que é baseado naespecificação Really Simple Syndication(RSS 2.0). Os formatos de arquivo XMLRSS são usados por usuários da Internetpara assinar Web sites que forneceramalimentações RSS. Consulte também RichSite Summary.

rede privada virtual (VPN)Uma extensão de uma intranet daempresa na estrutura existente de umarede pública ou privada. Uma VPNassegura que os dados que são enviadosentre dois terminais de sua conexãopermaneçam seguros.

regra de observaçãoCondição definida pelo usuário quedetermina se o relatório foi entregue a ele.Quando a regra é executada, a saída éavaliada e, se satisfizer a condição ouregra, o relatório será entregue por emailou item de notícias. As regras deobservação limitam a entrega do relatórioa apenas relatórios que contenham dadosimportantes para o usuário.

regras de execução da tarefaOpções especificadas pelo usuário em umagente que determinam quais são osstatus e os valores que provocam aexecução de uma tarefa. Isso determinaquais tarefas executar em cada instânciade evento.

relatórioConjunto de dados propositadamenteexpostos para comunicar informações denegócios. Consulte também especificaçãode relatório.

relatório ativoUm tipo de saída de relatório que forneceum relatório gerenciado altamenteinterativo e fácil de usar que os usuáriospodem consumir offline. Os relatóriosativos são criados para usuários denegócios e permitem a exploração dedados e a derivação de insight adicional.

repetidorNo Report Studio, contêiner de célula que

404 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 417: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

repete os valores contidos em si mesmosem estrutura interna definida.

restrição

1. Uma especificação de segurança quenega a um ou mais usuários acapacidade de acessar um componentede modelo ou de executar uma tarefade autoria ou modelagem.

2. Uma restrição dos valores possíveisque os usuários podem inserir em umcampo.

resumoNa realização do relatório e na análise,um valor agregado calculado para todosos valores de um determinado nível dadimensão. Exemplos de resumos: total,mínimo, máximo, médio e calcular.

Rich Site Summary (RSS)Formato baseado em XML para oconteúdo da web organizado que sebaseia na especificação RSS 0.91. Osformatos de arquivo XML RSS são usadospor usuários da Internet para assinar Websites que forneceram alimentações RSS.Consulte também Really SimpleSyndication.

RSS

1. Consulte Rich Site Summary.2. Consulte Really Simple Syndication.

Ssaída de relatório

A saída produzida como resultado daexecução de uma especificação derelatório contra um conjunto de dados.

scorecardUma coleção de métricas representando odesempenho de uma unidade ou aspectode uma organização.

scorecard de responsabilidadeScorecard que o Metric Studio criaautomaticamente para cada usuário quecontém todas as métricas e projetos quepossuem.

Secure Sockets Layer (SSL)Um protocolo de segurança que forneceprivacidade de comunicação. Com SSL, osaplicativos cliente/servidor podem secomunicar de uma maneira que foiprojetada para evitar espionagem do

tráfego de rede, violação e falsificação demensagens. Consulte também autoridadede certificação.

Segurança da Camada de Transporte (TLS)Um conjunto de regras de criptografiaque usa certificados e chaves decriptografia verificados para protegercomunicações na Internet. TLS é umaatualização do protocolo SSL.

Serviços da Web para Portlets RemotosPadrão para a criação de serviços da weborientados por apresentações, para quesejam facilmente integrados a outrosaplicativos, como portais da web.

sessão O tempo que um usuário autenticadopermanece logado.

SSL Consulte Secure Sockets Layer.

TTabela de repetição.

No Report Studio, contêiner em forma detabela que repete as células por toda apágina ou linha na consulta associada.

tarefa Ação executada por um agente caso ostatus do evento corresponda às regras deexecução da tarefa. Por exemplo: o agentepode enviar um email, publicar um itemde notícias ou executar um relatório.

tarefa Grupo de objetos executáveis comorelatórios, agentes e outras tarefas que ousuário executa e agenda como um lote.

tela Uma área dentro de um painel ou área detrabalho com a qual usuários interagempara criar, visualizar e manipularconteúdo e dados.

tema de consultaUma coleção nomeada de itens deconsulta que estão relacionados demaneira funcional. Em termos conceituais,isso é semelhante a uma consulta definidapara um banco de dados ou visualização.

tipo de métricaCategoria de métricas que define asregras do negócio tais como o padrão dedesempenho, unidades e significado deum grupo de métricas. Por exemplo:Receita pode ser um tipo de métrica, eReceita européia e Receitanorte-americana, as suas métricas.

Glossário 405

Page 418: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

TLS Consulte Segurança da Camada deTransporte.

tupla Uma coleção ordenada de dois ou maismembros provenientes de dimensõesdiferentes. Por exemplo, a tupla (2007,Materiais de acampamento, Japão)apresenta o valor da intersecção dos trêsmembros (2007, Materiais deacampamento e Japão). Pode-se usar astuplas para filtrar e classificar dados, ecriar cálculos.

Uusuário

Qualquer indivíduo, organização,processo, dispositivo, programa, protocoloou sistema que usa os serviços de umsistema de computação.

Vvisualização de relatório

Referência a outro relatório que tempropriedades exclusivas, como valores deprompt, esquemas e resultados. Asvisualizações de relatório podem serusadas para compartilhar umaespecificação de relatório ao invés decopiá-la.

VPN Consulte rede privada virtual.

Wwidget

Um aplicativo móvel e reutilizável ouparte do conteúdo dinâmico que pode sercolocado em uma página da web, receberentrada e comunicar-se com um aplicativoou com outro widget.

406 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 419: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Índice Remissivo

AA Companhia de Aventuras de Amostra 9acesso

configurando acesso seguro ao portal 89, 131acesso à rede

compartilhando locais de dados 274acesso anônimo

desativando 89, 131Administração do PowerPlay 390AIX

erro ao se conectar ao banco de dados DB2 360suporte para namespace RACF 199variáveis de ambiente para instalar o IBM Cognos BI 67,

113, 134, 142ajuste

Armazenamento de conteúdo do DB2 318Algoritmo de confidencialidade 214alias da web

recurso alterado na versão 10.1.0 3aliases

configurando em servidores da Web 91, 148aliases web

IBM Cognos BI 91, 148alimentações RSS

resolução de problemas 346alteração

codificação para e-mail 269definições de configuração padrão 208modelo de configuração 319URIs 211versões Java 206

ambientes suportados 27amostras 9

conexões de origens de dados 163importação 164instalando 163testando um relatório 164

amostras da Companhia de Aventuras de Amostrainstalando 163

amostras do IBM Cognos BI 9Analysis Studio

descrição do componente 7Apache Tomcat

nenhum servidor de aplicativos padrão 1aplicativo do painel 4archive Web

implantação do IBM Cognos BI 329archives corporativos

implantação do IBM Cognos BI 329armazenamento de conteúdo

atualização 359configurações inválidas 355configurando clientes de banco de dados 79criando 65, 232criando áreas de tabela 74, 119criando no Oracle 39descrição do componente 10diretórios JDBC 79diversas versões do IBM Cognos BI 53e outros locais para armazenar saída de relatório 225excluindo tabelas do banco de dados 373

armazenamento de conteúdo (continuação)fazendo backup 207, 291gerenciamento de conexão 85, 125requisitos para alterar o servidor de aplicativos 290utilizando SSL 246versões compatíveis do DB2 e de Java 354

Armazenamento de conteúdo do DB2 318erro ao executar o script C8DB2.sh 382script 73, 118

armazenamento de métricamelhorando o desempenho 321

armazenamento de objeto externopara saída de relatório 229testando conexão 230

armazenamentos de métricasfalha 388

arquitetura 11arquivando

saída de relatório 226arquivo .ats

usando para remover componentes 312arquivo cogroot.link 378arquivo cogstartup.lock 349arquivo cogstartup.xml 324, 328

alterando propriedades manualmente 326arquivo inválido 380

arquivo cogstartup.xml inválido 380arquivo de especificação de transferência

usando para remover componentes 312arquivo de especificação de transferência (.ats)

configuração 307arquivo JAR

erro ao fazer configuração 380arquivo p2pd.war para WebLogic 368arquivo response.ats 307, 308arquivos

não localizada 363arquivos chase_referral 171arquivos de biblioteca

para instalação de 32 bits versus 64 bits 36arquivos de configuração

applications.xml para Portal Services 278coglocale.xml 326cogstartup.xml 324exportação 311

arquivos de implementaçãoem movimento 60importando 61

arquivos de log 348configuração de inicialização 348configuração do código do idioma 349desinstalação 350erros do gateway 349modo silencioso 350resumo de transferência 348tempo de execução 349transferência 348

arquivos do provedor de segurançacopiando na JVM do servidor de aplicativos 208

arquivos EAR,Veja archives corporativos

© Copyright IBM Corp. 2005, 2014 407

Page 420: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

arquivos WAR,Veja archive Web

ASCIIrequisitos para diretório de instalação 362

assinandomodelos de resolução de problemas 346

Assistente de migraçãodescrição do componente 9não funciona 390

Assistente para Construção de Aplicativo 295atalhos de teclado 337ativação

IBM Cognos Application Firewall 217serviços 220SSL para um servidor de aplicativos 303

atributo de contexto não pode ser desserializado 368atualização 49

afeta caracteres chineses, japoneses ou coreanos 369ambiente java 32, 208armazenamento de conteúdo 57, 359comparando relatórios de versões diferentes 63de outros produtos IBM Cognos para o IBM Cognos BI 21especificações do relatório 62IBM Cognos BI em um servidor de aplicativos 305movendo conteúdo 56processo 49recursos 51tarefas 53traduções ausentes de nomes de objetos 391visualizando conteúdo de uma versão anterior 53

atualizadorinstalando 71, 117, 137, 146

auditorialogs 254

autenticaçãoárvores de domínio para Active Directory Server 171CA SiteMinder 196conexão única usando LDAP 195conexão única usando o Active Directory Server 172conexão única usando o namespace do IBM Cognos Series

7 178conexão única usando RACF 201conexão única usando SAP 203configurando namespace do IBM Cognos Series 7 177desativando logon anônimo 166excluindo namespaces 204função SaferAPIGetTrustedSignon 179LDAP 183, 184LDAP usando Active Directory Server 185LDAP usando IBM Directory Server 188LDAP usando Novell Directory Server 189LDAP usando Oracle Directory Server 191plug-ins de conexão confiável para IBM Cognos Series

7 179propriedades customizadas para Active Directory

Server 170propriedades de usuário customizadas para LDAP 193provedor Siteminder 198provedores de autenticação customizada 181requisitos para conexão única com Microsoft Analysis

Server ou Microsoft SQL Server 168SAP 201Servidor Active Directory 168SSL usando LDAP 194usando namespaces 165

autenticação do Kerberos 173ativando a conexão única 283

autenticação do Kerberos (continuação)criando uma origem de dados 286namespace do Active Directory Server 285

Autenticação do Kerberosdelegação restrita 175

autenticação do Windows 172autoridade de certificação

configurando 235configurando o serviço 235

Bbalanceamento de carga 43

ativando e desativando serviços 220configuração 15configurando definições do servidor de correio 129

banco de dadosDB2 em z/OS 81o cliente falha ao conectar 372tabelas não criadas 371

Banco de dados de conteúdo do Cognosalterando usuários e senhas 209descrição do componente 8melhorando o desempenho 319

banco de dados de criação de logcriando usando DB2 36criando usando Microsoft SQL Server 40criando usando Oracle 39criando usando servidor de banco de dados Informix 41criando usando Sybase 42diretrizes de criação 255utilizando SSL 246

banco de dados de logexcluindo tabelas 373

banco de dados de notificaçãoconfigurando 232criando 231criando áreas de tabela 74, 119excluindo tabelas 373utilizando SSL 246

bancos de dadosarmazenamento de conteúdo 232cliente do banco de dados de criação de log 255criação de log 258excluindo tabelas 373notificação 129utilitário de carregamento em massa ausente 388

bancos de dados de consulta 11

CCA,

Veja autoridade de certificaçãoCA SiteMinder 196

configurando namespaces 198verificação de script cruzado no IBM Cognos Application

Firewall 217caminhos

configuração para cookies 271caracteres

codificação não suportada 355caracteres acentuados

não exibidos apropriadamente 370caracteres coreanos

corrompidos durante a instalação no Linux 366exibidos incorretamente após a atualização 369

408 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 421: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

caracteres de byte duploexibidos de forma inadequada 370

caracteres especiaisnas propriedades do namespace LDAP 183

caracteres exibidos incorretamente 370caracteres incompatíveis 355caracteres japoneses

corrompidos durante a instalação no Linux 366exibidos incorretamente após a atualização 369

catálogos e relatórios Impromptumigração para o IBM Cognos BI 21

Certificados 1024-bit 233certificados CA 233Certificados SHA1 233chave simétrica comum 213chaves criptográficas

fazendo backup e excluindo 207, 291gerando novamente 377

Chinêscaracteres corrompidos durante a instalação no Linux 366caracteres exibidos incorretamente após a atualização 369

Chinês simplificadoconfigurando fontes 221, 224

cintilação 390cintilação de tela 390cliente 12

métodos de instalação 102, 141não se conecta ao banco de dados 372

cliente de banco de dadosconfigurando 79configurando para um banco de dados de criação de

log 255clientes móveis

instalando 102, 141CM-SYS-5001 Ocorreu um erro interno no Content

Manager 382codificação de e-mail em tailandês

requisitos do JRE 269código do idioma do usuário

mapeando para o código do idioma do conteúdo 266códigos de idioma do produto

exibindo códigos do idioma suportados 264mapeando para a interface com o usuário 268

códigos do idiomaexibindo códigos de idioma do produto suportados 264exibindo códigos do idioma de conteúdo suportados 265traduções ausentes de nomes de objetos 391

códigos do idioma do conteúdocustomização 265exibindo códigos do idioma suportados 265mapeando para o código do idioma do usuário 266

códigos do produtonos arquivos de especificação de transferência 312

Coexistência 53cogconfig.sh

opções da linha de comandos 339Cognos Mobile

executando sem um servidor da web 102, 141Cognos Viewer

descrição do componente 6Cognos Workspace domínios aprovados 217comando uninst 312comando uninstnx 312componente do cliente do PowerPlay 10componentes 5

amostras do IBM Cognos BI 9Analysis Studio 7

componentes (continuação)armazenamento de conteúdo 10Assistente de migração 9Banco de dados de conteúdo do Cognos 8Cognos Viewer 6componentes de camadas de aplicativos 15, 16Content Manager 8, 15, 65distribuindo 18gateways 6, 14, 65IBM Cognos Administration 6IBM Cognos Configuration 6IBM Cognos Connection 6IBM Cognos Workspace 7instalando 65instalando em um computador 13opcionais 8origens de dados 11outro 5requisitos de instalação para sistemas de 64 bits 16Serviço de Migração 9servidor 12servidor de relatório 65utilitário de conversão de marcador 9

Componentes da camada de aplicativosinstalando 65servidor de log 254

componentes de camadas de aplicativosinstalando no computador separado 15requisitos de configuração 16

componentes de migração 9componentes do cliente 10componentes do Cognos Mobile 11componentes do servidor 5, 12

sequência de instalação 109comunicação LDAP segura 194conexão única

namespace do Active Directory 172namespace LDAP 195namespace RACF 201namespace SAP 203problemas com Integrated Windows Authentication 384usando o namespace do IBM Cognos Series 7 178utilizando Autenticação do Kerberos 283

conexõesorigem de dados 163

conexões de origens de dadosconfiguração 85, 125

conexões do banco de dados 125confiança compartilhada

configurando entre o IBM Cognos BI e outrosservidores 243

configuraçãoalterando configurações padrão 208alterando o modelo 319arquivo de bloqueio 349automatizando 307configurações globais 263configurações não aplicadas 381configurações padrão 208configurações para IBM Cognos BI 33, 208Content Manager 15dados bloqueados 379diversas versões do IBM Cognos BI 53erro ao criptografar informações 376executando a partir da linha de comandos 328fazendo backup 207, 291incluindo recursos 324

Índice Remissivo 409

Page 422: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

configuração (continuação)informações de criptografia não podem ser

criptografadas 376não assistida 307, 311não é possível abrir o IBM Cognos Configuration 349não é possível salvar 379problemas 372requisitos para conexão única com Microsoft Analysis

Server ou Microsoft SQL Server 168teste 101

configuração de clientebancos de dados do DB2 73, 118

Configuração do fornecedor de autenticação RACFrecurso alterado na versão 10.1.0 4

configuração não assistidaalterando propriedades 326configurando 307

configuraçõesreconfigurando ao atualizar o IBM Cognos BI 371

configurações avançadasreconfigurando ao atualizar o IBM Cognos BI 371

configurações de ulimit 31configurações inválidas

armazenamento de conteúdo 355IBM Cognos Configuration 355

configurações móveisreconfigurando ao atualizar o IBM Cognos BI 371

configurando 339arquivo de especificação de transferência (.ats) 307bancos de dados de notificação 232confiança compartilhada com outros servidores 243contas de servidor de correio 88Content Manager em espera 127destino para mensagens de log 254diretórios JDBC 79fontes 221fuso horário padrão 269gateways 147IBM Cognos BI 43local de arquivos temporários 219namespace do Active Directory 168namespace LDAP 184namespace LDAP para Active Directory Server 185namespace LDAP para IBM Directory Server 188namespace RACF 199namespace SAP 202não assistida 311Navegadores da Web 44Portal Services 277propriedades do ambiente para componentes da camada

do aplicativo 139propriedades do servidor de aplicativo 299propriedades em uma configuração não assistida 326protocolo SSL 240provedor SiteMinder 198provedores de autenticação customizada 181serviço de autoridade de certificação 235serviço do IBM Cognos 319servidor de correio 129Servidor web 91, 148

conjuntos de códigosconfigurando uma prioridade para conexões SSL 244

construçõesexecutando no IBM Cognos Connection usando serviço

Movimentação de Dados 25

conta do usuáriorequisitos para execução do serviço do IBM Cognos 83,

124, 138, 146, 205contas de servidor de correio

configurando 88Content Manager

alterando fusos horários 269ativo e em espera 112, 228componente 15configuração 15configurando em diversos computadores 127configurando um armazenamento de conteúdo 232descrição do componente 8espera 15falha ao iniciar 360instalando 65Mensagens de erro. 382opções de instalação 15proteção contra failover 15replicação 228requisitos em caso de uso do IBM Cognos Transformer com

namespace Series 7 65, 177requisitos para alterar o servidor de aplicativos 290salvando saída de relatório externamente 229servidor de log 254tentar registrar o dispatcher 360

Content Manager ativo 112Content Manager em espera 15, 112

configurando 127conversão

de marcadores do IBM Cognos Series 7 para o IBM CognosPowerPlay 9

de relatórios em ppr para relatórios em ppx 9conversão de relatórios

do formato ppr para o formato ppx 9Cookies

ativando em navegadores da Web 44configurações 271customizando 271

cookies HTML,Veja Cookies

correções de partesservidores de aplicativos 290

credenciais do usuárioalterando na configuração não assistida 326

criação de logbanco de dados 258cliente de banco de dados 255configurando 258servidores remotos de log 257usando arquivos 258

criandoarmazenamento de conteúdo 65

criptografiaalterando definições na configuração não assistida 326erros de configuração 376

criptografia de propriedades de arquivo temporário 219cubos

não é possível abrir 362

Ddados

bloqueados pelo IBM Cognos Configuration 379compartilhando locais de dados em uma rede 274

Data Managerusando no IBM Cognos BI 25

410 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 423: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

DB2configuração de cliente 73, 118criando um banco de dados móvel no z/OS 81diretórios JDBC 80drivers de banco de dados 73, 118especificando como um repositório de mensagem de

log 258no z/OS como banco de dados 81versões de Java suportadas 354

DB2-ERR-0005 385Derby

tamanho do cache da página 319desativando

acesso anônimo 89, 131descrição do produto xidesempenho

estimando 320estimando a largura da banda 320estimando servidores 320

desinstalaçãoFramework Manager 334IBM Cognos BI 333, 334Transformer 334

desinstalação autônoma 312desinstalação no modo silencioso 312destinos de log

tipos de 254determinação de problema

trocando informações com o suporte IBM 345diagnósticos

Veja resolução de problemasdiferenças

entre o IBM Cognos Series 7 PowerPlay e o IBM CognosPowerPlay xi

diretório de instalaçãoproblemas depois de renomear ou mover 378

diretório-raizpara salvar saída de relatório fora do IBM Cognos BI 225

diretórios JDBCbancos de dados Oracle 80configurando 79configurando bancos de dados Oracle 256DB2 80

diretórios virtuaisIBM Cognos BI 91, 148

dispatcherremovendo o registro 305

dispatchersComputador Componentes da camada de aplicativos 389excluindo 58importando 61métricas do sistema 313

displayLognova descrição do recurso para versão 10.2 3

distribuição de relatórioem uma rede 322

documentaçãoSoftware Development Kit 3

domíniosaprovados para o Cognos Workspace 217árvores de domínio do Active Directory Server 171configuração para cookies 271

drivers de banco de dadosDB2 73, 118Informix 79, 123, 257Oracle 78, 123Sybase 79, 123

Ee-mail

configurando contas de servidor de correio 88e-mails

alterando a codificação 269efetuando login

configurando segurança 84, 130ocultando namespaces durante 182

entregadiminuindo o tempo para abrir relatórios 322

erro CAM-CRP-1157 354erro CM-SYS-5007 360erro de contexto 368erro de criptografia 380

arquivo cogstartup.xml inválido 380erro do JRE 380

erro de diretório não encontrado 363erro de domínio de confiança

ao salvar a configuração 377erro de Java ao iniciar a configuração 380erro DPR-CMI-4006 360erro DPR-DPR-1035 354Erro HTTP 404 363erro página não localizada

iniciando o IBM Cognos BI no Windows 2003 363erros

ESSBASEPATH 385erros de limite de tempo CGI 388espaços de tabela 318

criando para o banco de dados móvel DB2 no z/OS 82scripts de armazenamento de conteúdo 74, 119

especificações do relatórioatualização 62

ESSBASEPATHincluindo 385

excluindodispatchers 58

exportaçãoarquivos de configuração 311

Ffalha no download de recurso 359fazendo backup

informações do IBM Cognos BI 207, 291fazendo upgrade de um banco de dados de criação de log no

IBM DB2 no z/OS 59finalidade do documento xiFirefox

configurações de navegador 44fix pack

instalando 71, 117, 137, 146fontes

alterando o padrão 224alterando para relatórios PDF 224configurando 221lista de fontes integradas para relatórios PDF 225não localizada ao iniciar o IBM Cognos Configuration no

UNIX 385usando fontes do sistema no Cognos Configuration 224

fontes integradas 225fontes PDF

mapeando para fontes PDF integradas para impressão derelatório mais rápida 223

Framework Managerdesinstalação 334

Índice Remissivo 411

Page 424: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Framework Manager (continuação)erro de criptografia 353

função SaferAPIGetTrustedSignonusando para autenticação 179

fusos horáriosalteração 269

fusos horários do servidoralteração 269

Ggateway

alterando redirecionamentos padrão 372problemas de conexão 378

gateway CGIServidor Apache 96, 154Servidor IBM HTTP 96, 154

gateway de servletconfigurando 95, 153

gateway ISAPI 93, 151gateways

Arquivo de log 349configurações recomendadas para Microsoft IIS 388configurando 147configurando para usar um namespace 220descrição do componente 6incluindo em uma rede para diminuir tempos de

entrega 322instalando 65instalando no computador separado 14quando usar ISAPI 388requisitos de configuração 14

GB18030 221, 224glossário 397Google Chrome

configurações de navegador 44grupos

associação ausente no Active Directory Server 387

HHP-UX

variáveis de ambiente para instalar o IBM Cognos BI 67,113, 134, 142

IIBM Cognos

atualizador 71, 117, 137, 146instalação do pacote de manutenção 71, 117, 137, 146

IBM Cognos Administrationdescrição do componente 6

IBM Cognos Application Firewallconfigurando 217

IBM Cognos BIalterando servidores de aplicativos 289atualizador 71, 117, 137, 146com autenticação do Kerberos 283componentes 5configurações padrão 65configurando 43desinstalação 333dispatchers 317efetuando login 84, 130implementando 299

IBM Cognos BI (continuação)instalação da ferramenta de migração no Windows 103,

160instalação do pacote de manutenção 71, 117, 137, 146instalando 65não inicia em um servidor de aplicativos 378o serviço não inicia 354opções de instalação 12reconfigurando as configurações de dispositivo móvel ao

atualizar 371requisitos do sistema 28resolução de problemas das instalações 341serviços 317

IBM Cognos Configurationconfigurações inválidas 355descrição do componente 6erro de fonte não localizada no UNIX 385modo autônomo 311não é possível iniciar 379opções da linha de comandos 339problemas ao abrir 349problemas ao salvar uma configuração 372problemas com a navegação pelo teclado 379usando fontes do sistema 224

IBM Cognos Connectiondescrição do componente 6não é possível abrir 364

IBM Cognos Controlleracesso a dados no IBM Cognos BI 23

IBM Cognos Financeacesso a dados no IBM Cognos BI 23

IBM Cognos NoticeCastduplicação de funcionalidade no IBM Cognos BI 25

IBM Cognos Planning - Analystacesso a dados no IBM Cognos BI 23

IBM Cognos Planning - Contributoracesso a dados no IBM Cognos BI 23

IBM Cognos Portal Servicesvisão geral de migração 26

IBM Cognos Queryduplicação de funcionalidade no IBM Cognos BI 25

IBM Cognos Series 7ativando a conexão única 178ativando SSL 178migração para o IBM Cognos BI 21plug-ins de conexão confiável 179usando para autenticação 177

IBM Cognos Series 7 PowerCubesrequisitos para conversão de idioma bem-sucedida 24

IBM Cognos Visualizerduplicação de funcionalidade no IBM Cognos BI 25

IBM Cognos Web Servicesvisão geral de migração 25

IBM Cognos Workspace 7IBM CognosScript

visão geral de migração 25IBM DB2

criando sequências de conexões 85, 125IBM DB2 no z/OS, fazendo upgrade de um banco de dados

de criação de log 59IBM Directory Server

com um namespace LDAP 188IBM Java Software Development Kit 262IBM WebSphere 289idioma

customizando para a interface com o usuário 264

412 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 425: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

idioma (continuação)customizando suporte ao conteúdo do código do

idioma 265idiomas

incompatibilidade após a atualização 369tabelas de conversão 369

imagenscarregando no Report Studio 91, 148validade do conteúdo 91, 148

implantação do IBM Cognos BI 299implementando

objetos de configuração 61importação

amostras 164importando

arquivos de implementação 61configurações 61

impressão de relatórioscustomizando para servidores de impressão UNIX e

Linux 230Impromptu Web Reports

migração para o IBM Cognos BI 21indisponibilidade da rede

os serviços falham ao iniciar 359informações de criptografia não podem ser

criptografadas 376Informix

criando o armazenamento de conteúdo 41criando um banco de dados de criação de log 41drivers de banco de dados 79, 123, 257especificando como um repositório de mensagem de

log 258inicialização

arquivo de bloqueio de configuração 349DB2 Retorna Erro SQL1224N ao se Conectar do AIX 360falha do script 367falha no download de recurso 359falha sem erro 355não é possível abrir o IBM Cognos Connection 364não é possível fazer o download de cognos.xts 367não é possível iniciar o serviço 354página não localizada 363problemas 350serviço do IBM Cognos 381

iniciando o serviço do Cognosa partir da linha de comandos 328

inícioo serviço do IBM Cognos a partir do IBM Cognos

Configuration 90instalação

básica para diversos locais 110lista de verificação 65não assistida 307opções para o Content Manager 15requisitos para nome de diretório 362teste 101

instalação de 32 bitsrequisitos para arquivos de biblioteca de 32 bits 36

instalação de 64 bitsrequisitos para os arquivos de biblioteca de 64 bits 36

Instalação do IBM Cognos Go! Painelrenomeado como IBM Cognos Workspace 4

instalação não assistidaconfigurando 307Iniciar 310modificando um arquivo de resposta 309

instalação silenciosa-startupfile path/filename.xml

nova descrição do recurso para versão 10.2 2arquivo de inicialização 2exibir status na tela 310Iniciar 310modificando um arquivo de resposta 309opção para exibir o status na tela 3opção para ignorar as mensagens de status 310

instalações básicasdiversos locais 110

Instalações de 64 Bits 16instalações distribuídas

cenários 12opções 18

instalações silenciosas 307instalando

amostras da Companhia de Aventuras de Amostra 163clientes móveis 102, 141distribuindo componentes 18IBM Cognos BI 65, 307, 308IBM Cognos BI no Linux 370instalação não assistida 307, 308métodos para o cliente 102, 141opções 18sequência para componentes do servidor 109Supplementary Languages Documentation 72teste 133, 140, 159usando arquivo de especificação de transferência

(.ats) 307, 308usando arquivos de especificação de transferência

(.ats) 308Integrated Windows Authentication

problemas 384interface

customizando suporte ao idioma 264interface com o usuário

customizando suporte ao idioma 264mapeando para o código de idioma do produto 268

Internet Explorerconfigurações de navegador 44

IPv4 271IPv6 271ISAPI

quando usar para um gateway 388issetup

não iniciando no Linux 350

JJava

alterando versões 206atualizando ambientes de tempo de execução 32, 208configurando gateway de servlet para servidores da Web

compatíveis com Java 95, 153usa toda a CPU 354versões suportadas para armazenamento de conteúdo do

DB2 354JAVA_HOME

configuração 380java.lang.NoClassDefFoundError 353Java Management Extensions

com logs de usuário 262configurando propriedades JMX para monitoramento

remoto de métricas do sistema 313Java Software Development Kit da IBM 313

Índice Remissivo 413

Page 426: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

Java virtual machinetrava ao importar a implementação 383

Javascriptsativando em navegadores da Web 44

JobStreamsexecutando no IBM Cognos Connection usando serviço

Movimentação de Dados 25JREs

atualização 32, 208JSON

Suporte de IIS e MIME 101, 159JVM

alteração 206, 207, 291configurações de memória para o Banco de dados de

conteúdo do Cognos 319copiando arquivos do provedor de segurança 208

Llargura da banda

estimando 320latência

melhorando 322LDAP

Active Direcetory Server 185ativando a conexão única 195ativando SSL 194configurando um namespace 184editando a propriedade de mapeamento de identidade

externa 195IBM Directory Server 188Novell Directory Server 189Oracle Directory Server 191propriedades customizadas 193usando para autenticação 183

libXm.so.4erro ao executar issetup 350

Lifecycle Manager 63limite de tempo assíncrono 322Linux

caracteres corrompidos durante a instalação 366caracteres não exibidos apropriadamente 370configurações de ulimit 31iniciando e parando o serviço do Cognos 328mensagens de log 258requisitos do sistema 65variáveis de ambiente para IBM Cognos BI 67, 113, 134,

142Linux no System z

erro de script C8DB2.sh 382suporte para namespace RACF 199

listas de incorporação de fontes 225locais de arquivos

requisitos no Windows Vista 273local da instalação

recurso alterado na versão 10.1.0 3local de arquivos temporários 219

configurando 219localhost

requisito para alterar para nome do host ou endereçoIP 84

Localização de arquivos de implementaçãoconfigurando para Windows Vista 273

Localização de arquivos de mapeamentoconfigurando para Windows Vista 273

Localização dos arquivos de dadosconfigurando para Windows Vista 273

Localização dos arquivos temporáriosconfigurando para Windows Vista 273

log de eventos do Windowsdestino para mensagens de log 258

logins do usuárioconfigurando acesso seguro ao portal 89, 131

logon anônimodesativando 166

logsprocessamento de mensagens 254serviço 316

logs de auditoriaVeja também mensagens de logVeja também resolução de problemasdestinos de log 254

logs de eventos 258logs de usuário 262

Mmacro

conversão de relatórios em ppr para relatórios em ppx 9manutenção

melhorando o desempenho do sistema 313memória

requisitos 30Mensagens de erro.

CAM-CRP-1064 358CAM-CRP-1315 A configuração atual aponta para um

domínio de confiança diferente 377CFG-ERR-0106 Cognos Configuration não recebeu

nenhuma resposta 351CM-CFG-029 Content Manager não pode determinar 381CMM-APP-3254 Falha na inicialização do armazenamento

de métricas 388DIS-ERR-3115 Falha na execução da tarefa 388DPR-ERR-2014 362DPR-ERR-2022 Nenhuma resposta gerada 366DPR-ERR-2058 360, 364DPR-ERR-2079 382Erro HTTP 404 363falha da classe de servlet ao carregar no WebLogic 389falha no download do recurso especificado 359informações de criptografia corrompidas 380informações de criptografia não podem ser

criptografadas 376Java Runtime Environment 380MDS-RUN-3213 Não é possível localizar o utilitário de

carregamento em massa do banco de dados 388não é possível fazer o balanceamento de carga da

solicitação 362não foi possível desserializar o atributo de contexto 368página não localizada 363PRS-CSE-1255 358RQP-DEF-0114 370RSV-SRV-0066 370SoapSocketException 360solicitação malformada 369SQL1224N 360tempo limite do CGI 388você escolheu fazer o download de um arquivo 367

mensagens de logVeja também logs de auditoriaVeja também resolução de problemasativação para o IBM Cognos Application Firewall 217destinos de log 254Servidor de log remoto. 254

414 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 427: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

métricaspara servidores, dispatchers e serviços 313

métricas do sistemaacesso de fora do IBM Cognos Administration 4métricas do sistema 4monitoramento remoto 313recurso alterado na versão 10.1.0 4

Microsoftatualizações de segurança afetam memória 355

Microsoft Analysis Serverrequisito de namespace 168

Microsoft Analysis Servicesconexão única com origens de dados MSAS 172

Microsoft Cube 362Microsoft Office

serviço de dados de relatório 318Microsoft Registry Editor

aumentando soquetes ou portas 385Microsoft SQL Server

autenticação do Kerberos 283criando sequências de conexões 85, 125especificando como um repositório de mensagem de

log 258requisito de namespace 168

migraçãode outros produtos IBM Cognos para o IBM Cognos BI 21falha ao executar 390requisitos de autenticação 89

modelosalterando o tamanho do modelo 319

modelos Architectmigração para o IBM Cognos BI 21

modelos LDAPnova descrição do recurso versão 10.2 3

modo autônomo 307modo de consulta compatível

memória 30modo de consulta dinâmica

memória 30modo silencioso 307Módulos do Apache 91, 149moeda

customizando suporte 264multi_domain_tree 171

Nnamespace

RACF 199Namespace do Cognos

recriando 379namespace RACF 199namespaces

associação ao grupo ausente do Active DirectoryServer 387

autenticação 165autenticação do Kerberos 285configurando para um gateway 220configurando provedores de autenticação

customizada 181excluindo 204IBM Cognos Series 7 89não é possível efetuar logon 358ocultando durante o login 182recriando 379requisitos para Content Manager em caso de uso do

Transformer com namespace Series 7 65, 177

não é possível abrir o IBM Cognos Configuration 349Navegadores da Web

configurações de segurança 28configurando 44erros ao iniciar o portal da Web 364, 366utilizando Autenticação do Kerberos 283

nenhuma resposta gerada 366NIST SP800-131a 233notas sobre a liberação

revisando antes de instalar 27Novell Directory Server

com um namespace LDAP 189

Oopção displayLog 310opção instalação rápida 1opção nomsgboxes 310opções da linha de comandos 339opções de inicialização 339opções JVM

servidores de aplicativos 290Oracle

criando sequências de conexões 85, 125diretórios JDBC 80drivers de banco de dados 78, 123drivers JDBC de banco de dados 256erros de implementação 388especificando como um repositório de mensagem de

log 258Oracle Directory Server

com um namespace LDAP 191Oracle Essbase

falhas na consulta 385Oracle Java SE Development Kit 262, 313Oracle WebCenter Interaction Portal

configurando 277Oracle WebLogic 289origens de dados

conexões de amostras 163configurando ativado para Kerberos 286descrição do componente 11

origens de dados OLAP 362membros ausentes ou inacessíveis 387

Origens de dados relacionais .membros ausentes ou inacessíveis 387

OutOfMemoryError 360outros componentes 10

Ppacote de serviços

instalando 71, 117, 137, 146parâmetro DuseCMLargeResultSet 360parando o serviço do Cognos

a partir da linha de comandos 328Perfil do WebSphere Liberty

servidor de aplicativos 1permissões

para a conta do usuário que é usada para o serviço do IBMCognos 83, 124, 138, 146, 205

pools de aplicativos 91, 148portal

configurando acesso seguro para usuários 89, 131erros ao iniciar 364, 366

Índice Remissivo 415

Page 428: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

portal do IBM Cognos BIproblema ao conectar ao WebSphere Application Server de

64 bits 378Portal IBM WebSphere

configurando 277Portal Services 277

especificando o arquivo applications.xml 278portas

alteração 211definições de configuração padrão 33diversas versões do IBM Cognos BI 53

portas em uso 354PowerCubes

acesso no IBM Cognos BI 24não é possível abrir 362requisitos para conversão de idioma bem-sucedida 24

PowerPlay Server 390problemas do portal

não é possível abrir 364processamento de mensagens de log 254produtos

versões suportadas 27propriedade Consulta de usuário

caracteres especiais para namespace LDAP 183propriedade de mapeamento de identidade externa

caracteres especiais para namespace LDAP 183editando para um namespace LDAP 195

propriedade Senha e DN do usuário de ligaçãocaracteres especiais para namespace LDAP 183

propriedadesalterando na configuração não assistida 326configurando para o servidor de aplicativos 299local de arquivos temporários 219

propriedades customizadas de usuárioLDAP 193Servidor Active Directory 170

propriedades da conta RACFmapeando para o namespace RACF 199

propriedades de URIrequisito para alterar localhost para nome do host ou

endereço IP 84propriedades do ambiente 84proteção contra failover 15protocolo

endereço IP 271provedor de autenticação

configurando IBM Cognos BI para usar segurança 84, 130provedores de autenticação customizada 181público-alvo do documento xi

Qqualidade de proteção em conexões SSL 244

RRACF

ativando a conexão única 201conectividade 199configurações de autenticação para administradores do

IBM Cognos BI 199recriação de namespaces no Cognos 379recursos

incluindo 324novos recursos na versão 10.2.1 1novos recursos na versão 10.2.2 1

recursos de acessibilidade 337relatórios

alterando a fonte padrão 224customizando suporte ao idioma 265diminuindo o tempo de entrega 322estimando tamanhos 321

remoção de componentes de vários servidores 312remoção de registros de dispatchers 305removendo o registro

dispatchers 58Report Studio

carregando imagens 91, 148requisitos

diretório de instalação 362requisitos de software

versões do produto suportadas 27requisitos do sistema 28resolução de problemas 341

assinando o suporte 346bases de conhecimento

procurando soluções de resolução de problemas 343Content Manager falha ao iniciar 360correções

obtendo 344criação de log 254entrando em contato com o Suporte IBM 344identificando problemas 341obtendo correções 344para um usuário específico 262procurando em bases de conhecimento 343tabelas de banco de dados não criadas 371trocando informações com o suporte IBM 345

Resource Access Control FacilityConsulte também RACF 199

revisão das notas sobre a liberação antes da instalação 27rich client 12

SSafari 5

configurações de navegador 44saída de relatório

compartilhando com usuários fora do IBM Cognos BI 225reutilizando 226salvando em um sistema de arquivos 225

sAMAccountNameutilizando Autenticação do Kerberos 175

SAPativando a conexão única 203usando para autenticação 201

SAP BWconectividade 202configurações de autorização para administradores do IBM

Cognos BI 202configurações de autorização para usuários do IBM Cognos

BI 201SAP Enterprise Portal

configurando 277script ativo

ativando em navegadores da Web 44script C8DB2.sh

erro 382scripts

criando um armazenamento de conteúdo no DB2 73, 118para excluir tabelas de bancos de dados 373para melhorar o desempenho do armazenamento de

métricas 321

416 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 429: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

scripts de inicialização,Veja servidores de aplicativos

scripts de limpeza do banco de dados 373scripts SQL

para excluir bancos de dados 373Secure Sockets Layer,

Veja SSLsegurança

ativação 84, 130configurações para navegadores da Web 28configurando acesso seguro ao portal 89, 131problemas com Integrated Windows Authentication 384

senhasalterando na configuração não assistida 326alterando para o Banco de dados de conteúdo do

Cognos 209sequências de conexão de banco de dados

IBM DB2 85, 125Microsoft SQL Server 85, 125Oracle 85, 125

sequências de ordenaçãodistinção entre maiúsculas e minúsculas 355

Series 7 PowerCubesrequisitos para conversão de idioma bem-sucedida 24

serviçoatualização de índice 316dado do índice 315gráficos 315procura de índice 316tarefa manual 315

Serviço Content Manager 315serviço de anotação 315serviço de apresentação 317Serviço de apresentação

requisitos 314serviço de atualização do índice 316serviço de consulta 317serviço de dados de relatório 318serviço de dados do índice 315Serviço de deslocamento de dados

usando no IBM Cognos Connection 25serviço de entrega 315serviço de gerenciamento de eventos 315serviço de gráficos 315serviço de integração de dados 315Serviço de metadados 316Serviço de migração 316Serviço de Migração

descrição do componente 9serviço de monitor 317serviço de procura do índice 316Serviço de Relatório

lista de fontes integradas para relatórios PDF 225requisitos 314

serviço de relatórios em lote 315Serviço de relatórios em lote

lista de fontes integradas para relatórios PDF 225serviço de tarefa 316serviço de tarefa realizada por usuários 315serviço do agente 315serviço do Cognos

iniciando a partir da linha de comandos 328serviço do IBM Cognos

configurando 319iniciando a partir do IBM Cognos Configuration 90início 381parando a partir da linha de comandos 328

serviço do IBM Cognos (continuação)requisitos para a conta do usuário que é usada para o

serviço 83, 124, 138, 146, 205servidor não disponível 355

Serviço do Metrics Manager 316serviço móvel 317serviços

agente 315ajustando para melhorar o desempenho 314anotação 315apresentação 314, 317ativando e desativando 220configurando a conta do usuário para o acesso à rede

compartilhado 274consulta 317Content Manager 315dados do relatório 318desinstalação 333dispositivo móvel 317entrega 315falha ao iniciar após indisponibilidade da rede 359gerenciamento de eventos 315IBM Cognos BI 317iniciando a partir da linha de comandos 328integração de dados 315log 316Metadados 316métricas do sistema 313Metrics Manager 316Migração 316monitor 317não é possível iniciar 354parando a partir da linha de comandos 328relatório 318Relatório 314relatório em lote 315repositório 318serviço de migração não funcionando 390tarefa 316

serviços de relatório 318serviços de repositório 318Servidor Active Directory

associação ao grupo ausente 387ativando a conexão única 172ativando SSL 170autenticação do Kerberos 285autenticando em diversos domínios 171com um namespace LDAP 185propriedades avançadas 171usando para autenticação 168

Servidor de aplicativo Oracle 289servidor de aplicativos de 64 bits

problema ao conectar ao portal do IBM Cognos BI 378Servidor de aplicativos IBM WebSphere

conexão única com RACF 201servidor de correio

configurando 129servidor IBM Cognos BI

falha ao iniciar 355servidores

estimando números 320métricas do sistema 313

servidores da Webativando SSL 245conexão única usando Active Directory e servidor da Web

IIS 172configurando 91, 148

Índice Remissivo 417

Page 430: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

servidores da Web (continuação)configurando tempo de carregamento do Report

Studio 91, 148gateways de servlet 95, 153

servidores da Web Apacheconfigurando alias 91, 148

servidores da Web IISconexão única usando Active Directory 172

servidores da Web Microsoft IISconfigurações de gateway recomendadas 388

servidores de aplicativosalterando do padrão 289atualização para o IBM Cognos BI 305configurando 299falha da classe de servlet ao carregar no WebLogic 389falha do script de inicialização 367gateways de servlet 95, 153opções JVM 290problemas ao executar o IBM Cognos BI 378scripts de inicialização 297

servidores remotos de log 257configurando 258

SharePoint Portalconfigurando 277utilizando Autenticação do Kerberos 283

sinalizador seguroconfiguração para cookies 271

sistema de arquivospara salvar cópias da saída de relatório 225

sistema operacional de 64 bitsmemória 30

sistemas operacionaisversões suportadas 27

Software Development Kitdocumentação 3

SolarisJRE 1.5 382variáveis de ambiente para instalar o IBM Cognos BI 67,

113, 134, 142SSL

ativação em servidores da Web 245ativação para um servidor de aplicativos 303configurando 240configurando confiança compartilhada com outros

servidores 243namespace LDAP 194para o banco de dados de armazenamento de

conteúdo 246para o banco de dados de criação de log 246para o banco de dados de notificação 246qualidade de proteção 244Servidor Active Directory 170usando o namespace do IBM Cognos Series 7 178

Suporte do IIS MIME para arquivos JSON 101, 159Suporte IBM

entrando em contato 344enviando e recebendo informações 345

Supplementary Languages Documentationinstalando 72

Sybasecriando o armazenamento de conteúdo 42drivers de banco de dados 79, 123especificando como um repositório de mensagem de

log 258syslog

destino para mensagens de log 258

Ttabelas

excluindo de um banco de dados 373tamanho do cache da página

Derby 319tecla tab

problemas no IBM Cognos Configuration 379teclado

problemas de navegação 379teclas de atalho 337tempo limite do conjunto de conexões padrão

conflitos entre IBM Cognos BI e alguns servidores deaplicativos 293

testeconfiguração 101instalação 101

teste da instalação 133, 140, 159Transformer

acesso a dados no IBM Cognos BI 24desinstalação 334requisitos para o Content Manager em caso de uso do

namespace Series 7 65, 177

UUNIX

configurações de ulimit 31erro de fonte não localizada 385iniciando e parando o serviço do Cognos 328mensagens de log 258requisitos do sistema 65variáveis de ambiente para IBM Cognos BI 67, 113, 134,

142UNIX AIX

suporte para namespace RACF 199URI

alteração 211definições de configuração padrão 33

URIs do Content Manager 127, 139usuários

alterando para o Banco de dados de conteúdo doCognos 209

UTF-8codificação para e-mails 269

utilitário de conversão de marcador 9

Vvalidade do conteúdo

diretório de imagens 91, 148variáveis de ambiente

configurando para componentes da camada doaplicativo 139

configurando para servidores de aplicativos 292para instalar o IBM Cognos BI no UNIX ou Linux 67, 113,

134, 142requisitos no Windows Vista 273

verificação de script cruzadoconfigurando no IBM Cognos Application Firewall 217

versão de endereço IP 271versões do produto 71, 117, 137, 146virtualização

ambientes suportados 27

418 IBM Cognos PowerPlay Versão 10.2.2: Guia de Instalação e Configuração

Page 431: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · IBM Cognos PowerPlay Versão 10.2 ... Índice

WWeb Distributed Authoring and Versioning

Veja WebDAVWebDAV

configurando para visualizar as imagens 100, 157WebLogic

falha da classe de servlet ao carregar 389falha do script de inicialização 367implementando o arquivo p2pd.war 369não foi possível desserializar o atributo de contexto 368script de inicialização 297servidor de aplicativos 300, 302

WebLogic Application Servero IBM Cognos BI falha 368

WebSphere 289servidor de aplicativos 299

WebSphere Application Serverfalha do script de inicialização 367falha na implementação do IBM Cognos BI 368instalar o Cognos BI 295problema ao conectar ao portal do IBM Cognos BI 378

Windowsinstalação da ferramenta de migração do IBM

Cognos 103, 160requisitos do sistema 65

Windows IISconfigurações de gateway recomendadas 388

Windows Vistarequisitos para os locais de arquivos 273

XXQE-DS-0006 385

Zz/OS

criando espaços de tabela para o banco de dados móvelDB2 82

criando um banco de dados móvel DB2 81

Índice Remissivo 419