public.dhe.ibm.compublic.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Produtos IBM Cognos que Podem Ser Atualizados para o IBM Cognos Business Intelligence .......32

IBM Cognos Business IntelligenceVersão 10.2.1.1

Guia de Instalação e Configuração

��

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

Informações do produto

Esse documento se aplica ao IBM Cognos Business Intelligence Versão 10.2.1.1 e também pode se aplicar aliberações subsequentes.

Materiais licenciados - Propriedade da IBM

© Copyright IBM Corporation 2005, 2013.

Índice

Introdução . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii

Capítulo 1. O que há de novo? . . . . . . . . . . . . . . . . . . . . . . . . . . 1Novos Recursos na Versão 10.2.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Novos Padrões de Segurança no IBM Cognos BI . . . . . . . . . . . . . . . . . . . . . . 1Gateway IBM Cognos de 64 Bits como Padrão em Instalações de 64 Bits . . . . . . . . . . . . . . 1Armazene Relatórios em um Armazenamento de Objeto Externo . . . . . . . . . . . . . . . . . 1

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

Novos Recursos na Versão 10.1.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3Servidor de Relatório de 64 Bits . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3IBM Cognos Content Archival . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3Script para Geração de um Banco de Dados de Armazenamento de Conteúdo do IBM DB2 . . . . . . . . 4Instalar o IBM Cognos para IBM WebSphere a partir do Assistente para Construção de Aplicativo . . . . . 4

Novos Recursos na Versão 10.1.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4Modo de consulta dinâmica . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4Colaboração Usando o IBM Cognos Workspace . . . . . . . . . . . . . . . . . . . . . . . 5Acesso ao guia de instalação e de configuração do Software Development Kit . . . . . . . . . . . . 6

Recursos alterados na versão 10.1.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6Local de instalação padrão e alias da Web . . . . . . . . . . . . . . . . . . . . . . . . 6O Upgrade Manager é renomeado como Lifecycle Manager . . . . . . . . . . . . . . . . . . 6Recursos de Procura de Índice São Nativos para o IBM Cognos BI Server . . . . . . . . . . . . . . 6IBM Cognos Go! Dashboard É Mesclado com Recursos do IBM Cognos Viewer em uma Interface com o Usuário 7IBM Cognos Special Edition Está Integrado aos Produtos IBM Cognos BI Server. . . . . . . . . . . . 7Suporte Aprimorado para Autenticação Usando um Provedor RACF . . . . . . . . . . . . . . . 7Suporte para o Banco de Dados do Servidor Informix Dynamic . . . . . . . . . . . . . . . . . 7IBM Cognos Portal Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8Acesso seguro ao monitorar as métricas do sistema externamente . . . . . . . . . . . . . . . . 8

Capítulo 2. Opções de Distribuição . . . . . . . . . . . . . . . . . . . . . . . . 9Família IBM Cognos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Componentes do Produto Cognos Enterprise . . . . . . . . . . . . . . . . . . . . . . . . 10

Componentes do servidor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10Componentes opcionais do servidor . . . . . . . . . . . . . . . . . . . . . . . . . . 13Componentes de modelagem . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14Componentes Necessários do Banco de Dados. . . . . . . . . . . . . . . . . . . . . . . 15Componentes de infra-estrutura . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

Distribuição de Componentes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17Todos os Componentes do Servidor em um Computador . . . . . . . . . . . . . . . . . . . 18Gateways em Computadores Separados . . . . . . . . . . . . . . . . . . . . . . . . . 18Componentes da Camada de Aplicativos e Content Managers em Computadores Separados . . . . . . . 20Produtos IBM Cognos BI no Mesmo Computador . . . . . . . . . . . . . . . . . . . . . 22Consolidando Servidores para Linux no System z . . . . . . . . . . . . . . . . . . . . . 23Instalando Versões de 64 Bits de Produtos IBM Cognos BI . . . . . . . . . . . . . . . . . . . 23

Opções de Instalação para Componentes de Modelagem do Windows . . . . . . . . . . . . . . . . 25Considerações sobre Firewall . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25Distribuindo Componentes do Framework Manager . . . . . . . . . . . . . . . . . . . . . 27Distribuindo Componentes do Transformer . . . . . . . . . . . . . . . . . . . . . . . . 27Distribuindo Componentes do Metric Designer . . . . . . . . . . . . . . . . . . . . . . 30

Distribuindo Componentes de Scorecard do IBM Cognos BI . . . . . . . . . . . . . . . . . . . 31IBM Cognos Business Intelligence com Outros Produtos IBM Cognos . . . . . . . . . . . . . . . . 32

© Copyright IBM Corp. 2005, 2013 iii

Produtos IBM Cognos que Podem Ser Atualizados para o IBM Cognos Business Intelligence . . . . . . . 32Produtos IBM Cognos Series 7 que Podem ser Migrados para o IBM Cognos Business Intelligence . . . . . 34Produtos IBM Cognos que Interoperam com o IBM Cognos Business Intelligence . . . . . . . . . . . 35Conteúdo do IBM Cognos Series 7 que Pode Ser Recriado no IBM Cognos Business Intelligence . . . . . . 39

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

Definições de memória . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44Requisitos Java . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45Revisando as Configurações de Porta Padrão para o IBM Cognos Business Intelligence . . . . . . . . . . 46Diretrizes para Criar o Armazenamento de Conteúdo . . . . . . . . . . . . . . . . . . . . . 47

Configurações Sugeridas para Criar o Armazenamento de Conteúdo no DB2 Sistemas Operacionais Linux,Windows e UNIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48Configurações Sugeridas para Criar o Armazenamento de Conteúdo no DB2 no z/OS . . . . . . . . . 51Configurações Sugeridas para Criar o Armazenamento de Conteúdo no Oracle. . . . . . . . . . . . 52Configurações Sugeridas para Criar o Armazenamento de Conteúdo no Microsoft SQL Server. . . . . . . 52Configurações Sugeridas para Criar o Armazenamento de Conteúdo no IBM Informix Dynamic Server . . . 53Configurações Sugeridas para Criar o Armazenamento de Conteúdo no Sybase . . . . . . . . . . . 54

Configuração de uma Conta de Usuário ou Conta de Serviço de Rede para o IBM Cognos Business Intelligence . 55Configurando Variáveis de Ambiente no UNIX para o Armazenamento de Métricas . . . . . . . . . . . 56Configuração de navegadores web. . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

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

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

Tarefas de Atualização . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67Instalar e Configurar uma Nova Versão do Produto . . . . . . . . . . . . . . . . . . . . . 67Mover Seu Conteúdo para a Nova Versão do Produto . . . . . . . . . . . . . . . . . . . . 70Atualizar suas Especificações de Relatório . . . . . . . . . . . . . . . . . . . . . . . . 76Usar o Lifecycle Manager para Comparar os Relatórios entre suas Versões do Produto . . . . . . . . . 77

Capítulo 5. Instalação e Configuração dos Componentes do Produto em umComputador . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79Instalação de componentes do servidor no modo interativo . . . . . . . . . . . . . . . . . . . 79Instalar os Componentes do Servidor . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

Instalando Componentes do Servidor nos Sistemas Operacionais UNIX ou Linux . . . . . . . . . . . 82Instalando Componentes do Servidor em Sistemas Operacionais Windows . . . . . . . . . . . . . 84

Instalando o IBM Cognos Metrics Manager . . . . . . . . . . . . . . . . . . . . . . . . . 85Instalando os Fix Packs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

Instalando os Fix Packs IBM Cognos nos Sistemas Operacionais UNIX ou Linux . . . . . . . . . . . 85Instalando Fix Packs nos Sistemas Operacionais Windows . . . . . . . . . . . . . . . . . . . 86

Configure a conectividade do banco de dados para o banco de dados de armazenamento de conteúdo. . . . . 87Configurar a Conectividade do Banco de Dados para um Armazenamento de Conteúdo IBM DB2 . . . . . 87Configurar a Conectividade do Banco de Dados para um Armazenamento de Conteúdo Oracle . . . . . . 92Configurar Conectividade do Banco de Dados para um Armazenamento de Conteúdo Informix . . . . . . 92Configurar a Conectividade do Banco de Dados para um Armazenamento de Conteúdo Sybase . . . . . . 93

Configurar a Conectividade de Banco de Dados para Bancos de Dados de Relatório . . . . . . . . . . . 93Acessar Origens de Dados OLAP em Sistemas Operacionais Windows . . . . . . . . . . . . . . 94Acessar Origens de Dados ODBC em Sistemas Operacionais UNIX ou Linux . . . . . . . . . . . . 95Configure o IBM Cognos Business Intelligence para Usar o Oracle Essbase . . . . . . . . . . . . . 96Usando o Oracle Essbase em um Sistema Operacional UNIX ou Microsoft Windows de 64 bits . . . . . . 97

Início do IBM Cognos Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . 97Configurando Propriedades de Ambiente no IBM Cognos Configuration . . . . . . . . . . . . . . . 98Ativar a Versão de 64 Bits do Servidor de Relatório . . . . . . . . . . . . . . . . . . . . . . 98Ativação da segurança. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99Definição de propriedades de conexão com o banco de dados para o armazenamento de conteúdo. . . . . . 100

iv IBM Cognos Business Intelligence Versão 10.2.1.1: Guia de Instalação e Configuração

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

Especificação de uma conexão para uma conta do servidor de correio . . . . . . . . . . . . . . . 103Inicie os serviços do IBM Cognos. . . . . . . . . . . . . . . . . . . . . . . . . . . . 104Configurando o Servidor da Web. . . . . . . . . . . . . . . . . . . . . . . . . . . . 104

Ative o Gateway da Web de 32 bits em uma Instalação de 64 bits . . . . . . . . . . . . . . . . 105Use Gateways Compilados para Sistemas de Produção . . . . . . . . . . . . . . . . . . . 105Usar Gateways CGI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110Configurando o WebDAV para Visualizar e Navegar pelas Imagens . . . . . . . . . . . . . . . 114

Teste de instalação e configuração . . . . . . . . . . . . . . . . . . . . . . . . . . . 116Configurar Variáveis para Conexões de Origem de Dados . . . . . . . . . . . . . . . . . . . 117Criando um Banco de Dados de Armazenamento de Métricas . . . . . . . . . . . . . . . . . . 119

Criar um Banco de Dados de Armazenamento de Métricas no IBM DB2 . . . . . . . . . . . . . . 119Criar um Banco de Dados de Armazenamento de Métricas no Microsoft SQL Server . . . . . . . . . 120Criar um Banco de Dados de Armazenamento de Métricas no Oracle . . . . . . . . . . . . . . 121Criar um Banco de Dados de Armazenamento de Métricas no Oracle usando um Banco de Dados Existente 122

Configurando o Cliente de Banco de Dados para o Armazenamento de Métricas . . . . . . . . . . . . 123Configurar o Cliente de Banco de Dados para um Armazenamento de Métricas do IBM DB2. . . . . . . 123Configurar o Cliente de Banco de Dados para um Armazenamento de Métricas Oracle . . . . . . . . . 123Configurar o Cliente de Banco de Dados para um Armazenamento de Métricas do Microsoft SQL Server . . 124

Crie um pacote de métricas. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124

Capítulo 6. Instalação e Configuração dos Componentes do Servidor em DiferentesComputadores . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127Sequência de Instalação para os Componentes do Servidor . . . . . . . . . . . . . . . . . . . 129Recomendação - instale e configure a instalação básica para instalações distribuídas. . . . . . . . . . . 130Instalação de componentes do servidor no modo interativo . . . . . . . . . . . . . . . . . . . 131Instalação e configuração do Content Manager . . . . . . . . . . . . . . . . . . . . . . . 132

Componentes ativo e em espera do Content Manager . . . . . . . . . . . . . . . . . . . . 133Instalar os Componentes do Content Manager . . . . . . . . . . . . . . . . . . . . . . 134Instalando o Content Manager para IBM Cognos Metrics Manager . . . . . . . . . . . . . . . 137Instalando os Fix Packs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137Configure a conectividade do banco de dados para o banco de dados de armazenamento de conteúdo. . . . 139Início do IBM Cognos Configuration . . . . . . . . . . . . . . . . . . . . . . . . . 145Definição de propriedades de conexão com o banco de dados para o armazenamento de conteúdo. . . . . 146Configuração de propriedades do ambiente para computadores com Content Manager . . . . . . . . . 150Especificação de uma conexão para uma conta do servidor de correio . . . . . . . . . . . . . . 152Ativação da segurança . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153Início do Content Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153Teste da instalação do Content Manager . . . . . . . . . . . . . . . . . . . . . . . . 154

Instalação e configuração do Application Tier Components . . . . . . . . . . . . . . . . . . . 154Instalação do Application Tier Components . . . . . . . . . . . . . . . . . . . . . . . 154Instalando Componentes da Camada de Aplicativos para IBM Cognos Metrics Manager . . . . . . . . 158Instalando os Fix Packs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158Configurar a Conectividade de Banco de Dados para Bancos de Dados de Relatório. . . . . . . . . . 160Início do IBM Cognos Configuration . . . . . . . . . . . . . . . . . . . . . . . . . 164Configuração de propriedades do ambiente para computadores com Application Tier Components. . . . . 164Ativar a Versão de 64 Bits do Servidor de Relatório . . . . . . . . . . . . . . . . . . . . 167Instalação do Application Tier Components . . . . . . . . . . . . . . . . . . . . . . . 167Teste do Application Tier Components . . . . . . . . . . . . . . . . . . . . . . . . . 168Criando um Banco de Dados de Armazenamento de Métricas . . . . . . . . . . . . . . . . . 168Definir Manualmente o Local de Implementação para Metric Studio . . . . . . . . . . . . . . . 172Configurando o Cliente de Banco de Dados para o Armazenamento de Métricas . . . . . . . . . . . 173Crie um pacote de métricas. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175

Instalação e configuração do gateway . . . . . . . . . . . . . . . . . . . . . . . . . . 177Instalando os Componentes de Gateway nos Sistemas Operacionais UNIX ou Linux . . . . . . . . . 177Instalando os Componentes de Gateway nos Sistemas Operacionais Windows. . . . . . . . . . . . 179Instalando o Gateway para IBM Cognos Metrics Manager . . . . . . . . . . . . . . . . . . 180Instalando os Fix Packs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180Início do IBM Cognos Configuration . . . . . . . . . . . . . . . . . . . . . . . . . 182

Índice v

Configuração de propriedades de ambiente e de segurança para computadores de gateway . . . . . . . 183Configurando o Servidor da Web. . . . . . . . . . . . . . . . . . . . . . . . . . . 184Teste do gateway . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196

Capítulo 7. Instalação e configuração de ferramentas de modelagem para relatórios escorecards . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197Instalando e Configurando o IBM Cognos Framework Manager . . . . . . . . . . . . . . . . . 197

Configurações padrão para o Framework Manager . . . . . . . . . . . . . . . . . . . . . 198Instalando o Framework Manager . . . . . . . . . . . . . . . . . . . . . . . . . . 199Configurar Variáveis para Conexões de Origem de Dados para o Framework Manager. . . . . . . . . 199Propriedades do Ambiente para Computadores com Framework Manager . . . . . . . . . . . . . 202Teste a Instalação do Framework Manager . . . . . . . . . . . . . . . . . . . . . . . 204

Instalação e configuração do Metric Designer. . . . . . . . . . . . . . . . . . . . . . . . 204Configurações padrão para o Metric Designer . . . . . . . . . . . . . . . . . . . . . . 205Instalação do Metric Designer . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206Configurando o Cliente de Banco de Dados para o Armazenamento de Métricas . . . . . . . . . . . 207Configurando o Metric Designer . . . . . . . . . . . . . . . . . . . . . . . . . . . 208Configurar Variáveis para suas Fontes de Importação para Metric Designer . . . . . . . . . . . . 209Teste a Instalação do Metric Designer . . . . . . . . . . . . . . . . . . . . . . . . . 211

Capítulo 8. Instalar e Configurar Componentes Opcionais . . . . . . . . . . . . . 213IBM Cognos Transformer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213

Instalando o IBM Cognos Transformer . . . . . . . . . . . . . . . . . . . . . . . . . 214Configurações Padrão para IBM Cognos Transformer . . . . . . . . . . . . . . . . . . . . 217Comunicação entre os Componentes Transformer e Business Intelligence . . . . . . . . . . . . . 217Origens de Dados e Transformer . . . . . . . . . . . . . . . . . . . . . . . . . . . 219Testar sua Instalação do Transformer . . . . . . . . . . . . . . . . . . . . . . . . . 222Tarefas de Configuração Adicionais para IBM Cognos Transformer . . . . . . . . . . . . . . . 222

Instalando a Documentação do Produto Traduzida . . . . . . . . . . . . . . . . . . . . . . 227Instalando Fontes de Idioma Adicionais . . . . . . . . . . . . . . . . . . . . . . . . . 228

Configure Suporte para Caracteres do Iene Japonês e do Won Coreano . . . . . . . . . . . . . . 229IBM Cognos BI for Microsoft Office . . . . . . . . . . . . . . . . . . . . . . . . . . . 230

Copiando Arquivos de Cliente do IBM Cognos BI for Microsoft Office em um Local da LAN Central . . . . 230Ative o Suporte SSL para a Interface HTTPS para PowerPlay . . . . . . . . . . . . . . . . . 231Ativando Acesso Anônimo para o PowerPlay . . . . . . . . . . . . . . . . . . . . . . 231Implementando o IBM Cognos for Microsoft Office Client . . . . . . . . . . . . . . . . . . 231

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

Fazer Backup das Informações IBM Cognos Existentes . . . . . . . . . . . . . . . . . . . 236Mude a sua Versão do Java. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237

Alteração de definições de configuração padrão . . . . . . . . . . . . . . . . . . . . . . . 238Alterando Senha e Usuário Padrão para o Banco de Dados de Conteúdo do Cognos . . . . . . . . . 239Configurações de Porta e URI . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240Configuração de definições criptográficas . . . . . . . . . . . . . . . . . . . . . . . . 242IBM Cognos Application Firewall . . . . . . . . . . . . . . . . . . . . . . . . . . 247Criptografia de propriedades de arquivo temporário . . . . . . . . . . . . . . . . . . . . 249Configuração do gateway para usar um namespace . . . . . . . . . . . . . . . . . . . . 250Ativação e desativação de serviços . . . . . . . . . . . . . . . . . . . . . . . . . . 250Configurando Fontes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251Alterar a Fonte Padrão de Relatórios em PDF . . . . . . . . . . . . . . . . . . . . . . 253Configuração de fontes integradas a relatórios em PDF . . . . . . . . . . . . . . . . . . . 254Saída de relatório salvo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255Alterando o Local da Saída de Relatórios Temporários . . . . . . . . . . . . . . . . . . . 256Mudança da localização de gráficos de mapa para o Report Studio . . . . . . . . . . . . . . . 257

Utilize um Armazenamento de Objeto Externo para Saída de Relatório . . . . . . . . . . . . . . . 258Verifique o Acesso ao Objeto de Armazenamento Externo . . . . . . . . . . . . . . . . . . 259

Configurando Definições de Diversos Arrendatários . . . . . . . . . . . . . . . . . . . . . 259Identifique Informações de Ocupação . . . . . . . . . . . . . . . . . . . . . . . . . 260Ativando Multitenancy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261

vi IBM Cognos Business Intelligence Versão 10.2.1.1: Guia de Instalação e Configuração

Desativando Diversas Ocupações . . . . . . . . . . . . . . . . . . . . . . . . . . . 263Customizando a Impressão no Lado do Servidor para Plataformas UNIX e Linux . . . . . . . . . . . 264Alterar o Banco de Dados de Notificação . . . . . . . . . . . . . . . . . . . . . . . . . 265

Configurações Sugeridas para Criar um Banco de Dados de Notificação no DB2 no z/OS . . . . . . . . 266Criando Espaços de Tabela para um Banco de Dados de Notificação no DB2 para z/OS . . . . . . . . 266Alterar as propriedades de conexão para o banco de dados de notificação . . . . . . . . . . . . . 267

Criando um Novo Armazenamento de Conteúdo Usando Banco de Dados de Conteúdo do Cognos . . . . . 268Mude a Conformidade Padrão de Segurança para os Armazenamentos Confiáveis do IBM Cognos. . . . . . 269

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

Configurando Componentes do IBM Cognos para Usar Outra Autoridade de Certificação . . . . . . . . . 270Criar Arquivos Certificate Signing Request (CSR) . . . . . . . . . . . . . . . . . . . . . 272Importar os Certificados CA nos Componentes do IBM Cognos . . . . . . . . . . . . . . . . 273Configurar Componentes do IBM Cognos BI para Usar Certificados Gerados pelo CA . . . . . . . . . 275

Configurando o Protocolo SSL para Componentes do IBM Cognos . . . . . . . . . . . . . . . . 275Configurar SSL para Componentes do IBM Cognos . . . . . . . . . . . . . . . . . . . . 276Configure a Confiança Compartilhada entre Servidores IBM Cognos e Outros Servidores . . . . . . . . 278Selecionar e Classificar Conjuntos de Cifras para Secure Socket Layer . . . . . . . . . . . . . . 279

Configurar Servidores da Web Ativados pelo IBM Cognos para SSL . . . . . . . . . . . . . . . . 279Configurando um Repositório para Mensagens de Log . . . . . . . . . . . . . . . . . . . . 280

Diretrizes para Criar um Banco de Dados de Criação de Log . . . . . . . . . . . . . . . . . 281Conectividade do Banco de Dados para o Banco de Dados de Criação de Log. . . . . . . . . . . . 283Repositório de Mensagens de Log . . . . . . . . . . . . . . . . . . . . . . . . . . 285Ativação de conexão específica do usuário . . . . . . . . . . . . . . . . . . . . . . . 291

Alteração de definições globais . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292Personalização do suporte ao idioma na interface com o usuário . . . . . . . . . . . . . . . . 293Personalização do suporte de moeda . . . . . . . . . . . . . . . . . . . . . . . . . 293Customizar Suporte do Código de Idioma do Conteúdo . . . . . . . . . . . . . . . . . . . 294Códigos do idioma do conteúdo . . . . . . . . . . . . . . . . . . . . . . . . . . . 295Mapeamento de códigos do idioma do produto . . . . . . . . . . . . . . . . . . . . . . 297Personalização do fuso horário do servidor . . . . . . . . . . . . . . . . . . . . . . . 298Codificação para E-mails . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298Configurações de Cookie . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299

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

Configurando a Procura de Índice do IBM Cognos . . . . . . . . . . . . . . . . . . . . . . 302Atualização de uma versão anterior da Procura do Índice . . . . . . . . . . . . . . . . . . 303Habilitação e desabilitação de serviços do índice em instalações distribuídas . . . . . . . . . . . . 303Escalonamento da procura do índice usando o compartilhamento do índice . . . . . . . . . . . . 304Incluindo a Funcionalidade de Procura do IBM OmniFind Enterprise Edition em Aplicativos IBM Cognos . . 305

Configuração do URI de descoberta de colaboração . . . . . . . . . . . . . . . . . . . . . 305Configurando o IBM Cognos Workspace . . . . . . . . . . . . . . . . . . . . . . . . . 306

Configurando Acesso ao IBM Cognos Workspace ou às suas Funções . . . . . . . . . . . . . . 307Configurando Tipos MIME Suportados no Microsoft Internet Information Services . . . . . . . . . . 308Criando Espaços de Tabela para Banco de Dados de Anotação e Tarefa Manual no DB2 no z/OS . . . . . 308Configurando um Banco de Dados para Tarefas Manuais e Anotações . . . . . . . . . . . . . . 310Objetos de Métrica no IBM Cognos Workspace . . . . . . . . . . . . . . . . . . . . . . 311Configurando o IBM Cognos Workspace para Usar Dados do IBM Cognos TM1 . . . . . . . . . . . 313Configurando o IBM Cognos Workspace para Acessar IBM Cognos TM1 Applications . . . . . . . . . 316Alterando o Estilo de Objetos de Relatório no IBM Cognos Workspace . . . . . . . . . . . . . . 316Acessando as Amostras do IBM Cognos Workspace . . . . . . . . . . . . . . . . . . . . 317

Configuração do roteador para testar a disponibilidade do dispatcher . . . . . . . . . . . . . . . 317Configurando o IBM Cognos BI para Trabalhar com outros Produtos IBM Cognos . . . . . . . . . . . 317

Ativando Agentes e Relatórios Programados para Origens de Dados do IBM Cognos Planning Contributor 318Propriedades do Local do Arquivo no Windows Vista . . . . . . . . . . . . . . . . . . . . . 318

Atualização das Propriedades de Localização de Arquivos no Windows Vista . . . . . . . . . . . . 319

Capítulo 10. Configuração do Portal Services . . . . . . . . . . . . . . . . . . 321Especificação da localização do arquivo applications.xml . . . . . . . . . . . . . . . . . . . . 321

Índice vii

Configuração da segurança para o Portal Services . . . . . . . . . . . . . . . . . . . . . . 322Desativar Acesso Anônimo a Componentes do IBM Cognos . . . . . . . . . . . . . . . . . . 322Ativação de conexão única com Shared secret . . . . . . . . . . . . . . . . . . . . . . 323Ativar Conexão Única com Sharepoint Usando Autenticação do Kerberos . . . . . . . . . . . . . 328Ativação da conexão única para SAP EP com o SAP Logon Ticket . . . . . . . . . . . . . . . . 331Ativação da conexão única para SAP EP com mapeamento de usuário . . . . . . . . . . . . . . 332Ativar a Comunicação Segura Entre Componentes do SAP EP e do IBM Cognos . . . . . . . . . . . 333Ativando Conexão Única para WebSphere Portal Usando o Servidor de Aplicativos . . . . . . . . . . 333Ativação de conexão única para o portal Oracle WebCenter Interaction Portal usando autenticação básica . . 334Ative a conexão única para o Portal Oracle WebCenter Interaction Usando CA SiteMinder . . . . . . . 334

Capítulo 11. IBM Cognos Content Archival . . . . . . . . . . . . . . . . . . . . 337Configurar Arquivamento de Conteúdo . . . . . . . . . . . . . . . . . . . . . . . . . 339

Criando um Local de Arquivo para um Repositório de Sistema de Arquivos . . . . . . . . . . . . 339Importando Definições e Propriedades de Classes Customizadas para o IBM FileNet Content Manager . . . 340Importando Definições e Propriedades de Classes Customizadas para o IBM Content Manager 8 . . . . . 340Especificando um Tempo Disponível para Executar o Processo de Arquivamento . . . . . . . . . . . 342Especificando o Tempo de Execução de Encadeamento . . . . . . . . . . . . . . . . . . . 342Arquivando Formatos Selecionados de Saídas de Relatório . . . . . . . . . . . . . . . . . . 343Remoção dos Objetos de Versão Marcada da Fila . . . . . . . . . . . . . . . . . . . . . 344Especificando quais Especificações de Relatórios Não Estão Arquivadas . . . . . . . . . . . . . . 344

Capítulo 12. Usando Colaboração com o IBM Cognos Workspace. . . . . . . . . . 347Modificando o IBM Connections para IBM Cognos BI . . . . . . . . . . . . . . . . . . . . . 347Ativando a Conexão Única entre o IBM Connections e o IBM Cognos Business Intelligence . . . . . . . . 348

Capítulo 13. Configurando Componentes do IBM Cognos para Usar um Provedor deAutenticação . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351Desativação do acesso anônimo . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352Acesso de Usuário Restrito ao Namespace Cognos . . . . . . . . . . . . . . . . . . . . . . 353Configurando Componentes do IBM Cognos para Usar o Active Directory Server . . . . . . . . . . . 354

Configurar namespaces do Active Directory . . . . . . . . . . . . . . . . . . . . . . . 355Disponibilizando Propriedades de Usuário Customizadas para o Active Directory para Componentes do IBMCognos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356Ativação da comunicação segura para o Servidor do Active Directory . . . . . . . . . . . . . . 357Inclusão ou exclusão de domínios utilizando Propriedades avançadas . . . . . . . . . . . . . . 357Ativar Conexão Única entre os Componentes do Active Directory Server e IBM Cognos . . . . . . . . 359

Configurando o IBM Cognos para Usar Namespace IBM Cognos Series 7 . . . . . . . . . . . . . . 363Configurar um Namespace IBM Cognos Series 7 . . . . . . . . . . . . . . . . . . . . . 363Ativando Comunicação Segura para o Servidor de Diretório Usado pelo Namespace IBM Cognos Series 7 . . 364Ativando Conexão Única entre o IBM Cognos Series 7 e o IBM Cognos . . . . . . . . . . . . . . 364Namespaces IBM Cognos Series 7 e o Plug-in de Conexão Confiável do IBM Cognos Series 7 . . . . . . 365

Configurando o IBM Cognos para Usar um Provedor de Autenticação Customizada . . . . . . . . . . 367Configuração de namespaces de autenticação customizada . . . . . . . . . . . . . . . . . . 367Ocultação do namespace dos usuários durante o login . . . . . . . . . . . . . . . . . . . 368

Configurando Componentes do IBM Cognos para Usar LDAP . . . . . . . . . . . . . . . . . . 369Mapeamento LDAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369Configuração de namespaces LDAP . . . . . . . . . . . . . . . . . . . . . . . . . . 370Configure um Namespace LDAP para o Active Directory Server . . . . . . . . . . . . . . . . 371Configurando um Namespace LDAP para IBM Directory Server . . . . . . . . . . . . . . . . 374Configuração de namespaces LDAP para Novell Directory Server . . . . . . . . . . . . . . . . 376Configurando um Namespace LDAP para Oracle Directory Server . . . . . . . . . . . . . . . 378Disponibilizando Propriedades de Usuário Customizadas para o LDAP para Componentes do IBM Cognos 380Ativação da comunicação segura com o servidor LDAP . . . . . . . . . . . . . . . . . . . 380Ativando a Conexão Única entre LDAP e Componentes do IBM Cognos . . . . . . . . . . . . . 382Operação de Substituição . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382

Configure os Componentes do IBM Cognos para Usar o CA SiteMinder. . . . . . . . . . . . . . . 383Configurando o Namespace SiteMinder . . . . . . . . . . . . . . . . . . . . . . . . 384

Configurando o IBM Cognos para Usar um Provedor RACF para Autenticação . . . . . . . . . . . . 386Configurando um Namespace RACF . . . . . . . . . . . . . . . . . . . . . . . . . 386

viii IBM Cognos Business Intelligence Versão 10.2.1.1: Guia de Instalação e Configuração

Ativando a Conexão Única entre o RACF e o IBM Cognos . . . . . . . . . . . . . . . . . . 387Configurando o IBM Cognos para Usar SAP . . . . . . . . . . . . . . . . . . . . . . . . 388

Configuração de namespaces SAP . . . . . . . . . . . . . . . . . . . . . . . . . . 389Ativar Conexão Única entre SAP e IBM Cognos . . . . . . . . . . . . . . . . . . . . . . 390

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

Capítulo 14. Usando um Servidor de Aplicativos Diferente do Tomcat . . . . . . . . 393Criar uma Instância JVM Separada . . . . . . . . . . . . . . . . . . . . . . . . . . . 394

Configurar Parâmetros JVM para Desempenho . . . . . . . . . . . . . . . . . . . . . . 394Verificar a Configuração de Componentes IBM Cognos . . . . . . . . . . . . . . . . . . . . 394Fazer Backup das Informações IBM Cognos Existentes . . . . . . . . . . . . . . . . . . . . 395Configurar Variáveis de Ambiente . . . . . . . . . . . . . . . . . . . . . . . . . . . 396Ajustando o Valor de Tempo Limite de Conexão Padrão para IBM Cognos Business Intelligence . . . . . . 398Incluir a Função de Usuário para Ativar Conexão Única entre os Perfis do IBM WebSphere . . . . . . . . 398Configurar Componentes IBM Cognos para Execução no Servidor de Aplicativos . . . . . . . . . . . 399

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

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

Alterar o Script de Inicialização do Servidor de Aplicativos para WebLogic. . . . . . . . . . . . . 403Alterar o Script de Inicialização do Servidor de Aplicativos para JBoss . . . . . . . . . . . . . . 404

Configurar Propriedades do Servidor de Aplicativos e Instalar Componentes IBM Cognos . . . . . . . . 405Instalar o IBM Cognos no WebSphere . . . . . . . . . . . . . . . . . . . . . . . . . 405Instalar o IBM Cognos no WebLogic. . . . . . . . . . . . . . . . . . . . . . . . . . 406Instalar o IBM Cognos no SAP NetWeaver . . . . . . . . . . . . . . . . . . . . . . . 408Instalar o IBM Cognos no JBoss . . . . . . . . . . . . . . . . . . . . . . . . . . . 409

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

Configurar Diretório Virtual para SAP NetWeaver . . . . . . . . . . . . . . . . . . . . . 411Cancelar Registro dos Dispatchers que Foram Configurados para Tomcat . . . . . . . . . . . . . . 411Upgrade para IBM Cognos BI em um Ambiente de Servidor de Aplicativos . . . . . . . . . . . . . 412

Capítulo 15. Manutenção do desempenho . . . . . . . . . . . . . . . . . . . . 413Métricas de desempenho do sistema. . . . . . . . . . . . . . . . . . . . . . . . . . . 413

Monitoramento das métricas do sistema externamente. . . . . . . . . . . . . . . . . . . . 413Ativação apenas de serviços obrigatórios . . . . . . . . . . . . . . . . . . . . . . . . . 414Ajustando um Armazenamento de Conteúdo do DB2 . . . . . . . . . . . . . . . . . . . . . 417Ajustando os Recursos de Memória para o Serviço do IBM Cognos . . . . . . . . . . . . . . . . 417Reduzindo o Número de Solicitações por Processo . . . . . . . . . . . . . . . . . . . . . . 418Ajustar Configurações do Apache Tomcat para Instalações de 64 Bits . . . . . . . . . . . . . . . . 418Aumentando a Capacidade de Manipulação de Solicitações para o Banco de Dados de Conteúdo do Cognos . . 419Melhoria do desempenho do banco de dados de armazenamento de métricas . . . . . . . . . . . . . 419Redução do tempo de entrega para relatórios em uma rede . . . . . . . . . . . . . . . . . . . 420Aumento do limite de tempo assíncrono em ambiente de carregamento de uso intenso. . . . . . . . . . 420

Capítulo 16. Configurando Manualmente o IBM Cognos Business Intelligence nosSistemas Operacionais UNIX e Linux . . . . . . . . . . . . . . . . . . . . . . 421Alterar Manualmente Definições de Configuração Padrão . . . . . . . . . . . . . . . . . . . 421Incluindo um Componente em Sua Configuração . . . . . . . . . . . . . . . . . . . . . . 422Alterando as Configurações Criptografadas Manualmente . . . . . . . . . . . . . . . . . . . 423Configurações Globais em Sistemas Operacionais UNIX e Linux . . . . . . . . . . . . . . . . . 424

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

Iniciando o Cognos BI em Modo Silencioso em Sistemas Operacionais UNIX e Linux . . . . . . . . . 426Parando o Cognos BI em Modo Silencioso em Sistemas Operacionais UNIX e Linux . . . . . . . . . 427

Criar Manualmente um Arquivo de Aplicativo IBM Cognos . . . . . . . . . . . . . . . . . . . 427Criando Arquivo de Aplicativo IBM Cognos para o Software Business Intelligence . . . . . . . . . . 428Criando Arquivo de Aplicativo IBM Cognos para um Gateway de Servlet . . . . . . . . . . . . . 429

Índice ix

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

Usar um Arquivo de Resposta a partir de uma Instalação em Outro Computador . . . . . . . . . . 432Modificando um Arquivo de Resposta . . . . . . . . . . . . . . . . . . . . . . . . . 433Iniciando uma Instalação Não Assistida . . . . . . . . . . . . . . . . . . . . . . . . 434

Usar uma Configuração Não Assistida . . . . . . . . . . . . . . . . . . . . . . . . . . 435Use uma Desinstalação Não Assistida . . . . . . . . . . . . . . . . . . . . . . . . . . 436

Capítulo 18. Desinstalando o IBM Cognos BI . . . . . . . . . . . . . . . . . . . 439Desinstalar o IBM Cognos Business Intelligence nos Sistemas Operacionais UNIX ou Linux . . . . . . . . 439Desinstale o IBM Cognos Business Intelligence em Sistemas Operacionais Windows . . . . . . . . . . . 440

Apêndice A. Recursos de acessibilidade . . . . . . . . . . . . . . . . . . . . 441Atalhos de teclado do assistente de instalação . . . . . . . . . . . . . . . . . . . . . . . 441

Apêndice B. Integração do Google OneBox para IBM Cognos Business Intelligence 443Configurando Componentes do IBM Cognos OneBox . . . . . . . . . . . . . . . . . . . . . 445

Configurar Segurança para um Módulo de Amostra do Google OneBox . . . . . . . . . . . . . . 445Configurar um Módulo de Amostra do Google OneBox . . . . . . . . . . . . . . . . . . . 447Customizando os Resultados da Procura para o Provedor do Google OneBox . . . . . . . . . . . . 448

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

Apêndice D. Amostras . . . . . . . . . . . . . . . . . . . . . . . . . . . . 457A Companhia de Aventuras de Amostra . . . . . . . . . . . . . . . . . . . . . . . . . 457

Grupo de Empresas da Companhia de Aventuras de Amostra . . . . . . . . . . . . . . . . . 457Funcionários . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459Vendas e Marketing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459Amostra do Banco de Dados, Modelos e Pacotes de Outdoors . . . . . . . . . . . . . . . . . 460

Instalação do IBM Cognos Business Intelligence Samples . . . . . . . . . . . . . . . . . . . . 463Instalando Amostras no UNIX ou Linux . . . . . . . . . . . . . . . . . . . . . . . . 463Instalando Amostras no Windows . . . . . . . . . . . . . . . . . . . . . . . . . . 463

Configurando as Amostras . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464Utilizando Amostras . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464Restaurando Arquivos de Backup para Banco de Dados de Amostras . . . . . . . . . . . . . . 465Restaurar as Amostras no IBM DB2 Usando um Script . . . . . . . . . . . . . . . . . . . 468Restaurar as Amostras em Oracle Usando um Script . . . . . . . . . . . . . . . . . . . . 472Criar Conexões de Origem de Dados para os Bancos de Dados de Amostras . . . . . . . . . . . . 475Configurar Amostras de Cubos do Microsoft Analysis Services . . . . . . . . . . . . . . . . . 477Configurar a Amostra de Serviços de Cubo do InfoSphere Warehouse . . . . . . . . . . . . . . 478Configure as Amostras do IBM Cognos TM1 . . . . . . . . . . . . . . . . . . . . . . . 479Configurar a Amostra de Cubo Essbase . . . . . . . . . . . . . . . . . . . . . . . . 480Criando Conexões de Origem de Dados para Origens de Dados OLAP . . . . . . . . . . . . . . 481Configurando a Amostra do Metric Studio . . . . . . . . . . . . . . . . . . . . . . . 484Importar as Amostras . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 486Modelos de Banco de Dados de Amostras do Framework Manager . . . . . . . . . . . . . . . 488Exemplo - Executar a amostra Agentes de devoluções ELM com base nos dados alterados . . . . . . . 489Remova os Pacotes de Amostras e Relatórios do IBM Cognos BI . . . . . . . . . . . . . . . . 491

Apêndice E. Solução de problemas . . . . . . . . . . . . . . . . . . . . . . . 493Resolvendo um Problema . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 493

Procurando em Bases de Conhecimento . . . . . . . . . . . . . . . . . . . . . . . . 495Obtendo Correções . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 496Entrando em Contato com o Suporte IBM . . . . . . . . . . . . . . . . . . . . . . . . 496Trocando Informações com a IBM . . . . . . . . . . . . . . . . . . . . . . . . . . 497Assinando Atualizações de Suporte . . . . . . . . . . . . . . . . . . . . . . . . . . 498

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

x IBM Cognos Business Intelligence Versão 10.2.1.1: Guia de Instalação e Configuração

CFG-ERR-0106 Erro ao Iniciar o Serviço do IBM Cognos no IBM Cognos Configuration . . . . . . . . 503Erro Criptográfico ao Iniciar o IBM Cognos Business Intelligence . . . . . . . . . . . . . . . . 505Não É Possível Iniciar o Serviço do IBM Cognos Porque a Porta Está Sendo Usada por Outro Processo . . . 505O Serviço do IBM Cognos não Inicia ou Falha após Iniciar . . . . . . . . . . . . . . . . . . 506Servidor IBM Cognos Business Intelligence Falha ao Iniciar e Não Fornece Mensagem de Erro . . . . . . 507Servidor Não Disponível ao Iniciar o IBM Cognos Business Intelligence . . . . . . . . . . . . . . 507Não É Possível Efetuar Logon em um Namespace ao Usar o IBM Cognos Connection . . . . . . . . . 510Os Serviços do IBM Cognos Falham ao Reiniciar após uma Indisponibilidade da Rede . . . . . . . . . 510Nenhum Aviso de que Instalar a Versão mais Recente Atualizará Automaticamente a Versão Anterior doArmazenamento de Conteúdo . . . . . . . . . . . . . . . . . . . . . . . . . . . . 511Falha no Download do Recurso . . . . . . . . . . . . . . . . . . . . . . . . . . . 511DB2 Retorna Erro SQL1224N ao se Conectar do AIX . . . . . . . . . . . . . . . . . . . . 511Erro do Content Manager ao Iniciar o IBM Cognos Business Intelligence . . . . . . . . . . . . . 512Content Manager Falha ao Iniciar ou Leva Muito Tempo para Iniciar. . . . . . . . . . . . . . . 512DPR-ERR-2014 Exibido Erro no Arquivo de Log no Computador com Content Manager . . . . . . . . 513Caracteres Não ASCII no Diretório de Instalação Causam Erros de Tempo de Execução . . . . . . . . 514Não É Possível Abrir um Microsoft Cube ou PowerCube . . . . . . . . . . . . . . . . . . . 514A Página não Pode Ser Localizada ao Iniciar o IBM Cognos Business Intelligence no Windows 2003 . . . . 515A página não é mostrada ao abrir um portal após instalar o IBM Cognos Business Intelligence . . . . . . 515DPR-ERR-2058 Erro Exibido no Navegador da Web ao Iniciar o IBM Cognos Business Intelligence . . . . . 516O Report Studio não Inicia . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 518DPR-ERR-2022 Erro Exibido no Navegador da Web ao Iniciar o IBM Cognos Business Intelligence . . . . . 518Caracteres Corrompidos na Instalação de alguns Idiomas no Linux . . . . . . . . . . . . . . . 518Não É Possível Fazer o Download do Arquivo cognos.xts . . . . . . . . . . . . . . . . . . 519Falha do Script de Inicialização do Servidor de Aplicativos . . . . . . . . . . . . . . . . . . 519O IBM Cognos Business Intelligence Falha em Execução no WebLogic Application Server no AIX . . . . . 520Falha na Implementação do IBM Cognos Business Intelligence IBM WebSphere Application Server. . . . . 520Não é possível desserializar o erro de atributo de contexto ao implementar o arquivo p2pd.war no WebLogic 520Exibido Erro após a Atualização do IBM Cognos Business Intelligence em um WebLogic Application Server 521Caracteres Acentuados ou de Byte Duplo Podem Não Ser Exibidos Corretamente ao Instalar o IBM CognosBusiness Intelligence no Linux. . . . . . . . . . . . . . . . . . . . . . . . . . . . 521Erros "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 . . . . . . . . . . . . . . . 521Não é Possível Iniciar o Serviço IBM Cognos ao Atualizar Instalações Multitenant . . . . . . . . . . 522

Problemas ao Configurar o IBM Cognos Business Intelligence . . . . . . . . . . . . . . . . . . 523Executando Scripts de Limpeza do Banco de Dados e de Índice . . . . . . . . . . . . . . . . 523Erro ao Tentar Criptografar Informações ao Salvar sua Configuração . . . . . . . . . . . . . . . 526CAM-CRP-1315 Erro ao salvar configuração . . . . . . . . . . . . . . . . . . . . . . . 527CAM-CRP-0221 Erro ao Efetuar Login no Portal. . . . . . . . . . . . . . . . . . . . . . 528Aviso para o Download do Gateway ISAPI . . . . . . . . . . . . . . . . . . . . . . . 528Alterar Manualmente o Nome do Diretório de Instalação Afeta Instalações em Execução em um Servidor deAplicativos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 529Os Dados de Configuração estão Bloqueados por Outra Instância do IBM Cognos Configuration . . . . . 529Não é Possível Sair de uma Sequência de Tabs Usando Somente a Navegação pelo Teclado no IBM CognosConfiguration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 530Não É Possível Salvar sua Configuração . . . . . . . . . . . . . . . . . . . . . . . . 530Erro do Java ao Iniciar o IBM Cognos Configuration . . . . . . . . . . . . . . . . . . . . 531Erro Criptográfico ao Iniciar o IBM Cognos Configuration . . . . . . . . . . . . . . . . . . 531Reinício do Serviço do IBM Cognos para Aplicação das Definições de Configuração. . . . . . . . . . 531CM-CFG-029 Erro ao Tentar Salvar uma Configuração que Especifica Armazenamento de Conteúdo doMicrosoft SQL Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 532Erro DB2 não Localizado para Linux no System z . . . . . . . . . . . . . . . . . . . . . 532DPR-ERR-2079 Quando o Content Manager Está Configurado para Failover . . . . . . . . . . . . 532Falha ao Importar um Grande Armazenamento de Conteúdo no Solaris Usando o JRE 1.5 . . . . . . . 533A Importação de uma Grande Implementação no Windows Trava a Java Virtual Machine . . . . . . . . 533Mensagem de Erro CCL-BIT-0006 ao Usar o WebSphere Application Server em um Sistema PesadamenteCarregado . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 533Erro DPR-ERR-2008 Ao Abrir um Relatório . . . . . . . . . . . . . . . . . . . . . . . 534Não é Possível Carregar o TM1 Cubeviewer ou WebSheet iWidget no Business Insight . . . . . . . . . 534Usuários Devem Fornecer Credenciais do Active Directory . . . . . . . . . . . . . . . . . . 535A Fonte do UNIX não foi Localizada ao Iniciar o IBM Cognos Configuration . . . . . . . . . . . . 535

Índice xi

ESSBASEPATH Não Pode Ser Detectado . . . . . . . . . . . . . . . . . . . . . . . . 536Problemas ao Testar Conexões de Origem de Dados com o IBM Cognos BI Implementado no SAP NetWeaverApplication Server 7.1.1 no UNIX . . . . . . . . . . . . . . . . . . . . . . . . . . 536Falha na Consulta ao Usar o Servidor Oracle Essbase . . . . . . . . . . . . . . . . . . . . 537Associação ao Grupo Ausente do Namespace do Active Directory . . . . . . . . . . . . . . . . 538Erros Exibidos ao Implementar no Oracle 10G Application Server . . . . . . . . . . . . . . . . 539Erro Página não Localizada ao Executar Relatórios Usando o IBM Cognos for Microsoft Office . . . . . . 539Erro de Tempo Limite do CGI durante a Conexão com o IBM Cognos Business Intelligence por meio de umNavegador da Web . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 540Falha da Classe de Servlet ao Carregar no WebLogic . . . . . . . . . . . . . . . . . . . . 540Ícones de Área de Trabalho ou da Janela do IBM Cognos Configuration Cintilam no Windows . . . . . . 541Traduções Ausentes de Nomes de Objetos em Alguns Códigos de Idiomas . . . . . . . . . . . . . 542

Avisos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 545

Índice Remissivo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 549

xii IBM Cognos Business Intelligence Versão 10.2.1.1: Guia de Instalação e Configuração

Introdução

Este documento deve ser usado com o IBM® Cognos Business Intelligence. O IBMCognos BI é um produto da Web com recursos integrados de relatório, análise,scorecard e gerenciamento de eventos.

Este guia contém instruções para instalar, atualizar, configurar e testar o IBMCognos BI, alterar servidores de aplicativos e configurar amostras.

Público-alvo

Para utilizar esse guia, é preciso estar familiarizado comv Conceitos de relatórios.v conceitos sobre scorecardsv conceitos sobre banco de dados e armazém de dadosv problemas de segurançav qualificações de administração básicas do Windows ou UNIXv O ambiente de servidor e a infra-estrutura de segurança existentes na empresa.

Localização de informações

Para localizar a documentação do produto do IBM Cognos na web, incluindo todaa documentação traduzida, acesse um dos Centros de Informações do IBM Cognos(http://pic.dhe.ibm.com/infocenter/cogic/v1r0m0/index.jsp). As Notas sobre aLiberação são publicadas diretamente nos Centros de Informações e incluem linksnas notas técnicas e APARs mais recentes.

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

Documentação do Produto IBM Cognos Software DevelopmentKit

Após a instalação do IBM Cognos Software Development Kit, a documentação dodesenvolvedor fica disponível no produto.

É possível acessar a documentação por meio dos métodos a seguir:v No IBM Cognos Administration, clique em Ajuda > Mais Documentação; em

Documentação do IBM Cognos, é possível abrir os documentos do SoftwareDevelopment Kit em formato PDF ou HTML.

v Na pasta c10_location\webcontent\documentation\en, é possível abrir osdocumentos em formato PDF ou HTML.

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 de

© Copyright IBM Corp. 2005, 2013 xiii

http://pic.dhe.ibm.com/infocenter/cogic/v1r0m0/index.jsp

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

instalação” na página 441. A documentação HTML do IBM Cognos possui recursosde acessibilidade. Os documentos PDF são complementares e, como tal, nãoincluem recursos de acessibilidade adicionais.

Instruções prospectivas

Esta documentação descreve a funcionalidade atual do produto. Pode-se incluirreferências aos itens que não estão disponíveis atualmente. Não se deve inferirimplicações de qualquer disponibilidade futura. Quaisquer dessas referências nãosão um compromisso, promessa ou obrigação legal de entregar qualquer material,código ou funcionalidade. O desenvolvimento, a liberação e a sincronização derecursos ou funcionalidade permanecem conforme critérios exclusivo da IBM.

Termo de responsabilidade das amostras

A Companhia das Aventuras de Amostra, a Companhia das Grandes Aventuras,Vendas GA, qualquer variação dos nomes Aventuras de Amostra ou GrandesAventuras e Amostra de Planejamento representam operações de negócios fictíciascom dados de amostra usados para desenvolver aplicativos de amostra para a IBMe clientes IBM. Esses registros fictícios incluem dados de amostra para transaçõesde vendas, distribuição de produtos, e recursos humanos e financeiros. Qualquersemelhança com nomes, endereço, números de contato ou valores de transaçõesreais é mera coincidência. Outros arquivos de amostras podem conter dadosficcionais gerados manualmente ou por máquinas, dados fatuais compilados deorigens acadêmicas ou públicas, ou ainda dados usados com a permissão doportador dos direitos autorais, para uso como dados de amostra a fim dedesenvolver aplicativos de amostras. Os nomes de produtos a que são feitasreferências podem ser marcas registradas de seus respectivos proprietários. A cópianão autorizada é proibida.

As amostras incluídas com o IBM Cognos Business Intelligence destinam-se apenasa propósitos de demonstração e não são totalmente acessíveis.

xiv IBM Cognos Business Intelligence Versão 10.2.1.1: Guia de Instalação e Configuração

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

Esta seção contém uma lista de recursos novos, alterados, descontinuados eremovidos que afetam a instalação e a configuração deste release. A seção auxiliaráno planejamento de estratégias de implantação de aplicativos e atualizações e desolicitações de treinamento dos usuários.

Para obter informações sobre outros novos recursos para essa liberação, consulte oIBM Cognos Business Intelligence New Features Guide.

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ório, servidores debanco de dados e servidores de aplicativos, consulte a página do IBM SoftwareProduct Compatibility Reports (SPCR) (www.ibm.com/support/docview.wss?uid=swg27037784).

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.

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

Gateway IBM Cognos de 64 Bits como Padrão em Instalaçõesde 64 Bits

Nas versões anteriores, se você instalasse as versões de 64 bits do IBM CognosBusiness Intelligence, apenas as versões de 32 bits do componente de gatewayeram as versões padrão. Se você desejasse utilizar a versão de 64 bits de gateway,você tinha de mover manualmente os arquivos de gateway de 64 bits.

A versão de 64 bits do gateway agora é o padrão para todas as instalações de 64bits. Para uma instalação de 32 bits, a versão de 32 bits do gateway é o padrãopara instalações de 32 bits.

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 dearmazenamento no banco de dados de armazenamento de conteúdo configurandoum objeto externo.

© Copyright IBM Corp. 2005, 2013 1

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


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ágina258Você 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 tópicos a seguir descrevem os novos recursos da 10.2.0.

Gateway IBM Cognos de 64 BitsNas versões anteriores, se você instalasse as versões de 64 bits do IBM CognosBusiness Intelligence, apenas as versões de 32 bits do componente de gatewayficavam disponíveis. Nesta versão, as versões de 64 bits do gateway também estãodisponíveis.

A versão de 64 bits do gateway é o padrão para todas as instalações de 64 bits.Para uma instalação de 32 bits, a versão de 32 bits do gateway é o padrão parainstalações de 32 bits.

Configuração de Aplicativos Multitenant no IBM CognosConfiguration

É possível usar novas propriedades no IBM Cognos Configuration para configurarambientes do Business Intelligence que suportam aplicativos multitenant.

Dependendo do seu ambiente, é possível aplicar as propriedades avançadasmultitenancy.TenantPattern ou multitenancy.ITenantProvider para namespacesindividuais ou para todos os namespaces em seu ambiente.Informações relacionadas:“Configurando Definições de Diversos Arrendatários” na página 259Antes que seja possível usar a ocupação variada do IBM Cognos, você devemodificar as definições de configuração na instalação do IBM Cognos BusinessIntelligence. As propriedades de diversos arrendatários que você especifica paraum namespace específico substituem quaisquer propriedades de diversosarrendatários que você configura globalmente.

Configurações Predefinidas do LDAPNo IBM Cognos Configuration, é possível configurar seu ambiente selecionando apartir de um número de configurações predefinidas de namespace de autenticaçãoLDAP.

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

2 IBM Cognos Business Intelligence Versão 10.2.1.1: Guia de Instalação e Configuração

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 do UNIX ou Linux.

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

Informações relacionadas:“Iniciando uma Instalação Não Assistida” na página 434É possível iniciar uma instalação não assistida e escolher exibir ou não asmensagens durante o processo de instalação.

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

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

Novos Recursos na Versão 10.1.1Os novos recursos desde a última liberação são os seguintes.

Servidor de Relatório de 64 BitsNas instalações de 64 bits, o componente do servidor de relatório, incluído com osComponentes da camada de aplicativos, é fornecido nas versões de 32 bits e de 64bits. A versão de 64 bits do servidor de relatórios é destinada para uso compacotes criados para o modo de consulta dinâmica.Conceitos relacionados:“Instalando Versões de 64 Bits de Produtos IBM Cognos BI” na página 23Alguns 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.

IBM Cognos Content ArchivalO IBM Cognos Content Archival permite que você armazene versões de saída dorelatório e suas especificações de relatório de origem em um repositório de

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

arquivamento de conteúdo externo. O software suporta um IBM FileNet® ContentManager com o repositório externo IBM FileNet CMIS.

O IBM Cognos Content Archival é fornecido em um pacote configurável com osoftware Business Intelligence e é usado com um repositório do sistema dearquivos apenas para propósitos de teste e desenvolvimento.Conceitos relacionados:Capítulo 11, “IBM Cognos Content Archival”, na página 337Armazenar o conteúdo arquivado no seu repositório externo fornece apossibilidade de atender os requisitos de conformidade regulamentar e podemelhorar a escalabilidade e o desempenho dos produtos IBM Cognos porque reduzo tamanho do conteúdo no armazenamento de conteúdo.

Script para Geração de um Banco de Dados deArmazenamento de Conteúdo do IBM DB2

É possível criar um arquivo de linguagem de definição de dados (DDL) SQL apartir do IBM Cognos Configuration. Execute o script encontrado no IBM DB2para criar um banco de dados que pode ser usado para o armazenamento deconteúdo do IBM Cognos.Informações relacionadas:“Gerando um Arquivo de Script para Criar um Banco de Dados para umArmazenamento de Conteúdo do DB2” na página 88É possível gerar um arquivo de script para automaticamente criar oarmazenamento de conteúdo no IBM DB2 em todas as plataformas. O arquivo descript é denominado um arquivo DDL.

Instalar o IBM Cognos para IBM WebSphere a partir doAssistente para Construção de Aplicativo

É possível usar o Assistente para Construção de Aplicativo no IBM CognosConfiguration para instalar e configurar o IBM Cognos BI. Opções adicionais foramincluídas no assistente para permitir instalar e configurar o produto diretamente apartir do IBM Cognos Configuration.Informações relacionadas:“Use o Assistente para Construção de Aplicativo para construir e instalar o IBMCognos no IBM WebSphere Application Server” na página 401Use o Assistente de Construção de Aplicativo para construir, instalar e configurar oIBM Cognos Application no IBM WebSphere Application Server.

Novos Recursos na Versão 10.1.0Os novos recursos na versão 10.1.0 incluem o seguinte.

Modo de consulta dinâmicaIBM Cognos Business Intelligence Server oferece desempenho e funcionalidade deconsulta melhorados com um modo de consulta dinâmica que pode ser usado comas origens de dados suportadas.

Exige-se certa configuração antes que seja possível usar o modo de consultadinâmica.


Mais informações sobre o modo de consulta dinâmica

Para obter informações adicionais sobre o modo de consulta dinâmica, consulte osdocumentos listados na tabela a seguir.

Tabela 1. Onde localizar informações sobre o modo de consulta dinâmica

O que você está procurando? Onde encontrar as informações

Uma visão geral do modo de consultadinâmica, seus benefícios e considerações deuso.

IBM Cognos Business Intelligence: Guia deConsulta Dinâmica

Informações detalhadas sobre as técnicas eos comportamentos do produto no modo deconsulta dinâmica.

IBM Cognos 10 Dynamic Query Cookbook naseção Proven Practices do IBM SupportPortal (http://www.ibm.com/software/analytics/support/finding-answers).

Informações sobre a ativação daconectividade das origens de dadossuportadas pelo modo de consulta dinâmica.

IBM Cognos Business Intelligence: Guia deInstalação e Configuração

Informações sobre a administração doserviço de consulta, incluindo aspropriedades do cache e do serviço deconsulta.

IBM Cognos Business Intelligence: Guia deAdministração e Segurança

Informações sobre a publicação de pacotesno modo de consulta dinâmica.

IBM Cognos Framework Manager User Guide

Informações sobre o teste dos relatórios nomodo de consulta dinâmica antes daatualização.

Guia do Usuário do IBM Cognos LifecycleManager

Informações sobre o uso do IBM CognosSoftware Development Kit para administrarpropriedades do serviço de consulta edesenvolver aplicativos clientes para usar omodo de consulta dinâmica.

IBM Cognos Software Development Kit: Guia doDesenvolvedor

Informações relacionadas:“Configurar a Conectividade de Banco de Dados para Bancos de Dados deRelatório” na página 93Para suportar a comunicação entre o IBM Cognos Business Intelligence e as origensde dados, você deve instalar o software adicional para suas origens de dados nomesmo computador que hospeda o servidor de relatório. Dependendo da origemde dados e do modo de consulta, o software necessário pode incluir clientes debanco de dados e/ou arquivos do driver Java™ Database Connectivity (JDBC).

Colaboração Usando o IBM Cognos WorkspaceOs recursos de colaboração no IBM Cognos Workspace fornecem uma ponte entreo uso do IBM Cognos Business Intelligence para descobrir um problema denegócios e o uso de software social para controlar e resolver o problema. NaVersão 10.1.0, o IBM Connections e todos os componentes de software necessáriospara usá-lo com o Cognos BI são fornecidos em um pacote configurável com osprodutos do servidor IBM Cognos BI.

Os usuários do IBM Cognos Workspace podem criar atividades no IBMConnections e compartilhá-las com outros usuários que colaboram nos processosde tomada de decisão e de resolução de problemas. Para aproveitar este recurso,


http://www.ibm.com/software/analytics/support/finding-answers


você deve instalar e configurar o IBM Connections e o software necessário,incluindo o IBM WebSphere Application Server e suas atualizações.Conceitos relacionados:Capítulo 12, “Usando Colaboração com o IBM Cognos Workspace”, na página 347Os recursos de colaboração no IBM Cognos Workspace fornecem uma ponte entreo uso do IBM Cognos Business Intelligence para descobrir um problema denegócios e a ação para resolvê-lo.

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

Em releases anteriores, a documentação para o IBM Cognos Software DevelopmentKit não estava disponível on-line.

O Guia de Instalação e Configuração do IBM Cognos Software Development Kit naversão 10.1.0 está disponível no Centro de Informações do IBM Cognos, empic.dhe.ibm.com/infocenter/cbi/v10r1m0/.

Recursos alterados na versão 10.1.0Foram incluídos links para os tópicos diretamente relacionados para recursosalterados desde a última liberação

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.

O Upgrade Manager é renomeado como Lifecycle ManagerO Lifecycle Manager é um aplicativo baseado no sistema operacional MicrosoftWindows para atualizações de auditoria do ReportNet 1.1 MR3 ou MR4 e versõesanteriores do IBM Cognos BI para versões mais recentes do IBM Cognos BusinessIntelligence. Nas versões mais antigas, esse aplicativo chamava-se UpgradeManager.

Recursos de Procura de Índice São Nativos para o IBMCognos BI Server

Em releases anteriores, os recursos de procura de índice ficavam disponíveis pormeio da instalação do IBM Cognos Go! Search com seu produto de servidor IBMCognos BI.

O recurso de procura de índice agora é o modo de procura padrão no produto doservidor IBM Cognos BI. Não é necessário instalar um pacote separado, mas é


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

necessário realizar algumas configurações para habilitar serviços do índice econfigurar a escalabilidade , e é preciso criar o índice antes de usar o recurso deprocura de índice.

Para obter informações sobre a criação do índice e sobre a configuração depermissões do usuário para a procura de índice, consulte IBM Cognos BusinessIntelligence: Guia de Administração e Segurança.

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. Não é necessário instalar um pacote de painel separado,mas algumas tarefas são obrigatórias para a atualização do IBM Cognos Go!Dashboard.

IBM Cognos Special Edition Está Integrado aos Produtos IBMCognos BI Server

Em releases anteriores, o IBM Cognos Special Edition fornecia todos os produtosIBM para a criação de uma solução de relatório corporativa. Os produtos incluíamIBM WebSphere Application Server, IBM DB2 Universal Database e IBM HTTPServer. Na Versão 10.1.0, esses produtos são fornecidos em um pacote configurávelcom os produtos do servidor IBM Cognos BI.

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, configuraria umnamespace do Custom Java Provider no IBM Cognos Configuration para usá-lo.No servidor IBM Cognos Business Intelligence, Versão 10.1.0, é possível configurarum namespace RACF diretamente no IBM Cognos Configuration nos sistemasoperacionais AIX ou Linux para System z.Informações relacionadas:“Configurando o IBM Cognos para Usar um Provedor RACF para Autenticação”na página 386Se 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.

Suporte para o Banco de Dados do Servidor Informix DynamicO servidor IBM Cognos Business Intelligence suporta o uso do Informix DynamicServer como um banco de dados para o armazenamento de conteúdo, banco dedados de notificação e banco de dados de registros.


Scripts também são fornecidos para a limpeza das tabelas e dos índices em umbanco de dados do servidor Informix Dynamic.Informações relacionadas:“Diretrizes para Criar o Armazenamento de Conteúdo” na página 47O 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.“Configurando um Repositório para Mensagens de Log” na página 280O protocolo BI bus inclui processamento de mensagens de log, uma ferramenta dediagnóstico importante para investigar o comportamento dos IBM Cognos BIs.“Executando Scripts de Limpeza do Banco de Dados e de Índice” na página 523Em algumas situações de resolução de problemas, você poderá ser aconselhado ainiciar com novos dados de configuração.

IBM Cognos Portal ServicesO portal BEA AquaLogic User Interaction (ALUI) é substituído pelo OracleWebCenter Interaction Portal.Informações relacionadas:Capítulo 10, “Configuração do Portal Services”, na página 321Portal 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.

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.Informações relacionadas:“Monitoramento das métricas do sistema externamente” na página 413É 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.


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

Antes de implementar o IBM Cognos Business Intelligence, decida como você vaiinstalá-lo em seu ambiente. É possível instalar todos os componentes do servidorem um computador, ou distribuí-los em 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 BI é compatível com outros produtos IBM Cognos. Se seu ambienteincluir outros produtos IBM Cognos, você deverá considerar como o IBM CognosBI se ajustará ao seu ambiente.

Família IBM CognosA família de produtos IBM Cognos inclui o IBM Cognos Insight, IBM CognosExpress e IBM Cognos Enterprise. O IBM Cognos Enterprise pode ser IBM CognosTM1, IBM Cognos Business Intelligence, ou ambos.

A família de produtos IBM Cognos fornece soluções integradas que são dotamanho certo para a sua organização. As soluções são escaláveis e implementáveisem ambientes de diferentes tamanhos, a partir de um desktop para um únicoservidor para um server farm. Porque as soluções compartilham uma base comum,é possível iniciar com uma solução limitada que aborde uma necessidade imediatae depois expandir sua solução com o tempo. Por exemplo, você pode expandir suasolução da seguinte maneira:v Iniciar usando o IBM Cognos Insight para descoberta de dados, visualização e

planejamento.v Incluir um servidor que use o IBM Cognos Express para compartilhar os insights

que seus usuários adquirem. Criar analítica adicional para ajudar complanejamento, análise e relatório de grandes conjuntos de dados.

v À medida que a sua comunidade de usuários crescer ou seus requisitosanalíticos mudarem, expanda seus recursos usando o IBM Cognos Enterprise(IBM Cognos TM1 e IBM Cognos Business Intelligence). A partir de um servidor,é possível instalar remotamente o Cognos Insight em desktops na suaorganização. É possível adquirir insights a partir de informações corporativas emtempo real e colaborar com os membros de sua organização através dedispositivos móveis.

A tabela a seguir fornece uma comparação de produtos na família IBM Cognos.

Tabela 2. Comparação dos Principais Recursos do Cognos Insight, do Cognos Express edo Cognos Enterprise

Principais recursos Cognos Insight Cognos Express Cognos Enterprise

Painéis X X X

Análise X X X

Modelagem decenário What-if

X X X

Planejamento eorçamento

X X X


Tabela 2. Comparação dos Principais Recursos do Cognos Insight, do Cognos Express edo Cognos Enterprise (continuação)

Principais recursos Cognos Insight Cognos Express Cognos Enterprise

Relatórios deprodução

X X

Integração doMicrosoft Office

X X

Suporte para o iPadda Apple

X X

Suporte para outrosdispositivos móveis

X

Colaboraçãocorporativa

X

Kit deDesenvolvimentode Software

X

A família Cognos endereça as necessidades de gerenciamento de desempenho einteligência de negócios das seguintes entidades:v Indivíduos que requerem analítica pessoal e de desktop podem atender às suas

necessidades com o Cognos Insight.v Organizações de médio porte ou grupos de trabalho dentro de organizações

maiores podem atender às suas necessidades para relatório, análise eplanejamento integrados usando o Cognos Express.

v Empresas grandes que precisam implementar recursos analíticos para centenasou milhares de pessoas podem atender às suas necessidades com oCognosEnterprise.

Componentes do Produto Cognos EnterpriseIBM Cognos Business Intelligence é uma solução de inteligência de negóciosbaseada na Web com recursos integrados de relatório, análise, scorecard egerenciamento de eventos. O IBM Cognos Business Intelligence inclui IBM CognosBusiness Intelligence Server e IBM Cognos Business Intelligence Modeling.

O IBM Cognos BI integra-se facilmente em sua infraestrutura existente usandorecursos 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, o IBM Cognos BI usa Apache Tomcat como um servidor deaplicativos. É possível configurar os produtos IBM Cognos BI para execução nosservidores de aplicativos suportados que você usa atualmente em seu ambiente.

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,análises, scorecards e gerenciamento de eventos, assim como funcionalidades paraencaminhar e processar solicitações de usuários.


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

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.

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.

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

Relatórios profissionais - Report Studio

Com o Report Studio, autores de relatórios criam, editam e distribuem uma vastagama de relatórios profissionais. Eles também podem definir modelos de relatóriode padrões corporativos para usar no Query Studio, e editar e modificar relatórioscriados no Query Studio ou no Analysis Studio.

Consultas ad hoc e relatórios para uso próprio - Query Studio

Com o Query Studio, os usuários com pouco ou nenhum treinamento podem criare salvar relatórios rapidamente para corresponder a necessidades não atingidaspelos relatórios padrão e profissionais criados no Report Studio.

Monitoração de dados para condições excepcionais - Event Studio

No Event Studio, define-se agentes para monitorar seus dados e realizar tarefasquando ocorrerem eventos de negócios ou condições excepcionais com os quais sedeve lidar. Quando um evento ocorre, as pessoas são alertadas para agir. Osagentes podem publicar detalhes no portal, mandar alertas por e-mail, executar edistribuir relatórios baseados em eventos, e monitorar o status de eventos. Porexemplo, uma chamada de suporte de um cliente principal ou o cancelamento deum grande pedido pode acionar um evento, enviando um email às pessoasapropriadas.

Análise de métricas - Metric Studio

No Metric Studio, é possível criar e entregar um ambiente de scorecardscustomizado para monitorar e analisar métricas em sua organização. Os usuáriospodem monitorar, analisar e relatar informações críticas a tempo usando scorecardsbaseados em métricas funcionais cruzadas.

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.

Também é possível usar um software social, como o IBM Connections para tomardecisões de maneira colaborativa.

Compatibilidade com o Microsoft Office - IBM Cognos para MicrosoftOffice

Usando o IBM Cognos for Microsoft Office, os usuários do Microsoft Office podemacessar dados dos produtos de relatório do IBM Cognos dos aplicativos doMicrosoft Office.

Os componentes do IBM Cognos for Microsoft Office acompanham o IBM CognosBI e devem ser instalados separadamente.

O IBM Cognos for Microsoft Office não acompanha o IBM Cognos MetricsManager.


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 do Aplicativo Pré-configurado - Banco deDados de Conteúdo do Cognos

O Banco de Dados de Conteúdo do Cognos é uma instância de um banco dedados do Apache Derby. É um componente de instalação selecionável e não éinstalado por padrã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 IBMCognos Business 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.

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.

Acessando Diversas Origens de Dados - IBM Cognos BI VirtualView Manager

O IBM Cognos BI Virtual View Manager fornece acesso a origens de dadosadicionais como LDAP, Java Database Connectivity (JDBC), Open XML e WSDL, emelhora o desempenho ao consultar dados de diferentes origens de dados.


Componentes de modelagemOs componentes de modelagem modelam dados em origens de dados paraestruturar e apresentar dados de uma forma que faça sentido para o usuário. Oscomponentes de modelagem incluem as seguintes ferramentas:

Criação de uma visualização de negócios dos dados -Framework Manager

O IBM Cognos Framework Manager é a ferramenta de modelagem para criar egerenciar os metadados relacionados aos negócios para uso na análise e norelatório do IBM Cognos BI. Os metadados são publicados para uso comferramentas de relatórios como o pacote, fornecendo uma visualização de negóciosúnica e integrada de qualquer quantidade de origens de dados heterogêneas.

Extração de dados para scorecards - Metric Designer

Metric Designer é a ferramenta de modelagem usada para criar extrações paraserem usadas em aplicativos de scorecard do IBM Cognos BI. As extrações sãousadas para mapear e transferir as informações das origens de dados existentescomo arquivos IBM Cognos Framework Manager e Impromptu Query Definition(.iqd).

Modelagem Multidimensional - IBM Cognos Transformer

O IBM Cognos Transformer é a ferramenta de modelagem do IBM Cognos BIusada para criar PowerCubes para serem usados no IBM Cognos BI. Os IBMCognos BI PowerCubes seguros não são compatíveis com o IBM Cognos Series 7.

Para obter informações sobre como instalar e configurar versões do Transformeranteriores à 8.4, consulte a documentação fornecida com a sua edição doTransformer.

Series 7 IQD Bridge

O Series 7 IQD Bridge contém as informações de conexão que o IBM Cognos BIrequer para usar as origens de dados do IBM Cognos Series 7 Impromptu IQD eas consultas externas do IBM Cognos BI Framework Manager no IBM CognosTransformer. Ele também suporta a configuração de multiprocessamento nosmodelos do Series 7 que são importados no IBM Cognos Transformer.

Importação e gerenciamento de mapas - Map Manager

O IBM Cognos Map Manager é um utilitário baseado em Windows que osadministradores e modeladores usam para importar os mapas e atualizar osrótulos para os mapas no Report Studio. Para recursos de mapas, como nomes depaís ou região e de cidade, os administradores e os modeladores podem definirnomes alternativos para fornecer versões multilíngues do texto que aparece nomapa.

Para obter mais informações, consulte o Guia de Instalação e Usuário do IBMCognos Map Manager.


IBM Cognos Insight

No IBM Cognos Insight, é possível analisar dados, explorar cenários e influenciardecisões criando áreas de trabalho pessoais ou gerenciadas. Use estas áreas detrabalho interativas para comunicar resultados aos gerenciadores. Como o CognosInsight suporta writeback, também é possível usar estas áreas de trabalho parareunir e consolidar destinos, confirmações e previsões de gerenciamento.

O Cognos Insight é fornecido com o IBM Cognos BI. Use o IBM CognosConnection Installer for Cognos Insight para instalar o software de fornecimentoem servidores Cognos BI. Este software permite que diversos usuários façamdownload e instalem o IBM Cognos Insight em seus computadores a partir dainterface do IBM Cognos Connection.

Para obter informações adicionais, consulte IBM Cognos Insight: Guia de Instalação eConfiguração.

Componentes Necessários do Banco de DadosAlém das ferramentas fornecidas, o IBM Cognos Business Intelligence requer osseguintes componentes 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.

O produto IBMCognos BI inclui um banco de dados integrado, o Banco de Dadosde Conteúdo do Cognos, que pode ser usado para que o produto seja executadorapidamente em um sistema de teste ou de prova de conceito. Quando estiverpronto para configurar um ambiente de produção com o seu produto IBM CognosBI, configure o armazenamento de conteúdo para usar um banco de dadossuportado que possa ser assegurado e sintonizado para desempenho e estabilidade.O portal de administração fornece recursos que podem ser usados para fazerbackup e arquivar os dados do Banco de Dados de Conteúdo do Cognos antes quesejam movidos para o novo banco de dados de armazenamento de conteúdo noseu ambiente de produção. Para obter mais informações, consulte o tópico sobrecomo implementar o armazenamento de conteúdo inteiro no Guia deAdministração e Segurança do Business Intelligence IBM Cognos.

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.

Armazenamento de métricas

O armazenamento de métricas é um banco de dados relacional que possui oconteúdo para pacotes de métricas. O armazenamento de métrica também contémas configurações do Metric Studio, tais como preferências do usuário.


Pode ser criado mais de um armazenamento de métricas. Por exemplo, umarmazenamento de métricas possui o conteúdo de um aplicativo de vendas e ooutro pode possuir o conteúdo de um aplicativo de finanças.

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 de infra-estruturaAlém do software de inteligência de negócios, algumas ofertas do IBM CognosBusiness Intelligence incluem os seguintes produtos.

IBM WebSphere Application Server

O IBM WebSphere Application Server pode ser usado para os componentes doservidor de relatório IBM Cognos BI (Componentes da Camada de Aplicativos) e oContent Manager. O IBM WebSphere Application Server fornece uma infraestruturade aplicativo escalável segura para a arquitetura orientada a serviços (SOA) doIBM Cognos.

São fornecidos scripts para automatizar o processo de criação de portas distintaspara diversos aplicativos.

IBM Connections

O IBM Connections é o software de rede social projetado para o local de trabalho.O IBM Connections permite criar e gerenciar atividades a partir do IBM CognosWorkspace.

IBM HTTP Server

IBM HTTP Server é um servidor da Web baseado em uma parceria entre a IBM e oservidor da Web Apache.

IBM DB2 Universal Database

O IBM DB2 Universal Database fornece armazenamento de conteúdo para seusdados do IBM Cognos BI. O DB2 fornece desempenho, escalabilidade econfiabilidade líderes de mercado.

Os scripts são fornecidos para automatizar o processo de criação e configuração denovo armazenamento de conteúdo.


Distribuição de ComponentesQuando instala os componentes do servidor IBM Cognos BI, você especifica ondecolocar os gateways, 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 BI no mesmo local dos outrosprodutos IBM Cognos BI.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 Consolide diversos servidores instalando no System zO IBM Cognos BI é suportado para o sistema operacional Linux no System z.Esse tipo de instalação é adequada quando se está configurando oupersonalizando uma instalação no ambiente para adequar-se aos requisitos de TIe de infraestrutura.

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.

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.


Todos os Componentes do Servidor em um ComputadorÉ possível instalar todos os componentes do servidor IBM Cognos BI em umcomputador. Escolha esse cenário para ambientes de teste ou demonstração nosquais a carga de usuário é pequena.

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

Não é possível fazer uma instalação em um único computador nos sistemasoperacionais UNIX ou Linux, pois você deve instalar o Framework Managerbaseado no sistema operacional Microsoft Windows em um computador separadoque é executado no Windows.

No diagrama a seguir, todos os componentes do servidor estão instalados em umcomputador. O armazenamento de conteúdo, os bancos de dados de consulta e oFramework Manager estão localizadas em computadores separados.

Requisitos de Configuração

Se instalar todos os componentes do servidor para relatórios do IBM Cognos BI nomesmo computador, você deveráv Configurar seu servidor da Web para hospedar o webcontent do IBM Cognosv Especificar informações de conexão para o armazenamento de conteúdo.v Configurar uma conta de e-mail para notificações (se pretende enviar relatórios

por e-mail).

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

Figura 1. Instalação em um Único Computador dos Três Componentes do Servidor


É possível instalar o gateway e um servidor da Web em um computador e instalaros componentes de relatório restantes do IBM Cognos BI em outros computadores.Se tiver uma Web farm, considere a instalação de um gateway em cada servidorweb. A utilização de diversos servidores web para gerenciar solicitações recebidasoferece 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.


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.

Figura 2. Instalação com Dois Gateways


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.

No diagrama a seguir, o gateway passa a solicitação ao dispatcher (não exibido),que a passa para o computador com Content Manager ativo padrão. Como ocomputador falhou, a solicitação é redirecionada para o computador em esperacom Content Manager, que se tornou ativo quando o computador ativo padrãocom Content Manager falhou.



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. Aacessibilidade e a taxa de transferência também são melhores que em um únicocomputador, assim como o suporte a failover.

Exemplo - Distribuindo Serviços do Índice

Para distribuir os serviços do índice para a procura de índice, instale uma instânciados componentes da camada de aplicativos na camada de aplicativos, com oserviço de procura do índice e o serviço de atualização do índice ativados. Instale

Figura 3. Instalação com um Content Manager Ativo e Em Espera


os componentes da camada de aplicativos adicionais na camada do aplicativoconforme necessário, com o serviço de procura de índice habilitado. Além disso,instale uma instância dos Componentes da Camada de Aplicativos na camada dedados, com o serviço de dados do índice ativado. O diagrama a seguir mostra oserviço de procura do índice e o serviço de atualização do índice na camada deaplicativos e os serviços de dados do índice na camada de dados.


Se você instalar um ou mais Componentes da Camada de Aplicativos em umcomputador separado, para garantir que eles possam se comunicar com outroscomponentes de relatório do IBM Cognos BI, 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.

Produtos IBM Cognos BI no Mesmo ComputadorOs produtos IBM Cognos BI são projetados para compartilhar componentes,incluindo gateway, Content Manager, armazenamento de conteúdo, IBM CognosConnection e IBM Cognos Configuration. Se você instalar mais de um produtoIBM Cognos BI no mesmo computador, instale-os no mesmo local de instalação. Oprograma de instalação verifica se existe outro componente do IBM Cognos BI nolocal de instalação. Se existir um componente e puder ser compartilhado, não seráreinstalado.

Acessando a Documentação do Produto em um AmbienteIntegradoA documentação para componentes do IBM Cognos BI é instalada com ocomponente de gateway. Se você integrar diferentes produtos IBM Cognos BI, épossível usar o mesmo gateway ou gateways separados.

Se quiser usar o mesmo gateway, todos os componentes de gateway deverão ter amesma versão do produto e você deverá instalar o componente de gateway doIBM Cognos BI para cada produto no mesmo local no mesmo computador. Issogarante que toda a documentação do produto esteja disponível para todos osusuários. Se você quiser usar gateways separados para cada produto, é possívelinstalar o componente de gateway do IBM Cognos para cada produto emcomputadores separados, mas a documentação do produto em cada gateway seráespecífica para o produto IBM Cognos BI instalado.

Figura 4. Serviços do Índice Distribuído


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.

Consolidando Servidores para Linux no System zO sistema operacional Linux no System z é uma implementação nativa do sistemaoperacional Linux. As opções de hosting incluem a execução do Linux e uma oumais partições lógicas (LPAR).

Recurso Integrado para Linux (IFL)

IFLs são processadores do System z dedicados à execução de cargas de trabalhodo sistema operacional Linux nativamente, ou sob software de virtualização,dependendo de suas necessidades. IFLs permitem consolidar e gerenciarcentralmente recursos do Linux no System z.

Modo de Partição Lógica (LPAR)

O sistema operacional Linux pode ser executado em LPARs e se comunicar comoutras partições do Linux usando conexões TCP/IP.

A escalabilidade horizontal em um grande ambiente Linux é limitada pelo númerode LPARs que podem ser criadas. A execução do Linux em LPARs pode ser melhorse você estiver executando um pequeno número de imagens do Linux e cada umadessas imagens estiver usando uma grande quantidade de energia deprocessamento ou exigir uma grande quantidade de memória dedicada. Issogarante que as imagens não terão recursos sub-utilizados alocados a elas.

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.

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

Tabela 3. 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 4. 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.

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)

Usando a Versão de 64 Bits do Servidor de Relatório

Nas instalações de 64 bits, o componente do servidor de relatório, incluído com osComponentes da camada de aplicativos, é fornecido nas versões de 32 bits e de 64bits. Em instalações de 32 bits, apenas a versão de 32 bits do componente doservidor de relatório é fornecida.

A seleção da versão usada é feita com o IBM Cognos Configuration após ainstalação. Por padrão, o componente do servidor de relatório está configuradopara usar o modo de 32 bits, mesmo em um computador de 64 bits. O modo de 32bits permite executar relatórios de todos os pacotes, enquanto o modo de 64 bitspermite executar apenas relatórios criados a partir dos pacotes usando o modo deconsulta dinâmica.

Para pacotes que não estão usando o modo de consulta dinâmica, é necessário terum servidor de relatório de 32 bits em execução em seu ambiente. Relatórios depacotes que não usam o modo de consulta dinâmica não serão executados usandoo servidor de relatório de 64 bits.

Por exemplo, é possível instalar dois Componentes da camada de aplicativos emseu ambiente e ter um deles usando a versão de 32 bits do servidor de relatório e o


outro usando a versão de 64 bits, conforme mostrado no diagrama a seguir.

É possível controlar em quais servidores seus relatórios serão executados usandoregras de roteamento para os pacotes. Para obter mais informações sobre comoconfigurar regras de roteamento, consulte o Administration and Security Guide.

Opções de Instalação para Componentes de Modelagem do WindowsVocê instala as ferramentas de modelagem, como Framework Manager, MetricsDesigner e Transformer em computadores com o sistema operacional MicrosoftWindows.

Para publicar pacotes para que estejam disponíveis para usuários, configure asferramentas de modelagem para utilizar um dispatcher, quer diretamente ouatravés de um gateway. Se o IBM Cognos Connection estiver protegido, vocêdeverá ter privilégios para criar origens de dados e publicar pacotes no IBMCognos Connection.

Considerações sobre FirewallQuando a ferramenta de modelagem estiver fora de um firewall de rede queproteja os Application Tier Components, podem surgir problemas de comunicaçãocom o dispatcher. Por razões de segurança, a configuração padrão do IBM CognosBI impede o dispatcher de aceitar solicitações da ferramenta de modelagemquando ela está fora do firewall de rede.

Uma ferramenta de modelagem que está fora de um firewall de rede, por exemplo,Framework Manager, não pode enviar solicitações pelo firewall de rede para odispatcher no servidor de aplicativos IBM Cognos BI. Para evitar problemas ao secomunicar por um firewall de rede, instale a ferramenta de modelagem na mesmacamada de arquitetura que o Application Tier Components. O diagrama a seguirmostra o computador do Framework Manager dentro do firewall de rede, se

Figura 5. Opção de Distribuição para Uso da Versão de 64 Bits do Servidor de Relatório


comunicando com sucesso com o dispatcher no servidor de aplicativos IBMCognos BI.

Como alternativa, é possível instalar um gateway adicional que é dedicado àcomunicação com a ferramenta de modelagem conforme mostrado no diagrama aseguir. Em seguida, a ferramenta e o gateway podem ser configurados de formaque o dispatcher aceite solicitações da ferramenta de modelagem.

Figura 6. Computador Cliente Fora do Firewall


Distribuindo Componentes do Framework ManagerO Framework Manager comunica-se com os Application Tier Components, quepodem ser instalados em um ou mais aplicativos. Para publicar pacotes, configureo Framework Manager para se comunicar com o dispatcher, tanto diretamentecomo através de um gateway dedicado.


No computador em que o Framework Manager está instalado, configure asseguintes propriedades de ambiente:v URI do Gateway

v URI do dispatcher para aplicativos externos

Se a ferramenta de modelagem estiver utilizando um gateway dedicado em vez dese comunicar diretamente com o dispatcher, é necessário configurar também apropriedade URIs de dispatchers do gateway no computador de gatewaydedicado.

Distribuindo Componentes do TransformerO Transformer pode ser instalado em um computador contendo outroscomponentes do IBM Cognos BI ou em um computador separado de outroscomponentes do IBM Cognos BI. Quando instalado separadamente, o Transformer

Figura 7. Computador Cliente Fora do Firewall


pode ser usado como um produto independente ou pode ser configurado para secomunicar com outros componentes do IBM Cognos BI.

O Transformer consiste nos seguintes componentes. É possível ter um ou ambos,dependendo do ambiente.v Transformer no Windows

Esta é a ferramenta de modelagem do sistema operacional Microsoft Windowspara projetar PowerCubes que são usados no IBM Cognos BI. Também pode serutilizado para criar e publicar PowerCubes.

v Transformer no UNIX ou LinuxEste é o utilitário de linha de comandos para a construção de PowerCubes nossistemas operacionais UNIX e Linux. Primeiro você projeta os modelos usando oTransformer Windows ou scripts MDL e depois usa os modelos para aconstrução de PowerCubes.Instale os componentes de construção do Transformer PowerCube para Linux noSystem z.

Recursos Suportados

Quando você usa o Transformer como um produto independente, é possível usarorigens de dados que são externas para o IBM Cognos BI e não é possível criarvisualizações protegidas com filtragem dimensional. Quando você usa oTransformer com outros componentes do IBM Cognos BI, é possível usar osseguintes recursos fornecidos pelo IBM Cognos BI:v Provedores de autenticação do IBM Cognos BIv Origens de dados do IBM Cognos BI, como pacotes publicados, relatórios do

Query Studio e relatórios do Report StudioNão é possível utilizar arquivos simples como origens de dados.

v IBM Cognos Connection para publicação de origem de dados e pacote doPowerCube

v construção de PowerCubes

Considerações Sobre Servidores Baseados em Função

Você pode querer configurar servidores Transformer dedicados para obter odesempenho de construção do cubo ideal e acessibilidade para usuários do IBMCognos BI. Nesse cenário, considere os seguintes requisitos:v O software cliente de banco de dados é instalado em qualquer computador em

que o Transformer será utilizado para criar PowerCubes ou testar origens dedados.

v Para conectividade de origem de dados, configure variáveis de ambienteapropriadas para servidores UNIX and Linux.

v Servidores IBM Cognos BI têm acesso ao local em que PowerCubes sãoarmazenados para que o servidor de relatório possa acessar PowerCubes.

A construção e atualização de PowerCubes de produção podem ter scripts e serexecutados remotamente quando houver acesso e privilégios de usuário suficientes.Para obter mais informações sobre como criar e atualizar PowerCubes deprodução, consulte o Transformer User Guide.


Analistas ou Especialistas de Negócios

Pode-se ter negócios especializados ou usuários com poder que podem criarPowerCubes modelados em uma combinação de origens de dados pessoais ecorporativas. Esses usuários podem fazer sua própria análise dos dados para sualinha de negócio ou pequeno grupo de usuários. É possível permitir que taisusuários sejam auto-suficientes dentro da infra-estrutura de TI e de segurança daorganização atendendo aos seguintes requisitos:v O software do cliente de banco de dados está instalado, ou disponível para os

modeladores instalarem, em computadores com o Transformer que são usadospara acessar origens de dados do IBM Cognos BI ou origens de dados IQD doIBM Cognos Series 7.

v Modeladores devem ter privilégios para criar uma origem de dados no IBMCognos Administration.Modeladores não precisam de acesso direto ao IBM Cognos Administration. Elespodem criar e atualizar origens de dados utilizando o ferramentas doTransformer ou de linhas de comandos. É possível fornecer aos modeladoresuma pasta protegida no IBM Cognos Connection na qual publicar pacotes doPowerCube.

v Os modeladores devem ter acesso a uma localização na qual armazenarPowerCubes depois de criá-los.Esse local também deve estar acessível para o serviço do IBM Cognos e pode serum compartilhamento protegido em uma LAN.

v Para criar PowerCubes em um servidor Transformer específico, os modeladoresdevem ter privilégios de FTP para transferir modelos e executar privilégios paracriar cubos nesse servidor.Os modeladores podem transferir modelos e executar criações de cuboutilizando scripts. Os modeladores podem também utilizar métodosautomatizados para criar PowerCubes. Para obter mais informações, consulte oGuia de administração e segurança.


Para publicar pacotes PowerCubes, configure o Transformer para se comunicarcom o dispatcher, tanto diretamente como através de um gateway dedicado. Se oIBM Cognos Connection estiver protegido, você deverá ter privilégios para criarorigens de dados e publicar pacotes no IBM Cognos Connection.

No computador em que o Transformer está instalado, configure as seguintespropriedades de ambiente:v URI do Gateway




Informações relacionadas:“Instalando o IBM Cognos Transformer” na página 214Instale o Transformer se pretende criar PowerCubes para usar com o IBM CognosBI.“Origens de Dados e Transformer” na página 219As ferramentas de modelagem do IBM Cognos BI criam e gerenciam metadados. OIBM Cognos Transformer cria e gerencia metadados para PowerCubes. Comometadados são derivados de origens de dados em ambientes multiplataformas oumultilíngues, há várias coisas que você deve considerar ou fazer ao configurar umambiente de origem de dados para o IBM Cognos Transformer. Geralmente, issodepende da outra tecnologia utilizada para suas origens de dados ou deimportação.

Distribuindo Componentes do Metric DesignerPara o Metric Studio, se você desejar definir e carregar métricas a partir de origensde dados relacionais e dimensionais, incluindo cubos, pacotes do FrameworkManager ou Impromptu Query Definitions (arquivos .iqd), instale o MetricDesigner para extrair os dados.

Instale o Metrics Designer após instalar e configurar outros componentes do IBMCognos BI. Você deve instalar o Metrics Designer baseado no sistema operacionalMicrosoft Windows em um computador Windows.


O Metric Designer comunica-se com o Application Tier Components, que pode serinstalado em um ou mais aplicativos. Para publicar extrações, configure o MetricDesigner para se comunicar com o dispatcher, tanto diretamente como através deum gateway dedicado.

Você deve garantir que o Metrics Designer possa se comunicar com outroscomponentes de scorecard do IBM Cognos BI. No computador em que o MetricDesigner está instalado, configure as seguintes propriedades de ambiente:v URI do Gateway


Configuração adicional será necessária depois de instalar o Metric Designer paraque possa acessar alguns tipos de origens de dados .



Informações relacionadas:“Instalação e configuração do Metric Designer” na página 204É possível instalar o Metrics Designer, a ferramenta de modelagem de metadadospara o IBM Cognos Metrics Manager, no mesmo computador que os componentesdo IBM Cognos BI ou em um computador diferente. Todos os arquivos requeridossão copiados em um computador. Definições padrão são utilizadas para aconfiguração. No entanto, você pode querer alterar essas configurações padrão secondições existentes tornarem as opções padrão impróprias ou se você tiverinstalado o IBM Cognos BI em um computador diferente.

Distribuindo Componentes de Scorecard do IBM Cognos BIAo instalar o IBM Cognos BI Metrics Manager, você especifica onde colocar osgateways, Componentes da Camada de Aplicativos e Content Manager.

Os componentes de scorecard podem ser distribuídos quase da mesma forma queos componentes de relatório.

Se você estiver instalando o Metrics Manager com seus componentes de relatóriodo BI, poderá usar um servidor dedicado para seus Componentes da Camada deAplicativos do Metrics Manager. Para obter mais informações, consulte“Configurar uma Instância de Componentes da Camada de Aplicativos Apenas noMetrics Manager” na página 165.

É possível instalar esses componentes utilizando qualquer uma das seguintesopçõ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 de scorecard do IBM Cognos BI no mesmo computadordos outros produtos IBM Cognos BI.Os produtos IBM Cognos BI compartilham componentes, como o ContentManager. Se você pretende instalar os componentes de scorecard do IBM CognosBI no mesmo computador de outros produtos IBM Cognos BI, instale-os nomesmo local de instalação.

Após a instalação dos componentes de scorecard do IBM Cognos BI, você deveconfigurá-los para que eles possam se comunicar uns com os outros.


Além de instalar o Content Manager, Application Tier Components e componentesde gateway, pode-se escolher instalar o Metric Designer , o aplicativo demodelagem de metadados para scorecards. Independentemente do cenário deinstalação do IBM Cognos que você seguir, é possível instalar o Metrics Designer eo armazenamento de conteúdo em um computador separado dos Componentes daCamada de Aplicativos.

IBM Cognos Business Intelligence com Outros Produtos IBM CognosÉ possível instalar o IBM Cognos BI em um ambiente que inclua outros produtosIBM Cognos.

O assistente de instalação para o IBM Cognos BI pode reconhecer diretórioscompatíveis e mostrar um aviso quando ocorrerem conflitos. Após o IBM CognosBI ser instalado, é possível acessar objetos que são criados em outro produto IBMCognos no IBM Cognos BI. As exigências de acesso dependem de como se escolheexecutar os dois produtos.

Serviços Duplicados se Usando Diversos Produtos

Muitos produtos IBM Cognos usam serviços semelhantes, tais como o serviço derelatório e o serviço de apresentação. Se você estiver usando diversos produtos,tais como o IBM Cognos Business Intelligence com o IBM Cognos Metrics Managerou IBM Cognos PowerPlay, é necessário garantir que desative alguns dos serviçosduplicados para garantir que seus produtos funcionem apropriadamente.

Por exemplo, você tem oIBM Cognos Business Intelligence e o IBM CognosPowerPlay instalados. Ambos os produtos têm um serviço de relatórios e umserviço de apresentação. Se ambos os produtos forem acessados por meio domesmo gateway, os relatórios que devem ser executados nos serviços do IBMCognos BI podem ser roteados para os serviços do IBM Cognos PowerPlay. Oresultado pode ser que seus relatórios exibam um erro.

A lista a seguir mostra um exemplo de distribuição de componentes usando trêsservidores, no qual cada servidor hospeda um produto. O quarto servidor hospedao gateway comum.v Servidor A - IBM Cognos Business Intelligencev Servidor B - IBM Cognos Metrics Managerv Servidor C - IBM Cognos PowerPlayv Servidor D - o servidor da Web usado para todos os produtos1. No Servidor A, você deve ter o serviço de relatório e o serviço de apresentação

ativados.2. No Servidor B e no Servidor C, você deve desativar o serviço de relatório e o

serviço de apresentação.3. No Servidor D, estes serviços não estão presentes.

Produtos IBM Cognos que Podem Ser Atualizados para o IBMCognos Business Intelligence

Os produtos IBM Cognos a seguir são versões anteriores de componentes queagora estão em IBM Cognos BI ReportNet, IBM Cognos Metrics Manager, IBMCognos DecisionStream e IBM Cognos PowerPlay Web. Quando você atualiza esses


produtos para o IBM Cognos BI, é possível continuar executando as versõesanteriores simultaneamente no mesmo computador até ficar satisfeito com atransição para o IBM Cognos BI.

Cognos ReportNet

Para o ReportNet e o IBM Cognos BI serem executados simultaneamente, cadaversão deve ter portas, armazenamentos de conteúdo, alias da Web e configuraçõesde cookie exclusivos. Se você usar configurações padrão, a configuração só seránecessária para selecionar novas portas e um novo armazenamento de conteúdopara o IBM Cognos BI.

Não é possível usar conteúdo do ReportNet diretamente no IBM Cognos BI atévocê atualizar o ReportNet. Quando você atualizar para o IBM Cognos BI, oarmazenamento de conteúdo será atualizado para usar o esquema do IBM CognosBI e não poderá ser usado por versões anteriores. Desta forma, é necessário manteros armazenamentos de conteúdo novo e antigo para executar ambas as versões doproduto. É possível manter ambos os armazenamentos de conteúdo usando umdos seguintes caminhos:v criar uma cópia do banco de dados de armazenamento de conteúdo do

ReportNet usando utilitários de exportação de banco de dados e usar a cópiacom o IBM Cognos BI

v usar o recurso de exportação integrado no IBM Cognos Connection paraexportar o banco de dados de armazenamento de conteúdo do ReportNet eimportar a implementação exportada no IBM Cognos BI

É possível atualizar relatórios ao mesmo tempo ou atualizá-los mais tarde se forexigida compatibilidade com alguns aplicativos Software Development Kitexistentes.

Cognos Metrics Manager

Para usar o conteúdo do armazenamento de dados do IBM Cognos MetricsManager no IBM Cognos BI, você faz uma atualização exportando o conteúdo doarmazenamento de dados para arquivos simples, instalando o IBM Cognos BI edepois importando os arquivos simples no armazenamento de métricas do IBMCognos BI. Observe que o recurso de selecionador de cubo (capacidade de mapearmétricas específicas para intersecções de cubo) no IBM Cognos Metrics Managernão está disponível em outros Studios do IBM Cognos BI.

Cognos DecisionStream

É possível continuar executando o IBM Cognos DecisionStream Series 7simultaneamente com produtos IBM Cognos BI. Os catálogos criados usando oDecisionStream Series 7 devem ser atualizados antes de poder usá-los com o DataManager.

Para obter instruções sobre execução simultânea e upgrade de catálogosDecisionStream para o ambiente IBM Cognos BI Data Manager, consulte o capítulosobre o upgrade de um catálogo no Guia do Usuário do IBM Cognos Data Manager.

Cognos PowerPlay Web

É possível continuar usando relatórios da Web do PowerPlay nas interfaces com ousuário do PowerPlay 7 no portal do IBM Cognos BI. Também é possível fazer um


drill through entre o PowerPlay Web e o IBM Cognos BI. É possível publicar apartir do PowerPlay Enterprise Server no IBM Cognos BI, contanto que você useos mesmos nomes do host ou endereço IP para identificar o namespace Series 7 noIBM Cognos Series 7 e no IBM Cognos BI.

Também é possível atualizar os seguintes relatórios para os relatórios do IBMCognos BI usando IBM Cognos Migration Assistant:v Relatórios do Windows do PowerPlayv Relatórios do Explorer do PowerPlay Webv Relatórios do PowerPlay para Excelv Relatórios do PowerPlay para Windows publicados no PowerPlay Web

As ferramentas estão disponíveis na Central do Cliente IBM Cognos(http://www.ibm.com/software/data/support/cognos_crc.html).

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. Também é possível usar as ferramentasde migração para migrar o conteúdo do Series 7 PowerPlay para o IBM Cognos BIPowerPlay versão 10.2.0.

Produtos IBM Cognos Series 7 que Podem ser Migrados parao IBM Cognos Business Intelligence

É possível migrar metadados e aplicativos do IBM Cognos Series 7 para o IBMCognos BI. O conteúdo que pode ser migrado inclui modelos do Architect doWindows, relatórios de cliente do Impromptu e catálogos do Windows, conteúdodo Upfront e conteúdo baseado na Web do Windows e UNIX.

Para obter uma lista de versões suportadas do IBM Cognos Series 7 e para fazerdownload das ferramentas e da documentação do IBM Cognos MigrationAssistant, consulte o IBM Cognos Customer Center (http://www.ibm.com/software/data/cognos/customercenter).

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.

Upfront

É possível migrar conteúdo do Upfront para o IBM Cognos BI. O processo demigração mapeia a estrutura de conteúdo do Upfront para uma estrutura de pastado IBM Cognos Connection. Preservando a organização existente do Upfront, émais fácil completar tarefas administrativas, como aplicar segurança para oconteúdo migrado.


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

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

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

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.

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

Alguns produtos IBM Cognos fornecem funcionalidade que não está disponível noIBM Cognos BI. É possível usar esses produtos no mesmo ambiente do IBMCognos BI. Com alguns produtos, é possível acessar os diferentes tipos de cubosou relatórios no portal do IBM Cognos BI. Com outros produtos, é possível acessarrecursos exclusivos no portal do IBM Cognos BI.

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.

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 informações adicionais sobre como atualizar os PowerCubesassegurados pelo IBM Cognos Series 7, consulte o Guia do Usuário do IBM CognosBusiness Intelligence Transformer.

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.Para obter mais informações sobre como otimizar PowerCubes, consulte oTransformer 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 silencioso


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

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.

Cognos Analytic Applications

IBM Cognos Analytic Applications é uma solução de gerenciamento dedesempenho que inclui um armazém de dados preenchido, pacotes que descrevemos dados disponíveis no armazém de dados e um conjunto de relatóriospredefinidos.

IBM Cognos Analytic Applications Workbench é uma solução de gerenciamento dedesempenho que inclui dados de inteligência de negócios de amostra com os quaisé possível construir aplicativos e arquivos de origem de documentação que podemser modificados para você produzir sua própria documentação customizada para oproduto.

Alguns componentes do IBM Cognos Analytic Application estão disponíveis parainstalação em sistemas de 64 bits. Os diretórios de instalação padrão parainstalações de 64 bits são diferentes dos diretórios de instalação padrão parainstalações de 32 bits. Se estiver instalando todos os componentes do servidor emum único ou diversos servidores, os componentes de 32 e 64 bits devem estar emdiretórios separados.

Cognos Mobile

Com o IBM Cognos Mobile, é possível acessar relatórios criados com o AnalysisStudio, Report Studio, Query Studio e áreas de trabalho criadas no IBM CognosWorkspace em um dispositivo móvel (como Blackberry) ou em um computadortablet.

Para fazer o download, visualizar e interagir com relatórios, os dispositivos doIBM Cognos Mobile são baseados na Web, requerem o download de um clientenativo ou requerem a instalação de um Rich Client, além da instalação doscomponentes do IBM Cognos BI no servidor. O IBM Cognos Mobile e o servidorIBM Cognos BI devem estar na mesma versão.


Para obter informações adicionais, consulte IBM Cognos Mobile: Guia de Instalação eAdministração.

Cognos Lifecycle Manager

Lifecycle Manager é um aplicativo baseado em Windows para fazer auditoria deatualizações do ReportNet 1.1 MR3 ou MR4 e versões anteriores do IBM Cognos BIpara versões mais novas do IBM Cognos BI. Ele fornece um recurso de verificaçãoque valida, executa e compara resultados de relatórios de dois releases diferentesdo IBM Cognos BI. Isso ajuda a identificar problemas de atualizações ecompatibilidade entre versões. O design da interface com o usuário e o recurso deinformações do estado fornecem um processo de prática comprovada e suporte aoplanejamento de projetos de atualização e a informações de status. O LifecycleManager também automatiza a maior parte do processo de união de arquivosnecessários, como relatórios e modelos, para etapas de teste.

Para obter informações adicionais, consulte o IBM Cognos Lifecycle Manager UserGuide.

Cognos BI Business Viewpoint Studio

IBM Cognos BI Business Viewpoint Studio ajuda a fornecer uma versão dasverdadeiras dimensões usadas em processos de gerenciamento de desempenho deuma empresa. Com o Business Viewpoint Studio, você obtém um processo denegócio controlado, colaborativo, orientado para o fluxo de trabalho, a fim degerenciar mudanças manuais e automáticas em todos os dados relacionados acomo as empresas analisam e gerenciam seus negócios. Tanto o IBM Cognos BIBusiness Viewpoint Studio quanto o IBM Cognos BI devem estar na mesma versão.

Cognos Content Archival

Com o IBM Cognos Content Archival, é possível armazenar versões de saída dorelatório e suas especificações do relatório de origem em um repositório dearquivamento de conteúdo externo. Isto aprimora o desempenho do sistema eestende a escalabilidade do produto IBM Cognos ao reduzir o tamanho do ContentStore, enquanto ajuda a aderir aos restritos requisitos regulamentares. O IBMCognos Content Archival suporta um IBM FileNet® Content Manager com orepositório externo do IBM FileNet CMIS.

Para obter informações adicionais, consulte o Guia de Instalação e Configuração doIBM Cognos Business Intelligence.

Cognos TM1

O IBM Cognos TM1 integra o planejamento de negócios, a medida de desempenhoe os dados operacionais para permitir que as empresas otimizem a efetividade denegócios e a interação do cliente, independentemente da geografia ou estrutura. OCognos TM1 fornece visibilidade imediata nos dados, prestação de contas em umprocesso colaborativo e uma visualização consistente de informações, permitindoque os gerenciadores estabilizem rapidamente as flutuações operacionais e tiremproveito de novas oportunidades.

Para obter informações adicionais, consulte o Guia do Usuário IBM Cognos TM1.


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.

Cognos Portal Services

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



Capítulo 3. Preparando para Instalar

Antes de instalar o IBM Cognos Business Intelligence, você deve configurarrecursos em seu ambiente para que os componentes possam operar. Por exemplo,você deve criar um banco de dados para o armazenamento de conteúdo,configurar navegadores da Web e criar uma conta do usuário para o IBM CognosBI.

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.

Utilize a seguinte lista de verificação para guiá-lo através do processo deconfiguração:__ v Revise as Notas sobre o Release.__ v Revise os ambientes suportados.__ v Verifique as requisitos do sistema.__ v Revise as configurações padrão de porta.__ v Crie o banco de dados para o armazenamento de conteúdo.__ v Configure uma conta do servidor de rede ou usuário para IBM Cognos BI.__ v Configure variáveis de ambiente no sistema operacional UNIX para o

armazenamento de métricas, caso esteja usando IBM Cognos BI MetricsManager.

__ v Configure navegadores web.

Após concluir essas tarefas, continue com Instalando Componentes do IBM CognosBI em um Computador ou Instalando Componentes do IBM Cognos BI Server emDiferentes Computadores.

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 o Release antes de instalar seu produto. As Notas sobre oRelease 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 a partir da primeira página do assistente de instalaçãoou do disco do produto. As notas sobre a liberação também estão disponíveis apartir dos Centros de Informações do IBM Cognos Information Centers(http://pic.dhe.ibm.com/infocenter/cogic/v1r0m0/index.jsp).

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.




A não ser que seja indicado de outra forma, os produtos IBM Cognos sãocompatíveis com as versões mais recentes de pacotes de correções e serviço a partirdas versões determinadas.

É 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 da 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 pelo 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 5. 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 Para obter mais informações, consulte “Definições dememória” na página 44.

Especificações do sistemaoperacional

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




http://www.ibm.com/software/support/virtualization_policy.html

http://pic.dhe.ibm.com/infocenter/prodguid/v1r0/clarity/vesForProduct.html

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


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.

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 6. Requisitos de Software para uma Instalação em Computador Único


Servidor web Deve ser instalado e iniciado um servidor 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.

Capítulo 3. Preparando para Instalar 43

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


Banco de Dados 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

Para o IBM Cognos BI Metrics Manager, os seguintesbancos de dados são suportados para o armazenamentode métricas:

v Oracle

v DB2

v Microsoft SQL Server

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

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.

SAP BW Os seguintes componentes SAP Front-End instaladosem cada computador servidor IBM Cognos BI:

v SAP GUI

v Complementos do BW

Definições de memóriaAs configurações de memória dependem de muitos fatores, como o nível deatividade esperado no servidor, a complexidade dos aplicativos IBM Cognos, onúmero de usuários e de 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 informaçõesadicionais, 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 2 GB por núcleo para os processos de serviços (modo de consulta compatível)

(BIBuS)

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

Tabela 7. 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 deconsulta compatível)

2 GB por núcleo

Camada do Aplicativo do IBM Cognos (modo deconsulta

4 GB + 1 GB por núcleo

Camada do IBM Cognos Content Manager 4 GB

Mais recursos podem ser necessários ao instalar software adicional.

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.


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

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

Para obter informações adicionais sobre as versões suportadas do Java para IBMCognos BI, consulte o IBM Software Product Compatibility Reports (SPCR)(www.ibm.com/support/docview.wss?uid=swg27037784).

Para obter informações adicionais sobre esse padrão de segurança, consulte oCentro de Informações do IBM Java (publib.boulder.ibm.com/infocenter/java7sdk/v7r0/index.jsp?topic=%2Fcom.ibm.java.security.component.doc%2Fsecurity-component%2Fjsse2Docs%2Fsp800-131a.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.

Assegure-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, acesse o IBM Software Product CompatibilityReports (SPCR) (www.ibm.com/support/docview.wss?uid=swg27037784). Cliqueno link para a sua versão do Cognos BI e localize as informações das Bibliotecas deTempo de Execução Java.

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.



http://publib.boulder.ibm.com/infocenter/java7sdk/v7r0/index.jsp?topic=%2Fcom.ibm.java.security.component.doc%2Fsecurity-component%2Fjsse2Docs%2Fsp800-131a.html



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

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

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


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 Tomcat

A tabela a seguir lista as configurações usadas pelo IBM Cognos BI para Tomcat.Os conectores SSL e não SSL são atualizados automaticamente no arquivoserver.xml ao usar o IBM Cognos Configuration para alterar a porta do dispatcherou ativar o protocolo SSL. É possível atualizar diretamente a porta deencerramento usando o IBM Cognos Configuration.

Tabela 9. Definições padrão de porta para Tomcat

Configuração Porta Descrição

Conector diferente de SSLCoyote HTTP/ 1.1

9300 A porta que o Tomcat usa para transmitirsolicitações do servidor da Web para oIBM Cognos BI

Conector SSL Coyote HTTP/1.1

9334 A porta que o Tomcat utiliza para escutarconexões seguras

Porta de encerramento 9399 A porta que o Tomcat utiliza para escutarum comando de encerramento

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.

Você deverá criar o armazenamento de conteúdo antes que seja possível usar oproduto IBM Cognos Business Intelligence.

Se você estiver usando o IBM DB2 para o seu armazenamento de conteúdo, épossível gerar um DDL para permitir que seu administrador de banco de dadoscrie um banco de dados DB2 adequado para o armazenamento de conteúdo. Paraobter mais informações, consulte “Gerando um Arquivo de Script para Criar umBanco de Dados para um Armazenamento de Conteúdo do DB2” na página 88.

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

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.

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.


http://site.icu-project.org/

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

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.


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


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 a utilizaçãodessa variá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 12. 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.

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 O administrador do banco de dados deve fazer o backup dos bancos de dadosdo IBM Cognos BI regularmente, pois estes contêm os dados do IBM Cognos.Para garantir a segurança e integridade dos bancos de dados, proteja-os deacesso não autorizado ou inadequado.

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

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



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




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.– 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 IBM Informix Dynamic Server


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 ajudá-lo a configurar o armazenamento deconteúdo no banco de dados IBM Informix Dynamic Server.v Defina as seguintes variáveis de ambiente:

– GL_USEGLU - Para ativar a funcionalidade International Components forUnicode (ICU) no Informix Dynamic Server, configure o valor para 1.

– DB_LOCALE - Para definir o código do idioma do banco de dados,especifique en_us.utf8.

v No arquivo ONCONFIG.nome_da_instância, defina a propriedade SHMBASE para0x14000000L.

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. Paravários bancos de dados de armazenamento de conteúdo, atribua o nomeCMSCRIPT_CS_ID à propriedade. Para vários bancos de dados de criação delog, atribua o nome IPFSCRIPTIDX à propriedade.

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



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

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 tópico sobre configuração do servidor web.

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

A conta de serviço de rede é a conta 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 maisinformações, consulte o tópico sobre configuração do servidor web. Também énecessário ter permissões de gravação para fazer instalações no diretório.

Configurando Variáveis de Ambiente no UNIX para o Armazenamentode Métricas

Para o IBM Cognos Business Intelligence, você deve especificar variáveis deambiente em um sistema operacional UNIX antes que seja possível usar um bancode dados DB2 ou Oracle como o armazenamento de métricas.

A sintaxe correta para a criação de variáveis de ambiente depende do shell.

IBM DB2

Para bancos de dados do IBM DB2, você deve configurar as variáveis de banco dedados executando os scripts de configuração de ambiente incluídos na instalaçãodo IBM DB2. Para os shells Bourne ou Korn, execute o seguinte comando ouinclua-o no script .profile:

DB2_installation_path/db2profile

No AIX, assegure-se de que a variável LIBPATH inclua apenas as bibliotecas de 32bits. O db2profile padrão configura o LIBPATH para referência a bibliotecas de 64bits.

Entre em contato com o administrador de banco de dados ou da rede para obter osvalores corretos para o sistema.

Oracle

Para bancos de dados Oracle, você deve configurar e exportar as variáveis deambiente de banco de dados para o usuário do armazenamento de métricas antesde iniciar os processos do IBM Cognos. O IBM Cognos BI usa essas variáveis debanco de dados para se conectar ao banco de dados. Uma maneira de configuraressas variáveis de ambiente é incluir esses comandos no script .profile ou .logindo usuário que inicia os serviços do IBM Cognos.

Quando você configura os caminhos da biblioteca de carregamento, assegure-se deque as bibliotecas Oracle de 32 bits estejam no caminho da procura de bibliotecas,que geralmente é o diretório ORACLE_HOME/lib. Se você instalou o cliente Oracle 10gde 64 bits, as bibliotecas de 32 bits estarão no diretório ORACLE_HOME/lib32.

A tabela a seguir descreve variáveis de ambiente para bancos de dados Oracle. Asdescrições supõem que um cliente Oracle 11g esteja instalado.


Tabela 13. Variáveis de Ambientes Usam um Armazenamento de Métricas do Oracle 11g


ORACLE_HOME O diretório de nível superior que contém osoftware cliente do banco de dados ou todaa instalação do banco de dados.

Exemplo: /usr/oracle

É possível usar um script Oracle para criaras variáveis de ambiente. Para obter maisinformações, consulte a documentação doOracle.

Exemplo: /usr/local/bin/coraenv

TNS_ADMIN O diretório que contém o arquivotnsnames.ora, o qual permite chamadas parao banco de dados Oracle para determinar asconexões do servidor necessárias.

Exemplo: $ORACLE_HOME/network/admin

PATH A variável para localizar arquivosexecutados.

Exemplo: $PATH:$ORACLE_HOME/bin

libraryPATH O caminho da biblioteca de carregamento.

Exemplos:

Para sistema operacional Solaris ou Linux:

LD_LIBRARY_PATH=$ORACLE_HOME/lib:$LD_LIBRARY_PATH

Para AIX:

LIBPATH=$ORACLE_HOME/ lib:$LIBPATH

Para o HP-UX:

SHLIB_PATH=$ORACLE_HOME/ lib:$SHLIB_PATH

NLS_LANG O valor da variável determina ocomportamento dependente de código doidioma do IBM Cognos BI. Convenções demensagens de erro, de ordem declassificação, de data, de hora, monetária,numérica e de calendário adaptam-seautomaticamente ao idioma e código doidioma nativos.

Entre em contato com o administrador de banco de dados ou da rede para obter osvalores corretos para o sistema.

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.


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

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

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

Report Studio

Query Studio

Analysis Studio

Event Studio

Metric Studio

IBM Cognos Workspace

IBM Cognos WorkspaceAdvanced

Internet Explorer(configurações paraalguns studios)

Executar os controles eplug-ins ActiveX.

Controles de script ActiveXmarcados como seguros paracriação de scripts.

Report Studio

Query Studio

Analysis Studio

Internet Explorer(configurações para umúnico studio)

Comportamento binário e descripts

Permitir acesso programático àárea de transferência

Persistência de dados dousuário

Report Studio

Firefox Permitir cookies

Ativar Java

Ativar JavaScript

Carregar imagens


IBM Cognos Administration

Cognos Viewer

Report Studio

Query Studio

Analysis Studio


IBM Cognos WorkspaceAdvanced


Tabela 14. Configurações do Navegador Ativadas para oIBM Cognos BIPortal (continuação)

Navegador Configuração Componente do IBM Cognos

Safari 5 Ativar Java

Ativar JavaScript

Não Bloquear a Janela Pop-upWindows

Bloquear Cookies: Nunca


Cognos Viewer


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


Cognos Viewer


O Report Studio e o Query Studio usam o suporte a XML nativo do MicrosoftInternet Explorer, que é um componente do navegador. O suporte a ActiveX deveser ativado porque os aplicativos Microsoft implementam XML usando ActiveX. OIBM Cognos BI não fornece ou faz download de controles ActiveX. Somente oscontroles ActiveX instalados como parte do Internet Explorer são ativados nestaconfiguração.

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.

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


Cookies Usados pelos Componentes do IBM Cognos BI

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

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

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


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

Cookie Tipo Finalidade

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.

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 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 do Cognos Upgrade Central (http://www.ibm.com/software/analytics/cognos/customercenter/upgrade.html) fornece informações adicionais paraajudá-lo a fazer upgrade. 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:


http://www-01.ibm.com/software/analytics/cognos/customercenter/upgrade.html

– Revisar recursos, como a documentação e o website do Cognos UpgradeCentral (www.ibm.com/software/analytics/cognos/customercenter/upgrade.html)

– Verificar os ambientes suportados para assegurar a compatibilidade com outrosoftware acessando o IBM Software Product Compatibility Reports (SPCR)(www.ibm.com/support/docview.wss?uid=swg27037784). Você também podedesejar verificar essa página, se estiver pensando em atualizar seu sistemaoperacional.

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

Figura 8. Processo de Upgrade





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. No Centro de Informações do IBM Cognos (http://pic.dhe.ibm.com/

infocenter/cogic/v1r0m0/index.jsp), revise as versões mais recentes dadocumentação listada na tabela a seguir.

Tabela 16. Lista da Documentação de Upgrade

Documento Informações pelas quais procurar

IBM Cognos Business Intelligence: Notas sobre aLiberação

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 Report Studio Atualização de relatórios.

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 65




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ório, servidores debanco de dados e servidores de aplicativos, consulte a página do IBM SoftwareProduct Compatibility Reports (SPCR) (www.ibm.com/support/docview.wss?uid=swg27037784).

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, os alias doservidor da web e os bancos de dados de armazenamento de conteúdoexclusivos.

– 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 desejar considerar as diretrizes a seguir antes de atualizar para umaversão mais recente do sistema operacional nos computadores em que o IBMCognos BI está instalado:v Verifique o IBM Software Product Compatibility Reports (SPCR)

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

v Assegure que o software de terceiros usado pelo IBM Cognos BI seja suportadona versão do sistema operacional proposto. O software de terceiros incluiria





componentes, como banco de dados e drivers de banco de dados, servidores deaplicativos, servidores da web e navegadores.

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

arquivos web archive (.war) e os arquivos enterprise archive (.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.

Considerações para Executar Diversas Versões ou Instâncias doIBM Cognos BI no Mesmo 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.




Configurações de Portas e de URISe você estiver usando Tomcat, deve usar números de porta diferentes paraevitar conflitos de porta. Como o IBM Cognos BI reserva um intervalo deportas, assegure-se de usar um deslocamento de 100 para as portas. Altereas 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 localv Número da porta de encerramento

Os números de porta padrão para Tomcat iniciam em 9300. Se você estiverinstalando outra versão do produto, assegure-se de não usar os mesmosvalores para a segunda versão.

Se você estiver instalando o produto em um servidor de aplicativos quenão seja Tomcat, assegure-se de instalar a nova versão em um novo perfilou em uma instância diferente da sua versão existente.

Armazenamento de conteúdoUse um armazenamento de conteúdo ou esquema diferentes para cadainstalação. Quando o armazenamento de conteúdo é atualizado não épossível reverter o conteúdo. É possível usar uma cópia restaurada de seuarmazenamento de conteúdo existente como o armazenamento deconteúdo para a versão mais recente do IBM Cognos Business Intelligence.A versão mais recente do produto atualiza o armazenamento de conteúdoquando 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. Sevocê tiver dois gateways instalados no mesmo computador, 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.


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 quepodem ser reaplicadas após o 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 foram feitas muitas mudanças de customização nosarquivos system.xml, será possível usar esse recurso de upgrade automático, emvez de reaplicar as mudanças manualmente, após o upgrade. Ao substituir osarquivos system.xml por aqueles da versão anterior do produto, os arquivospodem ser atualizados pela nova versão do produto. O upgrade automático éaplicado ao iniciar 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:


v URIs de dispatchers do gateway

v URI do dispatcher externo

v URI do dispatcher interno


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 Tomcat como o servidor de aplicativos, clique emIBM Cognos e assegure-se de que o Número da Porta de Encerramento sejaexclusivo.Se você estiver usando outro servidor de aplicativos, como WebSphere, essevalor não será usado.

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

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

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

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

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 obterinformações adicionais, 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 pode


demorar 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,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 o upgrade.Execute o NC_DROP_Database_Type.sql apropriado antes de fazer upgrade. Paraobter mais informações, consulte “Executando Scripts de Limpeza do Banco deDados e de Índice” na página 523.

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 em


execução. É possível atualizar seus relatórios depois usando o IBM CognosAdministration. 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 no z/OS:

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

Procedimento

1. Acesse o diretório c10_location\configuration\schemas\content\db2zOS e abratablespaceUpgrade_db2zOS.sql em um editor de texto.

2. Siga as instruções no arquivo de script e substitua os valores do marcador noarquivo com os valores para o banco de dados.

3. Salve e execute o arquivo.

Cancelar Registro de Dispatchers da Versão Anterior do seu Armazenamento deConteúdo:

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

Procedimento

1. 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 no IBM DB2 noz/OS:

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


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.

Procedimento

1. Acesse o diretório c10_location\configuration\schemas\logging\db2zOS e abraLS_tablespaceUpgrade_db2zOS.sql em um editor de texto.

2. Siga as instruções no arquivo de script e substitua os valores do marcador noarquivo 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ção:

Use a tarefa a seguir para criar um arquivo de implementação.

Procedimento

1. Em IBM Cognos Administration, na guia Configuração, clique emAdministraçã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.


É possível procurar na hierarquia de Pastas Públicas e escolher os pacotes

e pastas desejados. Clique no ícone Incluir para mover os itensselecionados na 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 desejar fazer mudanças no pacote ou na pasta no ambiente de

destino, clique no ícone Editar , faça as mudanças e clique em OK.v Para restringir o acesso ao pacote ou pasta e às entradas

correspondentes, 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ão:

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


Incluindo Objetos de Configuração ao Importar um Arquivo de Implementaçãodo Armazenamento de Conteúdo Inteiro:

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

Procedimento

1. Em IBM Cognos Administration, na guia Configuração, clique em Dispatcherse 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ção:

Para 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ções para ajudá-lo a decidir como resolver conflitos. Ao implantarnovamente, o assistente também mostrará se os pacotes e pastas estavam naimplantaçã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.

Procedimento

1. Para a sua nova versão do produto, no IBM Cognos Administration, na guiaConfiguraçã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.


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 atualizarespecificações de relatório, consulte o IBM Cognos Software Development KitDeveloper Guide.

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. Na guia Configuração, clique em Administração de Conteúdo.

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

5. Digite um nome para a tarefa de atualização e, se desejar, uma dica de tela e adescrição. Clique em Avançar.

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

7. 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 5. Instalação e Configuração dos Componentes doProduto em um Computador

É possível instalar todos os componentes do IBM Cognos Business Intelligence emum computador. Isto é útil quando se está configurando um ambiente de teste oude avaliação ou para ambientes de pequena produção. Para usar o IBM Cognos BI,você deve instalar todos os componentes que estão selecionados por padrão noassistente de instalação.

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

Você também pode distribuir a instalação em computadores diferentes. Para obtermais informações, consulte Capítulo 6, “Instalação e Configuração dosComponentes do Servidor em Diferentes Computadores”, na página 127.

Para obter instruções de desinstalação, consulte Capítulo 18, “Desinstalando o IBMCognos BI”, na página 439.

Instalação de componentes do servidor no modo interativoPara uma instalação completa, instale os componentes no servidor e, em seguida,configure-os para trabalharem no ambiente.

Normalmente, você executa os programas de instalação e configuração do IBMCognos no modo interativo. Isso significa que em uma interface com o usuáriográfica (GUI), o instalador solicita o fornecimento de informações e a ferramentade configuração possibilita a mudança das configurações padrão.

É possível escolher instalar componentes do servidor no modo silencioso.

Modo silencioso

É possível automatizar a instalação de componentes utilizando arquivos deresposta e executando o programa de instalação no modo silencioso.

É possível automatizar a configuração de componentes com a exportação dasconfigurações de um computador para outro, desde que os componentes instaladossejam os mesmos. Execute o IBM Cognos Configuration no modo interativo pelaprimeira vez.

A outra opção é editar o arquivo cogstartup.xml, usando as configurações que seaplicam ao ambiente e, em seguida, executar a ferramenta de configuração nomodo silencioso.


Modo interativo

A menos que pretenda concluir uma instalação no modo silencioso, instale a partirde uma estação de trabalho com sistema X Window, um terminal X, ou um PC ououtro sistema com um software de servidor X instalado.

Para executar a instalação no modo interativo, o console anexado ao computadordeve suportar interfaces gráficas de usuário baseadas em Java.

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.

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.

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

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.

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 todos


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

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.

Capítulo 5. Instalação e Configuração dos Componentes do Produto em um Computador 81

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 IBM Software Product Compatibility Reports (SPCR)(www.ibm.com/support/docview.wss?uid=swg27037784). 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.

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 17, “Usando instalação e configuração não assistidas”, napágina 431).Se você estiver instalando nos sistemas operacionais Linux e recebermensagens de erro sobre bibliotecas openmotif ausentes, poderá usar umainstalação não assistida com o comando issetupnx.

8. Siga as instruções do assistente de instalação e copie os arquivos necessáriospara seu computador.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/bin64 à variável de ambiente de caminho da

biblioteca apropriado.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 Supplementary


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

Você também deve atualizar sua estrutura de segurança Java (consulte “RequisitosJava” na página 45) 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 502Você executa issetup para instalar o IBM Cognos BI, mas recebe a mensagem deerro a seguir:

Instalando Componentes do Servidor em SistemasOperacionais 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.

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



log 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 você iniciar o IBM Cognos Configuration a partir do assistente deinstalaçã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 SupplementaryLanguage 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 227.

Instalando o IBM Cognos Metrics ManagerSe estiver instalando o IBM Cognos Metrics Manager com IBM Cognos BusinessIntelligence e quiser compartilhar recursos, você deverá instalar cada componentedo IBM Cognos Metrics Manager no mesmo local de cada componente do IBMCognos Business Intelligence.

Você também pode querer instalar o Metrics Designer (consulte “Instalação econfiguração do Metric Designer” na página 204).

Instalando os Fix PacksO IBM fornece pacotes de manutenção temporários que contêm atualizações paraum ou mais componentes para o seu produto IBM Cognos. Se um fix pack estiverdisponível ao instalar ou atualizar seu produto, é necessário instalá-lo após instalaros componentes do IBM Cognos.

Se um fix pack ficar disponível depois da implementação do produto IBM Cognos,será necessário parar o serviço, instalar o fix pack no mesmo local que oscomponentes do IBM Cognos e, então, iniciar o serviço.

Os fix packs são acumulativos. Ao instalar o fix pack mais recente, ele incluiatualizações de todos os fix packs anteriores. Os fix packs estão disponíveis paradownload no Suporte IBM (http://www.ibm.com/support/entry/portal/overview).

Nota: Os fix packs não são instalações independentes. É necessário instalá-los noscomputadores que possuem componentes do IBM Cognos instalados. Instale os fixpacks que são apropriados para sua versão do produto. 11To check your version,open the component list file at c10_location\cmplst.txt and check the line thatstarts with C8BISRVR_version=.

Instalando os Fix Packs IBM Cognos nos SistemasOperacionais UNIX ou Linux

Fix packs são atualizações de produto que contêm correções de códigosacumulativas realizadas desde a última liberação do produto. Os fix packs do IBMCognos são instalados no mesmo local que o produto existente.


http://www.ibm.com/support/entry/portal/overview

Antes de Iniciar

Certifique-se de executar as seguintes tarefas antes de instalar um Fix Pack.v Se o serviço do IBM Cognos estiver em execução, interrompa-o.v Faça o backup da estrutura de diretório.v Faça o backup do banco de dados de armazenamento de conteúdov Faça o backup de todos os arquivos editados manualmente.

Procedimento1. Acesse o local onde os arquivos de instalação foram transferidos por download

ou insira o disco se você tiver um.2. Para iniciar o assistente de instalação, digite o seguinte comando

./issetup

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. Retorne o produto IBM Cognos implementado ao serviço.v Se estiver usando o Tomcat, abra a Configuração do IBM Cognos, salve a

configuração e em seguida inicie o serviço IBM Cognos.v Se estiver executando o produto IBM Cognos em um servidor de aplicativos

diferente do Tomcat, reimplemente o produto IBM Cognos ao servidor deaplicativos.

6. Se você tiver um ambiente distribuído, repita estas etapas para todos osservidores IBM Cognos restantes.

Instalando Fix Packs nos Sistemas Operacionais WindowsFix packs são atualizações de produto que contêm correções de códigosacumulativas realizadas desde a última liberação do produto. Os fix packs doIBMCognos são instalados no mesmo local que o produto existente.

Antes de Iniciar


Procedimento1. Insira o disco do fix pack para o sistema operacional Windows ou acesse o

local para onde transferiu por download e extraiu os arquivos e dê um cliqueduplo no arquivo issetup.exe.


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





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 Banco de dados de conteúdo doCognos ou do Microsoft SQL Server como o armazenamento de conteúdo, vocêpode ter que instalar o software do cliente de banco de dados e/ou os drivers JavaDatabase Connectivity (JDBC) em cada computador em que instalar o ContentManager. Fazer isso permite que o Content Manager acesse o banco de dados dearmazenamento de conteúdo.

Configurar a Conectividade do Banco de Dados para umArmazenamento de Conteúdo IBM DB2

Esse procedimento descreve como configurar a conectividade do banco de dadospara um armazenamento de conteúdo DB2. Você deve executar este procedimentoem 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.

Procedimento

Copie os arquivos a seguir do diretório DB2_installation\sqllib\java para odiretó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 é denominado um arquivo DDL.

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

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.

Para obter mais informações, consulte o Centro de Informações do IBM DB2.

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


Tabela 17. Nomes de Parâmetro e Descrição para o Script de Espaço de Tabela deArmazenamento de Conteúdo (continuação)


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.


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 18. Nomes e Descrições de Parâmetros de Espaços de Tabela para o Banco deDados de Notificação DB2 no z/OS


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.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 original HTS_TABLESPACES.sql e use a seguinte

tabela para ajudá-lo a substituir os parâmetros genéricos pelos apropriadosao seu ambiente.

Tabela 19. Nomes e Descrições de Parâmetros de Espaços de Tabela para TarefasManuais no DB2 for z/OS


NCCOG Especifica o nome do banco de dados.


BP32K Especifica o nome do buffer pool de 32 k.

Consulte o script para obter 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 seguinte tabela

para ajudá-lo a substituir os parâmetros genéricos pelos apropriados ao seuambiente.



NCCOG O nome do banco de dados.

Consulte o script para obter 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 esalve o arquivo em outro local.

b. Abra o arquivo de script original ANN_TABLESPACES.sql e use a seguintetabela para ajudá-lo a substituir os parâmetros genéricos pelos apropriadosao seu ambiente.

Tabela 21. Nomes e Descrições de Parâmetros de Espaços de Tabela para Anotações noDB2 for z/OS



DSN8G810 O nome do grupo de armazenamento.

BP32K O nome do buffer pool de 32 k.

Consulte o script para obter 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 seguinte tabela






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.


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.

Configurar a Conectividade de Banco de Dados para Bancos de Dadosde Relatório

Para suportar a comunicação entre o IBM Cognos Business Intelligence e as origensde dados, você deve instalar o software adicional para suas origens de dados nomesmo computador que hospeda o servidor de relatório. Dependendo da origemde dados e do modo de consulta, o software necessário pode incluir clientes debanco de dados e/ou arquivos do driver Java Database Connectivity (JDBC).

Para o IBM Cognos Business Intelligence, o banco de dados de consulta (tambémconhecido como o banco de dados de relatório) somente é acessado pelomecanismo de relatório que executa relatórios. O mecanismo de relatório éinstalado com os Componentes da Camada de Aplicativos e também é usado peloFramework Manager, Metric Designer e IBM Cognos Transformer.

Modo de consulta compatível

Para executar relatórios que usam modo de consulta compatível, você deve usarbibliotecas de clientes de origem de dados de 32 bits e configurar o servidor derelatório para 32 bits. O modo de consulta compatível usa cliente nativo e conexõesODBC para se comunicar com origens de dados.

Se a origem de dados for de 64 bits, certifique-se de usar as bibliotecas de clientesde 32 bits para se conectar à origem de dados para usar o modo de consulta decompatibilidade.

Modo de consulta dinâmica

O modo de consulta dinâmica fornece comunicação a origens de dados usandoconexões Java/XMLA.


Para bancos de dados relacionais compatíveis, exige-se uma conexão JDBC tipo 4.O driver JDBC tipo 4 converte as chamadas JDBC diretamente para o protocolo debanco de dados específico do fornecedor. Ele está escrito em Java puro e éindependente de plataforma.

Para origens de dados OLAP compatíveis, a conectividade Java/XMLA otimiza oacesso ao oferecer MDX customizado e aprimorado para a origem e a versãoespecíficas da tecnologia OLAP e se conecta aos smarts da origem de dados OLAP.

É possível usar o modo de consulta dinâmica com as seguintes origens de dadosOLAP:v IBM Cognos TM1v SAP Business Information Warehouse (SAP BW)v Oracle Essbasev Microsoft Analysis Services

É possível usar o modo de consulta dinâmica para OLAP sobre modelosrelacionais ( relacionais modelados de forma dimensional) com as seguintes fontesde dados relacionais:v IBM DB2v IBM DB2 for z/OSv Oraclev Microsoft SQL Serverv Teradatav Netezza

Para obter mais informações sobre o modo de consulta dinâmica, incluindoinstalação dos drivers, consulte o IBM Cognos Business Intelligence Dynamic QueryGuide.

Para revisar uma lista de ambientes suportados pelo IBM Cognos BusinessIntelligence, incluindo as versões da origem de dados suportadas pelo modo deconsulta dinâmica, consulte a página IBM Software Compatibility Reports (SPCR)(www.ibm.com/support/docview.wss?uid=swg27037784).

Acessar Origens de Dados OLAP em Sistemas OperacionaisWindows

Para acessar os bancos de dados relacionais e as origens de dados OLAP pararelatórios, você deve instalar o software de API do cliente disponibilizado pelofornecedor da origem de dados. O software deve ser instalado no mesmocomputador no qual os Componentes da Camada de Aplicativos estão instalados.

Procedimento1. Instale o software de API do banco de dados para os bancos de dados

relacionais e as origens de dados OLAP no computador host do servidor derelatórios (no qual Componentes da Camada de Aplicativos estão instalados).Nos sistemas operacionais MicrosoftWindows, o mecanismo de relatóriosuporta a conectividade do banco de dados nativo ou ODBC.

2. Se o Framework Manager estiver instalado em um local separado dosComponentes da Camada de Aplicativos, também é necessário instalar osoftware da API cliente no computador no qual o Framework Manager está



instalado. Para obter mais informações, consulte “Configurar Variáveis paraConexões de Origem de Dados para o Framework Manager” na página 199.

Acessar Origens de Dados ODBC em Sistemas OperacionaisUNIX ou Linux

Para usar uma origem de dados ODBC no UNIX ou Linux para conectar-se a umaorigem de dados suportada, é necessário configurar o ambiente para localizar oarquivo .odbc.ini que contém as referências para a origem de dados, asbibliotecas de conectividade e suas bibliotecas do Gerenciador de Driversacompanhantes.

Para revisar as origens de dados ODBC suportadas, IBM Software ProductCompatibility Reports (SPCR) (www.ibm.com/support/docview.wss?uid=swg27037784).

Após configurar as conexões do ODBC, você deve criar conexões com as origensde dados no IBM Cognos Administration. Para obter informações, consulte o Guiade Administração e Segurança do IBM Cognos.

Se seu fornecedor de banco de dados não fornecer um gerenciador de drivers, épossível usar o unixODBC ou iODBC, dependendo do seu sistema operacional.

Nos sistemas operacionais Linux, o pacote unixODBC fornecido com o sistemaoperacional fornece o ODBC Driver Manager. É necessário instalar o unixODBCversão 2.2.11 ou posterior antes de poder configurar as conexões de origem dedados. Para verificar a versão instalada, use o comando a seguir: odbcinst--version. Verifique qual versão do unixODBC é necessária para o banco de dadosque está sendo usado e assegure-se de usar essa versão.

Nos sistemas operacionais UNIX, o gerenciador de drivers iODBC de softwarelivre é fornecido como parte da instalação do IBM Cognos.

Procedimento1. Crie uma variável de ambiente para especificar o local do arquivo .odbc.ini.

Por exemplo,export ODBCINI=/usr/local/etc/.odbc.ini

2. Configure a variável de ambiente do caminho da biblioteca apropriada paraespecificar o local das bibliotecas de conectividade e o Driver Manager para oseu banco de dados.A tabela a seguir lista as variáveis de ambiente para cada sistema operacionalque deve especificar o local das bibliotecas do gerenciador de drivers.

Tabela 23. Variáveis de Ambiente para seu Sistema Operacional

Sistema operacional Variável do ambiente

AIX LIBPATH

Solaris e Linux LD_LIBRARY_PATH

HP-UX SHLIB_PATH

3. Se seu fornecedor de banco de dados não fornecer um gerenciador de drivers,configure o caminho da biblioteca para incluir o caminho do gerenciador dedrivers local.




v No UNIX, iODBC é fornecido como parte da instalação do IBM Cognos. Osarquivos de biblioteca estão localizados no diretório c10_location/bin. Ocaminho da biblioteca já deveria conter o diretório c10_location/bin.Por exemplo,LIBPATH=/usr/IBM/cognos/bin:$LIBPATH

v No Linux, o pacote unixODBC fornece as bibliotecas do gerenciador dedrivers necessárias.Por exemplo,LD_LIBRARY_PATH=/usr/lib:$LD_LIBRARY_PATH

O que Fazer Depois

Se você estiver usando diversas origens ODBC nos sistemas operacionais UNIX ouLinux, é possível encontrar dependências dos arquivos de biblioteca com nomescomuns, mas implementações diferentes para a conectividade e o gerenciador dedrivers. Em um cenário no qual uma origem ODBC é validada enquanto outrafalha com base em uma dependência, entre em contato com o Suporte ao Cliente.Usar um .odbc.ini comum pode resultar em ter entradas incompatíveis paradiferentes gerenciadores de drivers. Para resolver o problema, revise os requisitosde estrutura entre os gerenciadores de drivers que você está usando e tente usar asintaxe que é comum entre os gerenciadores de drivers conflitantes.

Configure o IBM Cognos Business Intelligence para Usar oOracle Essbase

Se usar o IBM Cognos Business Intelligence com uma origem de dados Essbaseversão 11.1.1, você deve editar um arquivo de configuração para informar aoservidor IBM Cognos BI da sua versão.

Por padrão, o IBM Cognos BI é configurado para usar o Oracle Essbase versão11.1.2. Portanto, nenhuma configuração é necessária se você usar esta versão. Sevocê usar outra versão suportada do Oracle Essbase, deverá editar o arquivoqfs.config.xml para sua versão.

Além disso, se você usar o Oracle Essbase versão 11.1.2, deverá instalar o OracleFoundation Services, bem como o cliente Oracle Essbase.

Procedimento1. Acesse o diretório c10_location/configuration.2. Abra o arquivo qfs_config.xml em um xml ou editor de texto.3. Localize as seguintes linhas:

<provider name="DB2OlapODP" libraryName="essodp1112" connectionCode="DO">

4. Para Oracle Essbase 11.1.1, altere-as da seguinte maneira:<provider name="DB2OlapODP" libraryName="essodp111" connectionCode="DO">

5. Para Oracle Essbase 11.1.2, assegure-se de que as linhas aparecem da seguintemaneira:<provider name="DB2OlapODP" libraryName="essodp1112" connectionCode="DO">

6. Salve o arquivo e reinicie o serviço do IBM Cognos


Usando o Oracle Essbase em um Sistema Operacional UNIXou Microsoft Windows de 64 bits

Se você usar uma origem de dados do Oracle Essbase versão 11.1.2 com o IBMCognos Business Intelligence em um sistema operacional UNIX ou MicrosoftWindows de 64 bits, você deverá configurar manualmente as variáveis de ambienteARBORPATH e ESSBASEPATH.

As variáveis de ambiente ARBORPATH e ESSBASEPATH são criadas durante a instalaçãodo cliente do Oracle Essbase. O IBM Cognos BI usa essas variáveis para encontrara localização do cliente Oracle Essbase.

Para usar o Oracle Essbase com o IBM Cognos BI em um sistema operacionalUNIX ou Microsoft Windows de 64 bits, você deve instalar o cliente do OracleEssbase de 64 bits. Este cliente de 64 bits inclui um cliente de 32 bits utilizado peloIBM Cognos BI. Para apontar para esse cliente de 32 bits, você deve alterarmanualmente as variáveis de ambiente ARBORPATH e ESSBASEPATH para substituir oEssbaseClient pelo EssbaseClient-32. O seguinte exemplo supõe que o cliente éinstalado na unidade C. Seu local de instalação pode ser diferente.ARBORPATH=C:\Hyperion\EPMSystem11R1\products\Essbase\EssbaseClient-32

ESSBASEPATH=C:\Hyperion\EPMSystem11R1\products\Essbase\EssbaseClient-32

Se você usar um sistema operacional Microsoft Windows de 32 bits com um clientedo Oracle Essbase de 32 bits, nenhuma mudança será necessária para essasvariáveis de ambiente.

Início do IBM Cognos ConfigurationUse o IBM Cognos Configuration para configurar os componentes do IBM CognosBusiness Intelligence e iniciar e parar os serviços do IBM Cognos, se estiver usandoo contêiner do servlet Tomcat padrão.

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 você estiver usando um computador com Windows Vista, Windows 7 ouWindows 2008 e instalou o produto no diretório Program Files (x86), inicie oIBM 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, assegure-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,assegure-se de que está usando uma versão de 64 bits do Java.

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.

Ativar a Versão de 64 Bits do Servidor de RelatórioEm uma instalação de 64 bits, o componente do servidor de relatório é fornecidonas versões de 32 bits e de 64 bits. A opção padrão é 32 bits. Para usar a versão de64 bits, é necessário ativá-la usando o IBM Cognos Configuration.

A versão de 64 bits de servidor de relatório pode ser utilizada apenas com pacotespara os quais o modo de consulta dinâmica está ativado.


Você deve utilizar a versão de 32 bits do servidor de relatório para pacotes que nãoutilizam o modo de consulta dinâmica. Por exemplo, se o seu pacote se basear noIBM Cognos PowerCubes, você deve usar a versão de 32 bits do servidor derelatório.

Se você tiver várias instâncias de Componentes da Camada de Aplicativos em seuambiente, você pode configurar uma instância para utilizar o servidor de relatóriode 32 bits. Em seguida, você pode utilizar regras de roteamento para que pedidosde relatório para pacotes de modo de consulta não dinâmica sejam roteados para ainstância que está executando a versão de 32 bits de servidor de relatório. Paraobter mais informações sobre regras de roteamento, consulte o Guia deAdministração e Segurança.

Para ativar a versão de 64 bits, você deve instalar a versão de 64 bits dosComponentes da camada de Aplicativos em um computador de 64 bits. Se vocêinstalar a versão de 32 bits dos Componentes da Camada de Aplicativos ou estiverusando um computador de 32 bits, não ative o servidor de relatório de 64 bits.

Procedimento1. Na janela Explorer do IBM Cognos Configuration, clique em Ambiente.2. Clique na caixa Valor para Modo de Execução do Servidor de Relatório e

selecione 64 Bits.3. No menu Arquivo, clique em Salvar.4. Reinicie os serviços do IBM Cognos se eles estiverem em execução.

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.



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.

Em um ambiente de produção, use um banco de dados de nível empresarial paraarmazenamento do conteúdo. Se estiver usando o Banco de Dados de Conteúdo doCognos em um sistema de teste ou de prova de conceito, será possível usar osrecursos no portal de administração para fazer backup e arquivar os dados antesque sejam movidos para um banco de dados de nível corporativo no ambiente deprodução. Para obter mais informações, consulte o tópico sobre como implantartodo o armazenamento de conteúdo no Guia de administração e segurança.

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.

Configurando Propriedades de Conexão do Banco de Dadospara 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 de 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.8. Para testar a conexão entre o Content Manager e o banco de dados de

armazenamento de conteúdo, no menu Ações, clique em Testar.O Content Manager se conecta ao banco de dados, verifica as permissões dobanco de dados e cria e preenche uma tabela. A tabela não é excluída e seráusada todas as vezes que o teste for repetido.

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. No computador no qual foi instalado o Content Manager, 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.

Se você instalou mais de uma versão do IBM Cognos BI, deverá usar umarmazenamento de conteúdo diferente para cada versão. Quando umarmazenamento de conteúdo é usado por uma nova versão do IBM CognosBI, ele não pode ser usado por uma versão anterior.

Dica: Se desejar usar um par de valores da palavra-chave do Oracle Net8para gerenciar a conexão do banco de dados, selecione Banco de DadosOracle (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 comnúmero da 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 nomeda instâ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 diversasinstâncias do 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íveldigitar localhost\instance1. Se não forem especificadas propriedades denome de instância, é criada uma conexão com a instância padrão.As propriedades especificadas para a instância denominada, junto com a IDe senha de usuário e nome do banco de dados, são usados para criar umJDBC URL. 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 onome de uma instância não for especificado, será criada uma conexão coma instâ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 valoresapropriados para as propriedades Servidor de banco de dados e númeroda porta e Nome 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 de 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.



As credenciais de logon são imediatamente criptografadas.10. Para testar a conexão entre o Content Manager e o banco de dados de


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. Na janela Explorer, em Acesso a dados, clique em Notificação.2. Na janela Propriedades, para a propriedade Servidor de correio SMTP, digite

o nome do host e da porta de seu servidor de correio SMTP (saída).

Dica: Para conseguir abrir relatórios que são enviados por e-mail, altere a partedo nome do host do URI do gateway de localhost para o endereço IP docomputador ou para o nome do computador. Do contrário, o URL no e-mail iráconter localhost e os usuários remotos não poderão abrir o relatório.

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.

3. Clique na caixa de seleção Valor próxima à propriedade Conta e senha e cliqueno botão de edição quando aparecer.

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

5. Na janela Propriedades, digite o valor apropriado para a conta do remetentepadrão.

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

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

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.

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.

Ative o Gateway da Web de 32 bits em uma Instalação de 64bits

Se você instalou a versão de 64 bits do IBM Cognos BI, mas estiver usando umservidor da web de 32 bits, você deve mover manualmente os arquivos de gatewayde 32 bits em seu diretório de instalação.

Se você instalou a versão de 32 bits do IBM Cognos BI, a versão de 32 bits dogateway é instalada por padrão.

Procedimento1. Acesse c10_location/cgi-bin.2. Digite o seguinte comando:

v Nos sistemas operacionais UNIX ou Linux, digite ./copyGateMod.sh 32bit

v Em sistemas operacionais Windows, digite copyGateMod.bat 32bit

Resultados

Os arquivos de gateway de 32 bits são copiados do diretório cgi-bin/lib para odiretório cgi-bin.

Nota: Se você precisar restaurar os arquivos de gateway de 64 bits padrão, siga oprocedimento e digite ./copyGateMod.sh 64bit ou copyGateMod.bat 64bit. Osarquivos de gateway de 64 bits são copiados do diretório cgi-bin/lib64 para odiretório cgi-bin.

Use 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 Gateway de Servlet Java se você usar um servidor de aplicativo

diferente do Apache Tomcat padrão

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

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 Gerenciadorde 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. Expanda Sites e em seu website, inclua os diretórios virtuais conformemostrado na tabela:

Tabela 25. Diretórios Virtuais Necessários

Alias Local

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. Em 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 AplicativosSe você implementar o IBM Cognos em um servidor de aplicativos diferente doTomcat, poderá usar o gateway de servlet para entregar as páginas de portal emvez de usar um servidor da web.


Antes de Iniciar

Assegure-se de que as seguintes tarefas sejam 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 do IBM Cognos BI são instalados no mesmo

sistema que o servidor de aplicativos.v Os Componentes da Camada de Aplicativos do IBM Cognos BI e o Content

Manager estão instalados e em execução no ambiente.v A conta do usuário do servidor de aplicativos possui permissão de acesso total

para a instalação do IBM Cognos.

Sobre Esta Tarefa

Em vez de roteamento de solicitações diretamente para o dispatcher, vocêimplementa o gateway de servlet em uma instância JVM diferente das instânciasJVM que executam os Componentes da Camada de Aplicativos do IBM Cognos BIe os servlets do Content Manager. Fazer esse tipo de implementação separa ocarregamento para entregar conteúdo estático a partir 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 componentes do IBM Cognos usando o gateway deservlet inserindo 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 Gateways 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:



</Directory>



</Directory>



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 o Gateway do CGI no Microsoft Internet InformationServices (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 serviços da web de 32 e 64 bits.

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.







são ativados.c. Se CGI estiver configurado como Não Instalado, selecione CGI e clique

em Incluir Serviço de Função.4. Se você estiver usando o Microsoft Windows 2012 Server, use as etapas a




d. Expanda Desenvolvimento de Aplicativo.e. Selecione CGI se ainda não estiver selecionado e clique em Avançar.f. Clique em Instalar.


são 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 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).





7. Dê um clique duplo em Restrições de 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, tal 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:


Alias Local




13. Selecione o diretório virtual cgi-bin que você criou.14. Clique duas vezes em Mapeamentos do Manipulador.15. Em Ações, clique em Incluir Mapeamento de Módulo.

a. Em Caminho de Solicitação, digitecognos.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 do CGI inserindo http://servername/ibmcognos em 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:


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

Configurando WebDAV em IBM HTTP Server ou Servidor ApacheNo IBM HTTP Server ou servidor Apache, você deve incluir diretivas para seuarquivo de configuração do servidor, e em seguida, configurar o acesso dediretório.

Procedimento1. No diretório webserver_location/conf, abra o arquivo httpd.conf em um

editor de texto.2. Remova o comentário das diretivas que carregam modules/mod_dav.so e

modules/mod_dav_fs.so.LoadModule dav_module modules/mod_dav.soLoadModule dav_fs_module modules/mod_dav_fs.so

3. Forneça um local para a diretiva DAVLockDB.Por exemplo,DAVLockDB "webserver_location/var/DavLock"

Certifique-se de que o diretório exista.4. Crie um alias para o diretório no qual as imagens são armazenadas.5. Inclua Dav On nas informações <Directory> para o alias.

Por exemplo,Alias /images "path/shared_images"

<Directory "path/shared_images">Dav OnOptions Indexes MultiViewsAllowOverride NoneOrder allow,denyAllow from all

</Directory>

6. Salve o arquivo.7. Reinicie o servidor da web.

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




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.






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 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 do mouse no diretório ou diretório virtual no qualincluiu regras 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


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://nome_host:porta/p2pd/servlet

O valor padrão para nome_host:porta é localhost:9300.3. Teste a disponibilidade do dispatcher digitando o valor URI do dispatcher

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


Configurar Variáveis para Conexões de Origem de DadosUse este procedimento para configurar variáveis para conexões de origem dedados para Framework Manager ou IBM Cognos Transformer ou configure oambiente de origem de importação para Metric Designer.

Como os metadados são derivados de origens de dados em ambientesmultiplataformas ou multilíngue, há várias coisas que você deve considerar oufazer ao configurar o ambiente de origem de dados para o Framework Manager ouIBM Cognos BI Transformer ou configurar o ambiente de origem de importaçãopara o Metrics Designer. Geralmente, isso depende da outra tecnologia utilizadapara suas origens de dados ou de importação.

As ferramentas de modelagem do IBM Cognos Business Intelligence criam egerenciam metadados para o IBM Cognos BI. O Framework Manager cria egerencia metadados para as funções de relatório, o IBM Cognos BI Transformercria e gerencia metadados para PowerCubes e o Metrics Designer cria e gerenciametadados requeridos para funções de scorecard.

Se foi feita uma atualização, não é necessário configurar nada no ambiente daorigem de dados. É necessário configurar o ambiente de origem de dados somentese sua ferramenta de modelagem foi instalada em um local diferente da versãoanterior.

Usuários operando em diferentes idiomas podem se conectar a uma origem dedados do MSAS 2005 a partir da mesma instância do IBM Cognos BI. Osmodeladores devem criar um pacote separado para cada idioma. Os usuáriospodem executar relatórios em qualquer idioma.

Se uma origem de dados Sybase for utilizada, essas etapas não são necessárias.

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. Configure a variável de ambiente para suporte multilíngue:

v No Oracle, configure a variável de ambiente NLS_LANG (Suporte ao IdiomaNacional) em cada computador em que o Framework Manager ou o MetricDesigner e o servidor IBM Cognos BI estejam instalados, digitando oseguinte comando:NLS_LANG = language_territory.character_set

Os exemplos são:NLS_LANG = AMERICAN_AMERICA.UTF8

NLS_LANG = JAPANESE_JAPAN.UTF8

O valor da variável determina o comportamento dependente de código doidioma do IBM Cognos BI. Convenções de mensagens de erro, de ordem declassificação, de data, de hora, monetária, numérica e de calendárioadaptam-se automaticamente ao idioma e código do idioma nativos.

v No DB2, configure a variável de ambiente DB2CODEPAGE como um valor de1252.


Para obter mais informações sobre o uso dessa variável de ambienteopcional, consulte a documentação do DB2.

Nenhuma configuração é necessária para o SAP BW. O SAP suporta apenasuma página de códigos única em sistemas SAP BW que não sejam Unicode.

2. No Oracle, inclua $ORACLE_HOME/lib para sua variável LD_LIBRARY_PATH.Quando você configurar os caminhos de biblioteca de carregamento,assegure-se de que as bibliotecas Oracle de 32 bits estejam no caminho deprocura da biblioteca, que geralmente é o diretório $ORACLE_HOME/lib ou odiretório $ORACLE_HOME/lib32 se você instalou um cliente Oracle de 64 bits.

3. No Oracle, copie o arquivo de biblioteca correto para sua versão do clienteOracle do ORACLE_HOME/jdbc/lib para o diretório c10_location\webapps\p2pd\WEB-INF\lib.Se estiver usando o Oracle 10g, você deve ter ojdbc14.jar.Se estiver usando o Oracle 11g, você deve ter ojdbc5.jar.

4. Para SAP BW, configure os seguintes objetos de autorização para que aferramenta de modelagem possa recuperar metadados.Onde os valores padrão são especificados, talvez seja necessário modificar osvalores no sistema SAP.v S_RFC

Configure o campo Atividade como 16.Configure o campo Nome de RFC para que fique protegido como SYST,RSOB, SUGU, RFC1, RS_UNIFICATION, RSAB, SDTX, SU_USER.Configure o objeto Tipo de RFC para ser um campo protegido como FUGR.

v S_TABU_DIS

Configure o campo Atividade como 03.Configure o campo Grupo de Autorização como &NC&.

Nota: &NC& representa qualquer tabela que não tenha um grupo deautorização. Por motivos de segurança, crie um grupo de autorização edesigne a tabela RSHIEDIR a ele. O novo grupo de autorização restringe oacesso ao usuário apenas para a tabela, que é necessária para a ferramenta demodelagem. Crie o grupo de autorização como uma customização no sistemaSAP.

v S_USER_GRP

Configure o campo Atividade como 03, 05.Defina o campo User group in user master main com o valor padrão.

v S_RS_COMP

Defina o campo Activity com o valor padrão.Configure o campo Área de Informações como Nome Técnico da InfoArea.Configure o campo Cubo de Informações com o valor: Nome Técnico do Cubode Informações.Defina o campo Name (ID) of reporting components com o valor padrão.Defina o campo Type of reporting components com o valor padrão.

v S_RS_COMP1

Defina o campo Activity com o valor padrão.Defina o campo Name (ID) of reporting components com o valor padrão.Defina o campo Type of reporting components com o valor padrão.Defina o campo Owner (Person Responsible) com o valor padrão.


v S_RS_HIER

Configure o campo Atividade como 71.Configure o campo Nome da Hierarquia como Nome da Hierarquia.Configure o campo InfoObject como Nome Técnico do InfoObject.Configure o campo Versão como Versão da Hierarquia.

v S_RS_ICUBE

Configure o campo Atividade como 03.Configure o campo Subobjeto InfoCube com os valores DATA e DEFINITION.Configure o campo Área de Informações como Nome Técnico da InfoArea.Configure o campo InfoCube como Nome Técnico do InfoCube.

Para obter informações adicionais sobre objetos de autorização SAP BW,consulte o Transaction SU03.

Resultados

Após concluir essas tarefas, você deve configurar os componentes do IBM CognosBI (consulte Capítulo 9, “Opções de Configuração”, na página 235) paratrabalharem em seu ambiente.

Criando um Banco de Dados de Armazenamento de MétricasVocê deve criar um banco de dados de armazenamento de métricas usando oOracle, o Microsoft SQL Server ou o DB2.

O armazenamento de métricas é um banco de dados que contém o conteúdo parapacotes de métricas. O armazenamento de métricas também contém asconfigurações do aplicativo de scorecard, tais como preferências do usuário.Embora se execute o comando para criar o armazenamento de métricas a partir dolocal onde o Application Tier Components está instalado, será possível especificarum local diferente para o armazenamento de métricas nos parâmetros docomando. Se o armazenamento de métricas estiver em um computador diferentedo Application Tier Components, crie um alias para o armazenamento de métricasno local do Application Tier Components.

Não é possível usar o Banco de Dados de Conteúdo do Cognos como um banco dedados de armazenamento de métricas.

Seu administrador de banco de dados deve fazer backup dos bancos de dados doIBM Cognos Business Intelligence regularmente porque eles contêm os dados doIBM Cognos. Para garantir a segurança e integridade dos bancos de dados,também é importante protegê-los de acesso não autorizado ou inadequado.

Criar um Banco de Dados de Armazenamento de Métricas noIBM DB2

Use este procedimento para criar um armazenamento de métricas usando umbanco de dados IBM DB2.

Procedimento1. No local Componentes da Camada de Aplicativos, no diretório

c10_location/configuration/schemas/cmm/db2, execute o scriptcmm_create_db.cmd digitando o comando a seguir:Em um sistema operacional Microsoft Windows, digite


cmm_create_db dbinstance user_name password dbname drive dbalias

Em um sistema operacional UNIX, digitecmm_create_db.sh dbinstance user_name password dbname path dbalias

Use os valores da tabela a seguir em seu comando.

Tabela 28. Valores para cmm_create_db script

Valor Configuração

dbinstance O nome da instância DB2 na qual o banco de dados será criado.

nome_usuário A ID do usuário com permissões para criar o banco de dados. AID do usuário deve ter privilégios SYSADM ou SYSCTRL, e deveter privilégios DBADM para criar o esquema.

senha A senha para o valor user_name.

dbname O nome do banco de dados que será criado. O nome deve ter nomáximo 8 caracteres e não pode começar com um número.

drive/path No Windows, a unidade na qual os objetos do banco de dadosserão criados. Por exemplo, C. No UNIX, o caminho no qual osobjetos de banco de dados serão criados.

dbalias O nome alternativo do banco de dados. Este valor é opcional.

Nota: O administrador de banco de dados pode revisar os scripts para garantirque se adaptem ao ambiente. O script initializedb.db2 é chamado pelo scriptcmm_create_db.cmd e define os conjuntos de buffer e os espaços de tabela.

2. Determine qual conta do usuário o IBM Cognos Metrics Manager usará paraacessar o banco de dados.A conta do usuário deve ter os seguintes privilégios.v CREATETABv BINDADDv CONNECTv IMPLICIT_SCHEMAv LOAD

Criar um Banco de Dados de Armazenamento de Métricas noMicrosoft SQL Server

Use este procedimento pra criar um armazenamento de métricas usando um bancode dados do Microsoft SQL Server.

Procedimento1. Determine qual conta do usuário o IBM Cognos Metrics Manager usará para

acessar o banco de dados.Essa informações é um dos parâmetros que podem ser usados ao executar ocomando para criar o banco de dados. A conta do usuário deve ser aproprietária do banco de dados (dbo) ou ser um alias do proprietário do bancode dados.

2. No local Componentes da Camada de Aplicativos, no diretórioc10_location/configuration/schemas/cmm/sqlserver, execute o scriptcmm_create_db.cmd digitando o comando a seguir:path_to_script cmm_create_db host_name database_name user_name password[user_to_create]





host_name O nome do computador onde o banco de dados serácriado.

Se houver diversas instâncias do Microsoft SQL Server,especifique host_name\instance_name.

database_name O nome do banco de dados que será criado.

nome_usuário A ID do usuário com permissões para criar o banco dedados. A ID do usuário deve ter permissão para criar obanco de dados, como sa user. A ID de usuário tambémdeve ter inglês como o idioma padrão.

senha A senha para o username.

user_to_create O usuário é criado pelo script e recebe permissões deproprietário do banco de dados. Este valor é opcional.

Criar um Banco de Dados de Armazenamento de Métricas noOracle

Use este procedimento para criar um armazenamento de métricas usando um novobanco de dados Oracle.

Procedimento1. Certifique-se de ter efetuado login no servidor Oracle como um usuário

membro do grupo de usuários ORA_DBA no Windows ou grupo dba no UNIX.2. Configure a variável de ambiente NLS_LANG (Suporte ao Idioma Nacional)

para o conjunto de caracteres UTF-8 no computador de armazenamento demétricas digitando o seguinte comando:NLS_LANG = language_territory.character_set

Os exemplos são:v NLS_LANG = AMERICAN_AMERICA.UTF8v NLS_LANG = JAPANESE_JAPAN.UTF8O valor da variável determina o comportamento dependente de código doidioma do IBM Cognos BI. Convenções de mensagens de erro, de ordem declassificação, de data, de hora, monetária, numérica e de calendário adaptam-seautomaticamente ao idioma e código do idioma nativos.

3. Determine qual conta do usuário o IBM Cognos Metrics Manager usará paraacessar o banco de dados.Essa informações é um dos parâmetros que podem ser usados ao executar ocomando para criar o banco de dados. Utilize um nome de usuário de banco dedados Oracle válido com as seguintes permissões concedidas:v CREATE TABLE, CREATE VIEW, CREATE PROCEDURE, CREATE

TRIGGER, CREATE TYPE, CREATE SEQUENCE e CREATE SESSIONv EXECUTE nos pacotes DBMS_LOCK e DBMS_UTILITYAs permissões CREATE TABLE e CREATE TRIGGER devem ser concedidasdiretamente à conta de usuário, ao invés de à função.Conceda somente estas permissões. Se você conceder menos ou maisprivilégios, o armazenamento de métricas não será inicializado.


4. No local Componentes da Camada de Aplicativos, no diretórioc10_location/configuration/schemas/cmm/oracle, execute o scriptcmm_create_db.cmd digitando o comando a seguir:path_to_script cmm_create_db sid path database_version [user_to_create]




path_to_script O caminho para o script. Por exemplo,c10_location/configuration/schemas/cmm/oracle

sid O SID para o novo banco de dados que serácriado.

caminho O caminho onde os arquivos de dados serãocriados.

database_version A versão do software Oracle que estáinstalada. Por exemplo, oracle9 ou oracle10.

user_to_create O usuário é criado pelo script e recebepermissões de proprietário do banco dedados. Este valor é opcional.

Criar um Banco de Dados de Armazenamento de Métricas noOracle usando um Banco de Dados Existente

Use este procedimento para criar um armazenamento de métricas usando umbanco de dados Oracle existente.





3. Determine qual conta do usuário o IBM Cognos Metrics Manager usará paraacessar o banco de dados. Utilize um nome de usuário de banco de dadosOracle válido com as seguintes permissões concedidas:v CREATE TABLE, CREATE VIEW, CREATE PROCEDURE, CREATE

TRIGGER, CREATE TYPE, CREATE SEQUENCE e CREATE SESSIONv EXECUTE nos pacotes DBMS_LOCK e DBMS_UTILITY.As permissões CREATE TABLE e CREATE TRIGGER devem ser concedidasdiretamente à conta de usuário, ao invés de à função.Conceda somente estas permissões. Se você conceder menos ou maisprivilégios, o armazenamento de métricas não será inicializado.


4. Determine se o banco de dados é Unicode.Dica: Um método é digitar a seguinte instrução select: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 nosparâmetros de conjunto de caracteres do banco de dados. O scriptcmm_create_db.cmd mencionado em “Criar um Banco de Dados deArmazenamento de Métricas no IBM DB2” na página 119 cria um banco dedados com a codificação de caracteres AL32UTF8.

Configurando o Cliente de Banco de Dados para o Armazenamento deMétricas

Se estiver usando um banco de dados diferente do Microsoft SQL comoarmazenamento de métricas, você deverá instalar um software do cliente de bancode dados e drivers Java Database Connectivity (JDBC) em cada computador emque instalar Componentes da Camada de Aplicativos para o Cognos MetricsManager. Fazer isso permite ao Application Tier Components acessar o banco dedados de armazenamento de métricas.

Configurar o Cliente de Banco de Dados para umArmazenamento de Métricas do IBM DB2

Use esse procedimento para configurar o cliente de banco de dados para umarmazenamento de métricas do IBM DB2.

Procedimento1. Instale o software cliente IBM DB2 no computador com Componentes da

Camada de Aplicativos.2. Se o armazenamento de métricas estiver em um computador diferente dos

Componentes da Camada de Aplicativos, configure um alias do banco dedados para o armazenamento de métricas executando o IBM DB2 ClientConfiguration Assistant.Em um sistema operacional UNIX ou Linux, use a interface de linha decomandos do IBM DB2.

Nota: Se o banco de dados de armazenamento de métricas e o Application TierComponents estiverem no mesmo computador, o nome do armazenamento demétricas será automaticamente o alias.

3. Copie os seguintes arquivos do diretório DB2_installation/sqllib/java para odiretório c10_location/webapps/p2pd/WEB-INF/lib.v o arquivo do driver universal, db2jcc.jarv o arquivo de licença, db2jcc_license_cu.jar


Se o diretório contiver um arquivo db2java.jar ou db2java.zip, exclua-o.

Configurar o Cliente de Banco de Dados para umArmazenamento de Métricas Oracle

Use este procedimento para configurar o cliente de banco de dados para umarmazenamento de métricas do Oracle.


Procedimento1. Se você estiver usando uma instalação de 64 bits, instale um cliente Oracle de

64 bits.

Nota: Se estiver usando o Oracle 11g, deverá instalar também um cliente de 32bits.

2. No computador onde está instalado o cliente Oracle, acesse o diretórioORACLE_HOME/jdbc/lib.

3. Copie ojdbc5.jar para o diretório c10_location/webapps/p2pd/WEB-INF/lib nocomputador em que os Componentes da Camada de Aplicativos estãoinstalados.

Nota: Assegure-se de copiar o arquivo jar do cliente de 64 bits se você tiverinstalado o Metrics Manager de 64 bits.O driver está disponível a partir de um cliente Oracle ou uma instalação doservidor e pode ser transferido por download do website da Oracle.

4. Instale o utilitário SQL Loader no computador em que o Application TierComponents está instalado.

Configurar o Cliente de Banco de Dados para umArmazenamento de Métricas do Microsoft SQL Server

Use este procedimento para configurar o cliente de banco de dados para umarmazenamento de métricas do Microsoft SQL Server.

Procedimento1. Instale o utilitário bcp em todos os computadores Windows em que os

Componentes da Camada de Aplicativos do IBM Cognos Metrics Managerestiverem instalados.

2. Inclua o local do utilitário bcp na variável de ambiente do caminho.

Crie um pacote de métricas.Antes de os usuários poderem utilizar o Metric Studio, você deve criar pelo menosum pacote de métricas utilizando o assistente de Novo pacote de métrica. Umpacote de métricas é uma representação do IBM Cognos Connection de umaplicativo do Metric Studio. O pacote de métrica contém informações de conexão,relatórios e tarefas de gerenciamento de métrica para esse aplicativo. O conteúdodo pacote de métricas fica armazenado em um armazenamento de métrica.

Você abre o assistente Novo Pacote de Métricas a partir da barra de ferramentas noIBM Cognos Connection. Utilize o assistente para definir o nome do pacote demétricas e a conexão da origem de dados ao armazenamento de métricas. Para umnovo armazenamento de métricas, forneça também as informações necessárias parainicializar o banco de dados, incluindo as datas de abertura e encerramento do anofiscal.

Antes de Iniciar

Para criar pacotes de métricas, você deve ter permissões de execução para orecurso protegido de Administração do Metric Studio e permissões de acesso àhierarquia para a função protegida de Administração.


Procedimento

1. No IBM Cognos Connection, clique no botão Novo Pacote de Métricas .2. Digite um nome e uma descrição para o aplicativo do Metric Studio que

representará esse pacote de métricas e clique em Avançar.3. Clique em Nova origem de dados.4. Digite um nome e uma descrição da conexão de origem de dados para o

armazenamento de métricas onde esteja o conteúdo para este pacote e cliqueem Avançar

5. Na caixa Tipo, clique no tipo de banco de dados.6. Selecione o nível de isolamento e clique em Avançar.7. Especifique as informações solicitadas para o seu tipo de banco de dados.

v Se estiver usando um banco de dados Microsoft SQL Server:a. Digite o nome do servidor de banco de dados. Por exemplo,

server_name ou server_name\instance_name se houver diversasinstâncias doMicrosoft SQL Server. Se você não estiver usando o númeroda porta padrão 1433, use server_name,port.

b. Digite o nome do banco de dados.c. Selecione Conexões.d. Selecione as caixas de seleção Senha e Criar uma conexão que o grupo

Todos possa usar, e digite o ID e senha da conta do usuário com acessoao banco de dados.

A conta de usuário deve ter inglês como o idioma padrão definido.v Se estiver usando um banco de dados Oracle:

a. Insira a sequência de conexões.b. Selecione ID do Usuário.c. Selecione as caixas de seleção Senha e Criar uma conexão que o grupo


d. Opcionalmente, configure uma conexão JDBC para origem de dadosincluindo um tipo de conexão de ID de Serviço, e especificando osvalores necessários para o nome do servidor, número da porta e ID deserviço do Oracle nos campos apropriados. Se estiver usando AIX, umaconexão JDBC é necessária.

v Se estiver usando um banco de dadosIBM DB2:a. Insira o nome do banco de dados conforme definido no cliente do IBM

DB2.b. Selecione ID do Usuário.c. Selecione as caixas de seleção Senha e Criar uma conexão que o grupo


d. Opcionalmente, configure uma conexão JDBC para origem de dadosincluindo nome do servidor, número da porta e nome do banco dedados nos campos apropriados. Se estiver usando AIX, uma conexãoJDBC é necessária.

Na maioria dos casos não é necessária uma sequência de ordenação. Sedesejar fornecer uma, certifique-se de que o valor digitado é o mesmo que asequência de ordenação especificada quando o banco de dados foi criado.Para obter informações sobre sequências de ordenação, consulte adocumentação do banco de dados.


Dica: Para testar se os parâmetros estão corretos, clique em Testar a conexão.8. Clique em Avançar e depois em Concluir.9. Clique na nova origem de dados e depois em Avançar.

10. Clique em Avançar e siga os prompts para fornecer as informações necessáriaspara inicializar o banco de dados. Ao aparecer a página que resume osdetalhes da origem de dados e as configurações do armazenamento demétricas, clique em Inicializar.

11. Selecione Abra este pacote com o Metric Studio após encerrar o assistente eclique em Concluir.

Resultados

O Metric Studio se abre e o novo pacote de métricas aparece no IBM CognosConnection.


Capítulo 6. Instalação e Configuração dos Componentes doServidor em Diferentes Computadores


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.

Os componentes do servidor incluem o seguinte:v Content Managerv Componentes da Camada de Aplicativosv Gateway

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

Se você estiver instalando o IBM Cognos Metrics Manager, deverá criar o banco dedados de armazenamento de métricas e pelo menos um pacote de métricas.

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

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

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.


Instalações de 64 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.

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.

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 129

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.

Figura 9. Fluxo de Trabalho do Processo de Instalação Distribuída


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.

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

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 de componentes do servidor no modo interativoPara uma instalação completa, instale os componentes no servidor e, em seguida,configure-os para trabalharem no ambiente.

Normalmente, você executa os programas de instalação e configuração do IBMCognos no modo interativo. Isso significa que em uma interface com o usuáriográfica (GUI), o instalador solicita o fornecimento de informações e a ferramentade configuração possibilita a mudança das configurações padrão.

É possível escolher instalar componentes do servidor no modo silencioso.

Modo silencioso

É possível automatizar a instalação de componentes utilizando arquivos deresposta e executando o programa de instalação no modo silencioso.

É possível automatizar a configuração de componentes com a exportação dasconfigurações de um computador para outro, desde que os componentes instaladossejam os mesmos. Execute o IBM Cognos Configuration no modo interativo pelaprimeira vez.

A outra opção é editar o arquivo cogstartup.xml, usando as configurações que seaplicam ao ambiente e, em seguida, executar a ferramenta de configuração nomodo silencioso.

Modo interativo

A menos que pretenda concluir uma instalação no modo silencioso, instale a partirde uma estação de trabalho com sistema X Window, um terminal X, ou um PC ououtro sistema com um software de servidor X instalado.

Para executar a instalação no modo interativo, o console anexado ao computadordeve suportar interfaces gráficas de usuário baseadas em Java.


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

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




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.






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.


exporte PATH







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 17, “Usando instalação e configuração não assistidas”, na página 431.Se você estiver instalando nos sistemas operacionais Linux e recebermensagens de erro sobre bibliotecas openmotif ausentes, poderá usar umainstalação nã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 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.




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.



Instalando o Content Manager nos Sistemas OperacionaisWindowsUse o seguinte procedimento para instalar o Content Manager em um sistemaoperacional Microsoft Windows.


Antes de Iniciar








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.



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 o Content Manager para IBM Cognos MetricsManager

Se estiver instalando o IBM Cognos Metrics Manager com o servidor IBM CognosBI e quiser compartilhar recursos, não será necessário instalar o Content Manager apartir do disco do IBM Cognos Metrics Manager. Seu produto de scorecard podeusar o mesmo Content Manager que é instalado para o servidor IBM Cognos BI. Sequiser que seu produto de scorecard opere independentemente do servidor IBMCognos BI, instale o Content Manager para IBM Cognos Metrics Manager em umlocal diferente do Content Manager para o servidor IBM Cognos BI.









Antes de Iniciar










Instalando os Fix Packs IBM Cognos nos Sistemas OperacionaisUNIX ou LinuxFix packs são atualizações de produto que contêm correções de códigosacumulativas realizadas desde a última liberação do produto. Os fix packs do IBMCognos são instalados no mesmo local que o produto existente.

Antes de Iniciar




./issetup


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.





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 Banco de dados de conteúdo doCognos ou do Microsoft SQL Server como o armazenamento de conteúdo, vocêpode ter que instalar o software do cliente de banco de dados e/ou os drivers JavaDatabase Connectivity (JDBC) em cada computador em que instalar o ContentManager. Fazer isso permite que o Content Manager acesse o banco de dados dearmazenamento de conteúdo.

Configurar a Conectividade do Banco de Dados para umArmazenamento de Conteúdo IBM DB2Esse procedimento descreve como configurar a conectividade do banco de dadospara um armazenamento de conteúdo DB2. Você deve executar este procedimentoem 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.

Procedimento





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

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 mais informações, consulte o Centro de Informações do IBM DB2.

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

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 31. Nomes de Parâmetro e Descrição para o Script de Espaço de Tabela deArmazenamento de Conteúdo


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.


Tabela 31. Nomes de Parâmetro e Descrição para o Script de Espaço de Tabela deArmazenamento de Conteúdo (continuação)


CMSCRIPT_LARGE_BP Especifica o nome do pool de buffer grandealocado especialmente para objetos grandes.


CMSCRIPT_REGULAR_BP Especifica o nome do pool de buffer detamanho normal alocado especialmente paraobjetos grandes e de tamanho normal.


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













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














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 esalve o arquivo em outro local.

b. Abra o arquivo de script original ANN_TABLESPACES.sql e use a seguintetabela para ajudá-lo a substituir os parâmetros genéricos pelos apropriadosao seu ambiente.












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.




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.





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.





Antes de Iniciar










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

Em um ambiente de produção, use um banco de dados de nível empresarial paraarmazenamento do conteúdo. Se estiver usando o Banco de Dados de Conteúdo doCognos em um sistema de teste ou de prova de conceito, será possível usar osrecursos no portal de administração para fazer backup e arquivar os dados antesque sejam movidos para um banco de dados de nível corporativo no ambiente deprodução. Para obter mais informações, consulte o tópico sobre como implantartodo o armazenamento de conteúdo no Guia de administração e segurança.

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.

Certifique-se de que um dos servidores suportados foi usado para criar oarmazenamento de conteúdo.

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





válidas:


v Clique na caixa de seleção Valor próxima à propriedade ID do usuário esenha 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 de 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.8. Para testar a conexão entre o Content Manager e o banco de dados de


Configurando as Propriedades de Conexão com o Banco deDados para um Armazenamento de Conteúdo do DB2 no z/OSDeve-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.





válidas:v Clique na caixa Valor próxima à propriedade ID do usuário e senha e

clique no ícone de edição quando ele aparecer. Verifique se especificou amesma ID de usuário que a de CMSCRIPT_USERNAME ao criar os espaçosde tabela.

v Digite os valores apropriados e clique em OK.5. Para usar a conexão JDBC tipo 4, na propriedade Servidor de banco de dados

e número da porta, digite um valor, usando a sintaxe host:porta .6. Na janela Explorer, clique em Configuração Local.7. Na janela Propriedades, próxima a Propriedades avançadas, clique dentro da

caixa Valor e clique no ícone de edição.A caixa de diálogo Valor - Propriedades avançadas será exibida.


8. Para adicionar os parâmetros usados para criar os espaços de tabelas, cliqueem Adicionar.Todos os parâmetros, exceto CMSCRIPT_USERNAME, são adicionados.

9. No menu Arquivo, clique em Salvar.As credenciais de logon são imediatamente criptografadas.

10. Para testar a conexão entre o Content Manager e o banco de dados dearmazenamento de conteúdo, no menu Ações, clique em Testar.Isto testa a conexão entre o Content Manager e o banco de dados doarmazenamento de conteúdo.

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. No computador no qual foi instalado o Content Manager, 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.

Se você instalou mais de uma versão do IBM Cognos BI, deverá usar umarmazenamento de conteúdo diferente para cada versão. Quando umarmazenamento de conteúdo é usado por uma nova versão do IBM CognosBI, ele não pode ser usado por uma versão anterior.

Dica: Se desejar usar um par de valores da palavra-chave do Oracle Net8para gerenciar a conexão do banco de dados, selecione Banco de DadosOracle (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 comnúmero da 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 nomeda instâ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 diversasinstâncias do 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íveldigitar localhost\instance1. Se não forem especificadas propriedades denome de instância, é criada uma conexão com a instância padrão.


As propriedades especificadas para a instância denominada, junto com a IDe senha de usuário e nome do banco de dados, são usados para criar umJDBC URL. 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 onome de uma instância não for especificado, será criada uma conexão coma instâ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 valoresapropriados para as propriedades Servidor de banco de dados e númeroda porta e Nome 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 de 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.


10. Para testar a conexão entre o Content Manager e o banco de dados dearmazenamento de conteúdo, no menu Ações, clique em Testar.


O Content Manager se conecta ao banco de dados, verifica as permissões dobanco de dados e cria e preenche uma tabela. A tabela não é excluída e seráusada todas as vezes que o teste for repetido.

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.

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 238) 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 13, “Configurando Componentes doIBM Cognos para Usar um Provedor de Autenticação”, na página 351), ativar edesativar serviços (consulte “Ativação e desativação de serviços” na página 250)nos computadores com Content Manager ou alterar configurações globais (consulte“Alteração de definições globais” na página 292).

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

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 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 emArmazenamento de Conteúdo.

9. Certifique-se de que os valores para todas as propriedades coincidam com oque foi configurado no computador ativo padrão com Content Manager.


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. Na janela Explorer, em Acesso a dados, clique em Notificação.2. Na janela Propriedades, para a propriedade Servidor de correio SMTP, digite

o nome do host e da porta de seu servidor de correio SMTP (saída).

Dica: Para conseguir abrir relatórios que são enviados por e-mail, altere a partedo nome do host do URI do gateway de localhost para o endereço IP docomputador ou para o nome do computador. Do contrário, o URL no e-mail iráconter localhost e os usuários remotos não poderão abrir o relatório.

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.

3. Clique na caixa de seleção Valor próxima à propriedade Conta e senha e cliqueno botão de edição quando aparecer.

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

5. Na janela Propriedades, digite o valor apropriado para a conta do remetentepadrão.

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




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









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á em execução digitando a URI do Content

Manager ativo. Por exemplo, http://host_name:port/p2pd/servletO valor padrão para nome_host:porta é localhost:9300.O Content Manager estará disponível quando o valor Estado estiver emExecução.

Instalação e configuração do Application Tier ComponentsInstale o Application Tier Components no mesmo computador ou emcomputadores diferentes.

Efetue as seguintes tarefas para instalar e configurar o Application TierComponents:__ v Instale os Componentes da Camada de Aplicativos__ v Instale os Componentes da Camada de Aplicativos para o IBM Cognos

Metrics Manager, se necessário__ v Instale os fix packs, se disponíveis__ v Configure a conectividade do banco de dados para o banco de dados de

relatórios.__ v Inicie o IBM Cognos Configuration__ v Configure propriedades do ambiente para computadores com Camada de

Aplicativos__ v Inicie os Componentes da Camada de Aplicativos__ v Teste os Componentes da Camada de Aplicativos__ v Crie o banco de dados de armazenamento de métricas__ v Configure o cliente de banco de dados para o armazenamento de métricas, se

necessário.__ v Crie um pacote de métricas.

Instalação do Application Tier ComponentsInstale os componentes do Application Tier Components em um ou maiscomputadores, dependendo do ambiente.

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.


Instalações de 64 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.

Requisitos de impressora

Para garantir que os relatórios sejam impressos corretamente em um sistemaoperacional Microsoft Windows, o Adobe Reader requer que você configure pelomenos uma impressora no sistema operacional em que os Componentes daCamada de Aplicativos estão instalados. Todos os relatórios, independente doformato de impressão escolhido, são enviados como arquivos PDF temporáriospara o Adobe Reader para impressão.

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




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.










exporte PATH







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 432).Se você estiver instalando nos sistemas operacionais Linux e recebermensagens de erro sobre bibliotecas openmotif ausentes, poderá usar umainstalação não assistida com o comando issetupnx.


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.




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.



Instalando os Componentes da Camada de Aplicativos noSistema Operacional WindowsInstale os componentes do Application Tier Components em um ou maiscomputadores, dependendo do ambiente.








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.



seleção das Notas sobre o Release do IBM Cognos.


v Se você iniciar o IBM Cognos Configuration a partir do assistente deinstalaçã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.


Instalando Componentes da Camada de Aplicativos para IBMCognos Metrics Manager

Se estiver instalando o IBM Cognos Metrics Manager com o servidor IBM CognosBI e quiser compartilhar recursos, você deverá instalar os Componentes daCamada de Aplicativos para o IBM Cognos Metrics Manager no mesmo local dosComponentes da Camada de Aplicativos para o servidor IBM Cognos BI. Se quiserque seu produto de scorecard opere independentemente do servidor IBM CognosBI server, instale os Componentes da Camada de Aplicativos para o IBM CognosMetrics Manager em um local diferente dos Componentes da Camada deAplicativos para o servidor IBM Cognos BI.







Antes de Iniciar

Certifique-se de executar as seguintes tarefas antes de instalar um Fix Pack.v Se o serviço do IBM Cognos estiver em execução, interrompa-o.v Faça o backup da estrutura de diretório.



v Faça o backup do banco de dados de armazenamento de conteúdov Faça o backup de todos os arquivos editados manualmente.










Antes de Iniciar




./issetup



5. Retorne o produto IBM Cognos implementado ao serviço.


v Se estiver usando o Tomcat, abra a Configuração do IBM Cognos, salve aconfiguração e em seguida inicie o serviço IBM Cognos.

v Se estiver executando o produto IBM Cognos em um servidor de aplicativosdiferente do Tomcat, reimplemente o produto IBM Cognos ao servidor deaplicativos.


Configurar a Conectividade de Banco de Dados para Bancosde Dados de Relatório

Para suportar a comunicação entre o IBM Cognos Business Intelligence e as origensde dados, você deve instalar o software adicional para suas origens de dados nomesmo computador que hospeda o servidor de relatório. Dependendo da origemde dados e do modo de consulta, o software necessário pode incluir clientes debanco de dados e/ou arquivos do driver Java Database Connectivity (JDBC).

Para o IBM Cognos Business Intelligence, o banco de dados de consulta (tambémconhecido como o banco de dados de relatório) somente é acessado pelomecanismo de relatório que executa relatórios. O mecanismo de relatório éinstalado com os Componentes da Camada de Aplicativos e também é usado peloFramework Manager, Metric Designer e IBM Cognos Transformer.

Modo de consulta compatível

Para executar relatórios que usam modo de consulta compatível, você deve usarbibliotecas de clientes de origem de dados de 32 bits e configurar o servidor derelatório para 32 bits. O modo de consulta compatível usa cliente nativo e conexõesODBC para se comunicar com origens de dados.

Se a origem de dados for de 64 bits, certifique-se de usar as bibliotecas de clientesde 32 bits para se conectar à origem de dados para usar o modo de consulta decompatibilidade.

Modo de consulta dinâmica

O modo de consulta dinâmica fornece comunicação a origens de dados usandoconexões Java/XMLA.

Para bancos de dados relacionais compatíveis, exige-se uma conexão JDBC tipo 4.O driver JDBC tipo 4 converte as chamadas JDBC diretamente para o protocolo debanco de dados específico do fornecedor. Ele está escrito em Java puro e éindependente de plataforma.

Para origens de dados OLAP compatíveis, a conectividade Java/XMLA otimiza oacesso ao oferecer MDX customizado e aprimorado para a origem e a versãoespecíficas da tecnologia OLAP e se conecta aos smarts da origem de dados OLAP.

É possível usar o modo de consulta dinâmica com as seguintes origens de dadosOLAP:v IBM Cognos TM1v SAP Business Information Warehouse (SAP BW)v Oracle Essbasev Microsoft Analysis Services


É possível usar o modo de consulta dinâmica para OLAP sobre modelosrelacionais ( relacionais modelados de forma dimensional) com as seguintes fontesde dados relacionais:v IBM DB2v IBM DB2 for z/OSv Oraclev Microsoft SQL Serverv Teradatav Netezza

Para obter mais informações sobre o modo de consulta dinâmica, incluindoinstalação dos drivers, consulte o IBM Cognos Business Intelligence Dynamic QueryGuide.

Para revisar uma lista de ambientes suportados pelo IBM Cognos BusinessIntelligence, incluindo as versões da origem de dados suportadas pelo modo deconsulta dinâmica, consulte a página IBM Software Compatibility Reports (SPCR)(www.ibm.com/support/docview.wss?uid=swg27037784).

Acessar Origens de Dados OLAP em Sistemas OperacionaisWindowsPara acessar os bancos de dados relacionais e as origens de dados OLAP pararelatórios, você deve instalar o software de API do cliente disponibilizado pelofornecedor da origem de dados. O software deve ser instalado no mesmocomputador no qual os Componentes da Camada de Aplicativos estão instalados.

Procedimento1. Instale o software de API do banco de dados para os bancos de dados

relacionais e as origens de dados OLAP no computador host do servidor derelatórios (no qual Componentes da Camada de Aplicativos estão instalados).Nos sistemas operacionais MicrosoftWindows, o mecanismo de relatóriosuporta a conectividade do banco de dados nativo ou ODBC.

2. Se o Framework Manager estiver instalado em um local separado dosComponentes da Camada de Aplicativos, também é necessário instalar osoftware da API cliente no computador no qual o Framework Manager estáinstalado. Para obter mais informações, consulte “Configurar Variáveis paraConexões de Origem de Dados para o Framework Manager” na página 199.

Acessar Origens de Dados ODBC em Sistemas OperacionaisUNIX ou LinuxPara usar uma origem de dados ODBC no UNIX ou Linux para conectar-se a umaorigem de dados suportada, é necessário configurar o ambiente para localizar oarquivo .odbc.ini que contém as referências para a origem de dados, asbibliotecas de conectividade e suas bibliotecas do Gerenciador de Driversacompanhantes.

Para revisar as origens de dados ODBC suportadas, IBM Software ProductCompatibility Reports (SPCR) (www.ibm.com/support/docview.wss?uid=swg27037784).

Após configurar as conexões do ODBC, você deve criar conexões com as origensde dados no IBM Cognos Administration. Para obter informações, consulte o Guiade Administração e Segurança do IBM Cognos.





Se seu fornecedor de banco de dados não fornecer um gerenciador de drivers, épossível usar o unixODBC ou iODBC, dependendo do seu sistema operacional.

Nos sistemas operacionais Linux, o pacote unixODBC fornecido com o sistemaoperacional fornece o ODBC Driver Manager. É necessário instalar o unixODBCversão 2.2.11 ou posterior antes de poder configurar as conexões de origem dedados. Para verificar a versão instalada, use o comando a seguir: odbcinst--version. Verifique qual versão do unixODBC é necessária para o banco de dadosque está sendo usado e assegure-se de usar essa versão.

Nos sistemas operacionais UNIX, o gerenciador de drivers iODBC de softwarelivre é fornecido como parte da instalação do IBM Cognos.

Procedimento1. Crie uma variável de ambiente para especificar o local do arquivo .odbc.ini.

Por exemplo,export ODBCINI=/usr/local/etc/.odbc.ini

2. Configure a variável de ambiente do caminho da biblioteca apropriada paraespecificar o local das bibliotecas de conectividade e o Driver Manager para oseu banco de dados.A tabela a seguir lista as variáveis de ambiente para cada sistema operacionalque deve especificar o local das bibliotecas do gerenciador de drivers.

Tabela 37. Variáveis de Ambiente para seu Sistema Operacional


AIX LIBPATH


HP-UX SHLIB_PATH

3. Se seu fornecedor de banco de dados não fornecer um gerenciador de drivers,configure o caminho da biblioteca para incluir o caminho do gerenciador dedrivers local.v No UNIX, iODBC é fornecido como parte da instalação do IBM Cognos. Os

arquivos de biblioteca estão localizados no diretório c10_location/bin. Ocaminho da biblioteca já deveria conter o diretório c10_location/bin.Por exemplo,LIBPATH=/usr/IBM/cognos/bin:$LIBPATH

v No Linux, o pacote unixODBC fornece as bibliotecas do gerenciador dedrivers necessárias.Por exemplo,LD_LIBRARY_PATH=/usr/lib:$LD_LIBRARY_PATH

O que Fazer Depois

Se você estiver usando diversas origens ODBC nos sistemas operacionais UNIX ouLinux, é possível encontrar dependências dos arquivos de biblioteca com nomescomuns, mas implementações diferentes para a conectividade e o gerenciador dedrivers. Em um cenário no qual uma origem ODBC é validada enquanto outrafalha com base em uma dependência, entre em contato com o Suporte ao Cliente.Usar um .odbc.ini comum pode resultar em ter entradas incompatíveis paradiferentes gerenciadores de drivers. Para resolver o problema, revise os requisitosde estrutura entre os gerenciadores de drivers que você está usando e tente usar a


sintaxe que é comum entre os gerenciadores de drivers conflitantes.

Configure o IBM Cognos Business Intelligence para Usar oOracle EssbaseSe usar o IBM Cognos Business Intelligence com uma origem de dados Essbaseversão 11.1.1, você deve editar um arquivo de configuração para informar aoservidor IBM Cognos BI da sua versão.

Por padrão, o IBM Cognos BI é configurado para usar o Oracle Essbase versão11.1.2. Portanto, nenhuma configuração é necessária se você usar esta versão. Sevocê usar outra versão suportada do Oracle Essbase, deverá editar o arquivoqfs.config.xml para sua versão.

Além disso, se você usar o Oracle Essbase versão 11.1.2, deverá instalar o OracleFoundation Services, bem como o cliente Oracle Essbase.

Procedimento1. Acesse o diretório c10_location/configuration.2. Abra o arquivo qfs_config.xml em um xml ou editor de texto.3. Localize as seguintes linhas:

<provider name="DB2OlapODP" libraryName="essodp1112" connectionCode="DO">

4. Para Oracle Essbase 11.1.1, altere-as da seguinte maneira:<provider name="DB2OlapODP" libraryName="essodp111" connectionCode="DO">

5. Para Oracle Essbase 11.1.2, assegure-se de que as linhas aparecem da seguintemaneira:<provider name="DB2OlapODP" libraryName="essodp1112" connectionCode="DO">

6. Salve o arquivo e reinicie o serviço do IBM Cognos

Usando o Oracle Essbase em um Sistema Operacional UNIX ouMicrosoft Windows de 64 bitsSe você usar uma origem de dados do Oracle Essbase versão 11.1.2 com o IBMCognos Business Intelligence em um sistema operacional UNIX ou MicrosoftWindows de 64 bits, você deverá configurar manualmente as variáveis de ambienteARBORPATH e ESSBASEPATH.

As variáveis de ambiente ARBORPATH e ESSBASEPATH são criadas durante a instalaçãodo cliente do Oracle Essbase. O IBM Cognos BI usa essas variáveis para encontrara localização do cliente Oracle Essbase.

Para usar o Oracle Essbase com o IBM Cognos BI em um sistema operacionalUNIX ou Microsoft Windows de 64 bits, você deve instalar o cliente do OracleEssbase de 64 bits. Este cliente de 64 bits inclui um cliente de 32 bits utilizado peloIBM Cognos BI. Para apontar para esse cliente de 32 bits, você deve alterarmanualmente as variáveis de ambiente ARBORPATH e ESSBASEPATH para substituir oEssbaseClient pelo EssbaseClient-32. O seguinte exemplo supõe que o cliente éinstalado na unidade C. Seu local de instalação pode ser diferente.ARBORPATH=C:\Hyperion\EPMSystem11R1\products\Essbase\EssbaseClient-32

ESSBASEPATH=C:\Hyperion\EPMSystem11R1\products\Essbase\EssbaseClient-32


Se você usar um sistema operacional Microsoft Windows de 32 bits com um clientedo Oracle Essbase de 32 bits, nenhuma mudança será necessária para essasvariáveis de ambiente.


Antes de Iniciar









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

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


Configurar uma Instância de Componentes da Camada deAplicativos Apenas no Metrics ManagerSe você estiver instalando Componentes da Camada de Aplicativos do MetricsManager em uma instância separada dos seus Componentes da Camada deAplicativos do BI, poderá desativar vários dos serviços comuns em sua instânciados Componentes da Camada de Aplicativos do Metrics Manager.

Por exemplo, você possui o Content Manager instalado como uma instânciaseparada e possui instalados o relatório dos Componentes da Camada deAplicativos em outra instância. Se você incluir uma instância dos Componentes da


Camada de Aplicativos do Metrics Manager, não será necessário duplicar todos osserviços necessários para o relatório dos Componentes da Camada de Aplicativos.

Procedimento1. Na instância em que você possui apenas os Componentes da Camada de

Aplicativos do Metrics Manager instalados, abra o IBM Cognos Configuration.2. Na janela do Explorer, em Configuração Local > Ambiente, clique em Serviço

do IBM Cognos.3. Configure os seguintes serviços como True:

v Serviço de integração de dados

v Serviço de entrega

v Serviço de dispatcher

v Serviço de metadados

v Serviço do Metric Manager

Os serviços restantes podem ser configurados como False.4. Salve suas configurações e reinicie os serviços para essa instância.

Figura 10. Instância de Componentes da Camada de Aplicativos do Metrics Manager comComponentes de BI


Ativar a Versão de 64 Bits do Servidor de RelatórioEm uma instalação de 64 bits, o componente do servidor de relatório é fornecidonas versões de 32 bits e de 64 bits. A opção padrão é 32 bits. Para usar a versão de64 bits, é necessário ativá-la usando o IBM Cognos Configuration.

A versão de 64 bits de servidor de relatório pode ser utilizada apenas com pacotespara os quais o modo de consulta dinâmica está ativado.

Você deve utilizar a versão de 32 bits do servidor de relatório para pacotes que nãoutilizam o modo de consulta dinâmica. Por exemplo, se o seu pacote se basear noIBM Cognos PowerCubes, você deve usar a versão de 32 bits do servidor derelatório.

Se você tiver várias instâncias de Componentes da Camada de Aplicativos em seuambiente, você pode configurar uma instância para utilizar o servidor de relatóriode 32 bits. Em seguida, você pode utilizar regras de roteamento para que pedidosde relatório para pacotes de modo de consulta não dinâmica sejam roteados para ainstância que está executando a versão de 32 bits de servidor de relatório. Paraobter mais informações sobre regras de roteamento, consulte o Guia deAdministração e Segurança.

Para ativar a versão de 64 bits, você deve instalar a versão de 64 bits dosComponentes da camada de Aplicativos em um computador de 64 bits. Se vocêinstalar a versão de 32 bits dos Componentes da Camada de Aplicativos ou estiverusando um computador de 32 bits, não ative o servidor de relatório de 64 bits.

Procedimento1. Na janela Explorer do IBM Cognos Configuration, clique em Ambiente.2. Clique na caixa Valor para Modo de Execução do Servidor de Relatório e

selecione 64 Bits.3. No menu Arquivo, clique em Salvar.4. Reinicie os serviços do IBM Cognos se eles estiverem em execução.

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









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

Procedimento1. Abra um navegador 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 estará disponível quando o IBM Cognos Connection aparecer, masnão exibindo gráficos ou imagens.

Criando um Banco de Dados de Armazenamento de MétricasVocê deve criar um banco de dados de armazenamento de métricas usando oOracle, o Microsoft SQL Server ou o DB2.

O armazenamento de métricas é um banco de dados que contém o conteúdo parapacotes de métricas. O armazenamento de métricas também contém asconfigurações do aplicativo de scorecard, tais como preferências do usuário.Embora se execute o comando para criar o armazenamento de métricas a partir dolocal onde o Application Tier Components está instalado, será possível especificarum local diferente para o armazenamento de métricas nos parâmetros docomando. Se o armazenamento de métricas estiver em um computador diferentedo Application Tier Components, crie um alias para o armazenamento de métricasno local do Application Tier Components.

Não é possível usar o Banco de Dados de Conteúdo do Cognos como um banco dedados de armazenamento de métricas.

Seu administrador de banco de dados deve fazer backup dos bancos de dados doIBM Cognos Business Intelligence regularmente porque eles contêm os dados doIBM Cognos. Para garantir a segurança e integridade dos bancos de dados,também é importante protegê-los de acesso não autorizado ou inadequado.


Criar um Banco de Dados de Armazenamento de Métricas noIBM DB2Use este procedimento para criar um armazenamento de métricas usando umbanco de dados IBM DB2.

Procedimento1. No local Componentes da Camada de Aplicativos, no diretório

c10_location/configuration/schemas/cmm/db2, execute o scriptcmm_create_db.cmd digitando o comando a seguir:Em um sistema operacional Microsoft Windows, digitecmm_create_db dbinstance user_name password dbname drive dbalias

Em um sistema operacional UNIX, digitecmm_create_db.sh dbinstance user_name password dbname path dbalias




dbinstance O nome da instância DB2 na qual o banco de dados será criado.

nome_usuário A ID do usuário com permissões para criar o banco de dados. AID do usuário deve ter privilégios SYSADM ou SYSCTRL, e deveter privilégios DBADM para criar o esquema.

senha A senha para o valor user_name.

dbname O nome do banco de dados que será criado. O nome deve ter nomáximo 8 caracteres e não pode começar com um número.

drive/path No Windows, a unidade na qual os objetos do banco de dadosserão criados. Por exemplo, C. No UNIX, o caminho no qual osobjetos de banco de dados serão criados.

dbalias O nome alternativo do banco de dados. Este valor é opcional.

Nota: O administrador de banco de dados pode revisar os scripts para garantirque se adaptem ao ambiente. O script initializedb.db2 é chamado pelo scriptcmm_create_db.cmd e define os conjuntos de buffer e os espaços de tabela.

2. Determine qual conta do usuário o IBM Cognos Metrics Manager usará paraacessar o banco de dados.A conta do usuário deve ter os seguintes privilégios.v CREATETABv BINDADDv CONNECTv IMPLICIT_SCHEMAv LOAD

Criar um Banco de Dados de Armazenamento de Métricas noMicrosoft SQL ServerUse este procedimento pra criar um armazenamento de métricas usando um bancode dados do Microsoft SQL Server.

Procedimento1. Determine qual conta do usuário o IBM Cognos Metrics Manager usará para

acessar o banco de dados.


Essa informações é um dos parâmetros que podem ser usados ao executar ocomando para criar o banco de dados. A conta do usuário deve ser aproprietária do banco de dados (dbo) ou ser um alias do proprietário do bancode dados.

2. No local Componentes da Camada de Aplicativos, no diretórioc10_location/configuration/schemas/cmm/sqlserver, execute o scriptcmm_create_db.cmd digitando o comando a seguir:path_to_script cmm_create_db host_name database_name user_name password[user_to_create]




host_name O nome do computador onde o banco de dados serácriado.

Se houver diversas instâncias do Microsoft SQL Server,especifique host_name\instance_name.

database_name O nome do banco de dados que será criado.

nome_usuário A ID do usuário com permissões para criar o banco dedados. A ID do usuário deve ter permissão para criar obanco de dados, como sa user. A ID de usuário tambémdeve ter inglês como o idioma padrão.

senha A senha para o username.

user_to_create O usuário é criado pelo script e recebe permissões deproprietário do banco de dados. Este valor é opcional.

Criar um Banco de Dados de Armazenamento de Métricas noOracleUse este procedimento para criar um armazenamento de métricas usando um novobanco de dados Oracle.





3. Determine qual conta do usuário o IBM Cognos Metrics Manager usará paraacessar o banco de dados.Essa informações é um dos parâmetros que podem ser usados ao executar ocomando para criar o banco de dados. Utilize um nome de usuário de banco dedados Oracle válido com as seguintes permissões concedidas:


v CREATE TABLE, CREATE VIEW, CREATE PROCEDURE, CREATETRIGGER, CREATE TYPE, CREATE SEQUENCE e CREATE SESSION

v EXECUTE nos pacotes DBMS_LOCK e DBMS_UTILITYAs permissões CREATE TABLE e CREATE TRIGGER devem ser concedidasdiretamente à conta de usuário, ao invés de à função.Conceda somente estas permissões. Se você conceder menos ou maisprivilégios, o armazenamento de métricas não será inicializado.

4. No local Componentes da Camada de Aplicativos, no diretórioc10_location/configuration/schemas/cmm/oracle, execute o scriptcmm_create_db.cmd digitando o comando a seguir:path_to_script cmm_create_db sid path database_version [user_to_create]




path_to_script O caminho para o script. Por exemplo,c10_location/configuration/schemas/cmm/oracle

sid O SID para o novo banco de dados que serácriado.

caminho O caminho onde os arquivos de dados serãocriados.

database_version A versão do software Oracle que estáinstalada. Por exemplo, oracle9 ou oracle10.

user_to_create O usuário é criado pelo script e recebepermissões de proprietário do banco dedados. Este valor é opcional.

Criar um Banco de Dados de Armazenamento de Métricas noOracle usando um Banco de Dados ExistenteUse este procedimento para criar um armazenamento de métricas usando umbanco de dados Oracle existente.





3. Determine qual conta do usuário o IBM Cognos Metrics Manager usará paraacessar o banco de dados. Utilize um nome de usuário de banco de dadosOracle válido com as seguintes permissões concedidas:


v CREATE TABLE, CREATE VIEW, CREATE PROCEDURE, CREATETRIGGER, CREATE TYPE, CREATE SEQUENCE e CREATE SESSION

v EXECUTE nos pacotes DBMS_LOCK e DBMS_UTILITY.As permissões CREATE TABLE e CREATE TRIGGER devem ser concedidasdiretamente à conta de usuário, ao invés de à função.Conceda somente estas permissões. Se você conceder menos ou maisprivilégios, o armazenamento de métricas não será inicializado.

4. Determine se o banco de dados é Unicode.Dica: Um método é digitar a seguinte instrução select: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 nosparâmetros de conjunto de caracteres do banco de dados. O scriptcmm_create_db.cmd mencionado em “Criar um Banco de Dados deArmazenamento de Métricas no IBM DB2” na página 119 cria um banco dedados com a codificação de caracteres AL32UTF8.

Definir Manualmente o Local de Implementação para MetricStudio

Se estiver usando o IBM Cognos Metrics Manager em uma instalação distribuída,você deve definir manualmente um local de implementação para o Metric Studio.

Você deve definir manualmente um local de implementação para Metric Studio nassituações a seguir:v Se mais de um servidor de métricas foi instalado.v Se o servidor de métricas está separado do Content Manager

Se você tiver apenas um servidor de métrica e ele estiver no mesmo computadordo Content Manager, o IBM Cognos Metrics Manager será configuradoautomaticamente com um local de implementação.

Exemplos em que um local de implementação não precisa ser definidomanualmentev Servidor único com Content Manager + Application Tier Components +

Gatewayv Vários servidores, onde o Servidor A = Content Manager + Application Tier

ComponentsServidor B = Gateway

Exemplos em que o local da implementação deve ser definido manualmente.v Vários servidores, onde Servidor A = Content Manager.

Servidor B = Application Tier ComponentsServidor C = Gateway

v Vários servidores, onde o Servidor A = Content Manager + Application TierComponentsServidor B = Application Tier ComponentsServidor C = Application Tier ComponentsServidor D = Gateway


O local de implementação deve ser definido em cada computador servidor demétricas (em que o Application Tier Components está instalado).

Importante: Crie apenas uma pasta do local de implementação. O local deimplementação é selecionado quando um pacote de métricas é criado. O mesmolocal de implementação deve ser usaoa para todos os pacotes de métricas. Se oarquivo de local de implementação contiver vários locais de implementação, entãoevite possíveis erros e exclua tudo, exceto uma localização.

Antes de Iniciar

Antes de definir o local de implementação para o Metric Studio, crie uma pastacompartilhada que irá servir como local de implementação. A pasta deve seracessível a todos os computadores servidores de métricas.

Procedimento1. No computador do servidor de métricas no qual os Componentes da Camada

de Aplicativos estão instalados, acesse o diretório c10_location/configuratione abra deployment_locations.xml em um editor de texto.

2. Selecione a seção aplicável:v Nos sistemas operacionais UNIX ou Linux, selecione:

<DeploymentLocation><name>Unix Mount</name><value>/mount/deployment</value></DeploymentLocation>

v Nos sistemas operacionais Windows, selecione:<DeploymentLocation><name>windows share</name><value>\\winserver\deployment location</value></DeploymentLocation>

3. Copie a seção selecionada após a linha:DELETE this line to remove the xml comment tag -->

4. Configure o valor do local de implementação:v Nos sistemas operacionais UNIX ou Linux, substitua /mount/deployment pelo

caminho montado em NFS para a pasta compartilhada.v Nos sistemas operacionais Windows, substitua \\winserver\deployment

location pelo caminho UNC para a pasta compartilhada.Se o IBM Cognos BI for implementado em um servidor de aplicativos que nãoseja Tomcat, certifique-se de que o local seja um caminho absoluto.

5. Salve e feche o arquivo.

Configurando o Cliente de Banco de Dados para oArmazenamento de Métricas

Se estiver usando um banco de dados diferente do Microsoft SQL comoarmazenamento de métricas, você deverá instalar um software do cliente de bancode dados e drivers Java Database Connectivity (JDBC) em cada computador emque instalar Componentes da Camada de Aplicativos para o Cognos MetricsManager. Fazer isso permite ao Application Tier Components acessar o banco dedados de armazenamento de métricas.


Configurar o Cliente de Banco de Dados para umArmazenamento de Métricas do IBM DB2Use esse procedimento para configurar o cliente de banco de dados para umarmazenamento de métricas do IBM DB2.

Procedimento1. Instale o software cliente IBM DB2 no computador com Componentes da

Camada de Aplicativos.2. Se o armazenamento de métricas estiver em um computador diferente dos

Componentes da Camada de Aplicativos, configure um alias do banco dedados para o armazenamento de métricas executando o IBM DB2 ClientConfiguration Assistant.Em um sistema operacional UNIX ou Linux, use a interface de linha decomandos do IBM DB2.

Nota: Se o banco de dados de armazenamento de métricas e o Application TierComponents estiverem no mesmo computador, o nome do armazenamento demétricas será automaticamente o alias.




Configurar o Cliente de Banco de Dados para umArmazenamento de Métricas OracleUse este procedimento para configurar o cliente de banco de dados para umarmazenamento de métricas do Oracle.

Procedimento1. Se você estiver usando uma instalação de 64 bits, instale um cliente Oracle de

64 bits.

Nota: Se estiver usando o Oracle 11g, deverá instalar também um cliente de 32bits.

2. No computador onde está instalado o cliente Oracle, acesse o diretórioORACLE_HOME/jdbc/lib.

3. Copie ojdbc5.jar para o diretório c10_location/webapps/p2pd/WEB-INF/lib nocomputador em que os Componentes da Camada de Aplicativos estãoinstalados.

Nota: Assegure-se de copiar o arquivo jar do cliente de 64 bits se você tiverinstalado o Metrics Manager de 64 bits.O driver está disponível a partir de um cliente Oracle ou uma instalação doservidor e pode ser transferido por download do website da Oracle.

4. Instale o utilitário SQL Loader no computador em que o Application TierComponents está instalado.


Configurar o Cliente de Banco de Dados para umArmazenamento de Métricas do Microsoft SQL ServerUse este procedimento para configurar o cliente de banco de dados para umarmazenamento de métricas do Microsoft SQL Server.

Procedimento1. Instale o utilitário bcp em todos os computadores Windows em que os

Componentes da Camada de Aplicativos do IBM Cognos Metrics Managerestiverem instalados.

2. Inclua o local do utilitário bcp na variável de ambiente do caminho.

Crie um pacote de métricas.Antes de os usuários poderem utilizar o Metric Studio, você deve criar pelo menosum pacote de métricas utilizando o assistente de Novo pacote de métrica. Umpacote de métricas é uma representação do IBM Cognos Connection de umaplicativo do Metric Studio. O pacote de métrica contém informações de conexão,relatórios e tarefas de gerenciamento de métrica para esse aplicativo. O conteúdodo pacote de métricas fica armazenado em um armazenamento de métrica.

Você abre o assistente Novo Pacote de Métricas a partir da barra de ferramentas noIBM Cognos Connection. Utilize o assistente para definir o nome do pacote demétricas e a conexão da origem de dados ao armazenamento de métricas. Para umnovo armazenamento de métricas, forneça também as informações necessárias parainicializar o banco de dados, incluindo as datas de abertura e encerramento do anofiscal.

Antes de Iniciar

Para criar pacotes de métricas, você deve ter permissões de execução para orecurso protegido de Administração do Metric Studio e permissões de acesso àhierarquia para a função protegida de Administração.

Procedimento

1. No IBM Cognos Connection, clique no botão Novo Pacote de Métricas .2. Digite um nome e uma descrição para o aplicativo do Metric Studio que

representará esse pacote de métricas e clique em Avançar.3. Clique em Nova origem de dados.4. Digite um nome e uma descrição da conexão de origem de dados para o

armazenamento de métricas onde esteja o conteúdo para este pacote e cliqueem Avançar

5. Na caixa Tipo, clique no tipo de banco de dados.6. Selecione o nível de isolamento e clique em Avançar.7. Especifique as informações solicitadas para o seu tipo de banco de dados.

v Se estiver usando um banco de dados Microsoft SQL Server:a. Digite o nome do servidor de banco de dados. Por exemplo,

server_name ou server_name\instance_name se houver diversasinstâncias doMicrosoft SQL Server. Se você não estiver usando o númeroda porta padrão 1433, use server_name,port.

b. Digite o nome do banco de dados.c. Selecione Conexões.


d. Selecione as caixas de seleção Senha e Criar uma conexão que o grupoTodos possa usar, e digite o ID e senha da conta do usuário com acessoao banco de dados.

A conta de usuário deve ter inglês como o idioma padrão definido.v Se estiver usando um banco de dados Oracle:

a. Insira a sequência de conexões.b. Selecione ID do Usuário.c. Selecione as caixas de seleção Senha e Criar uma conexão que o grupo


d. Opcionalmente, configure uma conexão JDBC para origem de dadosincluindo um tipo de conexão de ID de Serviço, e especificando osvalores necessários para o nome do servidor, número da porta e ID deserviço do Oracle nos campos apropriados. Se estiver usando AIX, umaconexão JDBC é necessária.

v Se estiver usando um banco de dadosIBM DB2:a. Insira o nome do banco de dados conforme definido no cliente do IBM

DB2.b. Selecione ID do Usuário.c. Selecione as caixas de seleção Senha e Criar uma conexão que o grupo


d. Opcionalmente, configure uma conexão JDBC para origem de dadosincluindo nome do servidor, número da porta e nome do banco dedados nos campos apropriados. Se estiver usando AIX, uma conexãoJDBC é necessária.

Na maioria dos casos não é necessária uma sequência de ordenação. Sedesejar fornecer uma, certifique-se de que o valor digitado é o mesmo que asequência de ordenação especificada quando o banco de dados foi criado.Para obter informações sobre sequências de ordenação, consulte adocumentação do banco de dados.

Dica: Para testar se os parâmetros estão corretos, clique em Testar a conexão.8. Clique em Avançar e depois em Concluir.9. Clique na nova origem de dados e depois em Avançar.

10. Clique em Avançar e siga os prompts para fornecer as informações necessáriaspara inicializar o banco de dados. Ao aparecer a página que resume osdetalhes da origem de dados e as configurações do armazenamento demétricas, clique em Inicializar.

11. Selecione Abra este pacote com o Metric Studio após encerrar o assistente eclique em Concluir.

Resultados

O Metric Studio se abre e o novo pacote de métricas aparece no IBM CognosConnection.


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.

Caso pretenda instalar o IBM Cognos Metrics Manager e compartilhar recursoscom o gateway do IBM Cognos BI, instale o gateway em um sistema de 32 bits.Para obter mais informações, consulte “Instalando o Gateway para IBM CognosMetrics Manager” na página 180.

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 o gateway para os componentes do IBM Cognos Metrics Manager, se

necessáriov 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

Instalações de 64 bits


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.

Antes de Iniciar



Cognos BI, pare o serviço do IBM Cognos.



2. Configure a variável de ambiente JAVA_HOME para apontar para o local dainstalaçã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.








exporte PATH







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 17, “Usando instalação e configuração não assistidas”, napágina 431).


Se você estiver instalando nos sistemas operacionais Linux e recebermensagens de erro sobre bibliotecas openmotif ausentes, poderá usar umainstalação não assistida com o comando issetupnx.


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



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

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.








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


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

Instalando o Gateway para IBM Cognos Metrics ManagerSe estiver instalando o IBM Cognos Metrics Manager com o servidor IBM CognosBI e quiser compartilhar recursos, você deverá instalar o Gateway para o IBMCognos Metrics Manager no mesmo local do Gateway para o servidor IBM CognosBI. Se quiser que seu produto de scorecard opere independentemente do servidorIBM Cognos BI, instale o Gateway para IBM Cognos Metrics Manager em um localdiferente do Gateway para o servidor IBM Cognos BI.








Antes de Iniciar




./issetup










Antes de Iniciar











Antes de Iniciar










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

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


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.

Ative o Gateway da Web de 32 bits em uma Instalação de 64 bitsSe você instalou a versão de 64 bits do IBM Cognos BI, mas estiver usando umservidor da web de 32 bits, você deve mover manualmente os arquivos de gatewayde 32 bits em seu diretório de instalação.

Se você instalou a versão de 32 bits do IBM Cognos BI, a versão de 32 bits dogateway é instalada por padrão.

Procedimento1. Acesse c10_location/cgi-bin.2. Digite o seguinte comando:

v Nos sistemas operacionais UNIX ou Linux, digite ./copyGateMod.sh 32bit

v Em sistemas operacionais Windows, digite copyGateMod.bat 32bit

Resultados

Os arquivos de gateway de 32 bits são copiados do diretório cgi-bin/lib para odiretório cgi-bin.

Nota: Se você precisar restaurar os arquivos de gateway de 64 bits padrão, siga oprocedimento e digite ./copyGateMod.sh 64bit ou copyGateMod.bat 64bit. Osarquivos de gateway de 64 bits são copiados do diretório cgi-bin/lib64 para odiretório cgi-bin.

Use 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 Gateway de Servlet Java se você usar um servidor de aplicativo

diferente do Apache Tomcat padrão

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_PATH


v Em HP-UX, SHLIB_PATH e LD_LIBRARY_PATHv No AIX, LIBPATH


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



</Directory>



</Directory>



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.


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.


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.



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




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.


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 Gerenciadorde Servidor, selecione IIS, e depois dê um clique direito no nome do seuservidor e clique em Gerenciador do Internet Information Services (IIS).




7. Expanda Sites e em seu website, inclua os diretórios virtuais conformemostrado na tabela:


Alias Local




8. Selecione o diretório virtual cgi-bin que você criou.9. Clique duas vezes em Mapeamentos do Manipulador.

10. Em 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:

Se você implementar o IBM Cognos em um servidor de aplicativos diferente doTomcat, poderá usar o gateway de servlet para entregar as páginas de portal emvez de usar um servidor da web.

Antes de Iniciar

Assegure-se de que as seguintes tarefas sejam 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 do IBM Cognos BI são instalados no mesmo

sistema que o servidor de aplicativos.v Os Componentes da Camada de Aplicativos do IBM Cognos BI e o Content

Manager estão instalados e em execução no ambiente.v A conta do usuário do servidor de aplicativos possui permissão de acesso total

para a instalação do IBM Cognos.

Sobre Esta Tarefa

Em vez de roteamento de solicitações diretamente para o dispatcher, vocêimplementa o gateway de servlet em uma instância JVM diferente das instânciasJVM que executam os Componentes da Camada de Aplicativos do IBM Cognos BIe os servlets do Content Manager. Fazer esse tipo de implementação separa ocarregamento para entregar conteúdo estático a partir 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.7. Ative o SSL, se necessário.

Resultados

Agora é possível acessar componentes do IBM Cognos usando o gateway deservlet inserindo 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 Gateways 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


servidor da web sejam especificados para a propriedade ServerName.4. Inclua o seguinte:



</Directory>



</Directory>



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 o 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 serviços da web de 32 e 64 bits.


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.


Procedimento




são ativados.c. Se CGI estiver configurado como Não Instalado, selecione CGI e clique

em Incluir Serviço de Função.4. Se você estiver usando o Microsoft Windows 2012 Server, use as etapas a




d. Expanda Desenvolvimento de Aplicativo.e. Selecione CGI se ainda não estiver selecionado e clique em Avançar.f. Clique em Instalar.


são ativados.d. Expanda Recursos de Desenvolvimento de Aplicativo.e. Se CGI não estiver selecionado, selecione CGI.f. Clique em OK.







7. Dê um clique duplo em Restrições de 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, tal 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:


Alias Local




13. Selecione o diretório virtual cgi-bin que você criou.14. Clique duas vezes em Mapeamentos do Manipulador.15. Em Ações, clique em Incluir Mapeamento de Módulo.

a. Em Caminho de Solicitação, digitecognos.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 do CGI inserindo http://servername/ibmcognos em 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:


Alias Local 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 IBM HTTP Server ou Servidor Apache:

No IBM HTTP Server ou servidor Apache, você deve incluir diretivas para seuarquivo de configuração do servidor, e em seguida, configurar o acesso dediretório.

Procedimento

1. No diretório webserver_location/conf, abra o arquivo httpd.conf em umeditor de texto.

2. Remova o comentário das diretivas que carregam modules/mod_dav.so emodules/mod_dav_fs.so.LoadModule dav_module modules/mod_dav.soLoadModule dav_fs_module modules/mod_dav_fs.so

3. Forneça um local para a diretiva DAVLockDB.Por exemplo,DAVLockDB "webserver_location/var/DavLock"

Certifique-se de que o diretório exista.4. Crie um alias para o diretório no qual as imagens são armazenadas.5. Inclua Dav On nas informações <Directory> para o alias.

Por exemplo,Alias /images "path/shared_images"

<Directory "path/shared_images">Dav OnOptions Indexes MultiViews


AllowOverride NoneOrder allow,denyAllow from all

</Directory>

6. Salve o arquivo.7. Reinicie o servidor da web.

Resultados


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



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.







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 do mouse no diretório ou diretório virtual no qualincluiu regras 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


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.


Capítulo 7. Instalação e configuração de ferramentas demodelagem para relatórios e scorecards

Após você instalar e configurar os componentes do servidor IBM Cognos BusinessIntelligence, é possível instalar e configurar os seguintes componentes demodelagem para relatório e scorecard:__ v Framework Manager__ v Metric Designer

Instalando e Configurando o IBM Cognos Framework ManagerÉ possível instalar o IBM Cognos Framework Manager, a ferramenta demodelagem de metadados para IBM Cognos Business Intelligence para relatórios,no mesmo computador que outros componentes do IBM Cognos BI ou em umcomputador diferente. Todos os arquivos requeridos são copiados em umcomputador. Definições padrão são utilizadas para a configuração. É possívelalterar essas configurações padrão se for necessário ou se você instalar oFramework Manager em um computador separado do IBM Cognos BI.

Se tiver atualizado de uma versão anterior do Framework Manager, utilize osmesmos modelos e projetos que utilizou com a versão anterior. Para atualizarprojetos existentes, abra-os na nova versão do Framework Manager.

Se estiver atualizando o Framework Manager de uma versão anterior, desinstaleprimeiro essa versão anterior do Framework Manager . Para obter maisinformações, consulte Capítulo 18, “Desinstalando o IBM Cognos BI”, na página439.

Antes de instalar o Framework Manager, feche todos os programas que estãoatualmente em execução para garantir que os programas de instalação copiemtodos os arquivos necessários para seu computador.

Além disso, certifique-se de ter privilégios de administrador para o computadorWindows no qual está instalando. Se você não for um administrador, peça aoadministrador de seu sistema para incluí-lo no grupo Administrador de seucomputador. Privilégios de administrador também são necessários para a contautilizada para executar o Framework Manager.

Instale e configure todos os componentes do servidor IBM Cognos BI antes deinstalar o Framework Manager.

Instale em um diretório que contenha apenas caracteres ASCII no nome docaminho. Alguns servidores não aceitam caracteres que não sejam ASCII em nomesde diretórios. A instalação do Framework Manager no diretório que possui umapóstrofo no nome do caminho pode resultar em uma abertura incorreta.

Se você estiver instalando a ferramenta de modelagem no mesmo diretório do IBMCognos BI e não parar os serviços do IBM Cognos, será solicitado que você façaisso durante a instalação.

Para ajudar a gerenciar, compartilhar e proteger diferentes versões dos metadados,é possível configurar o Framework Manager para utilizar um sistema de controle


de fontes externo. Para obter mais informações, consulte a seção sobre a utilizaçãodo controle do armazenamento externo no Framework Manager User Guide.

Requisitos do sistema para o Framework Manager

Antes de instalar o Framework Manager, certifique-se de que o computadorWindows atenda aos requisitos de software e hardware do IBM Cognos BI. Otamanho de seus modelos determina os requisitos de hardware, como espaço emdisco.

A tabela a seguir lista os requisitos mínimos de hardware e software para executaro Framework Manager.

Tabela 45. Requisito do Sistema para Framework Manager


Sistema operacional Windows

RAM Mínimo: 512 MB

Ideal: 1 GB

Espaço em disco Mínimo: 500 MB de espaço livre na unidade que contém odiretório temporário usado pelo IBM Cognos BI

Banco de Dados O software do cliente de banco de dados instalado nomesmo computador que o Framework Manager (apenasOracle, DB2 ou Sybase. Os drivers do Microsoft SQL sãoinstalados com o IBM Cognos BI por padrão)

Configuração da conectividade do banco de dados

Outro Microsoft Data Access Component (MDAC) 2.6 ouposterior para uso com amostras de produto

Para ajudar a gerenciar, compartilhar e proteger diferentes versões dos metadados,é possível configurar o Framework Manager para utilizar um sistema de controlede fontes externo. Para obter mais informações, consulte a seção sobre a utilizaçãodo controle do armazenamento externo no Framework Manager User Guide.

Configurações padrão para o Framework ManagerA tabela a seguir lista as configurações padrão para as portas e URIs do IBMCognos BI usados pelo Framework Manager.

Tabela 46. Configurações Padrão para Framework Manager

Componente Padrão Descrição

Gateway http://localhost:80/ibmcognos/cgi-bin/cognos.cgi

O URI para o gateway doIBM Cognos BI



O URI do dispatcher

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

Depois da instalação, é possível utilizar a ferramenta de configuração para alteraras configurações padrão. Também é possível alterá-las editando o arquivocogstartup.xml no diretório c10_location\configuration.


Instalando o Framework ManagerPara obter uma instalação completa do IBM Cognos Business Intelligence, vocêdeve instalar o Cognos Framework Manager em um computador com Windows.

O Framework Manager é um aplicativo de 32 bits. Se você instalá-lo em umsistema operacional de 32 bits, é impossível instalá-lo no mesmo local doscomponentes do servidor do IBM Cognos BI de 32 bits ou em outro local. Se vocêinstalá-lo em um sistema operacional de 64 bits, é impossível instalá-lo no mesmolocal dos componentes do servidor do IBM Cognos BI de 64 bits. Você deveinstalá-lo em outro local.

Procedimento1. Se necessário, pare o serviço do IBM Cognos.

Esta etapa apenas será necessária, se você estiver instalando no mesmo localem que os componentes do servidor IBM Cognos BI de 32 bits estão instaladose você desejar instalar o Framework Manager no mesmo local.

2. Inicie o programa de instalação.v Insira o disco do produto.

Se o assistente de instalação não abrir automaticamente, acesse o diretório dosistema operacional e dê um clique duplo no arquivo issetup.exe.

v Acesse o local para onde você transferiu por download e extraiu os arquivosde instalação e, em seguida, dê um clique duplo no arquivo issetup.exe.


4. Siga as instruções do assistente de instalação e copie os arquivos necessáriospara seu computador.

5. Quando notificado com uma mensagem de informação sobre como instalar aDocumentação Sobre os Idiomas Complementares, clique em OK

A Documentação Sobre os Idiomas Complementares contém versões traduzidasde Recomendações para Metadados de Modelagem. Se você desejar que este guiaesteja disponível em idiomas além do inglês, instale o conteúdo do disco. Casocontrário, a instalação incluirá apenas a versão em inglês do guia.

6. Na última página do assistente de instalação, selecione Iniciar o IBM CognosConfiguration para configurar o Cognos Framework Manager imediatamente.É possível optar por configurar o Cognos Framework Manager posteriormenteiniciando a ferramenta de configuração a partir do menu Iniciar do Windows.

7. Proteja o diretório de instalação contra acesso não autorizado.

O que Fazer Depois

Definições padrão são utilizadas para a configuração. É possível alterar essasconfigurações padrão durante a instalação, ou posteriormente, para melhoradequar ao seu ambiente.

Configurar Variáveis para Conexões de Origem de Dados parao Framework Manager

As ferramentas de modelagem do IBM Cognos BI criam e gerenciam metadados. OFramework Manager cria e gerencia metadados para as funções de relatório. Comoos metadados são obtidos de origens de dados em ambientes multiplataforma e

Capítulo 7. Instalação e configuração de ferramentas de modelagem para relatórios e scorecards 199

multilíngue, há vários fatores que devem ser analisados antes de configurar oambiente de origens de dados para o Framework Manager. Geralmente, issodepende da outra tecnologia utilizada para suas origens de dados ou deimportação.

Se você fez upgrade de uma versão anterior do Framework Manager, não seránecessário configurar nada no ambiente de origem de dados. É necessárioconfigurar o ambiente de origem de dados somente se o Framework Manager foiinstalado em um local diferente da versão anterior.


Para obter mais informações sobre conexões de origem de dados, consulte o Guiade Administração e Segurança do IBM Cognos.


Execute as seguintes etapas no local em que instalou o Framework Manager.







v No DB2, configure a variável de ambiente DB2CODEPAGE como um valor de1252.Para obter mais informações sobre o uso dessa variável de ambienteopcional, consulte a documentação do DB2.


2. No Oracle, inclua $ORACLE_HOME/lib para sua variável LD_LIBRARY_PATH.Quando você configurar os caminhos de biblioteca de carregamento,assegure-se de que as bibliotecas Oracle de 32 bits estejam no caminho deprocura da biblioteca, que geralmente é o diretório $ORACLE_HOME/lib ou odiretório $ORACLE_HOME/lib32 se você instalou um cliente Oracle de 64 bits.




v S_TABU_DIS



v S_USER_GRP


v S_RS_COMP


v S_RS_COMP1


v S_RS_HIER


v S_RS_ICUBE




Propriedades do Ambiente para Computadores comFramework Manager

Quando instala o Framework Manager em um computador diferente doscomponentes de não modelagem do IBM Cognos BI, você deve configurá-lo parase comunicar com os outros componentes.

Se você instalar o Framework Manager no mesmo computador que oscomponentes de não modelagem do IBM Cognos BI, não será necessária nenhumaconfiguração se vocêv Configurar o servidor web utilizando os diretórios virtuais padrão.v Utilizar as portas padrão.v Utilizar os recursos padrão.v Utilizar as configurações de criptografia padrão.

Se o IBM Cognos BI foi instalado em mais de um local, certifique-se de que todosos URIs apontem para a versão correta do IBM Cognos BI. O Framework Managerdeve ser configurado para usar a mesma versão do IBM Cognos BI.

Instalações com um firewall

Quando a ferramenta de modelagem estiver fora de um firewall de rede queproteja o Application Tier Components, podem surgir problemas de comunicaçãocom o dispatcher. Para evitar problemas de comunicação, pode-se instalar aferramenta de modelagem na mesma camada de arquitetura que o Application TierComponents ou pode-se instalar e configurar um gateway que fique dedicado àscomunicações da ferramenta de modelagem.

Para obter mais informações sobre a ferramenta de modelagem e firewalls de rede,consulte “Considerações sobre Firewall” na página 25.

As etapas neste tópico descrevem como configurar a ferramenta de modelagem docomputador quando este estiver dentro ou fora do firewall da rede.

Para obter mais informações sobre como configurar o computador de gatewaydedicado, consulte “Configuração de propriedades de ambiente e de segurançapara computadores de gateway” na página 183.

Pré-requisitos

Certifique-se de que o serviço do IBM Cognos em pelo menos um computadorcom Content Manager esteja em execução. Isso garante que o serviço daautoridade de certificação emita um certificado para o computador com oFramework Manager.

Certifique-se de que o servidor web esteja configurado e em execução .

Configure também as origens de dados antes de configurar o Framework Manager.

Configurando o Framework Manager no Firewall de RedeUse as seguintes etapas para a comunicação entre o Framework Manager e osoutros componentes do IBM Cognos Business Intelligence quando o FrameworkManager estiver dentro de um firewall de rede.


Procedimento1. No computador no qual você instalou o Framework Manager, inicie o IBM

Cognos Configuration.2. Na janela Explorer, clique em Ambiente.3. Na janela Propriedades, na caixa URI do gateway, digite o valor adequado.

v Se o seu servidor da web foi configurado para o gateway ISAPI, substituacognos.cgi por cognosisapi.dll.

v Se o seu servidor da web foi configurado para usar módulos Apache, use aseguinte sintaxe:http://host_name:port/ibmcognos/cgi-bin/module_alias

v Se o servidor foi configurado para usar o gateway de servlet, use a seguintesintaxe:http[s]://host_name:port/context_root/servlet/Gateway

4. Altere a parte do nome do host da URI do gateway de localhost para oendereço IP ou o nome do host do computador onde o componente de gatewayestá instalado.

5. Especifique o valor para o URI do dispatcher para aplicativos externosdigitando o URI do servidor onde os Application Tier Components estãoinstalados.Esse valor será o mesmo da propriedade URI do dispatcher interno em seucomputador com Application Tier Components.

6. Na janela Explorer, em Criptografia, clique em Cognos, o provedor decriptografia padrão.

7. No grupo de propriedadesConfiguração da autoridade de certificação, napropriedade Senha digite a mesma senha configurada no computador padrãoativo com Content Manager.


Configurando o Framework Manager Fora do Firewall de RedeUse as seguintes etapas para configurar a comunicação entre o FrameworkManager e os outros componentes do IBM Cognos Business Intelligence quando oFramework Manager usar um gateway dedicado e estiver fora do firewall de rede.

Procedimento1. Configure um gateway dedicado para o Framework Manager.2. No gateway dedicado, no IBM Cognos Configuration, altere a propriedade

URIs do dispatcher para o gateway para o URI do dispatcher no servidor noqual os Componentes da Camada de Aplicativos estão instalados.Esse valor será o mesmo da propriedade URI do dispatcher interno em seucomputador com Application Tier Components.

3. No computador no qual você instalou o Framework Manager, inicie o IBMCognos Configuration.

4. Na janela Explorer, clique em Ambiente.5. Na janela Propriedades, na caixa URI do gateway, digite o valor apropriado

para o servidor que está sendo usado como o gateway dedicado.v Se o seu servidor da web foi configurado para o gateway ISAPI, substitua

cognos.cgi por cognosisapi.dll.v Se o seu servidor da web foi configurado para usar módulos Apache, use a

seguinte sintaxe:http://host_name:port/ibmcognos/cgi-bin/module_alias



6. Altere a parte do localhost da URI do gateway para o endereço IP ou o nomedo host do servidor de gateway dedicado.

7. Especifique o valor para o URI do dispatcher para aplicativos externosdigitando o URI do dispatcher interno no servidor em que os Application TierComponents estão instalados.Certifique-se de alterar o nome do host no URI do localhost.

8. Na janela Explorer, em Criptografia, clique em Cognos, o provedor decriptografia padrão.

9. No grupo de propriedadesConfiguração da autoridade de certificação, napropriedade Senha digite a mesma senha configurada no computador padrãoativo com Content Manager.


Resultados

O Framework Manager é configurado para se comunicar com os outroscomponentes do IBM Cognos BI. Se tiver instalado o Framework Manager em umcomputador com sistema operacional Microsoft Windows Vista, você deveráatualizar as propriedades do local do arquivo em computadores Windows Vista.

Teste a Instalação do Framework ManagerÉ possível testar a configuração iniciando o aplicativo e criando um projeto.

Procedimento

Para iniciar o Framework Manager, no menu Iniciar, clique em Programas > IBMCognos 10 > Framework Manager.No Microsoft Windows 8 ou Windows 2012 Server, dê um clique duplo no íconeFramework Manager no painel Iniciar.Pode surgir um aviso para atualização se a versão do esquema do modelo foranterior à versão suportada atualmente.Se a página Bem-vindo do Framework Manager for exibida, a instalação estáfuncionando.

Instalação e configuração do Metric DesignerÉ possível instalar o Metrics Designer, a ferramenta de modelagem de metadadospara o IBM Cognos Metrics Manager, no mesmo computador que os componentesdo IBM Cognos BI ou em um computador diferente. Todos os arquivos requeridossão copiados em um computador. Definições padrão são utilizadas para aconfiguração. No entanto, você pode querer alterar essas configurações padrão secondições existentes tornarem as opções padrão impróprias ou se você tiverinstalado o IBM Cognos BI em um computador diferente.

Se tiver atualizado de uma versão 2.0 ou mais recente do Metrics Manager, utilizeos mesmos extrações e projetos que utilizou com a versão anterior. Para atualizarprojetos existentes, abra-os na nova versão do Metric Designer e redefina asconexões de origens de dados e outras referências.


O Metric Designer está disponível apenas como instalação de 32 bits. Ele deve serinstalado em um computador com sistema operacional Microsoft Windows de 32bits.

Requisitos do sistema para o Metric Designer

Antes da instalação do Metrics Designer, certifique-se de que o computadorWindows atenda aos requisitos de software e de hardware do IBM Cognos BI. Otamanho dos determina os requisitos de hardware, como espaço em disco.

A tabela a seguir lista os requisitos mínimos de hardware e software para executaro Metric Designer.

Tabela 47. Requisitos do Sistema para Metric Designer


Sistema operacional Windows (interface de design)

Sistema operacional UNIX (apenasmecanismo):

Sun Solaris HP-UX IBM AIX

RAM Mínimo: 512 MB

Ideal: 1 GB

Espaço em disco Mínimo: 500 MB de espaço livre na unidadeque contém o diretório temporário

Outro Microsoft Data Access Component (MDAC)2.6 ou posterior para uso com amostras deproduto

Para instalar e configurar o Metric Designer, siga estas etapas:__ v Instale componentes do Metric Designer.__ v Configure o cliente do banco de dados para o armazenamento de métricas.__ v Configure as propriedades do ambiente para o Metric Designer.__ v Configure o ambiente de origem de importação para o Metrics Designer__ v Teste a instalação do Metric DesignerInformações relacionadas:“Distribuindo Componentes do Metric Designer” na página 30Para o Metric Studio, se você desejar definir e carregar métricas a partir de origensde dados relacionais e dimensionais, incluindo cubos, pacotes do FrameworkManager ou Impromptu Query Definitions (arquivos .iqd), instale o MetricDesigner para extrair os dados.

Configurações padrão para o Metric DesignerA tabela a seguir lista as configurações padrão para as portas e URIs que sãoutilizados pelo Metric Designer.

Tabela 48. Configurações Padrão para Metric Designer



O URI do gateway


Tabela 48. Configurações Padrão para Metric Designer (continuação)




O URI do dispatcher

Após a instalação, é possível usar o IBM Cognos Configuration para alterar asconfigurações padrão. Também é possível alterá-las editando o arquivocogstartup.xml no diretório c10_location\configuration.

Instalação do Metric DesignerUtilize as seguintes etapas para instalar o Metric Designer.

Certifique-se de ter privilégios de administrador para o computador MicrosoftWindows no qual está instalando. Se você não for um administrador, peça aoadministrador de seu sistema para incluí-lo no grupo Administrador de seucomputador.

Se você estiver instalando a ferramenta de modelagem no mesmo diretório do IBMCognos BI e não parar os serviços do IBM Cognos, será solicitado que você façaisso durante a instalação.

Instale em um diretório que contenha apenas caracteres ASCII no nome docaminho. Alguns servidores não aceitam caracteres que não sejam ASCII em nomesde diretórios.

Antes de Iniciar

Antes de instalar o Metric Designer, feche todos os programas que estãoatualmente em execução para garantir que os programas de instalação copiemtodos os arquivos necessários para seu computador.

Antes da configuração do Metrics Designer, outros componentes do IBM Cognos BIdevem ser instalados e configurados e o Metrics Designer deve ser instalado.

Instale e configure também o aplicativo de destino, onde carregará dados oumetadados.



v Insira o disco do Metric Designer.Se o assistente de instalação não abrir automaticamente, acesse o diretório dosistema operacional e clique duas vezes em issetup.exe.

v Acesse o local em que os arquivos de instalação foram baixados e extraídos eclique duas vezes em issetup.exe.

3. Selecione o idioma para executar o assistente de instalação.4. Siga as instruções do assistente de instalação e copie os arquivos necessários

para seu computador.5. Na página Concluir do assistente de instalação, faça o seguinte:




v Se os componentes do servidor estão configurados, você pode selecionarIniciar IBM Cognos Configuration para configurar o Metric Designer.Se os componentes do servidor não estão configurados, limpe a caixa deseleção.É possível iniciar o IBM Cognos Configuration usando o atalho IBM CognosConfiguration do menu Iniciar.


Resultados

Para garantir a segurança e a integridade do IBM Cognos BI, é importante protegero diretório de instalação contra acesso desautorizado e inadequado.

Configurando o Cliente de Banco de Dados para oArmazenamento de Métricas

Se você estiver usando um banco de dados diferente do Microsoft SQL como umarmazenamento de métricas, deverá instalar o software do cliente de banco dedados e os drivers do Java Database Connectivity (JDBC) em todos oscomputadores em que instalar o Metric Designer. Fazer isso permite ao MetricDesigner acessar o banco de dados de armazenamento de métricas.

Configurar o Cliente de Banco de Dados para umArmazenamento de Métricas do IBM DB2Use esse procedimento para configurar o cliente de banco de dados para umarmazenamento de métricas do IBM DB2. Fazer isso permite ao Metric Designeracessar o banco de dados de armazenamento de métricas.

Procedimento1. Instale o software cliente IBM DB2 em seu computador com Metric Designer.2. Se o armazenamento de métricas estiver em um computador diferente,

configure um alias do banco de dados para o armazenamento de métricasexecutando o IBM DB2 Client Configuration Assistant.

Nota: Se o banco de dados de armazenamento de métricas e o Metric Designerestiverem no mesmo computador, o nome do armazenamento de métricas setornará automaticamente o alias.




Configurando o Cliente de Banco de Dados para umArmazenamento de Métricas do OracleSe usar um banco de dados Oracle para o armazenamento de métricas, vocêdeverá configurar o driver de banco de dados e o utilitário no computador comMetrics Designer.



ORACLE_HOME/jdbc/lib.2. Copie ojdbc5.jar para o diretório c10_location/webapps/p2pd/WEB-INF/lib no

computador em que o Metric Designer está instalado.O driver está disponível a partir de um cliente Oracle ou uma instalação doservidor e pode ser transferido por download do website da Oracle.

3. Instale o utilitário SQL Loader no computador com Metric Designer.

Configurar o Cliente de Banco de Dados para umArmazenamento de Métricas do Microsoft SQL ServerSe usar um banco de dados do Microsoft SQL Server para o armazenamento demétricas, você deverá configurar o utilitário de banco de dados no computadorcom Metrics Designer.

Procedimento

Instale o utilitário bcp no computador com Metric Designer.

Configurando o Metric DesignerSe você instalar o Metric Designer em um computador diferente de outrosservidores IBM Cognos, deverá configurá-lo para se comunicar com os servidoresIBM Cognos.


Quando a ferramenta de modelagem estiver fora de um firewall de rede queproteja o Application Tier Components, podem surgir problemas de comunicaçãocom o dispatcher. Para evitar problemas de comunicação, pode-se instalar aferramenta de modelagem na mesma camada de arquitetura que o Application TierComponents ou pode-se instalar e configurar um gateway que fique dedicado àscomunicações da ferramenta de modelagem.

Para obter mais informações sobre a ferramenta de modelagem e firewalls de rede,consulte “Considerações sobre Firewall” na página 25.

As etapas neste tópico descrevem como configurar a ferramenta de modelagem docomputador quando este estiver dentro ou fora do firewall da rede.

Para obter mais informações sobre como configurar o computador de gatewaydedicado, consulte “Configuração de propriedades de ambiente e de segurançapara computadores de gateway” na página 183.

Configurar o Metric DesignerUse as etapas a seguir para configurar o Metric Designer para comunicação com osservidores IBM Cognos.

Procedimento1. No computador no qual você instalou o Metrics Designer, inicie o IBM Cognos

Configuration.2. Na janela Explorer, clique em Ambiente.3. Na janela Propriedades, na caixa URI do gateway, digite o valor adequado:





4. Altere a parte do nome do host da URI do gateway de localhost para oendereço IP ou o nome do host do computador onde o componente de gatewayestá instalado.



Resultados

O Metrics Designer é configurado para se comunicar com outros componentes doIBM Cognos BI.

Configurar Variáveis para suas Fontes de Importação paraMetric Designer

As ferramentas de modelagem do IBM Cognos BI criam e gerenciam metadados. OMetric Designer cria e gerencia metadados necessários para as funções descorecard. Como os metadados são obtidos de origens de dados em ambientesmultiplataforma e multilíngue, há vários fatores que devem ser analisados antes deconfigurar o ambiente de importação de origens para o Metric Designer.Geralmente, isso depende da outra tecnologia utilizada para suas origens de dadosou de importação.


Para obter mais informações sobre conexões de origem de dados, consulte o Guiade Administração e Segurança do IBM Cognos.

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. Para obtermais informações, consulte “Instalando Fontes de Idioma Adicionais” na página228.

Use as seguintes etapas para configurar origens de importação do Metrics Designerpara Oracle, DB2 ou SAP BW.


v No Oracle, configure a variável de ambiente NLS_LANG (Suporte ao IdiomaNacional) em cada computador em que o Metric Designer ou os


Componentes da Camada de Aplicativos para o IBM Cognos MetricsManager estão instalados, digitando o seguinte comando:NLS_LANG = language_territory.character_set






2. No Oracle, inclua $ORACLE_HOME/lib para sua variável LD_LIBRARY_PATH.Quando você configura os caminhos da biblioteca de carregamento, assegure-sede que as bibliotecas Oracle de 32 bits estejam no caminho da procura debibliotecas, que geralmente é o diretório ORACLE_HOME/lib. Se você instalou ocliente Oracle 10g de 64 bits, as bibliotecas de 32 bits estarão no diretórioORACLE_HOME/lib32.



v S_TABU_DIS



v S_USER_GRP


v S_RS_COMP

Defina o campo Activity com o valor padrão.Configure o campo Área de Informações como Nome Técnico da InfoArea.Configure o campo Cubo de Informações com o valor: Nome Técnico do Cubode Informações.


Defina o campo Name (ID) of reporting components com o valor padrão.Defina o campo Type of reporting components com o valor padrão.

v S_RS_COMP1


v S_RS_HIER


v S_RS_ICUBE



Teste a Instalação do Metric DesignerÉ possível testar a configuração iniciando o aplicativo e criando um projeto.

Procedimento

Para iniciar o Metric Designer, no menu Iniciar, clique em Programas > IBMCognos 10 > Metric Designer.No Microsoft Windows 8 ou Windows 2012 Server, dê um clique duplo no íconeMetric Designer no painel Iniciar.Se a página Bem-vindo do Metric Designer for exibida, a instalação estáfuncionando.



Capítulo 8. Instalar e Configurar Componentes Opcionais

Os componentes opcionais fornecem funcionalidade estendida para os usuários.

Após você instalar e configurar os componentes do servidor IBM Cognos BusinessIntelligence e as ferramentas de modelagem, é possível instalar os seguintescomponentes opcionais.v IBM Cognos Transformerv Documentação do produto traduzidav Fontes adicionais para símbolos monetários japoneses e coreanosv IBM Cognos BI for Microsoft Office

IBM Cognos TransformerÉ possível instalar o IBM Cognos Transformer, a ferramenta de modelagem demetadados para criar PowerCubes para uso com o IBM Cognos BI, no mesmocomputador que outros componentes do IBM Cognos BI ou em um computadordiferente. É possível instalar o IBM Cognos Transformer no mesmo computador doIBM Cognos Series 7 Transformer.

O Transformer pode ser disponibilizado mais facilmente para especialistas emnegócios que querem projetar modelos e construir PowerCubes para uso próprio.Por exemplo, os departamentos de TI podem fornecer a especialistas de negócio oumodeladores do Transformer um programa de instalação baseado na web pode sertransferido de um portal corporativo ou seguro, permitindo a fácil distribuição dosarquivos de instalação.

Definições padrão são utilizadas para a configuração. É possível alterar asconfigurações padrão se necessário ou se você instalar o IBM Cognos Transformerem um computador separado do IBM Cognos BI.

IBM Cognos Transformer e Sistemas de 64 Bits

O IBM Cognos Transformer está disponível apenas em uma versão de 32 bits. Osrequisitos de instalação são como se segue:v Utilitário do sistema operacional UNIX e Linux para a construção de

PowerCubesEsse componente pode ser instalado em um sistema de 64 bits, mas em umdiretório separado dos componentes do IBM Cognos BI de 64 bits. Por exemplo,os componentes de 64 bits são instalados no /ibm/cognos/c10_64 por padrão. Oscomponentes de 32 bits são instalados no /ibm/cognos/c10.

v IBM Cognos Transformer ClientEsse componente deve ser instalado em um computador Windows. Deve estarem um sistema de 32 bits ou em um diretório separado dos componentes doIBM Cognos de 64 bits em um sistema de 64 bits.

Tarefas para Instalar e Configurar o IBM Cognos Transformer

Para instalar e configurar o IBM Cognos Transformer, execute estas tarefas:__ v Instale o IBM Cognos Transformer


__ v Revise as configurações padrão__ v Configure o IBM Cognos Transformer__ v Configure o ambiente de origem de dados para o Transformer__ v Teste a instalação do IBM Cognos Transformer

Instalando o IBM Cognos TransformerInstale o Transformer se pretende criar PowerCubes para usar com o IBM CognosBI.

O idioma que você seleciona no assistente de instalação determina o idioma dainterface com o usuário do assistente de instalação e do IBM Cognos Transformer.Todos os idiomas disponíveis são instalados.

Com um sistema operacional UNIX ou Linux, a instalação do IBM CognosTransformer não fica completa até você instalar também o IBM CognosTransformer em um computador com o sistema operacional Microsoft Windows.Todos os componentes são instalados nos dois ambientes e depois é possível usaros recursos e ferramentas adequados a cada ambiente. Por exemplo, o cliente IBMCognos Transformer fornece uma interface gráfica com o usuário para projetarmodelos em computadores Windows. Em seguida, você constrói cubos em seucomputador UNIX ou Linux. Os modelos que contêm uma origem de dados IQDnão são suportados no Linux.

Instale em um diretório que contenha apenas caracteres ASCII no nome docaminho. Alguns servidores não aceitam caracteres que não sejam ASCII em nomesde diretórios.

Antes de instalar o IBM Cognos Transformer, feche todos os programas que estãoatualmente em execução para garantir que o programa de instalação copie todos osarquivos obrigatórios em seu computador.

Se estiver instalando no Windows, certifique-se de ter privilégios de administradorpara o computador Windows no qual está instalando. Se você não for umadministrador, peça ao administrador de seu sistema para incluí-lo no grupoAdministrador de seu computador.

Nota: Quando o Transformer for instalado no Windows Vista, se você não tiverprivilégios de Administrador no computador e fizer mudanças no arquivocogtr.xml, o arquivo atualizado será salvo por padrão em um diretório do VirtualStore, e não no diretório c10_location/configuration.

Você deve instalar e configurar todos os componentes do servidor IBM Cognos BIantes de instalar o IBM Cognos Transformer.


Informações relacionadas:“Distribuindo Componentes do Transformer” na página 27O Transformer pode ser instalado em um computador contendo outroscomponentes do IBM Cognos BI ou em um computador separado de outroscomponentes do IBM Cognos BI. Quando instalado separadamente, o Transformerpode ser usado como um produto independente ou pode ser configurado para secomunicar com outros componentes do IBM Cognos BI.

Requisitos do Sistema para IBM Cognos TransformerAntes de você instalar o IBM Cognos Transformer, certifique-se de que ocomputador atenda aos requisitos de software e hardware do IBM Cognos BI. Otamanho dos PowerCubes determina os requisitos de hardware, como espaço emdisco.

A tabela a seguir lista os requisito mínimos de hardware e de software para aexecução do IBM Cognos Transformer.

Tabela 49. Requisitos do Sistema para Transformer


Sistema operacional Windows

UNIX: Sun Solaris, HP-UX, IBM AIX

Linux

RAM Mínimo: 512 MB

Ideal: 4 GB

Espaço em disco Mínimo: 500 MB de espaço livre na unidadeque contém o diretório temporário usadopelo IBM Cognos BI

Origem de dados Software do cliente de banco de dadosinstalado no mesmo computador do IBMCognos Transformer

Configuração da conectividade do banco dedados

Outro Microsoft Data Access Component (MDAC)2.6 ou posterior para uso com amostras deproduto

Instalando o IBM Cognos Transformer nos SistemasOperacionais UNIX ou LinuxUse as seguintes etapas para instalar o IBM Cognos Transformer em sistemasoperacionais UNIX ou Linux.

Procedimento1. Se estiver instalando a partir de um download, acesse o local em que os

arquivos de instalação foram baixados e extraídos.2. Se estiver instalando a partir de um disco, monte o disco de modelagem do

IBM Cognos Transformer usando extensões de arquivo Rock Ridge.Para montar o disco em HP-UX, faça o seguinte:v Adicione o diretório pfs_mount no caminho.


Capítulo 8. Instalar e Configurar Componentes Opcionais 215

exporte PATH

v Para iniciar os daemons NFS necessários e executar os daemons no plano defundo, digite bg pfs_mountd e digite bg pfsd






4. Selecione o idioma para utilizar na instalação.O idioma que você seleciona no assistente de instalação determina o idioma dainterface com o usuário do assistente de instalação e do IBM CognosTransformer. Todos os idiomas disponíveis são instalados.


Dica: O componente Series 7 IQD Bridge não é suportado no Linux e HP-UXItanium.




seleção das Notas sobre o Release do IBM Cognos.v Não configure o Transformer imediatamente porque é necessário realizar

outras tarefas antes para garantir que o ambiente esteja devidamenteconfigurado. Certifique-se de que a caixa de seleção IBM CognosConfiguration esteja limpa.É possível configurar posteriormente o Transformer usando o IBM CognosConfiguration digitando cogconfig.sh no diretório c10_location/bin64.

v Clique em Concluir.8. Crie uma variável de ambiente MANPATH e configure-a com o seguinte valor:

/c10_location/webcontent/documentation/en/cogtr_a.html

O documento cogtr_a.html fornece a sintaxe para as opções da linha decomandos UNIX que são suportadas pelo IBM Cognos Transformer. A manpage para o IBM Cognos Transformer está acessível no UNIX digitando cogtrman a partir do diretório c10_location/bin64.

Instalando o IBM Cognos Transformer em Sistemas OperacionaisWindowsUse as seguintes etapas para instalar o IBM Cognos Transformer nos sistemasoperacionais Microsoft Windows.


Procedimento1. Execute um dos seguintes procedimentos:

v Insira o disco de modelagem do IBM Cognos Transformer.Se o assistente de instalação não for aberto automaticamente, acesse odiretório do sistema operacional e clique duas vezes em issetup.exe.


2. Selecione o idioma para utilizar na instalação.O idioma que você seleciona no assistente de instalação determina o idioma dainterface com o usuário do assistente de instalação e do IBM CognosTransformer. Todos os idiomas disponíveis são instalados.





seleção das Notas sobre o Release do IBM Cognos.v Não configure o Transformer imediatamente porque é necessário realizar

outras tarefas antes para garantir que o ambiente esteja devidamenteconfigurado. Certifique-se de que a caixa de seleção IBM CognosConfiguration esteja limpa.É possível iniciar o IBM Cognos Configuration usando o atalho IBM CognosConfiguration do menu Iniciar.


Configurações Padrão para IBM Cognos TransformerA tabela a seguir lista as configurações padrão para portas e URIs do IBM CognosBI que são usados pelo IBM Cognos Transformer.

Tabela 50. Configurações Padrão para Transformer



O URI para o gateway doIBM Cognos BI



O URI do dispatcher

Depois da instalação, é possível utilizar a ferramenta de configuração para alteraras configurações padrão. Também é possível alterá-las editando o arquivocogstartup.xml no diretório c10_location\configuration.

Comunicação entre os Componentes Transformer e BusinessIntelligence

Você deve configurar o IBM Cognos Transformer para se comunicar com os outroscomponentes do IBM Cognos BI.


As instruções deste tópico destinam-se ao instalador ou administrador. Se você foro modelador ou especialista de negócios do Transformer que deseja fazerdownload e utilizar o Transformer, consulte “Implementando IBM CognosTransformer para Modeladores” na página 226

Se o IBM Cognos BI foi instalado em mais de um local, certifique-se de que todosos URIs apontem para a versão correta do IBM Cognos BI. O Transformer deve serconfigurado para usar a mesma versão do IBM Cognos BI.


Quando a ferramenta de modelagem estiver fora de um firewall de rede queproteja o Application Tier Components, podem surgir problemas de comunicaçãocom o dispatcher. Para evitar problemas de comunicação, pode-se instalar aferramenta de modelagem na mesma camada de arquitetura que o Application TierComponents ou pode-se instalar e configurar um gateway que fique dedicado àscomunicações da ferramenta de modelagem. Para obter mais informações sobre aferramenta de modelagem e firewalls de rede, consulte “Considerações sobreFirewall” na página 25.

As etapas deste tópico descrevem como configurar o computador de ferramentasde modelagem. Se estiver utilizando um gateway dedicado à ferramenta demodelagem, configure também o computador de gateway . Para obter maisinformações, consulte “Instalação e configuração do gateway” na página 177.

Configurar Computadores com IBM Cognos TransformerVocê deve configurar o IBM Cognos Transformer para se comunicar com outroscomponentes do IBM Cognos BI.

Se você instalar o IBM Cognos Transformer no mesmo computador que oscomponentes de não modelagem do IBM Cognos BI, nenhuma configuração seránecessária se vocêv Configurar o servidor web utilizando os diretórios virtuais padrão.v Utilizar as portas padrão.v Utilizar os recursos padrão.v Utilizar as configurações de criptografia padrão.

Antes de Iniciar

Instale e configure componentes do IBM Cognos BI antes de configurar o IBMCognos Transformer. Primeiro você deve instalar e configurar o Content Manager edepois iniciar o serviço do IBM Cognos em pelo menos um computador comContent Manager antes de configurar o IBM Cognos Transformer. Isso garante queo serviço de autoridade de certificação emita um certificado para o computadorcom IBM Cognos Transformer.

Certifique-se de que o servidor web esteja configurado e em execução .

Para suportar o uso de origens de dados do IBM Cognos BI (incluindo pacotes erelatórios) no Transformer, assegure-se de que o cliente de banco de dados estejainstalado no computador em que o Transformer está instalado.

Procedimento1. No computador no qual instalou o IBM Cognos Transformer, inicie o IBM

Cognos Configuration.


2. Na janela Explorer, clique em Ambiente.3. Na janela Propriedades, na caixa URI do gateway, digite o valor adequado.




4. Altere a parte do nome do host da URI do gateway de localhost para oendereço IP do computador ou para o nome do computador.


6. No menu Arquivo, clique em Salvar.O IBM Cognos Transformer é configurado para se comunicar com os outroscomponentes do IBM Cognos BI.

7. Se você instalou o Transformer em um computador Windows Vista, ou sealgum componente do IBM Cognos BI estiver instalado em um computadorWindows Vista, atualize as propriedades do local do arquivo:a. Faça logon como administrador.b. No diretório c10_location\configuration, abra cogtr.xml.sample em um

editor de texto.c. Localize todos os valores que usam um caminho relativo, “..\directory”.d. Substitua o elemento de caminho relativo, “..”, pela mesma variável de

ambiente e diretório raiz usados para locais de arquivos nos outroscomputadores com IBM Cognos BI.

e. Salve o arquivo como cogtr.xml.f. No diretório c10_location\CS7Gateways\bin, abra cs7g.ini em um editor de

texto.g. Inclua os locais para as origens de dados do IBM Cognos Series 7 no

arquivo.h. Salve o arquivo.

As mudanças são aplicadas na próxima vez que abrir o Transformer.

Origens de Dados e TransformerAs ferramentas de modelagem do IBM Cognos BI criam e gerenciam metadados. OIBM Cognos Transformer cria e gerencia metadados para PowerCubes. Comometadados são derivados de origens de dados em ambientes multiplataformas oumultilíngues, há várias coisas que você deve considerar ou fazer ao configurar umambiente de origem de dados para o IBM Cognos Transformer. Geralmente, issodepende da outra tecnologia utilizada para suas origens de dados ou deimportação.

Se os usuários operando em diferentes idiomas se conectarem a uma origem dedados do Microsoft Analysis Services (MSAS) 2000, você deverá criar umainstância separada do IBM Cognos BI para cada idioma.



Para obter mais informações sobre conexões a origens de dados, consulte o Guia deadministração e segurança.

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. Para obtermais informações, consulte “Instalando Fontes de Idioma Adicionais” na página228.Informações relacionadas:“Distribuindo Componentes do Transformer” na página 27O Transformer pode ser instalado em um computador contendo outroscomponentes do IBM Cognos BI ou em um computador separado de outroscomponentes do IBM Cognos BI. Quando instalado separadamente, o Transformerpode ser usado como um produto independente ou pode ser configurado para secomunicar com outros componentes do IBM Cognos BI.

Configuração do ambiente de origem de dados para oTransformerUse estas etapas para configurar origens de dados do Oracle ou SAP BW para oIBM Cognos Transformer.









2. Para o Oracle, adicione $ORACLE_HOME/lib ao caminho da biblioteca.Quando os caminhos de biblioteca de carga forem definidos, certifique-se deque as bibliotecas Oracle de 32 bits estejam no caminho de procura de


biblioteca, que geralmente são os diretórios $ORACLE_HOME/lib ou$ORACLE_HOME/lib32, se foi instalado um cliente Oracle de 64 bits.



v S_TABU_DIS



v S_USER_GRP


v S_RS_COMP


v S_RS_COMP1


v S_RS_HIER


v S_RS_ICUBE




Testar sua Instalação do TransformerÉ possível testar a configuração iniciando o aplicativo e criando um modelo.

Procedimento

Para iniciar o IBM Cognos Transformer, no menu Iniciar, clique em Programas >IBM Cognos 10 > IBM Cognos Transformer.No Microsoft Windows 8 ou Windows 2012 Server, dê um clique duplo no íconeIBM Cognos Transformer no painel Iniciar.Para iniciar o IBM Cognos Transformer manualmente, dê um clique duplo noarquivo cogtr.exe no diretório c10_location\bin.Se vir a janela Transformer, a instalação está funcionando.

Tarefas de Configuração Adicionais para IBM CognosTransformer

Depois de instalar o Transformer, é possível executar essas tarefas:v Se você instalou o Transformer em um computador Windows Vista e pretende

usar o arquivo cogtr.xml.samples como um modeloAtualize preferências padrãopara o Windows Vista

v Se quiser usar modelos do Transformer do IBM Cognos Series 7 e quisercontinuar usando origens de dados IQD,Inclua origens de dados do IBM CognosSeries 7 no Transformer

Para tornar o Transformer disponível para instalação e uso de modeladores,execute as seguintes tarefas:v Crie um local de instalação de rede para modeladores do Transformerv Exporte dados de configuração para modeladores do Transformerv Implemente IBM Cognos BI Transformers para modeladores

Atualizando Preferências Padrão para Windows VistaCom aprimoramentos de segurança no Windows Vista, o Microsoft alterou aestrutura dos diretórios do usuário. Se quiser utilizar o arquivo cogtr.xml.samplescomo modelo, edite as configurações de preferências padrão. Se desejar que todosos usuários tenham os mesmos diretórios padrão, altere as preferências padrãopara um local comum ao qual os usuários tenham acesso. Se você quiser que osusuários tenham diretórios do Windows Vista, é possível excluir as preferênciaspadrão para os diretórios.


Procedimento1. Faça logon como administrador.2. No diretório c10_location\configuration, abra cogtr.xml.sample em um editor de

texto no modo elevado clicando com o botão direito do mouse no editor detexto e selecionando Executar como Administrador.


3. Se deseja que todos os usuários tenham os mesmos diretórios padrão, mude osdiretórios para uma localização à qual todos os usuários tenham acesso deleitura e gravação.Os diretórios para a mudança são os seguintes:v <Preference Name="CubeSaveDirectory" Type="string" Value="..\temp"/>

v <Preference Name="DataSourceDirectory" Type="string"Value="..\temp"/>

v <Preference Name="DataWorkDirectory" Type="string" Value="..\temp"/>

v <Preference Name="LogFileDirectory" Type="string" Value="..\logs"/>

v <Preference Name="ModelSaveDirectory" Type="string" Value="..\temp"/>

v <Preference Name="ModelWorkDirectory" Type="string" Value="..\temp"/>

4. Se quiser que os usuários tenham os diretórios padrão do Windows Vista,exclua as preferências especificadas na etapa 3 do arquivo.Os diretórios padrão do Windows Vista para o Transformer sãov CubeSaveDirectory

Documents\Transformer\PowerCubesv DataSourceDirectory

No IBM Cognos Configuration, sob a propriedade Ambiente, Local dosArquivos de Dados

v DataWorkDirectoryNo IBM Cognos Configuration, sob a propriedade Ambiente, Local dosArquivos Temporários

v LogFileDirectoryDocuments\Transformer\Logs

v ModelSaveDirectoryDocuments\Transformer\Models

v ModelWorkDirectoryNo IBM Cognos Configuration, sob a propriedade Ambiente, Local dosArquivos Temporários

5. Altere as outras configurações conforme a necessidade.6. Salve o arquivo como cogtr.xml.


Incluindo Origens de Dados do IBM Cognos Series 7 noTransformerCaso pretenda usar modelos do Transformer e origens de dados do IBM CognosSeries 7, você deverá incluir o local das origens de dados do IBM Cognos Series 7no arquivo de gateway do Transformer.


Procedimento1. Faça logon como administrador.2. No diretório local_c10/CS7Gateways/bin, abra o aquivo cs7g.ini em um editor

de texto.


No Windows Vista, abra-o no modo elevado clicando com o botão direito domouse no editor de texto e selecionando Executar como Administrador.

3. Inclua os locais para as origens de dados do IBM Cognos Series 7 no arquivo.4. Salve o arquivo.


Criação de uma localização de instalação de rede paramodeladores do TransformerSua empresa pode ter negócios especializados ou usuários de poder que podemcriar PowerCubes modelados em uma combinação de origens de dados pessoais ecorporativos. Esses usuários podem fazer sua própria análise dos dados para sualinha de negócio ou pequeno grupo de usuários. Um instalador ou administradorpode fazer o download de um arquivo executável para um local da Web ou LANno qual modeladores possam executar o arquivo para iniciar o assistente deinstalação do IBM Cognos Transformer.


Antes de Iniciar

Antes de tornar o arquivo de instalação disponível para modeladores doTransformer, outros recursos ou permissões devem ser configurados:v O software do cliente de banco de dados está instalado, ou disponível para os

modeladores instalarem, em computadores com o Transformer que são usadospara acessar origens de dados do IBM Cognos BI ou origens de dados IQD doIBM Cognos Series 7.

v Modeladores devem ter privilégios para criar uma origem de dados no IBMCognos Administration.Modeladores não precisam de acesso direto ao IBM Cognos Administration. Elespodem criar e atualizar origens de dados utilizando o ferramentas doTransformer ou de linhas de comandos. É possível fornecer aos modeladoresuma pasta protegida no IBM Cognos Connection na qual publicar pacotes doPowerCube.

v Os modeladores devem ter acesso a uma localização na qual armazenarPowerCubes depois de criá-los.Esse local também deve estar acessível para o serviço do IBM Cognos e pode serum compartilhamento protegido em uma LAN.

v Para criar PowerCubes em um servidor Transformer específico, os modeladoresdevem ter privilégios de FTP para transferir modelos e executar privilégios paracriar cubos nesse servidor.Os modeladores podem transferir modelos e executar criações de cuboutilizando scripts. Os modeladores podem também utilizar métodosautomatizados para criar PowerCubes. Para obter mais informações, consulte oGuia de administração e segurança.

Procedimento1. Insira o disco para o produto de modelagem do IBM Cognos Transformer.2. Se a página Bem-vindo do assistente de instalação aparecer, saia do assistente.3. No disco, localize o arquivo C8transformerinstall.exe.


4. Copie o arquivo para uma localização segura na qual os modeladores doTransformer tenham acesso.

Dados de Configuração para Modeladores do TransformerSe deseja tornar o arquivo de instalação do Transformer disponível para osmodeladores do Transformer, os modeladores precisarão das configurações dodispatcher e de criptografia para configurar o Transformer em seu computadorlocal. É possível exportar a configuração de um computador com Transformer parauso com todos os outros computadores com Transformer. Os modeladores podemcopiar o arquivo de configuração exportado para seu diretório de instalação doTransformer e, em seguida, executar o comando para configurar o computador doTransformer no modo silencioso.


Se tiver atualizado o coglocale, cogtr.xml, ou os arquivos cs7g.ini no computadordo Transformer, copie esses arquivos para a localização da web ou LAN para queos modeladores do Transformer possam fazer o download deles para seuscomputadores.

Para exportar a configuração, o computador de origem deve ter os mesmoscomponentes do IBM Cognos BI que os computadores com modelador doTransformer “Comunicação entre os Componentes Transformer e BusinessIntelligence” na página 217. Se alguns modeladores forem instalados no WindowsVista, você deverá criar um arquivo de exportação a partir de um computador comWindows Vista. Sugerimos a criação de pastas separadas em um local da Web ouLAN para Windows e Windows Vista.

Exportando a Configuração do Transformer:

Use o IBM Cognos Configuration para exportar a configuração de um computadorcom o Transformer para usar com todos os outros computadores com oTransformer.

Procedimento

1. No IBM Cognos Configuration, no menu File, clique em Exportar como.2. Se desejar exportar a configuração atual para uma pasta diferente, na caixa

Procurar em, localize e abra a pasta.Certifique-se de que a pasta esteja protegida de acesso inadequado ou nãoautorizado.

3. Na caixa Nome de arquivo, digite um nome para o arquivo de configuração.4. Clique em Salvar.5. Renomeie o arquivo exportado para cogstartup.xml.6. Copie o arquivo cogstartup.xml exportado do computador de origem para a

mesma localização de web e LAN que o arquivo de instalação do Transformer.7. Se tiver alterado a configuração global no computador de origem, copie o

arquivo coglocale.xml do computador de origem para a mesma localização daweb ou LAN que o arquivo de instalação do Transformer.A localização padrão do arquivo coglocale.xml é local_c10/configuration.


Copiando Arquivos de Configuração Atualizados do Transformer:

Se tiver atualizado determinados arquivos de configuração, você deverá copiá-losno mesmo local do arquivo de instalação do Transformer.

Procedimento

1. Se tiver atualizado o arquivo cogtr.xml, copie-o do diretóriolocal_c10/configuration para a mesma localização web ou LAN do arquivo deinstalação do Transformer.

2. Se tiver atualizado o arquivo cs7g.ini, copie-o do diretório local_c10/CS7Gateways/bin para a mesma localização web ou LAN do arquivo deinstalação do Transformer.

Implementando IBM Cognos Transformer para ModeladoresSe for o especialista em negócio ou modelador do Transformer, implante agora oTransformer para poder criar PowerCubes e publique-os em usuários ou gruposselecionados.

Se não tiver concluído a instalação, siga as etapas para instalar o Transformer. Paraconfigurar o Transformer para que ele possa se comunicar com os dispatchers doIBM Cognos BI, siga as etapas para configurar o Transformer.

Para suportar o uso de origens de dados do IBM Cognos BI (incluindo pacotes erelatórios) no Transformer, certifique-se de que o cliente de banco de dados estejainstalado no computador com o Transformer.

Instalação do Transformer:

Como um especialista em negócios ou modelador do Transformer, use as seguintesetapas para instalar o Transformer a partir de um local da Web ou LAN fornecidopelo administrador.

Procedimento

1. Da localização da web ou LAN que o administrador forneceu, execute oarquivo C8transformerinstall.exe.O conteúdo é expandido para o diretório Documents and Settings\username\Local settings\Temp e o assistente de instalação do Transformer é aberto.


Dica: O componente Series 7 IQD Bridge não é suportado no Linux e HP-UXItanium.

3. Na página Concluir do assistente, selecione Exibir as notas sobre a liberação eem Concluir.

4. Crie uma variável de ambiente MANPATH e configure-a com o seguinte valor:/c10_location/webcontent/documentation/en/cogtr_a.htmlO documento cogtr_a.html fornece a sintaxe para opções da linha de comandosdo UNIX que são suportadas pelo IBM Cognos Transformer. A man page parao IBM Cognos Transformer fica acessível no UNIX digitando-se cogtr man nodiretório c10_location/bin.


Configuração do Transformer:

Como um especialista em negócios ou modelador do Transformer, use as seguintesetapas para configurar o Transformer.

Procedimento

1. Vá para a mesma localização da web ou LAN que o arquivo de instalação doTransformer.

2. Se algum arquivo .xml estiver presente, copie-o no diretórioTransformer_location\configuration, em que Transformer_location é o diretórioonde o Transformer está instalado.O local padrão é C:\Program Files\Cognos\c10.

3. Se um arquivo .ini estiver presente, copie-o no diretório Transformer_location\CS7Gateways\bin.

4. Acesse o diretório Transformer_location\bin.5. Digite o comando de configuração:

./cogconfig.bat -sO IBM Cognos Configuration aplica as definições de configuração especificadasna cópia local do cogstartup.xml, criptografa credenciais, gera certificadosdigitais e inicia os serviços do IBM Cognos.

6. Para testar o IBM Cognos Transformer, no menu Iniciar, clique em Programas> IBM Cognos 10 > Transformer.Se vir a janela Transformer, a instalação está funcionando.

7. Depois que o Transformer estiver instalado e em execução com sucesso, excluaos arquivos de instalação que foram extraídos do arquivo de instalação.

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.

Instalando Fontes de Idioma AdicionaisPara incluir o suporte para o caractere do iene japonês ou do won coreano, vocêdeverá instalar fontes adicionais a partir do disco IBM Cognos BI SupplementaryLanguage Documentation.

O ponto de código Unicode “U+005C” é designado oficialmente para a barrainvertida. Entretanto, no Japão e na Coréia, esse código é atribuído historicamenteaos símbolos de moeda e muitas pessoas ainda preferem ver um sinal de iene ouwon em determinadas partes do software, por exemplo em caminhos de arquivo.Para acomodar isso, é possível instalar as fontes “Andale WT J” e “Andale WT K”.

Antes de Iniciar

Antes de instalar as fontes adicionais, certifique-se de que as seguintes condiçõesforam atendidas:v O IBM Cognos está instalado e configurado corretamente.v Há espaço em disco adequado disponível para instalar as fontes adicionais. Você

precisa de pelo menos 220 MB de espaço em disco.v O seu ambiente de software é suportado.

Procedimento1. No local onde Componentes da Camada de Aplicativos estão instalados, insira

o disco IBM Cognos BI Supplementary Language Documentation.Nos sistemas operacionais UNIX ou Linux, monte o disco usando as extensõesde arquivos Rock Ridge.

2. Acesse o diretório do disco correspondente ao sistema operacional utilizado.3. Inicie o assistente de instalação digitando o seguinte comando:

v No Windows, issetupv No UNIX ou Linux, ./issetup

Nota: Quando você usa o comando issetup com XWindows, os caracteresjaponeses poderão ficar corrompidos.


4. Siga as instruções do assistente de instalação para copiar os arquivos solicitadosna mesma localização onde instalou o Application Tier Components.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.Ao ser solicitado para selecionar componentes, desmarque IBM CognosBusiness Intelligence Supplementary Languages Documentation, expandaFontes de Idioma Adicionais e, em seguida, selecione a fonte.Essas fontes são copiadas para o diretório c10_location/bin/fonts. Esse localda fonte é definido no valor da propriedade Local de fontes físicas no IBMCognos Configuration em Ambiente. Se mover as fontes para outro local,verifique se o novo local está adicionado ao valor da propriedade Local defontes físicas.As fontes utilizadas para exibir dados em um relatório são selecionadasutilizando um processo de correspondência entre fontes solicitado quando orelatório é projetado e as fontes que estão disponíveis quando o relatório éproduzido. Para saídas em PDF e gráficos, esse processo ocorre no servidoronde todas as fontes do servidor que gera o relatório podem ser utilizadas.

5. Escolha a opção desejada na página Concluir do assistente de instalação.

Resultados

Após instalar as fontes adicionais, é necessário configurar o suporte para asmesmas. Para obter mais informações, consulte “Configure Suporte para Caracteresdo Iene Japonês e do Won Coreano”.

Configure Suporte para Caracteres do Iene Japonês e do WonCoreano

Para que os caracteres das moedas japonesa e coreana sejam exibidos corretamente,é necessário configurar fontes adicionais na planilha de estilo global.

Antes de Iniciar

Antes de configurar essas fontes, você deve instalá-las a partir do disco IBMCognos BI Supplementary Language Documentation.

Procedimento1. Abra a folha de estilo GlobalReportStyles.css em um editor de texto.

A folha de estilo GlobalReportStyles.css está localizada no diretórioc10_location\bin.

2. Ative uma das seguintes seções e modifique-a, conforme mostrado no seguinteexemplo:/* For Japanese: */.pg.pp{font-family: ’MS UI Gothic’, ’Andale WT J’ , Tahoma, arial, geneva,helvetica, sans-serif;}

/* For Korean: */.pg,.pp


{font-family: Gulim, ’Andale WT K’ , Tahoma, arial, geneva,helvetica, sans-serif;}

O gerador de PDF usa a primeira fonte disponível no servidor e inclui todos oscaracteres na string a ser exibida. Se preferir usar outras fontes em seu servidor,insira-as na lista.

3. Salve o arquivo GlobalReportStyles.css.4. Reinicie o servidor IBM Cognos BI.

Resultados

Quaisquer mudanças feitas na folha de estilo serão sobrescritas se você atualizar oIBM Cognos BI. É necessário repetir este procedimento seguido de umaatualização.

IBM Cognos BI for Microsoft OfficeIBM Cognos BI for Microsoft Office está disponível para implementação com todosos produtos IBM Cognos BI, exceto para o IBM Cognos BI Metrics Manager.

Para configurar e implementar o IBM Cognos BI for Microsoft Office, é possíveldisponibilizar os arquivos de cliente para os usuários instalarem ou é possívelinstalar o cliente nos computadores do usuário, dependendo do seu ambiente.

O IBM Cognos BI for Microsoft Office está disponível como uma instalação de 32bits ou 64 bits.

Para implementar o IBM Cognos BI for Microsoft Office com PowerPlay, é possívelconfigurar mapeamentos de gateway para que os usuários do IBM Cognos BI forMicrosoft Office possam acessar relatórios do PowerPlay que residem em umservidor PowerPlay. Também é possível configurar o tamanho do relatório quepode ser importado do IBM Cognos BI no IBM Cognos BI for Microsoft Office.Para obter informações adicionais sobre os mapeamentos de gateway e limites detamanho de relatório, consulte o Guia de administração e segurança.

Use a seguinte lista de verificação para configurar o IBM Cognos BI for MicrosoftOffice:__ v Copie o IBM Cognos BI para arquivos do Microsoft Office na LAN para

implementação, se necessário.__ v Ative o suporte ao secure sockets layer, se necessário.__ v Ative o acesso a anônimo, se necessário.__ v Implemente o IBM Cognos BI for Microsoft Office para ambientes do cliente.

Copiando Arquivos de Cliente do IBM Cognos BI for MicrosoftOffice em um Local da LAN Central

Antes de os usuários poderem implementar o IBM Cognos BI for Microsoft Officeem seu computador, eles precisam de acesso aos arquivos de instalação. É possívelfornecer aos usuários o disco de instalação que está incluído no IBM Cognos BIPowerPlay ou copiar os arquivos do disco em um local central na LAN ou Website.


Procedimento

No disco IBM Cognos BI for Microsoft Office ou em um diretório onde os arquivosde instalação foram transferidos por download e extraídos, copie os seguintescomponentes no local da LAN:v A pasta KB908002.v O arquivo setup.exe.v O arquivo CognosOfficeSetup.msi.

Resultados

Usuários podem então executar o arquivo setup.exe do local da LAN paraimplementar o IBM Cognos BI for Microsoft Office.

Ative o Suporte SSL para a Interface HTTPS para PowerPlaySe seu ambiente incluir IBM Cognos Series 7 PowerPlay Enterprise Server e vocêestiver usando interface HTTPS para acessar o PowerPlay, você deverá ativar osuporte ao Secure Sockets Layer (SSL). Para ativar o suporte a SSL para o gatewaydo PowerPlay e o dispatcher do IBM Cognos BI, você deve definir uma senha parao keystore do IBM Cognos BI e depois criar e armazenar o certificado Autoridadede Certificação (CA) do servidor da Web no keystore do IBM Cognos BI.

Para obter informações adicionais, consulte “Configurando o Protocolo SSL paraComponentes do IBM Cognos” na página 275.

Ativando Acesso Anônimo para o PowerPlayQuando você usar conexão única com o Microsoft Internet Information Services(IIS), o acesso anônimo deverá ser ativado para os usuários do portal acessaremdocumentos do IBM Cognos BI for Microsoft Office que são baseados em relatóriosdo PowerPlay.

Se for necessário, um segundo gateway do PowerPlay poderá ser usado parafornecer acesso anônimo para o IBM Cognos BI for Microsoft Office. Para obtermais informações, consulte o tópico sobre como especificar mapeamentos degateway no Guia de administração e segurança.

Procedimento1. Em cada computador no qual o Content Manager está instalado, inicie o IBM

Cognos Configuration.2. Na janela Explorer, em Segurança > Autenticação, clique em Cognos.3. Na janela Propriedades, clique na caixa próxima à propriedade Permitir acesso

anônimo e clique em Verdadeiro.4. No menu Arquivo, clique em Salvar.

Implementando o IBM Cognos for Microsoft Office ClientO IBM Cognos for Microsoft Office está disponível para instalação comcomponentes do IBM Cognos BI. Após a instalação e configuração do IBM CognosBI, é possível instalar o IBM Cognos for Microsoft Office nas estações de trabalhodo cliente.

O IBM Cognos for Microsoft Office Client está disponível apenas como umainstalação de 32 bits. Ele deve ser instalado em um computador com Windows de32 bits.


Implementando o IBM Cognos for Microsoft Office emComputadores Clientes

O IBM Cognos for Microsoft Office usa o Microsoft .NET Framework para permitirque os usuários interajam com componentes baseados no servidor. O Microsoft.NET Framework e as atualizações requeridas são transferidos por download einstalados pelo arquivo de configuração quando você instala o IBM Cognos forMicrosoft Office. O arquivo de configuração deve ser executado em todos oscomputadores de usuários.

Para obter uma lista de versões suportadas do Microsoft .NET Framework,consulte o IBM Software Product Compatibility Reports (SPCR)(www.ibm.com/support/docview.wss?uid=swg27037784).

Utilize a seguinte lista de verificação para guiá-lo através do processo deimplementação:v Instalar o .NET Framework e o IBM Cognos for Microsoft Office.

Para obter informações adicionais sobre como instalar o IBM Cognos forMicrosoft Office, consulte o Guia de Instalação do IBM Cognos for MicrosoftOffice.

v Definir o nível de segurança de macro para o Microsoft Office XP, se necessário.v Instalar o certificado de autoridade de certificação para o suporte SSL (camada

de soquetes de segurança), se solicitado.

Definir Nível de Segurança da Macro para o Microsoft Office XPPara os aplicativos Microsoft Office XP executarem o IBM Cognos for MicrosoftOffice, você deve definir o nível de segurança da macro para um nível apropriado.Você deve definir isto para o Microsoft Office Excel, Microsoft Office Word eMicrosoft Office PowerPoint.

Procedimento1. Abra o aplicativo do Microsoft Office XP.2. No menu Ferramentas, clique em Macros e depois em Segurança.3. Escolha se mudar o nível de segurança ou os editores confiáveis.

v Na guia Nível de Segurança, clique em Médio ou Baixo e, em seguida,clique em OK

v Na guia Editores confiáveis, selecione Trust all installed add-ins ortemplates e clique em OK.

Instalar o Certificado de CA para a Interface HTTPS no Series 7PowerPlaySe seu ambiente incluir o IBM Cognos Series 7 PowerPlay Enterprise Server e vocêestiver usando a interface HTTPS (https://) para acessar o Series 7 PowerPlay,você deverá instalar um certificado emitido por uma autoridade de certificação(CA). O certificado de autoridade de certificação (CA) é exigido para o suporte dacamada de soquetes de segurança (SSL).

Procedimento1. Recupere o certificado CA do seu administrador.

O arquivo tem uma extensão .cer.2. Clique duas vezes no arquivo .cer, clique em Instalar Certificado e depois em

Avançar.3. Clique em Place all certificates in the following store.



4. Clique em Browse, clique em Trusted Root Certification Authorities, e depoisclique em Avançar.

5. Clique em Concluir.



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. Entretanto, é possível alterar essasconfigurações padrão se as condições existentes tornarem as opções padrãoinadequadas ou para que se adéquem melhor ao 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. Entretanto, se o console anexado aocomputador UNIX ou Linux no qual você está instalando os componentes do IBMCognos não suportar uma interface gráfica com o usuário baseada em Java, vocêdeverá editar manualmente o arquivo cogstartup.xml no diretórioc10_location/configuration e, em seguida, executar o IBM Cognos Configurationem 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.

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

Fazer Backup das Informações IBM Cognos ExistentesVocê deve fazer backup de informações existentes do IBM Cognos se oscomponentes do IBM Cognos Business Intelligence estiverem em execução em umservidor de aplicativos (incluindo Tomcat) e você estiver mudando para umservidor de aplicativos fornecido com sua própria JVM. Você também deve fazerbackup de informações existentes do IBM Cognos se precisar alterar a JVM queestá usando.

Nota: Você deve fazer backup de informações existentes do IBM Cognos noambiente de trabalho antes da atualização.

Antes de configurar componentes do IBM Cognos BI para a execução no novoservidor de aplicativos ou JVM, você deve 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 uma localização alternativa. Novas chaves

criptográficas devem ser criadas utilizando o mesmo JVM que o servidor deaplicativos utiliza. 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. As chaves criptográficas existem se esse diretórioincluir os subdiretórios a seguir: 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 o 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 Tomcat, pare o serviço do IBM Cognos e feche o IBM CognosConfiguration.

v Se você usar um servidor de aplicativos diferente do Tomcat, encerre o IBMCognos BI em seu ambiente.

4. Faça backup de chaves criptográficas existente salvando arquivos e diretórioscorretos em uma localização alternativa que seja segura.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 nesse arquivo serão automaticamente criptografadas novamenteusando novas chaves criptográficas quando você salvar 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.

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.

Assegure-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, acesse o IBM Software Product CompatibilityReports (SPCR) (www.ibm.com/support/docview.wss?uid=swg27037784). Cliqueno link para a sua versão do Cognos BI e localize as informações das Bibliotecas deTempo de Execução Java.

Capítulo 9. Opções de Configuração 237



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çosv configurar fontesv alterar a fonte padrão para relatóriosv salvar saída de relatório em um sistema de arquivosv alterar o local dos gráficos de mapa para o Report Studiov 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 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.

Tarefas de administração para o Banco de dados de conteúdo do Cognos sãoexecutadas usando um utilitário denominado 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.1.2.1/docs onde você instalou o Bancode dados de conteúdo do Cognos.

Alterando a Senha de Usuário PadrãoSe 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 no qual instalou o Banco de dados de conteúdo do Cognos,

acesse o diretório c10_location/derby10.1.2.1/bin.2. Inicie o utilitário ij usando o arquivo de script ij.bat ou ij.ksh.

O utilitário ij é um utilitário de linha de 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;

Criando um Novo Usuário e SenhaSe 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 no qual instalou o Banco de dados de conteúdo do Cognos,

acesse o diretório c10_location/derby10.1.2.1/bin.2. Inicie o utilitário ij usando o arquivo de script ij.bat ou ij.ksh.3. Conecte-se ao 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 instalou o Cognos Content Database, acesse o diretório

c10_location/derby10.1.2.1/bin.2. Inicie o utilitário ij usando o arquivo de script ij.bat ou ij.ksh.3. Conecte-se ao 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.

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 aplicativosexternos, 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 51. 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 Tomcat é 9300. A porta padrão de umservidor web é 80.

Exemplo: 9300 ou 80

raiz do contexto Usada pelo Tomcat ou um servidor de aplicativos paradeterminar o contexto do aplicativo, para que a solicitaçãopossa ser incorporada ao aplicativo web correto para serprocessada.

Exemplo: p2pd

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/


Tabela 51. Elementos e Descrições da URI do IBM Cognos (continuação)

Elemento Descrição

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

Se você estiver usando a colaboração com o IBM Connections, certifique-se deincluir o domínio completo para todas as entradas do nome do host no IBMCognos Configuration. Por exemplo, se seu computador for nomeado MyComputere o domínio for MyCompanyName.com, para o valor host_name_or_IP, useMyComputer.MyCompanyName.com. O domínio deve ser incluído em ordempara o IBM Connections permitir o acesso. Para obter mais informações, consulte“Modificando o IBM Connections para IBM Cognos BI” na página 347.

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.


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


v definições para um provedor de criptografia em uma infraestrutura deseguranç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 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 algoritmo

Esses 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 Nos computadores que não contêm o Content Manager, se não desejar

armazenar 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 CryptographExtension (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 270.


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

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 em Criptografia e clique emNovo 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.

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, conformelistado na tabela a seguir:

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



Tabela 52. Valores e Descrições das Propriedades de Criptografia (continuação)

Propriedade Descrição

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.

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

Se você estiver usando os recursos de colaboração com o IBM Connections, vocêdeverá incluir o nome do host, domínio e número da porta no qual o IBMConnections está sendo executado na propriedade Domínios e Hosts Válidos parao Cognos Application Firewall.

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.

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

Se estiver usando os recursos de colaboração com o IBM Connections, vocêdeverá incluir o host, domínio e número da porta para o perfil do IBMWebSphere no qual o IBM Connections foi instalado. Por exemplo, seinstalasse o IBM Connections em um computador denominado myserver eseu domínio fosse mycompany.com, você incluiriamyserver.mycompany.com:9080, em que 9080 é o número da porta do IBMWebSphere em que o IBM Connections está em execução.

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

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


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

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


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.

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.

Especificação do 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 em fontes instaladas no diretórioc10_location\bin\fonts do computador IBM Cognos. Se os componentes do IBMCognos estiverem instalados em um computador com sistema operacionalMicrosoft Windows, eles também usarão as fontes instaladas no diretório de fontedo 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 estiver usando um servidor de aplicativos que não o Tomcat, digite ocaminho totalmente qualificado para o local da fonte. Por exemplo:local_c10/bin/fonts.


Mapeamento de fontes suportadas para fontes instaladasÉ possível substituir fontes globais, que não estão instaladas no computador, porfontes físicas.

Mapeie as fontes em cada computador onde o Application Tier Componentsestejam instalados.

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 Query


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


Resultados

Agora, se necessário, especifique a localização de instalação das fontes.

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.



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.

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.

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 formatoarquivo://diretório

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.4. Na propriedade Salvar saídas de relatórios em um sistema de arquivos, clique

em Verdadeiro.5. Para testar a conexão com o diretório de saída de relatório, no menu Ações,

clique em Testar.6. No menu Arquivo, clique em Salvar.

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.

Mudança da localização de gráficos de mapa para o ReportStudio

O IBM Cognos BI é fornecido com um conjunto de gráficos de mapa de amostraque podem ser usados no Report Studio. É possível alterar o local dos gráficos demapa usando o IBM Cognos Configuration.

Por padrão, os gráficos de mapa são armazenados no diretório c10_location/mapsno computador com os Componentes da Camada de Aplicativos.

Para obter mais informações sobre o uso de gráficos de mapas, consulte o Guia dousuário no Report Studio.

Para obter informações sobre o uso de mapas customizados de outras fontes,consulte o Map Manager Installation and User Guide.

Procedimento1. No computador com Componentes da Camada de Aplicativos, inicie o IBM

Cognos Configuration.2. Na janela Explorer, clique em Ambiente.3. Na janela Propriedades, clique no valor para Localização de arquivos de

mapeamento.

4. Clique no botão de edição .5. Na janela Selecionar pasta, navegue para o diretório que deseja e clique em

Selecionar.6. No menu Arquivo, clique em Salvar.


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

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.

Configurando Definições de Diversos ArrendatáriosAntes que seja possível usar a ocupação variada do IBM Cognos, você devemodificar as definições de configuração na instalação do IBM Cognos BusinessIntelligence. As propriedades de diversos arrendatários que você especifica paraum namespace específico substituem quaisquer propriedades de diversosarrendatários que você configura globalmente.

O diagrama a seguir mostra como os recursos de diversos arrendatários Cognos BIisolam o acesso aos objetos em seu armazenamento de conteúdo. Os usuáriospodem acessar apenas os objetos os quais estão autorizados a acessar em cadaagrupamento de arrendatários.

Neste exemplo, os usuários teriam acesso aos objetos a seguir:v Os usuários pertencentes ao Arrendatário 1 podem acessar object_1, object_2 e

object_3.

Figura 11. Armazenamento de Conteúdo Configurado para Usar os Recursos de OcupaçãoVariada do Cognos BI


v Os usuários pertencentes ao Arrendatário 2 podem acessar object_3, object_4,object_5 e object_6.

Dica: O administrador do sistema pode acessar todos os objetos noarmazenamento de conteúdo.

Para configurar diversos arrendatários, você deve executar as tarefas a seguir:1. “Identifique Informações de Ocupação”2. “Ativando Multitenancy” na página 261

Identifique Informações de OcupaçãoAntes que seja possível modificar sua configuração para aplicativos com váriosinquilinos, é necessário identificar como as informações de ocupação(agrupamento) são determinadas em seu ambiente para os usuários individuais.Depois, você associa as informações de ocupação para especificar propriedades demulti-tenancy.

Para identificar informações de ocupação, é possível usar a posição de um usuáriodentro de uma hierarquia, ou é possível usar as propriedades associadas comobjetos de usuário. Também é possível criar código customizado que seja chamadodurante o processo de autenticação de usuário.

Use Hierarquias para Determinar Informações de Ocupação

Uma maneira de determinar informações de ocupação é reutilizar as informaçõesda estrutura do nó dentro de uma hierarquia.

Ao reutilizar as informações da estrutura do nó, é possível usar as informaçõesfornecidas pelo atributo de usuário ancestors, que representam o caminhohierárquico para uma conta de usuário na forma de uma matriz. A tabela a seguirmostra como é possível mapear o atributo ancestors para uma hierarquia paraidentificar as informações de ocupação:

Tabela 54. Atributo Ancestors Mapeado para Informações de Hierarquia

Informações de Ancestors Hierarquia Exemplo de LDAP

ancestors[0] Nó do diretório

ancestors[1] ID do Namespace base DN

ancestors[2] Agrupamento dearrendatário, comopastas

organizational units

Por exemplo, se os usuários estiverem armazenados em um diretório LDAP e oslocatários estiverem diretamente sob o Nome Distinto de Base (DN) comounidades organizacionais, configure a propriedade de ocupação variadaMapeamento de ID de Locatário, Padrão no IBM Cognos Configuration para oseguinte valor:~/ancestors[2]/defaultName

Além do defaultName, os seguintes qualificadores ancestors podem retornarinformações de ocupação:v name/locale, em que código de idioma se baseia no mapeamento na configuração

do namespace. Se nenhum código de idioma for fornecido, o nome será o títulodo objeto. Por exemplo, seria possível especificar:


~/ancestors[2]/name/EN-ca

v searchPath/objectID. Por exemplo, seria possível especificar:~/ancestors[2]/searchPath/objectId

Use Atributos do Objeto para Determinar Informações deOcupação

Se não puder usar a hierarquia de estrutura do nó para determinar as informaçõesde tenancy, será possível usar atributos do objeto específicos a partir de seuprovedor de autenticação. Esse método requer que você também identifiquequaisquer propriedades adicionais para serem consultadas durante o processo deautenticação do usuário.

Por exemplo, se o atributo departmentNumber de um objeto de usuário LDAPidentificar o locatário do usuário, configure a propriedade de ocupação variadaMapeamento de ID de Locatário, Padrão no IBM Cognos Configuration daseguinte forma:~/parameters/parameter_name

Nesse exemplo, você também deve configurar a propriedade LDAP customizada aseguir:parameter_name = departmentNumber

Use Código Customizado para Determinar Informações deOcupação

Quando as informações de ocupação não puderem ser obtidas por meio de umahierarquia ou de um atributo de usuário, você deve criar uma classe customizadaque seja chamada durante o processo de autenticação do usuário para determinaras informações de ocupação. Por exemplo, pode ser necessário juntar dados dediversas fontes de autenticação, ou de uma fonte de autenticação e de um bancode dados relacional.

Nesses casos, você cria uma classe Java customizada usando o kit dedesenvolvimento de software do IBM Cognos e especifica seu nome durante aconfiguração do BI. Neste cenário, configure a propriedade Mapeamento de ID deLocatário, Classe de Provedor no IBM Cognos Configuration da seguinte forma:custom_class_name

em que custom_class_name representa o nome de sua classe customizada. Porexemplo, com.example.Class.

O IBM Cognos Software Development Kit inclue uma classe customizada deamostra para determinar as informações do ocupação. É possível localizar osarquivos de amostra no diretório c10_location\sdk\java\AuthenticationProvider\MultiTenancyTenantProviderSample.

Ativando MultitenancyPara ativar os recursos de ocupação variada do IBM Cognos, você deve configuraras propriedades de autenticação em todos os computadores nos quais o ContentManager está configurado e reiniciar o serviço IBM Cognos.


Antes de Iniciarv Identifique como as informações de arrendatário são determinadas para usuários

individuais no seu ambiente. Para obter informações adicionais, consulte“Identifique Informações de Ocupação” na página 260.

v Compile quaisquer arquivos de classe Java customizados necessários emarquivos JAR e coloque-os no diretório c10_location/webapps/p2pd/WEB-INF/libjuntamente com quaisquer arquivos associados, ou atualize a variável deambiente CLASSPATH para incluir o caminho para esses arquivos. Isso seránecessário apenas se estiver usando o provedor de autenticação Javacustomizado.

v Determine se você deve aplicar as configurações de multitenancy para todos osnamespaces configurados ou para namespaces individuais. As propriedades demultitenancy para um namespace específico fornecem quaisquer propriedadesde multitenancy que são configuradas globalmente. Se um namespace não forconfigurado para usar multitenancy, então políticas e permissões para objetosserão usadas para determinar quem pode acessar os objetos. Se a ocupaçãovariada for aplicada em diversos namespaces, os IDs de arrendatário em todosos namespaces devem ser exclusivos.

Procedimento1. Abra o IBM Cognos Configuration.2. Escolha se deseja definir configurações de ocupação variada globalmente para

todos os namespaces ou para um namespace específico.v Para configurar ocupação variada para todos os namespaces, na janela

Explorer, para a categoria Segurança, clique em Autenticação.v Para configurar ocupação variada para um namespace, na janela Explorer,

para a categoria Segurança, clique em Autenticação. Em seguida, clique nonamespace que deseja configurar.

3. Em Ocupação Variada, clique no botão de edição para a propriedadeMapeamento de ID de Locatário.A caixa Mapeamento de ID de Locatário é exibida.

4. Especifique em uma das propriedades a seguir:v Padrão

Os cenários a seguir lhe ajudarão a especificar valores para essa propriedade.– Para usar as informações de hierarquia, você poderia especificar o

seguinte valor para essa propriedade:~/ancestors[2]/defaultName

Importante: Se você usar namespaces do Active Directory, você tambémdeve configurar a propriedade avançada MultiDomainTree para true paramapear arrendatários para domínios.

– Para usar atributos do objeto específico do provedor de autenticação,como número do departamento (departmentNumber), você poderiaespecificar o seguinte valor para essa propriedade:~/parameters/parameter_name

Importante: Ao configurar essa propriedade para um namespace LDAP,em Mapeamentos de Conta (Avançado), você também deve especificar apropriedade customizada a seguir:

parameter_name para Nome e departmentNumber para Valor.v Classe do provedor


Para usar uma classe Java customizada, você só precisa especificar o nomeda classe Java criada.

5. Na janela Explorer, clique com o botão direito do mouse em Autenticação eclique em Testar. Se a ocupação variada estiver configurada corretamente, seuID de locatário será exibido nos detalhes. Se a ocupação variada não estiverconfigurada corretamente, o ID de locatário não será exibido. Nesse caso,assegure-se de que os valores de propriedade de ocupação variada estejamcorretos e teste novamente.

6. No menu Arquivo, clique em Salvar.7. Reinicie o serviço do IBM Cognos para que as mudanças entrem em vigor.

O que Fazer Depois

Após a ativação da ocupação variada, o administrador do sistema deve configuraras informações de ocupação para os objetos no armazenamento de conteúdo. Paraobter mais informações, consulte Guia de Administração e Segurança.

Para controlar atividades de arrendatário, é possível usar um banco de dados decriação de log.

Desativando Diversas OcupaçõesPara desativar a ocupação variada, você deve remover as propriedades deautenticação de ocupação variada em todos os computadores em que o ContentManager está configurado.

Todos os IDs de locatário devem ser removidos de todos os objetos noarmazenamento de conteúdo. Se todos os IDs do arrendatário não foremremovidos após desativar a ocupação variada, o comportamento do aplicativo seráimprevisível. Para entender completamente os recursos de ocupação variada, testeo sistema antes de ativar a ocupação variada em um ambiente de produção. Adecisão para ativar a ocupação variada deve ser cuidadosamente considerada.

Procedimento1. Abra o IBM Cognos Configuration.2. Escolha se deseja desativar configurações de ocupação variada globalmente

para todos os namespaces ou para um namespace específico.v Para desativar ocupação variada para todos os namespaces, na janela

Explorer, para a categoria Segurança, clique em Autenticação.v Para desativar ocupação variada para um namespace, na janela Explorer,

para a categoria Segurança, clique em Autenticação. Em seguida, clique nonamespace que deseja configurar.

Importante: Se as propriedades de diversas ocupações forem configuradasglobalmente ou individualmente, as propriedades para um namespaceespecífico substituirão quaisquer propriedades globais de diversas ocupações.

3. Em Ocupação Variada, clique no botão de edição para a propriedadeMapeamento de ID de Locatário.A caixa Mapeamento de ID de Locatário é exibida.

4. Exclua os valores para a propriedade Padrão ou Classe de Provedor.Se outras propriedades de ocupação variada específicas do namespace foramespecificadas, elas deverão ser excluídas ou alteradas também. Por exemplo,para namespaces do Active Directory, altere o valor da propriedade avançadaMultiDomainTree para false.


5. Na janela Explorer, clique com o botão direito em Autenticação e clique emTestar. O ID de locatário não deve ser exibido nos detalhes.

6. No menu Arquivo, clique em Salvar.7. Reinicie o serviço do IBM Cognos.

O que Fazer Depois

Depois que diversas ocupações estiverem desativadas, o administrador do sistemadeve revisar e atualizar as políticas nos objetos e, em seguida, atualizar a ocupaçãopara público.

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.

Opção Nome Descrição

-p impressora Especifica a fila deimpressão. Se nenhuma filade impressão forespecificada, a fila padrãoserá usada.

-o orientação Especifica a orientação dapágina de um arquivo, comoretrato ou paisagem. Senenhuma orientação forespecificada, a orientaçãoretrato será usada.


Opção Nome Descrição

-m Mídia Especifica o tamanho damídia de saída, comotamanho carta ou A4. Se amídia, a altura e a larguranão forem especificadas, abandeja de papel padrão seráusada.

-h Altura Para tamanhos de páginacustomizados. Especifica aaltura da página, em pontos.Só será válida se especificadacom a opção -w, sem a opção-m.

-w largura Para tamanhos de páginacustomizados. Especifica alargura da página, empontos. Só será válida seespecificada com a opção -h,sem a opção -m.

-L Arquivo de log Especifica um caminho paraum arquivo especificado pelousuário para a criação de logdas mensagens de erro. Onome de arquivo padrãopara 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 47.

Nota: Se você estiver usando o DB2, não poderá gerar um script para criar obanco de dados de notificação da mesma maneira que o armazenamento deconteúdo.Para DB2 no z/OS, use as instruções no “Configurações Sugeridas para Criarum Banco de Dados de Notificação no DB2 no z/OS” na página 266.

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

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

Configurações Sugeridas para Criar um Banco de Dados deNotificação no DB2 no z/OS

O banco de dados criado para o banco de dados de notificação deve conter asdefinições de configuração especificadas.

Para garantir uma instalação com sucesso, siga as seguintes diretrizes ao criar obanco de dados de notificação.

Use a seguinte lista de verificação para ajudá-lo a configurar o banco de dados denotificação no DB2 no z/OS.__ v Crie uma instância do banco de dados, um grupo de armazenamento e uma

conta de usuário para o banco de dados de notificação.O usuário deve ter permissões para criar e excluir tabelas no banco de dados.O IBM Cognos BI usa as credenciais da conta do usuário para se comunicarcom o servidor de banco de dados.

__ v Certifique-se de reservar um pool de buffer com um tamanho de página de32 k e um segundo com um tamanho de página de 4 k para a instância dobanco de dados.

__ v Os administradores devem executar um script para criar tablespaces paramanter objetos grandes e outros dados para o banco de dados de notificaçãoa fim de usar esses tablespaces.Para obter mais informações sobre como executar o script, consulte “CriandoEspaços de Tabela para um Banco de Dados de Notificação no DB2 paraz/OS”.

__ 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 IBMCognos.Para garantir a segurança e integridade dos bancos de dados, proteja-os deacesso não autorizado ou inadequado.

Criando Espaços de Tabela para um Banco de Dados deNotificação no DB2 para z/OS

Se você estiver usando o DB2 para z/OS, um administrador de banco de dadosdeverá executar scripts para criar um conjunto de espaços de tabela necessáriopara o banco de dados de notificação. Os scripts devem ser alterados parasubstituir os parâmetros de espaço reservado com os adequados a seu ambiente.

Assegure-se de usar as convenções de nomenclatura do DB2 para z/OS. Porexemplo, todos os nomes de parâmetros devem iniciar com uma letra e ocomprimento não deve exceder 6 caracteres. Para obter mais informações, consulteo Centro de Informações do IBM DB2.


Procedimento1. Conecte-se ao banco de dados como um usuário com privilégios para criar e

arrastar tablespaces e para permitir a execução de instruções SQL.2. Para criar os espaços de tabela de notificação, acesse o diretório

c10_location/configuration/schemas/delivery/zosdb2.a. Faça uma cópia de backup do arquivo de script NC_TABLESPACES.sql e salve












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. Em cada local em que o Content Manager ou Componentes da Camada de

Aplicativos estão instalados, inicie o IBM Cognos Configuration.2. Na janela Explorer, em Acesso a dados, clique em Notificação.3. Identifique o banco de dados usado para notificação:

v Na janela Explorer, clique com o botão direito do mouse em Notificação eselecione Novo Recurso > Banco de Dados.

v Digite um nome para o recurso do banco de dados.v Selecione o tipo de banco de dados do menu suspenso.v Clique em OK.


4. Na janela Propriedades, insira os valores para o recurso de banco de dados denotificação.

5. No menu Arquivo, clique em Salvar.6. Teste a notificação. Na janela Explorer, clique com o botão direito em

Notificação e clique em Testar.Esse procedimento testa a conexão 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.

Resultados

Verifique se os valores usados para identificar o recurso do banco de dados denotificação são os mesmos em todos os computadores com Content Manager eApplication Tier Components. Para usar o banco de dados de notificação padrão,não é necessário editar os valores na janela Propriedades.

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.

Procedimento1. No local em que instalou a nova instância do Cognos Content Database, no

diretório c10_location/derby10.1.2.1/bin, use o script ij.bat ou ij.ksh paracriar 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.1 que sãousados para comunicações SSL incluem somente certificados que são qualificadospara o padrão NIST SP800-131a. Você pode alterar os certificados disponíveis paravocê 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.1 incluemsomente certificados de autoridade de certificação (CA) que são qualificados para opadrão NIST SP800-131a. Se utilizar outros certificados, como os certificados de CASHA1 ou 1024-bit, você deve incluir esses certificados no armazenamento confiávelindividualmente. Ou, você inclui esses certificados do armazenamento confiável doJRE 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.

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.


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.

Para usar outro certificado CA, você deve usar o processo a seguir:1. “Criar Arquivos Certificate Signing Request (CSR)” na página 272.

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 2733. “Configurar Componentes do IBM Cognos BI para Usar Certificados Gerados

pelo CA” na página 275.


Algumas tarefas usam uma ferramenta de linha de comandos nomeadaThirdPartyCertificateTool. As tabelas a seguir listam as opções para essaferramenta de linha de comandos.

Tabela 56. Modo principal de operação

Comando Descrição

-c Cria um SAC

-i Importa um certificado

Tabela 57. Modificadores de operação

Comando Descrição

-s Trabalha com a identidade de assinatura

-e Trabalha com a identidade de criptografia

-T Trabalhe com o armazenamento confiável(somente com -i)

Tabela 58. Sinalizadores de Informações

Comando Descrição

-d DN para utilizar para certificado

-r SAC ou localização de arquivo de certificado(depende do modo)

-t Arquivo de certificado de autoridade decertificação (somente com -i)

-p senha de armazenamento de chaves

-a Algoritmo de par de chaves: RSA ou DSA.RSA é o valor padrão.

-D Localização do diretório

Os valores de amostra da tabela a seguir são usados:

Tabela 59. Valores de Amostra

Propriedade Valor

Nome distinto do certificado de assinatura(DN)

Um valor exclusivo, formatado como:

CN=SignCert,O=MyCompany,C=CA

DN de certificado de criptografia Um valor exclusivo, formatado como:

CN=EncryptCert,O=MyCompany,C=CA

senha de armazenamento de chaves A senha padrão: NoPassWordSet

Esse valor deve corresponder às senhas noIBM Cognos Configuration em Segurança >Criptografia > Cognos. Se você alterar osvalores padrão para Senha dearmazenamento de chaves de assinatura,Senha de armazenamento de chaves decriptografia e Senha de armazenamento dechaves de Autoridade de Certificação,certifique-se de usar as senhas que vocêconfigurou.


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.


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 chaves 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, digiteThirdPartyCertificateTool.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 Codificaçã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.



Antes de Iniciar


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


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

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

Se a URI do dispatcher interno for prefixada com http, mas a URI do dispatcherexterno for prefixada com https ou vice-versa, os dois conectores Coyote HTTP/1.1e SSL Coyote HTTP/1.1 diferentes de SSL 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.

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.

Configurar 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 doscomponentes remotos do IBM Cognos 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 da confiança na infraestrutura desegurança do IBM Cognos. Isso se aplica às duas conexões, SSL e não SSL. Sedesejar usar certificados gerenciados por outro serviço, consulte “ConfigurandoComponentes do IBM Cognos para Usar Outra Autoridade de Certificação” napágina 270.

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.Caso use Tomcat, a propriedade URI do dispatcher interno deve tambémespecificar o 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.Caso use Tomcat, a propriedade URI do dispatcher interno deve tambémespecificar o 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 o gateway foi instalado em um computador separado e você estiverusando SSL para conexões externas, no IBM Cognos Configuration nocomputador de gateway, insira https e o número da porta para acomunicação SSL na propriedade URIs do Dispatcher para Gateway.



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.

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.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. O certificado não deve ser um certificado autoassinado, pois oscertificados autoassinados não serão confiáveis para os componentes do IBMCognos. Para obter informações adicionais sobre como usar certificados com oservidor da web, consulte a documentação do servidor da web. Esses certificadosnã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.

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. 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.Tarefas relacionadas:“Configurar Segurança para um Módulo de Amostra do Google OneBox” napágina 445Por padrão, os aplicativos do Google OneBox são abertos e anônimos. Se o seuaplicativo requerer autenticação segura, você deverá configurar o Google SearchAppliance (GSA) e a instalação do IBM Cognos corretamente.

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 o


Content 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 eventos mesmo se outros serviços no computador local, comoo dispatcher, forem 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 adequada

para 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 planejamento, consulte o Guia de Arquitetura eImplementação do IBM Cognos Business Intelligence.

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 naconfiguraçã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 a configuração de criação de log, consulte o Guiade Administração e Segurança do IBM Cognos Business Intelligence.

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.

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

Nota: Se você estiver usando o DB2, não poderá gerar um script para criar obanco de dados de notificação da mesma maneira que o armazenamento deconteúdo.Para DB2 no z/OS, use as instruções no “Configurações Sugeridas para Criarum Banco de Dados de Criação de Log no DB2 no z/OS ” na página 282.

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” na página 283.


v Especifique o repositório das mensagens de log.Utilize as instruções em “Repositório de Mensagens de Log” na página 285.

Configurações Sugeridas para Criar um Banco de Dados deCriação de Log no DB2 no z/OS

O banco de dados criado deve conter as definições de configuração especificadas.

Use a lista de verificação a seguir para ajudar a configurar o banco de dados decriação de log no DB2 no z/OS.__ v Efetue logon no sistema z/OS como usuário com privilégios de administrador

no DB2 no z/OS.__ v Crie uma instância do banco de dados, um grupo de armazenamento e uma

conta de usuário para o armazenamento de conteúdo. O IBM Cognos usa ascredenciais de uma conta do usuário para se comunicar com o servidor debanco de dados.

__ v Verifique se alocou um pool de buffer com tamanho de página de 8 KB para ainstância do banco de dados.

__ v Para um banco de dados de criação de log no DB2 no z/OS, osadministradores devem executar um script de espaço de tabela para criarespaços de tabela para reter maiores objetos e outros dados para o banco dedados de criação de log e, em seguida, conceder ao usuário direitos para atabela. Para obter mais informações sobre como executar o script do espaçode tabela, consulte “Criar Espaços de Tabela para um Banco de Dados deCriação de Log no DB2 no z/OS”.

Criar Espaços de Tabela para um Banco de Dados de Criação deLog no DB2 no z/OSSe você estiver usando o DB2 no z/OS, um administrador de banco de dados deveexecutar um script para criar um conjunto de espaços de tabela necessários para obanco de dados de criação de log. O script deve ser modificado para substituir osparâmetros de espaço reservado com os adequados a seu ambiente.

Certifique-se de usar a convenção de nomenclatura para DB2 no z/OS. Porexemplo, todos os nomes de parâmetros devem iniciar com uma letra e ocomprimento não deve exceder 6 caracteres. Para obter mais informações, consulteo Centro de Informações do IBM DB2.


arrastar tablespaces e para permitir a execução de instruções SQL.2. Acesse o diretório c10_location/configuration/schemas/logging/db2zos.3. Abra o arquivo de script LS_tablespace_db2zOS.sql e use a tabela a seguir para

ajudá-lo a substituir os parâmetros genéricos pelos apropriados para o seuambiente.

Tabela 60. Os nomes de parâmetro de espaço de tabela e as descrições para o banco dedados de criação de log no DB2 no z/OS


IPFSCRIPT_DATABASE O nome do banco de dados de criação delog.

IPFSCRIPT_STOGROUP O nome do grupo de armazenamento.


Tabela 60. Os nomes de parâmetro de espaço de tabela e as descrições para o banco dedados de criação de log no DB2 no z/OS (continuação)


IPFSCRIPT_TABLESPACE O nome do espaço de tabela que contém astabelas base no banco de dados de criaçãode log.

Este tablespace não é para tabelas auxiliares.

IPFSCRIPT_LS_ID O identificador de instância para o banco dedados de auditoria. Este valor não deve sermais longo do que dois caracteres.

IPFSCRIPT_BP O nome do buffer pool de 8 k alocado paraobjetos regulares.

IPFSCRIPT_USERNAME A conta do usuário que acessa o banco dedados de criação de log.

Nem todos os parâmetros listados estão no script, mas podem ser adicionadosno futuro.

4. Salve e execute o script.5. Conceda os direitos de usuário do IBM Cognos aos espaços de tabela criados

ao executar o arquivo de script:v Abra o arquivo de script LS_rightsGrant_db2zOS.sql.v Substitua os valores de parâmetros com os adequados a seu ambiente.

Dica: Certifique-se de que os mesmos valores usados ao criar pools de buffere a conta de usuário estejam sendo usados.

v Salve e execute o script LS_rightsGrant_db2zOS.sql.

Resultados

O banco de dados de criação de log foi criado.

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




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.





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.




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.




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 lidoscomo 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 Repositório de Mensagens de Log para DB2 noUNIX, 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.3. Na janela Propriedades, use a tabela a seguir para ajudar a configurar as

propriedades do servidor de log.


Tabela 61. 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.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. Por


exemplo, é 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 DB2 noz/OSÉ 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. 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.3. Na janela Propriedades, use a tabela a seguir para ajudar a configurar as




Tarefa Ação



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.



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.

4. Na janela Explorer, em Ambiente, clique com o botão direito em Criação deLog e clique em Novo Recurso > Destino.

5. ??Na caixa Nome, digite o nome do repositório.6. Na lista Tipo, clique em Banco de dados e depois em OK.7. Na janela Explorer, em Criação de Log, clique com o botão direito no nome

do banco de dados e clique em Novo Recurso > Banco de Dados.8. ??Na caixa Nome, digite o nome do repositório.9. Na lista Tipo, clique em Banco de dados DB2 e depois em OK.

10. Na janela Propriedades, digite Servidor de banco de dados e número daporta, ID do usuário e senha e Nome do banco de dados z/OS.Verifique se a ID do usuário é igual ao valor especificado no parâmetroIPFSCRIPT_USERNAME no arquivo de script LS_tablespace_db2zOS.sql“Criar Espaços de Tabela para um Banco de Dados de Criação de Log no DB2no z/OS” na página 282.

11. Na janela Explorer, clique em Configuração Local.12. Na janela Propriedades, próxima de Propriedades Avançadas, clique na caixa

Valor e, em seguida, clique no ícone de edição .13. Clique em Adicionar e adicione os seguintes nomes e valores de parâmetros

de configuração:

Tabela 63. Nomes e Valores dos Parâmetros de Configuração

Nome do parâmetro Valor

IPFSCRIPT_CREATE_IN O local das tabelas de base

Por exemplo:NomeBancodedados.baseNomeTablespace.

IPFSCRIPT_STOGROUP O nome do grupo de armazenamento.

IPFSCRIPT_DATABASE O nome do banco de dados de criação delog.

IPFSCRIPT_LS_ID O identificador de instância para o banco dedados de auditoria. Esse valor não deve sermais longo do que dois caracteres.


14. No menu Arquivo, clique em Salvar.15. Teste a conexão ao novo banco de dados. Na janela Explorer, em Ambiente,

clique com o botão direito em 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, oscomponentes do IBM Cognos testarão todos os bancos de dados.

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



Tarefa Ação



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.



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 em Criação deLog 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 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 de 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.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.

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

Antes de Iniciar



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


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


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 sejam


exibidos corretamente, é necessário instalar fontes adicionais do discoSupplementary Languages Documentation.


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.

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 o


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

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.


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.

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.


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.

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

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.

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 da


Web. 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 listado na tabela a seguir.

Tabela 66. Configurações de Cookie

Host Formato do domínio

computador ou servidor nome do computador ou servidor (sempontos)

Exemplo: minhaempresa

os sufixos são .com, .edu, .gov, .int, .mil,.net, ou .org

.name.suffix

(dois pontos)

Exemplo: .minhaempresa.com

outro .name1.name2.suffix

(três pontos)

Exemplo: .infoviagens.co.nz

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 informações adicionais sobre este atributo, consulte IBM Cognos BusinessIntelligence: Guia de Administração e Segurança.

Personalização de configurações de cookiesUse IBM Cognos Configuration para customizar o domínio do cookie, o caminho eo sinalizador seguro.


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, seum 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 daseguinte 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.

Configurando a Procura de Índice do IBM CognosO recurso de procura de índice está incluído no produto do servidor IBM CognosBusiness Intelligence como recurso de procura padrão. Para usar a procura doíndice, é necessário configurar os serviços de indexação e criar pelo menos umíndice. Se o resultado da procura incluir uma URL, a URL deve estar em umdomínio confiável antes que os usuários possam acessá-lo.

Para obter informações adicionais, consulte o site da web das PráticasComprovadas do IBM Cognos: Práticas Comprovadas de Procura Melhorada doIBM Cognos , (http://www.ibm.com/developerworks/data/library/cognos/infrastructure/cognos_specific/page541.html).

Importante: Quando um índice é criado, a coleção de dados coloca umcarregamento extra no serviço de relatório em lotes. Para gerenciar necessidades deindexação adicionais, planeje e escale os serviços de relatório em lotescorretamente. A quantidade total de conexões com alta afinidade disponíveis paraindexação deve ser igual à quantidade de CPUs disponíveis nos servidores quehospedam o serviço de atualização do índice.

Se você usar o Google Search Appliance para procura corporativa, é possívelintegrar o conteúdo do IBM Cognos nos resultados da procura do Google. Paraobter mais informações, consulte “Configurando Componentes do IBM CognosOneBox” na página 445.

Para configurar a Procura do Índice, faça o seguinte:__ v Atualize de uma versão anterior.__ v Ative os serviços de índice para uma instalação distribuída, conforme

necessário.__ v Configure escalabilidade para procura de índice.


http://www.ibm.com/developerworks/data/library/cognos/infrastructure/cognos_specific/page541.html

http://www.ibm.com/developerworks/data/library/cognos/infrastructure/cognos_specific/page541.html

__ v Certifique-se de que qualquer URL que possa surgir em um resultado deprocura seja incluída na lista de domínios e hosts válidos no IBM CognosConfiguration.Para obter mais informações, consulte “IBM Cognos Application Firewall” napágina 247.

__ v Inclua a funcionalidade de procura do IBM OmniFind Enterprise Edition paraaplicativos IBM Cognos, se necessário.

__ v Crie pelo menos um índice.Para obter mais informações, consulte o Guia de administração e segurança.

Atualização de uma versão anterior da Procura do ÍndiceSe estiver fazendo a atualização a partir de um produto que usou IBM Cognos Go!Search e tiver modificado seu arquivo card.xml para publicar o índice emmecanismos de procura de terceiros, você deverá migrar essas configurações para aversão do IBM Cognos BI.

Algumas versões do IBM Cognos Go! Search incluíam um arquivo csnconfig.xml.Se você redefiniu seu índice em uma versão anterior do Go! Search, você vailocalizar funcionalidade equivalente no IBM Cognos Administration. Anotequaisquer configurações customizadas antes de excluir o arquivo csnconfig.xml.Para obter mais informações, consulte o Guia de administração e segurança.

Procedimento1. Após atualizar para o IBM Cognos BI, copie o arquivo card.xml do local de

backup de sua versão antiga para o diretório c10_location\bin\card.2. Se solicitado a substituir um arquivo existente, clique em Sim.

Habilitação e desabilitação de serviços do índice eminstalações distribuídas

Normalmente, uma instalação do IBM Cognos BI pode hospedar uma instância doserviço de dados do índice, uma instância do serviço de atualização do índice equalquer número de instâncias de serviços de procura de índice. Para atingir asmetas operacionais específicas, como maior robustez ou desempenho,configurações mais complexas são possíveis.

Em uma instalação distribuída típica do IBM Cognos BI, o serviço de procura deíndice e o serviço de atualização de índice devem ser ativados na camada doaplicativo, e o serviço de dados do índice deve ser ativado na camada de dados.

Procedimento1. No servidor no qual você instalou os Componentes da Camada de Aplicativos

na camada de aplicativos, inicie o IBM Cognos Configuration e faça o seguinte:v Na janela Explorer, expanda Ambiente e clique em Serviços do IBM

Cognos.v Na janela Propriedades, altere o valor para Serviço de dados do índice

habilitado como Falso.v Salve a configuração.

2. No servidor no qual você instalou os Componentes da Camada de Aplicativosna camada de dados, inicie o IBM Cognos Configuration e faça o seguinte:v Na janela Explorer, expanda Ambiente e clique em Serviços do IBM

Cognos.


v Na janela Propriedades, altere os valores para Serviço de procura do índicehabilitado e Serviço de dados do índice habilitado como Falso.

v Salve a configuração.3. Para cada instância adicional do serviço de procura de índice, no servidor onde

você instalou os Componentes da Camada de Aplicativos adicionais na camadade aplicativos, inicie o IBM Cognos Configuration e faça o seguinte:v Na janela Explorer, expanda Ambiente e clique em Serviços do IBM

Cognos.v Na janela Propriedades, altere os valores para Serviço de dados do índice

habilitado e Serviço de atualização do índice habilitado como Falso.v Salve a configuração.

Escalonamento da procura do índice usando ocompartilhamento do índice

Para escalar uma operação de procura, é possível implantar várias instâncias doserviço de dados de indexação em diferentes servidores. Como a procura estávinculada à CPU, é possível atingir o balanceamento de carga introduzindo novosservidores que compartilham o mesmo índice. Essa configuração é conhecida comocompartilhamento de índice.

O compartilhamento de índice permite que diversos serviços de dados do índiceprocurem e atualizem um único índice localizado no sistema de arquivocompartilhado no ambiente distribuído do IBM Cognos BI. Todos os serviços dedados do índice podem procurar em todos os arquivos do índice.

Quando sua instalação do IBM Cognos BI incluir diversos servidores de camada dedados, todas as instâncias do serviço de dados do índice devem ser configuradasde forma idêntica e apontar para um sistema de arquivo compartilhado. Docontrário, só será possível ativar uma instância de serviço de dados de índice porvez.

Procedimento1. Crie o diretório-raiz para o índice de procura de índice em um dos servidores

que faz parte da camada de dados da sua implementação do IBM Cognos BI.Por exemplo, crie um diretório chamado sharedIndex no host "indexsearch". Ocaminho é \\indexsearch\sharedIndex.Em um sistema operacional Microsoft Windows, os locais de arquivocompartilhado devem ser especificados com o uso de Convenção Universal deNomenclatura (UNC). Unidades mapeadas não são suportadas.

2. Compartilhe o diretório e verifique se todos os servidores que hospedam umserviço de dados do índice podem acessá-lo. Ele será o diretório-raiz do índicecompartilhado.

3. Se você estiver usando o Windows, certifique-se de que o serviço do Windowspara IBM Cognos BI seja executado sob um usuário com permissões de leiturae gravação nesse sistema de arquivo compartilhado.v Selecione Iniciar > Painel de Controle > Ferramentas Administrativas >

Gerenciamento de Computador.v Expanda Services and Applications e clique em Services.v Dê um clique duplo no serviço do IBM Cognos que hospeda o serviço de

dados do índice.v Selecione a guia Logon e especifique uma conta de domínio que tenha

permissões de leitura e gravação no sistema de arquivos compartilhados.


4. Efetue logon no IBM Cognos Connection como um administrador.5. No IBM Cognos Connection, clique em Ativar > IBM Cognos Administration.6. Clique na guia Procura do Índice.7. Clique em Armazenamento e em Avançado.8. Na caixa Instâncias, verifique se Todos está selecionado.

As mudanças serão aplicadas a todas as instâncias de serviço de dados deíndice no ambiente de Procura do Índice. Recomendamos isso para a maioriados parâmetros.

9. Remova o caminho padrão e digite o novo caminho para o diretório de índicecompartilhado como o valor para o parâmetro CSN.IndexLocation.Por exemplo, exclua a configuração padrão e digite \\indexsearch\sharedIndex como o valor para CSN.IndexLocation.

10. Se o serviço de dados do índice estiver em um Network File System (NFS) dosistema operacional UNIX, inclua o parâmetro CSN.IndexNFSSupport na listade definições de configuração avançadas e configure o valor como true.

11. Clique em Salvar.

Incluindo a Funcionalidade de Procura do IBM OmniFindEnterprise Edition em Aplicativos IBM Cognos

Caso pretenda usar o IBM OmniFind Enterprise Edition com IBM Cognos BI, vocêdeverá incluir o IBM Search and Index API (arquivos esapi.jar e siapi.jar) nainstalação do IBM Cognos.

Para obter mais informações sobre como integrar IBM Cognos Applications a outromecanismo de procura, consulte o Guia de Administração e Segurança do IBMCognos.

A inclusão do IBM Search and Index API não é obrigatória se você pretende usar oIBM OmniFind Yahoo Edition.

Antes de Iniciar

O produto IBM OmniFindEnterprise Edition já deve estar instalado e configuradocom uma coleção que pode ser procurada (índice).

Procedimento1. No computador no qual o produto IBM OmniFindEnterprise Edition está

instalado, acesse o diretório OmniFind_installation_location\lib.2. Localize os arquivos esapi.jar e siapi.jar e copie-os no diretório

IBM_Cognos_installation_location\webapps\p2pd\WEB-INF\lib em cadacomputador em que o serviço de procura de índice está ativado.

Configuração do URI de descoberta de colaboraçãoÉ possível configurar o IBM Cognos Business Intelligence e o IBM CognosWorkspace para usarem o IBM Connections para tomada de decisão colaborativa.A integração com o IBM Connections permite que usuários corporativos colaboremao criar ou visualizar relatórios, executar análise ou monitorar áreas de trabalho.Os usuários têm acesso a atividades do IBM Connections a partir do IBM CognosWorkspace e à página inicial do IBM Connections a partir do IBM Cognos BI e doIBM Cognos Workspace.


O URI de descoberta de Colaboração especifica o servidor IBM Connections a serusado como o provedor de colaboração. Quando um URI é especificado, o suporterelacionado à colaboração é incluído no IBM Cognos BI da seguinte forma:v é incluído um link na página de Boas Vindas do Cognos Connection. Se o

usuário tiver acesso à página inicial do IBM Connections, o link será chamadoAcessar minha rede social e vinculará o usuário à página inicial. Se o usuáriotiver acesso às atividades do IBM Connection, mas não à página inicial, o linkserá chamado Minhas Atividades e vinculará o usuário à página de atividades.

v um link para a página inicial do IBM Connections é incluído no menu Iniciar noCognos Connection

v um link para a página inicial do IBM Connections é incluído no menu Ações noIBM Cognos Workspace

v o botão de menu Colaborar é incluído na barra de aplicativos da área detrabalho no IBM Cognos Workspace. Isto permite que o usuário crie ou visualizeuma atividade da área de trabalho no IBM Connections.

Procedimento1. Inicie o IBM Cognos Connection.2. Clique em Ativar, IBM Cognos Administration.3. Na guia Configuração, clique em Dispatchers e serviços para visualizar a lista

de dispatchers.4. Da barra de ferramentas, clique no botão Configurar propriedades -

configuração.5. Clique na guia Configurações.6. Para a categoria Ambiente, URI de descoberta de colaboração, digite o URI da

seguinte maneira:http://server_name:port_number/activities/serviceconfigs

Por exemplo, http://server_name:9080/activities/serviceconfigsem que server_name representa o nome do servidor no qual o IBM Connectionsestá instalado.

7. Clique em OK.Conceitos relacionados:Capítulo 12, “Usando Colaboração com o IBM Cognos Workspace”, na página 347Os recursos de colaboração no IBM Cognos Workspace fornecem uma ponte entreo uso do IBM Cognos Business Intelligence para descobrir um problema denegócios e a ação para resolvê-lo.

Configurando o IBM Cognos WorkspaceO IBM Cognos Workspace está incluído no servidor IBM Cognos BI. Ele entregarecursos dinâmicos e customizáveis que permitem montar de maneira rápida efácil áreas de trabalho interativas usando conteúdo do IBM Cognos, bem comoorigens de dados externos. Depois de testar se esse IBM Cognos Workspace estáexecutando, configure o acesso às funções e aos recursos seguros.

Complete as tarefas de configuração a seguir.__ v Configurar o acesso ao IBM Cognos Workspace.__ v Configurar os Tipos MIME Suportados no Microsoft Internet Information

Services.


Depois que as tarefas de configuração tiverem sido concluídas, é possível realizaras seguintes tarefas conforme necessário:__ v Configurar um banco de dados para anotações .__ v Configurar o IBM Cognos Workspace para usar objetos de métrica.__ v Configurar o IBM Cognos Workspace para usar o conteúdo de um TM1 Data

Server.__ v Configurar o IBM Cognos Workspace para acessar IBM Cognos TM1

Applications.__ v Alterar os estilos em seus relatórios.__ v Usar as amostras.

Configurando Acesso ao IBM Cognos Workspace ou às suasFunções

Configure o acesso ao IBM Cognos Workspace, concedendo as permissõesnecessárias para o recurso Painel Executivo para namespaces, usuários, grupos oufunções especificados.

É possível conceder acesso total ao IBM Cognos Workspace ou é possível concederacesso apenas à função de publicação.

O IBM Cognos BI deve estar configurado e em operação antes que seja possívelconfigurar o acesso para o IBM Cognos Workspace.

Concedendo Acesso Total ao IBM Cognos WorkspacePara conceder acesso ao IBM Cognos Workspace e toda a sua funcionalidade,conceda permissões de execução e travessia para o recurso de Painel Executivo.

Informações adicionais sobre como configurar a permissão para que os usuáriospossam ser localizados em uma nota técnicahttp://www.ibm.com/support/docview.wss?uid=swg21498402 (www.ibm.com/support/docview.wss?uid=swg21498402) no website da IBM.

Procedimento1. No IBM Cognos Connection, clique em Iniciar, IBM Cognos Administration.2. Na guia Segurança, clique em Capacidades.

3. Localize o recurso Painel Executivo, clique no botão de ações próximo donome do recurso e selecione Configurar Propriedades.

4. Selecione a guia Permissões.5. Conceda permissão de Execução a todos os grupos de usuários que devem ter

acesso ao IBM Cognos Workspace e, em seguida, clique em OK.

Concedendo Acesso à Função de Publicação ao IBM CognosWorkspacePara conceder acesso apenas à função de publicação no IBM Cognos Workspace,conceda permissões de passagem para o recurso Painel Executivo e permissões deexecução para a função protegida Painéis de Publicação em Espaços deColaboração.

Procedimento1. No IBM Cognos Connection, clique em Iniciar, IBM Cognos Administration.2. Na guia Segurança, clique em Capacidades.




3. Encontre e selecione a função Painel executivo.

4. Clique no botão de ações próximo de Painéis de Publicação em Espaçosde Colaboração e clique em Configurar Propriedades.

5. Selecione a guia Permissões.6. Para definir permissões de acesso explicitamente para cada entrada, selecione

Substituir as permissões de acesso obtidas da entrada pai.7. Para cada grupo de usuários, selecione a caixa de seleção para a entrada e, na

caixa ao lado da lista, selecione as caixas de seleção para conceder permissões àentrada.

8. Se desejar adicionar novas entradas à lista, clique em Adicionar e escolha comoselecionar as entradas:v Para escolher dentre as entradas disponíveis, clique no namespace

apropriado e depois assinale as caixas de seleção próximas dos usuários,grupos ou funções.

v Para procurar por entradas, clique em Procurar e, na caixa Procurar string,digite a expressão que deseja buscar. Para opções de procura, clique emEditar. Localize a entrada que desejar e clique nela.

v Para digitar o nome de entradas que você deseja incluir, clique em Digitar edigite os nomes de grupos, funções ou usuários usando o seguinte formato,em que um ponto e vírgula (;) separa cada entrada: namespace/group_name;namespace/role_name;namespace/user_name;

Em seguida, é possível conceder permissões para cada nova entrada.9. Clique em OK.

Configurando Tipos MIME Suportados no Microsoft InternetInformation Services

Se você usar o Microsoft Internet Information Services (IIS) 6.0, para que o IBMCognos Workspace seja carregado com êxito, deverá definir o tipo MIME que oIBM Cognos Workspace usa.

Procedimento1. Abra o console de gerenciamento do Microsoft IIS.2. Clique com o botão direito do mouse no nome do computador local e clique

em Propriedades.3. Clique em Tipos de MIME.4. Clique em Novo.5. Na caixa Ramal, digite .cfg.6. Na caixa Tipo MIME, digite text/plain.7. Aplique as novas configurações.

As mudanças entrarão em vigor quando o processo do trabalho for atualizado.Para evitar espera, é possível reiniciar o World Wide Web Publishing Service.Para obter informações adicionais, procure na biblioteca online do Microsoftpor Manipulando Tipos MIME no Internet Explorer.

Criando Espaços de Tabela para Banco de Dados deAnotação e Tarefa Manual no DB2 no z/OS

Se você estiver usando o DB2 no z/OS, um administrador de banco de dados deveexecutar scripts para criar os espaços de tabela necessários para o banco de dados


de anotação e tarefa manual. O script deve ser modificado para substituir osparâmetros de espaço reservado com os adequados a seu ambiente.

Certifique-se de usar a convenção de nomenclatura para DB2 no z/OS. Porexemplo, todos os nomes de parâmetros devem iniciar com uma letra e ocomprimento não deve exceder seis caracteres. Para obter mais informações,consulte o Centro de Informações do IBM DB2.

É possível usar o banco de dados de armazenamento de conteúdo ou um banco dedados separado para o banco de dados de tarefa manual e de anotações. Emqualquer dos casos, você deve executar os scripts para criar os espaços de tabela.


arrastar tablespaces e para permitir a execução de instruções SQL.2. Para criar os espaços de tabela de tarefas manuais, acesse o diretório

c10_location/configuration/schemas/hts/zosdb2.a. Faça uma cópia de backup do arquivo de script HTS_tablespaces.sql e














3. 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 original ANN_TABLESPACES.sql e use a seguinte














Configurando um Banco de Dados para Tarefas Manuais eAnotações

Por padrão, os dados usados para o recurso Tarefas Manuais e Anotações no IBMCognos Workspace são armazenados no mesmo banco de dados que oarmazenamento de conteúdo. É possível configurar um banco de dados separadopara Human Tasks e Anotações.

Para configurar o banco de dados, primeiro é necessário criá-lo, além de uma contade usuário na qual o banco de dados operará e, em seguida, configurar o recursoHuman Tasks e Anotações para usar o novo banco de dados.

Procedimento1. Crie um banco de dados usando as mesmas instruções que “Diretrizes para

Criar o Armazenamento de Conteúdo” na página 47.Se você estiver usando o DB2 on z/OS para seu banco de dados, deverá criaros espaços de tabela necessários executando dois scripts. Para obter maisinformações, consulte “Criando Espaços de Tabela para Banco de Dados deAnotação e Tarefa Manual no DB2 no z/OS” na página 308.

2. Crie uma conta de usuário, que será usada para operar o banco de dados.3. Na instância em que os Componentes da Camada de Aplicativos são instalados,

inicie o IBM Cognos Configuration.4. No Explorer, clique com o botão direito do mouse em Serviços de Tarefa

Manual e Anotação e selecione Novo Recurso > Banco de Dados.5. Na caixa de diálogo Novo recurso - Banco de dados, digite um nome para o

banco de dados, selecione o tipo e clique em OK.6. Na janela de propriedades de recursos do banco de dados, configure o

seguinte:v Especifique os valores obrigatórios para todas as propriedades marcadas com

um asterisco.


v Especifique a ID de usuário e senha para a conta que opera o banco dedados.


8. Para testar a conexão com o novo banco de dados, no menu Ações, clique emTestar.

9. Repita essas etapas em cada instância de Componentes da Camada deAplicativos e do Content Manager.

Objetos de Métrica no IBM Cognos WorkspacePor padrão, um arquivo de contribuição do Metric Studio é fornecido com oservidor IBM Cognos BI e os objetos de métrica ficam disponíveis para IBMCognos Workspace. Se seu produto incluir o IBM Cognos Metrics Manager e oserviço de métrica estiver ativado, é possível acessar os objetos do Metric Studioem suas áreas de trabalho.

Se o produto não incluir o Metrics Manager, remova o arquivo de contribuição doMetric Studio. Caso contrário, qualquer pacote de métrica existente continuarásendo exibido na área de janela de conteúdo do IBM Cognos Workspace e astentativas de acessá-lo produzirão uma mensagem de erro.

Se o arquivo de contribuição do Metric Studio estiver presente ou não, os pacotesde métricas publicados serão sempre exibidos no IBM Cognos Workspace. Se oarquivo de contribuição estiver presente, o conteúdo do aplicativo de métricaaparecerá na área de janela de conteúdo do IBM Cognos Workspace. Esse conteúdoinclui listas de monitoramento, scorecards, métricas, tipos de métricas e estratégias.Se o arquivo de contribuição não estiver presente, o conteúdo do aplicativo demétricas não aparecerá na área de janela de conteúdo. No entanto, o pacote demétricas e todos os relatório de métricas aparecem na área de janela de conteúdo.Todos os objetos que aparecem na área de janela de conteúdo podem sermanipulados na área de janela da mesma maneira que são manipulados no IBMCognos Connection.

Execute as seguintes tarefas, conforme necessário, para configurar o IBM CognosWorkspace para usar objetos de métrica:__ v Altere os relatórios que são renderizados por um objeto de métrica, se

necessário.__ v Remova o arquivo atom de contribuição de métrica, se necessário.

Alterando o Relatório Renderizado por um Objeto de MétricaSe um autor tiver criado novos relatórios para um pacote de métricas, será possívelassociar os novos relatórios aos tipos de objetos editando o arquivocmm_NOT.properties.

Cada tipo de objeto de métrica que é arrastado para uma área de trabalho no IBMCognos Workspace renderiza um relatório específico, conforme mostrado naseguinte tabela:

Tabela 71. Objetos de Métricas e os Relatórios Renderizados a Partir dos Mesmos

Tipo de objeto Relatório gerado

Métrica Gráfico do histórico da métrica

Tipo de métrica Dados do tipo de métrica

Scorecard Lista de métricas de scorecard


Tabela 71. Objetos de Métricas e os Relatórios Renderizados a Partir dosMesmos (continuação)

Tipo de objeto Relatório gerado

Estratégia Lista de métricas de estratégia

Lista de observação Lista de monitoramento e lista de métricas

Os relatórios são criados automaticamente com cada pacote de métrica.

Procedimento1. Para a instância em que os Componentes da Camada de Aplicativos estiverem

instalados, acesse o diretório c10_location\webapps\p2pd\WEB-INF\classes.2. Renomeie o arquivo cmm_NOT.properties para cmm.properties.3. Abra cmm.properties em um editor de texto.4. Na seção ##Default reports for BUX, localize o tipo de objeto que deseja

substituir em cada relatório:v Para métrica,

##cmm.bux_report.metric=/folder[@name=’Reports’]/folder[@name=’Reports’]/report[@name=’MetricHistory Graph’]

v Para tipo de métrica,##cmm.bux_report.metric_type=/folder[@name=’Reports’]/folder[@name=’Reports’]/report[@name=’MetricType Data’]

v Para scorecard,##cmm.bux_report.scorecard=/folder[@name=’Reports’]/folder[@name=’Reports’]/report[@name=’ScorecardMetric List’]

v Para estratégia,##cmm.bux_report.strategy=/folder[@name=’Reports’]/folder[@name=’Reports’]/report[@name=’StrategyMetric List’]

v Para a lista de monitoramento,v

##cmm.bux_report.watchlist=/folder[@name=’Reports’]/folder[@name=’Workspace Reports’]/report[@name=’Watch List’]

5. Remova o comentário da propriedade removendo os símbolos ##.6. Substitua os valores nas sequências /folder pelos nomes de pasta em que o

relatório se localiza.7. Substitua o valor da sequência /report pelo parâmetro object_id do novo

relatório.Se o novo relatório usar um parâmetro diferente de object_id, faça o seguinte:a. localize a propriedade object_id do CMM para o tipo de objeto que está

sendo substituído:Para métrica,##cmm.bux_report.object_id.prompt_param_name.metric=object_id

Para tipo de métrica,##cmm.bux_report.object_id.prompt_param_name.metric_type=object_id

Para scorecard,


##cmm.bux_report.object_id.prompt_param_name.scorecard=object_id

Para estratégia,##cmm.bux_report.object_id.prompt_param_name.strategy=object_id

b. Remova o comentário da propriedade removendo os símbolos ##.c. Substitua a sequência object_id pelo nome do parâmetro usado pelo novo

relatório.8. Repita as etapas 4 a 7 para cada tipo de objeto que deseja substituir.9. Salve o arquivo cmm.properties.

10. Reinicie os serviços do IBM Cognos.

Removendo o Arquivo de Contribuição do Metric StudioSe a sua instalação do IBM Cognos BI não incluir o IBM Cognos Metrics Manager,nenhum pacote de métricas continuará a aparecer na área de janela de conteúdodo IBM Cognos Workspace. Entretanto, selecioná-lo faz com que uma mensagemde erro apareça. Para evitar essa mensagem de erro, é possível remover o arquivode contribuição do Metric Studio de sua instalação do IBM Cognos BI. Os pacotesde métricas continuam a aparecer e selecioná-los na área de janela de conteúdomostra o conteúdo do relatório.

Procedimento1. Acesse o diretório c10_location/configuration/icd/contributions/contrib.2. Exclua o arquivo metric_studio_contribution.atom.3. Reinicie o serviço do IBM Cognos.

Configurando o IBM Cognos Workspace para Usar Dados doIBM Cognos TM1

Para poder usar dados do IBM Cognos TM1 no IBM Cognos Workspace, você devemodificar os arquivos de configuração em sua instalação do IBM Cognos BI.

Para configurar o servidor de dados TM1 para IBM Cognos Workspace, você deveexecutar as seguintes tarefas:__ v Configurar informações de conexão para o TM1 Server.__ v Configurar os nomes de seu servidor IBM Cognos TM1 conforme apareceriam

no IBM Cognos Workspace.__ v Opcionalmente, alterar o nome da pasta Visualizações.

Configure Informações de Conexão para o TM1 ServerVocê deve modificar um arquivo de configuração para configurar informações deconexão para os TM1 Servers.

É fornecido um arquivo de contribuição de amostra com sua instalação do IBMCognos BI. Se estiver usando uma instalação distribuída, o arquivo de configuraçãoestará disponível nos computadores nos quais foram instalados os Componentesda Camada de Aplicativos.

Se o gateway do IBM Cognos BI estiver sendo executado em um computadordiferente do computador do TM1 Web, assegure-se de usar nomes de domíniocompletos para os valores de nome do servidor, como TM1WebHost. Por exemplo,use http://mycomputer.mydomain.com/ibmcognos em vez de http://mycomputer/ibmcognos. Além disso, é necessário usar os nomes completos de domínio para osvalores de nome do servidor na seção Ambiente do IBM Cognos Configuration.


Procedimento1. No computador no qual foram instalados os Componentes da Camada de

Aplicativos do IBM Cognos BI, acesse o diretório c10_location\configuration\icd\contributions\contrib e renomeie o arquivotm1_contribution.atom.sample como tm1_contribution.atom.

2. Abra o arquivo tm1_contribution.atom em um editor de texto.O arquivo contém três seções <atom:entry>. Você deve alterar os valores deuma seção <atom:entry> para cada TM1 Server que deseja acessar no IBMCognos Workspace. Se tiver mais TM1 Servers que deseja incluir, você deveincluir seções <atom:entry>, conforme necessário. Você deve também comentara linha de quaisquer seções <atom:entry> extra. A terceira seção <atom:entry>do arquivo de amostra já teve sua linha comentada.A primeira seção <atom:entry> destina-se a um TM1 Server que não usaautenticação do Cognos.A segunda seção <atom:entry> destina-se a um TM1 Server que usaautenticação do Cognos.

3. Na seção <atom:entry> adequada para a autenticação necessária, substitua osvalores de TM1WebHostName e TM1HostName pelo nome ou endereço IP do TM1Web Server e do TM1 Data Server.Por exemplo, altere as seções destacadas da amostra.TM1WebHost=TM1WebHostName&TM1WebVirtualDirectory=tm1web&TM1Host=TM1HostName&

4. Para um TM1 Server que não usa a autenticação do IBM Cognos, altere asseções destacadas mostradas para o valor de TM1DataServer:TM1DataServer=TM1ServerHostWithoutCAM&TM1username=admin&TM1pass=apple

Substitua admin e apple pelo ID de usuário e senha da conta do administradorusada para o TM1 Server.

5. Para um TM1 Server que usa a autenticação do IBM Cognos, altere as seçõesdestacadas mostradas para o valor de TM1DataServer:TM1DataServer=CamAuthenticatedTM1ServerHost

6. Se você não estiver usando os valores padrão, altere as propriedades a seguir:v https

Essa propriedade descreve o protocolo usado para o TM1 Web Server. Se oTM1 Web estiver em execução com HTTP seguro, substitua 0 por 1.

v TM1WebVirtualDirectory

Essa propriedade é o nome do diretório virtual para o TM1 Web. Se o nomedo diretório da Web TM1 não for tm1web, substitua o valor da propriedadeTM1WebVirtualDirectory pelo nome correto.Por exemplo,TM1WebVirtualDirectory=planningweb&

v TM1Toolbar

Esta propriedade determina se a barra de ferramentas interna está visível.Versões do TM1Web anteriores à versão 9.5.2 não permitem uma barra deferramentas externa. O valor-padrão de TM1Toolbar é 0. Para exibir a barrade ferramentas interna, configure o valor como 1.

7. Se você estiver definindo diversas conexões de TM1 Server, crie uma seção<atom:entry> para cada TM1 Server.Todos os valores atom:id em todas as entradas .atom devem ser exclusivos.Por exemplo,


<atom:entry><atom:id>tag:ibm.cognos.icd.com,2010-01-01:/tm1_rootfeed_2

</atom:id>

<atom:entry><atom:id>tag:ibm.cognos.icd.com,2010-01-01:/tm1_rootfeed_2b

</atom:id>

As amostras são exclusivas, em razão de tm1_rootfeed_2 e tm1_rootfeed_2b.Assegure-se de usar nomes exclusivos para valores como tm1_rootfeed_1,rootfeed_title_1 e rootfeed_summary_1.

8. Assegure-se de comentar a linha ou excluir quaisquer seções <atom:entry>não utilizadas.

9. Salve e feche o arquivo.10. Reinicie os serviços do IBM Cognos. Se você desejar alterar os nomes dos TM1

Servers, à medida que eles aparecem no IBM Cognos Workspace, poderáreiniciar os serviços após a próxima tarefa.

Configure os Nomes do IBM Cognos TM1 ServerÉ possível definir os nomes dos seus TM1 Servers como faria se eles aparecessemno IBM Cognos Workspace.

Se você usar idiomas diferentes do inglês, poderá criar arquivos de idiomaadicionais para exibir os nomes no IBM Cognos Workspace.


Aplicativo do IBM Cognos BI, acesse o diretório c10_location\configuration\icd\contributions\contrib.

2. Abra o arquivo chamado tm1_en.properties em um editor de texto.3. Altere o texto que aparece após o sinal de igual (=) para fornecer um nome

significativo para o TM1 Server definido para o título.Por exemplo, se você definiu uma conexão do TM1 Server usando a seçãorootfeed_title_1 no arquivo tm1_contribution.atom na tarefa anterior, altere onome para que apareça como:rootfeed_title_1 = MyTM1Server

4. Altere a descrição da propriedade rootfeed_summary_1 para fornecer umadescrição significativa para o TM1 Server.Por exemplo, se você definiu um nome para a conexão do TM1 Server usandorootfeed_title_1, altere o valor de rootfeed_summary_1, como a seguir:rootfeed_summary_1 = Detail about MyTM1Server

5. Inclua novos valores para cada TM1 Server que foi incluído no arquivotm1_contribution.atom na tarefa anterior. Assegure-se de fazer acorrespondência entre as seções rootfeed_title e rootfeed_summary e osvalores definidos no arquivo tm1_contribution.atom.

6. Se o ambiente suportar diversos idiomas:v Faça uma cópia do arquivo tm1_en.properties.v Renomeie o arquivo como tm1_language_code.properties, em que

language_code é o código de dois caracteres do idioma que você está usando,como ja ou es.É fornecido um arquivo de propriedades em Francês de amostra:tm1_fr.properties.

7. Reinicie os serviços do IBM Cognos para que as mudanças entrem em vigor.


Altere o Nome da Pasta VisualizaçõesOpcionalmente, é possível alterar o nome que é exibido no IBM Cognos Workspacepara a pasta Visualizações.

Por padrão, o IBM Cognos Workspace exibe uma pasta Aplicativos e uma pastaVisualizações para cada servidor TM1 identificado no arquivotm1_contribution.atom. O nome da pasta Aplicativos é retornado pelo TM1 Server.O nome da pasta Visualizações é determinado por um arquivo de mensagens que éfornecido com o IBM Cognos Workspace.

Procedimento1. Acesse o diretório c10_location\templates\ps\messages.2. Crie uma cópia do arquivo tm1buxmsgs_en.xml e nomeie-o usando o código de

idioma adequado.É fornecido um arquivo de tradução em Francês de amostra:tm1buxmsgs_fr.xml.

3. Abra o novo arquivo de tradução em um editor XML.4. Substitua a palavra Views na seção a seguir por um valor adequado:

<string id="TM1_VIEWS" type="String" usage="TM1 views">Views</string>

5. Salve e feche o novo arquivo.6. Repita as etapas para cada idioma suportado.

Configurando o IBM Cognos Workspace para Acessar IBMCognos TM1 Applications

O servidor IBM Cognos BI pode acessar o Web client para os Aplicativos IBMCognos TM1 através de um iwidget externo exibido na área de janela de conteúdodo IBM Cognos Workspace. Antes que o iwidget possa ser exibido, use adocumentação do TM1 Applications para executar as tarefas a seguir.

Procedimento1. Instale os Aplicativos do IBM Cognos TM1.2. Configurar o IBM Cognos TM1 Applications para interoperabilidade com o

servidor IBM Cognos BI.Ao copiar o arquivo icon_active_application.gif para a pasta de imagens doportal do servidor Cognos BI, copie-o também na pasta c10_location/webcontent/icd/feeds/images.

3. Implemente seus aplicativos.O IBM Cognos TM1 Applications gera uma URL, que o servidor IBM CognosBI detecta.

Resultados

A URL do TM1 Contributor é exibida em Pastas Públicas na área de janela deconteúdo do IBM Cognos Workspace.

Alterando o Estilo de Objetos de Relatório no IBM CognosWorkspace

Ao arrastar um objeto de relatório para uma área de trabalho,ele aparece no estilode gradiente prata e azul do seu produto. É possível configurar o objeto derelatório que aparece no estilo original criado alterando uma propriedade global noarquivo de configuração do IBM Cognos Viewer.


Os objetos de relatório que são afetados pela configuração global incluemconsultas, análises, relatórios e partes de relatórios que foram criados usando oestilo do IBM Cognos Versão 1.x, o estilo da Versão 8.x e o estilo financeiro(balanço). Esses objetos irão assumir a configuração global mesmo se tiverem sidosalvos antes da configuração global. As miniaturas da área de trabalho serãoafetadas pela configuração global apenas se a miniatura for executada novamente.

Alguns objetos de relatório não são afetados pela configuração global e sempreserão renderizados no estilo criado, como relatórios do PowerPlay e miniaturas deobjetos de relatório.

Procedimento1. Para cada instância do Content Manager e dos Componentes da Camada de

Aplicativos, acesse o diretório c10_location/webapps/p2pd/WEB-INF/classes.2. Abra o arquivo viewerconfig.properties em um editor de texto.3. Para fazer os objetos de relatório aparecerem no estilo original criado, altere o

valor de useAuthoredReportStyles para true.4. Salve o arquivo e, em seguida, reinicie os serviços.

Acessando as Amostras do IBM Cognos WorkspaceAs amostras do IBM Cognos Workspace são incluídas nas amostras do IBMCognos BI.

Usuários de negócios podem acessar as amostras para o IBM Cognos Workspaceselecionando a opção para abrir áreas de trabalho existentes e, em seguida,selecionando Amostras > Modelos > Amostras do Cognos Workspace.

Para obter informações sobre a instalação e configuração das amostras, consulte“Instalação do IBM Cognos Business Intelligence Samples” na página 463 e“Configurando as Amostras” na página 464. Para obter informações adicionaissobre como usar as amostras, consulte o Guia do Usuário do IBM Cognos Workspace.

Configuração do roteador para testar a disponibilidade do dispatcherSe você usar um roteador para distribuir solicitações para dispatchers do IBMCognos, e o roteador puder testar a disponibilidade de um servidor usando umaURL de teste, é possível configurar o roteador para testar a disponibilidade de umdispatcher do IBM Cognos.

Procedimento

Configure o roteador para usar uma URL com o caminho /p2pd/servlet/ping.Se o dispatcher não estiver pronto, a seguinte resposta é exibida:503 Serviço não disponívelSe o dispatcher estiver pronto, a seguinte resposta é exibida:200 OK

Configurando o IBM Cognos BI para Trabalhar com outros ProdutosIBM Cognos

Alguns produtos IBM Cognos fornecem funcionalidade que não está disponível noIBM Cognos BI.


É possível continuar a utilizar esses produtos no mesmo ambiente. Tarefas deconfiguração adicionais podem ser necessárias para garantir que o IBM Cognos BIpossa acessar objetos que foram criados usando produtos IBM Cognos. Exigênciasadicionais de acesso dependem de como se escolhe executar os dois produtos.

Ativando Agentes e Relatórios Programados para Origens deDados do IBM Cognos Planning Contributor

Para executar agentes e relatórios programados, que são baseados nas origens dedados do IBM Cognos Planning Contributor, você deve especificar uma senhasecreta compartilhada. Isso ajuda a garantir uma comunicação segura entre osservidores IBM Cognos BI e o Contributor Data Server.


Cognos Configuration.2. Na janela Explorer, clique em Acesso a dados, IBM Cognos Planning,

Servidor de dados contribuintes.3. Na janela Propriedades, clique na caixa Valor próxima da propriedade Senha

com Assinatura e clique no botão de edição quando ele aparecer.4. Na caixa de diálogo Valor - Senha de assinatura, digite a senha que será

assinada digitalmente.A senha faz distinção entre maiúsculas e minúsculas e deve corresponder àpropriedade Senha com Assinatura que você configura nas propriedades IBMCognos Series 7, Configuration Manager, Cognos Planning/Cognos BI -Contributor Data Server/Geral.


Resultados

Uma assinatura digital, baseada na senha, é criada. A assinatura digital écodificada pelo IBM Cognos BI e decodificada pelo Contributor Data Server.

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.

Além disso, se você instalar o Transformer em um computador com WindowsVista e quiser usar o arquivo cogtr.xml.samples como modelo, você deveráatualizar preferências padrão no arquivo de configuração do Transformer.


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

- Local do armazenamento da chave de assinatura

- Local do armazenamento de chave de criptografia


Resultados

As variáveis de ambiente são resolvidas quando os locais do arquivo são acessadosdurante as atividades de sistema.



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 mais informações, 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 SAP Enterprise Portal (SAP EP)v 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 mais informações, consulte a publicaçãoIBM Cognos Business Intelligence Administration and Security Guide.

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 mais informações, consulte a publicação IBM Cognos BusinessIntelligence Administration and Security Guide.

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.



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.


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 de 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 iViews (SAP EP)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 323

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

que você configurou na etapa 1.

Dica: O namespace de conexão confiável age 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.


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



Configurar o Cognos iViews para SAP EPNo iViews, você deve vincular o iViews ao namespace Custom Java Provider emseu respectivo portal.

Procedimento1. Abra o editor do iView para cada Cognos iView.2. Na caixa de diálogo Property Category, selecione Show All.3. Para a propriedade cpsauthsecret: Segredo de Autorização CPS, insira a

sequência de caracteres secreta usada para a propriedade SegredoCompartilhado durante a configuração do namespace Custom Java Provider.

4. Para a propriedade cps: ID de namespace de autenticação, insira o ID denamespace Custom Java Provider.

5. Para a propriedade cpsserver: CPS Connection Server, insira o caminho doURL para acessar os componentes 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 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 o Bloco de notas, edite o arquivo

cpsalui.properties no diretório local_c10/cps/oracle/webapps/gadgets/WEB-INF/classes.

2. Configure as definições mostradas na tabela a seguir.


Tabela 72. 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 seguinte arquivo deconstrução:v Em sistemas operacionais UNIX ou Linux, build.sh

v No 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 Tomcat,v Pare o IBM Cognos BI.v Copie o arquivo cps-wci.war para o diretórioc10_location/webapps.

O Tomcat expande automaticamente o arquivo WAR e inicia o servidorremoto.

v Inicie o IBM Cognos BI.5. Se os componentes do IBM Cognos BI estiverem em execução em outro tipo de

servidor de aplicativos, copie o arquivo cps-wci.war para o servidor deaplicativos.


Para obter instruções, consulte o guia de administração de seu servidor deaplicativos.

Resultados

A conexão única está configurada.

Configure as 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 73. 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 conjunto 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 a Autenticação anônima estejadesativada.

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.


Tabela 73. 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, assegure-se de que o aplicativo sejaexecutado por uma conta de serviço de domínio eassegure-se de que a conta de domínio tenha adelegaçã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.


http://technet.microsoft.com/en-us/library/ee806870.aspx

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


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.

Ativação da conexão única para SAP EP com o SAP LogonTicket

Se a conexão única for ativada com o SAP Logon Ticket, você deve configurarcomponentes do IBM Cognos com um namespace SAP que vincule a um servidorSAP BW.

Em seguida, você deve copiar o certificado que foi gerado durante a instalação doSAP EP para o ambiente de segurança pessoal do SAP BW.

Os usuários devem ter a mesma ID de usuário em todos os sistemas SAPacessados pela conexão única.

Antes de começar, certifique-se de quev configurado componentes do IBM Cognos para usar uma fonte de autenticação

SAPv ativado a conexão única entre os componentes do IBM Cognos e o SAP BWv Foram instalados os pacotes de serviço mais recentes no servidor SAP BW

Os service packs podem ser baixados do SAPNET.v Foram instalados as correções críticas mais recentes para o portal SAP.


v Foi instalado o plug-in do Enterprise Portal que corresponde à liberação do SAPEP ou do servidor SAP BW.Para versões SAP mais antigas que 6.2, no SAPNET, faça o download doEP50_PLUG-IN para Basis 620 (SAPKINE32A). Ao usar transação SAINT, instaleo SAPKINE32A.

v Foi instalado o SAP Security Library nos servidores SAP BW.Em sapservX, em /general/misc/security/SAPSECU/platform, faça o downloaddo sapsecin e sepsecu.dll e coloque os dois arquivos no diretório /run directorydo servidor SAP BW.

Para ativar SSO para SAP EP, complete os procedimentos de conexão única com oschamados de logon SAP no SAP Enterprise Portal Security Guide.

Agora, é possível usar o Cognos iViews no SAP Enterprise Portal. Para obter maisinformações, consulte o Guia de administração e segurança.

Ativação da conexão única para SAP EP com mapeamento deusuário

Se ativar a conexão única com o mapeamento de usuário, você define uma origemde dados do IBM Cognos no SAP EP. Usuários individuais ou um administradorpodem digitar os IDs de usuário e as senhas para os componentes do IBM Cognosna origem de dados. Você deve mapear as credenciais de logon de usuários naorigem de dados para um namespace. O Portal Services iViews transmite ascredenciais de logon para componentes do IBM Cognos usando o HTTP BasicAuthentication.

Preparar o AmbienteAntes de mapear credenciais de logon do usuário, você deve executar algumastarefas no ambiente de segurança.

Procedimento1. Configure o URI do gateway que será usado pelo Portal Services para solicitar

autenticação usando o HTTP Basic Authentication.Para obter informações sobre como configurar um URL para usar o HTTP BasicAuthentication, consulte a documentação para o gateway ou seu servidor web.

2. Ajuste as configurações do iView para acessar o URL seguro.Para obter informações, consulte a documentação de seu servidor web.

3. No IBM Cognos Configuration, configure um namespace para autenticarusuários do portal.

4. Se usar um namespace LDAP, configure as seguintes propriedades:v Para a propriedade Utilizar identidade externa, altere a configuração para

Verdadeiro.v Para a propriedade Mapeamento de identidade externa, defina-a como

(uid=${environment("REMOTE_USER")})

Criar a Origem de Dados e Mapear os UsuáriosVocê deve configurar as credenciais de logon e definir os mapeamentos deusuários para o Cognos iViews.


Procedimento1. No portal SAP, verifique se as seguintes propriedades estão configuradas para a

origem de dados no diretório /PortalContent/other_vendors/every_user/com.cognos.pct.c8/systems/Cognos:v Método de Logon = UIDPWv nome do servidor = o nome do servidor IBM Cognosv número da porta = número da porta do gatewayv Protocolo do Sistema de destino = HTTPv Tipo de Mapeamento de Usuário = admin,userv alias do sistema (Criar um alias do sistema)Para obter mais informações, consulte o SAP Enterprise Portal Security Guide.

2. Para cada Cognos iView, ative o mapeamento de usuário para a origem dedados, inserindo o nome do alias do sistema no nível do iView, em um atributochamado CPS: Origem de Dados de Mapeamento de Usuário.Para obter mais informações, consulte o SAP Enterprise Portal Security Guide.

3. Para cada Cognos iView, defina a propriedade CPS: ID de Namespace deAutenticação para o namespace que você deseja usar para autenticação.

4. Registre as credenciais do IBM Cognos para os usuários do portal.Os usuários podem inserir suas próprias IDs e senhas.Para obter mais informações, consulte o SAP Enterprise Portal Security Guide.

5. Ative a comunicação segura entre o SAP EP e o IBM Cognos.

Resultados

Agora, é possível usar o Cognos iViews no SAP Enterprise Portal. Para obter maisinformações, consulte o Guia de administração e segurança.

Ativar a Comunicação Segura Entre Componentes do SAP EPe do IBM Cognos

Uma conexão segura, usando SSL, não é exigida entre os componentes do SAP EPe do IBM Cognos. É mais importante se foi ativado a conexão única com omapeamento de usuário.

Para ativar o SSL entre os componentes do SAP EP e do IBM Cognos, consulte adocumentação de segurança do SAP EP.

Após o SSL ter sido ativado, edite as propriedades para todos os iViews, de modoque a propriedade cpsserver: CPS Connection Server use https no lugar de http.

Agora, é possível usar os portlets do IBM Cognos no SAP Enterprise Portal. Paraobter mais informações, consulte o Guia de administração e segurança.

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.

Para obter informações sobre SSL para componentes do IBM Cognos em umWebSphere Application Server, consulte “Configurando o Protocolo SSL paraComponentes do IBM Cognos” na página 275.

Após a conexão única ser configurada, é possível usar os portlets do IBM Cognosno WebSphere Portal. Para obter mais informações, consulte o Guia de administraçãoe segurança.

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.Para obter instruções, consulte “Configure os Componentes do IBM Cognospara Usar o CA SiteMinder” na página 383.

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 de

autenticação ativo que o CA SiteMinder fornece.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.



Capítulo 11. IBM Cognos Content Archival

Armazenar o conteúdo arquivado no seu repositório externo fornece apossibilidade de atender os requisitos de conformidade regulamentar e podemelhorar a escalabilidade e o desempenho dos produtos IBM Cognos porque reduzo tamanho do conteúdo no armazenamento de conteúdo.

O software suporta um IBM FileNet Content Manager com repositório externo doIBM FileNet CMIS. Se já tiver o software IBM Filenet CMIS versão 1 instalado,você deve atualizar este software com o fix pack, versão 2. O arquivamento deconteúdo também pode ser configurado para usar o seu sistema de arquivos.

Os administradores criam uma conexão de origem de dados com um repositórioexterno para permitir que o conteúdo seja movido do armazenamento de conteúdopara o repositório. Os usuários podem visualizar o conteúdo arquivado norepositório externo a partir do IBM Cognos Connection. Fornecendo resultados daprocura para conteúdo recente e arquivado, os usuários podem fazer comparaçõescríticas entre dados atuais e dados históricos. Esse mecanismo eficiente permiteque sua empresa atenda aos requisitos corporativos e governamentais, ao mesmotempo que fornece uma experiência contínua do usuário.

O conteúdo arquivado no repositório externo não é gerenciado no ambiente doIBM Cognos. Por exemplo, se você excluir relatórios no IBM Cognos Connection,as saídas arquivadas não serão excluídas no repositório externo.

Para obter informações sobre como administrar seus archives, consulte o Guia deAdministração e Segurança do IBM Cognos Business Intelligence.

Há dois cenários de fluxo de trabalho para arquivar seu conteúdo. O primeirofluxo de trabalho permite que os administradores arquivem pacotes e pastas após ainstalação do IBM Cognos Content Archival. O segundo fluxo de trabalho permiteque os administradores criem conexões de repositório para novos pacotes e pastas.

Fluxo de Trabalho 1: Arquivando Conteúdo Depois de Instalar oSoftware de Conectividade

Os administradores podem arquivar a saída de relatório salva para os pacotes epastas específicos ou todos os pacotes e pastas depois de instalar ou atualizar oIBM Cognos Business Intelligence. Este fluxo de trabalho precisa ser concluídosomente uma vez, pois todo o conteúdo está localizado atualmente em seuarmazenamento de conteúdo.v Crie uma conexão de origem de dados como o repositório externo.v No Cognos Connection, selecione as conexões do repositório para os pacotes e

pastas que precisam ser arquivados.v Crie e execute uma tarefa de manutenção de arquivamento de conteúdo para

selecionar pastas e pacotes a arquivar no repositório externo.

Depois de configurar uma conexão do repositório para pacotes e pastas, qualquernova saída de relatório é arquivada automaticamente, o que significa que não hánecessidade de executar a tarefa de manutenção de arquivamento de conteúdonovamente.


Fluxo de Trabalho 2: Criando Conexões do Repositório paraNovos Pacotes e Pastas

Os administradores podem criar conexões do repositório para novos pacotes epastas ao concluir estas tarefas:v Crie uma conexão de origem de dados como o repositório externo.v No Cognos Connection, selecione as conexões do repositório para os pacotes e

pastas que precisam ser arquivados.

Usando Tarefas de Manutenção de Conteúdo de Arquivamentode Conteúdo

A tarefa de manutenção de conteúdo de arquivamento de conteúdo cria umareferência para as versões de relatório nas pastas e pacotes que você seleciona econfigura. A seleção de pastas e pacotes marca o conteúdo e permite que elepermaneça no armazenamento de conteúdo até que seja arquivado em seurepositório externo.

É importante observar que essa tarefa não move o conteúdo do armazenamento deconteúdo para o repositório externo. Você deve selecionar as conexões derepositório para seus pacotes e pastas no IBM Cognos Connection primeiro. Asversões do relatório em pastas e pacotes que não são marcadas para arquivamentoestão disponíveis para exclusão do armazenamento de conteúdo.

Depois que o conteúdo é marcado, a tarefa de arquivamento de conteúdo estáconcluída. Uma tarefa em segundo plano no Content Manager localiza os itensmarcados e, em seguida, os copia e salva no repositório externo.

A importação do conteúdo para uma pasta ou pacote configurado paraarquivamento em um repositório externo não move e arquiva o conteúdoimportado automaticamente no repositório. Um administrador deve executar umatarefa de manutenção de conteúdo do arquivamento de conteúdo para essa pastaou pacote para arquivar o conteúdo importado.

Tarefas em Segundo Plano

As tarefas XML em segundo plano usadas para mover conteúdo doarmazenamento de conteúdo para o repositório externo são archiveTask.xml edeleteTask.xml. O arquivo archiveTask.xml move o conteúdo marcado para umrepositório ECM externo. Também é possível usar esse arquivo para configurartempos de execução de encadeamento e saídas de archive de formatosselecionados. O arquivo deleteTask.xml é um arquivo de configuração que recuperae exclui objetos de versão marcados da fila.

Preservar IDs do Conteúdo antes de Arquivar

Se necessário, é possível preservar IDs de conteúdo antes de a saída de relatórioser arquivada.

Os objetos no armazenamento de conteúdo possuem IDs de conteúdo que sãoexcluídos e substituídos por novos IDs por padrão, quando você executa umaimplementação de importação e move o conteúdo para um ambiente de destino.Entretanto, pode haver situações em que você deve preservar IDs de conteúdo, porexemplo, ao mover a saída de relatório para um repositório de relatórios externo.


Configurar Arquivamento de ConteúdoVocê deve configurar o seu ambiente para arquivamento de conteúdo. Para que asmudanças de configuração entrem em vigor, você deve parar e iniciar os seusserviços do IBM Cognos.

Criando um Local de Arquivo para um Repositório de Sistemade Arquivos

Para arquivar relatórios ou especificações de relatórios em um repositório dosistema de arquivos de arquivamento de conteúdo do IBM Cognos, é necessáriocriar um alias raiz que aponte para um local de arquivo em uma unidade local oucompartilhamento de rede.

Antes de Iniciar

Você deve ser um administrador e ter acesso ao local do arquivo. O ContentManager e os Componentes da Camada de Aplicativos devem poder acessar esselocal usando uma URI de arquivo.

Procedimento1. Se estiver em execução, pare o serviço do IBM Cognos.2. Inicie o IBM Cognos Configuration.3. Clique em Ações > Editar Configuração Global.

4. Na guia Geral, selecione Raízes de Alias, clique dentro do campo de valor,clique no botão Editar e quando a caixa de diálogo Valor - Raízes de Aliasaparecer, clique em Incluir.

5. Na coluna Nome raiz do alias, digite um nome exclusivo para o seu repositóriodo sistema de arquivos.

Nota: Não há limite para o número de aliases que você pode criar.6. Digite o caminho para o local do seu sistema de arquivos, em que caminho do

sistema de arquivos é o caminho completo para um local de arquivo existente:v No Windows, na coluna windowsURI, digite file:/// seguido pelo caminho

local, por exemplo, file:///c:/file-system-path ou digite file:// seguidopelo nome do servidor e caminho de compartilhamento, por exemplofile://server/share.

v Em UNIX ou Linux, na coluna unixURI, digite file:/// seguido pelocaminho local, por exemplo, file:///file-system-path.

Nota: Caminhos relativos, como file:///../file-system-path, não sãosuportados.Em uma instalação distribuída, ambos os computadores do Content Manager edos Componentes da Camada de Aplicativos devem ter acesso ao local doarquivo. Use ambas as URIs apenas em uma instalação distribuída. A URI doUNIX e a URI do Windows em uma raiz de alias devem apontar para o mesmolocal no sistema de arquivos.

7. Clique em OK.8. Reinicie o serviço do IBM Cognos. Isto pode levar alguns minutos.

Capítulo 11. IBM Cognos Content Archival 339

Resultados

Use este nome do repositório do sistema de arquivos para criar uma conexão coma origem de dados para usar com o software do Cognos Content Archival. Paraobter mais informações, consulte o Guia de Administração e Segurança do IBMCognos .

Importando Definições e Propriedades de ClassesCustomizadas para o IBM FileNet Content Manager

Para usar o arquivamento de conteúdo do IBM Cognos, você deve importar umconjunto de classes e arquivos de propriedades customizados no IBM FileNetContent Manager.

As definições e propriedades de classes customizadas incluem metadadosespecíficos de FileNet. É possível instalar arquivos de propriedade e classescustomizadas a qualquer momento.

Procedimento1. Se você tiver o arquivamento de FileNet configurado, acesse o diretório

c10_location/configuration/repository/filenet/upgrade/.2. Se o arquivamento de FileNet ainda não estiver configurado, acesse o diretório

c10_location/configuration/repository/filenet/new/.3. Copie os arquivos CMECMIntegrationObjects_CEExport._xxx.xml para uma

pasta local no servidor FileNet.4. Abra a FileNet Enterprise Manager Administration Tool e faça conexão com o

domínio do repositório externo do FileNet.5. Selecione um Armazenamento de Objeto de destino e clique no botão Importar

Todos os Itens para importar as definições para o armazenamento de objeto.6. Na área de janela Opções de Importação, clique em Importar Arquivo de

Manifesto e navegue até onde os arquivosCMECMIntegrationObjects_CEExport._xxx.xml estão localizados.

7. Selecione o arquivo CMECMIntegrationObjects_CEExport_Manifest.xml e cliqueem Importar.

8. Reinicie o FileNet Content Engine e o aplicativo FileNet CMIS para aplicar asmudanças no seu ambiente.

Nota: Pode levar bastante tempo para as mudanças serem atualizadas emtodos os nós do FileNet.

Importando Definições e Propriedades de ClassesCustomizadas para o IBM Content Manager 8

Para usar o arquivamento de conteúdo do IBM Cognos com o IBM ContentManager 8, você deve importar um conjunto de arquivos de classes e propriedadescustomizadas. Você também deve atualizar o arquivo de configuração do CMIScom os tipos de pasta do IBM Cognos.

As definições e propriedades de classes customizadas incluem metadadosespecíficos do IBM Content Manager 8. É possível instalar arquivos de propriedadee classes customizadas a qualquer momento.

Como nenhum Resource Manager é definido durante o processo de instalação, hámensagens de erro de conflito durante o processo de importação.


Antes de Iniciar

Você deve ter o IBM Content Manager 8 instalado com um repositório externo doIBM Content Manager 8 CMIS versão 1.1.

Procedimento1. Abra o Cliente de Administração do Sistema do Content Manager 8.2. No menu principal, clique em Ferramentas > Importar XML.3. Na janela Opções de Importação XML, seção Arquivo para importar:

v No campo Arquivo de modelo de dados, clique em Navegar, e selecione oarquivo CMECMIntegrationTypes_RMImport_Manifest.xsd do qual desejarimportar os objetos.

v No campo Arquivo de objetos administrativos, clique em Navegar eselecione o arquivo CMECMIntegrationTypes_RMImport_MimeTypes.xml paraimportar o arquivo de Objetos administrativos.

A localização padrão é o diretório <c10_location>/configuration/repository/contentManager8/New.

4. Para visualizar conflitos, na janela Opções de Importação XML, em Opçõesde processamento, selecione Processar interativamente.

5. Clique em Importar para iniciar o processo de importação.a. Na janela Importar Resultados do Pré-processador, expanda Tipos de

Item e dê um clique duplo em um tipo de Item que indicar um conflito.b. Na janela Detalhes de Definição de Importação e Definição de Destino,

na coluna Destino Resultante, selecione os nomes para o Gerenciador deRecursos e Coleção criados ao instalar o Content Manager 8, e clique emAceitar.

c. Repita as etapas a e b para cada tipo de item que indicar um conflito.6. Após resolver todos os conflitos, a partir da janela Importar Resultados do

Pré-processador, clique em Continuar.7. Na janela Confirmar Seleção de Importação, clique em Importar.8. Após concluir a importação, clique em OK.9. Para atualizar o arquivo de configuração do CMIS para detectar os tipos de

pasta do IBM Cognos, execute o CMIS para o programa de configuração doContent Manager 8 para criar um perfil.

10. Abra o arquivo cmpathservice.properties na pasta de perfis de configuraçãodo IBM CMIS para Content Manager.Para UNIX, o caminho de arquivo padrão é: /opt/IBM/CM_CMIS/profiles/profile1

Para Windows, o caminho de arquivo padrão é: C:\ProgramFiles\IBM\CM_CMIS\profiles\profile1

a. Localize a linha folderTypes.b. Inclua os tipos de pastas do IBM Cognos COGNOSREPORT e

REPORTVERSION em maiúsculas. Separe cada tipo de pasta com umavírgula.For example,folderTypes = ClbFolder,COGNOSSREPORT,REPORTVERSION

c. Salve e feche o arquivo.11. Execute o CMIS para o programa de configuração do Content Manager 8 e

selecione a opção para reimplementar o arquivo de configuração do CMISautomaticamente.


Nota: Para obter informações adicionais sobre a implementação manual doCMIS, consulte Implementando manualmente o IBM CMIS para ContentManager (http://pic.dhe.ibm.com/infocenter/cmgmt/v8r4m0/topic/com.ibm.installingcmcmis.doc/cmsde001.htm).

12. No console administrativo do WebSphere Application Server, reinicie o CMISpara Content Manager Application.

Especificando um Tempo Disponível para Executar oProcesso de Arquivamento

Para manter o alto desempenho do sistema durante os horários de pico, é possívelconfigurar um período de blecaute para especificar quando as tarefas dearquivamento ou de exclusão serão executadas.

Um período de blecaute é um período temporário no qual a movimentação dedados é negada. Por padrão, um período de blecaute não é definido quando osoftware é instalado.

Procedimento1. Acesse o diretório c10_location/webapps/p2pd/WEB-INF/cm/tasks/manager.2. Usando um editor de texto XML, abra o arquivo tasksManager.xml.3. Por exemplo, para especificar um período de blecaute semanal das 8h às 17h,

de terça-feira à sexta-feira, inclua o seguinte elemento <blackoutPeriods> comoum elemento filho do elemento backgroundTasksManager.v horário de início = <hour>08</hour>

v horário de conclusão = <hour>17</hour>

v dias =<day>Tuesday</day><day>Wednesday</day><day>Thursday</day><day>Friday</day>

4. Se necessário, diminua o número de encadeamentos disponíveis para osprocessos de arquivamento e exclusão. O número máximo de encadeamentos é7.

5. Salve e feche o arquivo.6. Reinicie as atividades em segundo plano no serviço do Content Manager.

Especificando o Tempo de Execução de EncadeamentoÉ possível usar encadeamentos para planejar o tempo de processamento do sistemaoperacional.

As tarefas em segundo plano de arquivamento e exclusão usam encadeamentospara mover conteúdo. Os encadeamentos são unidades de tempo deprocessamento programadas pelo sistema operacional.

Procedimento1. Acesse o diretório c10_location/webapps/p2pd/WEB-INF/cm/tasks/config.2. Usando um editor de texto XML, abra o arquivo archiveTask.xml.3. Por exemplo, para configurar três encadeamentos que executam da meia-noite

às 8h, um encadeamento que execute das 8h às 17h, nenhum encadeamento das17h à meia-noite e todos os encadeamentos que executem todos os dias dasemana, inclua o seguinte elemento <executionPeriods> XML como umelemento filho do elementobackgroundTask.


http://pic.dhe.ibm.com/infocenter/cmgmt/v8r4m0/topic/com.ibm.installingcmcmis.doc/cmsde001.htm

http://pic.dhe.ibm.com/infocenter/cmgmt/v8r4m0/topic/com.ibm.installingcmcmis.doc/cmsde001.htm

<executionPeriods><executionPeriod><threads>3</threads><startTime><hour>00</hour><minute>00</minute></startTime><stopTime><hour>08</hour><minute>00</minute></stopTime><days><day>Monday</day><day>Tuesday</day><day>Wednesday</day><day>Thursday</day><day>Friday</day><day>Saturday</day><day>Sunday</day></days></executionPeriod><executionPeriod><startTime><hour>08</hour><minute>00</minute></startTime><stopTime><hour>17</hour><minute>00</minute></stopTime><days><day>Monday</day><day>Tuesday</day><day>Wednesday</day><day>Thursday</day><day>Friday</day><day>Saturday</day><day>Sunday</day></days></executionPeriod></executionPeriods>


Arquivando Formatos Selecionados de Saídas de RelatórioÉ possível configurar o arquivamento para limitar o arquivamento a formatos desaída específicos. Por padrão, as saídas de qualquer formato, incluindo PDF, XML,HTML e Excel, são arquivadas.

É possível limitar o arquivamento de formatos de saída específicos no repositório.

Procedimento1. Acesse o diretório c10_location/webapps/p2pd/WEB-INF/cm/tasks/config.2. Usando um editor de texto XML, abra o arquivo archiveTask.xml.3. Por exemplo, para definir o arquivamento de apenas versões de saída de

relatório em PDF, inclua o seguinte elemento <outputFormats> XML como umelemento filho do elemento runOptions XML.<outputFormats>

<outputFormat>PDF</outputFormat></outputFormats>

É possível usar o elemento outputFormatsde amostra existente e modificar alista para especificar os formatos de saída a serem arquivados.


Não é possível arquivar seletivamente diversas versões de saída do relatório dearquivo, por exemplo, HTML com gráficos.Salve e feche o arquivo.

Remoção dos Objetos de Versão Marcada da FilaO arquivo deleteTask.xml é um arquivo de configuração para a tarefa em segundoplano chamada deleteTask, que recupera e exclui da fila os objetos de versãomarcada.

Há duas tarefas de manutenção de conteúdo que marcam e movem o conteúdo daversão em uma fila:v O Atualizador de Regras de Retenção que atualiza e aplica as regras de retenção

nos relatórios, consultas, análise e objetos do documentov O Removedor de Conteúdo, que marca as versões e históricos.

O arquivo deleteTask.xml está localizado no diretório c10_location/webapps/p2pd/WEB-INF/cm/tasks/config.

Para obter informações adicionais sobre regras de retenção, consulte o Guia deAdministração e Segurança do IBM Cognos.

Especificando quais Especificações de Relatórios Não EstãoArquivadas

Por padrão, a saída de especificação de relatório é arquivada. As especificações derelatório descrevem como os dados foram gerados em um relatório.

Para desligar o arquivamento das especificações de relatório, você deve modificardois arquivos: CM.xml, e CM_FILENET.xml ou CM_CM8.xml, dependendo de se oconteúdo será arquivado em um repositório do IBM FileNet Content Manager ouem um repositório do IBM Content Manager 8.

Procedimento1. Acesse o diretório c10_location/webapps/p2pd/WEB-INF/repositories/config.2. Usando um editor de texto XML, abra o arquivo CM.xml.3. Comente ou remova a linha a seguir: <property

name="specifications" metadataPropertyName="specification"useTempFile="true"

4. Salve e feche o arquivo.5. Acesse o diretório c10_location/webapps/p2pd/WEB-INF/repositories/config.6. Execute umas das seguintes etapas:

v Se você arquivar o conteúdo no FileNet, abra o arquivo nomeadoCM.FILENET.xml em um editor de texto.

v Se você arquivar o conteúdo no IBM Content Manager 8, abra o arquivonomeado CM.xml em um editor de texto.

7. Comente a linha ou remova o elemento a seguir:<property repositoryName="REPORTEXECUTIONSPECIFICATION" repositoryType="ASSOCIATED"metadataPropertyName="specification">

<associatedObjectTypes><objectType name="VERSIONSPECIFICATION"><properties><property repositoryName="cmis:name" repositoryType="STRING"

metadataPropertyName="reportVersionDefaultName" valueHandler="com.cognos.cm.repositoryPluginFramework.


PropertyValueAppendStringHandler" valueHandlerArgument="_specification"/></properties>

</objectType></associatedObjectTypes>

</property>

Nota: No arquivo CM.xml o, valor de objectType name é <objectTypename="$t!-2_VERSIONSPECIFICATIONv-1">.

8. Reinicie as atividades em segundo plano no serviço do Content Manager. Paraobter informações adicionais, consulte o Guia de Administração e Segurança doIBM Cognos Business Intelligence.



Capítulo 12. Usando Colaboração com o IBM CognosWorkspace

Os recursos de colaboração no IBM Cognos Workspace fornecem uma ponte entreo uso do IBM Cognos Business Intelligence para descobrir um problema denegócios e a ação para resolvê-lo.

As atividades são uma capacidade de colaboração baseada na web para coletar,organizar, compartilhar e reutilizar o trabalho relacionado a uma meta. Osmembros de uma atividade interagem em uma localização on-line na qual elescriam, coletam e compartilham um conjunto de ideias e recursos para oferecersuporte a uma meta. Uma atividade é uma forma de organizar seu trabalho ecolaborar com outras pessoas em um espaço compartilhado da Web. Como é fácilconvidar novos membros, é possível reunir rapidamente as pessoas e os recursoscorretos necessários para realizar a tarefa. É possível publicar mensagens,compartilhar arquivos e links para Web sites, e criar e atribuir itens pendentes. Asatividades fazem parte do IBM Connections e são integradas ao IBM CognosWorkspace.

Para usar atividades com o IBM Cognos Workspace, você deve instalar o IBMConnections e configurá-lo para funcionar com o IBM Cognos BI.

Para obter mais informações sobre o IBM Connections, consulte os seguintes links:v a página do wiki do IBM Connections (http://www.lotus.com/ldd/lcwiki.nsf)v o site de suporte ao cliente (http://www.ibm.com/support/

docview.wss?uid=swg27012786)Tarefas relacionadas:“Configuração do URI de descoberta de colaboração” na página 305É possível configurar o IBM Cognos Business Intelligence e o IBM CognosWorkspace para usarem o IBM Connections para tomada de decisão colaborativa.A integração com o IBM Connections permite que usuários corporativos colaboremao criar ou visualizar relatórios, executar análise ou monitorar áreas de trabalho.Os usuários têm acesso a atividades do IBM Connections a partir do IBM CognosWorkspace e à página inicial do IBM Connections a partir do IBM Cognos BI e doIBM Cognos Workspace.

Modificando o IBM Connections para IBM Cognos BIPara ativar a colaboração entre o IBM Cognos BI e o IBM Connections, você devemodificar dois arquivos de configuração do IBM Connections.

Procedimento1. Acesse o diretório WebSphere_location\profiles\Dmgr01\config\cells\

computer_name\LotusIBMConnections-config, e abra o arquivo denominadooa-config.xml em um editor de texto.

2. No final do arquivo, mas antes do elemento </config>, inclua o seguinteelemento:<WidgetRedirectWhitelist><domain>.*\.mycompany\.com</domain></WidgetRedirectWhitelist>

Em que .mycompany e .com compõem seu domínio.


http://www.lotus.com/ldd/lcwiki.nsf


3. Salve e feche o arquivo.4. Acesse o diretório WebSphere_location\profiles\connections_profile\

InstalledApps\computer_nameNode##Cell\LotusConnections-config e abra oarquivo denominado LotusConnections-config.xml em um editor de texto.

5. Altere o valor para profiles_directory_service_extension_enabled para"false". Por exemplo, <sloc:serviceReferenceprofiles_directory_service_extension_enabled="false"serviceName="directory"/>.

6. Altere o valor para ssl_enabled para "false". Por exemplo,<sloc:serviceReference acf_config_file="acf-config-nf.xml"bootstrapHost="" bootstrapPort="" clusterName="Cluster02"enabled="false"person_card_service_name_js_eval="generalrs.label_personcard_activitieslink"person_card_service_url_pattern="/service/html/mainpage#dashboard%2Cmyactivities%2Cuserid%3D{userid}%2Cname%3D{displayName}"serviceName="activities" ssl_enabled="false">.

7. Salve e feche o arquivo.8. Sincronize seus nós e reinicie o IBM WebSphere Application Server.9. Abra o console administrativo do IBM WebSphere Application Server.

10. Clique no link da página Secure administration, applications, andinfrastructure.

11. Na seção Autenticação, clique em Segurança da Web > Conexão Única (SSO).12. Na caixa de diálogo Domain name, informe o nome do domínio. Por

exemplo, digite .mycompany.com.Certifique-se de incluir o ponto antes do nome do domínio. Se houversubdomínios diferentes na rede, certifique-se de usar somente a parte comumdo nome do domínio. Por exemplo, o IBM Cognos BI está instalado em umcomputadr com .deptA.mycompany.com como o domínio e IBM Connectionsestá instalado em um computador com .deptB.mycompany.com, você deveincluir somente a parte .mycompany.com do nome do domínio.

13. Clique em OK e em Save.

Ativando a Conexão Única entre o IBM Connections e o IBM CognosBusiness Intelligence

Para ativar a conexão única entre o IBM Connections e o IBM Cognos BusinessIntelligence com seu servidor da web como o ponto de acesso, você deve instalarum plug-in de servidor da web fornecido com a instalação do IBM WebSphereApplication Server.

Procedimento1. Instale os componentes do IBM Cognos Business Intelligence.

Se estiver distribuindo sua instalação, você deverá instalar o componente deGateway no computador do servidor da web. Se você estiver usando umainstalação de servidor único, instale todos os componentes.Você deve instalar o componente de Gateway no computador do servidor daweb para que o conteúdo estático fique disponível.

2. Crie um diretório virtual para o gateway denominado /p2pd/servlet queaponta para o diretório c10_location/webcontent.

3. Execute s instalação do WebSphere Application Server e selecione a instalaçãode plug-in do servidor da web.


4. Siga as etapas no assistente e certifique-se de selecionar o servidor da webapropriado.Para obter informações adicionais sobre a instalação do plug-in, consulte aseguinte página do IBM WebSphere: http://publib.boulder.ibm.com/infocenter/wasinfo/v6r0/index.jsp?topic=/com.ibm.websphere.nd.doc/info/ae/ae/tins_road_plugins.html

5. Acesse o diretório c10_location\webapps\p2pd\WEB-INF no computador emque instalou o IBM Cognos BI e abra o arquivo denominado arquivoibm-web-ext.xmi em um editor de texto.

6. Mude todos os valores para fileServingEnabled para false.7. Salve e feche o arquivo.8. Acesse o diretório c10_location\war\p2pd e execute as seguintes etapas:

v Abra o arquivo denominado application.xml.template em um editor detexto.

v Edite a seção do aplicativo para incluir um elemento de função desegurança, conforme mostrado no seguinte exemplo:<application>

<display-name>IBM Cognos</display-name><module>

<web><web-uri>@p2pdwar@</web-uri><context-root>@p2pd@</context-root>

</web></module><security-role id="SecurityRole_Cognos_BI_User">

<description/><role-name>BI User</role-name>

</security-role></application>

v Salve e feche o arquivo.Depois de instalado o aplicativo IBM Cognos no IBM WebSphere, você deveativar a função de segurança.

9. Acesse o diretório c10_location\webapps\p2pd\WEB-INF e execute as seguintesetapas:v Se você tiver instalado o Content Manager no computador, abra o arquivo

denominado web.xml.withCM em um editor de texto.Se o Content Manager não foi instalado no mesmo computador, abra oarquivo denominado web.xml.noCM.

v Após a última seção de mapeamento de servlet e antes do fechamento doelemento web-apps, inclua o seguinte texto:<security-constraint>

<web-resource-collection><web-resource-name>Cognos Dispatcher</web-resource-name>

<url-pattern>/servlet/dispatch/ext/*</url-pattern><http-method>GET</http-method><http-method>POST</http-method>

</web-resource-collection><auth-constraint>

<role-name>BI User</role-name></auth-constraint>

</security-constraint><login-config>

<auth-method>BASIC</auth-method><realm-name>Cognos Dispatcher</realm-name>

Capítulo 12. Usando Colaboração com o IBM Cognos Workspace 349

http://publib.boulder.ibm.com/infocenter/wasinfo/v6r0/index.jsp?topic=/com.ibm.websphere.nd.doc/info/ae/ae/tins_road_plugins.html



</login-config><security-role>

<role-name>BI User</role-name></security-role>

v Salve e feche o arquivo.10. Use o IBM Cognos Configuration para criar o arquivo de implementação para

instalar no IBM WebSphere.Certifique-se de não incluir o conteúdo estático ao gerar o arquivo EAR.

11. Configure o IBM Cognos BI confome requerido usando o IBM CognosConfiguration, incluindo sua proteção usando a mesma fonte de autenticaçãousada para o IBM Connections, e salve sua configuração.

12. Instale o aplicativo IBM Cognos no IBM WebSphere Application Server.Para obter uma conexão única, você deverá ativar uma função de usuárioapós instalar o aplicativo.v No console administrativo do , clique em Aplicativos > Aplicativos

corporativos.v Clique em IBM Cognos.v Na seção Detail properties, clique em Security role to user/group

mapping.v Selecione a caixa de opção Selecionar para Usuário do BI e selecione Tudo

Autenticado no Domínio do Aplicativo na caixa Mapear AssuntosEspeciais.

v Clique em OK e em Save.13. No console administrativo do IBM , sob Servidores, clique em Servidores da

web. Selecione o servidor da web e clique em Gerar Plug-in.14. Selecione o servidor da web novamente e clique em Preparar Plug-in.15. Se você não estiver usando um IBM WebSphere Network Deployment, você

deverá trocar de chaves entre os perfis do IBM WebSphere.v No console administrativo do , clique em Segurança > Proteger

administração, aplicativos e infraestrutura.v Em Autenticação > Mecanismos e expiração de autenticação.v Na Seção de conexão única de célula cruzada, insira uma senha.v Exporte a chave e, em seguida, importe-a no outro perfil.v Repita estas etapas para o outro perfil para importar uma chave do perfil B

para o perfil A e importar uma chave do perfil A para o perfil B.

Resultados

Para acessar o portal do IBM Cognos BI, sua URL é http://web_server_name/p2pd/servlet/dispatch/ext


Capítulo 13. 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.

Se você atualizou do ReportNet e o IBM Cognos detectar um namespaceconfigurado que não está mais configurado, o namespace desconfigurado aparecerána lista de provedores de autenticação no portal Administração. Configure onamespace se ainda precisar das informações de conta de usuário. Caso contrário,exclua o namespace. Para obter informações sobre a exclusão do namespace,consulte o Guia de administração e segurança.

Além disso, ao atualizar de uma versão para outra, utilize o mesmo namespace deautenticação para ambas as versões. Caso contrário, o conteúdo seguro antigo nãoestará disponível, pois a nova versão pode não conter as mesas políticas, usuários,funções e grupos.

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

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 Directoryv SAP BW

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.

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

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.Tarefas relacionadas:“Configurar Segurança para um Módulo de Amostra do Google OneBox” napágina 445Por padrão, os aplicativos do Google OneBox são abertos e anônimos. Se o seuaplicativo requerer autenticação segura, você deverá configurar o Google SearchAppliance (GSA) e a instalação do IBM Cognos corretamente.

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 mais informações, consulte apublicação IBM Cognos Business Intelligence Administration and Security Guide.

3. Na janela Propriedades, clique na caixa próxima à propriedade Permitir acessoanônimo e selecione Falso.


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.

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.

Capítulo 13. Configurando Componentes do IBM Cognos para Usar um Provedor de Autenticação 353

Configurando Componentes do IBM Cognos para Usar o ActiveDirectory Server

Se você instalar o Content Manager em um computador com sistema operacionalMicrosoft Windows, é possível configurar o Active Directory como sua fonte deautenticação usando um namespace Active Directory.

Se instalar o Content Manager em um computador baseado em UNIX, você deveráusar um namespace do LDAP para configurar o Active Directory como sua fontede autenticação. Se instalar um Content Manager em uma combinação decomputadores Windows e UNIX, você deve usar um namespace LDAP paraconfigurar o Active Directory para todos os Content Managers. Ao utilizar onamespace de LDAP para autenticar em relação ao Servidor do Active Directory,ficará limitado somente aos recursos do LDAP. Não haverá acesso aos recursos doActive Directory como as propriedades avançadas para domínios e conexão únicautilizando delegação Kerberos .

Se você instalar o Content Manager em um computador baseado em Linux, asmesmas restrições do UNIX serão aplicadas. É preciso utilizar um namespace doLDAP para configurar 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.

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

Cognos


Conceitos relacionados:“Ativar Conexão Única entre os Componentes do Active Directory Server e IBMCognos” na página 359Por padrão, o provedor do Active Directory usa a autenticação Kerberos. Ele seintegrará ao servidor da web IIS para conexão única, se a autenticação doWindows (anteriormente nomeada NT Challenge Response) for ativada no servidorda web IIS.Informações relacionadas:“Inclusão ou exclusão de domínios utilizando Propriedades avançadas” na página357Quando 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.“Configure um Namespace LDAP para o Active Directory Server” na página 371Se 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.

Configurar namespaces 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 deve ser atribuído para o Web site da intranet local no navegadorweb.

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.



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.

Resultados

IBM Cognos carrega, inicializa e configura as bibliotecas do provedor para onamespace.

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 mais informações,consulte a publicação IBM Cognos Business Intelligence Administration and SecurityGuide.


Configuration.


2. Na janela Explorer, em Segurança > Autenticação, clique no namespace doActive Directory.

3. Na janela Propriedades, clique na coluna Valor para PropriedadesCustomizadas 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.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.


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 74. 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.8. No menu Arquivo, clique em Salvar.Informações relacionadas:“Configurando Componentes do IBM Cognos para Usar o Active Directory Server”na página 354Se você instalar o Content Manager em um computador com sistema operacionalMicrosoft Windows, é possível configurar o Active Directory como sua fonte deautenticação usando um namespace Active Directory.

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 75. 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 Conexão Única entre os Componentes do ActiveDirectory Server e IBM Cognos

Por padrão, o provedor do Active Directory usa a autenticação Kerberos. Ele seintegrará ao servidor da web IIS para conexão única, se a autenticação doWindows (anteriormente nomeada NT Challenge Response) for ativada no servidorda web IIS.

Se a autenticação do Windows for ativada, não será solicitado que você insiranovamente as informações de autenticação ao acessar o conteúdo do IBM Cognosque é assegurado pelo namespace do Active Directory.

Se você usar a autenticação do Kerberos, poderá 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 estão no domínio do Active Directory. Para ativar o S4U,você deve usar Ativar a delegação restrita.

Por exemplo, há usuários cujos computadores não pertencem ao domínio, mas elespossuem 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 privilégio de Identidade, o que impede que eles sejam autenticadospara o IBM Cognos BI. Para resolver esse problema, é possível usar o S4U.

Se você não desejar a autenticação do Kerberos, poderá configurar o provedor paraacessar 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ê deveassegurar-se de concluir as tarefas a seguir:1. Configure a autenticação do Windows no servidor da web IIS.2. Instale o Content Manager em um computador que seja parte do domínio do

Active Directory, para os Content Managers ativos e em espera.


3. Configure os computadores ou a conta do usuário na qual o Content Manageré executado para ser confiável.

Informações relacionadas:“Configurando Componentes do IBM Cognos para Usar o Active Directory Server”na página 354Se você instalar o Content Manager em um computador com sistema operacionalMicrosoft Windows, é possível configurar o Active Directory como sua fonte deautenticação usando um namespace Active Directory.

Ativando a Conexão Única para Usar a Autenticação doKerberosSe o servidor da web IIS estiver configurado para autenticação do Windows, vocênão precisará incluir nenhuma configuração adicional. A autenticação do Kerberosé usada como padrão.

Ativando Conexão Única para Usar Autenticação do Kerberoscom Delegação RestritaPara poder usar delegação restrita, você deve definir os Service Principal Names(SPN) para os usuários configurados para executar os componentes do IBMCognose a ferramenta de aplicativo do servidor da web Microsoft Internet InformationServices (IIS) no domínio do Active Directory.

Se você usar o Kerberos com delegação restrita, deverá incluir um usuário desAMAccountName para o Content Manager ao configurar o gateway. Todos osContent Managers ativos e em espera devem ser configurados para seremexecutados na mesma conta.

Se você estiver configurando a conexão única para servidores de banco de dados,deverá configurar o sAMAccountName para o usuário que executa os Componentesda Camada e Aplicativos ao incluir o namespace do Active Directory. Todos osComponentes da Camada de Aplicativos devem ser configurados para seremexecutados na mesma conta.

Os SPNs são os usuários inseridos nos campos sAMAccountName no IBM CognosConfiguration.

Por exemplo, suponha que tenha um usuário que executa o componente ContentManager, outro que executa os Componentes da Camada de Aplicativos e outroque executa a ferramenta de aplicativo do servidor da web. O usuário do ContentManager é CognosCMUser. O usuário dos Componentes da Camada de Aplicativos éCognosATCUser. O usuário do conjunto de aplicativos é IISUser. Cada usuá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 usuários do IBM Cognos.Por exemplo:setspn -A ibmcognosba/CognosCMUser MyDomain\CognosCMUsersetspn -A ibmcognosba/CognosATCUser MyDomain\CognosATCUser


Nesses comandos, você deve usar ibmcognosba conforme mostrado nosexemplos. Os nomes de usuários e os domínios devem corresponder ao seuambiente.

Nota: Nesse exemplo, os usuários do sAMAccountName que você deve inserir sãoCognosCMUser e CognosATCUser.

4. Se você estiver configurando a conexão única para o servidor de banco dedados Microsoft SQL Server ou Microsoft SQL Server Analysis Services, deveráconfigurar o SPN para o servidor de banco de dados. Para obter informaçõesadicionais, consulte a documentação do servidor de banco de dados.

5. Finalmente, você deve configurar a delegação restrita na ferramenta deadministração Computadores e Usuários do Active Directory. Na guiaDelegação para todos os usuários (IISUser, CognosCMUser e CognosATCUser),você deve selecionar Confiar este usuário da delegação apenas aos serviçosespecificados e Usar apenas o Kerberos para usar o Kerberos com delegaçãorestrita. Selecione Confiar este usuário da delegação apenas aos serviçosespecificados e Usar qualquer protocolo de autenticação se você estiverusando a extensão do Kerberos S4U.E, em seguida, você deve incluir os SPNs necessários. Por exemplo, inclua oibmcognosba como um tipo de serviço. E inclua DomainController1 eDomainController2 como o tipo de serviço ldap.Se você estiver configurando a conexão única para a origem de dados, inclua oserviço MSOLAPSvc3 ou MSQLSVC.

Procedimento1. No computador em que o Content Manager foi instalado, 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 desejar usar a autenticação doKerberos primeiro. Se o Kerberos falhar, haverá a tentativa de autenticaçãode Service For User (S4U). Se o S4U falhar, as credenciais serão solicitadasao usuário.

v Insira S4UAuthentication se desejar usar a autenticação S4U primeiro. Se oS4U falhar, as credenciais serão solicitadas ao 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 desejar salvar as credenciais do usuário comouma credencial confiável. Por exemplo, se desejar usar as credenciais paraexecutar tarefas planejadas.

v Insira S4UForTC se desejar salvar apenas o nome de usuário autenticadocomo uma credencial confiável. O nome de usuário é salvo no formatoUPN, 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 Componentes da Camada de AplicativossAMAccountName, e insira o sAMAccountName do usuário que executa osComponentes da Camada de Aplicativos.

Importante: Esse valor apenas será necessário se você estiver configurando aconexão única para o servidor de banco de dados Microsoft SQL Server ouMicrosoft SQL Server Analysis Services. Se você não estiver configurando aconexã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 Gateway, abra o IBM

Cognos Configuration.15. Na janela Explorer, clique em Ambiente.16. Clique na coluna Valor para o Content Manager sAMAccountName, 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 IBM Cognos para Usar REMOTE_USERSe não desejar a autenticação do Kerberos, poderá configurar o provedor paraacessar a variável de ambiente REMOTE_USER para atingir a conexão única.

Você deve configurar a propriedade avançada singleSignOnOption como o 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, você também poderá escolher salvar o REMOTE_USERcomo uma credencial confiável. Salvar como uma credencial confiável significa queas tarefas planejadas autenticam o REMOTE_USER com os privilégios de Credencialde Ligação.


Procedimento1. No computador em que o Content Manager foi instalado, 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 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. Usuários serão autenticadoscom base na autenticação e configuração de conexão do namespace IBM CognosSeries 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.

É 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.Do contrário, podem ser recebidos erros ou avisos de autenticação mais de umavez. 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

Configurar um Namespace IBM Cognos Series 7É possível configurar o IBM Cognos para usar um ou mais namespaces IBMCognos Series 7 para autenticação.







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 vocêestiver publicando do PowerPlay Enterprise Server para o IBM Cognos BI,você deve usar o mesmo formato de valor usado no Gerenciador deConfiguração do IBM Cognos Series 7 para o local do servidor de diretório.Por exemplo, se o nome do servidor for usado no Gerenciador deConfiguração do IBM Cognos Series 7, você também deve usar o nome doservidor no IBM Cognos Configuration 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.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.

8. Na janela Propriedades, em Configurações de Cookie, certifique-se de que aspropriedades Caminho, Domínio e Sinalizador Seguro Ativadocorrespondam às configurações definidas para o IBM Cognos Series 7.



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.7. Se o namespace IBM Cognos Series 7 usar o plug-in de Conexão Confiável para

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

unsigned long *trustedDomainNameLength, /*[OUT]*/

SAFER_USER_TYPE *userType, /*[OUT]*/

void **implementerData); /*[IN/OUT]*/

Parâmetros para a função SaferAPIGetTrustedSignonWithEnv

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


Tabela 76. Parâmetros e Descrição para a FunçãoSaferAPIGetTrustedSignonWithEnv (continuação)


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

[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 utilizar um provedor de autenticação customizada para acessar eautenticar usuários em uma fonte de autenticação alternativa. Também é possívelusá-lo como um mecanismo de conexão única para integrar componentes do IBMCognos com sua infraestrutura de segurança. É possível ocultar namespaces deusuários durante o logon.

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 de


autenticaçã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


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.



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

Resultados


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 Usar 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 mais informações, consulte a publicaçãoIBM Cognos Business Intelligence Administration and Security Guide.

Você também tem a opção de disponibilizar propriedades de usuário customizadasa partir do namespace LDAP para componentes do IBM Cognos.

Caso queira vincular os usuários ao servidor LDAP, consulte “MapeamentoLDAP”.

Procedimento1. “Configuração de namespaces LDAP” na página 3702. 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 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 do LDAP faz as procuras, ele utiliza os filtrosespecificados nas propriedades Consulta de usuário e Mapeamento de identidadeexterna. Também vincula ao servidor de diretórios utilizando o valor especificadona propriedade Vincular DN do usuário e senha ou utilizando anônimo se nenhumvalor for especificado.

Quando um namespace LDAP foi configurado para utilizar a propriedadeMapeamento de identidade externa para autenticação, o provedor de LDAPvincula ao servidor de diretórios utilizando Vincular DN do usuário e senha ouutilizando anônimo se nenhum valor é especificado. Todos os usuários queprecisam efetuar logon no IBM Cognos usando mapeamento de identidade externavêem os mesmos usuários, grupos e pastas que 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 buscas são feitas utilizando as credenciais de usuárioou utilizando anônimo se nenhum valor for especificado. Quando a propriedadeestá desativada, que é a configuração padrão, as buscas são feitas utilizando ascredenciais do usuário logado. O benefício de utilizar credenciais de ligação é queem vez de alterar direitos administrativos para vários usuários, é possível alteraros direitos administrativos somente para o usuário vinculado.

Observe que se você usar uma sintaxe de DN, como uid=${userID},ou=mycompany.com, para as propriedades Consulta de usuário, Mapeamento deidentidade externa ou Senha e DN do usuário de ligação, você deverá escapartodos os caracteres especiais usados no DN. Se usar uma sintaxe de procura, como(uid=${userID}), para as propriedades Consulta do usuário ou Mapeamento deidentidade externa, você não deverá escapar caracteres especiais usados no DN.

Configuração de namespaces 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.






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 a um servidor dediretórios utilizando um Vincular DN do usuário e senha determinado aoprocurar, 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 é estabelecido,solicitações posteriores ao servidor LDAP são executadas sob o contexto deautenticação do usuário final.

8. Se não usar mapeamento de identidade externa, use credenciais de ligaçãopara buscar o servidor de diretórios LDAP executando 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.Se não forem especificadas uma ID do usuário e senha, um acesso anônimoserá ativado e a busca será feita utilizando anônimo.

9. Verifique as configurações do mapeamento para objetos e atributosobrigató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.



Resultados


Configure um Namespace 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.


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.


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.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 a um servidor dediretórios utilizando um Vincular DN do usuário e senha determinado aoprocurar, 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 77. 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


Membro membro

Nome cn


Tabela 77. Valores de Mapeamento Avançado do LDAP para Uso com Objetos do ActiveDirectory Server (continuação)


Conta Classe do objeto usuário

Telefone comercial telephonenumber

Código do idioma doconteúdo

(deixar em branco)


E-mail correio

Fax/telefone facsimiletelephonenumber

Nome fornecido givenname

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. Caso tenha modificado oesquema, pode ser necessário realizar mudanças de mapeamento adicionais.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.



Resultados



Informações relacionadas:“Configurando Componentes do IBM Cognos para Usar o Active Directory Server”na página 354Se você instalar o Content Manager em um computador com sistema operacionalMicrosoft Windows, é possível configurar o Active Directory como sua fonte deautenticação usando um namespace Active Directory.

Configurando um Namespace LDAP para IBM Directory ServerSe 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.



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 provedor de namespace de autenticação aparece na janelaExplorer, no componente Autenticação.


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 Senha e DN do usuário de ligação, especifique cn=root

7. Se desejar que o provedor de autenticação LDAP se vincule a um servidor dediretórios utilizando um Vincular DN do usuário e senha determinado aoprocurar, especifique esses valores.Se não houver valores especificados, o namespace de autenticação LDAPvincula como anônimo.


senha.9. Para configurar as propriedades de mapeamento avançadas do LDAP para

uso com objetos do IBM Directory Server, use os valores especificados naseguinte tabela.

Tabela 78. Valores de Mapeamento Avançado do LDAP para Uso com Objetos do IBMDirectory Server


Pasta Classe do objeto organizationalunit,organization,contêiner


Tabela 78. Valores de Mapeamento Avançado do LDAP para Uso com Objetos do IBMDirectory Server (continuação)



Nome ou,o,cn

Grupo Classe do objeto groupofnames


Membro membro

Nome cn

Conta Classe do objeto inetorgperson



(deixar em branco)


E-mail correio




Telefone celular mobile

Nome cn

Pager pager

Senha userPassword



(deixar em branco)

Sobrenome sn

Nome de usuário uid

Essas propriedades de mapeamento representam mudanças baseadas em umainstalação padrão do IBM Directory Server. Caso tenha modificado o esquema,pode ser necessário realizar mudanças de mapeamento adicionais.


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.


Configuração de namespaces LDAP para 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.



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.


5. Na janela Propriedades, para a propriedade ID do Namespace, especifiqueum identificador exclusivo para o namespace.


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 Senha e DN do usuário de ligação, especifique o DN base para umusuário de administração, como cn=Admin,0=COGNOS

7. Se desejar que o provedor de autenticação LDAP se vincule a um servidor dediretórios utilizando um Vincular DN do usuário e senha determinado aoprocurar, especifique esses valores.Se não houver valores especificados, o namespace de autenticação LDAPvincula como anônimo.



uso com objetos do Novell Directory Server, utilize valores especificados naseguinte tabela.


Tabela 79. Valores de Mapeamento Avançado do LDAP para Uso com Objetos do NovellDirectory Server


Pasta Classe do objeto organizationalunit,organization,contêiner


Nome ou,o,cn

Grupo Classe do objeto groupofnames


Membro membro

Nome cn

Conta Classe do objeto inetOrgPerson



Idioma


E-mail correio




Telefone celular mobile

Nome cn

Pager pager

Senha (deixar em branco)



Idioma

Sobrenome sn



Essas propriedades de mapeamento representam as mudanças baseadas emuma instalação padrão do Novell Directory Server. Caso tenha modificado oesquema, pode ser necessário realizar mudanças de mapeamento adicionais.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 os usuários efetuarem login com sucesso no IBM Cognos Connection,eles deverão ter permissão para ler os atributos ou e o.


Configurando um Namespace LDAP para 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.


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.


5. Na janela Propriedades, para a propriedade ID do Namespace, especifiqueum identificador exclusivo para o namespace.


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 a um servidor dediretórios utilizando um Vincular DN do usuário e senha determinado aoprocurar, especifique esses valores.


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



uso com objetos do Oracle Directory Server, use os valores especificados natabela a seguir.

Tabela 80. Valores de Mapeamento Avançado do LDAP para Uso com Objetos do OracleDirectory Server


Pasta Classe do objeto organizationalUnit,organization


Nome ou,o

Grupo Classe do objeto groupofuniquenames


Membro uniquemember

Nome cn

Conta Classe do objeto inetorgperson



preferredlanguage


E-mail correio




Telefone celular dispositivo móvel

Nome cn

Pager pager

Senha userPassword



preferredlanguage

Sobrenome sn


Essas propriedades de mapeamento representam as mudanças baseadas emuma instalação padrão do Oracle Directory Server. Caso tenha modificado oesquema, pode ser necessário realizar mudanças de mapeamento adicionais.


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.


Disponibilizando Propriedades de Usuário Customizadas parao LDAP 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 IBMCognos Business 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, clique no namespace 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 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 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.

Ativação da comunicação segura com 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


v certificado raiz confiável e todos os outros certificados que compõem a cadeia deconfiança para o certificado de servidor de diretórios.O certificado raiz confiável é o certificado da autoridade de certificação raiz queassinou o certificado do servidor de diretórios.

v Somente o certificado do servidor de diretórios.

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 trabalha com as versões cert8.db e cert7.db do banco de dados decertificado de cliente. É preciso utilizar a ferramenta certutil do kit de ferramentasNetscape OpenSource NSS_3_3_2_RTM para criar o banco de dados de certificados.O IBM Cognos não aceita outras versões de arquivos cert8.db, incluindo aquelas daferramenta certutil fornecida com o Microsoft Active Directory. A ferramentacertutil adequada está disponível no Web site do FTP do Mozilla.

Você também deve usar a versão 4.6.7 da biblioteca NSPR, que está disponível doWeb site FTP na Mozilla.

Procedimento1. Crie um diretório para o banco de dados de certificados.2. Crie um banco de dados de certificado digitando

certutil -N -d certificate_directory

onde diretório_certificado é o diretório criado 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 de CA, digite

certutil -A -n certificate_name -d certificate_directory -i CA.cert-t C,C,C

v Para um certificado do servidor de diretórios, digitecertutil -A -n certificate_name -d certificate_directory -iserver_certificate.cert -t P

onde nome_certificado é um alias atribuído, como o nome da CA ou nome host;e certificado_servidor é o prefixo do arquivo de certificado do servidor dediretórios.

4. Copie o diretório de banco de dados do certificado para o diretóriolocal_c10/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.


7. Na janela Explorer, em Segurança > Autenticação, clique no namespaceLDAP.

8. Na janela Propriedades, para a propriedade Host e porta, altere a porta paraproteger a porta LDAPS.Para a propriedade Banco de dados de certificados SSL, especifique ocaminho para 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 6 a 11 em cada local onde o Content Manager está instalado.

Ativando a Conexão Única entre LDAP e Componentes do 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. No caso de um gateway de servidor deaplicativos ou entrada de dispatcher apontando para componentes do IBM Cognos,o Mapeamento de Identidade Externa pode se referir à variável de sessãouserPrincipalName. O valor resolvido da propriedade Mapeamento de identidadeexterna no tempo de execução deve ser um DN de usuário válido.

Quando um namespace LDAP é configurado para utilizar a propriedadeMapeamento de identidade externa para autenticação, o provedor de LDAPvincula ao servidor de diretórios utilizando Vincular DN do usuário e senha ouutilizando anônimo se nenhum valor é especificado. Todos os usuários queprecisam efetuar logon no IBM Cognos usando mapeamento de identidade externavêem os mesmos usuários, grupos e pastas que 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 da propriedade. Para obter mais informações, consulte a ajuda on-line para oIBM Cognos Configuration.

É possível aplicar edição de expressão limitada à propriedade Mapeamento deidentidade externa utilizando a operação de substituição.

Operação de SubstituiçãoA operação de substituição retorna uma cópia da string com todas as ocorrênciasda subsequência anterior substituída pela nova.

As seguintes regras aplicam-se:v O caractere \ evita os caracteres nos parâmetros da função. Caracteres como \ e

" precisam ser evitados.v Chamadas de funções aninhadas não são suportadas.v Caracteres especiais não são suportados.


Sintaxe

${replace(str , old , new)}

Parâmetros para a operação de substituição

Tabela 81. Parâmetros e Descrição para a Operação de Substituiçã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 das Propriedades do 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.

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 IBM Cognos para UsarREMOTE_USER” na página 362.


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 usarum 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 IBM Cognos para UsarREMOTE_USER” na página 362.


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.

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 82. 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 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.11. Na janela Propriedades, especifique a propriedade Host e qualquer outros

valores 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


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

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.


Quando um namespace RACF é configurado para usar mapeamento de identidadepara autenticação, o namespace RACF se liga ao provedor RACF usando ascredenciais de ligação ou anonimamente 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.


Configuration.2. Na janela Explorer, em Segurança, clique com o botão direito 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 deedição.

5. Na caixa de diálogo Valor- Credenciais de ligação, especifique a ID de usuárioe 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.

No SAP BW, é possível atribuir usuários a grupos ou papéis de usuários ou ambos.O provedor de autenticação SAP utiliza apenas papéis.

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

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

Conectividade entre SAP BW e IBM Cognos no UNIX

Para configurar a conectividade entre o SAP BW e os componentes do IBM Cognosem um sistema operacional UNIX, certifique-se de instalar o arquivo de bibliotecacompartilhado do SAP (fornecido pelo SAP) e de incluí-lo na variável de ambientedo caminho da biblioteca da seguinte forma:v Solaris

LD_LIBRARY_PATH=$LD_LIBRARY_PATH:<librfccm.so_directory>v HP-UX

SHLIB_PATH=$SHLIB_PATH:<librfccm.sl_directory>v AIX

LIBPATH=$LIBPATH:<librfc.a_directory>

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.

4. Na janela Explorer, em Segurança, clique com o botão direito 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.


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.



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.


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 mais informações, consulte apublicação IBM Cognos Business Intelligence Administration and Security Guide.

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 mais informações, consulte o Guia de Administração eSegurança do IBM Cognos Business Intelligence.

Resultados

Após a exclusão de um namespace, ele aparece como Inativo no portal.



Capítulo 14. Usando um Servidor de Aplicativos Diferente doTomcat

IBM Cognos Business Intelligence instala e usa Tomcat como servidor deaplicativos por padrão. No entanto, é possível optar por executar o IBM Cognos BIem outro servidor de aplicativos suportado em substituição.

Os servidores de aplicativos que podem ser usados para executar IBM Cognos BIincluem o seguinte:v IBM WebSphere Application Serverv Oracle WebLogic Serverv Red Hat JBossv SAP NetWeaver

Para IBM Cognos BI para Linux no System z, o IBM WebSphere ApplicationServer é suportado.

Para garantir que seu produto funcione corretamente, aplique todas as correçõesdo sistema operacional minimamente necessárias e use apenas as versões de outrossoftwares que sejam suportadas para um produto IBM Cognos.

Também é possível optar por executar o IBM Cognos Servlet Gateway em umservidor de aplicativos suportado em vez de usar um servidor da web. Ao usar ogateway de servlet, o ambiente dispensa o uso de servidores web. O servidor deaplicativos e o gateway de servlet substituem as funções fornecidas pelo servidorda Web e outros gateways do IBM Cognos.

Para configurar o IBM Cognos BI para execução em seu servidor de aplicativos,faça o seguinte:v Crie uma instância JVM separada, se necessário.v Verifique se os componentes do IBM Cognos estão configurados corretamente.v Faça backup de quaisquer dados e chaves de criptografia existentes do IBM

Cognos, se necessário.v Defina variáveis de ambiente.v Inclua a função de usuário para ativar a conexão única para colaboração com o

IBM Connectionsv Configure componentes do IBM Cognos para execução no servidor de

aplicativos.v Identifique o JDK para WebLogic 9 no AIX, se necessário.v Mudança do script de inicialização do servidor de aplicativos, se necessário.v Configure propriedades do servidor de aplicativo e implemente o IBM Cognos

BI.v Ative o SSL, se necessário.v Configure o servidor web.v Remova o registro de dispatchers que não são mais utilizados.


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 do servidor separada no IBM WebSpherev Um servidor gerenciado separado no Oracle WebLogicv Uma instância de servidor separada para Red Hat JBoss.v Uma instância Java separada para SAP NetWeaver

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.

Não é necessário alterar essas configurações, se você estiver usando o Tomcat comoo servidor de aplicativos.

Por exemplo, pode: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.

Fazer Backup das Informações IBM Cognos ExistentesVocê deve fazer backup de informações existentes do IBM Cognos se oscomponentes do IBM Cognos Business Intelligence estiverem em execução em umservidor de aplicativos (incluindo Tomcat) e você estiver mudando para umservidor de aplicativos fornecido com sua própria JVM. Você também deve fazerbackup de informações existentes do IBM Cognos se precisar alterar a JVM queestá usando.

Nota: Você deve fazer backup de informações existentes do IBM Cognos noambiente de trabalho antes da atualização.

Antes de configurar componentes do IBM Cognos BI para a execução no novoservidor de aplicativos ou JVM, você deve 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 uma localização alternativa. Novas chaves

criptográficas devem ser criadas utilizando o mesmo JVM que o servidor deaplicativos utiliza. 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. As chaves criptográficas existem se esse diretórioincluir os subdiretórios a seguir: 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.

Capítulo 14. Usando um Servidor de Aplicativos Diferente do Tomcat 395

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 o 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 Tomcat, pare o serviço do IBM Cognos e feche o IBM Cognos

Configuration.v Se você usar um servidor de aplicativos diferente do Tomcat, encerre o IBM

Cognos BI em seu ambiente.4. Faça backup de chaves criptográficas existente salvando arquivos e diretórios

corretos em uma localização alternativa que seja segura.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 nesse arquivo serão automaticamente criptografadas novamenteusando novas chaves criptográficas quando você salvar 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 403.

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 85. Variáveis de Ambiente do Servidor de Aplicativos


Windows PATH

AIX LIBPATH


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 a stringpara:<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.

Incluir a Função de Usuário para Ativar Conexão Única entre os Perfisdo IBM WebSphere

Se estiver usando a colaboração com o IBM Connections e desejar ativar a conexãoúnica entre os perfis do IBM WebSphere, você deverá modificar dois arquivos deconfiguração do IBM Cognos Business Intelligence antes de construir e instalar seuaplicativo IBM Cognos BI.

Para configurar a conexão única, você deve configurar uma senha compartilhadaentre o perfil que está sendo usado para o IBM Connections e o perfil que estásendo usado para o IBM Cognos BI. Para obter mais informações, consulte IBMWebSphere http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp.

A conexão única entre o IBM Cognos BI e o IBM Connections é ativada pelo IBMWebSphere. Isso significa que você deve acessar o IBM Cognos BI diretamente pormeio do dispatcher em vez de por meio do servidor da Web. Por exemplo, em vezde acessar o aplicativo IBM Cognos BI a partir de uma URL comohttp://webserver_name/ibmcognos, você terá que acessá-lo através da URL dedispatcher, como http://WebSphere_servername.domain:port/p2pd/servlet/dispatch/ext, em que port é o número da porta do perfil IBM WebSphere no qualinstalou o IBM Cognos BI. A URL é a mesma que para URIs do dispatcher paragateway no IBM Cognos Configuration.

Procedimento1. Acesse o diretório cognos_install_location\war\p2pd.2. Abra o arquivo denominado application.xml.template em um editor de texto.3. Edite a seção do aplicativo para incluir os elementos a seguir:

<application><display-name>IBM Cognos 10</display-name><module>


http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp

<web><web-uri>@p2pdwar@</web-uri><context-root>@p2pd@</context-root>

</web></module><security-role id="SecurityRole_Cognos_BI_User">

<description/><role-name>BI User</role-name>

</security-role></application>

4. Salve e feche o arquivo.5. Acesse o diretório cognos_install_location\webapps\p2pd\WEB-INF.6. Abra o arquivo denominado web.xml.withCM em um editor de texto.7. Após a última seção servlet-mapping, e antes do elemento </web-apps>, inclua

o seguinte:<security-constraint>

<web-resource-collection><web-resource-name>Cognos Dispatcher</web-resource-name>

<url-pattern>/servlet/dispatch/ext/*</url-pattern><http-method>GET</http-method><http-method>POST</http-method>

</web-resource-collection><auth-constraint>

<role-name>BI User</role-name></auth-constraint>

</security-constraint><login-config>

<auth-method>BASIC</auth-method><realm-name>Cognos Dispatcher</realm-name>

</login-config><security-role>

<role-name>BI User</role-name></security-role>


Resultados

Agora é possível configurar componentes do IBM Cognos para execução no IBMWebSphere.

Configurar Componentes IBM Cognos para Execução no Servidor deAplicativos

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.

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 o IBM WebSphere, poderá usar o Assistente paraConstrução de Aplicativo para criar o aplicativo, bem como instalá-lo. Não énecessário usar o IBM WebSphere Administration Console para configurar aspropriedades 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 401.


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, será solicitada a geraçãoautomática de novas chaves neste momento.

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. Utilize o Assistente para Construção de Aplicativo para criar o arquivo deaplicativo que será implantado no servidor de aplicativos. Para iniciar oassistente Construção de Aplicativo do IBM Cognos Configuration, em Ações,clique em Construir Arquivos de Aplicativo. O assistente permite selecionar otipo de aplicativo para criar e a raiz de contexto utilizada para acessar oaplicativo.É necessário criar o arquivo de aplicativo no mesmo computador no qual oarquivo será implantado.O valor de raiz do contexto inserida no assistente deve ser o mesmo que aqueleinserido na guia Environment e utilizado para implantar o 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 implantação do aplicativo, taiscomo o nome do aplicativo, podem ser alterados para melhor se adequarem aoambiente do sistema.

Nota: Se estiver instalando o IBM Cognos BI no IBM WebSphere e estiverusando colaboração com o IBM Connections, assegure que Incluir arquivosestáticos da pasta Webcontent seja selecionado. Isso permitirá que você acesseo aplicativo sem usar um servidor da Web e que configure a conexão únicaentre o IBM Cognos BI e o IBM Connections.

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. Aoimplementar o aplicativo a partir do WebLogic Administration Console, vocêselecionaria o diretório p2pd.Para o JBoss, se utilizar a opção Expandir arquivos em uma pasta, inclua aextensão .war no nome da pasta em que o assistente criará o aplicativo p2pd.Quando o assistente solicita o local da pasta, acesse JBoss_location/server/instance_name/deploy e crie uma pasta denominada p2pd.war.Para obter informações sobre qual tipo de arquivo de aplicativo, WAR, EAR oudiretório expandido, é suportado em seu ambiente, consulte a documentaçãodo servidor 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 ouvir o nome do host ouendereç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.

Importante: Se você estiver usando colaboração com o IBM Connections,certifique-se de usar o nome completo do domínio do computador no qual seusserviços estão em execução para as URIs. Se você não incluir o domínio, o IBMConnections não permitirá o acesso, já que não pode verificar o domínio doqual o acesso está vindo.Por exemplo, você deve alterar valores como http://localhost:9300 para usaro nome do servidor, o domínio e o número da porta de transporte para seuperfil do IBM WebSphere. Se tiver o IBM WebSphere instalado em umcomputador denominado MyComputer que está em execução em seu domíniodenominado MyCompanyName.com, o localhost deverá ser alterado paraMyComputer.MyCompanyName.com. Se você estiver usando o número deporta de transporte IBM WebSphere padrão, 9080, então http://localhost:9300/ seria http://MyComputer.MyCompanyName.com:9080/.

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 fazer configurações deambiente para execução no Tomcat. A entrada não é necessária quando utilizarum servidor de aplicativo diferente.

6. Complete outras mudanças de configuração necessárias, comov Especificar propriedades para o banco de dados do Content Manager.v Inserir IDs do usuário e senhas.Se você usou as configurações padrão para a instalação do IBM Cognos, podeser necessário apenas fazer 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.

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.


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 IBM WebSphere Application Server, você não tem que alterar oscript de inicialização, a menos que queira incluir as mudanças de variável deambiente. Se você realmente efetuar as mudanças, use o console de administração.

Se o seu ambiente contiver um JRE que você esteja usando para outros produtos, apasta JRE pode conter arquivos .jar que não são compatíveis com os arquivos.jar que são fornecidos com o IBM Cognos BI. Isso pode resultar em uma falha aoiniciar o IBM Cognos BI em seu servidor de aplicativos. Nesta situação, direcione oIBM Cognos BI para usar os arquivos .jar endossados, incluindo o parâmetro aseguir na linha de comandos Java:-Djava.endorsed.dirs=${ibmcognos_home}/tomcat[version]/common/endorsed

Alterar o Script de Inicialização do Servidor de Aplicativospara WebLogic

Se você estiver usando o Oracle WebLogic Server, o script de inicialização deveráser modificado para especificar configurações da Java Virtual Machine (JVM). Parao WebLogic 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 de WebLogic feita. Por exemplo, em uma instalação do servidorgerenciado, o nome do script de inicialização é startManagedWebLogic.sh oustartManagedWebLogic.cmd.

3. Para versões JRE não IBM, selecione o modo de execução 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:JAVA_OPTIONS=

-Dweblogic.security.SSL.trustedCAKeyStore=%WL_HOME%\server\lib\cacerts-Dorg.xml.sax.driver=org.apache.xerces.parsers.SAXParser

5. Defina a memória máxima e mínima utilizada pelo JVM.Geralmente, a memória é definida através de dois parâmetros JVM: -Xms e-Xmx. Como valores iniciais, são sugeridos 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 definido. 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.


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.


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.

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 86. Variáveis de Ambiente do Sistema Operacional


Microsoft Windows PATH


Tabela 86. Variáveis de Ambiente do Sistema Operacional (continuação)


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 sejanecessá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. Se estiver usando a colaboração com o IBM Connections, você deverá ativar oacesso para a função de Usuário do BI incluída em “Incluir a Função deUsuário para Ativar Conexão Única entre os Perfis do IBM WebSphere” napágina 398.v No console administrativo do IBM WebSphere, clique em Aplicativos >

Aplicativos Corporativos.v Clique em IBM Cognos.v Na seção Detail properties, clique em Security role to user/group mapping.v Assinale a caixa de seleção Select para BI User e assinale a caixa de seleção

All authenticated?.v Clique em OK e em Save.

8. Pare e reinicie a instância do servidor de aplicativos WebSphere usada para oscomponentes do IBM Cognos.

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

Instalar o IBM Cognos no WebLogicSiga estas etapas para instalar no WebLogic.

Procedimento1. Se você usou a opção de diretório expandido ao construir o aplicativo no IBM

Cognos Configuration, acesse a etapa 2. Se você criou um 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 implantação do aplicativo, tais como o nome doaplicativo, podem ser alterados para melhor se adequarem ao ambiente do


sistema. O valor da raiz de contexto usado para implementar o aplicativodeve ser o mesmo que o valor da raiz de contexto inserido no IBM CognosConfiguration.

v No diretório que acaba de criar, extraia o arquivo WAR do aplicativo para ainstalação do WebLogic utilizando o seguinte comando de um prompt decomandos:WebLogic_location/jdk_version/bin/jar xvfm "installation_location/application.war" .

Um espaço seguido de um ponto são necessários no fim do comando.Nesse comando, o ponto não se refere ao diretório atual.

2. Inicie o WebLogic Administration Server e o WebLogic Managed Serverassociados ao domínio do IBM Cognos.O Node Manager deve ser iniciado antes que possa iniciar e parar instânciasdo Managed Server utilizando o console administrativo

3. Você deve modificar o ambiente no Console Administrativo do WebLogicantes de implementar o IBM Cognos BI. Efetue logon no ConsoleAdministrativo e navegue para a instância do Managed Server que hospedaráo aplicativo IBM Cognos BI. Selecione a guia Início do Servidor para ainstância do Managed Server 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 de JVM, comoconfigurações de memória especificadas usando dois parâmetros de JVM:-Xms e -Xmx.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-Dorg.xml.sax.driver=org.apache.xerces.parsers.SAXParser

Se usar WebLogic no AIX, você também deverá especificar o UID da versãoserial apropriada nos argumentos Java. Se essa atualização não for feita, podeocorrer uma incompatibilidade de UID da versão serial durante o uso doWebLogic com Java 5, pois o WebLogic requer JDK 1.5.Por exemplo: na caixa Argumentos, digite-Xms768m -Xmx768m -XX:MaxPermSize=128m-Dorg.xml.sax.driver=org.apache.xerces.parsers.SAXParser-Dcom.sun.xml.namespace.QName.useCompatibleSerialVersionUID=1.0

Para obter informações sobre os parâmetros JVM, consulte a documentação 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 antesda implementação do IBM Cognos BI ou IBM Cognos Servlet Gateway.

8. Implemente o IBM Cognos BI ou o aplicativo IBM Cognos Servlet Gateway noconsole do WebLogic usando um novo aplicativo da Web da seguinte forma:v Defina o nome do aplicativo.

Por exemplo, ibmcognos.


v Defina o caminho para o diretório onde os arquivos de aplicativoexpandidos estão localizados.

Nota: O IBM Cognos BI usa um utilitário de carga customizado. Utilize aopção de diretório expandido ao implantar.

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 com sucesso, configure o período derecarregamento para o aplicativo da Web como -1 para melhorar odesempenho. Isso evitará que o WebLogic verifique a existência de arquivosde aplicativo atualizados que são utilizados somente em um ambiente dedesenvolvimento.

10. Pare e reinicie o WebLogic Managed Server 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.

Instalar o IBM Cognos no SAP NetWeaverSiga estas etapas para instalar no SAP NetWeaver.

Procedimento1. Abra a ferramenta de configuração digitando

drive:\usr\sap\sapid\JCxx\j2ee\configtool\configtool.bat

Por exemplo, se a ID do SAP é J2E e a instalação está 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, onde

xxxxxxx é o número de ID da instalação, destaque http.4. Em Propriedades Globais, destaque KeepAliveTimeout e digite um número

mais alto e, em seguida, clique em Definir.

Dica: Sugerimos um número inicial de KeepAliveTimeout de pelo menos 60.5. Em cluster-data, instance_IDxxxxxxx, destaque Server_IDxxxxxxx.6. Defina a memória utilizada pelo 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, você pode terproblemas durante a execução do SAP NetWeaver. Sugerimos um valormínimo de 768 MB.

7. Na caixa de parâmetros Java, configure o analisador XML da seguinte forma:-Dorg.xml.sax.driver=org.apache.xerces.parsers.SAXParser

8. Para ambientes IBM Cognos BI que usam Report Studio, em cluster-data,instance_IDxxxxxxx, destaque Server_IDxxxxxxx, services e destaque http.

9. Em Propriedades Globais, destaque CompressedOthers, digite falso e, emseguida, clique em Definir.



Será solicitado para reiniciar o servidor.11. Reinicie o servidor utilizando o console de gerenciamento SAP ou reiniciando

os serviços em Serviços.12. Utilize a ferramenta Implantar para criar um novo projeto.13. Carregue o arquivo do aplicativo IBM Cognos que você criou usando IBM

Cognos Configuration. Por padrão, o arquivo é denominado p2pd.ear paraIBM Cognos BI e ServletGateway.ear para IBM Cognos Servlet Gateway.

14. Utilizando a ferramenta Implantar, conecte-se à ferramenta Administração eimplante o arquivo do aplicativo.

15. Quando for solicitado que inicie o aplicativo, clique em Sim.16. 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"><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.4. Coloque o aplicativo p2pd na pasta JBoss_location/server/instance_name/deploy

se ainda não estiver nessa localização.5. Inicie o servidor de aplicativos.

Para jBoss 5.0, o comportamento padrão é vincular seus serviços ao localhost(127.0.0.1). No entanto, isso 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 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:

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: Assegure-se de que o usuário que executa o script possua acessode leitura ao diretório em que o certificado está armazenado e acesso deleitura ao arquivo de certificado. Caso contrário, você poderá ver um errosemelhante à seguinte mensagem de erro: Exceção no erro "principal" deencadeamento java.lang.NullPointerException ao importar o certificado.

Você deve digitar jCAKeystore como o nome do keystore 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 104.


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 87. Diretórios Virtuais para SAP NetWeaver

Alias Localização Permissão

context_root (por exemplo,p2pd)

c10_location/webcontent Leitura

Cancelar Registro dos Dispatchers que Foram Configurados paraTomcat

Se estiver instalando o IBM Cognos BI em um servidor de aplicativos depois de játer iniciado o produto com Tomcat, você terá os dispatchers registrados noarmazenamento de conteúdo. Você deve cancelar o registro de quaisquerdispatchers que tenham sido registrados anteriormente para Tomcat.

Remova dispatchers usando o 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.


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

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 “Configurar Componentes IBM Cognos para Execução no Servidor de

Aplicativos” na página 399v 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 15. 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.


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.


Tabela 88. 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 15. Manutenção do desempenho 415

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

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.


Tabela 88. Serviços do IBM Cognos (continuação)

Serviço Finalidade

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.

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ídade 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 aoTomcat, o servidor de aplicativos que o IBM Cognos BI usa por padrão. Se quiserconfigurar o IBM Cognos BI para execução em outro servidor de aplicativos, não ouse IBM Cognos Configuration para configurar os recursos. Ao invés disso,configure os recursos 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.

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 utilizados, use a definiçã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 melhorar as velocidades operacionais e se o desempenho for maisimportante do que o tempo de inicialização rápida, e se o computador tivermuitos recursos, digite um valor que seja cerca do dobro do valor padrão,como 1536.


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.

Ajustar Configurações do Apache Tomcat para Instalações de 64 BitsSe estiver usando o Apache Tomcat em uma instalação de 64 bits, é possível editaras configurações de maxThreads e de acceptCount para melhorar o desempenho.

Procedimento1. Acesse o diretório c10_location/tomcat/conf.2. Abra o arquivo server.xml.3. Localize a linha <Connector port="9300" protocol="HTTP/1.1".


4. Nessa seção, altere os valores a seguir:a. Altere maxThreads="500" para maxThreads="1500"

b. Altere acceptCount="500" para acceptCount="100"

5. Salve o arquivo.6. Reinicie os serviços do IBM Cognos.

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

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.4. Dependendo do tipo de banco de dados, execute um dos seguintes scripts da

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


Capítulo 16. 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


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.


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.


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 (Begin of) and (End of) comentários:<crn:instance ...>...</crn:instance>

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 16. Configurando Manualmente o IBM Cognos Business Intelligence nos Sistemas Operacionais UNIX e Linux 423

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.


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.


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


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

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.


Criando Arquivo de Aplicativo IBM Cognos para o SoftwareBusiness Intelligence


Procedimento1. Para 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,opção build.bat file_type

v Para sistemas operacionais UNIX ou Linux,opção build.sh file_type

onde file_type pode ser um dos valores listados na tabela a seguir:

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

expandir diretório que contém o aplicativo comconteúdo estático

expand_without_webcontent diretório que contém o aplicativo semconteúdo estático

expand_without_docsamples diretório que contém o aplicativo comconteúdo estático e sem arquivos dedocumentação ou amostra

e onde option pode ser um ou mais dos valores listados na tabela a seguir:


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

outro (padrão)

Executar ações em umservidor de aplicativos JBoss

Executar ações em umservidor de aplicativos quenão JBoss

-Dcontext_root=value p2pd (padrão) Predeterminar um valor-raizde contexto para o aplicativo

-Dwar_name=value path/filename

O padrão é ../../p2pd.war

Caminho e nome do arquivoWAR que será criado

-Dear_name=value path/filename

O padrão é ../../p2pd.ear

Caminho e nome do arquivoEAR que será criado

-Dexpand_location=value

(Para tipos de arquivos deexpansão)

path/directory

O padrão é../../temp/expand

Caminho para o diretórioonde os arquivos doaplicativo serão expandidos

Criando Arquivo de Aplicativo IBM Cognos para um Gatewayde Servlet


Procedimento1. Para 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 o Windows,opção build.bat file_type

v Para o UNIX ou Linux,opção build.sh file_type

onde file_type pode ser um dos valores listados na tabela a seguir:

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

gateway_war_without_docsamples Arquivo WAR com conteúdo estático e semarquivos de documentação ou amostra


Tabela 92. Valores e Descrições de Tipo de Arquivo de um Arquivo de Aplicativo para umGateway de Servlet (continuação)

Valor Descrição

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

expandir diretório que contém o aplicativo comconteúdo estático

expand_without_docsamples diretório que contém o aplicativo comconteúdo estático e sem arquivos dedocumentação ou amostra

e onde option pode ser um ou mais dos valores listados na tabela a seguir:

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

outro (padrão)

Executar ações em umservidor de aplicativos JBoss

Executar ações em umservidor de aplicativos quenão JBoss

-Dcontext_root=value ServletGateway (padrão) Predeterminar um valor-raizde contexto para o aplicativo

-Dwar_name=value path/filename

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

Caminho e nome do arquivoWAR que será criado

-Dear_name=value path/filename

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

Caminho e nome do arquivoEAR que será criado

-Dexpand_location=value path/directory

O padrão é../../temp/expand

Caminho para o diretórioonde os arquivos doaplicativo serão expandidos


Capítulo 17. 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.


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

CMMSRVR IBM Cognos Metrics Manager

BIMEMOD IBM Cognos Metric Designer

BITRSFRMR IBM Cognos BI Transformer

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

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.

Capítulo 17. Usando instalação e configuração não assistidas 433

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.7. Para uma instalação do Windows, para a propriedade APPFOLDER=, digite um

nome 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 “Iniciando umaInstalaçã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 comandos a seguir:

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 efetuar bypass nas mensagens de exibição na tela, é possível incluir aopção -nomsgboxes no comando issetup. Por exemplo, para iniciar umainstalação silenciosa usando o arquivo response.ats padrão sem mensagensexibidas durante a instalação, digite: issetup -s -nomsgboxes.

v No UNIX ou no Linux, digite:./issetup -s location/filename.ats

v No UNIX ou Linux onde você não tem o XWindows:./issetupnx -s local/nome do arquivo.ats

Nota: Em um ambiente do UNIX ou Linux, para visualizar o status dainstalação na tela, é possível incluir a opção -displayLog no comandoissetupnx. Por exemplo, para iniciar uma instalação silenciosa usando oarquivo response.ats padrão, e exibir o status, digite: ./issetup -s-displayLog.

Resultados

Se um status de retorno diferente de 0 (zero) for retornado, verifique os arquivosde log 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.

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

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


cogconfig.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.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 95. Pacotes na Lista de Pacotes

Código de pacote Produto

BISRVR IBM Cognos BI Server

CRNSRVR IBM Cognos BI Reporting Server

BIMODEL Framework Manager

CMMSRVR IBM Cognos Metrics Manager

BIMEMOD Metric Designer

BITRSFRMR IBM Cognos BI Transformer

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



Capítulo 18. 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


./uninst -u

v Se não estiver usando o XWindows, execute uma desinstalação não assistida(consulte “Usar um Arquivo de Resposta a partir de uma Instalação emOutro Computador” na página 432).

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.3. Exclua todos os arquivos de Internet temporários dos computadores de

navegadores web.Para obter mais informações, consulte a documentação do navegador web.


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 IBM Accessibility Center (http://www.ibm.com/able) para obterinformações adicionais sobre o compromisso que a IBM tem com a 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 96. 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 97. 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


http://www.ibm.com/able

Tabela 97. 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 98. 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 99. 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 100. 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


Apêndice B. Integração do Google OneBox para IBM CognosBusiness Intelligence

A procura indexada do IBM Cognos pode se integrar ao Google Search Appliance(GSA) para fornecer resultados do Google OneBox sobre seu conteúdo do IBMCognos Business Intelligence.

Com a integração do Google OneBox, se uma solicitação de procura incluirpalavras-chave do acionador predefinido, o conteúdo do IBM Cognos aparecerá naseção OneBox da página de resultados. O tipo de conteúdo que aparece nosresultados é configurável. Os resultados do OneBox mostram o conteúdo do IBMCognos BI, tal como um relatório ou métricas, ou uma lista de resultados daprocura de índice semelhante ao que apareceria se o usuário executasse a procuraa partir do IBM Cognos Connection.

Você deve usar o GSA para uma procura corporativa para aproveitar as vantagensdesse recurso.

Antes de começar, você deve assegurar-se de que o recurso de procura de índiceesteja configurado. Para obter mais informações, consulte “Configurando a Procurade Índice do IBM Cognos” na página 302.

A integração do Google OneBox usa dois componentes do IBM Cognos:v Um módulo OneBox para conteúdo do IBM Cognos

Esse componente deve ser instalado e configurado no GSA.v Um provedor OneBox para conteúdo do IBM Cognos

Esses componentes são instalados automaticamente com o IBM Cognos BI. Épossível configurá-lo para customizar a maneira como os resultados desolicitações de procura específicas são processados e aparecem nos resultados doOneBox.

Processo de Solicitação de Procura

O diagrama a seguir mostra a comunicação entre os componentes quando umaprocura é processada pelo GSA com um módulo para o conteúdo do IBM Cognos.


1. A solicitação de procura é enviada ao GSA.

2. O GSA processa a solicitação de duas maneiras:

v Solicitando um conjunto de resultados do índice mantido pelo GSA.

v Solicitando um conjunto de resultados da capacidade do Google OneBox.

3. Se a solicitação de procura corresponder aos critérios do acionador, o módulo OneBoxenviará a solicitação ao provedor OneBox.

4. O provedor OneBox processa a solicitação com base em um conjunto de regras definidona configuração do provedor.

5. O provedor OneBox retorna resultados para o módulo Google OneBox, conteúdoespecífico, tal como um relatório ou uma métrica, ou um conjunto de resultados daprocura de índice.

6. Resultados da procura, incluindo conteúdo do IBM Cognos mostrado como resultadosdo OneBox, são retornados para o usuário.

Figura 12. Comunicações entre Componentes Usando uma Procura do GSA


Configurando Componentes do IBM Cognos OneBoxPara configurar a integração do conteúdo do IBM Cognos nos resultados daprocura do Google OneBox, você deve instalar e configurar no mínimo um móduloOneBox para o conteúdo do IBM Cognos.

É possível customizar a integração do Google OneBox para IBM Cognos BI usandoum dos seguintes métodos:v Configure e instale módulos OneBox adicionais para o conteúdo do IBM Cognos

no Google Search Appliance.Com mais de um módulo, é possível configurar os componentes do OneBoxpara retornar mais de um tipo de conteúdo do IBM Cognos para solicitações deprocura específicas. Por exemplo, com mais de um módulo, o relatório deinventário de termos de procura pode retornar um relatório e uma métrica.É possível configurar os módulos para os modos anônimo ou seguro.

v Crie um arquivo map.xml.Especifique como processar solicitações de procura recebidas de um ou maismódulos OneBox para o conteúdo do IBM Cognos. Por exemplo, é possíveldefinir regras de processamento que retornam um relatório específico quandoum usuário digita "relatório de inventário" como uma solicitação de procura.

Módulos de Amostra

Quatro módulos de amostra do Google OneBox são fornecidos com a instalação doIBM Cognos BI:

Onebox.xsltUsado para validação.

Onebox_module_metric.xmlResultados da procura apenas para relatórios do Metric Studio.

Onebox_module_report.xmlResultados da procura apenas para relatórios do Report Studio.

Onebox_module_search.xmlResultados da procura para relatórios do Report Studio ou do MetricStudio.

Configurar Segurança para um Módulo de Amostra do GoogleOneBox

Por padrão, os aplicativos do Google OneBox são abertos e anônimos. Se o seuaplicativo requerer autenticação segura, você deverá configurar o Google SearchAppliance (GSA) e a instalação do IBM Cognos corretamente.

Se não requerer autenticação segura, continue no “Configurar um Módulo deAmostra do Google OneBox” na página 447.

Antes de Iniciar

Você deve estar familiarizado com a interface de administração do GSA e as opçõesde autenticação do Google OneBox. Para obter informações adicionais, consulte adocumentação do GSA.

Apêndice B. Integração do Google OneBox para IBM Cognos Business Intelligence 445

Procedimento1. Ative o SSL em seu servidor da web e configure o IBM Cognos BI para um

servidor da web ativado por SSL.Para obter mais informações, consulte “Configurar Servidores da Web Ativadospelo IBM Cognos para SSL” na página 279.

2. Inicie o IBM Cognos Configuration.3. Inclua um provedor de autenticação em sua instalação do IBM Cognos BI.

Para obter mais informações, consulte Capítulo 13, “ConfigurandoComponentes do IBM Cognos para Usar um Provedor de Autenticação”, napágina 351.a. Na janela Explorer, em Segurança, clique com o botão direito do mouse em

Autenticação e clique em Novo Recurso > Namespace.b. Na caixa Nome, digite um nome para o namespace de autenticação. Por

exemplo, digite onebox.c. Na lista Tipo, selecione Custom Java Provider e clique em OK.d. No painel Propriedades, na propriedade NamespaceID, especifique um

identificador exclusivo para o namespace. Por exemplo, digite onebox.e. Para a propriedade de nome de classe Java, insira

com.cognos.CAM_AAA.authentication.ClientCertTrustedSignon.ClientCertTrustedSignon

f. Salve sua configuração.4. Acesse o diretório c10_location/bin/jre/version/bin.5. Insira o seguinte comando:

keytool -import -file filename -keystore keystore_filename

Em que:v filename é o nome do arquivo que contém a versão PEM do certificado de

autoridade do certificado.v keystore_filename é o nome do arquivo keystore.

6. Acesse o diretório c10_location/configuration.7. Crie um arquivo de texto e nomeie-o ClientCertTS_namespace_ID.properties.

Em que namespace_ID é o nome usado para a propriedade NamespaceID noIBM Cognos Configuration.

8. Abra o arquivo em um editor de texto e inclua o seguinte conteúdo:# Identifies the keystore location and password

keystoreFileName=trustedCAs/mykeystore.ks#java keystore file as generated by "keytool"

keystorePassword=mypassword# password (in clear text) for the keystore file

redirectNamespaceID=namespace#the Cognos BI namespace ID to which the user should beauthenticated, for example onebox



Conceitos relacionados:Capítulo 13, “Configurando Componentes do IBM Cognos para Usar um Provedorde Autenticação”, na página 351Os 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.Tarefas relacionadas:“Configurar Servidores da Web Ativados pelo IBM Cognos para SSL” na página279Se 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.

Configurar um Módulo de Amostra do Google OneBoxUse essa tarefa para configurar um módulo do Google OneBox, para acessoanônimo ou acesso autenticado.

Procedimento1. Acesse o diretório c10_location\webapps\p2pd\WEB-INF\classes\search\

onebox\sample.2. Abra o arquivo de amostra que você deseja usar em um editor de texto.

Todos os arquivos de amostras usam a mesma estrutura básica. Uma seção épara a configuração básica do módulo. A outra seção é para customizar aapresentação dos resultados da procura na interface com o usuário.

3. Edite o elemento <name>cognos_demo_search</name> para alterar o nome domódulo mostrado para o usuário.Por exemplo, é possível alterar o elemento para algo como <name>SearchReports and Metrics<name>.

4. Edite o elemento <description>Displays Cognos 10 searchresults</description> para alterar a descrição mostrada para o usuário.

5. Edite o elemento <providerURL> para a URL de sua instalação do IBM CognosBI.v Para modo anônimo, configure <providerURL> como machine_name:port/

ibmcognos/cgi-bin/cognos.cgi/onebox

v Para modo seguro, configure <providerURL> como machine_name:port/ibmcognos/cgi-bin/cognos.cgi/onebox?CAMNamespace=namespace_ID

6. Configure security userAuth como o valor apropriado.v Para o modo anônimo, configure security userAuth como none. Por

exemplo, <security userAuth=“none” />.v Para modo seguro, configure security userAuth como LDAP. Por exemplo,

<security userAuth=“LDAP” />.7. Salve e feche o arquivo.8. Acesse o diretório c10_location\templates\ps\onebox.9. Renomeie sample-map.xml para map.xml.

Para obter informações adicionais sobre arquivos de mapeamento, consulte“Customizando os Resultados da Procura para o Provedor do GoogleOneBox” na página 448.

10. Reinicie o serviço do IBM Cognos.11. Execute uma tarefa de atualização de índice no IBM Cognos Connection. Para

obter informações adicionais, consulte o Guia de Administração e Segurança doIBM Cognos BI.


Customizando os Resultados da Procura para o Provedor doGoogle OneBox

É possível configurar o provedor para customizar a maneira como os resultados daprocura são processados e aparecem nos resultados do Google OneBox.

Usando a configuração padrão, os resultados do Google OneBox são uma listapriorizada de resultados da procura do IBM Cognos BI.

Por padrão, os componentes do IBM Cognos necessários para a integração doGoogle OneBox são configurados para retornar uma lista de resultados da procurado IBM Cognos BI. Diferentemente da configuração necessária, tal como configuraro módulo do OneBox para especificar o local do provedor do OneBox, não énecessário customizar a configuração para mostrar o conteúdo do IBM Cognoscomo resultados do OneBox.

É possível alterar a configuração padrão usando um arquivo map.xml. O arquivomap.xml permite especificar como processar as solicitações de procura recebidas dosmódulos do OneBox. Por exemplo, é possível definir regras de processamento queretornam um relatório específico quando um usuário insere “relatório deinventário” como uma solicitação de procura.

É possível criar o arquivo map.xml ou usar o arquivo sample-map.xml que éfornecido com sua instalação do IBM Cognos BI. Para obter mais informações,consulte “Exemplos de Configuração do Provedor Google OneBox”.

Procedimento1. Para cada relatório que se deseja utilizar como um destino para os resultados

do Google OneBox, execute e salve o relatório no formato XHTML.Para obter mais informações sobre como selecionar o formato XHTML para umrelatório, consulte o tópico sobre opções de relatório avançadas no Guia deAdministração e Segurança do IBM Cognos BI.

2. No computador em que você instalou o IBM Cognos BI, acesse o diretórioc10_location\templates\ps\onebox.

3. Abra sample-map.xml em um editor de texto.4. Modifique as entradas para definir o comportamento do processamento para

um ou mais módulos.

Dica: Use os comentários no arquivo sample-map.xml para ajudá-lo aconfigurar o arquivo.

5. Salve e feche o arquivo.6. Renomeie sample-map.xml para map.xml.7. Reinicie o IBM Cognos BI .

O que Fazer Depois

Para testar as mudanças na configuração, execute várias procuras para garantir queo conteúdo esperado seja retornado nos resultados do OneBox. Verifique osresultados da procura para assegurar que a aparência dos relatórios é aceitável.

Exemplos de Configuração do Provedor Google OneBoxUse os exemplos a seguir para entender como é possível customizar oprocessamento de procura do provedor OneBox para retornar conteúdo do IBMCognos como resultados do Google OneBox.


Além de modificar a configuração do provedor OneBox usando o arquivo map.xml,você deve instalar e configurar um ou mais módulos OneBox no Google SearchAppliance (GSA). Para obter informações adicionais sobre como trabalhar commódulos do Google OneBox, consulte a documentação do Google OneBox.

Para utilizar um relatório como um destino para uso como resultados do GoogleOneBox, é necessário executar e salvar o relatório no formato XHTML. O relatóriotambém deve ser pequeno o suficiente para caber no espaço limitado fornecidopara os resultados do OneBox. Assegure-se de testar todos os relatórios usadospara resultados do Google OneBox.

Etapas adicionais de criação não são necessárias para gráficos de métricasutilizados como resultados do OneBox. Um gráfico de métricas é geradodinamicamente como uma resposta a uma solicitação de procura. Diferentementedo relatório de formato de gráfico, um gráfico de métricas não precisa serpreviamente criado ou testado para assegurar uma aparência aceitável nosresultados do OneBox.

Para obter informações adicionais sobre como selecionar formato XHTML para umrelatório, consulte o Guia de Administração e Segurança do IBM Cognos.

Exemplo - Configurar um Provedor OneBox para Retornar umRelatório

Existem dois relatórios que podem ser utilizados como resultados do GoogleOneBox, o relatório de receita e relatório de inventário. Pode ser que se deseje umdos relatórios obtidos pela procura quando uma consulta de procura inclui orelatório de palavra-chave e uma ou mais das seguintes palavras-chave, receita einventário. O GSA inclui um módulo OneBox chamado cognos_report. O relatóriode palavra-chave é um dos ativadores para esse módulo.

Modifique o arquivo map.xml para incluir a seguinte entrada de módulo:<module oneboxName="cognos_report"><mapEntries><mapEntry provider="cm"><regex>.*revenue.*</regex><path type="output">/content/package

[@name=’Onebox Reports’]/query[@name=’RevenueReport’]</path>

</mapEntry><mapEntry provider="cm"><regex>.*inventory.*</regex><path type="output">/content/package

[@name=’Onebox Reports’]/query[@name=’InventoryReport’]</path>

</mapEntry></mapEntries></module>

O fluxo de comunicação a seguir ocorre quando um usuário digita inventário derelatório como termo de procura.1. O GSA recebe a consulta de procura e solicita um conjunto de resultados de

sua própria capacidade de índice e da capacidade do OneBox.2. A capacidade do OneBox identifica o relatório de termo de procura como um

acionador para o módulo cognos_report e passa a consulta para esse módulocomo uma solicitação de procura.

3. O módulo cognos_report passa a consulta para o provedor OneBox.


4. O provedor avalia a solicitação de procura e, com base nas entradas do arquivomap.xml, determina que o Relatório de Inventário deve ser retornado como oresultado da procura.Se a consulta de procura incluiu os termos renda e inventário, o Relatório deRenda seria retornado como o resultado da procura, pois é a primeiramapEntry.

5. O provedor retorna o Relatório de Inventário para o GSA.6. O GSA formata o relatório usando a folha de estilo XSL incluída no módulo

cognos_report.7. O relatório de inventário é exibido como um resultado do OneBox junto com os

resultados da procura retornados do índice do Google.

Exemplo - Configurar um Provedor OneBox para Retornar um Gráfico

Além dos relatórios de tabela de referência cruzada e de lista, existem os relatóriosde gráficos. Para retornar um gráfico quando uma solicitação de procura inclui otermo margem, inclua uma entrada <mapEntry> no arquivo map.xml. Como oexemplo map.xml para relatórios, a ordem de <mapEntry> é importante. Se asolicitação de procura incluir os termos receita e margem, o Relatório de Rendaserá retornado porque a renda é a primeira <mapEntry>. O gráfico de margem só éobtido quando a solicitação de procura inclui o termo margem, mas não o termoreceita ou inventário.

O GSA inclui um módulo OneBox chamado cognos_report. O relatório de termosde procura é um dos ativadores para esse módulo.





</mapEntry><mapEntry provider="cm"><regex>.*margin.*</regex><path type="image">/content/package

[@name=’Onebox Reports’]/query[@name=’MarginChart’]</path>


O fluxo de comunicação a seguir ocorre quando um usuário digita o termomargem de relatório como uma consulta de procura.1. O GSA recebe a consulta de procura e solicita um conjunto de resultados de





4. O provedor avalia a solicitação de procura e, com base nas entradas do arquivomap.xml, determina que o Gráfico de Margens deve ser retornado no resultadoda procura.Se a consulta da procura incluiu o termo renda ou inventário, um relatório seráretornado, pois os itens <mapEntry> para essa palavra-chave aparecem antes de<mapEntry> para margem.

5. O provedor retorna o Gráfico de Margens para o GSA.6. O GSA formata o relatório usando a folha de estilo XSL incluída no módulo

cognos_report.7. O gráfico de margem é exibido como um resultado do OneBox junto com os

resultados da procura obtidos do índice do Google.

Outra opção de configuração é incluir um módulo OneBox para processarsolicitações de procura que incluem um acionador para gráficos. Nesse caso, oarquivo map.xml inclui itens <module_OneBox name> separados. O provedor OneBoxprocessa solicitações de cada módulo separadamente. A ordem dos módulos noarquivo map.xml não afeta os resultados. Uma das vantagens de se utilizar mais deum módulo é que os resultados do OneBox para um único termo de procurapodem retornar um relatório e um gráfico.

Exemplo - Configurar o Provedor OneBox para Retornar um Relatórioe um Gráfico

Pode ser que se deseje obter um relatório de tabela de referência cruzada e umgráfico quando uma solicitação de procura inclui inventário. Use dois itens <pathtype> na mesma <mapEntry>.



</mapEntry><mapEntry provider="cm"><regex>.*inventory.*</regex><path type="image">/content/package

[@name=’Onebox Reports’]/query[@name=’InventoryChart’]</path>

<path type="output">/content/package[@name=’Onebox Reports’]/query[@name=’InventoryReport’]</path>


O fluxo de comunicação a seguir ocorre quando um usuário digita o termoinventário de relatório como uma consulta de procura.1. O GSA recebe a consulta de procura e solicita um conjunto de resultados de





4. O provedor avalia a solicitação de procura e, com base nas entradas de arquivomap.xml, determina que o Gráfico de Inventário e o Relatório de Inventáriodevem ser retornados como o resultado da procura.Se a consulta de procura incluiu os termos renda e inventário, o Relatório deRenda seria retornado como o resultado da procura, pois é a primeiramapEntry.

5. O provedor retorna o Gráfico de Inventário e o Relatório de Inventário do GSA.6. O GSA formata os relatórios usando a folha de estilo XSL incluída no módulo

cognos_report.7. O gráfico de inventário e o relatório de inventário são exibidos como um

resultado do OneBox junto com os resultados da procura obtidos do índice doGoogle.

Outra opção de configuração é incluir um módulo OneBox para processarsolicitações de procura que incluem um acionador para gráficos. Nesse caso, oarquivo map.xml inclui itens <module_OneBox name> separados. O provedor OneBoxprocessa solicitações de cada módulo separadamente. A ordem dos módulos noarquivo map.xml não afeta os resultados.

Exemplo - Configurar o Provedor OneBox para Retornar uma Métrica

É possível configurar o provedor OneBox para retornar o gráfico e os dados deuma métrica especificada. O nome do pacote é especificado no arquivo map.xmlcom o atributo <path>. Você especifica uma <mapEntry provider> diferente noarquivo map.xml em comparação com relatórios, <mapEntry provider="mm"> em vezde <mapEntry provider="cm">.

É possível instalar e configurar um ou mais módulos OneBox para processarsolicitações para relatórios e métricas. Pode ser que se deseje retornar um relatórioe uma métrica para uma única solicitação de procura. Para suportar esse tipo deresultado do OneBox, instale um módulo OneBox adicional no GSA e configure omódulo para usar métrica como um acionador. O GSA inclui dois módulosOneBox, cada um com um nome exclusivo, cognos_report e cognos_metric.





</mapEntry></mapEntries></module><module oneboxName="cognos_metric">

<mapEntries><mapEntry provider="mm">

<regex>.*</regex><path>International Sales</path>

</mapEntry></mapEntries>

</module>


O fluxo de comunicação a seguir ocorre quando um usuário digita o termo receitade métrica ou métrica de receita como uma consulta de procura.1. O GSA recebe a consulta de procura e solicita um conjunto de resultados de

sua própria capacidade de índice e da capacidade do OneBox.2. A capacidade OneBox identifica a métrica de termo de procura como um

acionador para o módulo cognos_metric e passa a consulta para esse módulocomo uma solicitação de procura.

3. O módulo cognos_metric passa a consulta para o provedor OneBox.4. O provedor avalia a solicitação de procura e, com base nas entradas do arquivo

map.xml, solicita resultados do provedor usado para métricas.5. O provedor de métricas procura no pacote de vendas internacionais e retorna o

gráfico e os dados para uma métrica cujo nome melhor combina com a receita.6. O provedor OneBox retorna a métrica para o GSA.7. O GSA formata a métrica usando a folha de estilo XSL incluída no módulo

cognos_metric.8. A métrica é exibida como resultados do OneBox junto com os resultados de

procura obtidos do índice do Google.

Outra opção de configuração é usar um único módulo OneBox e incluir entradas<mapEntry provider="mm"> no arquivo map.xml. Com essa configuração, osresultados do OneBox podem incluir conteúdo de apenas um dos tipos deprovedor, cm ou mm, mas não dos dois.



Apêndice C. 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 101. 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


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


Apêndice D. Amostras

Essa seção explica o propósito, o conteúdo e o local das amostras do IBM CognosBusiness Intelligence. Também descreve a companhia de amostra, GrandesAventuras, e sua estrutura, bancos de dados, modelo e pacotes.

A Companhia de Aventuras de AmostraAs amostras da Empresa de Aventuras de Amostra ilustram os recursos doproduto e as melhores práticas técnicas e de negócios.

Também é possível utilizá-los para testar com e compartilhar técnicas dedesenvolvimento de relatórios e para solução de problemas. Ao utilizar asamostras, é possível fazer conexão com recursos do produto.

Para obter exemplos relacionados a diferentes tipos de negócios, consulte osblueprints do produto nos Centros de Informações do IBM Cognos(http://pic.dhe.ibm.com/infocenter/cogic/v1r0m0/index.jsp).

A Empresa de Aventuras de Amostra, ou Vendas GA, ou qualquer variação donome Aventuras de Amostra, é o nome de uma operação de negócio fictícia cujosdados de amostra são usados para desenvolver aplicativos de amostra para a IBMe clientes IBM. Seus registros fictícios incluem dados de amostra para transações devendas, distribuição de produtos, e recursos humanos e financeiros. Qualquersemelhança com nomes, endereço, números de contato ou valores de transaçõesreais é mera coincidência. A cópia não autorizada é proibida.

Estrutura de Tópicos da Amostra

As amostras consistem no seguinte:v Dois bancos de dados que contém todos os dados corporativos e os modelos de

amostra relacionados para consulta e análisev Cubos de amostra e os modelos relacionadosv Uma origem de dados de métricas incluindo métricas associadas e um mapa de

estratégia para a empresa consolidada e um modelo para Extrações de métrica.v Relatórios, consultas, modelos de consulta e áreas de trabalho

Para executar relatórios interativos, necessita-se de scripts. Para ver todos osrelatórios incluídos nos pacotes de amostras, copie os arquivos da instalação doconteúdo de amostras nas pasta de implementação e, em seguida, importe asimplementações no produto IBM Cognos Business Intelligence.

Segurança

As amostras estão disponíveis para todos os usuários.

Grupo de Empresas da Companhia de Aventuras de AmostraPara produzir exemplos de design mais rapidamente, especialmente exemplosfinanceiros, algumas informações gerais sobre a Companhia de Aventuras deAmostra são úteis.



Para procurar por amostras que utilizem especificamente esses recursos doproduto, consulte as descrições individuais das amostras nesta seção.

A receita da Companhia de Aventuras de Amostra é gerada pelas lojas corporativase pelas operações das franquias. As receitas são consolidadas pelas subsidiáriasintegrais. Há seis organizações distintas, cada uma com seus própriosdepartamentos e unidades de vendas. Cinco delas são empresas com base regional.

A sexta empresa, GA - Acessórios:v Tem sua própria coleção de produtos, diferenciada de outras empresas GA por

marca, nome, preço, cor e tamanho.v Vende a partir uma única ramificação para todas as regiões e varejistas.v Funciona como uma empresa operacional com base em Genebra e como

proprietária parcial das três subsidiárias GA na Europa.

O diagrama abaixo ilustra a estrutura da empresa consolidada, incluindo asmudanças de porcentagem com relação à posse da GA Central européia e mostra amoeda registrada e o prefixo GL de cada subsidiária.

Cada corporação possui a mesma estrutura departamental e a mesma estrutura deGL, mostrada na tabela. As divisões podem não registrar as mesmas moedas. Porexemplo, a subsidiária das Américas registra em dólares americanos, mas a moedalocal da divisão corporativa é o dólar canadense e a moeda local da divisão deoperações é o peso.

Figura 13. Estrutura Corporativa Consolidada


Tabela 102. Estrutura Departamental

Divisão (GL) Departamento (GL)

Corporativo (1700) Vendas (1720)

Marketing (1750)

IS&T (1760)

Recursos Humanos (1730)

Finanças (1740)

Compras (1710)

Operações (1800) Produção e Distribuição (1820)

Serviço ao consumidor (1820)

Cada empresa tem um gráfico completo das contas. A maioria das contas, taiscomo despesas não pessoais, ficam no nível do departamento e contêm apenas ostotais de resumo. Por exemplo, apesar de cada departamento de marketing terdespesas, o custo não é especificado no nível da transação onde as promoções demarketing ocorrem.

FuncionáriosOs dados da Companhia de Aventuras de Amostra contêm uma lista completa dosfuncionários de todas as divisões, departamentos e locais.

Os dados estão disponíveis para os relatórios sobre bônus (Global Bonus report) ecomissões sobre vendas (Sales Commissions for Central Europe report),treinamento (Employee Training by Year report) e visualizações de desempenho epesquisas de satisfação do funcionário (Employee Satisfaction 2012). Caso utilize oMetric Studio, as métricas de amostra de recursos humanos também estarãodisponíveis.

No pacote Armazém de Dados da GA (análise), os grupos de medidas e asdimensões relacionadas estão organizados em pastas. Os funcionários estãoorganizados em hierarquias por região e gerente, para realizar diferentes tipos deagregação fáceis de relatar. A agregação foi definida pelas medidas do Resumo docargo do funcionário, de forma que o Número de vagas para o cargo e o Númeroplanejado de vagas para o cargo agreguem corretamente em cada nível de tempo:mensal, trimestral ou anual. Para obter exemplos, consulte o relatório Número defuncionários estimado.

Os funcionários também estão listados em um arquivo LDIF de amostra quepoderia ser usado para autenticação LDAP de qualquer produto IBM, incluindoTivoli. Esse diretório de autenticação é necessário para as amostras do IBM CognosPlanning. Nenhuma outra amostra depende de perfis de segurança.

Vendas e MarketingOs dados de vendas e marketing estão disponíveis para todas as empresas dogrupo da Companhia de Aventuras de Amostra.

A GA - Acessórios tem detalhes mais ricos para fornecer exemplos de análise. Paraobter exemplos, consulte a análise Revenue vs % Gross Profit by Product Brand,

Apêndice D. Amostras 459

com base no cubo de Vendas e marketing. As campanhas de marketing e devendas estão ligadas às empresas regionais da Companhia de Aventuras deAmostra.

No geral, as empresas GA vivenciaram um sólido crescimento da maior parte desuas linhas de produtos (Sales Growth Year Over Year), em todas as regiões(Receita por Subsidiária da GA em 2011), devido a fatores como aumento dosnegócios repetidos e dos produtos novos ou melhorados, como a alta margem dalinha de produtos de óculos de sol. Nas linhas de produtos vendidas pelas cincoempresas regionais (todas menos a GA - Acessórios), as promoções obtiveramsucessos mistos (Promotion Success by Campaign, Bundle and Quarter). Casoutilize o Metric Studio, isso também pode ser visto nas métricas de amostra.

Pesquisas do Cliente

Os dados também contêm informações das pesquisas de consumidor. Por exemplo,a linha de produtos que inclui repelente contra insetos, protetor solar, etc., nãoobteve sucesso (Product Satisfaction - Outdoor Protection 2011) e a origem dodescontentamento do varejista pode ser o nível de serviço do cliente ao invés dosretornos (Customer Returns and Satisfaction). Caso utilize o Metric Studio, estasinformações também poderão ser monitoradas nas métricas.

Pontos de Vendas

A receita dos pontos de vendas da empresa está disponível no nível da transação.A receita das vendas das franquias está disponível somente no nível consolidado(cubo Vendas e marketing). As métricas sobre os varejistas mostram que o númerode novos pontos de revenda caiu ao longo do período abrangido por estes dados.

A GA - Acessórios realiza vendas no mundo todo, e apenas de acessórios. Osdados de transação da GA - Acessórios são a fonte primária para a análise dosprodutos por marca, cor e tamanho. As outras cinco subsidiárias do grupo deempresas são regionais e vendem todas as linhas de produtos para os varejistasdas respectivas regiões. Por exemplo, o relatório Top 10 Retailers in 2011 utilizasparklines e lista dados para visualizar receitas no nível do varejista.

Amostra do Banco de Dados, Modelos e Pacotes de OutdoorsOs modelos de Framework Manager de Aventuras de Amostra ilustram as técnicasde modelagem e suportam as amostras.

Os modelos baseiam-se no banco de dados transacional do Armazém de Dados daGA e das Vendas da GA e são a base para os relatórios e as consultas da amostra.Cada modelo contém dois pacotes para publicar a análise (dimensional) e asvisualizações de consulta dos dados.

Você deve ter acesso ao Framework Manager, a ferramenta de modelagem no IBMCognos Business Intelligence, para consultar os modelos de amostra. Pode sernecessário também configurar os bancos de dados e as conexões da amostra.

Armazém de Dados da GA

O modelo de Armazém de Dados GA, great_outdoors_data_warehouse.cpf, ébaseado no banco de dados GOSALESDW. Contém dados de recursos humanos,vendas e marketing, e finanças, agrupados em áreas de negócios. Na visualização


do Banco de dados, as três áreas de negócios estão agrupadas em namespacesseparados. A visualização do Banco de dados contém um quarto namespace(Dados GA) para as informações comuns.

A visualização do Banco de dados é bem semelhante à estrutura do banco dedados subjacente. Todas as tabelas (assuntos de consulta do banco de dados) sãoinalteradas. Isso permite que o IBM Cognos BI recupere metadados diretamente dopacote na maioria dos casos em vez de usar uma chamada de metadados para obanco de dados. As mudanças e adições seguintes foram realizadas na visualizaçãodo Banco de dados:v Incluíram-se junções quando necessário.v Para permitir a agregação em diferentes níveis de granularidade, criaram-se

alguns assuntos de consulta de modelo. Para exemplos, consulte a relação entreHorário e Vendas ou fato de Vendas.

v As tabelas de consulta foram copiadas para permitir junções simples realizadasentre elas e cada um dos níveis de uma dimensão. Para exemplos, consulte astabelas de busca.

A visualização Negócios contém somente assuntos de consulta de modelo, semjunções. As mudanças e adições seguintes foram realizadas na visualizaçãoNegócios:v Foram incluídos cálculos nos assuntos de consulta do modelo. Por exemplo, a

dimensão de tempo contém cálculos de linguagem.v Foram criadas novas dimensões onde o banco de dados possui várias

hierarquias, para organizar cada uma das hierarquias. Por exemplo, ashierarquias de funcionários são organizadas em diversas categorias, comogerente e região.

O Banco de Dados Transacional de Vendas GA

O modelo de Vendas GA, great_outdoors_sales.cpf, é baseado no banco de dadosGOSALES, que é estruturado como um banco de dados transacional. Contémprincipalmente dados de vendas.

A visualização do Banco de dados é bem semelhante à estrutura do banco dedados subjacente. As mudanças e adições seguintes foram realizadas navisualização do Banco de dados:v Para tornar possível associar as tabelas de fatos à dimensão de tempo, foram

usadas as junções dos assuntos de consulta de modelo e as junções de váriaspartes.

v Incluíram-se outras junções quando necessário.

A visualização Negócios contém somente assuntos de consulta de modelo, semjunções. As mudanças e adições seguintes foram realizadas na visualizaçãoNegócios:v Foram incluídos cálculos nos assuntos de consulta do modelo.v Os assuntos de consulta de modelo criados na visualização de Banco de dados

para possibilitar junções na dimensão de tempo foram conectados como atalhosde referência.

v Foram criadas novas dimensões onde o banco de dados possui váriashierarquias, para organizar cada uma das hierarquias.


v A Equipe de vendas é um subconjunto da dimensão Funcionário. Não há chaveFuncionário exclusiva em Vendas GA, então o filtro recupera somente o registroatual. Este modelo não usa dados históricos.

As Amostras PowerCubes

Os seguintes cubos são entregues com as amostras da Companhia de Aventuras deAmostra em inglês, francês, alemão, japonês e chinês:v sales_and_marketing.mdc

v employee_expenses.mdc

v go_accessories.mdc

v go_americas.mdc

v go_asia_pacific.mdc

v great_outdoors_sales_en.mdc

v great_outdoors_7.mdc

Os Pacotes de Amostras

As amostras da Companhia de Aventuras de Amostra incluem seis pacotes. Éfornecida uma breve descrição de cada pacote disponível.

Armazém de Dados da GA (análise) é uma visualização dimensionalmentemodelada do banco de dados GOSALESDW. Este pacote pode ser usado em todosos studios, incluindo o IBM Cognos Analysis Studio. Utilizando este pacote épossível drill up e drill down.

Vendas GA (análise) é uma visualização dimensionalmente modelada do banco dedados VENDASGA. Este pacote pode ser utilizado em todos os studios, incluindoo Analysis Studio. Utilizando este pacote é possível drill up e drill down.

Armazém de Dados da GA (consulta) é uma visualização não dimensional dobanco de dados VENDASGADW. Este pacote pode ser usado em todos os studios,exceto o Analysis Studio, e serve para fazer relatórios quando não houvernecessidade de drill up ou drill down.

Vendas GA (consulta) é uma visualização não dimensional do banco de dadosVENDASGA. Este pacote pode ser usado em todos os studios, exceto o AnalysisStudio, e serve para fazer relatórios quando não houver necessidade de drill up oudrill down.

Vendas e Marketing (cubo) é um pacote OLAP, baseado no cubosales_and_marketing.mdc.

Grandes Aventuras (cubo) é um pacote OLAP, baseado no cubogreat_outdoors_sales_en.mdc.

Nota: Os pacotes OLAP, Vendas da Grandes Aventuras (cubo) e Vendas eMarketing (cubo), não são multilíngues. O archive IBM_Cognos_PowerCube.zipcontém cinco versões de cada pacote; em inglês, francês, alemão, japonês e chinês.


Instalação do IBM Cognos Business Intelligence SamplesAs amostras do IBM Cognos Business Intelligence ilustram os recursos do produtoe as melhores práticas técnicas e de negócios. Também é possível utilizá-las paratestar e compartilhar técnicas de desenvolvimento de relatórios e de solução deproblemas. Se deseja usar as amostras, instale-as a partir do disco do IBM CognosBusiness Intelligence Samples ou a partir do local em que foi feito o download e aextração dos arquivos.

Instale as amostras em um diretório que contenha apenas caracteres ASCII nonome do caminho. Alguns servidores não aceitam caracteres que não sejam ASCIIem nomes de diretórios.

Instalando Amostras no UNIX ou LinuxUse o procedimento a seguir para instalar as amostras do IBM Cognos BusinessIntelligence nos sistemas operacionais UNIX ou Linux.

Procedimento1. Monte o disco do produto IBM Cognos usando as extensões de arquivo Rock

Ridge ou acesse o local onde os arquivos de instalação foram transferidos pordownload.Para montar o disco do IBM Cognos em HP-UX, faça o seguinte:v Adicione o diretório pfs_mount no caminho.


exporte PATH

v Para iniciar os daemons NFS necessários e executar os daemons no plano defundo, digite bg pfs_mountd e digite bg pfsd






3. Siga as instruções do assistente de instalação e copie os arquivos necessáriospara seu computador.Instale as amostras no mesmo local dos componentes do servidor.

4. Na página Concluir do assistente de instalação, clique em Concluir.

Instalando Amostras no WindowsUse o seguinte procedimento para instalar as amostras do IBM Cognos BusinessIntelligence nos sistemas operacionais Microsoft Windows.


Procedimento1. Insira o disco Samples ou vá para o local para o qual os arquivos de instalação

foram baixados e extraídos.A página Bem-vindo do assistente de instalação aparece.

2. Se a página Bem-vindo não aparecer, vá para o diretório do sistemaoperacional e clique duas vezes no arquivo issetup.exe.

3. Selecione o idioma para utilizar na instalação.Essa seleção determina o idioma da interface com o usuário. É possível alteraro idioma para qualquer um dos idiomas instalados depois de concluída ainstalação.

4. Siga as instruções do assistente de instalação e copie os arquivos necessáriospara seu computador.Instale as amostras no mesmo local dos componentes do servidor.

5. Na página Concluir do assistente de instalação, clique em Concluir.Use o menu Iniciar do sistema operacional Microsoft Windows para iniciar oIBM Cognos Configuration a partir da pasta de atalho.

Configurando as AmostrasPara configurar as amostras, você deve executar várias tarefas de configuração,como restaurar os bancos de dados de amostras e criar conexões de origem dedados.

Após configurar as amostras, é possível usá-las para aprender como usar osoftware IBM Cognos, incluindo o Framework Manager, Metric Studio, MetricDesigner, Event Studio, IBM Cognos Workspace e IBM Cognos Mobile.

O IBM Cognos BI fornece bancos de dados de amostras que contêm informaçõesde vendas, marketing e financeiras para uma empresa fictícia chamada Companhiade Aventuras de Amostra, que vende equipamento esportivo.

Antes de ser possível usar os bancos de dados de amostras, o IBM Cognos BI deveestar instalado, configurado e em execução e, em seguida, o IBM Cognos BISamples deve ser instalado. Para usar a ferramenta de modelagem, você deveinstalar os componentes Framework Manager, Metric Designer, Transformer eDynamic Cubes.

Utilizando AmostrasÉ possível usar as amostras do IBM Cognos para aprender como usar o IBMCognos Business Intelligence, incluindo Framework Manager, Metric Studio, MetricDesigner, Event Studio, IBM Cognos Workspace e IBM Cognos Mobile.

O IBM Cognos BI fornece bancos de dados de amostras que contêm informaçõesde vendas, marketing e financeiras para uma empresa fictícia chamada Companhiade Aventuras de Amostra, que vende equipamento esportivo.

Antes de ser possível usar os bancos de dados de amostras, o IBM Cognos BI deveestar instalado, configurado e em execução e, em seguida, o IBM Cognos BISamples deve ser instalado.

Para usar a ferramenta de modelagem, instale os componente do FrameworkManager, Metric Designer e Transformer.


Para configurar as amostras, faça o seguinte:v Restaure os bancos de dados de amostras. É possível restaurar manualmente os

arquivos de backup do banco de dados de amostra. Para obter instruções,consulte “Estapas para Restaurar Arquivos de Backup para Banco de Dados deAmostras” na página 467.Também é possível restaurar os arquivos de backup usando scripts. Para DB2,consulte “Restaurar as Amostras no IBM DB2 Usando um Script” na página 468.Para Oracle, consulte “Restaurar as Amostras em Oracle Usando um Script” napágina 472.

v Crie as conexões de origem de dados para os bancos de dados de amostras.v Se estiver planejando utilizar as amostras de origens de dados OLAP, configure

a conexão aos cubos das amostras, se necessário, e crie conexões para as origensde dados OLAP que deseja utilizar.Tarefas de configuração são obrigatórias apenas para cubos do MicrosoftAnalysis Services, cubos do Essbase e Cubing Services.

v Caso pretenda usar a amostra do Metric Studio, configure-av Se quiser usar a amostra do Metric Designer, configure uma conexão de origem

de dados para a mesma, configure a amostra do Metric Studio e importe osarquivos de implementação IBM_Cognos_Samples eIBM_Cognos_Metrics.

v Importe o conteúdo das amostras (pacotes) para o armazenamento de conteúdo.v Se desejar testar o agente de amostras Agente de devoluções ELM utilizando o

Event Studio, execute o agente de amostra com base nos dados alterados.

Após concluir essas tarefas, use IBM Cognos BI para executar os relatórios deamostra ou scorecards. É possível remover posteriormente as amostras do IBMCognos BI.

Restaurando Arquivos de Backup para Banco de Dados deAmostras

Para usar as amostras do IBM Cognos Business Intelligence, você deve restaurar osarquivos de backup dos bancos de dados de amostras. Essa ação cria versõesmultilíngues dos bancos de dados da Aventuras de Amostra.

Os seguintes bancos de dados de amostras e arquivos associados são fornecidoscom o IBM Cognos Business Intelligence. Para o Microsoft SQL Server,descompacte o arquivo GS_DB_ORA.tar.gz e cada banco de dados será entreguecomo um arquivo de backup do Microsoft SQL Server. Para o Oracle, descompacteo arquivo GS_DB_ORA.tar.gz. Para o IBM DB2, descompacte o arquivoGS_DB.tar.gz. Os bancos de dados podem ser localizados nos seguintes locais.

Tabela 103. Locais de Backup de Amostras de IBM DB2 e Oracle

Bancos de dados Local do arquivo

IBM DB2 GS_DB\data

Oracle GS_DB_ORA\data

Tabela 104. Bancos de Dados de Amostra e Arquivos Associados do IBM DB2

Descrição do banco de dados ou esquema Nome de arquivo

Vendas da Grandes Aventuras GS_DB.tar.gz

Varejistas da Grandes Aventuras GS_DB.tar.gz


Tabela 104. Bancos de Dados de Amostra e Arquivos Associados do IBMDB2 (continuação)


Armazém de dados de vendas da GrandesAventuras

GS_DB.tar.gz

Procura de mercado da Grandes Aventuras GS_DB.tar.gz

Recursos humanos da Grandes Aventuras GS_DB.tar.gz

Tabela 105. Bancos de Dados e Arquivos do Microsoft SQL Server


Vendas da Grandes Aventuras VENDASGA.zip

Varejistas da Grandes Aventuras VENDASGA.zip


GOSALESDW. zip

Procura de mercado da Grandes Aventuras VENDASGA.zip

Recursos humanos da Grandes Aventuras VENDASGA.zip

Tabela 106. Bancos de Dados e Arquivos do Oracle


Vendas da Grandes Aventuras GS_DB_ORA.tar.gz

Varejistas da Grandes Aventuras GS_DB_ORA.tar.gz


GS_DB_ORA.tar.gz

Procura de mercado da Grandes Aventuras GS_DB_ORA.tar.gz

Recursos humanos da Grandes Aventuras GS_DB_ORA.tar.gz

Para restaurar os bancos de dados de amostras, certifique-se de fazer o seguinte:v Atribua aos bancos de dados restaurados os mesmos nomes dos arquivos de

backup ou exportação.Os nomes diferem maiúsculas de minúsculas.Utilize o nome do usuário e a senha corretos.

v Crie usuários com os privilégios selecionados para tabelas em vários esquemas.Para configurar os pacotes de Armazém de Dados da GA, especifique um únicoobjeto de conexão e signon de usuário. Crie um único usuário denominadoGOSALESDW com o privilégio selecionado para tabelas em um único esquemadenominado GOSALESDW.Os pacotes GA Vendas especificam um único objeto de conexão e signon deusuário. Crie um único usuário denominado GOSALES com o privilégioselecionado para tabelas nos seguintes esquemas: GOSALES, GOSALESHR,GOSALESMR e GOSALESRT.

v Use o conjunto de caracteres UTF-8 no computador com sistema operacionalMicrosoft Windows que seja cliente Oracle ou DB2 para ver os relatórios emvários idiomas.Para o DB2, você deve configurar a variável de ambiente DB2CODEPAGE paraum valor de 1208. No Oracle, defina a variável de ambiente NLS_LANG paraum valor específico de uma região. Por exemplo, defina NLS_LANG paraAméricas para American_America.UTF8.


v Tenha espaço disponível em disco suficiente no local de destino. Reserve 150 MBpara os dados de Vendas GA (quatro esquemas) e 200 MB para os dados dearmazém Vendas GA (um esquema).

Considerações do IBM DB2

Os arquivos de dados para db2move (um comando de ferramenta demovimentação do banco de dados) e os scripts, para incluir restrições, sãolocalizados no diretório de dados. O diretório de dados é criado ao descompactar oarquivo GS_DB.tar.gz.

Se você usar WinZip para extrair o arquivo de movimentação do DB2 em umambiente Microsoft Windows, assegure-se de que a opção de conversão CR/LFinteligente do arquivo TAR não esteja selecionada.

Após extrair o arquivo de movimentação do DB2, restaure os esquemas para umbanco de dados chamado GS_DB.

Para adicionar visualizações, restrições, privilégios de usuários e procedimentosarmazenados ao GS_DB, prepare e execute os arquivos gs_db_modify fornecidoscom as amostras na seguinte ordem:1. Atualize o nome de usuário e senha em gs_db_modify.sql e salve-o.2. Execute gs_db_modify.bat

Nota: Se o arquivo de script tentar criar um procedimento armazenado no qual oprocedimento não exista, será gerado um erro. Esse erro não afeta as amostras.

Os requisitos de memória são afetados pelo tamanho e tipo do sistema de bancode dados. O banco de dados de amostras GO cujas tabelas estão organizadas porcoluna pode requerer mais memória do que a configuração típica baseada emlinha.

Considerações sobre o Oracle

Para criar restrições de chaves estrangeiras em tabelas referentes a esquemasdiferentes, execute o arquivo gs_or_modify.sql localizado na mesma pasta que osarquivos .dmp.

Estapas para Restaurar Arquivos de Backup para Banco deDados de AmostrasUse este procedimento para restaurar os arquivos de backup.

Procedimento1. NO computador onde o IBM Cognos BI está instalado, vá ao diretório sql

server, oracle ou db2 localizado em c10_location/webcontent/samples/datasources.

2. Se necessário, copie os arquivos de backup dos bancos de dados de amostraspara seu diretório de backups de bancos de dados.

3. Restaure os bancos de dados de amostras utilizando sua ferramenta degerenciamento de bancos de dados.

Dica:

v Para arquivos de backup SQL, restaure o banco de dados a partir de umdispositivo e certifique-se de que os locais de restauração estão corretos paraos arquivos de banco de dados .ldf e .mdf. Para obter mais informações,


consulte a documentação do Microsoft SQL Server ou a Base deConhecimento, que está disponível em IBM Support Portal(http://www.ibm.com/software/analytics/support/finding-answers).

v Para DB2, quando você criar um banco de dados GS_DB, crie um buffer poolpadrão do sistema com um tamanho de página de 32 KB e um espaço detabela regular associado. Assegure-se de que o espaço de tabela provisório dosistema também tenha 32 KB.

4. Para cada banco de dados, crie no mínimo um usuário que tenha as permissõesselecionadas para todas as tabelas dos bancos de dados customizados.

Resultados

Agora você já pode criar as conexões de origens de dados no portal.

Restaurar as Amostras no IBM DB2 Usando um ScriptÉ possível usar scripts para restaurar arquivos de backup para bancos de dados deamostras para o DB2.

Para configurar o banco de dados de amostra, você deve extrair o arquivo GS_DBtar.gz, customizar um arquivo de configuração e executar o script deconfiguração.

Há pré-requisitos para a instalação do banco de dados de amostras GrandesAventuras para DB2 no Linux, UNIX e Windows. Antes que seja possível instalaros bancos de dados de amostra, você deverá verificar ou configurar privilégios.1. Extraia o arquivo GS_DB.tar.gz e retenha a estrutura de diretório original. Se

você usar WinZip para extrair o arquivo de movimentação do DB2 no sistemaoperacional Microsoft Windows, certifique-se de que a opção de conversãoCR/LF inteligente do arquivo TAR não esteja selecionada.

2. Nos sistemas operacionais Linux e UNIX, modifique as permissões de arquivosno arquivo setupGSDB.sh de forma que ele seja executável: chmod u+xsetupGSDB.sh.

3. Certifique-se de que o ID do usuário usado para configurar o banco de dadostenha autoridade DBADM ou as seguintes autoridades no DB2:v CREATETABv CREATE_NOT_FENCED_ROUTINEv LOAD

Opcional: edição do arquivo de configuração

O arquivo de configuração contém as opções de configuração padrão que sãousadas ao criar os dados GOSALES. As definições de configuração padrão sãolistadas na seguinte tabela.

Tabela 107. Valores Opcionais para Restaurar as Amostras no IBM DB2

Ajuste de configuração Padrão Descrição

GOSALES_INST GS_DB Usado para configurar onome ou alias do banco dedados.

GOSALES_BLU N Altere para 'Y' se criartabelas organizadas porcoluna.



Tabela 107. Valores Opcionais para Restaurar as Amostras no IBM DB2 (continuação)


GOSALES_CREATEDB Opcional: faz com que umbanco de dados existentecom o mesmo nome sejaeliminado.

GOSALES_DB_TERRITORY US Ao criar um banco de dados,esta é a região do banco dedados UTF-8 que é criada.

GOSALES_BP

GOSALES_TS

GOSALES_BP

GOSALES_TS

Opcional: informe o nome dopool de buffers e espaço detabela, caso eles sejamcriados pelo script.

GOSALES_GRANTEES GOSALES, DB2ADMIN Informe a lista de usuários,grupos ou PUBLIC que terãopermissões CONTROL paraos esquemas GOSALES,GOSALESHR, GOSALESMRe GOSALESRT. Essasequência deve seguir asintaxe do comando GRANT.

GOSALESDW_GRANTEES DWVENDASGA

DB2ADMIN

Informe a lista de usuários,grupos ou PUBLIC que terãopermissões CONTROL parao esquema GOSALESDW.

GOSALES_DPF N Altere para 'Y' se estiverinstalando um ambienteparticionado de banco dedados (DPF)

GOSALES_SCHEMA

GOSALESHR_SCHEMA

GOSALESMR_SCHEMA

GOSALESRT_SCHEMA

GOSALESDW_SCHEMA

VENDASGA

GOSALESHR

GOSALESMR

GOSALESRT

DWVENDASGA

Informe os nomes a seremusados para cada esquema.

É possível customizar o arquivo de configuração de amostra para usar outrasconfigurações além dos valores padrão.

O script de ajuste cria o banco de dados GS_DB, espaços de tabela, tabelas,visualizações, concede privilégios e modifica os nomes dos esquemas para o bancode dados de amostra. Na maioria das situações, é possível aceitar as opçõespadrão. Se quiser alterar o nome do banco de dados ou modificar os usuários ougrupos que têm permissões sobre os dados, deverá atualizar o arquivo deconfiguração GOSalesConfig.

Edite o arquivo de configuração usando um editor de texto.

Nota: Se você editar os shell scripts UNIX em um ambiente Windows, certifique-sede preservar os términos de linha do UNIX.


O arquivo de configuração em Windows é GOSalesConfig.bat. O arquivo deconfiguração em UNIX é GOSalesConfig.sh.

Por padrão, o nome do banco de dados GS_DB é usado e são concedidaspermissões para os usuários DB2ADMIN (Linux, UNIX, Windows) e GOSALES.

Executando o Script de Ajuste no Modo Interativo

No modo interativo, o script setupGSDB solicita a confirmação ou fornecimento deinformações de configuração para a instalação do banco de dados GS_DB. Épossível aceitar as configurações padrão ou fornecer configurações diferentes parasubstituir os padrões.v Execute o script de ajuste para o sistema operacional.

Tabela 108. Executando o Script de Restauração de Amostras

Sistema operacional Comando

Microsoft Windows Em um janela de comando do DB2, altere odiretório GS_DB/win e execute o scriptsetupGSDB.bat.

UNIX Em um prompt de shell, direcione amudança de db2profile para o diretórioGS_DB/unix e execute o script setupGSDB.sh.

v Pressione Enter para continuar. O script exibe um resumo das suas escolhasantes de confirmar as mudanças no ambiente. Se você aprovar as escolhas,pressione Enter e o script fará as mudanças. Por exemplo, você poderá ver aseguinte mensagem:

Please confirm the following settings:Database Name: GS_DBColumn-organized tables: N (DB2 on UNIX only)Drop and Recreate Database: YDPF environment: NCreate a 32 K Bufferpool named: GOSALES_BPCreate a 32 K Tablespace named: GOSALES_TSGOSALES Grant users/groups: GOSALES, DB2ADMINGOSALESDW Grant users/groups: GOSALESDW, DB2ADMINAdministration User Name: db2adminImport the sample data to the following schemas:GOSALESGOSALESHRGOSALESMRGOSALESRTGOSALESDWWARNING: If the database GS_DB already exists it will be droppedContinue creating the sample data with these settings? (Y/N) Default=Y:

O banco de dados GS_DB está configurado.

Execução do script de ajuste com opções da linha de comandos

O script setupGSDB possibilita o fornecimento de informações na linha decomandos para reduzir o número de prompts do script.

Em uma linha de comandos, execute o script para o sistema operacional. EmWindows use setupGSDB.bat. Em sistemas operacionais UNIX ou Linux usesetupGSDB.sh.

É possível executar o script setupGSDB com as seguintes opções:


Tabela 109. Opções de setupGSDB para IBM DB2

Opção Descrição

-createdbCria o banco de dados. Essa opção eliminaos bancos de dados existentes com o mesmonome. Ela cria o pool de buffers e o espaçode tabela exigidos.

-database database nameEspecifica o nome do banco de dados. Essevalor substitui o valor padrão de GS_DB.

-userid administration_user_IDEspecifica o nome do ID de usuário deadministrador do DB2 que é usado paracriar o banco de dados.

-password administration_user_IDEspecifica a senha para o ID de usuário deadministrador do DB2.

-nopromptIndica que nenhum prompt será exibido.Essa opção executa o script no modosilencioso. Informações inexistentes fazemcom que o script falhe. Não será solicitadanenhuma confirmação.

Exemplo 1: Você é um administrador DB2 e deseja criar o banco de dados GS_DBpadrão no nó local. Execute o comando a seguir:

setupGSDB -createDB -noprompt

Exemplo 2: Você deseja criar as tabelas em um banco de dados existentedenominado GSDBY e deseja usar o ID de usuário de administrador db2admin.Execute o seguinte comando:

setupGSDB -database GSDBY -userid db2admin

O script solicita a senha ao se conectar ao GSDBY. O script substituirá as tabelasque já existem no banco de dados GSDBY, a menos que você opte por eliminar obanco de dados.

Opcional: instalação dos dados de amostra em um servidorremoto

Se o banco de dados de amostra GS_DB estiver instalado em um servidor remotono ambiente, será possível vinculá-lo ao catalogar o banco de dados remoto nocomputador local e, em seguida, executar o script de ajuste localmente.v Se o banco de dados de amostras não existir no servidor remoto, crie-o com o

comando CREATE DATABASE. O banco de dados requer um conjunto de códigoUTF-8 e um buffer pool com tamanho de página de 32 KB para os espaços detabela temporário e padrão. Por exemplo, no servidor remoto, crie o banco dedados executando o comando a seguir:CREATEDATABASE GS_DB USING CODESET UTF-8 TERRITORY US PAGESIZE 32K

v No computador local, catalogue o banco de dados remoto:db2catalog tcpip node nodename remote ipaddr server port_numberdb2 catalog database GS_DB as GS_DB at node nodename

v No computador local, execute o script:


setupGSDB-database GS_DB -userid administration_user_ID

Será solicitada uma senha para que você se conecte ao banco de dados.

Restaurar as Amostras em Oracle Usando um ScriptÉ possível usar scripts para restaurar arquivos de back-up para bancos de dadosde amostra para Oracle.

Para configurar o banco de dados de amostra, você deve extrair o arquivoGS_DB_ORA.tar.gz, customizar um arquivo de configuração e executar o script deconfiguração.

Há pré-requisitos para a instalação do banco de dados de amostras GrandesAventuras para Oracle. Antes que seja possível instalar os bancos de dados deamostra, você deverá verificar ou configurar privilégios.v Extraia o arquivo GS_DB_ORA.tar.gz e mantenha a estrutura de diretórios

original.v Nos sistemas operacionais Linux e UNIX, modifique as permissões de arquivos

no arquivo setupGSDB.sh de forma que ele seja executável: chmod u+xsetupGSDB.sh.

v Certifique-se de que o ID de usuário utilizado para configurar o banco de dadosOracle tenha autoridade para criar usuários e executar o utilitário de importação.

Opcional: edição do arquivo de configuração

O arquivo de configuração contém as opções de configuração padrão que sãousadas ao criar os dados GOSALES.

Tabela 110. Valores Opcionais para Restaurar Amostras em Oracle


GOSALES_IMP_CMD imp Se necessário, pode ser modificadopara especificar o caminho completopara a versão correta do utilitário deimportação.

GOSALES_INST Sequência do host da Oracle.

GOSALES_TS GOSALES_TS Se os usuários forem criados porscripts, use para informar o nomedo tablespace para atribuir aosusuários.

GOSALES_CREATE_TS Opcional: usado para criar otablespace padrão para usuários.

GOSALES_TEMP_TS Se os usuários forem criados porscripts, use para designar nome aotablespace temporário para atribuiraos usuários. Deixe em branco parausar o tablespace temporáriopadrão.

GOSALES_SCHEMA

GOSALES_SCHEMA_PW

VENDASGA

GOSALESPW

Usado para informar o nome deusuário e senha para o usuárioGOSALES. Se não for informado,será solicitada uma senha.


Tabela 110. Valores Opcionais para Restaurar Amostras em Oracle (continuação)


GOSALESHR_SCHEMA

GOSALESHR_SCHEMA_PW

GOSALESHR

GOSALESHRPW

Usado para informar o nome deusuário e a senha para o usuárioGOSALESHR. Se não for informado,será solicitada uma senha.

GOSALESMR_SCHEMA

GOSALESMR_SCHEMA_PW

GOSALESMR

GOSALESMRPW

Usado para informar o nome deusuário e a senha para o usuárioGOSALESMR. Se não forinformado, será solicitada umasenha.

GOSALESSRT_SCHEMA

GOSALESRT_SCHEMA_PW

GOSALESRT

GOSALESRTPW

Usado para informar o nome deusuário e a senha para o usuárioGOSALESRT. Se não for informado,será solicitada uma senha.

GOSALESDW_SCHEMA

GOSALESDW_SCHEMA_PW

DWVENDASGA

GOSALESDWPW

Usado para informar o nome deusuário e senha para o usuárioGOSALESDW. Se não forinformado, será solicitada umasenha.

GOSALES_GRANTEES VENDASGA Usado para informar os usuáriosque terão as permissões SELECT,INSERT, DELETE, UPDATE eALTER para os esquemasGOSALES, GOSALESHR,GOSALESMR e GOSALESRT.

Observação: o proprietário doGOSALES_SCHEMA semprereceberá a concessão do privilégioSELECT, INSERT, DELETE,UPDATE e ALTER em todos osesquemas.

GOSALESDW_GRANTEES DWVENDASGA Usado para informar os usuáriosque terão as permissões SELECT,INSERT, DELETE, UPDATE eALTER para o esquemaGOSALESDW.

É possível personalizar o arquivo de configuração de amostra para usar outrasdefinições além dos valores padrão.

O script de ajuste cria os usuários e esquemas especificados no arquivo deconfiguração. Na maioria das situações, é possível aceitar as opções padrão. Sequiser alterar os nomes dos esquemas ou modificar os usuários ou grupos que têmpermissões sobre os dados, deverá atualizar o arquivo de configuraçãoGOSalesConfig.

Edite o arquivo de configuração GOSalesConfig.bat ou GOSalesConfig.sh usandoum editor de texto.


Execução do Script de Ajuste no Modo Interativo

Em modo interativo, o script setupGSDB solicita a confirmação ou fornecimento deinformações de configuração para a instalação do banco de dados de amostras. Épossível aceitar as configurações padrão ou fornecer configurações diferentes parasubstituir os padrões.v Execute o script de ajuste para o sistema operacional.

Tabela 111. Executando o Script de Restauração de Amostras

Sistema operacional Comando

Microsoft Windows Em uma janela de comando de DOS, alterepara o diretório GS_DB_ORA\win e execute oscript setupGSDB.bat.

UNIX Em um prompt de shell, altre para odiretório GS_DB_ORA/unix e execute o scriptsetupGSDB.sh.

v Pressione Enter para continuar. O script executará o ajuste do banco de dados deamostra e exibirá um resumo das suas escolhas antes de confirmar as mudançasno ambiente. Se você aprovar as escolhas, pressione Enter e o script fará asmudanças. Por exemplo, você poderá ver a seguinte mensagem:Please confirm the following settings:

Instance Name is ORAINST123Create the following user accounts and import the data:GOSALESGOSALESHRGOSALESMRGOSLAESRTGOSALESDW

Default tablespace is GOSALES_TSTemporary tablespace is DEFAULTAdministration User name is sys

WARNING: If the users already exist they will be dropped

Create a Tablespace named GOSALES_TS

Grant select on the GOSALES schemas to GOSALESGrant select on the GOSALESDW schema to GOSALESDW

Continue creating the sample data with these settings?(Y/N) Default=Y:

Dica: Se você editar os shell scripts UNIX em um ambiente Windows,certifique-se de preservar os términos de linha do UNIX.

Execução do script de ajuste com opções da linha de comandos

O script setupGSDB possibilita o fornecimento de informações na linha decomandos para reduzir o número de prompts do script.

Em uma linha de comandos, execute o script para o sistema operacional. EmWindows use setupGSDB.bat. Em sistemas operacionais UNIX ou Linux usesetupGSDB.sh.

É possível executar o script setupGSDB com as seguintes opções:


Tabela 112. Opções de setupGSDB para Oracle

Opção Descrição

-createdbCria os usuários. Essa opção elimina osusuários existentes com o mesmo nome.

-database database nameEspecifica o nome da instância Oracle. Essevalor substitui o valor padrão especificadono arquivo de configuração.

-userid administration_user_IDEspecifica o nome do ID de usuário doadministrador do Oracle usado para criar osusuários.

-password administration_user_IDEspecifica a senha para o ID de usuário doadministrador do Oracle.

-nopromptIndica que nenhum prompt será exibido.Essa opção executa o script no modosilencioso. Informações inexistentes fazemcom que o script falhe. Não será solicitadanenhuma confirmação.

Exemplo 1: Você é um administrador do Oracle e deseja criar os esquemas debanco de dados de amostras padrão. Execute o comando a seguir:

setupGSDB -createDB -noprompt

Exemplo 2: Você deseja criar as tabelas em esquemas existentes especificados noarquivo de configuração e deseja usar o ID de usuário de administrador sys.Execute o seguinte comando:

setupGSDB -YourOracleInstance -userid sys -sysdba

O script solicita a senha ao se conectar à instância Oracle. O script exclui as tabelasou visualizações existentes nos esquemas especificados e os substitui.

Criar Conexões de Origem de Dados para os Bancos deDados de Amostras

Você deve criar conexões de origens de dados para os bancos de dados deamostras restaurados.

O IBM Cognos Business Intelligence usa conexões de origem de dados para bancosde dados de amostras para conectar-se aos bancos de dados de amostras e executaros relatórios de amostra ou usar o pacote de amostra.

Antes de Iniciar

O nome do banco de dados DB2 digitado deve usar letras maiúsculas. Além disso,no Framework Manager, os nomes de esquemas digitados para as origens dedados do DB2 devem usar letras maiúsculas.

Antes de criar as conexões de origens de dados, você deve restaurar os arquivos debackup dos bancos de dados de amostras. Além disso, certifique-se de que oserviço do IBM Cognos BI esteja em execução.


Para criar origens de dados, você deve ter permissões de execução para o recursoprotegido Conexões de Origem de Dados e permissões de acesso à hierarquia paraa função protegida Administração. Você deve ter permissões de gravação para onamespace Cognos.

Se você restaurou os bancos de dados de amostra em um computador diferente docomputador onde foram instalados os Componentes da Camada de Aplicativos doIBM Cognos BI, talvez seja necessário instalar o cliente de banco de dados paraacessar os bancos de dados de amostra. Para obter informações adicionais, consulte“Configurar a Conectividade de Banco de Dados para Bancos de Dados deRelatório” na página 93 no Guia de Instalação e Configuração do IBM Cognos BusinessIntelligence.

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.

3. Clique no ícone de nova origem de dados .4. Na caixa Nome, digite great_outdoors_sales e clique em Avançar.5. Na página de conexão, clique no tipo de banco de dados restaurado e ao qual

deseja conectar-se, selecione um nível de isolamento e clique em Avançar.A página da sequência de conexões do banco de dados selecionada aparece.Nota: Por padrão, a criação de uma conexão de origem de dados ativaamostras que usam o modo de consulta dinâmica. Se você desejar usar apenasas amostras compatíveis, cancele a seleção Configurar Conexão JDBC.Dica: O usuário especificado na origem de dados great_outdoors_sales deveter privilégios de seleção nas tabelas de cada um dos esquemas GOSALES,GOSALESRT, GOSALESMR e GOSALESHR.

6. Execute um dos seguintes procedimentos:v Se você restaurou os bancos de dados de amostras no Microsoft SQL Server,

na caixa Nome do Servidor, digite o nome do servidor no qual os bancosde dados restaurados estão localizados. Na caixa Nome do banco de dadosdigite GOSALES.As amostras do IBM Cognos BI requerem conectividade TCP/IP com oMicrosoft SQL Server. Certifique-se a Segurança do SQL Server estejaconfigurada para SQL Server e sistema operacional Microsoft Windows emvez de Apenas Windows. As amostras utilizam a segurança do SQL Serverpara autenticação.

v Se você restaurou os bancos de dados de amostras no Oracle, na caixaSequência de Conexão do SQL*Net, digite o nome da instância do bancode dados Oracle conforme inserido no arquivo tnsnames.ora.

v Se você restaurou o banco de dados de amostras no DB2, na caixa Nome dobanco de dados DB2, digite GS_DB usando letras maiúsculas. Deixe acaixa Sequência de Conexão do DB2 em branco.

v Se você implementou o cubo de amostra no IBM InfoSphere WarehouseCubing Services, na caixa Nome, digite sales_and_marketing_cs. Na páginaEspecificar a Conexão para a caixa Tipo, selecione IBM InfoSphereWarehouse cubing services (XMLA). Na página Especificar a sequência deconexões da caixa de URL do servidor, digite o nome do servidor e o


número da porta XMLA do cubo, seguido por /IBMXmlAnalysis. Porexemplo: meuservidor:1999/IBMXmlAnalysis.

7. Em Conexões, selecione as caixas de seleção Senha e Criar uma conexão queo grupo Todos pode usar, digite a ID do usuário e a senha para o usuário quefoi criado quando os bancos de dados foram restaurados, e então clique emConcluir.Dica: Para testar se os parâmetros estão corretos, clique em Testar aconexão....

8. Clique em Concluir.9. Repita as etapas 4 a 9 para o banco de dados de amostras ou esquema

GOSALESDW e digite great_outdoors_warehouse na etapa 5.10. Se o modelo GOSALESW for usado por modeladores no IBM Cognos

Transformer, a sequência de conexões deverá ser incluída manualmente noarquivo cs7g.ini.v Se você implementou o cubo de amostra no IBM InfoSphere Warehouse

Cubing Services, na caixa Nome, digite sales_and_marketing_cs. Na páginaEspecificar a Conexão da caixa Tipo, selecione serviços de cubo do IBMInfoSphere Warehouse (XMLA). Na página Especificar a sequência deconexões da caixa de URL do servidor, digite o nome do servidor e onúmero da porta XMLA do cubo, seguido por /IBMXmlAnalysis. Porexemplo: meuservidor:1999/IBMXmlAnalysis.

Resultados

As conexões de origem de dados da Aventuras de Amostra aparecem comoentradas em Conexões de Origem de Dados.

Agora você já pode importar as amostras a menos que haja um erro de sintaxe nasequência de conexão ou um parâmetro incorreto.

Configurar Amostras de Cubos do Microsoft Analysis ServicesO IBM Cognos Connection ou Framework Manager fornece cubos de amostra parao Microsoft Analysis Services (MSAS).

Para dados financeiros, use o cubo GA Info Finanças derivado do banco de dadosDWVENDASGA. Esse cubo contém dados financeiros mensais e atualizadosanualmente sobre todas as contas para que você possa criar extratos financeiros noAnalysis Studio, Query Studio e Report Studio. Os dados estão na forma deresultados em dólares norte-americanos reais para 2004, 2005, 2006 ou 2007(somente dados reais de sete meses).

A versão MSAS2005 está no formato GOFinanceFact_XX.abf. XX representa oidioma. Por exemplo, XX é substituído por EN para indicar inglês. A versãoMSAS2008 de cubos também existe, com o conteúdo de relatório apenas para aversão 2005.

Para dados de vendas, utilize o cubo GOSalesFact derivado do banco de dadosGOSalesFact_XX do Analysis Services, baseado no banco de dados SQLSERVERGOSALESDW. O cubo contém medidas como custo unitário, preço unitário,quantidade e lucro bruto. As dimensões incluem Tempo, Produto e Varejistas.

A versão MSAS2005 está no arquivo de backup restaurável GOSalesFact_XX.abf.


Os arquivos de backup estão localizados no diretório c10_location/webcontent/samples/datasources/cubes/MSAS. Os arquivos devem ser restaurados para umbanco de dados do Microsoft SQL Server que esteja executando o MicrosoftAnalysis Services aplicável e hospedando o banco de dados GOSALESDW.

Nota: O Microsoft XML 6.0 Parser e o Microsoft SQL 2005 Analysis Services 9.00OLEDB Provider devem ser instalados no cliente local para estabelecer conexões deorigem de dados para cubos do MSAS.

Procedimento1. No computador no qual o IBM Cognos Business Intelligence está instalado,

acesse o diretório c10_location/webcontent/samples/datasources/cubes/MSAS/en.

2. Copie os arquivos GOSALESDW.cab e GOSALESDW.abf para um diretório quepode ser acessado a partir do console do Analysis Manager nos AnalysisServers do Microsoft SQL Server.

3. Use o Microsoft Analysis Services Analysis Manager para restaurar o banco dedados dos arquivos GOSALESDW.cab e GOSALESDW.abf.

Resultados

Agora é possível criar as conexões de origem de dados para estas origens de dadosdo MSAS no Cognos Administration fazendo referência aos cubos GOSalesFact_XXou GOFinanceFact_XX restaurados.

Configurar a Amostra de Serviços de Cubo do InfoSphereWarehouse

Antes de Iniciar

Antes de configurar as amostras dos Serviços de Cubo do InfoSphere Warehouse,você deve restaurar o banco de dados de amostra do DB2.

Procedimento1. No computador em que o software IBM Cognos é instalado, acesse o diretório

db2 localizado em c10_location/webcontent/samples/datasources/cubes/CubingServices/. Selecione o idioma de sua opção.

2. Se for necessário, copie o arquivo csgodw.xml no diretório de trabalho.3. No IBM InfoSphere Warehouse Design Studio, importe o arquivo de metadados

csgodw.xml para um modelo de dados com base no esquema DB2 GS_DW.4. Implemente o cubo CSGODW no esquema DB2 GS_DW.5. Use o IBM InfoSphere Warehouse Administration Console para incluir o novo

cubo em um servidor de cubos e execute-o.Observe o número da porta XMLA para o cubo, pois esse número serásolicitado para a conexão da origem de dados.

Resultados

Agora, é possível criar as conexões de origem de dados no portal do IBM CognosConnection.


Configure as Amostras do IBM Cognos TM1Para usar as amostras do IBM Cognos TM1, você deve configurar os servidores,criar um atalho para o arquivo de configuração, importar os arquivos deimplementação e criar as conexões de origem de dados.

Para configurar as amostras do servidor Cognos TM1, descompacte e instale osarquivos greatoutdoors.zip. Para configurar o Cognos TM1 FinanceFact Server,descompacte e instale os arquivos financefact.zip. O caminho da instalaçãopadrão para estes arquivos é: C:\Arquivos de Programas\IBM\Cognos\c10\webcontent\samples\datasources\cubes\tm1.

Procedimento1. Certifique-se de que tenha o software TM1 instalado e o servidor iniciado.2. Crie um atalho de desktop para o local pré-configurado do arquivo de

configuração TM1s.cfg. O local padrão é: "C:\Program Files\IBM\Cognos\TM1\bin\tm1s.exe" -z "C:\Program Files\IBM\Cognos\c10\webcontent\samples\datasources\cubes\tm1\greatoutdoors"

3. Se o local de seu arquivo de configuração for diferente, abra o arquivo deconfiguração em um editor de texto e modifique-o. A seguir, um exemplo dearquivo de configuração básico.v Se o modo de segurança integrado estiver configurado como 1. Todos os

clientes devem informar nome de usuário e senha do banco de dados.v Se o modo de segurança integrado estiver configurado para 2. Os clientes

terão a opção de conexão por meio de nome de usuário e senha do banco dedados ou usando o mecanismo de login único para autenticação.

v Se o modo de segurança integrado estiver configurado como 3. Todos osclientes devem usar o mecanismo de login único para autenticação.TM1SDataBaseDirectory=C:\ProgramFiles\IBM\Cognos\c10\webcontent\samples\datasources\cubes\tm1\greatoutdoors

LoggingDirectory=C:\ProgramFiles\IBM\Cognos\c10\webcontent\samples\datasources\tm1\greatoutdoors\LogFiles

Nome do servidor=Grandes AventurasNúmero da porta=33339Host de admin=host localIdioma = portProtocolo=tcpNetworkFrame=SaveTime=DownTime=RuleTraceOn=

4. Para iniciar o servidor, ative o atalho do desktop para TM1s.cfg.5. Para importar os arquivos de implementação do relatório, Sales_plan.zip,

Sales_plan_TC.zip e TM1_FinanceFact.zip, use IBM Cognos Administration.

Resultados

Os pacotes Financefact e Salesplan são criados. Estes pacotes conectam-se àsorigens de dados TM1_FinanceFact e TM1_SalesPlan que você deve agora criar noCognos Administration.


Os pacotes de implementação fazem referência às seguintes origens de dados.

Dica: Para chinês tradicional, use os pacotes x_TC.

Tabela 113. Origens de Dados de Amostra TM1

Aplicativo Origens de Dados

Grandes Aventuras TM1_SalesPlan

TM1_SalesPlan_TC

FinanceFact TM1_FinanceFact

TM1_FinanceFact_TC

Os pacotes de implantação fazem referência aos seguintes relatórios do ReportStudio.

Tabela 114. Pacotes de Implementação de Amostra TM1

Pacotes Relatórios

Grandes Aventuras Produtos que vendem mais

Comparação de preço dos canais

Previsão de receita por região: Lojas de golfe

Previsão de vendas das lojas de golfe -Américas x Ásia Pacífico

Previsão de margem bruta

FinanceFact Folha de balanço - Américas

Folha de balanço - Europa Central

Instrução de renda

Origem e aplicação de fundos (EuropaCentral)

Configurar a Amostra de Cubo EssbasePara configurar a amostra de cubo do Essbase, você deve ter o Oracle Essbase e oEssbase Integration Services Console instalados.

Alternativamente, é possível configurar o cubo Essbase menor GODBReduced.zipque é uma versão filtrada da versão integral, GODWENU. Para configurar a versãomenor, descompacte GODBReduced.zip, carregue o arquivo otl e txt no ambientedo Essbase antes de seguir as etapas precedentes.

Procedimento1. Acesse o diretório c10_location\webcontent\samples\datasources\cubes\

Essbase\Outlines_and_Raw_Data.Este diretório contém arquivos zip para os diferentes idiomas, tal como EN.zipou JA.zip para inglês e japonês, respectivamente.

2. Descompacte o arquivo correspondente ao seu idioma.Cada arquivo zip contém os dois seguintes arquivos:v languageU_Data.txt, tal como ENU_Data.txt ou JAU_Data.txt.v GODWlanguageU.otl, tal como GODWENU.otl ou GODWJAU.otl.

3. Utilizando o armazenamento em bloco do Essbase, crie um aplicativo emUnicode.


4. Dentro do aplicativo, crie um novo banco de dados.É possível usar GODWlanguageU, tal como GODWENU ou GODWJAU, como seu nomedo banco de dados ou use o nome de sua escolha.

5. Copie e cole o arquivo GODWlanguageU.otl em seu diretório do banco dedados.

6. Se o nome do banco de dados especificado na etapa 4 for diferente deGODWlanguageU, renomeie o arquivo GODWlanguageU.otl para corresponder aonome do banco de dados criado.Confirme que deseja sobrescrever o arquivo otl.

7. No console Essbase Administration Services, abra a estrutura de tópicos dobanco de dados e salve-a.Confirme se deseja salvar a estrutura de tópicos mesmo não tendo sidoalterada.

8. Copie o arquivo languageU_Data.txt e cole-o no mesmo diretório que oarquivo otl.

9. No console Essbase Administration Services, clique com o botão direito nobanco de dados criado e selecione Carregar dados.

10. Navegue até o arquivo languageU_Data.txt em seu diretório do banco dedados, selecione o arquivo e clique em OK.

11. Depois que os dados forem carregados com sucesso, clique no banco de dadose selecione Execute Calculation.

12. Selecione o cálculo padrão e depois clique em OK.O processo de cálculo pode demorar até 5 horas, dependendo do computadorem que o Essbase OLAP Server estiver instalado.

Resultados

Agora você já pode criar uma conexão de origens de dados para o cubo.

Criando Conexões de Origem de Dados para Origens deDados OLAP

O IBM Cognos Business Intelligence fornece amostras OLAP.

As amostras estão disponíveis para todos por padrão. Para criar origens de dadoscustomizadas, você deve ter permissões de execução para o recurso seguroConexões de Origens de Dados e permissões de acesso à hierarquia para a funçãosegura Administração. Você deve ter permissões de gravação para o namespaceCognos.

As amostras OLAP sãov Cubos do GO Sales Fact e GO Finance Fact Microsoft Analysis Servicesv Os cubos da Companhia das Aventuras de Amostra que incluem

sales_and_marketing, employee_expenses, go_accessories, go_americas,go_asia_pacific e great_outdoors_sales_en.

v Cubo do DB2 das Aventuras de Amostra

Você deve criar conexões de origens de dados para os cubos para utilizar asamostras. Você deve configurar as amostras de cubo do Microsoft Analysis Servicesou configurar a amostra de cubo do Oracle Essbase, se estiver usando-os, antes decriar conexões de origem de dados.


Criar Conexões de Origem de Dados para PowerCubesUse o procedimento a seguir para criar uma conexão de origem de dados para umPowerCube.

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.

3. Clique no botão de nova origem de dados .Observação: você deve incluir uma conexão de origem de dados para cadacubo.

4. Para criar uma conexão de origem de dados para o cubo Vendas e marketing,digite vendas_e_marketing na caixa Nome e clique em Avançar.

5. Na página de conexão, em Tipo clique em IBM Cognos PowerCube, e cliqueem Próximo.A página da sequência de conexões do banco de dados selecionada aparece.

6. Opcional: na caixa Tamanho do cache de leitura (MB):, digite o tamanho docache de leitura do cubo em megabytes.Se você deixar este campo em branco ou digitar 0, o IBM Cognos Connectionusará o valor padrão no arquivo ppds_cfg.xml na pasta de configuração.

7. Na caixa Localização do Windows, digite o local e o nome do arquivovendas_e_marketing.mdc para a conexão da origem de dados. Por exemplo,digite:c10_location/webcontent/samples/datasources/cubes/PowerCubes/En/Sales_and_Marketing.mdc

É possível definir um caminho do sistema operacional Microsoft Windows ouum caminho do sistema operacional UNIX.Se você definir um caminho do UNIX e planeja usar o Framework Manager,também deverá definir o caminho do Windows e assegurar que o cubo tambémesteja disponível no local do Windows. O Framework Manager pode acessarcubos apenas a partir de locais do Windows.

8. Para testar se os parâmetros estão corretos, faça o seguinte:v Clique em Testar a conexão.v Clique em Teste.v Quando o teste estiver concluído, clique duas vezes em Fechar.


Resultados

Agora é possível importar o pacote de amostras do IBM_Cognos_Powercube.zippara o PowerCube para usar essa origem de dados ou é possível criar seu própriopacote usando o cubo.

Criar Conexões de Origem de Dados para Cubos Oracle EssbaseUse o procedimento a seguir para criar uma conexão de origem de dados para umcubo Oracle Essbase.


Nota: Para conectar a uma origem de dados Oracle Essbase, o software clientedeve ser instalado e configurado no servidor IBM Cognos Business Intelligence eno mesmo local que o IBM Cognos Framework Manager.

Procedimento1. Inicie o IBM Cognos Administration.2. Na guia Configuração, clique em Nova origem de dados.3. Na página de nome e descrição, digite um nome exclusivo para a conexão e, se

desejar, uma descrição e dica de tela, e selecione Avançar.4. Na página de conexão, na lista suspensa Tipo, selecione Oracle Essbase e, em

seguida, clique em Avançar. A página de sequência de conexões aparece.5. Digite o nome do servidor Oracle Essbase.6. Selecione Conexões e, em seguida, clique em Senha e Criar uma conexão que

o grupo Todos possa usar.7. Digite o ID do Usuário, Senha e, em seguida, confirme a senha para o cubo.8. Selecione Testar a Conexão e, em seguida, Testar para testar se os parâmetros

estão corretos. Na coluna Status, é possível ver se a conexão foi bem-sucedida.Se tiver sido mal sucedida, selecione Fechar, retorne às etapas anteriores everifique seus parâmetros de conexão. Se tiver sido bem-sucedida, acesse apróxima etapa.


Resultados

Para utilizar essa origem de dados, crie um pacote utilizando essa fonte noFramework Manager e, em seguida, publique-o.

Criar Conexões de Origem de Dados para Cubos do MicrosoftAnalysis ServiceUse o procedimento a seguir para criar uma conexão de origem de dados para umcubo do Microsoft Analysis Service.

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. Na guia Configuração, clique em Nova origem de dados.3. Na caixa Nome, digite o nome da conexão da origem de dados e clique em

Avançar.v Para o cubo GAInfoFinanças, digite GAInfoFinanças_XX_MSAS2005.v Para o cubo GAInfoVendas, digite GAInfoVendas_XX_MSAS2005.

4. Na página Especificar Conexão do Novo Assistente de Origem de Dados,clique em Microsoft Analysis Services 2005.

5. Clique em Avançar.6. ??Na caixa Nome do servidor, digite o nome do servidor onde se encontram

os bancos de dados restaurados. Barras invertidas não são necessárias.7. Em Signon, assinale as caixas de seleção Senha e Criar um signon que o

grupo Todos pode usar. Digite o ID do usuário e a senha para o banco dedados MSAS2005. Para MSAS2005, essa é uma configuração de login de rede.

8. Clique em Testar a conexão e então clique no botão Testar. Clique em Fechar.9. Clique em Concluir. Você será solicitado a criar um pacote.


Alternativamente, pode-se implantar um pacote existente de um arquivo deimplementação de amostras. Os nomes dos arquivos de implementaçãocorrespondem aos nomes e conexão de origem de dados especificados naetapa 4 e contêm relatórios de amostra que funcionam com os cubosassociados.Em Administração de Conteúdo na guia Configuração no IBM CognosAdministration, clique em Nova Importação. O assistente de nova importaçãosolicitará a seleção de um arquivo de implementação. Quando selecionar oarquivo de implementação, é importante clicar em Editar e especificar umnome de destino para o pacote para evitar que um pacote existente sejasubstituído.

10. Para criar um pacote, selecione Criar um pacote e clique em OK.11. Especifique o nome do pacote e clique em OK.

v Para o cubo GA Info Finanças, digite GAInfoFinanças_XX_MSAS2005.v Para o cubo GA Info vendas, digite GAInfoVendas_XX_MSAS2005.

12. Especifique no banco de dados do Analysis Services se restaurou oGAInfoFinanças_XX ou o GAInfoVendas_XX:v Tanto para o cubo GAInfoFinanças quanto para os cubos GAInfoVendas,

digite DWVENDASGA.v Para o cubo GA Info vendas, digite GA Info vendas.

13. Clique no cubo aplicável ao banco de dados.14. Clique em Concluir.

Configurando a Amostra do Metric StudioPara configurar a amostra do Metric Studio, você deve criar um armazenamentode métricas e um novo pacote de métricas, configurar a origem de importação eimportar os dados e arquivos de métricas para o armazenamento de métricas.1. Crie um armazenamento de métricas denominado GOMETRIC.2. Crie um novo pacote de métricas denominado GO Metrics que usa a origem de

dados denominada go_metrics.Quando solicitado pelo assistente, selecione o calendário gregoriano padrão eaceite os padrões para Anos, Trimestres e Meses. Selecione 1º de janeiro de 2010como a data de início para um período que inclui o ano atual e use um períodode, pelo menos, cinco anos.

3. Defina a origem de importação.4. Importe os dados e arquivos de métricas para o armazenamento de métricas.

Configure a Origem de ImportaçãoPara configurar a amostra do Metric Studio, você deve configurar a origem deimportação.

Procedimento1. Copie todos os arquivos de texto da pasta apropriada para a pasta

c10_location/deployment/cmm:v Para Microsoft SQL Server ou Oracle, copie de c10_location/webcontent/

samples/datasources/metricsdata/GOMetrics_Unicode

v Para DB2, copie de c10_location/webcontent/samples/datasources/metricsdata/GOMetrics_UTF8

v Para todos os bancos de dados, para inglês em vez das amostras Unicodemultilíngues, copie de c10_location/webcontent/samples/datasources/metricsdata/GOMetrics


Nota: Pode ser necessário criar a pasta cmm.2. Em Pastas públicas, clique em Métricas GA.3. No Metric Studio, na lista Ferramentas, clique em Importar origens.

4. Clique no ícone Definir propriedades na coluna Ações ao lado de Origem deImportação Padrão.

5. Em Local de implementação de métricas, clique na pasta cmm. Essa é a localde implementação padrão.

6. Na caixa Formato do Arquivo, clique em 10.1.1.7. Em Codificação de conjunto de caracteres, selecione a codificação apropriada e

clique em OK.v Para Microsoft SQL Server ou Oracle, selecione Unicode (UTF-16)

v Para DB2, selecione Unicode (UTF-8)

v Para o conjunto de dados GO Metrics, selecione Europa Ocidental(Windows-1252) ou deixe o conjunto de dados em branco selecionandoOutros.

8. Se você estiver usando o IBM DB2, aceite a opção padrão para Valor doSeparador Decimal.

Resultados

Agora você já pode utilizar o pacote Métricas GA no Metric Studio.

Importe Dados e Arquivos de Métricas para o Armazenamento deMétricasPara configurar a amostra do Metric Studio, você deve importar os dados earquivos de métricas para o armazenamento de métricas.

Procedimento1. Escolha entre importar os arquivos para o armazenamento de métricas usando

o IBM Cognos Connection ou o Metric Studio:v Para usar o IBM Cognos Connection, em Pastas Públicas ou Minhas Pastas,

abra o pacote Métricas da GA clicando no ícone de conteúdo do pacote demétricas da visualização na coluna Ações. Clique em Manutenção demétrica.

v Para utilizar o Metric Studio, no Metric Studio, na lista Ferramentas, cliqueem Manutenção de métrica.

2. Clique na tarefa de métrica Importar e transferir dados de arquivos para oarmazenamento de métricas.

Dica: Se ocorrer um erro, clique em Limpar logs de dados rejeitados da áreatemporária, Limpar apenas dados de histórico de métrica e Limpar dados dehistórico de métrica e de calendário.

Dica: Também é possível limpar todos os dados do log de auditoria existentesdo armazenamento de dados de métrica clicando em Limpar histórico deauditoria. Para obter informações adicionais, consulte o tópico sobre comolimpar o histórico de auditoria no Guia de administração e segurança.

Resultados

Agora você já pode utilizar o pacote Métricas GA no Metric Studio.


Importar as AmostrasPara 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 os arquivos de implementação diferentes deIBM_Cognos_PowerCube.zip, você deve restaurar os bancos de dados. Também vocêdeve criar conexões de origens de dados para os bancos de dados de amostras .Toda implementação requer uma conexão da origem de dados para executarrelatórios.

Antes de importar o arquivo de implementação IBM_Cognos_PowerCube.zip, vocêdeve criar uma conexão com o banco de dados para o PowerCube apropriado eselecionar o idioma que deseja usar. O idioma selecionado deve ser suportado porseu código do idioma.

Procedimento1. Copie o arquivo zip do diretório c10_location/webcontent/samples/content

para o diretório no qual seus arquivos de implementação são salvos.A localização padrão é c10_location/deployment. A localização é configuradana ferramenta de configuração. Para obter informações sobre como alterar alocalização, consulte a ajuda on-line da ferramenta de configuração.

2. Abra o IBM Cognos Administration conectando-se ao portal do IBM CognosBI e clicando em Administrar Conteúdo do IBM Cognos na página de BoasVindas.

3. Na guia Configuração, clique em Administração de Conteúdo.

Nota: Para acessar esta área no IBM Cognos Administration, você deve ter aspermissões necessárias para o recurso protegido Tarefas de administração.

4. Na barra de ferramentas, clique no botão Nova Importação.O assistente Nova Importação será exibido.

5. Na caixa Arquivo de Implementação, selecione o archive:v IBM_Cognos_Samples

v IBM_Cognos_PowerCube

v IBM_Cognos_Metrics

v IBM_Cognos_DrillThroughSamples

v IBM_Cognos_Audit

v IBM_Cognos_Mobile

v IBM_Cognos_csgodw

v IBM_Cognos_Office

v IBM_Cognos_Prompt_API

v IBM_Cognos_Samples_DQ

v IBM_Cognos_DynamicCube

v IBM_Cognos_PowerPlay

Nota: Os arquivos de implementação IBM_Cognos_Samples_DQ eIBM_Cognos_DynamicCube requerem uma conexão de origem de dados deconsulta dinâmica.

6. Clique em Avançar.


7. Digite um nome exclusivo, uma descrição opcional e uma dica de tela para oarquivo de implementação, seleciona a pasta onde deseja salvá-lo e clique emAvançar.

8. Na caixa Conteúdo de pastas públicas, selecione as pastas que desejaimportar.O arquivo de implementação IBM_Cognos_Samples tem uma pasta únicachamada Amostras com subpastas: Modelos e Modelo de Amostra. A pastaModelos contém os seguintes pacotes ou pastas:v Armazém de Dados da GA (análise), Armazém de Dados da GA

(consulta), Vendas da GA (análise) e Vendas da GA (consulta)

v Pasta do Painel, Objetos do Painel, Amostras do Cognos Workspace,Amostras Interativas

A pasta Cognos Workspace Advanced do pacote Armazém de Dados da GA(análise) contém relatórios usados para dados externos.O arquivo de implementação IBM_Cognos_PowerCube contém pacotes ou pastasnos seguintes idiomas:v Inglês - Vendas e marketing (cubo)v Francês - pacotes localizadosv Alemão - pacotes localizadosv Japonês - pacotes localizadosv Chinês simplificado - pacotes localizadosO arquivo de implementação IBM_Cognos_Metrics contém o pacote Métricasde GA.A implementação IBM_Cognos_Mobile contém a pasta Vendas e Marketing(cubo) em cinco idiomas: inglês, francês, alemão, japonês e chinês. Você deveconfigurar uma conexão de origem de dados para o cubo Vendas e Marketing.Exige-se uma conexão separada para cada idioma.A implantação IBM_Cognos_Office contém:v Armazém de Dados da GA(análise)

v Armazém de Dados da GA (consulta)

v Vendas GA (análise)

v Cubo Vendas e Marketing

O arquivo de implementação IBM_Cognos_DrillThroughSamples contém osseguintes pacotes e pastas:v O pacote Vendas e marketing (cubo) em cinco idiomas: inglês, francês,

alemão, japonês e chinêsv Armazém de Dados da GA(análise)

v Armazém de Dados da GA (consulta)

Para o arquivo de implementação IBM_Cognos_DrillThroughSamples, você deveconfigurar conexões da origem de dados para as origens de dados a seguir:v O cubo Vendas e marketing. Exige-se uma conexão separada para cada

idioma.v a great_outdoors_sales.v a great_outdoors_warehouse.

9. Selecione as opções desejadas, juntamente com a escolha de resolução deconflitos para as opções selecionadas e clique em Avançar.

10. Na página Especificar as opções gerais, selecione se incluirá as permissões deacesso e referências a namespaces externos, e quem será o proprietário dasentradas após importá-las.


11. Clique em Avançar.As informações de resumo aparecem.

12. Revise as informações de resumo e depois clique em Avançar.13. Selecione a ação desejada:

v Para executar uma vez agora ou posteriormente, clique em Salvar eexecutar uma vez. Clique em Concluir, especifique a hora e a data daexecução e clique em Executar. Revise o tempo de execução e depois cliqueem OK.

v Para programar um horário recorrente, clique em Salvar e programar.Clique em Concluir e selecione a frequência e as datas de início eencerramento. Clique em OK.

v Para salvar sem programar nem executar, clique em Somente salvar eclique em Concluir.

14. Quando a importação for enviada, clique em Concluir.

Resultados

Agora é possível utilizar os pacotes de amostras para criar relatórios e análises noReport Studio, Query Studio e Analysis Studio, visualizar extrações no MetricDesigner ou criar agentes no Event Studio. Também é possível executar osrelatórios de amostras disponíveis na guia Pastas Públicas no portal.

Modelos de Banco de Dados de Amostras do FrameworkManager

Os modelos de amostras incluídos com o IBM Cognos Business Intelligencefornecem informações para a empresa fictícia, as Aventuras de Amostra.

As amostras incluemv great_outdoors_sales, que se refere ao banco de dados de amostras VENDASGAv great_outdoors_warehouse, que se refere ao banco de dados de amostras

GOSALESDWv gosales_scriptplayer, que se refere aos bancos de dados de amostras

VENDASGA

É possível utilizar os modelos do banco de dados de amostras em diferentesplataformas. Para obter informações sobre a movimentação de modelos de umaplataforma para outra, consulte o Framework Manager User Guide.

Nota: O Transformer usa alguns dos relatórios do pacote de Armazém de DadosGA (consulta) como dados de origem para vários cubos. Esses relatórios foramelaborados para serem relatórios de lista simples, sem formatação. As informaçõesde descrição dos relatórios indicam se o relatório foi desenvolvido para ser umaorigem de dados no Transformer.

Modelo Vendas GA

Esse modelo contém informações sobre análise de vendas da empresa fictícia, asAventuras de Amostra. Também possui os itens de consulta exigidos pelasamostras do Event Studio. O modelo acessa três esquemas e contém dois pacotes.Um pacote é baseado na visualização dimensional e o outro é baseado navisualização da consulta (relacional).


Modelo Armazém de Dados da GA

Este modelo contém informações sobre finanças, recursos humanos, vendas emarketing da empresa fictícia, as Aventuras de Amostra. O modelo acessa umaorigem de dados relacionais e dimensionais. O modelo contém dois pacotes. Umpacote é baseado na visualização dimensional e o outro é baseado na visualizaçãoda consulta (relacional).

Scriptplayer Vendas GA

Esses arquivos podem ser utilizados para executar logs de ações em sequência.Esse procedimento gera um modelo chamado gosales_scriptplayer e publica umpacote no armazenamento de conteúdo.

Exemplo - Executar a amostra Agentes de devoluções ELMcom base nos dados alterados

É possível alterar os dados do banco de dados VENDASGA se algum usuário doEvent Studio desejar testar o agente de amostra Agente de devolução ELM. Ousuário do Event Studio poderá, então, executar o agente de amostra duas vezes edetectar um novo evento.

Para obter mais informações, consulte o Guia do usuário do Event Studio.

Executar a amostra com base nos dados alterados envolve as seguintes etapas:v O usuário do Event Studio executa o agente de amostra com base nos dados

padrão e, em seguida, solicita a mudança dos dados.v Você simula a ocorrência de alguns eventos iniciais e, em seguida, solicita que o

usuário do Event Studio execute o agente de amostra pela segunda vez.v O usuário do Event Studio executa o agente de amostra com base nos dados

alterados. O usuário do Event Studio o informará quando a execução do agenteestiver finalizada.

v Você simula a passagem de tempo e a resolução de alguns eventos e, emseguida, solicita que o usuário do Event Studio execute o agente de amostra pelaterceira vez.

v O usuário do Event Studio executa o agente de amostra pela última vez. Ousuário do Event Studio o informará quando a execução do agente estiverfinalizada.

v Você modifica os dados para que os Agentes de devoluções ELM não detectemeventos.

Exemplo - Simular a ocorrência de eventos iniciaisExecute parte do script Event_Studio_ELM_Agent_Modify_GOSALES.sql parasimular mudanças de dados.

As mudanças em dados incluem o seguinte:v alterar a data para a data atualv mudança do código de acompanhamento para -1 em quatro registros.

O código -1 indica que o acompanhamento é necessário.

Procedimento1. No SQL Query Analyzer, no menu Arquivo, clique em Abrir.


2. Acesse local_c10/webcontent/samples/datasources/sqlserver e clique duasvezes no arquivo Event_Studio_ELM_Agent_Modify_GOSALES.sql.

3. Na barra de ferramentas, clique em GOSALES na lista de bancos de dados.4. Na janela Consulta, em Part 1, selecione as 16 linhas de código.5. No menu Consulta, clique em Executar.

Resultados

O banco de dados é atualizado com as mudanças.

Exemplo - Simular a passagem do tempo e a resolução dealguns eventosExecute parte do script Event_Studio_ELM_Agent_Modify_GOSALES.sql parasimular mudanças de dados.

Primeiramente, altere os dados para que dois dias tenham se passado desde aúltima execução da amostra Agentes de devoluções ELM . Segundo, para três dasquatro instâncias de evento localizadas na última vez que a amostra Agentes deRetornos ELM foi executada, altere o código de acompanhamento de -1 para +1.Isto indica que apenas uma destas instâncias de evento ainda requeracompanhamento e as outras instâncias foram resolvidas.

Procedimento1. No SQL Query Analyzer, no menu Arquivo, clique em Abrir.2. Acesse local_c10/webcontent/samples/datasources/sqlserver e clique duas

vezes no arquivo Event_Studio_ELM_Agent_Modify_GOSALES.sql.3. Na barra de ferramentas, clique em GOSALES na lista de bancos de dados.4. Na janela Consulta, em Part 2, selecione todas as linhas de código que

aparecem após os comentários.5. No menu Consulta, clique em Executar.

Resultados

O banco de dados é atualizado com as mudanças.

Exemplo - Modificar dados para que o Agente de devolução ELMnão detecte eventosQuando o usuário do Event Studio terminar a execução da amostra Agentes dedevoluções ELM baseada nos dados alterados, ele deve notificá-lo.

Em seguida, o banco de dados VENDASGA pode ser modificado para que oagente não detecte qualquer instância de evento.

Procedimento

Execute os seguintes comandos sql:UPDATE GOSALES.RETURNED_ITEM SET FOLLOW_UP_CODE = 0UPDATE GOSALES.RETURNED_ITEM SET ASSIGNED_TO = 0UPDATE GOSALES.RETURNED_ITEM SET DATE_ADVISED = NULL

Resultados

Os dados serão modificados. O ELM Returns Agent de amostra está pronto paraser usado por outros Pacotes do Event Studio e Reports User.


Remova os Pacotes de Amostras e Relatórios do IBM CognosBI

Depois de usar os relatórios de amostra para aprender sobre o IBM CognosBusiness Intelligence, incluindo o Framework Manager, é possível excluir ospacotes nos quais as amostras são baseadas. Esse procedimento removepermanentemente as amostras do armazenamento de conteúdo.

Procedimento1. Abra o IBM Cognos Connection conectando-se ao portal do IBM Cognos BI e

clicando em IBM Cognos Content na página de Boas-vindas.2. Clique na guia Pastas públicas.3. Assinale a caixa de seleção do pacote de amostras que deseja excluir.4. Clique no botão excluir na barra de ferramentas e clique em OK.



Apêndice E. Soluçã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?


http://www-01.ibm.com/software/analytics/support/finding-answers/kb.html

http://www-01.ibm.com/software/analytics/support/finding-answers/kb.html

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


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 E. Solução de problemas 495

http://www.ibm.com/support/entry/portal/

https://www.ibm.com/blogs/SPNA/entry/the_ibm_support_portal_videos

http://www-947.ibm.com/support/entry/portal/search_results/software/cognos/cognos_business_intelligence?sn=spe&q=cognos%20bi&filter=language:en#q%3Dcognos%20bi%26sortby%3D-dcdate%26filter%3Dlanguage%3Aen%2BDC.Subject%3ASSEP7J%2BDC.Type%3ACT748%26spew%3Dfalse


http://www.ibm.com/support/entry/portal/Forums_communities/Software/Information_Management/Cognos_Business_Intelligence_and_Financial_Performance_Management

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:


http://www.ibm.com/support/fixcentral/

http://www14.software.ibm.com/webapp/set2/sas/f/handbook/offerings.html

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


http://www14.software.ibm.com/webapp/set2/sas/f/handbook/getsupport.html

http://www.ibm.com/software/support/

http://www.ibm.com/planetwide/

http://www.ibm.com/software/support/isa

http://www.ibm.com/software/support/isa

http://www.ibm.com/support/servicerequest

http://www.ibm.com/support/servicerequest

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


http://www-01.ibm.com/software/support/exchangeinfo.html

https://www.ibm.com/developerworks/community/forums/html/category?id=33333333-0000-0000-0000-000000000164

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


http://www-947.ibm.com/systems/support/myfeed/xmlfeeder.wss?feeder.requid=feeder.create_public_feed&feeder.feedtype=RSS&feeder.maxfeed=25&OC=SSEP7J&feeder.subdefkey=swgimgmt&feeder.channel.title=Cognos%20Business%20Intelligence&feeder.channel.descr=The%20latest%20updates%20about%20Cognos%20Business%20Intelligence

http://www-947.ibm.com/systems/support/myfeed/xmlfeeder.wss?feeder.requid=feeder.create_public_feed&feeder.feedtype=RSS&feeder.maxfeed=25&OC=SSEP7J&feeder.subdefkey=swgimgmt&feeder.channel.title=Cognos%20Business%20Intelligence&feeder.channel.descr=The%20latest%20updates%20about%20Cognos%20Business%20Intelligence

http://www.ibm.com/software/support/rss/

http://www.ibm.com/software/support/rss/

http://www.ibm.com/software/support/

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.


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.


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 LinuxVocê executa issetup para instalar o IBM Cognos BI, mas recebe a mensagem deerro a seguir:Error while loading shared libraries: libXm.so.4: cannot open shared object file:No such file or directory.

Procedimento1. Acesse o diretório /usr/lib.2. Crie um link simbólico para outra versão de libXm.so e 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 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 115. Sintomas e Soluções Sugeridas para Iniciar o IBM Cognos BusinessIntelligence

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.

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.


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




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 do JavaSe você recebeu o erro CFG-ERR-0106 porque uma versão de 32 bits do serviçoIBM Cognos Business Intelligence foi instalada em uma versão de 64 bits do Java,você deve renomear JAVA_HOME ou configurá-lo para apontar para uma versãode 32 bits suportada do Java.

Uma versão de 32 bits do serviço IBM Cognos BI deve ser instalada em umaversão de 32 bits compatível do Java. Não é possível configurar uma versão de 32bits do serviço IBM Cognos BI para executar em uma versão de 64 bits do Java.


Antes de Iniciar


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

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




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.


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.


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 116. 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 Conjunto de Códigos 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:


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.


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 101).Conceitos relacionados:“Configure a conectividade do banco de dados para o banco de dados dearmazenamento de conteúdo.” na página 87Se estiver usando um banco de dados diferente do Banco de dados de conteúdo doCognos ou do Microsoft SQL Server como o armazenamento de conteúdo, vocêpode ter que instalar o software do cliente de banco de dados e/ou os drivers JavaDatabase Connectivity (JDBC) em cada computador em que instalar o ContentManager. Fazer isso permite que o Content Manager acesse o banco de dados dearmazenamento 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 do Tomcat nas quais um endereço IP de rede é especificado noURI de dispatcher interno, os serviços do IBM Cognos podem não ser inicializadoscom êxito durante a reinicialização. Isto requer uma reinicialização manual após arestauração da rede.

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 Instalar a Versão mais RecenteAtualizará Automaticamente a Versão Anterior 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.


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


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_win32.xml em um editor

XML.2. Encontre a seção que começa com <param>"${install_path}.3. Adicione o parâmetro DuseCMLargeResultSet àquela seção, no local mostrado

pelo texto em negrito no exemplo a seguir.<param>"-Dcatalina.base=${install_path}/tomcat"</param>

<param>"-Dcatalina.home=${install_path}/tomcat"</param>

<param>"-Djava.io.tmpdir=${temp}"</param>

<param>"-DuseCMLargeResultSet=true"</param>

4. Salve e feche o arquivo.5. Inicie o IBM Cognos Configuration e inicie o serviço.

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.

DPR-ERR-2014 Exibido Erro no Arquivo de Log noComputador com Content Manager

Se o Content Manager estiver instalado em um computador separado e o serviçode gerenciamento de eventos no computador com Content Manager estiverdesativado.

A seguinte mensagem de erro poderá estar 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.


Procedimento1. Inicie o IBM Cognos Configuration no computador com Content Manager.2. Na área de janela Explorer, acesse Ambiente > Serviços do IBM Cognos.3. Defina a propriedade Serviço de gerenciamento de eventos ativado como

False.

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.v Clique com o botão direito do mouse na política Agir como parte do sistema

operacional e selecione Propriedades.v Clique em Incluir Usuário ou Grupo e inclua a conta do usuário que inicia o

serviç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 mais informações, consulte a publicação IBM Cognos Business IntelligenceAdministration and Security Guide.

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.

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.

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 Tomcat, é possível determinar se o problema está relacionadoàs configurações de servidor do HP-UX. É possível que o número máximoesperado de threads ativos simultaneamente por processo foi excedido.


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

1. Peça para o administrador do sistema alterar o parâmetro Kernel da seguinteforma:v max_thread_proc = 512v nkthread = 1024

2. Certifique-se de que as configurações de ulimit sejam ilimitadas.

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.

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.

O Report Studio não IniciaPode não ser possível iniciar o Report Studio se estiver sendo utilizado umsoftware bloqueador de pop-up no computador.

Ao iniciar o Report Studio, ele abre em uma nova janela do navegador. Além disso,uma nova janela do navegador é aberta ao executar um relatório e quando um erroé detectado.

Procedimento

Para corrigir o problema, desative qualquer software bloqueador de pop-up aotrabalhar no Report Studio.

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

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

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>

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

Procedimento1. Para resolver este problema ao instalar em alemão ou francês, use um código

do idioma não UTF-8 e inicie issetup para instalar o IBM Cognos BI.2. Para resolver este problema ao instalar em japonês, altere a configuração de

codificação de X Terminal para Shift-JIS e instale o IBM Cognos BI usando umainstalação não assistida.

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 mais informações, consulte a publicação IBM Cognos BusinessIntelligence Installation and Configuration Guide.

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 com vários inquilinos do software IBM Cognos, talvezvocê não possa iniciar o serviço do IBM Cognos, se as instâncias dos objetos queviolam as regras de consistência do arrendatário forem detectadas no ContentManager.

Sobre Esta Tarefa

As regras de consistência para ocupação variada requerem que cada objeto doarrendatário no armazenamento de conteúdo deva ter o mesmo ID do arrendatárioque seu pai, a não ser 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 do IBM Cognos, não obstante o erro de configuração. Isso apenas serápossível se você configurar a propriedade do Content ManagerignoreInvalidTenantContainmentAtStartup como true.

Após as instâncias de violação de regras de consistência do arrendatário seremresolvidas, essa propriedade deverá ser removida.

Procedimento1. Inicie o IBM Cognos Configuration no computador em que o Content

Manager está instalado.2. Em Acesso a Dados, clique em Content Manager.3. Para Propriedades avançadas, clique no ícone Editar na coluna Valor.4. Clique em Adicionar.5. Na coluna Nome, digite ignoreInvalidTenantContainmentAtStartup.6. Na coluna Valor, digite verdadeiro.7. Clique em OK.8. Inicie o serviço do IBM Cognos no computador em que 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ência noarmazenamento de conteúdo para detectar e resolver os problemasrelacionados ao arrendatário.Para obter informações adicionais, consulte o tópico sobre como criar eexecutar uma verificação de consistência do armazenamento de conteúdo no


capítulo sobre ambientes com vários inquilinos no Guia de Administração eSegurança do IBM Cognos Business Intelligence.

10. Após os problemas relacionados ao arrendatário serem resolvidos, remova apropriedade ignoreInvalidTenantContainmentAtStartup do IBM CognosConfiguration.

11. Reinicie o serviço do IBM Cognos.

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

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 do banco dedados a seguir:v Banco de dados 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.

Tabela 118. 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 119. Tipos de Banco de Dados e Nomes de Script para o Banco de Dados deNotificação


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


Tabela 119. Tipos de Banco de Dados e Nomes de Script para o Banco de Dados deNotificação (continuação)


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 120. Nomes de Script para Limpar Tabelas e Índices para o Banco de Dados deCriação de Log.


DB2 LS_dbClean_db2.sql

LS_dbCleanIndexes_db2.sql

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 121. Nomes de Script para o Banco de Dados de Armazenamento de Métricas


DB2 cmm_uninstall dbalias username password

Especifique o dbalias apenas se um banco dedados com o mesmo nome já estivercatalogado.


Tabela 121. Nomes de Script para o Banco de Dados de Armazenamento deMétricas (continuação)


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.

Tabela 122. Nomes de Script para o Banco de Dados de Tarefas Manuais e de Anotação


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 informações adicionais, 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.

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:

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.

Aviso para o Download do Gateway ISAPIVocê está usando o gateway ISAPI e quando acessar a URL, será solicitado quefaça download do arquivo de gateway ISAPI, cognosisapi.dll.

Este problema pode ocorrer, se o conjunto de aplicativos usado para o gatewayIBM Cognos for configurado para usar a configuração de bit incorreta para seugateway. Por exemplo, se você estiver usando o gateway ISAPI de 32 bits e oconjunto de aplicativos não estiver ativado para aplicativos de 32 bits. Ou, se vocêestiver usando o gateway ISAPI de 64 bits e o conjunto de aplicativos estiverativado para os aplicativos de 32 bits.

Procedimento1. No console do Gerenciador do Internet Information Services (IIS), em

Conexões, expanda o nome do servidor.2. Selecione Conjuntos de Aplicativos.3. Selecione o conjunto de aplicativos usado para IBM Cognos BI.4. Clique em Configurações Avançadas.


5. Altere a configuração para Ativar Aplicativos de 32 bits para o valor correto.Por exemplo, se você estiver usando o gateway de 32 bits, altere o valor paraTrue. Se você estiver usando o gateway de 64 bits, altere o valor para False.False é o padrão.

6. Clique em OK.7. Acesse o gateway ISAPI no navegador da web novamente.

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.

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.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 eSegurança do 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.

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 estiver parado, 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.

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.

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.

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.

Mensagem de Erro CCL-BIT-0006 ao Usar o WebSphereApplication Server em um Sistema Pesadamente Carregado

Em um sistema pesadamente carregado que usa o Websphere Application Server,algumas conexões podem terminar antes que o IBM Cognos Business Intelligenceconclua uma solicitação de processamento.


A mensagem de erro a seguir talvez seja exibida no arquivo c10_location/logscogserver.log:

Falha RSV-SRV-0063 Ocorreu um erro ao executar o comando 'asynchRun_Request'.CCL-BIT-0006 A mensagem HTTP é inesperadamente curta.

Quando a conexão for encerrada antes do processamento da solicitação, asolicitação será perdida e o usuário deverá reenviá-la.

É possível ajudar a reduzir a frequência desse erro aumentando o parâmetro deTempo Limite Persistente para as Cadeias de transporte do contêiner de Web noConsole Administrativo do WebSphere.

Aumente o período em intervalos de 10 a 15 segundos até que o erro não ocorramais ou surja raramente.

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

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 fontes


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


Problemas ao Testar Conexões de Origem de Dados com oIBM Cognos BI Implementado no SAP NetWeaver ApplicationServer 7.1.1 no UNIX

Se tiver implementado o IBM Cognos BI no SAP NetWeaver Application Server7.1.1 em execução em um sistema operacional UNIX, você poderá receber um erroquando testar suas conexões de origem de dados no IBM Cognos Administration.

Para resolver esse problema, você deve atualizar o caminho da biblioteca e todosos caminhos usados para o acesso do cliente de banco de dados em um arquivo deambiente SAP denominado .sapenv_servername.sh, em que servername é o nomede seu servidor.


Procedimento1. Acesse o diretório inicial do usuário administrador do SAP.2. Localize o arquivo denominado .sapenv_servername.sh, em que servername é o

nome de seu servidor.3. Abra o arquivo em um editor de texto.4. Inclua c10_location/bin64 no caminho da biblioteca e em quaisquer locais de

caminho necessários para o acesso do cliente de banco de dados.Por exemplo, se você instalou o IBM Cognos BI no /server1/home/ibm/cognos/c10, seu caminho da biblioteca será semelhante ao seguinte:LIBPATH=/server1/home/ibm/cognos/c10/bin64:/db/oracle/11.1.0.6/lib32:/server1/home/db2user/sqllib/lib32:/usr/lib:/lib:$_DEF_EXE; export LIBPATH

5. Salve o arquivo e reinicie os processos do SAP e do IBM Cognos BI.6. Teste suas conexões do banco de dados novamente no IBM Cognos Connection.

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.

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.

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 Falha na inicialização do armazenamento de métricas. DIS-ERR-3115Falha na execução da tarefa

MDS-RUN-3213 Não é possível localizar o utilitário de carregamentoem massa do banco de dados. Instale aferramenta do banco de dados apropriadapara essa 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 Página não Localizada ao Executar Relatórios Usando oIBM Cognos for Microsoft Office

Em um documento do Microsoft Office configurado para o IBM Cognos forMicrosoft Office, você usa Executar Relatório, mas recebe uma mensagem de erro“A página não pode ser localizada”.

Isto poderá ocorrer se o gateway e o dispatcher do IBM Cognos BI usarem o “hostlocal” como os valores de nome do servidor no servidor IBM Cognos BI.

Procedimento1. Inicie o IBM Cognos Configuration.2. No Explorer, clique em Ambiente.3. Certifique-se de que a parte localhost de todas as propriedades do URI seja

substituída pelo nome do computador.


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.2. No nó do computador local, clique com o botão direito em Websites e selecione

Propriedades.3. Na guia Home Directory, clique em Configuração.4. Na guia Opções de processo, aumente o tempo limite do script CGI.

Falha 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

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.

Traduções Ausentes de Nomes de Objetos em AlgunsCódigos de Idiomas

Após atualizar o IBM Cognos Business Intelligence ou importar um archive, algunsnomes de objetos podem não ser localizados para determinados códigos deidiomas. Por exemplo, Pastas Públicas, Minhas Pastas ou nomes de gruposexibidos em inglês, e não no idioma especificado.

Esse problema pode ocorrer nas situações a seguir:v O Cognos BI foi atualizado para uma versão mais recente, mas uma versão mais

antiga do armazenamento de conteúdo foi configurada como o Content Managerativo.

v Um archive que foi criado com uma versão mais antiga do Cognos BI foiimportado em uma versão mais recente do Cognos BI.

Por exemplo, você poderá encontrar nomes de objetos não traduzidos no idiomacatalão, croata, dinamarquês, grego, kazakh, norueguês, eslovaco, esloveno outailandês, se a instalação do Cognos BI 10.2 for configurada com a versão 10.1 doContent Manager. O suporte para os códigos de idiomas supramencionados foiincluído no Cognos BI versões 10.1.1 e 10.2, portanto, a versão 10.1 do ContentManager não possui essas traduções.

Para incluir as traduções no ambiente do Cognos BI, execute o procedimento aseguir.

Procedimento1. Inicie o IBM Cognos Configuration no computador em que o serviço do

Content Manager ativo está instalado.2. No menu Ações, clique em Editar Configuração Global.3. Confirme se os códigos de idiomas necessários estão listados nas guias Códigos

de Idiomas do Conteúdo e Códigos de Idiomas do Produto. Se os códigos deidiomas estiverem ausentes, inclua-os e salve suas mudanças.

4. Acesse o diretório c10_location/webapps/p2pd/WEB-INF/classes, e confirme seum arquivo de mensagem cmmsgsRL_locale.properties existe para cada códigode idioma necessário. Por exemplo, para esloveno, esse arquivo de mensagem é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 maneira para exibir nomes de objetos emcroata e esloveno:<updateInitialContentNames><locales><locale>hr</locale><locale>sl</locale></locales></updateInitialContentNames>


b. Remova ou comente a linha dos outros códigos de idiomas que não sãoafetados 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.

Resultados

Os nomes de objetos localizados são incluídos durante o processo de inicializaçãodo serviço do IBM Cognos. É possível visualizar os resultados da operação noarquivo cogserver.log. O arquivo updateInitialContentNames.xml é excluído noprocesso para evitar atualizações desnecessárias em cada reinício.



Avisos

Estas informações foram desenvolvidas para produtos e serviços oferecidos nomundo inteiro.

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

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


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

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 em “ Copyright and trademark information ” em www.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.

v Intel, o logotipo Intel, Intel Inside, o logotipo Intel Inside, Intel Centrino, ologotipo Intel Centrino, Celeron, Intel Xeon, Intel SpeedStep, Itanium e Pentiumsão marcas ou marcas registradas da Intel Corporation ou suas subsidiárias nosEstados Unidos e em outros países.

v Linux é marca registrada da Linus Torvalds nos Estados Unidos e/ou em outrospaí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.

Avisos 547

http://www.ibm.com/legal/copytrade.shtml


Índice Remissivo

Numéricos64 bits

servidor de relatório 99, 167

AA Companhia de Aventuras de Amostra 13A mensagem HTTP é inesperadamente curta 534acesso anônimo

ativando para dados do relatório do PowerPlay no IBMCognos BI for Microsoft Office 231

administraçãométricas do Metric Studio 124, 175

agregaçãoamostras e dimensões de tempo 459

AIXerro ao se conectar ao banco de dados DB2 512suporte para namespace RACF 386variáveis de ambiente para instalar o IBM Cognos BI 82,

134, 155, 177ajuste

Armazenamento de conteúdo do DB2 417configurações do Apache Tomcat em instalações de 64

bits 418Algoritmo de confidencialidade 244alias da web

recurso alterado na versão 10.1.0 6aliases

configurando em servidores da Web 104, 184aliases web

IBM Cognos BI 104, 184alimentações RSS

resolução de problemas 498alteração

codificação para e-mail 298definições de configuração padrão 238modelo de configuração 418URIs 241versões Java 235

ambientes suportados 42amostras 13, 457

A Companhia de Aventuras de Amostra 458armazém de dados da GA 460banco de dados, modelos e pacotes 460banco de dados transacional de vendas da GA 461conexões de origens de dados 475configurando 464cubo do MSAS 478cubos 462cubos Essbase 480dados de vendas e marketing 459Event Studio 489excluindo 491funcionários 459IBM Cognos Workspace 317importação 486Metric Designer 464Metric Studio 484modelos 488origens de dados OLAP 481

amostras (continuação)pacotes 462restaurando arquivos de backup usando scripts para

db2 468restaurando arquivos de backup usando scripts para

oracle 472restaurando bancos de dados de amostras 465Serviços de Cubo do InfoSphere Warehouse 478TM1 479

amostras do IBM Cognos 8 464amostras do IBM Cognos BI 13análise dimensional 38Apache Tomcat

ajuste para instalações de 64 bits 418aparecem barras invertidas ao invés da moeda 229aplicativo de área de trabalho 7ARBORPATH

variáveis de ambiente 97, 163archive Web

implantação do IBM Cognos BI 427archives corporativos

implantação do IBM Cognos BI 427áreas de trabalho 15

estilos de relatórios 317armazenamento de conteúdo

atualização 511configurações inválidas 507criando 79, 268criando áreas de tabela 89, 141criando no Oracle 52descrição do componente 15diversas versões do IBM Cognos BI 67e outros locais para armazenar saída de relatório 255excluindo tabelas do banco de dados 523fazendo backup 236, 395gerenciamento de conexão 100, 146requisitos para alterar o servidor de aplicativos 394versões compatíveis do DB2 e de Java 506

Armazenamento de conteúdo do DB2 417erro ao executar o script C8DB2.sh 532script 88, 140

armazenamento de conteúdo do Informix Dynamic Servernovo recurso na versão 10.1.0 8

armazenamento de métricaconfigurando variáveis de ambiente no UNIX 56criando 119, 168DB2 119, 169descrição do componente 15melhorando o desempenho 419Microsoft SQL Server 120, 169Oracle 121, 122, 170, 171requisitos do cliente de banco de dados 207

armazenamento de objeto externopara saída de relatório 258testando conexão 259

armazenamentos de métricasfalha 539

arquivamento de conteúdonova descrição do recurso versão 10.1.1 4

arquivandoConteúdo do IBM Cognos 337


arquivando (continuação)saída de relatório 256

arquivo .atsusando para remover componentes 436

arquivo apache_modconfigurando para gateways 203

arquivo cogroot.link 529arquivo cogstartup.lock 501arquivo cogstartup.xml 422, 426

alterando propriedades manualmente 424arquivo inválido 531

arquivo cogstartup.xml inválido 531arquivo de especificação de transferência

usando para remover componentes 436arquivo de especificação de transferência (.ats)

configuração 431arquivo de instalação

fazendo o download de modeladores do Transformer 224arquivo de instalação do Transformer 224arquivo JAR

erro ao fazer configuração 531arquivo p2pd.war para WebLogic 520arquivo response.ats 431, 432arquivos

não localizada 515arquivos .otl 480arquivos chase_referral 358arquivos de biblioteca

para instalação de 32 bits versus 64 bits 49arquivos de configuração

applications.xml para Portal Services 322coglocale.xml 424cogstartup.xml 422exportação 435

arquivos de implementaçãoem movimento 74importando 75

arquivos de log 500configuração de inicialização 500configuração do código do idioma 501desinstalação 502erros do gateway 501modo silencioso 502resumo de transferência 500tempo de execução 501transferência 500

arquivos do provedor de segurançacopiando na JVM do servidor de aplicativos 237

arquivos EAR,Veja archives corporativos

arquivos WAR,Veja archive Web

ASCIIrequisitos para diretório de instalação 514

assinandomodelos de resolução de problemas 498

Assistente para Construção de Aplicativo 402atalhos de teclado 441ativação

IBM Cognos Application Firewall 247serviços 250SSL para um servidor de aplicativos 410

atributo de contexto não pode ser desserializado 520atualização 63

ambiente java 45, 237armazenamento de conteúdo 71, 511comparando relatórios de versões diferentes 77

atualização (continuação)de outros produtos IBM Cognos para o IBM Cognos BI 32especificações do relatório 76ferramentas que suportam atualização do IBM Cognos

ReportNet 38IBM Cognos BI em um servidor de aplicativos 412movendo conteúdo 70processo 63recursos 65tarefas 67traduções ausentes de nomes de objetos 542visualizando conteúdo de uma versão anterior 67

atualizadorinstalando 85, 137, 158, 181

auditorialogs 280

autenticaçãoárvores de domínio para Active Directory Server 358CA SiteMinder 383conexão única usando LDAP 382conexão única usando o Active Directory Server 359conexão única usando o namespace do IBM Cognos Series

7 365conexão única usando RACF 387conexão única usando SAP 390configurando namespace do IBM Cognos Series 7 363desativando logon anônimo 353excluindo namespaces 391função SaferAPIGetTrustedSignon 365LDAP 369, 370LDAP usando Active Directory Server 371LDAP usando IBM Directory Server 374LDAP usando Novell Directory Server 376LDAP usando Oracle Directory Server 378plug-ins de conexão confiável para IBM Cognos Series

7 365propriedades customizadas para Active Directory

Server 356propriedades de usuário customizadas para LDAP 380provedor Siteminder 385provedores de autenticação customizada 367, 368requisitos para conexão única com Microsoft Analysis

Server ou Microsoft SQL Server 355SAP 388Servidor Active Directory 354SSL usando LDAP 381usando namespaces 351

autenticação do Kerberos 360ativando a conexão única 328criando uma origem de dados 331delegação restrita 361namespace do Active Directory Server 330

autenticação do Windows 359autenticação segura

Google OneBox para Enterprise 445autoridade de certificação

configurando 270configurando o serviço 270

Aventuras de Amostra,Veja amostras do IBM Cognos 8

Bbalanceamento de carga 55

ativando e desativando serviços 250configuração 20configurando definições do servidor de correio 152


Banco de dados de conteúdo do Cognosalterando usuários e senhas 239descrição do componente 13melhorando o desempenho 419

banco de dados de criação de logcriando usando DB2 49criando usando Microsoft SQL Server 53criando usando o banco de dados Informix Dynamic

Server 53criando usando Oracle 52criando usando Sybase 54diretrizes de criação 281espaços de tabela para DB2 no z/OS 282

banco de dados de logexcluindo tabelas 523

banco de dados de notificaçãoconfigurações para DB2 no z/OS 266configurando 267criando 265criando áreas de tabela 89, 141espaços de tabela do DB2 para z/OS 267excluindo tabelas 523

banco de dados de tarefa manual e de anotaçõesespaços de tabela no DB2 no z/OS 309

bancos de dadosamostras do IBM Cognos 8 464armazenamento de conteúdo 268armazenamento de métrica 119, 168cliente do banco de dados de criação de log 283criação de log 286excluindo tabelas 523notificação 152retornando ao estado original no Event Studio 490utilitário de carregamento em massa ausente 539

bancos de dados de consulta 16bloqueio de pop-up 518Business Viewpoint Studio 38

CCA,

Veja autoridade de certificaçãoCA SiteMinder 383

configurando namespaces 385verificação de script cruzado no IBM Cognos Application

Firewall 247caminhos

configuração para cookies 299caractere de iene 229caractere de won 229caractere Won

requisitos de fonte 228caractere Yen

requisitos de fonte 228caracteres acentuados

não exibidos apropriadamente 521caracteres coreanos

corrompidos durante a instalação no Linux 519caracteres de byte duplo

exibidos de forma inadequada 521caracteres especiais

nas propriedades do namespace LDAP 369caracteres exibidos incorretamente 521caracteres incompatíveis 507caracteres japoneses

corrompidos durante a instalação no Linux 519

card.xmlmigração 303

catálogos e relatórios Impromptumigração para o IBM Cognos BI 34

CCL-BIT-OOO6mensagem de erro 534

certificados CA 269Certificados de 1024 bits 269Certificados SHA1 269characters

codificação não suportada 507chave simétrica comum 242chaves criptográficas

fazendo backup e excluindo 236, 395gerando novamente 528

Chinêscaracteres corrompidos durante a instalação no Linux 519

Chinês simplificadoconfigurando fontes 251, 254

cintilação 542cintilação de tela 542cliente de banco de dados

configurando para um banco de dados de criação delog 283

requisitos para modeladores do Transformer 224requisitos para o armazenamento de métricas 207requisitos para Transformer 29

CM-SYS-5001 Ocorreu um erro interno no ContentManager 533

codificação de e-mail em tailandêsrequisitos do JRE 298

código do idioma do usuáriomapeando para o código do idioma do conteúdo 295

códigos de idioma do produtoexibindo códigos do idioma suportados 293mapeando para a interface com o usuário 297

códigos de página para origens de dados 117, 200, 209, 219códigos do idioma

exibindo códigos de idioma do produto suportados 293exibindo códigos do idioma de conteúdo suportados 294traduções ausentes de nomes de objetos 542

códigos do idioma do conteúdocustomização 294exibindo códigos do idioma suportados 294mapeando para o código do idioma do usuário 295

códigos do produtonos arquivos de especificação de transferência 436

Coexistência 67cogconfig.sh

opções da linha de comandos 455Cognos BI,

Veja IBM Cognos BICognos Framework Manager

instalando 199Cognos Viewer

descrição do componente 11Cognos Workspace domínios aprovados 247colaboração

usando o IBM Connections 247, 347, 398, 400colaboração usando o IBM Cognos Workspace

nova descrição do recurso na 10.1.0 5comando uninst 436comando uninstnx 436Companhia de Aventuras de Amostra 458

amostras 457bancos de dados, modelos e pacotes 460

componentes 10

Índice Remissivo 551

componentes (continuação)amostras do IBM Cognos BI 13armazenamento de conteúdo 15armazenamento de métrica 15Banco de dados de conteúdo do Cognos 13Cognos Viewer 11componentes de camadas de aplicativos 20, 21Composite Information Server 13Content Manager 13, 20, 80distribuindo Metrics Designer 30Event Studio 12Framework Manager 14gateways 11, 19, 80IBM Cognos Administration 11IBM Cognos BI para Microsoft Office 12IBM Cognos Configuration 11IBM Cognos Connection 11IBM Cognos Workspace 12instalando 80instalando em um computador 18Map Manager 14Metric Designer 14Metric Studio 12opcionais 13origens de dados 16outro 10provedor do Cognos OneBox 448Query Studio 12Report Studio 12requisitos de instalação para sistemas de 64 bits 23servidor de relatório 80Transformer 14

Componentes da camada de aplicativosinstalando 80servidor de log 280

componentes de camadas de aplicativosinstalando no computador separado 20requisitos de configuração 21

Componentes de modelagem 14arquivo de instalação para modeladores do

Transformer 224opções de instalação 25

componentes do servidor 11opções de instalação 23sequência de instalação 129

Composite Information Serverdescrição do componente 13

comunicação LDAP segura 381conectividade do banco de dados

armazenamento de conteúdo 123, 174banco de dados de consulta 93, 160banco de dados de relatório 93, 160

conexão únicanamespace do Active Directory 359namespace RACF 387namespace SAP 390utilizando Autenticação do Kerberos 328

conexõesorigem de dados 475origens de dados OLAP 481

conexões de origens de dadosconfiguração 100, 146

conexões do banco de dados 146conexões ODBC para origens de dados 95, 162confiança compartilhada

configurando entre o IBM Cognos BI e outrosservidores 278

configuraçãoalterando configurações padrão 238alterando o modelo 418arquivo de bloqueio 501automatizando 431configurações do Tomcat 46configurações globais 292configurações não aplicadas 532configurações padrão 238configurações para IBM Cognos BI 46, 238Content Manager 20dados bloqueados 530diversas versões do IBM Cognos BI 67erro ao criptografar informações 526executando a partir da linha de comandos 426fazendo backup 236, 395incluindo recursos 422informações de criptografia não podem ser

criptografadas 526não assistida 431, 435não é possível abrir o IBM Cognos Configuration 501não é possível salvar 530problemas 523requisitos para conexão única com Microsoft Analysis

Server ou Microsoft SQL Server 355requisitos para Metrics Designer 30teste 116

configuração de clientebancos de dados do DB2 87, 139

Configuração do fornecedor de autenticação RACFrecurso alterado na versão 10.1.0 7

configuração não assistidaalterando propriedades 424configurando 431

configuração silenciosa 431configurações de aplicativos de diversos arrendatários

ativando configurações multitenancy 262desativando configurações de diversas ocupações 263visão geral 259

configurações de aplicativos de ocupação variadaidentificando informações de arrendatário 260

configurações de aplicativos multitenancynova descrição do recurso versão 10.2 2

configurações inválidasarmazenamento de conteúdo 507IBM Cognos Configuration 507

configurando 455amostras 464apache_mod para o gateway 203arquivo de especificação de transferência (.ats) 431bancos de dados de notificação 267compartilhamento de índice 304componentes do Cognos OneBox 445confiança compartilhada com outros servidores 278contas de servidor de correio 103Content Manager em espera 150destino para mensagens de log 280fontes 251Framework Manager 27Framework Manager em um computador diferente 202fuso horário padrão 298gateways 183gráficos de mapa para o Report Studio 257IBM Cognos BI 55IBM Cognos BI para Microsoft Office 230IBM Cognos BI para servidores de aplicativos 400


configurando (continuação)IBM Cognos BI para trabalhar com outros produtos IBM

Cognos 318IBM Cognos Workspace 306ISAPI para o gateway 203local de arquivos temporários 249namespace do Active Directory 355namespace LDAP 370namespace LDAP para Active Directory Server 371namespace LDAP para IBM Directory Server 374namespace RACF 386namespace SAP 389não assistida 435Navegadores da Web 58Portal Services 321procura de índice 302propriedades do ambiente para componentes da camada

do aplicativo 165propriedades do servidor de aplicativo 405propriedades em uma configuração não assistida 424protocolo SSL 276provedor do Cognos OneBox 448provedor SiteMinder 385provedores de autenticação customizada 368roteadores 317serviço de autoridade de certificação 270serviço do IBM Cognos 418servidor de correio 152Servidor web 104, 184servlets para o gateway 203Transformer 28, 218

conjuntos de códigosconfigurando uma prioridade para conexões SSL 279

construçõesexecutando no IBM Cognos Connection usando serviço

Movimentação de Dados 37conta do usuário

requisitos para execução do serviço do IBM Cognos 97,145, 164, 182

contas de servidor de correioconfigurando 103

Content Manageralterando fusos horários 298ativo e em espera 133componente 20configuração 20configurando em diversos computadores 150configurando um armazenamento de conteúdo 268descrição do componente 13espera 20falha ao iniciar 512instalando 80Mensagens de erro. 533opções de instalação 20proteção contra failover 20requisitos em caso de uso do IBM Cognos Transformer com

namespace Series 7 80, 213, 363requisitos para alterar o servidor de aplicativos 394salvando saída de relatório externamente 258servidor de log 280tentar registrar o dispatcher 512

Content Manager 8desligando o arquivamento de especificação de

relatório 344Content Manager ativo 133Content Manager em espera 20, 133

configurando 150

Cookiesativando em navegadores da Web 58configurações 299customização 299

cookies HTML,Veja Cookies

correções de partesservidores de aplicativos 394

credenciais do usuárioalterando na configuração não assistida 424

criação de logbanco de dados 286cliente de banco de dados 283configurando 286servidores remotos de log 285usando arquivos 286

criandoarmazenamento de conteúdo 79armazenamento de métrica 119, 168

criptografiaalterando definições na configuração não assistida 424erros de configuração 526

criptografia de propriedades de arquivo temporário 249Cubing Services

conectividade da origem de dados 93, 160cubos

não é possível abrir 514

Ddados

amostras do IBM Cognos 8 464bloqueados pelo IBM Cognos Configuration 530

Data Managerusando no IBM Cognos BI 37

DB2armazenamento de métrica 119, 169conectividade do banco de dados 93, 160configuração de cliente 87, 139drivers de banco de dados 87, 139especificando como um repositório de mensagem de

log 286páginas de códigos 117, 200, 209, 219versões de Java suportadas 506

DB2-ERR-0005 537DecisionStream

requisitos para atualizar catálogos para o IBM CognosBI 33

DecisionStream para IBM Cognos BIconsideração de atualização 33

deleteTask 344Derby

tamanho do cache da página 419desempenho

melhorando para Apache Tomcat em 64 bits 418desinstalação

Framework Manager 440IBM Cognos BI 439, 440Metric Designer 440Transformer 440

desinstalação autônoma 436desinstalação no modo silencioso 436destinos de log

tipos de 280determinação de problema

trocando informações com o suporte IBM 497


diagnósticosVeja resolução de problemas

diretório de instalaçãoproblemas depois de renomear ou mover 529

diretório-raizpara salvar saída de relatório fora do IBM Cognos BI 255

diretórios JDBCconfigurando bancos de dados Oracle 284

diretórios virtuaisIBM Cognos BI 104, 184

dispatcherremovendo o registro 411

dispatchersComputador Componentes da camada de aplicativos 540excluindo 72importando 75métricas do sistema 413

displayLognova descrição do recurso para versão 10.2 3

dispositivos remotosusando para acessar relatórios 37

distribuição de relatórioem uma rede 420

documentaçãoSoftware Development Kit 6

domíniosaprovados para o Cognos Workspace 247árvores de domínio do Active Directory Server 358configuração para cookies 299

drivers de banco de dadosDB2 87, 139Informix 93, 145, 285Oracle 92, 144Sybase 93, 145

Ee-mail

configurando contas de servidor de correio 103e-mails

alterando a codificação 298efetuando login

configurando segurança 99, 153ocultando namespaces durante 368

entregadiminuindo o tempo para abrir relatórios 420

erro CAM-CRP-1157 506erro CM-SYS-5007 512erro de contexto 520erro de criptografia 531

arquivo cogstartup.xml inválido 531erro do JRE 531

erro de diretório não encontrado 515erro de domínio de confiança

ao salvar a configuração 528erro de Java ao iniciar a configuração 531erro DPR-CMI-4006 512erro DPR-DPR-1035 506Erro HTTP 404 515erro página não localizada

iniciando o IBM Cognos BI no Windows 2003 515erros

ESSBASEPATH 536erros de limite de tempo CGI 540espaços de tabela

DB2 no z/OS 282, 309scripts de armazenamento de conteúdo 89, 141

especificações do relatórioatualização 76desligando o arquivamento 344

Essbaseamostra de cubo 480

ESSBASEPATHincluindo 536variáveis de ambiente 97, 163

estilos de análiseem áreas de trabalho 317

estilos de consultaem áreas de trabalho 317

estilos de relatóriosem áreas de trabalho 317

Event Studioamostras 489descrição do componente 12retornando bancos de dados ao estado original 490

excluindoamostras do IBM Cognos 8 491dispatchers 72

exemploconfiguração do Google OneBox 449retornando gráficos no Google OneBox 449retornando métricas no Google OneBox 449retornando relatórios e gráficos no Google OneBox 449retornando relatórios no Google OneBox 449

exportaçãoarquivos de configuração 435

Ffalha no download de recurso 511fazendo backup

informações do IBM Cognos BI 236, 395fazendo upgrade de um banco de dados de criação de log no

IBM DB2 no z/OS 73FileNet

desligando o arquivamento de especificação derelatório 344

importando classes customizadas 340Firefox

configurações de navegador 58firewalls

acesso entre o Framework Manager e o IBM CognosBI 203

acesso o entre o Transformer e o IBM Cognos BI 218considerações de instalação 25

fix packinstalando 85, 137, 158, 181

fontesalterando o padrão 254alterando para relatórios PDF 254configurando 251lista de fontes integradas para relatórios PDF 254não localizada ao iniciar o IBM Cognos Configuration no

UNIX 535fontes adicionais

instalando 228fontes integradas 254fontes PDF

mapeando para fontes PDF integradas para impressão derelatório mais rápida 253

formatos de saídarestringindo 343

Framework ManagerVeja também Cognos Framework Manager


Framework Manager (continuação)acessando o IBM Cognos BI fora de um firewall 203configurando 27configurando em um computador diferente 202configurando origens de dados 117, 200descrição do componente 14desinstalação 440erro de criptografia 505instalando 197modelos de amostras 488opções de instalação 27requisitos do sistema 198testando a instalação e a configuração 204

função SaferAPIGetTrustedSignonusando para autenticação 365

fusos horáriosalteração 298

fusos horários do servidoralteração 298

Ggateway

configurando para o Transformer 218problemas de conexão 528usando os gateways de 32 bits 105, 185

gateway CGIServidor Apache 111, 191Servidor IBM HTTP 111, 191

Gateway Cognos de 64 bitsnova descrição do recurso versão 10.2 2nova descrição do recurso versão 10.2.1 1

gateway de servletconfigurando 110, 190

gateway ISAPI 107, 187aviso para o download de dll 528

gatewaysArquivo de log 501aviso para o download do ISAPI dll 528configurações recomendadas para Microsoft IIS 540configurando 183configurando apache_mod 203configurando ISAPI 203configurando para usar um namespace 250configurando um servlet 203descrição do componente 11incluindo em uma rede para diminuir tempos de

entrega 420instalando 80instalando no computador separado 19quando usar ISAPI 540requisitos de configuração 19

gateways de 32 bits 105, 185GB18030 251, 254Google Chrome

configurações de navegador 58Google OneBox

configurando componentes do Cognos OneBox 445exemplos de configuração 449integração com o IBM Cognos BI 443

Google OneBox para Enterpriseautenticação segura 445

Google Search Applianceintegração do Google OneBox para IBM Cognos BI 443

gráficosusando como resultados do Google OneBox 449

gráficos de mapas 257

gruposassociação ausente no Active Directory Server 538

HHP-UX

variáveis de ambiente para instalar o IBM Cognos BI 82,134, 155, 177

IIBM Cognos

amostras 464IBM Cognos Administration

descrição do componente 11IBM Cognos Application Firewall

configurando 247IBM Cognos BI

alterando servidores de aplicativos 393atualizador 85, 137, 158, 181com autenticação do Kerberos 328compartilhando componentes no mesmo computador 22componentes 10configurações padrão 79configurando 55desinstalação 439dispatchers 417efetuando login 99, 153implementando 405instalação do pacote de manutenção 85, 137, 158, 181instalando 80não inicia em um servidor de aplicativos 529o serviço não inicia 506opções de instalação 17requisitos do sistema 42resolução de problemas das instalações 493serviços 417

IBM Cognos BI para Microsoft Officearquivos de modelo 230configurando 230descrição do componente 12SSL 231usando relatórios do PowerPlay 231

IBM Cognos Configurationconfigurações inválidas 507descrição do componente 11erro de fonte não localizada no UNIX 535modo autônomo 435não é possível iniciar 530opções da linha de comandos 455problemas ao abrir 501problemas ao salvar uma configuração 523problemas com a navegação pelo teclado 530

IBM Cognos Connectiondescrição do componente 11não é possível abrir 515

IBM Cognos Content Archivalrepositório externo 337

IBM Cognos Controlleracesso a dados no IBM Cognos BI 36

IBM Cognos DecisionStreamrequisitos para atualizar catálogos para o IBM Cognos

BI 33IBM Cognos Finance

acesso a dados no IBM Cognos BI 36


IBM Cognos for Microsoft Officeerro ao usar Executar Relatórios 539implementando os componentes do cliente 231nível de segurança da macro para Microsoft Office XP 232SSL 232

IBM Cognos Insight 15IBM Cognos Metrics Manager

fazendo atualização para o IBM Cognos BI 33requisitos para atualizar para o IBM Cognos BI 33

IBM Cognos Metrics Manager, instalação 85, 137, 158, 180IBM Cognos Mobile

relatórios remotos 37IBM Cognos NoticeCast

duplicação de funcionalidade no IBM Cognos BI 39IBM Cognos Office Connection,

Veja IBM Cognos for Microsoft OfficeIBM Cognos Planning - Analyst

acesso a dados no IBM Cognos BI 35IBM Cognos Planning - Contributor

acesso a dados no IBM Cognos BI 35ativando agentes e relatórios programados 318migração para o IBM Cognos BI 34

IBM Cognos Portal Servicesvisão geral de migração 39

IBM Cognos PowerPlay Webrequisitos para atualizar relatórios para o IBM Cognos

BI 33IBM Cognos Query

duplicação de funcionalidade no IBM Cognos BI 39IBM Cognos Series 7

ativando a conexão única 365ativando SSL 364migração para o IBM Cognos BI 34plug-ins de conexão confiável 365usando para autenticação 363

IBM Cognos Series 7 PowerCubesrequisitos para conversão de idioma bem-sucedida 36

IBM Cognos Transformerconfigurando origens de dados 117, 219

IBM Cognos Visualizerduplicação de funcionalidade no IBM Cognos BI 39

IBM Cognos Web Servicesvisão geral de migração 39

IBM Cognos Workspace 12amostras 317configurando 306e colaboração 5estilos de relatórios 317requisitos para carregar o Microsoft IIS 308

IBM CognosScriptvisão geral de migração 39

IBM Connections 16, 247, 347, 348, 398, 400configurar colaboração 306usando com o IBM Cognos Workspace para resolver

problemas de negócios 5IBM Content Manager 8

importando classes customizadas 341importar

classes customizadas para IBM Content Manager 8 341IBM DB2

criando sequências de conexões 100, 146IBM DB2 no z/OS, fazendo upgrade de um banco de dados

de criação de log 73IBM Directory Server

com um namespace LDAP 374IBM FileNet Content Manager 337IBM Java Software Development Kit 291

IBM OmniFind Enterprise Editionincluindo função de procura no IBM Cognos BI 305

IBM WebSphere 393idioma

configurando para a interface com o usuário doTransformer 214

customizando para a interface com o usuário 293customizando suporte ao conteúdo do código do

idioma 294imagens

carregando no Report Studio 104, 184validade do conteúdo 104, 184

implantação do IBM Cognos BI 405Implementações do WebSphere Application Server

nova descrição do recurso versão 10.1.1 4implementando

objetos de configuração 75Transformer para modeladores 226

importaçãoamostras 486

importandoarquivos de implementação 75configurações 75

importarclasses customizadas para o FileNet 340

impressão de relatórioscustomizando para servidores de impressão UNIX e

Linux 264Impromptu Web Reports

migração para o IBM Cognos BI 35indisponibilidade da rede

os serviços falham ao iniciar 511informações de criptografia não podem ser

criptografadas 526Informix

criando o armazenamento de conteúdo 53criando um banco de dados de criação de log 53drivers de banco de dados 93, 145, 285especificando como um repositório de mensagem de

log 286inicialização

arquivo de bloqueio de configuração 501DB2 Retorna Erro SQL1224N ao se Conectar do AIX 512falha do script 519falha no download de recurso 511falha sem erro 507não é possível abrir o IBM Cognos Connection 515não é possível fazer o download de cognos.xts 519não é possível iniciar o serviço 506O Report Studio não Inicia 518página não localizada 515problemas 502serviço do IBM Cognos 532

iniciando o serviço do Cognosa partir da linha de comandos 426

inícioo serviço do IBM Cognos a partir do IBM Cognos

Configuration 104instalação

básica para diversos locais 131lista de verificação 79modos 79, 131não assistida 431opções do componente do servidor 23opções para Framework Manager 27opções para o Content Manager 20opções para Transformer 28


instalação (continuação)requisitos para nome de diretório 514testando Metrics Designer 211testando o Framework Manager 204testando o Transformer 222teste 116

instalação de 32 bitsrequisitos para arquivos de biblioteca de 32 bits 49

instalação de 64 bitsrequisitos para os arquivos de biblioteca de 64 bits 49

instalação não assistidaconfigurando 431início 434modificando um arquivo de resposta 433

instalação silenciosa-startupfile path/filename.xml

nova descrição do recurso para a versão 10.2 3arquivo de inicialização 3exibir status na tela 434início 434modificando um arquivo de resposta 433opção para efetuar bypass de mensagens de status 434opção para exibir o status na tela 3

instalações básicasdiversos locais 131

Instalações de 64 Bits 23instalações distribuídas

cenários 17, 31configurando o Framework Manager 202configurando o Transformer 218Metric Designer 30

instalações silenciosas 431instalando

fontes adicionais 228Framework Manager 197IBM Cognos BI 79, 80, 431, 432IBM Cognos BI no Linux 521instalação não assistida 431, 432Metric Designer 204sequência para componentes do servidor 129Supplementary Languages Documentation 227teste 154, 168, 196Transformer 213usando arquivo de especificação de transferência

(.ats) 431, 432usando arquivos de especificação de transferência

(.ats) 432Integrated Facility for Linux (IFL) 23Integrated Windows Authentication

problemas 535interface

customizando suporte ao idioma 293interface com o usuário

configurando o idioma para o Transformer 214customizando suporte ao idioma 293mapeando para o código de idioma do produto 297

Internet Explorerconfigurações de navegador 58

IPv4 301IPv6 301ISAPI

configurando para o gateway 203quando usar para um gateway 540

issetupnão iniciando no Linux 502

JJava

alterando versões 235atualizando ambientes de tempo de execução 45, 237configurando gateway de servlet para servidores da Web

compatíveis com Java 110, 190usa toda a CPU 506versões suportadas para armazenamento de conteúdo do

DB2 506JAVA_HOME

configuração 531java.lang.NoClassDefFoundError 505Java Management Extensions

com logs de usuário 291configurando propriedades JMX para monitoramento

remoto de métricas do sistema 413Java Software Development Kit da IBM 413Java virtual machine

trava ao importar a implementação 533Javascripts

ativando em navegadores da Web 58JDBC

conectividade do banco de dados para armazenamento deconteúdo 123, 174

JobStreamsexecutando no IBM Cognos Connection usando serviço

Movimentação de Dados 37JREs

atualização 45, 237JVM

alteração 235, 236, 395configurações de memória para o Banco de dados de

conteúdo do Cognos 419copiando arquivos do provedor de segurança 237

Llatência

melhorando 420LDAP

Active Direcetory Server 371ativando a conexão única 382ativando SSL 381configurando um namespace 370editando a propriedade de mapeamento de identidade

externa 382IBM Directory Server 374Novell Directory Server 376Oracle Directory Server 378propriedades customizadas 380usando para autenticação 369

libXm.so.4erro ao executar issetup 502

Lifecycle Manager 38, 77renomeado no IBM Cognos BI, versão 10.1.0 6

limite de tempo assíncrono 420Linux

caracteres corrompidos durante a instalação 519caracteres não exibidos apropriadamente 521conexões ODBC com origens de dados 95, 162iniciando e parando o serviço do Cognos 426mensagens de log 286requisitos do sistema 79variáveis de ambiente para IBM Cognos BI 82, 134, 155,

177variáveis de ambiente para o Tranformer 215


Linux no System zerro de script C8DB2.sh 532

Linux on System Zsuporte para namespace RACF 386

listas de incorporação de fontes 254locais

gráficos de mapas 257locais de arquivos

requisitos no Windows Vista 318local da instalação

recurso alterado na versão 10.1.0 6local de arquivos temporários 249

configurando 249local de implementação

para Metric Studio 173localhost

requisito para alterar para nome do host ou endereçoIP 98

Localização de arquivos de implementaçãoconfigurando para Windows Vista 318

Localização de arquivos de mapeamentoconfigurando para Windows Vista 318

Localização dos arquivos de dadosconfigurando para Windows Vista 318

Localização dos arquivos temporáriosconfigurando para Windows Vista 318

log de eventos do Windowsdestino para mensagens de log 286

logon anônimodesativando 353

logsprocessamento de mensagens 280serviço 416

logs de auditoriaVeja também mensagens de logVeja também resolução de problemasdestinos de log 280

logs de eventos 286logs de usuário 291

Mmanutenção

melhorando o desempenho do sistema 413Map Manager

descrição do componente 14memória

requisitos 45Mensagens de erro.

CAM-CRP-1064 510CAM-CRP-1315 A configuração atual aponta para um

domínio de confiança diferente 528CFG-ERR-0106 Cognos Configuration não recebeu

nenhuma resposta 503CM-CFG-029 Content Manager não pode determinar 532CMM-APP-3254 Falha na inicialização do armazenamento

de métricas 539DIS-ERR-3115 Falha na execução da tarefa 539DPR-ERR-2014 514DPR-ERR-2022 Nenhuma resposta gerada 518DPR-ERR-2058 512, 516DPR-ERR-2079 533Erro HTTP 404 515falha da classe de servlet ao carregar no WebLogic 540falha no download do recurso especificado 511informações de criptografia corrompidas 531

Mensagens de erro. (continuação)informações de criptografia não podem ser

criptografadas 526Java Runtime Environment 531MDS-RUN-3213 Não é possível localizar o utilitário de

carregamento em massa do banco de dados 539Não é possível balancear a carga da solicitação 514não foi possível desserializar o atributo de contexto 520página não localizada 515PRS-CSE-1255 510RQP-DEF-0114 522RSV-SRV-0066 522SoapSocketException 512solicitação malformada 521SQL1224N 512tempo limite do CGI 540você escolheu fazer o download de um arquivo 519

mensagens de logVeja também logs de auditoriaVeja também resolução de problemasativação para o IBM Cognos Application Firewall 247destinos de log 280Servidor de log remoto. 280

Metric Designerconfigurando origens de dados 117, 209configurar 208descrição do componente 14desinstalação 440distribuindo componentes 30instalando 204requisitos de configuração 30requisitos do sistema 204testando a instalação e a configuração 211

Metric Studiocriando métricas 124, 175definindo manualmente o local de implementação 173descrição do componente 12

métricaspara servidores, dispatchers e serviços 413usando como resultados do Google OneBox 449

métricas do Metric Studiocriando pacotes 124, 175

métricas do sistemaacesso de fora do IBM Cognos Administration 8métricas do sistema 8monitoramento remoto 413recurso alterado na versão 10.1.0 8

Metrics Manager, instalação 85, 137, 158, 180Microsoft

atualizações de segurança afetam memória 507Microsoft .NET Framework 231Microsoft Analysis Server

requisito de namespace 355Microsoft Analysis Services

conexão única com origens de dados MSAS 359configurando amostras de cubos do MSAS 478configurando o ambiente de origem de dados 117, 200,

209, 219Microsoft Analysis Services (MSAS)

conectividade da origem de dados 93, 160Microsoft Cube 514Microsoft IIS

requisitos para carregar o IBM Cognos Workspace 308Microsoft Office

serviço de dados de relatório 417Microsoft Registry Editor

aumentando soquetes ou portas 537


Microsoft SQL Serverarmazenamento de métrica 120, 169autenticação do Kerberos 328conectividade do banco de dados 93, 160criando sequências de conexões 100, 146especificando como um repositório de mensagem de

log 286requisito de namespace 355

migraçãocard.xml 303Cognos Go! Procura 303de outros produtos IBM Cognos para o IBM Cognos BI 34

modeladoresimplementando Transformer 226

modelosalterando o tamanho do modelo 418amostras do banco de dados 488modelos e pacotes de amostras 460modificando para amostras 486

modelos Architectmigração para o IBM Cognos BI 34

modelos de LDAPnova descrição do recurso versão 10.2 2

modo autônomo 431modo de consulta compatível

memória 45origens de dados de 64 bits 93, 160

modo de consulta dinâmica 93, 160memória 45nova descrição do recurso versão 10.1.0 4

modo silencioso 431Módulos do Apache 106, 185moeda

customizando suporte 293fontes requeridas para o caractere Yen ou Won 228won 229yen 229

moeda coreana 229moeda japonesa 229MSAS,

Veja Microsoft Analysis Servicesmulti_domain_tree 358

Nnamespace

RACF 386Namespace do Cognos

recriando 530namespace RACF 386namespaces

associação ao grupo ausente do Active DirectoryServer 538

autenticação 351autenticação do Kerberos 330configurando para um gateway 250configurando provedores de autenticação

customizada 368excluindo 391não é possível efetuar logon 510ocultando durante o login 368recriando 530requisitos para Content Manager em caso de uso do

Transformer com namespace Series 7 80, 213, 363não é possível abrir o IBM Cognos Configuration 501Navegadores da Web

configurações de segurança 42

Navegadores da Web (continuação)configurando 58erros ao iniciar o portal da Web 516, 518utilizando Autenticação do Kerberos 328

nenhuma resposta gerada 518Netezza

conectividade da origem de dados 93, 160configurando conexões ODBC 95, 162

NIST SP800-131a 269notas sobre a liberação

revisando antes de instalar 41Novell Directory Server

com um namespace LDAP 376

Oopção displayLog 434opção nomsgboxes 434opções da linha de comandos 455opções de inicialização 455opções de instalação

Componentes de modelagem 25opções JVM 394Oracle

armazenamento de métrica 121, 122, 170, 171conectividade do banco de dados 93, 160criando sequências de conexões 100, 146drivers de banco de dados 92, 144drivers JDBC de banco de dados 284erros de implementação 539especificando como um repositório de mensagem de

log 286suporte multilíngue 117, 200, 209, 219

Oracle Directory Servercom um namespace LDAP 378

Oracle Essbaseconfigurando 96, 163falhas na consulta 537Microsoft Windows de 64 bits 97, 163UNIX 97, 163

Oracle ESSBASEconectividade da origem de dados 93, 160

Oracle Java SE Development Kit 291, 413Oracle WebCenter Interaction Portal 8

configurando 321Oracle WebLogic 393origens de dados

conexões de amostras 475conexões ODBC 95, 162configurando ativado para Kerberos 331descrição do componente 16para Framework Manager 117, 200para IBM Cognos Transformer 117, 219para Metrics Designer 117, 209

origens de dados OLAP 514conexões 481membros ausentes ou inacessíveis 538

Origens de dados relacionais .membros ausentes ou inacessíveis 538

Os filtros de régua de controle do Go! Procurarenomeado como procura de índice 6

OutOfMemoryError 512outros componentes 15


Ppacote de serviços

instalando 85, 137, 158, 181pacotes de correção

instalando em computadores com UNIX ou Linux 86, 138,159, 181

instalando em computadores com Windows 86, 138, 158,182

painéisrecurso alterado na versão 10.1.0 7

parâmetro DuseCMLargeResultSet 512parando o serviço do Cognos

a partir da linha de comandos 426pasta do local de implementação compartilhada

para Metric Studio 173períodos de blecaute

especificando 342permissões

desvio 307execução 307para a conta do usuário que é usada para o serviço do IBM

Cognos 97, 145, 164, 182para modeladores do Transformer 224política de configuração 307

pools de aplicativos 104, 184portal

erros ao iniciar 516, 518portal BEA ALUI

Veja Oracle WebCenter Interaction Portalportal do IBM Cognos BI

problema ao conectar ao WebSphere Application Server de64 bits 528

Portal IBM WebSphereconfigurando 321

Portal Services 321especificando o arquivo applications.xml 322

portasalteração 241definições de configuração padrão 46diversas versões do IBM Cognos BI 67

portas em uso 506PowerCubes

acesso no IBM Cognos BI 36conectividade da origem de dados 93, 160não é possível abrir 514requisitos para conversão de idioma bem-sucedida 36

PowerPlayativando acesso anônimo para o IBM Cognos BI for

Microsoft Office 231considerações para atualizar para o IBM Cognos BI 33migrando relatórios da Web PowerPlay para o IBM Cognos

BI 34PowerPlay Web

requisitos para atualizar relatórios para o IBM CognosBI 33

problemas do portalnão é possível abrir 515

processamento de mensagens de log 280procura

configurando procura de índice 302integração do Google OneBox 443

procura de índiceconfigurando 302

produtosversões suportadas 42

propriedade Consulta de usuáriocaracteres especiais para namespace LDAP 369

propriedade de mapeamento de identidade externacaracteres especiais para namespace LDAP 369editando para um namespace LDAP 382

propriedade Senha e DN do usuário de ligaçãocaracteres especiais para namespace LDAP 369

propriedadesalterando na configuração não assistida 424configurando para o servidor de aplicativos 405local de arquivos temporários 249

propriedades customizadas de usuárioLDAP 380Servidor Active Directory 356

propriedades da conta RACFmapeando para o namespace RACF 386

propriedades de URIrequisito para alterar localhost para nome do host ou

endereço IP 98propriedades do ambiente 98proteção contra failover 20protocolo

endereço IP 301protocolo SSL

configurando 276provedor de autenticação

configurando IBM Cognos BI para usar segurança 99, 153provedor do Cognos OneBox 448provedores de autenticação customizada 367público-alvo do documento xiii

Qqualidade de proteção em conexões SSL 279Query Studio

descrição do componente 12

RRACF

ativando a conexão única 387conectividade 386configurações de autenticação para administradores do

IBM Cognos BI 386recriação de namespaces no Cognos 530recursos

incluindo 422novos recursos na versão 10.1.0 4novos recursos na versão 10.1.1 3novos recursos na versão 10.2.0 2novos recursos na versão 10.2.1 1recursos alterados na versão 10.1.0 6

recursos de acessibilidade 441recursos de procura

recurso alterado na versão 10.1.0 6relatórios

alterando a fonte padrão 254customizando suporte ao idioma 294diminuindo o tempo de entrega 420usando como resultados do Google OneBox 449

remoção de componentes de vários servidores 436remoção de registros de dispatchers 411removendo o registro

dispatchers 72Report Studio

carregando imagens 104, 184descrição do componente 12mudança do local dos gráficos de mapa 257


Report Studio (continuação)não inicia 518

reportando necessidadespara usuários do Transformer 29

ReportNetatualização 33requisitos para atualizar para o IBM Cognos BI 33

repositório externoarquivando conteúdo 337

requisitosdiretório de instalação 514

requisitos de softwareversões do produto suportadas 42

requisitos do sistema 42Framework Manager 198Metric Designer 204Transformer 215

resolução de problemas 493assinando o suporte 498bases de conhecimento

procurando soluções de resolução de problemas 495Content Manager falha ao iniciar 512correções

obtendo 496criação de log 280entrando em contato com o Suporte IBM 496identificando problemas 493obtendo correções 496para um usuário específico 291procurando em bases de conhecimento 495trocando informações com o suporte IBM 497

Resource Access Control FacilityConsulte também RACF 386

restaurandobancos de dados de amostras 465

revisão das notas sobre a liberação antes da instalação 41roteadores

configurando 317RSV-SRV-0063

mensagem de erro 534

SSafari 5

configurações de navegador 58saída de relatório

compartilhando com usuários fora do IBM Cognos BI 255reutilizando 256salvando em um sistema de arquivos 255

sAMAccountNameutilizando Autenticação do Kerberos 361

SAPativando a conexão única 390usando para autenticação 388

SAP BWconectividade 389conectividade da origem de dados 93, 160configurações de autorização para administradores do IBM

Cognos BI 389configurações de autorização para usuários do IBM Cognos

BI 388SAP Enterprise Portal

configurando 321SAP NetWeaver 393scorecard do IBM Cognos BI

distribuindo componentes 31

script ativoativando em navegadores da Web 58

script C8DB2.sherro 532

scriptscriando um armazenamento de conteúdo no DB2 88, 140para excluir tabelas de bancos de dados 523para melhorar o desempenho do armazenamento de

métricas 419scripts de armazenamento de conteúdo do DB2

nova descrição do recurso 10.1.1 4scripts de inicialização,

Veja servidores de aplicativosscripts de limpeza do banco de dados 523scripts SQL

para excluir bancos de dados 523Secure Sockets Layer,

Veja protocolo SSLsegurança

ativação 99, 153configurações para navegadores da Web 42problemas com Integrated Windows Authentication 535

senhasalterando na configuração não assistida 424alterando para o Banco de dados de conteúdo do

Cognos 239sequências de conexão de banco de dados

IBM DB2 100, 146Microsoft SQL Server 100, 146Oracle 100, 146

sequências de ordenaçãodistinção entre maiúsculas e minúsculas 507

Series 7 IQD Bridgecomponente do Transformer 14instalando 213

Series 7 PowerCubesrequisitos para conversão de idioma bem-sucedida 36

serviçoatualização de índice 416dado do índice 415gráficos 415procura de índice 416tarefa manual 415

Serviço Content Manager 415serviço de anotação 415serviço de apresentação 417Serviço de apresentação

requisitos 414serviço de atualização do índice 416serviço de consulta 417serviço de dados de relatório 417serviço de dados do índice 415Serviço de deslocamento de dados

usando no IBM Cognos Connection 37serviço de entrega 415serviço de gerenciamento de eventos 415serviço de gráficos 415serviço de integração de dados 415Serviço de metadados 416Serviço de migração 416serviço de monitor 416serviço de procura do índice 416Serviço de Relatório

lista de fontes integradas para relatórios PDF 254requisitos 414

serviço de relatórios em lote 415


Serviço de relatórios em lotelista de fontes integradas para relatórios PDF 254

serviço de tarefa 416serviço de tarefa realizada por usuários 415serviço do agente 415serviço do Cognos

iniciando a partir da linha de comandos 426serviço do IBM Cognos

configurando 418iniciando a partir do IBM Cognos Configuration 104início 532parando a partir da linha de comandos 426requisitos para a conta do usuário que é usada para o

serviço 97, 145, 164, 182servidor não disponível 507

Serviço do Metrics Manager 416serviços

agente 415ajustando para melhorar o desempenho 414anotação 415apresentação 414, 417ativando e desativando 250consulta 417Content Manager 415dados do relatório 417desinstalação 439entrega 415falha ao iniciar após indisponibilidade da rede 511gerenciamento de eventos 415IBM Cognos BI 417iniciando a partir da linha de comandos 426integração de dados 415log 416Metadados 416métricas do sistema 413Metrics Manager 416Migração 416monitor 416não é possível iniciar 506para Metrics Manager 166parando a partir da linha de comandos 426relatório 417Relatório 414relatório em lote 415repositório 417tarefa 416

serviços de relatório 417serviços de repositório 417serviços do Metrics Manager 166Servidor Active Directory

associação ao grupo ausente 538ativando a conexão única 359ativando SSL 357autenticação do Kerberos 330autenticando em diversos domínios 358com um namespace LDAP 371propriedades avançadas 358usando para autenticação 354

Servidor de aplicativo Oracle 393servidor de aplicativos de 64 bits

problema ao conectar ao portal do IBM Cognos BI 528Servidor de Aplicativos de 64 Bits

nova descrição do recurso versão 10.1.1 3Servidor de aplicativos IBM WebSphere

conexão única com RACF 387servidor de correio

configurando 152

servidor de relatórioativar 64 bits 99, 167

servidor IBM Cognos BIfalha ao iniciar 507

servidoresmétricas do sistema 413

servidores baseados em funçãoconsiderações para Transformer 28

servidores da Webativando SSL 280conexão única usando Active Directory e servidor da Web

IIS 359configurando 104, 184configurando tempo de carregamento do Report

Studio 104, 184gateways de servlet 110, 190

servidores da Web Apacheconfigurando alias 104, 184

servidores da Web IISconexão única para relatório do PowerPlay com base em

documentos do IBM Cognos BI for Microsoft Office 231conexão única usando Active Directory 359

servidores da Web Microsoft IISconfigurações de gateway recomendadas 540

servidores de aplicativosalterando do padrão 393atualização para o IBM Cognos BI 412configurando 405falha da classe de servlet ao carregar no WebLogic 540falha do script de inicialização 519gateways de servlet 110, 190local de implementação para Metric Studio 173opções JVM 394problemas ao executar o IBM Cognos BI 529scripts de inicialização 403

servidores remotos de log 285configurando 286

SharePoint Portalconfigurando 321utilizando Autenticação do Kerberos 328

sinalizador seguroconfiguração para cookies 299

sistema de arquivospara salvar cópias da saída de relatório 255

sistema operacional de 64 bitsmemória 45

sistemas operacionaisversões suportadas 42

Software Development Kitdocumentação 6

SolarisJRE 1.5 533variáveis de ambiente para instalar o IBM Cognos BI 82,

134, 155, 177SSL

ativação em servidores da Web 280ativação para um servidor de aplicativos 410configurando confiança compartilhada com outros

servidores 278configurando para IBM Cognos BI for Microsoft

Office 231configurando para o IBM Cognos for Microsoft Office 232namespace LDAP 381qualidade de proteção 279Servidor Active Directory 357usando o namespace do IBM Cognos Series 7 364


Suporte IBMentrando em contato 496enviando e recebendo informações 497

Supplementary Languages Documentationinstalando 227

Sybasecriando o armazenamento de conteúdo 54drivers de banco de dados 93, 145especificando como um repositório de mensagem de

log 286Sybase IQ

configurando conexões ODBC 95, 162syslog

destino para mensagens de log 286

Ttabelas

excluindo de um banco de dados 523tablespaces 417

DB2 para z/OS 267tamanho do cache da página

Derby 419tecla tab

problemas no IBM Cognos Configuration 530teclado

problemas de navegação 530teclas de atalho 441tempo limite do conjunto de conexões padrão

conflitos entre IBM Cognos BI e alguns servidores deaplicativos 398

tempos de arquivamentoespecificando 342

tempos de execução de encadeamentoespecificando 342

Teradataconectividade da origem de dados 93, 160

testeconfiguração 116Framework Manager 204instalação 116instalação do Transformer 222Metric Designer 211

teste da instalação 154, 168, 196tipos MIME

deve ser especificado no Microsoft IIS para carregar o IBMCognos Workspace 308

TM1conectividade da origem de dados 93, 160planejamento de negócios 38

Tomcatdefinições de configuração padrão 46Instalações de 64 Bits 418

Transformeracessando o IBM Cognos BI fora de um firewall 218acesso a dados no IBM Cognos BI 36componente para vinculação a arquivos IQD do Series

7 14configurando 28, 218descrição do componente 14desinstalação 440etapas para testar a instalação 222idioma para a interface com o usuário 214implementando para modeladores 226instalando 213opções de instalação 28requisitos do sistema 215

Transformer (continuação)requisitos para o Content Manager em caso de uso do

namespace Series 7 80, 213, 363variáveis de ambiente no Linux e UNIX 215

UUDB,

Veja DB2único signon 348

ativando acesso a documentos do IBM Cognos BI forMicrosoft Office com base em relatórios doPowerPlay 231

namespace LDAP 382problemas com Integrated Windows Authentication 535usando o namespace do IBM Cognos Series 7 365

UNIXconexões ODBC com origens de dados 95, 162configurando variáveis de ambiente para armazenamento

de métricas 56erro de fonte não localizada 535iniciando e parando o serviço do Cognos 426local de implementação para Metric Studio 173mensagens de log 286requisitos do sistema 79variáveis de ambiente para IBM Cognos BI 82, 134, 155,

177variáveis de ambiente para o Tranformer 215

UNIX AIXsuporte para namespace RACF 386

Upfrontmigrando conteúdo para o IBM Cognos BI 34

Upgrade Managerrecurso alterado na versão 10.1.0 6

URIalteração 241definições de configuração padrão 46

URI de descoberta de colaboraçãoconfigurando 306

URIs do Content Manager 150, 165usuários

alterando para o Banco de dados de conteúdo doCognos 239

UTF-8codificação para e-mails 298

Vvalidade do conteúdo

diretório de imagens 104, 184variáveis de ambiente

configurando em UNIX para armazenamento demétricas 56

configurando para componentes da camada doaplicativo 165

configurando para servidores de aplicativos 397para instalar o IBM Cognos BI no UNIX ou Linux 82, 134,

155, 177para Transformer no Linux e UNIX 215requisitos no Windows Vista 318

verificação de script cruzadoconfigurando no IBM Cognos Application Firewall 247

versão de endereço IP 301versões do produto 85, 137, 158, 181virtualização

ambientes suportados 42


WWeb Distributed Authoring and Versioning

Veja WebDAVWebDAV

configurando para visualizar as imagens 114, 194WebLogic

falha da classe de servlet ao carregar 540falha do script de inicialização 519implementando o arquivo p2pd.war 521não foi possível desserializar o atributo de contexto 520script de inicialização 403servidor de aplicativos 406, 409

WebLogic Application Servero IBM Cognos BI falha 520

WebSphere 393servidor de aplicativos 405

WebSphere Application Serverfalha do script de inicialização 519falha na implementação do IBM Cognos BI 520instalar o Cognos BI 402problema ao conectar ao portal do IBM Cognos BI 528

Windowslocal de implementação para Metric Studio 173requisitos do sistema 79

Windows IISconfigurações de gateway recomendadas 540

Windows Vistarequisitos para os locais de arquivos 318

Won coreanorequisitos de fonte 228

XXQE-DS-0006 537

YYen japonês

requisitos de fonte 228