public.dhe.ibm.compublic.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Implementando o Cognos TM1 em um Único Computador Windows ................37 Implementando

IBM Cognos TM1Versão 10.1.0

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

Informações do Produto

Este documento se aplica ao IBM Cognos TM1 Versão 10.1.0 e pode também ser aplicado às liberaçõessubsequentes. Para procurar novas versões do documento, visite os Centros de Informações do IBM Cognos(http://publib.boulder.ibm.com/infocenter/cogic/v1r0m0/index.jsp).

Capturas de tela dos produtos Microsoft usadas com permissão da Microsoft.

Materiais Licenciados - Propriedade da IBM

© Copyright IBM Corporation 2007, 2012.

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

Índice

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

Capítulo 1. O Que Há de Novo para a Instalação e Configuração do Cognos TM1 . . . . 1Novos recursos na versão 10.1.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Novos Programas de Instalação . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1Diretório de Instalação Padrão no Windows . . . . . . . . . . . . . . . . . . . . . . . . 1Novos Componentes do Cognos . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2Cognos Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2Novos Bancos de Dados de Amostras . . . . . . . . . . . . . . . . . . . . . . . . . . 2Apache Tomcat Incluído com a Instalação . . . . . . . . . . . . . . . . . . . . . . . . 3Suporte para endereços IP IPv6 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3Novo Guia de Instalação e Configuração . . . . . . . . . . . . . . . . . . . . . . . . . 3

Recursos Alterados na Versão 10.1.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . 3Cognos TM1 Admin Server e configuração agora gerenciados no Cognos Configuration . . . . . . . . . 3Conta do Usuário Precisa Ser Configurada para Componentes Cognos TM1 em Execução como Serviços doMicrosoft Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4Cognos TM1 Contributor Renomeado para Cognos TM1 Applications . . . . . . . . . . . . . . . 4Simultaneidade do Parallel Interaction Configurada por Padrão . . . . . . . . . . . . . . . . . 4Software Obrigatório . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5Seleção e Configuração do Idioma . . . . . . . . . . . . . . . . . . . . . . . . . . . 5Configuração de Segurança e Autenticação . . . . . . . . . . . . . . . . . . . . . . . . 5Números de Porta do Cognos TM1 Admin Server . . . . . . . . . . . . . . . . . . . . . . 5Instalação Silenciosa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Capítulo 2. Planejando sua Instalação do Cognos TM1 . . . . . . . . . . . . . . . 7Programas de Instalação Disponíveis . . . . . . . . . . . . . . . . . . . . . . . . . . . 7Componentes Disponíveis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8Requisitos de Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14Valores de Instalação Padrão . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15Visão Geral da Configuração . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

Cognos Configuration e Cognos TM1. . . . . . . . . . . . . . . . . . . . . . . . . . 16Parâmetros de Configuração do Cognos TM1 . . . . . . . . . . . . . . . . . . . . . . . 17

Contas de Usuário para Execução de Serviços do Cognos TM1 no Windows. . . . . . . . . . . . . . 17Confirmando a Instalação Adequada do Microsoft .NET Framework . . . . . . . . . . . . . . . . 18

Ativando o Cognos TM1 Excel Service . . . . . . . . . . . . . . . . . . . . . . . . . 19Definindo o Usuário do ASPNET . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Cognos TM1 Web Requer Componente Microsoft Chart Controls . . . . . . . . . . . . . . . . . 20Instalando o TM1 em Redes sem Domínios . . . . . . . . . . . . . . . . . . . . . . . . . 20

Sintaxe da Máquina Local . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Capítulo 3. Arquitetura . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23Arquitetura do Cognos TM1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Visão Geral do Cognos TM1 Admin Server . . . . . . . . . . . . . . . . . . . . . . . . 24Visão Geral do Cognos TM1 Server . . . . . . . . . . . . . . . . . . . . . . . . . . 25Visão Geral dos Arquivos Cognos TM1 . . . . . . . . . . . . . . . . . . . . . . . . . 26Visão Geral do Diretório de Dados . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Arquitetura do Cognos TM1 Web . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29Acessando diversos Cognos TM1 Servers do Cognos TM1 Web . . . . . . . . . . . . . . . . . 30Limitando o Acesso a um Único Cognos TM1 Server do Cognos TM1 Web . . . . . . . . . . . . . 31

Arquitetura do Cognos TM1 Applications . . . . . . . . . . . . . . . . . . . . . . . . . 31Camada 1 do Cognos TM1 Applications: Web Clients . . . . . . . . . . . . . . . . . . . . 32Camada 2 do Cognos TM1 Applications: Servidores da Web . . . . . . . . . . . . . . . . . . 34Camada 3 do Cognos TM1 Applications: Dados . . . . . . . . . . . . . . . . . . . . . . 34

Capítulo 4. Transporte . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

© Copyright IBM Corp. 2007, 2012 iii

Implementando o Cognos TM1 em um Único Computador Windows . . . . . . . . . . . . . . . . 37Implementando o Cognos TM1 Admin Server e o TM1 Server . . . . . . . . . . . . . . . . . . 38Implementando o Cognos TM1 Web . . . . . . . . . . . . . . . . . . . . . . . . . . . 39Implementando o Cognos TM1 Applications . . . . . . . . . . . . . . . . . . . . . . . . 39

Considerações de Segurança para Cognos TM1 Applications . . . . . . . . . . . . . . . . . . 40Implementando Todos os Componentes Cognos TM1 Applications em um Único Computador . . . . . . 40Implementando os Componentes Cognos TM1 Applications em Computadores Separados . . . . . . . . 42

Implementando Aplicativos Clientes do Cognos TM1 . . . . . . . . . . . . . . . . . . . . . 43Implementando o Cognos TM1 com Cognos Business Intelligence . . . . . . . . . . . . . . . . . 43

Capítulo 5. Fazendo Upgrade . . . . . . . . . . . . . . . . . . . . . . . . . . 47Planejando o Upgrade . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47Parando Serviços do Cognos TM1 antes do Upgrade . . . . . . . . . . . . . . . . . . . . . 48Fazendo Backup dos Dados para uma Versão Anterior do Cognos TM1 . . . . . . . . . . . . . . . 49Desinstalando uma Versão Anterior do IBM Cognos TM1 . . . . . . . . . . . . . . . . . . . . 50Atualizando a Instalação de um Único Computador do Cognos TM1 . . . . . . . . . . . . . . . . 51Atualizando o Cognos TM1 Server no UNIX ou Linux . . . . . . . . . . . . . . . . . . . . . 51Atualizando o Cognos TM1 Server no Windows . . . . . . . . . . . . . . . . . . . . . . . 51Atualizando os Clientes Cognos TM1 Architect e Perspectives . . . . . . . . . . . . . . . . . . 52Atualizando o Cognos TM1 Web . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52Atualizando o Cognos TM1 Contributor para o Cognos TM1 Applications . . . . . . . . . . . . . . 52Restaurando Dados de uma Versão Anterior no Cognos TM1. . . . . . . . . . . . . . . . . . . 55

Capítulo 6. Instalação de Computador Único do Cognos TM1 . . . . . . . . . . . . 57Instalar Software Obrigatório . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57Instalar os Componentes Básicos do Cognos TM1 . . . . . . . . . . . . . . . . . . . . . . 58Usar Cognos Configuration para Iniciar os Componentes do Cognos TM1 . . . . . . . . . . . . . . 59Executar o Cognos TM1 Perspectives . . . . . . . . . . . . . . . . . . . . . . . . . . . 61Executar o Cognos TM1 Architect . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61Executar o Cognos TM1 Web . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61Executar o Cognos TM1 Applications Portal . . . . . . . . . . . . . . . . . . . . . . . . 62Executar o Cognos TM1 Performance Modeler. . . . . . . . . . . . . . . . . . . . . . . . 63Executar Cognos Insight . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63Usar o Cognos TM1 Application Web. . . . . . . . . . . . . . . . . . . . . . . . . . . 64Outros Componentes Cognos TM1 . . . . . . . . . . . . . . . . . . . . . . . . . . . 64Configurando Computadores Clientes para Exportar Dados do Cognos TM1 em Formato PDF . . . . . . . 65

Capítulo 7. Instalação do Cognos TM1 Server . . . . . . . . . . . . . . . . . . . 67Instalando o Cognos TM1 Server no Windows. . . . . . . . . . . . . . . . . . . . . . . . 67

Instalar os Componentes do Cognos TM1 Server no Windows . . . . . . . . . . . . . . . . . 67Usar Cognos Configuration para Iniciar Servidores Cognos TM1 no Windows . . . . . . . . . . . . 68

Instalando o Cognos TM1 Server no UNIX ou Linux . . . . . . . . . . . . . . . . . . . . . 69Instalar os Componentes do Cognos TM1 Server nos Sistemas Operacionais UNIX ou Linux . . . . . . . 70Executando o Cognos TM1 no IBM AIX . . . . . . . . . . . . . . . . . . . . . . . . . 72Nomes de Objetos e Codificação de Caracteres Cognos para TM1 para Cognos TM1 Servers em Sistemas UNIXe Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

Criando um novo Servidor Cognos TM1 Vazio no Cognos Configuration . . . . . . . . . . . . . . . 73Incluindo um Servidor Cognos TM1 Existente no Cognos Configuration . . . . . . . . . . . . . . . 74Especificando o Local do Cognos TM1 Admin Host . . . . . . . . . . . . . . . . . . . . . . 75Especificando diversos Cognos TM1 Admin Hosts . . . . . . . . . . . . . . . . . . . . . . 76

Capítulo 8. Instalação do Cognos TM1 Web . . . . . . . . . . . . . . . . . . . . 77Instalar Software Obrigatório para Cognos TM1 Web . . . . . . . . . . . . . . . . . . . . . 77Configurar IIS 7 para Executar Cognos TM1 Web on Windows Vista, Windows 7 e Windows Server 2008 . . . . 78Instalar e Configurar o Cognos TM1 Web . . . . . . . . . . . . . . . . . . . . . . . . . 78Configurando a Página de Login Usando AdminHostName e TM1ServerName. . . . . . . . . . . . . 80

Capítulo 9. Instalação do Cognos TM1 Applications . . . . . . . . . . . . . . . . 83Instalando o Cognos TM1 Applications com o Apache Tomcat Fornecido . . . . . . . . . . . . . . . 84

Instalando o Cognos TM1 Applications . . . . . . . . . . . . . . . . . . . . . . . . . 84

iv IBM Cognos TM1 Versão 10.1.0: Guia de Instalação e Configuração

Implementando o Cognos TM1 Application Server com o Servidor de Aplicativos da Web Tomcat Fornecido. . 85Configurando a Segurança de Autenticação para o Cognos TM1 Applications . . . . . . . . . . . . 85Configurando o Ambiente do Servidor e do Cliente para o Cognos TM1 Applications . . . . . . . . . 86

Instalar o Cognos TM1 Applications com sua Própria Instalação do Servidor de Aplicativos da Web do ApacheTomcat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88

Instalando o Cognos TM1 Applications . . . . . . . . . . . . . . . . . . . . . . . . . 88Usar o IBM Cognos Configuration para Construir um Arquivo de Aplicativo para um Servidor Tomcat . . . 88Configurando a Segurança de Autenticação para o Cognos TM1 Applications . . . . . . . . . . . . 89Configurando o Ambiente do Servidor e do Cliente para o Cognos TM1 Applications . . . . . . . . . 90

Instalar o Cognos TM1 Applications com sua Própria Instalação do IBM Websphere . . . . . . . . . . . 92Instalando o Cognos TM1 Applications . . . . . . . . . . . . . . . . . . . . . . . . . 92Usando o IBM Cognos Configuration para Construir um Arquivo de Aplicativo para um IBM Websphere. . . 92Implementar o Cognos TM1 Application Server com o WebSphere Application Server . . . . . . . . . 93Configurando a Segurança de Autenticação para o Cognos TM1 Applications . . . . . . . . . . . . 94Configurando o Ambiente do Servidor e do Cliente para o Cognos TM1 Applications . . . . . . . . . 95

Determinando o Link de Inicialização da URL para Cognos TM1 Applications . . . . . . . . . . . . . 97Configurando um Cognos TM1 Server para Trabalhar com o Cognos TM1 Applications . . . . . . . . . . 98

Capítulo 10. Instalação do Cliente Cognos TM1. . . . . . . . . . . . . . . . . . 101Instalando o Cognos TM1 Perspectives . . . . . . . . . . . . . . . . . . . . . . . . . . 101Instalando o Cognos TM1 Architect . . . . . . . . . . . . . . . . . . . . . . . . . . . 103Instalando o Cognos TM1 Performance Modeler. . . . . . . . . . . . . . . . . . . . . . . 104

Instalando o Cognos TM1 Performance Modeler Usando o Programa de Instalação . . . . . . . . . . 105Instalando o Cognos TM1 Performance Modeler do Cognos Applications Portal . . . . . . . . . . . 105Instalando Remotamente o Cognos TM1 Performance Modeler em diversos Computadores . . . . . . . 106

Instalando o Cognos Insight . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108Instalando o Cognos Insight Usando o Programa de Instalação . . . . . . . . . . . . . . . . . 109Instalando o Cognos Insight a Partir do Cognos Applications Portal . . . . . . . . . . . . . . . 109Instalando Remotamente o Cognos Insight em diversos Computadores . . . . . . . . . . . . . . 110

Capítulo 11. Instalação de Bancos de Dados de Amostras do Cognos TM1 . . . . . . 113Usando a Amostra SData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114Usando o banco de dados de Amostra do Planning. . . . . . . . . . . . . . . . . . . . . . 114Usando a Amostra GO_New_Stores . . . . . . . . . . . . . . . . . . . . . . . . . . . 115Configure a Amostra GO Contributor . . . . . . . . . . . . . . . . . . . . . . . . . . 116Configurar a Amostra Companhia das Grandes Aventuras . . . . . . . . . . . . . . . . . . . 116Usando as Amostras do Servidor TM1 com Base no Banco de Dados de Amostra . . . . . . . . . . . 117

Restaurando Arquivos de Backup para IBM DB2 . . . . . . . . . . . . . . . . . . . . . 118Restaurando Arquivos de Backup para Oracle . . . . . . . . . . . . . . . . . . . . . . 120Restaurando Arquivos de Backup para o Microsoft SQL Server . . . . . . . . . . . . . . . . . 123Configurando a Amostra Vendas de Grandes Aventuras . . . . . . . . . . . . . . . . . . . 123

Capítulo 12. Instalando o Cognos TM1 Operations Console . . . . . . . . . . . . 125Usando o Apache Tomcat Fornecido com o Cognos TM1 Operations Console . . . . . . . . . . . . . 126

Incluir Certificados no Keystore do JRE . . . . . . . . . . . . . . . . . . . . . . . . 126Implementar Cognos TM1 Operations Console com a Versão Fornecida do Apache Tomcat . . . . . . . 127Criar um Grupo de Usuários para o Cognos TM1 Operations Console . . . . . . . . . . . . . . 127Editar o Arquivo OpsConfig.xml . . . . . . . . . . . . . . . . . . . . . . . . . . . 128Configurar Microsoft Internet Explorer 8 para o Cognos TM1 Operations Console . . . . . . . . . . 128Iniciar e Efetuar Login no Cognos TM1 Operations Console . . . . . . . . . . . . . . . . . . 129

Usando a Própria Versão do Apache Tomcat Fornecido . . . . . . . . . . . . . . . . . . . . 130Verificar a Variável de Ambiente do Usuário do JRE . . . . . . . . . . . . . . . . . . . . 130Incluir Certificados no Keystore do JRE . . . . . . . . . . . . . . . . . . . . . . . . 130Implementar o Cognos TM1 Operations Console . . . . . . . . . . . . . . . . . . . . . 131Criar um Grupo de Usuários para o Cognos TM1 Operations Console . . . . . . . . . . . . . . 131Editar o Arquivo OpsConfig.xml . . . . . . . . . . . . . . . . . . . . . . . . . . . 132Configurar Microsoft Internet Explorer 8 para o Cognos TM1 Operations Console . . . . . . . . . . 133Iniciar e Efetuar Login no Cognos TM1 Operations Console . . . . . . . . . . . . . . . . . . 133

Usando o Websphere 7.0 e 8.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134Importar Certificados do Websphere. . . . . . . . . . . . . . . . . . . . . . . . . . 134

Índice v

Implementando Cognos TM1 Operations Console no WebSphere . . . . . . . . . . . . . . . . 135Iniciando o Cognos TM1 Operations Console no WebSphere . . . . . . . . . . . . . . . . . 135

Capítulo 13. Instalação das Ferramentas Cognos TM1 . . . . . . . . . . . . . . . 137

Capítulo 14. Instalação de Interoperabilidade do Cognos TM1 e do Cognos BusinessIntelligence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139Instalar a Interoperabilidade do Cognos TM1 BI . . . . . . . . . . . . . . . . . . . . . . . 139Configurar a Interoperabilidade do Cognos TM1 BI para Usar Segurança do IBM Cognos . . . . . . . . . 140Configurar o Cognos BI para o Cognos TM1 Viewer Portlets . . . . . . . . . . . . . . . . . . 140Desinstalar a Interoperabilidade do Cognos TM1 BI . . . . . . . . . . . . . . . . . . . . . 141Ativando Relatório do Cognos BI em Origens de Dados do Cognos TM1 . . . . . . . . . . . . . . 141

Capítulo 15. Instalação do Cognos TM1 Package Connector . . . . . . . . . . . . 143Requisitos do Cognos TM1 Package Connector . . . . . . . . . . . . . . . . . . . . . . . 143Instalando o Cognos TM1 Package Connector . . . . . . . . . . . . . . . . . . . . . . . 143

Instalando o Cognos TM1 Package Connector no Windows 7 ou Vista . . . . . . . . . . . . . . 144Ativando a Conectividade para SAP a Partir do Cognos TM1 . . . . . . . . . . . . . . . . . . 144Configurando o Cognos TM1 Package Connector . . . . . . . . . . . . . . . . . . . . . . 144

Configurando a Variável de Ambiente . . . . . . . . . . . . . . . . . . . . . . . . . 145Configurando o Parâmetro de Configuração do Servidor Cognos TM1 (Opcional) . . . . . . . . . . 145Cognos TM1 Package Connector no Computador Cliente. . . . . . . . . . . . . . . . . . . 146

Executando o TM1 Package Connector . . . . . . . . . . . . . . . . . . . . . . . . . . 146Instalando o Cognos TM1 Package Connector no UNIX . . . . . . . . . . . . . . . . . . . . 146

Capítulo 16. Instalação do Cognos TM1 Workflow. . . . . . . . . . . . . . . . . 147

Capítulo 17. Configuração Avançada . . . . . . . . . . . . . . . . . . . . . . 149Alterando Serviços do Cognos TM1 para Serem Executados sob uma Conta de Usuário Específica no Windows 149Configuração do Idioma do Cognos TM1 . . . . . . . . . . . . . . . . . . . . . . . . . 150

Códigos de Idioma do Cognos TM1 . . . . . . . . . . . . . . . . . . . . . . . . . . 151Configurando o Idioma para o Servidor Cognos TM1 . . . . . . . . . . . . . . . . . . . . 152Configurando o Idioma para Clientes do Cognos TM1 no Windows . . . . . . . . . . . . . . . 152Configurando o Idioma no Internet Explorer para o Cognos TM1 Web . . . . . . . . . . . . . . 153

Alterando Números de Porta Padrão para Cognos TM1 Admin Server . . . . . . . . . . . . . . . 153Configurando o Cognos TM1 para Usar IPv6. . . . . . . . . . . . . . . . . . . . . . . . 154Configurando Computadores Clientes para Exportar Dados do Cognos TM1 em Formato PDF . . . . . . . 155Configuração Avançada do Cognos TM1 Web . . . . . . . . . . . . . . . . . . . . . . . 156

Configurando a Página de Login Usando AdminHostName e TM1ServerName . . . . . . . . . . . 156Configurando o Idioma no Internet Explorer para o Cognos TM1 Web . . . . . . . . . . . . . . 157Exibindo e Inserindo Números com Base em Configurações Regionais . . . . . . . . . . . . . . 157Configurando o Internet Explorer para o Cognos TM1 Web . . . . . . . . . . . . . . . . . . 158Executando o Cognos TM1 Web no Navegador da Web Firefox. . . . . . . . . . . . . . . . . 158Executando a Versão de 64 Bits do Cognos TM1 Web no Windows x64 . . . . . . . . . . . . . . 159Executando o Cognos TM1 Web em um Servidor WAN e Exportando Arquivos Excel e PDF . . . . . . . 160Usando ClearType no Cognos TM1 Web Server para Aprimorar a Exibição e a Renderização de Planilhas daWeb . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161Configurando o Cognos TM1 Web para Executar no Windows Vista . . . . . . . . . . . . . . . 161

Configuração Avançada do Cognos TM1 Applications . . . . . . . . . . . . . . . . . . . . . 162Usando o Cognos TM1 Applications com a Segurança do Cognos Business Intelligence . . . . . . . . 162Implementando o Cognos TM1 Applications no Servidor da Web Cognos BI . . . . . . . . . . . . 165Configurando o Cognos TM1 Applications com o Microsoft IIS. . . . . . . . . . . . . . . . . 167Configurando o Cognos TM1 Applications para Usar Diversos Cognos TM1 Servers . . . . . . . . . 167Fonte para Exportação do Cognos TM1 Applications para PDF . . . . . . . . . . . . . . . . . 168Configurando a Segurança da Função do Cognos TM1 TurboIntegrator no Insight . . . . . . . . . . 168

Capítulo 18. Configuração de Segurança . . . . . . . . . . . . . . . . . . . . 171Segurança da Autenticação . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171

Visão Geral da Autenticação . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171

vi IBM Cognos TM1 Versão 10.1.0: Guia de Instalação e Configuração

utilitário ETLDAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175Login Integrado . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185Autenticação LDAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193Usando a Segurança do Cognos com o Cognos TM1 . . . . . . . . . . . . . . . . . . . . 197

Usando SSL para Segurança de Transmissão de Dados . . . . . . . . . . . . . . . . . . . . 203Visão Geral para Usar SSL para Segurança de Transmissão de Dados. . . . . . . . . . . . . . . 203Certificados Gerados . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204Configurando o Cognos TM1 Admin Server para Usar SSL . . . . . . . . . . . . . . . . . . 205Configurando o Servidor Cognos TM1 para Usar SSL . . . . . . . . . . . . . . . . . . . . 207Configurando os Clientes Cognos TM1 para Usar SSL . . . . . . . . . . . . . . . . . . . . 211Configurando o Cognos TM1 Web para Usar SSL . . . . . . . . . . . . . . . . . . . . . 212Configurando o Cognos TM1 Applications para Usar SSL . . . . . . . . . . . . . . . . . . 213Configurando o Utilitário Cognos TM1 Top para Usar SSL . . . . . . . . . . . . . . . . . . 214Configurando a API TM1 C API para Usar SSL . . . . . . . . . . . . . . . . . . . . . . 215Configurando a API Java do Cognos TM1 para Usar SSL. . . . . . . . . . . . . . . . . . . 215Configurando o Utilitário ETLDAP do Cognos TM1 para Usar SSL . . . . . . . . . . . . . . . 216Usando Certificados Independentes . . . . . . . . . . . . . . . . . . . . . . . . . . 217

Capítulo 19. Manutenção da Instalação do Cognos TM1 10.1 . . . . . . . . . . . . 223Fazendo Backup de Dados para Cognos TM1 10.1 . . . . . . . . . . . . . . . . . . . . . . 223Modificando Componentes Instalados do Cognos TM1 . . . . . . . . . . . . . . . . . . . . 224Desinstalando o Cognos TM1 10.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . 224Desinstalando Cognos TM1 Applications . . . . . . . . . . . . . . . . . . . . . . . . . 225

Fazer Backup de seus Dados do Cognos TM1 Applications . . . . . . . . . . . . . . . . . . 225Exportando Aplicativos do Cognos TM1 10.1 Applications . . . . . . . . . . . . . . . . . . 226Parando Serviços Relacionados no Cognos TM1 10.1 . . . . . . . . . . . . . . . . . . . . 226Desinstalando o Cognos TM1 10.1 Applications . . . . . . . . . . . . . . . . . . . . . . 226Remover Implementação do Cognos TM1 Applications no Apache Tomcat . . . . . . . . . . . . . 227Remover Implementação do Cognos TM1 Applications no WebSphere . . . . . . . . . . . . . . 227Importando Aplicativos da Versão Atual de Volta para a Versão Atual do Cognos TM1 Applications . . . . 228

Apêndice A. Recursos de Acessibilidade . . . . . . . . . . . . . . . . . . . . 229Atalhos de Teclado para o Assistente de Instalação . . . . . . . . . . . . . . . . . . . . . . 229Atalhos de Teclado para o Cognos Configuration . . . . . . . . . . . . . . . . . . . . . . 230

Apêndice B. O Arquivo de Configuração do Servidor Tm1s.cfg . . . . . . . . . . . 231Local do Arquivo Tm1s.cfg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231Arquivo Tm1s.cfg de Amostra . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231Parâmetros no Arquivo Tm1s.cfg . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232

AdminHost . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233AllowReadOnlyChore Reschedule . . . . . . . . . . . . . . . . . . . . . . . . . . 233AllowSeparateNandCRules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233AllRuleCalcStargateOptimization . . . . . . . . . . . . . . . . . . . . . . . . . . . 234AuditLogMaxFileSize. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235AuditLogMaxQueryMemory . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235AuditLogMaxTempFileSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235AuditLogOn. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236AuditLogUpdateInterval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236CalculationThresholdForStorage . . . . . . . . . . . . . . . . . . . . . . . . . . . 236CAMSSLCertificate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237CheckFeedersMaximumCells . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237ClientCAMURI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237ClientPingCAMPassport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238CAMPortalVariableFile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238ClientMessagePortNumber . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238ClientPropertiesSyncInterval . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239ClientVersionMaximum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239ClientVersionMinimum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240ClientVersionPrecision . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240CognosInterfacePath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241

Índice vii

DataBaseDirectory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241DefaultMeasuresDimension. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242DisableMemoryCache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242DisableSandboxing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242DisableWorksheetView . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243Display_Info_DBType_R8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243DistributedPlanningOutputDir . . . . . . . . . . . . . . . . . . . . . . . . . . . 244DownTime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244ExcelWebPublishEnabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245ForceReevaluationOfFeedersForFedCellsOnDataChange . . . . . . . . . . . . . . . . . . . 245GroupsCreationLimit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246IdleConnectionTimeOutSeconds . . . . . . . . . . . . . . . . . . . . . . . . . . . 247IntegratedSecurityMode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247IPAddress . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248IPVersion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249JobQueuing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250JobQueueMaxWaitTime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250JobQueueThreadPoolSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250JobQueueThreadSleepTime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251Language. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251LDAPUseServerAccount. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252LDAPPasswordFile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252LDAPPasswordKeyFile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252LockPagesInMemory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253LoggingDirectory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253LogReleaseLineCount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253MaskUserNameInServerTools . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253MaximumCubeLoadThreads . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254MaximumLoginAttempts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255MaximumMemoryForSubsetUndo . . . . . . . . . . . . . . . . . . . . . . . . . . 255MaximumSynchAttempts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255MaximumTILockObjects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256MaximumUserSandboxSize. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257MaximumViewSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257MaxUndoHoldLineCount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257MessageCompression. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258NetRecvBlockingWaitLimitSeconds . . . . . . . . . . . . . . . . . . . . . . . . . . 258NetRecvMaxClientIOWaitWithinAPIsSeconds. . . . . . . . . . . . . . . . . . . . . . . 258ParallelInteraction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259PasswordMinimumLength . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259PasswordSource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259PerformanceMonitorOn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259PersistentFeeders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260PortNumber . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260PrivilegeGenerationOptimization . . . . . . . . . . . . . . . . . . . . . . . . . . . 260ProgressMessage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261ProportionSpreadToZeroCells . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262RawStoreDirectory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263ReceiveProgressResponseTimeoutSecs . . . . . . . . . . . . . . . . . . . . . . . . . 263RunningInBackground . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264RulesOverwriteCellsOnLoad . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264SAPLoggingEnabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264SAPLogFilePath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265SaveTime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265SecurityPackageName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265ServerCAMURI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266ServerLogging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266ServerName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266ServicePrincipalName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266SkipLoadingAliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267SkipSSLCAMHostCheck . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267

viii IBM Cognos TM1 Versão 10.1.0: Guia de Instalação e Configuração

SpreadingPrecision . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267SpreadingPrecision (Suspensões Consolidadas) . . . . . . . . . . . . . . . . . . . . . . 268SubsetElementBreatherCount . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269StartupChores . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269SyncUnitSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270UserDefinedCalculations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270UseLocalCopiesforPublicDynamicSubsets . . . . . . . . . . . . . . . . . . . . . . . . 270UseSQLFetch UseSQLFetchScroll UseSQLExtendedFetch . . . . . . . . . . . . . . . . . . . 270UseSSL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271UseStargateForRules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271ViewConsolidationOptimization . . . . . . . . . . . . . . . . . . . . . . . . . . . 272ViewConsolidationOptimizationMethod . . . . . . . . . . . . . . . . . . . . . . . . 272

Apêndice C. O Arquivo de Configuração do Cliente Tm1p.ini . . . . . . . . . . . . 275Local do Arquivo Tm1p.ini . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275Parâmetros no Arquivo Tm1p.ini . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275

AdminHost . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276AdminSvrSSLCertAuthority . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276AdminSvrSSLCertID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276AdminSvrSSLCertRevList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276AdminSvrSSLExportKeyID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276AdvancedRulesEditor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276AllowImportCamClients. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276BrowseDisplayReadsRightToLeft . . . . . . . . . . . . . . . . . . . . . . . . . . . 277ClassicSliceMode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277CognosGatewayURI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277ConnectLocalAtStartup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277DataBaseDirectory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277DimensionDownloadMaxSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278DisplayApplications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278DisplayChores . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278DisplayControlCubes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278DisplayCubes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278DisplayDimensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278DisplayExplorerPropertiesWindow . . . . . . . . . . . . . . . . . . . . . . . . . . 278DisplayProcesses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278DisplayReplications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279ExpandRowHeaderWidth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279ExportAdminSvrSSLCert . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279InSpreadsheetBrowser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279IntegratedLogin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279Language. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280LocalServerNetworkProtocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280MainWindowLayoutInfo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280PreviousAdminHosts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281PreviousDataDirectories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281SecurityAssignmentWindowLayoutInfo. . . . . . . . . . . . . . . . . . . . . . . . . 281SentMsgsToServerCountWarning . . . . . . . . . . . . . . . . . . . . . . . . . . . 281ShowAdminHostChangeWarning. . . . . . . . . . . . . . . . . . . . . . . . . . . 281ShowAliasAttributeWarning . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281ShowChoresSchedulingWarning . . . . . . . . . . . . . . . . . . . . . . . . . . . 281ShowCubeReplicationWarning. . . . . . . . . . . . . . . . . . . . . . . . . . . . 282ShowDimDeleteElementWarning . . . . . . . . . . . . . . . . . . . . . . . . . . . 282ShowDimensionAccessWarning . . . . . . . . . . . . . . . . . . . . . . . . . . . 282ShowDynamicSubsetWarning . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282ShowPickOperationWarning . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282ShowProcessUNASCIIWarning . . . . . . . . . . . . . . . . . . . . . . . . . . . 282ShowProcessUNODBCWarning . . . . . . . . . . . . . . . . . . . . . . . . . . . 282SliceNewWorkbook . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283SubsetWindowLayoutInfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283TM1RebuildDefault . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283

Índice ix

Apêndice D. Configurando Instalações e Configurações Não Assistidas . . . . . . . 285Instalações não Assistidas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285

Configurando uma Instalação não Assistida . . . . . . . . . . . . . . . . . . . . . . . 285Configurando uma Configuração Não Assistida . . . . . . . . . . . . . . . . . . . . . . . 286Configurando uma Desinstalação Não Assistida . . . . . . . . . . . . . . . . . . . . . . . 287

Apêndice E. Resolvendo um Problema . . . . . . . . . . . . . . . . . . . . . 289Cognos Information Centers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289Support Portal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290Reunindo Informações . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290Solicitações de Serviço . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290Support Assistant Lite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290Cognos Customer Center . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290Fix Central . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291Ferramentas de Determinação de Problemas . . . . . . . . . . . . . . . . . . . . . . . . 291Fóruns e Comunidades . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291Business Analytics Support Notebook . . . . . . . . . . . . . . . . . . . . . . . . . . 291Feeds RSS de Suporte de Software . . . . . . . . . . . . . . . . . . . . . . . . . . . 291Procurando e Navegando por Produtos Cognos . . . . . . . . . . . . . . . . . . . . . . . 291

Avisos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293

Índice Remissivo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297

x IBM Cognos TM1 Versão 10.1.0: Guia de Instalação e Configuração

Introdução

Este documento descreve como instalar, atualizar e configurar os componentes desoftware IBM® Cognos TM1 nos sistemas operacionais Microsoft Windows e UNIX.

Público-alvo

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

Para utilizar este guia, é preciso estar familiarizado com:v conceitos de instalaçãov problemas de segurançav qualificações de administração básicas do Windows ou UNIXv o ambiente de servidor e a infraestrutura de segurança existentes na organizaçãov requisitos de rede e do sistema Cognos TM1

Localizando Informações

Para localizar a documentação do produto IBM Cognos na web, incluindo toda adocumentação traduzida, acesse um dos Centro de Informações do IBM Cognos(http://publib.boulder.ibm.com/infocenter/cogic/v1r0m0/index.jsp). As Notassobre a Liberação são publicadas diretamente nos Centros de Informações eincluem links nas notas técnicas e APARs mais recentes.

Recursos de Acessibilidade

Recursos de Acessibilidade ajudam os usuários com deficiência física, comomobilidade restrita ou visão limitada, a usarem produtos de tecnologia dainformação. O assistente de instalação possui recursos de acessibilidade. Para obterinformações sobre esses recursos, consulte a seção de acessibilidade destedocumento.

A documentação HTML do IBM Cognos possui recursos de acessibilidade. Osdocumentos PDF são complementares e, como tais, incluem os recursos deacessibilidade não incluídos.

Declarações prospectivas

Esta documentação descreve a funcionalidade atual do produto. Referências a itensque não estão disponíveis no momento poderão ser incluídas. Nenhumaimplicação sobre qualquer disponibilidade futura deve ser inferida. Referênciasdesse tipo não são um compromisso, promessa ou obrigação legal de fornecermateriais, códigos ou funcionalidades. O desenvolvimento, a liberação e asincronização de recursos ou a funcionalidade permanecem a critério exclusivo daIBM.

© Copyright IBM Corp. 2007, 2012 xi


Termo de responsabilidade das amostras

A Companhia das Grandes Aventuras, as Vendas da GA, qualquer variação donome Grandes Aventuras e Amostra de Planejamento descrevem operações denegócios fictícias com dados de amostra usados para desenvolver aplicativos deamostra para a IBM e os clientes IBM. Esses registros fictícios incluem dados deamostra para transações de vendas, distribuição de produtos, finanças e recursoshumanos. Qualquer semelhança com nomes, endereços, números de contato ouvalores de transação reais é mera coincidência. Outros arquivos de amostraspodem conter dados fictícios gerados manualmente ou por máquinas, dados reaiscompilados de fontes acadêmicas ou públicas, ou dados usados com a permissãodo proprietário dos direitos autorais, para o uso como dados de amostra para odesenvolvimento de aplicativos de amostras. Os nomes de produtos citados podemser marcas registradas dos respectivos proprietários. A cópia não autorizada estáproibida.

xii IBM Cognos TM1 Versão 10.1.0: Guia de Instalação e Configuração

Capítulo 1. O Que Há de Novo para a Instalação eConfiguração do Cognos TM1

Esta seção contém uma lista de recursos novos, alterados e removidos para estaliberação.

A seção auxiliará no planejamento de estratégias de implantação de aplicativos eatualizações e de solicitações de treinamento dos usuários.

Para localizar a documentação do produto mais atual, acesse o Centro deInformações do IBM Cognos TM1 10.1.0 (http://publib.boulder.ibm.com/infocenter/ctm1/v10r1m0/index.jsp).

Para revisar uma lista atualizada de ambientes suportados pelos produtos IBMCognos, como sistemas operacionais, correções, navegadores, servidores da Web,servidores de diretório, servidores de banco de dados e servidores de aplicativos,visite Cognos Customer Center (http://www.ibm.com/software/data/support/cognos_crc.html).

Novos recursos na versão 10.1.0Estes são os novos recursos de instalação e etapas de configuração para o IBMCognos TM1 desde a última liberação.

Novos Programas de InstalaçãoEsta liberação inclui uma nova interface com o usuário do assistente de instalaçãoe uma nova coleção de programas de instalação.

O programa do assistente de instalação agora é baseado no programa de instalaçãodo IBM Cognos padrão. Os programas de instalação e a seleção de componenteagora são organizados para enfatizar a arquitetura do IBM Cognos TM1 e ajudarmelhor nas implementações que variam de um único computador atéimplementações em diversos computadores em um ambiente de rede.

Para obter detalhes, consulte os seguintes tópicos:v “Programas de Instalação Disponíveis” na página 7v “Componentes Disponíveis” na página 8

Diretório de Instalação Padrão no WindowsEsta liberação inclui uma nova interface com o usuário do assistente de instalaçãoe uma nova coleção de programas de instalação.

O programa de instalação agora usa o diretório de instalação padrão a seguirquando você instala no Microsoft Windows:

C:\Arquivos de Programas\IBM\cognos\tm1

Por exemplo, o IBM Cognos TM1 Web agora está instalado aqui:

C:\Arquivos de Programas\IBM\cognos\tm1\TM1Web

© Copyright IBM Corp. 2007, 2012 1

http://publib.boulder.ibm.com/infocenter/ctm1/v10r1m0/index.jsp


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

Novos Componentes do CognosEsta liberação inclui os novos componentes a seguir:

IBM Cognos TM1 Operations Console - Um novo componente paraadministradores. Este componente requer configuração e implementação em umservidor de aplicativos da web baseado em Java.

IBM Cognos TM1 Performance Modeler - Permite que desenvolvedores criemmodelos de planejamento e análise no ambiente do Cognos TM1. Acessível a partirdo Cognos TM1 Applications.

IBM Cognos Insight - Fornece o poder para analisar dados, explorar cenários einfluenciar decisões criando áreas de trabalho gerenciadas. Use essas áreas detrabalho para comunicar resultados para os gerentes da linha de negócios comoáreas de trabalho gerenciadas interativas. Como o Cognos Insight suportawriteback, também é possível usar estas áreas de trabalho para reunir e consolidardestinos de gerenciamento, compromissos e previsões.

Cognos ConfigurationO utilitário IBM Cognos Configuration é fornecido com esta liberação paragerenciar tarefas comuns e configuração para os seguintes componentes do IBMCognos TM1.v IBM Cognos TM1 Admin Serverv IBM Cognos TM1 Serverv IBM Cognos TM1 Excel Servicev IBM Cognos TM1 Application Serverv IBM Cognos TM1 Application Gateway

O Cognos Configuration deve ser instalado em pelo menos um computador paraexecutar o TM1 Admin Server.

Importante: Altere os seguintes serviços do Cognos TM1 que são criados peloCognos Configuration para que os serviços sejam executados sob uma conta deusuário específica no Microsoft Windows:v Cognos TM1 Admin Serverv Cognos TM1 Serverv Cognos TM1 Excel Service

Para obter detalhes, consulte:v “Contas de Usuário para Execução de Serviços do Cognos TM1 no Windows” na

página 17.v “Alterando Serviços do Cognos TM1 para Serem Executados sob uma Conta de

Usuário Específica no Windows” na página 149.

Novos Bancos de Dados de AmostrasEstá disponível um novo banco de dados de amostras projetado para trabalharcom o IBM Cognos TM1 Applications chamado GO_New_stores

Este banco de dados de amostras é instalado por padrão no localTM1_location/samples. Consulte o Capítulo 11, “Instalação de Bancos de Dados deAmostras do Cognos TM1”, na página 113.

2 IBM Cognos TM1 Versão 10.1.0: Guia de Instalação e Configuração

Apache Tomcat Incluído com a InstalaçãoEsta liberação inclui uma versão do servidor de aplicativos da web Apache Tomcatpara uso com os componentes a seguir:v IBM Cognos TM1 Application Serverv IBM Cognos TM1 Operations Console

Uma instância do Apache Tomcat é instalada automaticamente quando você instalaos componentes do Cognos TM1 Applications.

Suporte para endereços IP IPv6Esta liberação inclui suporte para convenção de endereço IP IPv6.

O IBM Cognos TM1 agora suporta dois protocolos de endereço IP: IPv4 e IPv6. OIPv4 usa endereços IP de 32 bits e o IPv6 usa endereços IP de 128 bits. O padrão éIPv4.

Para obter informações adicionais, consulte “Configurando o Cognos TM1 paraUsar IPv6” na página 154.

Novo Guia de Instalação e ConfiguraçãoA documentação de instalação foi reorganizada.

O novo Guia de Instalação e Configuração do IBM Cognos TM1 fornece umacombinação mais abrangente de tópicos de instalação e configuração, incluindoarquitetura, implementação, parâmetros de configuração e configuração desegurança.

Os seguintes tópicos foram movidos do Guia de Operação do IBM Cognos TM1 parao IBM Cognos TM1 Installation and Configuration Guide:v Arquitetura do sistema Cognos TM1v Arquivo e parâmetros de configuração do servidor Tm1s.cfgv Arquivo e parâmetros de configuração do cliente Tm1p.iniv Autenticação do Cognos TM1 e configuração de segurança SSL

Recursos Alterados na Versão 10.1.0Abaixo estão listadas as mudanças na instalação e configuração para o IBM CognosTM1 desde a última liberação.

Cognos TM1 Admin Server e configuração agora gerenciadosno Cognos Configuration

O utilitário IBM Cognos Configuration é fornecido com esta liberação paragerenciar tarefas comuns e configuração para os seguintes componentes do IBMCognos TM1.

A partir do IBM Cognos TM1 versão 10.1.0, o arquivo de configuração do TM1Admin Server, Tm1admsrv.ini, não é mais usado ou suportado pelo Cognos TM1.

As definições de configuração para o Cognos TM1 Admin Server agora sãoconfiguradas e armazenadas exclusivamente na ferramenta IBM Cognos

Capítulo 1. O Que Há de Novo para a Instalação e Configuração do Cognos TM1 3

Configuration. Você deve usar o Cognos Configuration para configurar o CognosTM1 Admin Server. O Cognos Configuration também inicia e para o Cognos TM1Admin server.

Conta do Usuário Precisa Ser Configurada para ComponentesCognos TM1 em Execução como Serviços do MicrosoftWindows

A ferramenta IBM Cognos Configuration registra componentes Cognos TM1 comoserviços do Windows usando a conta do Sistema Local predefinida. Você precisaráalterar esses serviços para serem executados como um usuário específico.

Importante: Altere os seguintes serviços do Cognos TM1 para serem executadossob uma conta do usuário específica no Microsoft Windows:v Cognos TM1 Admin Serverv Cognos TM1 Serverv Cognos TM1 Excel Service

Versões anteriores do Cognos TM1 permitiam especificar um usuário específicopara os serviços instalados durante o processo de instalação. Como o processoatual não solicita uma conta do usuário, você precisará alterar manualmentequalquer serviço do Windows criado pela ferramenta Cognos Configuration.

Para obter detalhes, consulte:v “Contas de Usuário para Execução de Serviços do Cognos TM1 no Windows” na

página 17.v “Alterando Serviços do Cognos TM1 para Serem Executados sob uma Conta de

Usuário Específica no Windows” na página 149.

Cognos TM1 Contributor Renomeado para Cognos TM1Applications

IBM Cognos TM1 Contributor e seus subcomponentes foram renomeados para estaliberação.v O componente geral agora é chamado de IBM Cognos TM1 Applications.v Os componentes de servidor da web agora são chamados de IBM Cognos TM1

Application Server e IBM Cognos TM1 Application Gateway.v O componente anterior para projetar aplicativos foi substituído pelo novo

componente IBM Cognos TM1 Performance Modeler.

Simultaneidade do Parallel Interaction Configurada por PadrãoO recurso Parallel Interaction introduzido no release anterior agora está ativo porpadrão.

As melhorias no processamento de simultaneidade obtidas usando o recursoParallel Interaction agora estão automaticamente disponíveis para todos osusuários por padrão. Anteriormente, um parâmetro de configuração precisava serconfigurado para usar este recurso.

Para obter detalhes sobre esse recurso, consulte o tópico "Usando InteraçãoParalela com um Servidor Cognos TM1" no Guia de Operações do IBM Cognos TM1.


Para obter detalhes sobre este parâmetro, consulte “ParallelInteraction” na página259.

Software ObrigatórioAlguns componentes de terceiro são obrigatórios e precisam ser instalados antes dainstalação do IBM Cognos TM1.

Faça download e instale estes componentes no sistema de destino antes de instalaros componentes do Cognos TM1 relacionados.

Para obter detalhes, consulte “Requisitos de Software” na página 14.

Para obter as informações mais recentes sobre software obrigatório, consulteAmbientes de Software do Cognos TM1 10.1.0 (www.ibm.com/support/docview.wss?uid=swg27021976).

Seleção e Configuração do IdiomaSelecionar um idioma durante a instalação se aplica somente ao programa deinstalação e não configura mais o idioma para a versão instalada do IBM CognosTM1.

O idioma para as diferentes interfaces com o usuário e mensagens do Cognos TM1agora é configurado automaticamente detectando o idioma atual em seu sistemaoperacional ou navegador da web no tempo de execução.

Para configurar um idioma específico para Cognos TM1, agora você configura estaopção após concluir a instalação.

Consulte o “Configuração do Idioma do Cognos TM1” na página 150.

Configuração de Segurança e AutenticaçãoO programa de instalação não fornece uma opção para selecionar a segurança delogin para Login Integrado ou autenticação LDAP.

Você deve configurar a segurança manualmente após concluir a instalação.Consulte o Capítulo 18, “Configuração de Segurança”, na página 171.

Números de Porta do Cognos TM1 Admin ServerSe alterar o host do IBM Cognos TM1 Admin Server ou os números de porta SSLdo Cognos TM1 Admin Server padrão no Cognos Configuration, você deveráatualizar manualmente os novos valores no arquivo de serviços do UNIX e doMicrosoft Windows.

Este arquivo do sistema operacional não é atualizado pelo Cognos TM1.

Para obter detalhes, consulte “Alterando Números de Porta Padrão para CognosTM1 Admin Server” na página 153.

Instalação SilenciosaAs opções e o uso da instalação silenciosa (não assistida) foram alterados a partirdas versões do Cognos TM1 anteriores.

Consulte o “Instalações não Assistidas” na página 285.

Capítulo 1. O Que Há de Novo para a Instalação e Configuração do Cognos TM1 5

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


Capítulo 2. Planejando sua Instalação do Cognos TM1

A chave para uma instalação bem-sucedida é o planejamento.

Durante a implementação do IBM Cognos TM1, decida como instalá-lo econfigurá-lo para fornecer o melhor desempenho possível. As opções de instalaçãoe configuração que você faz dependem de seus requisitos, recursos e preferências.

Programas de Instalação DisponíveisO IBM Cognos TM1 fornece uma coleção de programas de instalação para instalare configurar componentes Cognos TM1 em diferentes sistemas operacionais e paradiferentes cenários de implementação.

Os programas de instalação e as opções de componente são organizados pelosistema operacional e pela camada de arquitetura para suportar a implementaçãoem ambientes operacionais únicos e múltiplos.

Os programas de instalação disponíveis do Cognos TM1 10.1 estão descritosabaixo.

TM1 Windows de 32 bits

Inclui uma coleção de todos os componentes Cognos TM1 de 32 bits queestão disponíveis para Microsoft Windows.

Use este programa de instalação para instalar todos os componentes emum único sistema Windows de 32 bits ou para instalar seletivamentecomponentes individuais, tais como o Cognos TM1 Admin Server e oCognos TM1 Server, em sistemas Windows separados de 32 bits.

Por padrão, este programa de instalação instala automaticamente outilitário IBM Cognos Configuration para gerenciar os componentesCognos TM1 Admin Server, Cognos TM1 Server e Cognos TM1Applications.

TM1 Windows de 64 bits

Inclui uma coleção combinada de componentes de 32 bits e 64 bits parainstalação em um sistema Microsoft Windows de 64 bits.

Este programa de instalação será executado somente em um sistemaWindows de 64 bits.

Use este programa de instalação para instalar todos os componentes emum único sistema Windows de 64 bits ou para instalar seletivamentecomponentes individuais, tais como o Cognos TM1 Admin Server e oCognos TM1 Server, em sistemas Windows de 64 bits separados.

Por padrão, este programa de instalação instala automaticamente outilitário IBM Cognos Configuration para gerenciar os componentesCognos TM1 Admin Server, Cognos TM1 Server e Cognos TM1Applications.

Apenas TM1 Client


Inclui somente os clientes/interfaces com o usuário do Cognos TM1padrão. Estes componentes estão disponíveis somente como versões de 32bits.

Cognos TM1 Architect

Cognos TM1 Perspectives

Cognos TM1 Performance Modeler

Cognos Insight

Use este programa de instalação para distribuir e instalar os clientesCognos TM1 em diversos computadores de usuário final em seu ambiente.

TM1 UNIX

Inclui somente as versões do UNIX versões dos componentes Cognos TM1Admin Server e Cognos TM1 Server.

Use o programa de instalação do Cognos TM1 UNIX para instalar oCognos TM1 Admin e/ou Cognos TM1 Server em qualquer um dossistemas operacionais UNIX ou Linux suportados. Um programa deinstalação separado está disponível para cada um destes sistemasoperacionais suportados.

Por padrão, este programa de instalação instala automaticamente outilitário IBM Cognos Configuration para gerenciar os componentesCognos TM1 Admin Server e Cognos TM1 Server.

TM1 Interoperability for Business Intelligence

Programa de Instalação Opcional

Instala componentes opcionais que fornecem interação entre o IBM CognosTM1 e o IBM Cognos Business Intelligence (BI). Fornece suporte paraCognos TM1 Viewer Portlets e painéis, fornecendo o Cognos Insight apartir do Cognos BI Gateway e vinculando a IBM Cognos TM1Applications do Cognos BI.

Disponível para UNIX e Microsoft Windows.

TM1 Package Connector for Business Intelligence

Programa de Instalação Opcional

Instala componentes que suportam conectividade do IBM Cognos TM1com pacotes do IBM Cognos Business Intelligence (BI) com origens dedados SAP Business Warehouse e outras origens de dados ODBC erelacionais.

TM1 Workflow

Programa de instalação opcional.

Instala os componentes necessários para o aplicativo IBM Cognos TM1Workflow.

Componentes DisponíveisO IBM Cognos TM1 inclui uma coleção de componentes de servidor e de clientepara administrar, monitorar, modelar, analisar e interagir com dados do CognosTM1.


O programa de instalação organiza os diferentes componentes do Cognos TM1 emgrupos com base na camada da arquitetura. É possível instalar diferentescombinações de componentes em um único computador ou em diversoscomputadores, dependendo de seus requisitos, de seu sistema operacional e de seuambiente específicos. Cada componente requer um sistema operacional e umambiente de software específicos.

Componentes da Camada de Aplicativos

A tabela a seguir inclui a descrição e o sistema operacional para cada componentedo Cognos TM1 na camada do aplicativo.

Tabela 1. Componentes da Camada de Aplicativos

Componente Sistema operacional Descrição

TM1 Server Windows de 32 bits

Windows de 64 bits

UNIX de 64 bits

O Cognos TM1 Server gerencia solicitaçõesdos clientes Cognos TM1. Ele carrega osnomes de todos os objetos permanentesdisponíveis (cubos, dimensões, etc.) namemória e responde às solicitações docliente fazendo cálculos, consolidações eatualizações, conforme necessário.

O Cognos TM1 Server também gerencia asegurança concedendo ou negando o acessoaos objetos do servidor e mantendo um logde mudanças no banco de dados.

Consulte o Capítulo 7, “Instalação doCognos TM1 Server”, na página 67.

TM1 Admin Server Windows de 32 bits

Windows de 64 bits

UNIX de 64 bits

Um processo que controla todos osservidores Cognos TM1 em execução emuma rede. Um Servidor Admin é executadoem um computador conhecido como umHost Admin.

Quando um servidor Cognos TM1 éiniciado, o servidor se registra com umServidor Administrativo que está emexecução em um Host Administrativoespecificado.

Os clientes Cognos TM1 referenciam oServidor Administrativo para determinarquais servidores Cognos TM1 estãodisponíveis na rede.

Consulte o Capítulo 7, “Instalação doCognos TM1 Server”, na página 67.

Ferramentas do TM1 Os sistemasoperacionaissuportados variampor ferramenta.

Inclui a seguinte coleção de ferramentas eutilitários para administradores,desenvolvedores e modeladores do CognosTM1:

TIRunTI

TM1xfer

Consulte o Capítulo 13, “Instalação dasFerramentas Cognos TM1”, na página 137.

Capítulo 2. Planejando sua Instalação do Cognos TM1 9

Componentes da Camada do Aplicativo da Web

Estes componentes requerem um servidor de aplicativos da web no qual executar.

A tabela a seguir inclui a descrição e o sistema operacional para cada componentedo Cognos TM1 na camada do aplicativo da web.

Tabela 2. Componentes da Camada do Aplicativo da Web


TM1 ApplicationGateway

Windows de 32 bits

Windows de 64 bits

Componente da web baseado em Java quefaz o fornecimento dos componentes CognosTM1 Performance Modeler e Cognos Insightpara usuários finais remotos.

Este componente geralmente é instaladojuntamente com o componente TM1Application Server.

Consulte o Capítulo 9, “Instalação doCognos TM1 Applications”, na página 83.

TM1 ApplicationServer

Windows de 32 bits

Windows de 64 bits

Aplicativo da web baseado em Java quefornece o suporte primário para o IBMCognos TM1 Applications.

O Cognos TM1 Applications permiteprojetar, implementar e executar aplicativosde planejamento gerenciados baseados emcontribuição em dados do Cognos TM1. Estecomponente também interage com oscomponentes Cognos TM1 PerformanceModeler e Cognos Insight.

Este componente requer um servidor deaplicativos da web baseado em Java e o JavaRuntime Environment (JRE)

É possível usar o servidor de aplicativosApache Tomcat que é instalado por padrãoou sua própria instância de um servidor deaplicativos tal como o IBM WebSphereApplication Server.

Um IBM JRE é instalado automaticamentecom o Cognos TM1 Applications. Se estiverusando um servidor de aplicativos, use oJRE que é instalado com ele.

Consulte o Capítulo 9, “Instalação doCognos TM1 Applications”, na página 83.


Tabela 2. Componentes da Camada do Aplicativo da Web (continuação)


TM1 Web Windows de 32 bits

Windows de 64 bits

Componentes do servidor da web e docliente baseados no Microsoft InternetInformation Services (IIS) / .NETFramework.

O Cognos TM1 Web permite que osusuários se conectem aos servidores CognosTM1 e interajam com dados usando um dosnavegadores da web suportados.

Consulte o Capítulo 8, “Instalação doCognos TM1 Web”, na página 77.

TM1 OperationsConsole

Windows de 32 bits

Windows de 64 bits

Aplicativo da web baseado em Java quefornece uma ferramenta de monitoramentobaseado na web para administradores doTM1 monitorem e executarem ação naatividade do servidor TM1.

O IBM Cognos TM1 Operations Consolefornece uma maneira simples e efetiva deentender como os servidores Cognos TM1 eos carregamentos do usuário estãofuncionando.

É possível usar este componente com oservidor de aplicativos Apache Tomcat que éinstalado por padrão ou sua própriainstalação de um servidor de aplicativossuportado.

Um IBM JRE é instalado automaticamentecom o Cognos TM1 no Windows. Se estiverusando um servidor de aplicativos, use oJRE que é instalado com ele.

Consulte o Capítulo 12, “Instalando oCognos TM1 Operations Console”, napágina 125.

Componentes da Camada de Cliente

A tabela a seguir inclui a descrição e o sistema operacional para cada componenteCognos TM1 na camada de cliente.


Tabela 3. Componentes da Camada de Cliente


TM1 Perspectives Windows de 32 bits Cliente de suplemento do Cognos TM1 paraMicrosoft Excel.

Permite usar os recursos do Excel paraexecutar a análise complexa nos dadosarmazenados em um servidor Cognos TM1.Também pode criar e manter objetos edados em Cognos TM1 Servers locais eremotos.

Consulte o “Instalando o Cognos TM1Perspectives” na página 101.

Cognos Insight Windows de 32 bits Interface rich client Java baseada em Eclipseque pode ser ativada de modo independenteou a partir da página de portal do CognosTM1 Applications.

Disponível como um componenteselecionável apenas no Client e emprogramas de instalação Windows de 32 bitse 64 bits.

Por padrão, este componente estádisponível, mas não selecionado nosprogramas de instalação do Windows de 32bits e 64 bits.

Consulte o “Instalando o Cognos Insight”na página 108.

TM1 APIs Dependente de APIsespecíficas

Instala os arquivos necessários quepermitem que os desenvolvedores trabalhemcom as seguintes interfaces de programaçãode aplicativos (APIs) do Cognos TM1.

TM1 API - Permite que os desenvolvedorescriem aplicativos C, C++ e VB customizadosque interagem com o TM1.

TM1 Java API - Permite quedesenvolvedores criem aplicativos Javacustomizados que interagem com o TM1.

TM1 .NET API - Permite que osdesenvolvedores criem aplicativos Microsoft.NET customizados que interagem com oTM1.

Componentes de Camada do Desenvolvedor

A tabela a seguir inclui a descrição e o sistema operacional para cada componenteTM1 na camada do desenvolvedor.


Tabela 4. Componentes de Camada do Desenvolvedor


TM1 Architect Windows de 32 bits Um aplicativo de desktop baseado emWindows para administrar, criar e manterdados e metadados em ambos os servidoresTM1, local e remoto.

Consulte o “Instalando o Cognos TM1Architect” na página 103.

TM1 PerformanceModeler

Windows de 32 bits Interface rich client Java, baseada em Eclipseque é ativada a partir da página de portaldo Cognos TM1 Applications.

Permite que os desenvolvedores construammodelos de planejamento e análise noambiente do Cognos TM1.

Disponível como um componenteselecionável apenas no Client e emprogramas de instalação Windows de 32 bitse 64 bits.

Por padrão, este componente estádisponível, mas não selecionado nosprogramas de instalação do Windows de 32bits e 64 bits.

Consulte o “Instalando o Cognos TM1Performance Modeler” na página 104.

Componentes do Banco de Dados de Amostras

A tabela a seguir inclui a descrição e o sistema operacional para cada componenteadicional do TM1.

Tabela 5. Componentes do Banco de Dados de Amostras


Amostras Windows de 32 bits

Windows de 64 bits

UNIX de 64 bits

Instala os bancos de dados de amostrasCognos TM1:

Capítulo 11, “Instalação de Bancos de Dadosde Amostras do Cognos TM1”, na página113.

Componentes Adicionais Não Listados

A tabela a seguir inclui a descrição e o sistema operacional para componentesnecessários que não são listados ou selecionáveis no programa de instalação, massão instalados por padrão com a instalação de outros componentes selecionáveis.


Tabela 6. Componentes Adicionais Não Listados


TM1 Excel Service Windows de 32 bits Um componente de suporte necessário parao Cognos TM1 Web. Instalado somentequando o Cognos TM1 Web é instalado.

Instala e executa como um serviço doMicrosoft Windows no servidor da web quehospeda o Cognos TM1 Web.

Consulte o Capítulo 8, “Instalação doCognos TM1 Web”, na página 77.

TM1 OLE DBProvider Application

Windows de 32 bits

Windows de 64 bits

Permite que software de terceiro recuperedados do cubo do servidor Cognos TM1usando consultas MDX.

Requisitos de SoftwareAntes de instalar os componentes do servidor ou do cliente IBM Cognos TM1,revise os requisitos do sistema e configure os recursos em seu ambiente para queos componentes possam operar.

Revise a lista mais recente de ambientes suportados pelo Cognos TM1, incluindoinformações sobre sistemas operacionais, correções, servidores da Web enavegadores da web, visitando Cognos TM1 Software Environments(https://www.ibm.com/support/docview.wss?rs=3446&uid=swg27014444).

Software Obrigatório

Cognos TM1 Perspectives, Cognos TM1 Architect, Cognos TM1 Web e Cognos TM1Applications requerem a instalação de componentes de software específicos antesque eles possam ser instalados e usados.

Tabela 7. Componentes de Terceiros Obrigatórios

Componente de Pré-requisito Descrição

Microsoft Excel Obrigatório para Cognos TM1 Perspectives.

Opcional no servidor da Web no qual o Cognos TM1Web está em execução.

Microsoft Visual C++ 2005 SP1Redistributable Package

Requerido para Cognos TM1 Perspectives e Cognos TM1Architect.

Microsoft .NET 3.5 SP1Framework

Requerido para Cognos TM1 Perspectives, Cognos TM1Architect e Cognos TM1 Web.

Microsoft Chart Controls paraMicrosoft .NET Framework 3.5.

A partir do Cognos TM1 versão 9.5.2, o Cognos TM1Web requer o Microsoft Chart Controls para Microsoft.NET Framework 3.5 no servidor da Web no qual oCognos TM1 Web está em execução.

Este componente suporta o gráfico de dados nasinterfaces com o usuário do Cognos TM1 Web e doCognos TM1 Applications.

Faça download e instale estes componentes no sistema de destino antes de instalaros componentes do Cognos TM1 relacionados.


https://www.ibm.com/support/docview.wss?rs=3446&uid=swg27014444

Valores de Instalação PadrãoEste tópico descreve o conjunto de valores padrão usados pela instalação do IBMCognos TM1.

A instalação do Cognos TM1 usa os seguintes valores de configuração padrão:

Tabela 8. Valores de Configuração Padrão para Instalação do Cognos TM1

Item Descrição e Valor Padrão

Local de InstalaçãoPadrão

Em um sistema Microsoft Windows de 32 bits:

C:\Arquivos de Programas\IBM\Cognos\TM1

C:\Program Files\IBM\Cognos\TM1\TM1Web

Em um sistema Microsoft Windows de 64 bits:

C:\Program Files\IBM\cognos\tm1_64

C:\Program Files\IBM\cognos\tm1_64\TM1Web

Número da porta doAdmin Server

O número da porta TCP/IP na qual o Admin Server atendesolicitações do cliente.

5495 (não segura)

Número da Porta SSL doAdmin Server

O número da porta TCP/IP na qual todos os componentesCognos TM1 se comunicam com o Cognos TM1 Admin Serverusando Secure Socket Layer (SSL).

5498 (segura)

Número da Porta doServidor Cognos TM1

A porta na qual o servidor Cognos TM1 é executado. Esteparâmetro é usado para distinguir diversos servidores CognosTM1 em execução no mesmo computador. Os valores de portaválidos ficam entre 5000 e 49151.

O padrão é 12345.

Número da Porta deMensagem do ClienteCognos TM1

12345

Esse é um padrão de amostra. O sistema escolhe o próximonúmero de porta disponível.

Esse número de porta estabelece uma porta secundária paramensagens de progresso para ser usada quando uma operaçãomuito longa estiver aguardando para ser cancelada.

Nome do host do AdminServer

O mesmo que o computador no qual a instalação é executada.

Nomes do ServidorCognos TM1 de amostra

Amostra de Planejamento

SData

GO_New_Stores

Credenciais de Login:

Nome de Usuário: admin

Senha: apple


Tabela 8. Valores de Configuração Padrão para Instalação do Cognos TM1 (continuação)

Item Descrição e Valor Padrão

Diretório de dadospadrão para servidoresCognos TM1 de amostra

C:\Arquivos de Programas\IBM\cognos\tm1\samples\tm1\PlanSamp

C:\Arquivos de Programas\IBM\cognos\tm1\samples\tm1\SData

C:\Program Files\IBM\cognos\tm1\samples\tm1\GO_New_Stores

Modo de segurança Uma instalação Padrão usa Autenticação do Cognos TM1. Nestemodo, o servidor Cognos TM1 solicita aos usuários um nome deusuário e uma senha quando eles efetuam login noscomponentes Cognos TM1.

Visão Geral da ConfiguraçãoApós instalar o IBM Cognos TM1, use a ferramenta Cognos Configuration e osparâmetros do arquivo de configuração do Cognos TM1 para configurar oprograma para desempenho ideal.

Cognos Configuration e Cognos TM1A ferramenta IBM Cognos Configuration é usada para iniciar, parar, configurar esalvar a configuração para cada IBM Cognos TM1 Server.

Use o Cognos Configuration para gerenciar os seguintes componentes e tarefas:

Tabela 9. Tarefas do Cognos Configuration

Componente/Tarefa Ação

Cognos TM1 Admin Server Iniciar e parar o servidor.

Cognos TM1 Server Iniciar, parar e incluir os Cognos TM1 Servers.

Cognos TM1 Excel Service Iniciar e parar o serviço do Cognos TM1 Excel que suporta oCognos TM1 Web.

Cognos TM1 ApplicationServer

Iniciar e parar o servidor de aplicativos da web ApacheTomcat fornecido e o Cognos TM1 Application Server quesuporta Cognos TM1 Applications.

Se estiver usando sua própria instalação do Tomcat ou umoutro servidor de aplicativos da web, configure e execute oCognos TM1 Application Server fora do CognosConfiguration.

Salvando informações deconfiguração

Quando você salva a definição de configuração naferramenta Cognos Configuration, a ferramenta:

v verifica a configuração

v gera informações de criptografia

v verifica a integridade de dados criptografados

v salva a configuração para servidores Cognos TM1

v faz backup dos arquivos de configuração

v salva parâmetros de configuração

v atualiza o arquivo de configuração Tomcat


Tabela 9. Tarefas do Cognos Configuration (continuação)

Componente/Tarefa Ação

Criando arquivos WAR paraimplementação

Se desejar implementar o Cognos TM1 Application Servercom seu próprio servidor de aplicativos da web, use oCognos Configuration para criar o arquivo de aplicativo daweb (war) necessário.

No Cognos Configuration, clique em Ações > ConstruirArquivos de Aplicativo.

Parâmetros de Configuração do Cognos TM1O IBM Cognos TM1 usa uma coleção de parâmetros de configuração paracontrolar o comportamento dos componentes do cliente e do servidor.

Tabela 10. Parâmetros de Configuração do Cognos TM1 Disponíveis

Configuração Descrição

Arquivo Tm1s.cfg Configuração do servidor Cognos TM1

Consulte o Apêndice B, “O Arquivo de Configuração doServidor Tm1s.cfg”, na página 231.

Arquivo Tm1p.ini Configuração do cliente para Cognos TM1 Architect eCognos TM1 Perspectives

Consulte o Apêndice C, “O Arquivo de Configuração doCliente Tm1p.ini”, na página 275.

Cognos TM1 Web - arquivoweb.config

Configuração e definições do TM1 Web

Consulte o “Configuração Avançada do Cognos TM1Web” na página 156.

Configuração do Cognos TM1Applications

Configuração do Cognos TM1 Applications

Consulte o “Configuração Avançada do Cognos TM1Applications” na página 162.

Cognos TM1 OperationsConsole

Configuração do Cognos TM1 Operations Console

Consulte o Capítulo 12, “Instalando o Cognos TM1Operations Console”, na página 125.

Contas de Usuário para Execução de Serviços do Cognos TM1 noWindows

Quando você usa o IBM Cognos Configuration para iniciar o Cognos TM1 AdminServer, o Cognos TM1 Server e o Cognos TM1 Excel Service, eles são registradospara executarem como serviços do Windows usando a Conta do Sistema LocalMicrosoft Windows predefinida. Você deve alterar manualmente esses serviçospara serem executados sob uma conta de usuário específica.

Executar Serviços do Cognos TM1 sob uma Conta de UsuárioEspecífica do Windows

Por padrão, o Cognos Configuration registra os seguintes serviços do Cognos TM1para serem executados sob a Conta do Sistema Local do Microsoft Windows:v Cognos TM1 Admin Server


v Cognos TM1 Serverv Cognos TM1 Excel Service

Importante: Altere esses serviços do Cognos TM1 para serem executados sob umaconta de usuário específica do Microsoft Windows.

Para obter detalhes sobre como alterar a conta para um componente Cognos TM1em execução como um serviço do Windows, consulte “Alterando Serviços doCognos TM1 para Serem Executados sob uma Conta de Usuário Específica noWindows” na página 149.

Após fazer estas mudanças, você ainda poderá usar o Cognos Configuration parainiciar e parar estes serviços.

Privilégios Necessários para uma Conta do Usuário do WindowsEspecífico

A conta de usuário para execução de serviços do Cognos TM1 no Windows deveser um membro do grupo Administrador Local e estar incluída no grupo deproprietários do banco de dados para acessar tabelas SQL e visualizações.

A conta deve ter os seguintes privilégios na máquina local:v Agir como parte do sistema operacionalv Ignorar a verificação transversalv Aumentar cotasv Substituir um token de nível de processov Efetuar logon como um serviçov Ter privilégios de leitura e gravação no item Windows Registry

Confirmando a Instalação Adequada do Microsoft .NET FrameworkO Microsoft.NET Framework Versão 3.5 SP1 é necessário para o Cognos TM1Perspectives, o Cognos TM1 Architect e o Cognos TM1 Web.

É possível fazer o download do .Net Framework a partir do website de suporte daMicrosoft. Quando você instala, uma mensagem é exibida para lembrá-lo desterequisito.

O Microsoft Internet Information Services (IIS) deve ser instalado antes de instalara estrutura .NET 3.5 que é necessária para o Cognos TM1 Web.

Para obter as informações mais recentes sobre software obrigatório, visiteAmbientes de Software do Cognos TM1 10.1.0 (www.ibm.com/support/docview.wss?uid=swg27021976).

Para garantir que o .NET Framework 3.5 SP1 esteja instalado e registradocorretamente em seu computador, execute estas etapas.

Procedimento1. Abra uma janela Prompt de Comandos e navegue para o seguinte diretório:

C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727

Para um sistema Windows x64, use o diretório a seguir:C:\WINDOWS\Microsoft.NET\Framework64\v2.0.50727



Lembre-se: O IBM Cognos TM1 Web requer o Microsoft .NET Framework 3.5SP1, no entanto, o .NET 2.0 permanece em seu sistema após o upgrade do .NETe é necessário para esta etapa.

2. Execute o seguinte comando:aspnet_regiis.exe -i

Ativando o Cognos TM1 Excel ServiceSe o .NET Framework não estiver instalado antes de você instalar o IBM CognosTM1 Web, o Cognos TM1 Excel Service será desativado quando você concluir ainstalação do Cognos TM1 Web.

Este serviço fornece a funcionalidade do Cognos TM1 Web crítica e você deveconcluir as etapas a seguir para configurar a propriedade de Inicialização doServiço como Automática após instalar o .NET Framework.

Procedimento1. Abra o Painel de Controle do Windows .2. Dê um clique duplo em Ferramentas Administrativas.3. Dê um clique duplo em Serviços.4. Dê um clique duplo em TM1 Excel Service.5. Altere Tipo de Inicialização de Desativado para Automático.6. Clique em OK.

Além disso, se planeja executar o Cognos TM1 Web, você deve instalar umaversão suportada atualmente do Microsoft Excel na mesma máquina na qual oservidor da web do IIS está instalado.

Definindo o Usuário do ASPNETSe instalar o IBM Cognos TM1 Web em um sistema onde o Microsoft .NETFramework ainda não está instalado, talvez você encontre um erro dizendo que ousuário do ASPNET não está definido no sistema.

Você deve definir o usuário do ASPNET antes de instalar o Cognos TM1 Web. Sigaestas etapas para criar o usuário do ASPNET.

Procedimento1. Abra o Painel de Controle do Windows .2. Dê um clique duplo em Ferramentas Administrativas.3. Dê um clique duplo em Gerenciamento de Computadores.4. Clique em Grupos e Usuários Locais.5. Clique com o botão direito do mouse em Usuários e selecione Novo Usuário.6. Configure os campos da seguinte forma:

Nome do usuárioASPNET

Nome completoConta da Máquina ASP.NET

DescriçãoConta para execução de aplicativos ASP.NET

Senha Insira uma senha de sua escolha.


Usuário deve alterar senha no próximo logonEste campo não está disponível.

Usuário não pode alterar senhaSelecione esta caixa de seleção.

Senha nunca expiraSelecione esta caixa de seleção.

Conta está desativadaNão selecione esta caixa de seleção.

7. Clique em Criar.

Cognos TM1 Web Requer Componente Microsoft Chart ControlsA partir do IBM Cognos TM1 versão 9.5.2, o Cognos TM1 Web requer umcomponente gráfico de terceiro, Microsoft Chart Controls para Microsoft .NETFramework 3.5, no servidor da Web onde o Cognos TM1 Web está em execução.Você deve fazer download e instalar manualmente este componente.

O componente Microsoft Chart Controls suporta a criação de gráficos de dados nasinterfaces com o usuário do Cognos TM1 Web e Cognos TM1 Applications.

Faça o download e instale esse componente no servidor da Web onde o CognosTM1 Web está em execução.

Para obter mais detalhes sobre o componente Microsoft Chart Controls, procure noWeb site da Microsoft o seguinte tópico: Microsoft Chart Controls para Microsoft.NET Framework 3.5

Instalando o TM1 em Redes sem DomíniosSe você instalar o IBM Cognos TM1 em uma rede que não usa um controlador dedomínio, é possível configurar os serviços do Cognos TM1 para usarem contaslocais.

Para obter detalhes sobre a configuração dos serviços do Cognos TM1, consulte“Alterando Serviços do Cognos TM1 para Serem Executados sob uma Conta deUsuário Específica no Windows” na página 149.

Se usar uma ou mais contas locais para seus serviços do Cognos TM1, você deveráter certeza que estas contas possuem os seguintes privilégios em suas máquinaslocais:v Agir como parte do sistema operacionalv Ignorar a verificação transversalv Aumentar cotasv Substituir um token de nível de processov Efetuar logon como um serviço

Se você configurar compartilhamentos de arquivo em sua rede Windows para usopor componentes Cognos TM1, certifique-se de que cada conta local configuradapara executar um serviço do Cognos TM1 tenha acesso a esses compartilhamentos.

Nota: Se você instalar em uma máquina que não participa de um domínio doMicrosoft Windows, não será possível usar o Login Integrado.


Sintaxe da Máquina LocalNão use ponto, como "." como uma abreviação para o domínio da máquina localquando você especificar informações de login.

Você deve inserir explicitamente o nome da máquina. Em certas configurações, ouso da sintaxe ".\username" pode causar sérios problemas.



Capítulo 3. Arquitetura

Para entender a arquitetura dos principais componentes do IBM Cognos TM1, vocêdeve estar familiarizado com a infraestrutura da tecnologia da informação e com asnecessidades de negócios das pessoas em sua organização que usarão o IBMCognos TM1.

Para obter detalhes sobre autenticação de login e segurança de comunicação doCognos TM1, consulte “Segurança da Autenticação” na página 171.

Arquitetura do Cognos TM1O IBM Cognos TM1 utiliza uma arquitetura de cliente/servidor distribuída queconsiste no servidor IBM Cognos TM1 ao qual uma combinação de diferentesclientes pode se conectar.

O Cognos TM1 fornece os seguintes clientes e interfaces com o usuário:v Cognos TM1 Perspectivesv Cognos TM1 Architectv Cognos TM1 Client (versão limitada do Cognos TM1 Perspectives )v Cognos TM1 Cognos Web clientv Portal e fluxo de trabalho do Cognos TM1 Application (usando o Cognos TM1

Application Server)v Cognos TM1 Performance Modelerv Cognos Insight

Neste ambiente, os dados corporativos residem em servidores remotos, que podemser acessados por clientes autorizados. Dependendo de como você configura o

Figura 1. Visão Geral Resumida da Arquitetura de Cliente/Servidor do Cognos TM1


sistema, os clientes podem acessar um ou mais servidores TM1 remotos para obterdiferentes tipos de dados. Os clientes Cognos TM1 são descritos em detalhes noGuia do Usuário do IBM Cognos TM1 .

Clientes da Área de Trabalho do Windows

O TM1 Perspectives e o TM1 Architect podem se conectar a um servidor IBMCognos TM1 local, que age como um repositório para os dados privados do TM1 .Se você tiver a autoridade apropriada, poderá copiar dados de um servidor remotopara seu servidor local replicando esses dados e, em seguida, sincronizar suasatualizações de volta no servidor remoto.

O TM1 Perspectives, o TM1 Architect e o TM1 Client são clientes TM1 padrão. Emum ambiente de LAN/WAN normal, todos estes clientes comunicam-se com umservidor remoto usando o protocolo de rede TCP/IP.

Visão Geral do Cognos TM1 Admin ServerO IBM Cognos TM1 Admin Server é um processo que controla todos os servidoresCognos TM1 em execução em uma rede. Um Servidor Admin é executado em umcomputador conhecido como um Host Admin.

Quando o servidor Cognos TM1 inicia, o servidor se registra com um ServidorAdministrativo que está em execução em um Host Administrativo especificado. Osclientes TM1 referenciam o Admin Server para determinar quais servidores CognosTM1 estão disponíveis na rede.

O Admin Server mantém as informações a seguir para cada servidor Cognos TM1disponível:v Nome do servidorv Endereço IPv Protocolov Número da porta

Todas estas informações são fornecidas pelo servidor Cognos TM1 quando oservidor se registra no Admin Server.

Um Admin Server deve estar em execução antes de um servidor Cognos TM1poder iniciar. Se você tiver especificado um Host Administrativo no arquivoTm1s.cfg ou na linha de comandos do servidor, o servidor Cognos TM1 tentará seconectar a um Admin Server nesse host. O servidor Cognos TM1 falhará em serexibido se ele não conseguir se conectar ao Admin Server por qualquer razão.

Se você não tiver especificado um Host Administrativo, o servidor Cognos TM1tentará se conectar a um Admin Server na máquina local. Se um Admin Server nãoestiver atualmente em execução na máquina local, o servidor Cognos TM1 iniciaráum novo Admin Server e se conectará a ele.

O Admin Server se torna ciente dos servidores Cognos TM1 na rede atendendo anotificação dos servidores. Geralmente, o servidor Cognos TM1 envia notificaçãode sua presença em um intervalo regular chamado de "intervalo de pulsação", queé de 60 segundos por padrão. Quando o Admin Server detecta o servidor CognosTM1 , esse servidor se torna registrado e disponível para clientes na rede. Noentanto, se o Admin Server não detecta a presença de um servidor Cognos TM1registrado durante um período igual a três vezes o intervalo de pulsação, esse


servidor Cognos TM1 será removido da lista de servidores disponíveis na rede.Consequentemente, o servidor Cognos TM1 não estará disponível para clientes narede.

Por padrão, o Servidor Admin usa a porta 5495. Se a porta 5495 já estiver em uso,será possível designar um novo número da porta, criando um novo serviçochamado Tm1admsrv. Todos os aplicativos Cognos TM1 procuram um serviçonomeado chamado Tm1admsrv e, se esse serviço existir, os aplicativos usarão onúmero da porta designado ao serviço. Se o serviço não existir, os aplicativosCognos TM1 usarão a porta 5495.

Visão Geral do Cognos TM1 ServerO IBM Cognos TM1 Server gerencia o acesso ao diretório de dados do CognosTM1 para clientes Cognos TM1.

A figura a seguir ilustra as operações de um servidor Cognos TM1 remoto. Estasoperações são explicadas no texto a seguir.

v Na inicialização, o servidor remoto carrega dimensões e cubos do diretório dedados para a RAM da máquina servidor. Ao mesmo tempo, o servidor abre umnovo arquivo de log transacional chamado Tm1s.log no diretório de dados.Quando os cubos estiverem carregados, o servidor remoto estará disponível.

v O servidor Cognos TM1 remoto se registra com um ou mais ServidoresAdministrativos para que clientes possam se conectar ao servidor Cognos TM1remoto.

v Os aplicativos clientes contatam o Servidor Administrativo para localizarservidores Cognos TM1 disponíveis. Os clientes efetuam login nos servidoresCognos TM1 cujos dados eles desejam acessar.

v Os clientes editam os dados do cubo, enviando os valores de volta para oservidor Cognos TM1 .

Figura 2. Operações de um Servidor Remoto

Capítulo 3. Arquitetura 25

v Conforme novos valores são recebidos dos clientes, o servidor Cognos TM1grava os registros no arquivo Tm1s.log, controlando todas as mudanças dedados, incluindo a data e hora em que a edição ocorreu e o ID do cliente que feza edição.

v Conforme o servidor calcula novos valores em resposta a solicitações do cliente,o servidor armazena-os na memória, aumentando a quantidade de memóriausada pelo servidor.

v Quando o servidor for encerrado, todos os registros no arquivo Tm1s.log serãosalvos no disco, e o arquivo de log de transações será renomeado, anexando umregistro de data e hora a ele. O arquivo Tm1s.log é salvo no diretório de dadosdo servidor para restaurar transações de dados. Para obter detalhes, consulte otópico "Restaurando Registros a Partir do Log de Transações” no Guia deOperações do IBM Cognos TM1.Se o servidor for encerrado intencionalmente sem salvar as mudanças, o arquivode log será salvo com um registro de hora/data e a extensão será alterada para.rej. O arquivo Tm1syyyymmddhhmmss.rej pode ser processado por meio doTurboIntegrator para recuperar as transações.

v Para salvar todas as mudanças nos dados em um servidor Cognos TM1 aqualquer tempo sem encerrar o servidor, clique com o botão direito do mouseem um servidor no Server Explorer e clique em Salvar Dados. Todos os registrosno arquivo Tm1s.log são imediatamente gravados no disco, o arquivo de log detransações é renomeado anexando a ele um registro de data e hora e um novoarquivo Tm1s.log é criado para aceitar edições subsequentes em valores do cubo.As mudanças nos metadados, como definições de dimensão e definições decubo, são imediatamente salvas no disco. As mudanças nos metadados não sãogravadas no arquivo de log de transações.

Visão Geral dos Arquivos Cognos TM1O IBM Cognos TM1 requer numerosos arquivos de objeto e de sistema, a maioriados quais é armazenada no diretório de dados do servidorCognos TM1 .

Alguns deles são instalados com o produto, enquanto outros são gerados para cadadimensão e cubo criados. Além disso, outros arquivos são gerados pelo CognosTM1 para armazenar metadados, tais como informações de segurança.

A tabela a seguir lista os arquivos que definem cubos, dimensões e outros objetosdo Cognos TM1 . Estes arquivos estão localizados no diretório de dados, que édescrito posteriormente nesta seção.

Tabela 11. Arquivos que Definem Cubos, Dimensões e outros Objetos

Extensão do Arquivo Descrição

.blb Arquivo de formatação de cubo

.cho Arquivo de definição de tarefa de organização deprocessos

.cub Arquivo de banco de dados de cubo

.dim Dimensão compilada

.dit Arquivo de origem de dimensão ASCII


Tabela 11. Arquivos que Definem Cubos, Dimensões e outros Objetos (continuação)

Extensão do Arquivo Descrição

.pro Arquivo de definição de processo do TurboIntegrator

.rux Regra compilada

.sub Subconjunto de dimensões

.tbu Origem ASCII para arquivo de visualização

.tqu Consulta salva

.tru Origem ASCII para um arquivo de regras

.vue Visualização salva

.xdi Planilha de dimensões do Excel

.xru Planilha de regras do Excel

Visão Geral do Diretório de DadosO diretório de dados contém as informações de cubos, dimensões e do sistema quesão carregadas na memória quando um servidor Cognos TM1 é iniciado. Quandovocê acessa um servidor a partir de qualquer cliente Cognos TM1 , o Cognos TM1lê dados a partir do diretório de dados desse servidor.

Quando você executa o Cognos TM1 , as mudanças feitas nos valores do cubo sãoarmazenadas imediatamente na memória e no log de transações (Tm1s.log). OCognos TM1 , então, salva os dados de volta no diretório de dados quandoqualquer uma das situações a seguir ocorre:v O servidor Cognos TM1 é encerrado.v Um administrador clica com o botão direito do mouse em um ícone do servidor

no Server Explorer e escolhe Salvar Dados no menu pop-up. Isto direciona oCognos TM1 para salvar as mudanças no servidor selecionado.

v Um administrador escolhe Arquivo, Salvar Todos os Dados no Server Explorer.Isto direciona o Cognos TM1 para salvar as mudanças em todos os servidoresconectados, se você tiver a autoridade adequada.

v Um usuário salva as atualizações de lote.

Escolha o caminho para seu diretório de dados quando instalar o Cognos TM1 .

Tabela 12. Caminhos de Diretório de Dados Padrão

Diretório de Dados Caminho Padrão

Servidor local do Cognos TM1 installation_location\custom\tm1data\pdata

Servidor remoto Windows do Cognos TM1para dados de amostra

installation_location\custom\tm1data\sdata


Tabela 12. Caminhos de Diretório de Dados Padrão (continuação)

Diretório de Dados Caminho Padrão

Servidor UNIX do Cognos TM1 installation_location/custom/tm1data/sdata

Acesso à Rede NecessárioA capacidade do cliente de salvar dados é determinada pelo esquema de segurançado IBM Cognos TM1 .

Para obter informações, consulte o IBM CognosTM1 Developer Guide.

Importante: Torne este diretório visível somente para administradores e para ologin que é usado pelo servidor.

Diversos Diretórios de DadosÉ possível especificar que você quer que o IBM Cognos TM1 use diversosdiretórios de dados separando os nomes de diretórios com pontos e vírgulas.Quando você especifica diversos diretórios de dados, o Cognos TM1 faz oseguinte.v Acessa cubos e dimensões a partir de cada um dos diretórios especificados. Se

há um objeto duplicado, o Cognos TM1 acessa o objeto a partir do primeirodiretório especificado.

v Grava mudanças no diretório onde o objeto está localizado. Quando você criaum novo objeto, o Cognos TM1 grava no primeiro diretório que vocêespecificou.

Por exemplo, suponha que você queira armazenar dimensões em um diretóriochamado tm1dims, e os cubos em um diretório chamado tm1cubes. Vocêespecificaria o seguinte no arquivo Tm1s.cfg:DatabaseDirectory="c:\tm1dims;c:\tm1cubes"

Concatenando os dois diretórios, é possível acessar estes objetos por meio doServer Explorer, como se eles estivessem em um único local.

Local do Diretório de DadosEspecifique o local do diretório de dados de forma diferente para servidores locaise remotos.v Para um servidor local, especifique o local do diretório de dados, nomeando este

diretório no parâmetro DataBaseDirectory do arquivo Tm1p.ini.É possível alterar o arquivo the.ini usando o menu Opções do IBM Cognos TM1no Server Explorer.Para obter informações adicionais, consulte Apêndice C, “O Arquivo deConfiguração do Cliente Tm1p.ini”, na página 275.

v Para um servidor remoto, especifique o local do diretório de dados usando oparâmetro DatabaseDirectory no arquivo Tm1s.cfg ou o parâmetro da linha decomandos -d ao ativar o servidor.

Para obter informações sobre parâmetros do servidor, consulte Apêndice B, “OArquivo de Configuração do Servidor Tm1s.cfg”, na página 231.


Um servidor remoto deve poder reconhecer a unidade na qual o diretório dedados reside. Se o diretório estiver em uma unidade remota, será necessáriomapear essa unidade para uma letra de unidade local.

Dica: Ao acessar um servidor remoto, você não precisa mapear a unidade onde odiretório de dados do servidor reside.

Se você não especificar o local do diretório de dados, o servidor Cognos TM1 nãopoderá iniciar e a seguinte mensagem de erro será exibida.Data Directory not specified. Aborting server startup.

Arquitetura do Cognos TM1 WebO IBM Cognos TM1 Web usa uma arquitetura com multicamadas que permite aosusuários acessar e interagir com os dados do Cognos TM1 usando qualquernavegador da Web suportado.

A arquitetura com multicamadas do IBM Cognos TM1 Web inclui Web client,servidor de aplicativos da Web e camadas do componente de dados.

Camada 1: Web Clients

A camada do Web clients permite que usuários acessem e interajam com os dadosdo Cognos TM1 usando qualquer um dos navegadores da Web suportados. Osusuários podem trabalhar com cubos do Cognos TM1 e com planilhas da Web doCognos TM1.

Visite Ambientes do Software do Cognos TM1 (https://www-304.ibm.com/support/docview.wss?rs=3446&uid=swg27014444) para navegadores da Websuportados atualmente.

Figura 3. Diagrama da Visão Geral da Arquitetura do Cognos TM1 Web


https://www-304.ibm.com/support/docview.wss?rs=3446&uid=swg27014444

Camada 2: Servidor de Aplicativos da Web

O Cognos TM1 Web é executado em um servidor da Web do Microsoft InternetInformation Services (IIS) e requer o Microsoft .NET Framework.

Configure o servidor da Web Microsoft IIS com o seguinte:v Diretórios Virtuais necessários para armazenar scripts e outros arquivos

relacionados do Cognos TM1 Web ASP.v Versão suportada do Microsoft .NET Framework instalada.v Versão suportada do Microsoft Chart Controls para .NET Framework.v Opcional - Versão suportada do Microsoft Excel instalado. Este software é

necessário para gerar o Cognos TM1 Websheets.

Esta camada deve incluir também o Cognos TM1 Excel Service em execução comoum serviço do Windows no servidor da Web. O Cognos TM1 Excel Service fornecesuporte para a conversão e a exibição de planilhas do Microsoft Excel como oCognos TM1 Websheets. Esse serviço também exporta Websheets de volta para osformatos Microsoft Excel e PDF.

Ao instalar o Cognos TM1 Web, o programa de instalação, instala o Cognos TM1Excel Service (TM1ExcelService.exe) como um serviço do Windows no servidor daWeb.

Camada 3: Dados

Esta camada inclui o Servidor Administrativo do Cognos TM1 e pelo menos umServidor Cognos TM1.

Servidor Administrativo do IBM CognosTM1

O Servidor Administrativo do Cognos TM1 pode ser instalado em qualquercomputador na LAN, mas deve residir no mesmo segmento da LAN que oServidor Cognos TM1. Normalmente, o Servidor Cognos TM1 e o ServidorAdministrativo do Cognos TM1 são instalados no mesmo computador.

Servidor IBM Cognos TM1

O Servidor Cognos TM1pode ser instalado no mesmo computador que hospeda oservidor da Web, mas instalá-lo em um computador separado é mais eficiente.

A versão do Cognos TM1 usada em seu ambiente do Cognos TM1 Web deve serigual ou mais recente do que a versão do Cognos TM1 Web que está sendoexecuta. Se a versão do Cognos TM1 Web que está sendo executada for maisrecente do que a versão do Servidor Cognos TM1, os usuários receberão um erroao tentar efetuar login no Cognos TM1 Web.

Acessando diversos Cognos TM1 Servers do Cognos TM1Web

O IBM CognosTM1 Web fornece suporte de diversos bancos de dados, permitindoque usuários acessem diversos servidores Cognos TM1 registrados no mesmoServidor Administrativo do Cognos TM1 e em que usuários possuem a mesmacombinação de nome de usuário e senha.


Ao efetuar login, o Cognos TM1 Web exibe a área de janela de Navegação para oservidor principal selecionado na tela de login. No entanto, se a combinação de seunome de usuário e senha corresponder a outros servidores do Cognos TM1registrados no mesmo Servidor Administrativo do Cognos TM1, o IBM CognosTM1 Web efetuará seu login automaticamente nesses outros servidores em umabase conforme necessário. Este comportamento é diferente do Cognos TM1Architect e do Cognos TM1 Perspectives nos quais é necessário efetuar login emoutros servidores do Cognos TM1 como uma etapa manual, separada.

O suporte de diversos bancos de dados aplica-se principalmente às planilhas daWeb porque elas contêm fórmulas e referências do Cognos TM1 que apontam paraoutros servidores do Cognos TM1 . Por exemplo, se abrir uma planilha da Webque contém referências do Cognos TM1 para outros servidores registrados nomesmo Servidor Administrativo, o Cognos TM1 Web tentará efetuar login nesteoutro servidor usando nome de usuário e senha atuais.

Limitando o Acesso a um Único Cognos TM1 Server doCognos TM1 Web

Se você desejar impedir que os usuários do IBM CognosTM1 Web usem o suportede diversos bancos de dados para acessar outros servidores do Cognos TM1 nomesmo Servidor Administrativo, será possível usar um Servidor Administrativodiferente para registrar cada servidor do Cognos TM1 .

Por exemplo, com esta configuração, se efetuar login no Cognos TM1 Web e tentarabrir uma planilha da Web que faz referências a outro servidor do Cognos TM1registrado em um Servidor Administrativo diferente, os dados não serão exibidosainda que você tenha o mesmo nome de usuário e senha desse servidor.

Dica: Se você configurar os servidores do Cognos TM1 para serem executados emServidores Administrativos separados, mas ainda desejar acessá-los a partir doCognos TM1 Web, do Cognos TM1 Architect ou do Cognos TM1 Perspectives ,será possível usar o parâmetro AdminHost. Este parâmetro permite especificardiversos Hosts Administrativos, para que usuários possam acessar os servidores doCognos TM1 registrados com os Servidores Administrativos nos hostsespecificados.v Para obter informações sobre como configurar o IBM Cognos TM1 Web para

acessar diversos Servidores Administrativos, consulte "Configurando a Página deLogin Usando o AdminHostName e o TM1ServerName” no Guia de Operações doIBM Cognos TM1.

v Para obter informações sobre como configurar o Cognos TM1 Architect e oCognos TM1 Perspectives para acessarem diversos Admin Servers, consulte“Especificando diversos Cognos TM1 Admin Hosts” na página 76.

Arquitetura do Cognos TM1 ApplicationsO IBM Cognos TM1 Applications possui uma arquitetura com multicamadas queconsiste em três camadas: web clients, servidores de aplicativos da web e dados.

O diagrama a seguir mostra a arquitetura com multicamadas e os caminhos decomunicação básicos para todos os componentes Cognos TM1 Applications.


As linhas no diagrama de arquitetura do Cognos TM1 Applications são destinadasprincipalmente a mostrar os caminhos de comunicação típicos requeridos para astarefas gerenciadas pelo Cognos TM1 Application Server, tal como controlar osestados do fluxo de trabalho.

Além das linhas de comunicação, o Cognos TM1 Performance Modeler e o CognosInsight também requerem conexão direta com o Cognos TM1 Server subjacente otempo todo. Como exceção, durante o uso do Cognos Insight no modo Distribuído,ele não requer conexão constante com o Cognos TM1 Server.

Camada 1 do Cognos TM1 Applications: Web ClientsA camada do web clients contém todas as interfaces com o usuário para o IBMCognos TM1 Applications. Estas interfaces com o usuário são usadas por usuáriosfinais, administradores e desenvolvedores de aplicativos de planejamento.

Cognos TM1 Applications

O cliente Cognos TM1 Applications principal é uma interface com o usuáriobaseada em navegador da web suportada por um servidor de aplicativos da webbaseado em Java, tal como o IBM WebSphere ou a instalação fornecida do ApacheTomcat. As interfaces com o usuário para o Cognos TM1 Applications sãoorganizadas em duas subpáginas principais e três clientes de contribuição dedados diferentes.

Página do Cognos TM1 Applications

A página do Cognos TM1 Applications (página de portal) é o principal ponto deinício para ambos os usuários, administradores e não administradores. Esta páginafornece uma lista de aplicativos disponíveis que são filtrados para o usuário atual.Clicar em um aplicativo nesta página abre a página do fluxo de trabalho.

Figura 4. Diagrama de Visão Geral da Arquitetura do Cognos TM1 Applications


Os administradores e desenvolvedores de aplicativos também podem abrir oCognos TM1 Performance Modeler e o Cognos Insight a partir da barra deferramentas do Cognos TM1 Applications.

Página do Cognos TM1 Application

A página do Cognos TM1 Application (página do fluxo de trabalho) permitegerenciar tarefas dentro de um único aplicativo. Esse cliente exibe cada nó com oqual um usuário é responsável por contribuir e/ou revisar em um plano específico.Dependendo de como você configurar o aplicativo, o usuário poderá abrir o clienteCognos Insight ou o cliente Cognos TM1 Application Web para qualquer nóacessível neste cliente.

Clientes de Contribuição de Dados

A tabela a seguir resume os clientes de contribuição de dados do Cognos TM1Applications que permitem que os usuários trabalhem com dados nos formatos degrade e de gráfico.

Tabela 13. Cognos TM1 Applications - Clientes de Contribuição de Dados

Clientes Descrição

IBM Cognos TM1Application Web

Cliente padrão. O processamento é em tempo real com oservidor. Permite que os usuários visualizem e editem dados doaplicativo em um formato de grade usando visualizações docubo do Cognos TM1 ou Planilhas da Web do TM1 baseadas nainfraestrutura do Cognos TM1 Web

Esta interface com o usuário requer um servidor da web queexecuta componentes do Cognos TM1 Web com o MicrosoftInternet Information Services (IIS).

IBM Cognos Insight -Conectado

Cliente IBM Cognos Insight. O processamento é em tempo realcom o servidor. Permite que os usuários visualizem e editemdados do aplicativo em um formato de painel ou de área detrabalho.

Este cliente pode ser fornecido e instalado a partir do CognosTM1 Application Gateway ou instalado remotamente por umadministrador do sistema usando uma linha de comandos doWindows Installer e outras ferramentas de gerenciamento desoftware.

IBM Cognos Insight -Distribuído

Cliente IBM Cognos Insight com processamento local de dados.Os dados são atualizados no servidor somente quando umaação de confirmação de dados é executada.

As mesmas opções de fornecimento e instalação que o clienteCognos Insight - Conectado.

Cognos TM1 Performance Modeler

O cliente Cognos TM1 Performance Modeler fornece a interface com o usuáriopara administradores e desenvolvedores para projetar e implementar aplicativos.

Esta interface com o usuário deve ser instalada localmente no computador dousuário. Os usuários podem fornecer e instalar este cliente a partir do Cognos TM1Application Gateway na primeira vez em que eles abrem o cliente. Osadministradores do sistema também podem distribuir e instalar o programa


remotamente usando o Windows Installer e outras ferramentas de gerenciamentode software. Para obter detalhes, consulte “Instalando o Cognos TM1 PerformanceModeler” na página 104.

Cognos Insight

Cognos Insight pode ser executado separado do Cognos TM1 Applications parapermitir que os usuários criem áreas de trabalho para usarem dentro do aplicativo.

Esta interface com o usuário deve ser instalada localmente no computador dousuário. Ela pode ser fornecida a partir do Cognos TM1 Application Gateway einstalada pelo usuário na primeira vez em que ele abrir o cliente. Osadministradores do sistema também podem distribuir e instalar o programaremotamente usando uma linha de comandos do Windows Installer e outrasferramentas de gerenciamento de software. Para obter detalhes, consulte“Instalando o Cognos Insight” na página 108.

Camada 2 do Cognos TM1 Applications: Servidores da WebA camada de servidores da web contém dois servidores da web; um servidor deaplicativos da web baseado em Java necessário e um servidor da web MicrosoftInternet Information Services (IIS) opcional. O Microsoft IIS é necessário somentese você planeja usar o cliente IBM Cognos TM1 Application Web.

Servidor de Aplicativos da Web Java

O Cognos TM1 Application Server e o Gateway são executados em um servidor deaplicativos da web baseado em Java. É possível usar a versão do Apache Tomcatque é fornecida com a instalação ou sua própria instalação de um dos servidoresde aplicativos da web baseados em Java suportados.

Se você usar o Cognos TM1 Applications com um Cognos TM1 Server que estáusando a segurança do IBM Cognos, será possível implementar o Cognos TM1Application Server com o servidor da web Apache Tomcat que é fornecido com oIBM Cognos. Para obter detalhes, consulte “Usando o Cognos TM1 Applicationscom a Segurança do Cognos Business Intelligence” na página 162.

Servidor da Web Microsoft IIS

O Microsoft Internet Information Services (IIS) é necessário para suportar o clienteCognos TM1 Application Web. O cliente Cognos TM1 Application Web é umainterface com o usuário baseada na tecnologia do Cognos TM1 Web para visualizare editar dados do aplicativo. Para obter detalhes adicionais, consulte“Configurando o Cognos TM1 Applications com o Microsoft IIS” na página 167.

Camada 3 do Cognos TM1 Applications: DadosA camada de dados para o IBM Cognos TM1 Applications inclui o IBM CognosTM1 Admin Server e um ou mais servidores IBM Cognos TM1 em execução emum sistema baseado em Microsoft Windows ou UNIX. O Cognos TM1 ApplicationServer e as interfaces do cliente relacionadas se comunicam com os componentesna camada de dados para acessar os dados do Cognos TM1.

Cognos TM1 Admin Server

O Cognos TM1 Admin Server é um processo que controla todos os servidoresCognos TM1 em execução em uma rede. O Cognos TM1 Application Server se


comunica com o Cognos TM1 Admin Server para determinar quais servidoresCognos TM1 estão disponíveis na rede.

Cognos TM1 Server

O Cognos TM1 Server contém os dados para os aplicativos que você constrói eimplementa com o Cognos TM1 Applications.



Capítulo 4. Transporte

Esta seção descreve alguns dos cenários típicos de instalação e implementação paraos componentes do IBM Cognos TM1 disponíveis. Usar esta seção ajuda a planejara instalação e a configuração do Cognos TM1 em ambientes operacionais diferentese maximizar seu desempenho.

É possível instalar e implementar componentes em um único computador ou emdiversos computadores em um ambiente em rede.

Para cada componente que deseja instalar em um computador diferente, execute oAssistente de Instalação do Cognos TM1 nesse computador.

Componentes do servidor

É possível instalar os seguintes componentes do servidor em computadoresdedicados separados:v Cognos TM1 Admin Server e Cognos TM1 Serverv Cognos TM1 Webv Cognos TM1 Application Server

Componentes do Cliente

É possível instalar os seguintes componentes do cliente em diversos computadores:v Cognos TM1 Perspectivesv Cognos TM1 Architectv Cognos TM1 Performance Modelerv Cognos Insight

Implementando o Cognos TM1 em um Único Computador WindowsA instalação de componentes do IBM Cognos TM1 em um computador que estáexecutando o Microsoft Windows é uma abordagem prática para ambientes deprova de conceito, teste, demonstração, desenvolvimento e treinamento.

É possível usar o programa de instalação do Cognos TM1 de 32 bits ou 64 bitspara Windows.

A instalação em um único computador Windows é destinada principalmente paraum único usuário em um dos sistemas operacionais Windows de 32 bits ou 64 bitssuportados. Por exemplo, o Microsoft Windows XP, Windows Vista ou Windows 7.No entanto, estes não são sistemas operacionais no nível de produção de classe doservidor e este tipo de implementação deve ser usado somente para uso individuale não em um ambiente de produção com diversos usuários.

Instalação Típica de Computador Único

Uma instalação típica do Cognos TM1 em um único computador Windows incluios seguintes componentes:

Camada do Aplicativo


v Cognos TM1 Admin serverv Cognos TM1 Serverv Cognos TM1 Tools

Camada do Aplicativo da Web

v Cognos TM1 Application Gatewayv Cognos TM1 Application Serverv Cognos TM1 Webv Cognos TM1 Operations Console

Camada do Cliente

v Cognos TM1 Perspectivesv Cognos Insightv Cognos TM1 APIs

Camada do Desenvolvedor

v Cognos TM1 Architectv Cognos TM1 Performance Modeler

AmostrasBancos de dados de amostras para Cognos TM1 e Cognos TM1Applications

É possível ajustar quais componentes você instala com base em suas necessidadesespecíficas.

Diferenças de Implementação Entre Instalações de 64 bits e 32bits

Nem todos os componentes Cognos TM1 estão disponíveis para sistemas de 64bits. Se o componente estiver disponível como uma instalação de 64 bits, odiretório de instalação padrão será diferente do diretório de instalação padrão queé usado em uma instalação de 32 bits.

Implementando o Cognos TM1 Admin Server e o TM1 ServerÉ possível instalar os componentes IBM Cognos TM1 Admin Server e Cognos TM1Server em um computador Microsoft Windows e UNIX separado em seu ambientede hardware.

Para cada componente que deseja instalar em um computador diferente, execute oAssistente de Instalação do Cognos TM1 nesse computador.

É possível instalar o Cognos TM1 Admin Server no mesmo computador no qual oCognos TM1 Server está instalado ou em um outro computador em sua rede.

Quando um servidor Cognos TM1 está em execução, ele se registra no AdminServer especificado. Os clientes Cognos TM1, em seguida, se conectam a estemesmo Admin Server para obter informações sobre servidores Cognos TM1disponíveis em uma rede.

Se você distribuir os componentes do servidor por toda sua rede, deverá conhecerdeterminadas informações sobre onde seus componentes serão instalados e aconfiguração desses componentes. A lista a seguir fornece as informações que vocêprecisa saber para instalar cada componente.


Componente Descrição

Cognos TM1 Server Para instalar e configurar o servidor Cognos TM1, você devesaber o nome do computador no qual o Cognos TM1 AdminServer está em execução.

Cognos TM1 AdminServer

Ele pode ser instalado sem nenhum conhecimento da topologia derede.

Notas Importantes sobre Instalações Distribuídasv Todos os serviços devem estar em execução em uma única conta de domínio. O

Assistente de Instalação do Cognos TM1 configura os parâmetros da conta dedomínio para você, mas você deve criar a conta sob a qual os serviços sãoexecutados antes de executar a instalação. Se os serviços estiverem em execuçãoem contas diferentes, eles não poderão se comunicar uns com os outros.

v Os serviços do Cognos TM1 devem ser executados em computadoresconfigurados com o mesmo código de idioma. Não é possível, por exemplo,instalar alguns serviços em um computador que executa o código de idiomainglês dos EUA e outros serviços em um computador que executa o código deidioma alemão. Configure o código de idioma usando a opção Padrões eFormatos no Menu Iniciar, Configurações Regionais e Locais do MicrosoftWindows.

Implementando o Cognos TM1 WebDependendo dos seus requisitos, é possível implementar o IBM Cognos TM1 Webde inúmeras maneiras diferentes.

A forma como você implementa o Cognos TM1 Web depende de como vocêpretende usar o componente. Os cenários de implementação típicos incluem:v Como a interface com o usuário baseada na web que permite que os usuários

acessem dados do Cognos TM1 usando um navegador da web.Para obter detalhes, consulte “Arquitetura do Cognos TM1 Web” na página 29 eCapítulo 8, “Instalação do Cognos TM1 Web”, na página 77.

v Para suportar o cliente IBM Cognos TM1 Application Web no IBM Cognos TM1Applications.O cliente Cognos TM1 Application Web usa a infraestrutura do Cognos TM1Web. Para obter detalhes, consulte “Arquitetura do Cognos TM1 Applications”na página 31 e Capítulo 9, “Instalação do Cognos TM1 Applications”, na página83.

v Para suportar a interoperabilidade com os componentes do IBM CognosBusiness Intelligence (BI), como Cognos TM1 Viewer Portlets e iWidgets.Para obter detalhes, consulte Capítulo 14, “Instalação de Interoperabilidade doCognos TM1 e do Cognos Business Intelligence”, na página 139.

Implementando o Cognos TM1 ApplicationsDependendo de seu ambiente de rede e de suas necessidades de negóciosespecíficos, é possível instalar o IBM Cognos TM1 Applications em um únicocomputador ou distribuir os componentes para computadores separados em umarede.

Capítulo 4. Transporte 39

Considerações de Segurança para Cognos TM1 ApplicationsÉ possível usar a autenticação de segurança padrão do IBM Cognos TM1 ou asegurança doIBM Cognos para os Cognos TM1 Servers usados com Cognos TM1Applications.

Não use uma combinação de diferentes modos de autenticação de segurança paraa mesma instalação do Cognos TM1 Applications.

Determine o modo de segurança antes de configurar o Cognos TM1 Applicationspara usar um servidor Cognos TM1 e use esse mesmo modo de segurança comquaisquer servidores adicionais incluídos.

Para obter detalhes sobre o uso de segurança do Cognos, consulte “Usando oCognos TM1 Applications com a Segurança do Cognos Business Intelligence” napágina 162.

Usando o Parâmetro IntegratedSecurityMode com Cognos TM1Applications

Para configurar o modo de autenticação de segurança do Cognos TM1, use oparâmetro IntegratedSecurityMode no arquivo Tm1s.cfg de cada servidor CognosTM1 que deseja usar.

Importante: O componente Cognos TM1 Applications é compatível somente comos modos de autenticação de segurança do Cognos TM1 1 e 5.

Por exemplo, para usar a autenticação de segurança padrão do Cognos TM1,configure o parâmetro IntegratedSecurityMode como 1 para cada servidor.

IntegratedSecurityMode=1

Para usar segurança do IBM Cognos, configure o parâmetroIntegratedSecurityMode como 5.


Para obter mais detalhes sobre o parâmetro IntegratedSecurityMode, consulte aseção "Configuração do Sistema TM1" no Guia de Operações do IBM Cognos TM1.

Configurando a Segurança de Cognos TM1 Applications paradiversos Cognos TM1 Servers

Se quiser usar diversos servidores Cognos TM1 com Cognos TM1 Applications,todos eles deverão ser configurados para usar a mesma autenticação de segurança(autenticação padrão Cognos TM1 ou segurança do Cognos) e incluir o mesmonome de usuário administrador e senha.

Para obter detalhes adicionais, consulte “Configurando o Cognos TM1 Applicationspara Usar Diversos Cognos TM1 Servers” na página 167.

Implementando Todos os Componentes Cognos TM1Applications em um Único Computador

Para propósitos de desenvolvimento, teste ou demonstração, talvez você desejeinstalar todos os componentes necessários para o IBM Cognos TM1 Applicationsem um único computador que executa o Microsoft Windows.


Programa de Instalação

A implementação do Cognos TM1 Applications em um único computador é amaneira mais rápida de instalar e executar o programa.

Use o programa de instalação do Cognos TM1 de 32 ou 64 bits para Windows parainstalar o Cognos TM1 Applications em um único computador baseado noWindows.

Componentes Cognos TM1 Necessários

Os componentes a seguir são necessários para implementar e executar o CognosTM1 Applications em um único computador baseado no Windows.v Cognos TM1 Admin Serverv Cognos TM1 Serverv Cognos TM1 Application Serverv Cognos TM1 Application Gatewayv Cognos TM1 Webv Banco de dados de Amostras do Cognos TM1 (opcional) - Permite executar

facilmente um servidor Cognos TM1 de amostra para propósitos de teste.

Por padrão, a ferramenta Cognos Configuration é necessária e instaladaautomaticamente com esta configuração. Após concluir a instalação, use o CognosConfiguration para implementar e iniciar o Cognos TM1 Application Server egerenciar seus servidores Cognos TM1.

Uma versão do servidor de aplicativos da web Apache Tomcat também é instaladaautomaticamente para uso com o Cognos TM1 Applications.

O Cognos TM1 Web é necessário se você planeja usar o cliente Cognos TM1Applications Web.

Servidores de Aplicativos da Web Necessários

O Cognos TM1 Applications requer um servidor de aplicativos da web baseado emJava e uma instância opcional do servidor da web Microsoft Internet InformationServices (IIS).

É possível implementar o Cognos TM1 Applications em um dos seguintesservidores de aplicativos da web baseados em Java:v Use a versão do Tomcat que é fornecida com a instalação.v Use sua própria instância do Tomcatv Use sua própria instância do IBM Websphere

Opcionalmente, uma instância do servidor da web Microsoft IIS também énecessária se você planeja usar o cliente Cognos TM1 Applications Web que ésuportado pela infraestrutura do Cognos TM1 Web e do IIS.

Dica: Para implementar a instalação mais rápida e mais típica em um únicocomputador, use o servidor de aplicativos da web Apache Tomcat fornecido comsua própria instância do Microsoft IIS.


Implementando os Componentes Cognos TM1 Applicationsem Computadores Separados

A implementação de alguns ou todos os componentes IBM Cognos TM1Applications em computadores dedicados separados pode melhorar odesempenho, a disponibilidade e a capacidade.

Dependendo de seu ambiente de rede e de suas necessidades de negócios, épossível distribuir a camada de servidores de aplicativos da web e a camada dedados em diversos computadores de várias maneiras diferentes.

Implementar a Camada de Servidores de Aplicativos da Web e aCamada de Dados em Computadores Separados.

Esta configuração combina o servidor de aplicativos da web Java e o MicrosoftInternet Information Services (IIS) no mesmo computador, mas coloca a camada dedados do servidor Cognos TM1 em um computador separado.

Implementar Servidores de Aplicativos da Web emComputadores Separados

Esta configuração coloca o servidor de aplicativos da web Java e o Microsoft IISem seus próprios computadores. A camada de dados também poderia ser instaladaem um destes computadores ou em seu próprio computador dedicado.

Implementar Todos os Componentes em ComputadoresSeparados

Esta configuração coloca o servidor de aplicativos da web Java, o Microsoft IIS, oCognos TM1 Admin Server e o(s) servidor(es) Cognos TM1 todos emcomputadores separados.

Lista de Verificação para Implementar o Cognos TM1Applications

Use a lista de verificação a seguir para ajudá-lo a instalar o IBM Cognos TM1Application Server e os componentes relacionados em computadores separados.

Tabela 14. Lista de Verificação para Implementar os Componentes IBM Cognos TM1Applications em Computadores Separados

Cenário de Instalação Etapas de Instalação

Executando seu servidor deaplicativos da web Java em umcomputador separado

Use o programa de instalação Cognos TM1 para instalaro Cognos TM1 Application Server e o Cognos TM1Application Gateway no computador que executa oservidor de aplicativos Java.

Executando o Microsoft IIS emum computador separado

Use o programa de instalação do Cognos TM1 parainstalar o Cognos TM1 Web no computador que executao IIS.

O Assistente de Instalação instala os arquivos necessáriospara o cliente Cognos TM1 Application Web - uma dasinterfaces do cliente para visualizar e editar dados doaplicativo.

Para obter detalhes, consulte “Configurando o CognosTM1 Applications com o Microsoft IIS” na página 167.


Tabela 14. Lista de Verificação para Implementar os Componentes IBM Cognos TM1Applications em Computadores Separados (continuação)

Cenário de Instalação Etapas de Instalação

Executando a camada de dadosem um computador separado

Use o programa de instalação do TM1 para instalar oscomponentes TM1 Admin Server e TM1 Server nessecomputador.

Para obter informações adicionais, consulte“Implementando o Cognos TM1 Admin Server e o TM1Server” na página 38

Implementando Aplicativos Clientes do Cognos TM1Esta seção descreve como implementar os diferentes clientes IBM Cognos TM1(interfaces com o usuário) em seu ambiente de rede.

Os diferentes clientes Cognos TM1 incluem:v Cognos TM1 Perspectivesv Cognos TM1 Architectv Cognos TM1 Performance Modelerv Cognos Insightv Cognos TM1 Web (usando uma URL/um link da web)v Cognos TM1 Applications (usando uma URL/um link da web)

Implementando o Cognos TM1 com Cognos Business IntelligenceHá inúmeras maneiras diferentes para você integrar o IBM Cognos TM1 ao IBMCognos Business Intelligence (BI). Esse tópico resume algumas das abordagens deintegração mais típicas e inclui links para informações relacionadas.

As principais opções para integrar o Cognos TM1 ao Cognos BI incluem segurança,acesso a dados e interação de dados. A configuração de integração entre CognosTM1 e Cognos BI envolve uma combinação de tarefas de instalação e configuraçãonos computadores hospedando o servidor e os componentes de servidor da Web.Em alguns casos, a instalação e a configuração são necessárias em computadoresde usuários finais individuais.

Implementando o Cognos TM1 para Usar Segurança do CognosBI

É possível configurar o servidor Cognos TM1 para autenticar usuários usandosegurança do Cognos BI. Com essa configuração, qualquer interface com o usuáriodo Cognos TM1 ou outro aplicativo customizado deve usar um nome de usuário euma senha válidos do servidor Cognos BI para acessar dados do Cognos TM1.Também é possível configurar o IBM Cognos TM1 Applications para usarsegurança do Cognos BI.

Para obter detalhes, consulte os seguintes tópicos:v “Usando a Segurança do Cognos com o Cognos TM1 ” na página 197v “Usando o Cognos TM1 Applications com a Segurança do Cognos Business

Intelligence” na página 162


Implementando o Cognos TM1 Package Connector para ImportarDados do Cognos BI no Cognos TM1

O IBM Cognos TM1 Package Connector é atualmente suportado para uso compacotes IBM Cognos Business Intelligence com relação ao SAP Business Warehousee outras origens de dados ODBC e relacionais. É possível usar o Cognos TM1Package Connector para importar dados dessas origens no Cognos TM1 usandoum processo do Cognos TM1 TurboIntegrator.

O IBM Cognos TM1 Package Connector é um componente opcional, separado dainstalação principal do TM1, disponível como seu próprio CD ou download. Essecomponente deve ser instalado no TM1 Server e máquinas do clienteadministrativo onde os processos do TurboIntegrator estão sendo criados comrelação a um pacote BW.

Para obter mais detalhes, consulte a documentação a seguir:v Consulte Capítulo 15, “Instalação do Cognos TM1 Package Connector”, na

página 143 para obter instruções de instalação.v Consulte o capítulo "Importando Dados Usando o IBM Cognos TM1 Package

Connector" no IBM Cognos TM1 TurboIntegrator Guide para obter maisinformações sobre o uso do TM1 Package Connector.

v Consulte as seguinte fontes:Centro de Informações do IBM Cognos Business Intelligence 10.1.0(http://publib.boulder.ibm.com/infocenter/cbi/v10r1m0/index.jsp)Centro de Informações do IBM Cognos Business Intelligence 10.1.1(http://publib.boulder.ibm.com/infocenter/cbi/v10r1m1/index.jsp)– Consulte o link Hardware e Software Suportados para obter detalhes

específicos sobre o software suportado.– Consulte IBM Cognos Framework Manager User Guide sobre a criação de

pacotes.v Consulte a documentação do SAP para tópicos relacionados ao SAP.

Implementando Cognos TM1 como uma Origem de Dados comCognos BI

É possível configurar IBM Cognos BI para acessar cubos e servidores Cognos TM1a partir do Cognos Report Studio e do Cognos Query Studio.

Para ativar o relatório do Cognos BI com relação às origens de dados do CognosTM1, use o programa de instalação do Cognos TM1 Client para instalar osarquivos de API necessários do Cognos TM1 em todos os servidores Cognos BIque estão executando serviços de relatórios no Microsoft Windows

Para obter mais detalhes, consulte a documentação a seguir:v Consulte “Ativando Relatório do Cognos BI em Origens de Dados do Cognos

TM1” na página 141 para obter instruções de instalação.v Consulte o tópico a seguir em um dos seguintes Centros de Informações do IBM

Cognos:Guia de Administração e Segurança do IBM Cognos Business Intelligence > Origensde Dados e Conexões > TM1 Data SourceCentro de Informações do IBM Cognos Business Intelligence 10.1.0(http://publib.boulder.ibm.com/infocenter/cbi/v10r1m0/index.jsp)


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



Centro de Informações do IBM Cognos Business Intelligence 10.1.1(http://publib.boulder.ibm.com/infocenter/cbi/v10r1m1/index.jsp)

v Consulte a seguinte Nota Técnica da IBM:Não é possível se conectar ao TM1 do C10: TM1-ERR-050 Falha na tentativa deinicializar o TM1 API... (http://www-01.ibm.com/support/docview.wss?uid=swg21474468).

Implementando Cognos TM1 para Usar como Widgets e ViewerPortlets no Cognos BI

É possível usar o programa de instalação de interoperabilidade do IBM CognosTM1 BI para suportar a seguinte funcionalidade:v Use IBM Cognos Business Insight para acessar e visualizar dados do Cognos

TM1 como widgets em um painel do Cognos Business Insight.v Use IBM Cognos Connection com Cognos TM1 Viewer Portlets para acessar

websheets e visualizações de cubo do TM1.v Forneça links para Cognos TM1 Applications do Cognos BI.

Para obter mais detalhes, consulte a documentação a seguir:v Consulte Capítulo 14, “Instalação de Interoperabilidade do Cognos TM1 e do

Cognos Business Intelligence”, na página 139 para obter instruções de instalação.v Consulte os seguintes tópicos em um dos seguintes Centros de Informações do

IBM Cognos:Centro de Informações do IBM Cognos Business Intelligence 10.1.0(http://publib.boulder.ibm.com/infocenter/cbi/v10r1m0/index.jsp)Centro de Informações do IBM Cognos Business Intelligence 10.1.1(http://publib.boulder.ibm.com/infocenter/cbi/v10r1m1/index.jsp)– Guia de Instalação e Configuração do IBM Cognos Business Intelligence > Opções

de Configuração > Configurando IBM Cognos Business Insight >Configurando IBM Cognos Business Insight para Usar Conteúdo de um TM1Data Server

– Guia de Instalação e Configuração do IBM Cognos Business Intelligence > Opçõesde Configuração > Configurando IBM Cognos Business Insight >Configurando IBM Cognos Business Insight para Acessar IBM Cognos TM1Contributor

– Guia de Administração e Segurança do IBM Cognos Business Intelligence > Origensde Dados e Conexões > TM1 Data Sources

– Guia do Usuário do IBM Cognos Business Insight > Criando Paineis > IncluindoConteúdo do IBM Cognos > Conteúdo do TM1



http://www-01.ibm.com/support/docview.wss?uid=swg21474468





Capítulo 5. Fazendo Upgrade

O upgrade de uma versão anterior do IBM Cognos TM1 para a versão mais novadeve ser considerado um processo executado em estágios.

Deve-se considerar a atualização um projeto de TI que requer planejamentocuidadoso, tempo adequado e recursos.

O upgrade para o Cognos TM1 10.1 a partir da versão 9.0.x, 9.1.x ou 9.5.x requeruma desinstalação manual completa e depois uma instalação completa do 10.1.

Nota: Os bancos de dados do TM1 9.0.x e 9.1.x são convertidos automaticamenteem Unicode quando eles são abertos (iniciados) com um servidor TM1 versão 9.4ou superior. Após um banco de dados do TM1 mais antigo ser convertido emUnicode, ele não poderá mais ser aberto nas versões anteriores do TM1.

Processo de Upgrade

Quando você fizer upgrade, execute várias atividades distintas:1. Parar todos os serviços relacionados.2. Fazer backup de seus dados e aplicativos existentes.3. Remover a versão anterior do produto.4. Instalar a nova versão do produto.5. Restaurar seus dados, definições de configuração e aplicativos com a nova

versão do produto.

Planejando o UpgradeAs etapas para o upgrade de uma instalação existente do IBM Cognos TM1dependem dos componentes do Cognos TM1 que você usa atualmente e que foramimplementados.

São necessárias etapas adicionais se você também estiver fazendo upgrade de umaversão anterior do Cognos TM1 Contributor para o Cognos TM1 Applications.

Antes do Upgrade

Revise as considerações a seguir antes do upgrade.

Cognos TM1 Admin ServerA partir do IBM Cognos TM1 versão 10.1.0, o arquivo de configuração doTM1 Admin Server, Tm1admsrv.ini, não é mais usado ou suportado peloCognos TM1. Você deve usar o Cognos Configuration para configurar oCognos TM1 Admin Server.

Cognos TM1 Server

v Os bancos de dados do TM1 9.0.x e 9.1.x são convertidosautomaticamente em Unicode quando abertos (iniciados) com umCognos TM1 Server versão 9.4 ou superior. Após um banco de dados doTM1 mais antigo ser convertido em Unicode, ele não poderá mais seraberto nas versões anteriores do TM1.


v No IBM Cognos TM1 versão 10.1.0, é possível usar o CognosConfiguration para iniciar, parar e gerenciar servidores Cognos TM1.

Cognos TM1 Web

v O diretório de instalação padrão para o Cognos TM1 Web mudou deC:\inetpub\wwwroot\TM1Web para <TM1_Install>\tm1web.

v Se você quiser usar quaisquer configurações do arquivo de configuraçãodo Cognos TM1 Web anterior, é possível mesclar seletivamente as linhasdo arquivo Web.config anterior no novo arquivo Web.config.

Cognos TM1 Applications

v Atenção: Você precisará editar seus aplicativos anteriores no CognosTM1 Performance Modeler se eles usarem os seguintes recursos:– Subconjuntos Dinâmicos não podem ser usados como hierarquia de

aprovação no Cognos TM1 Applications.– Aplicativos não podem compartilhar os mesmos cubos de aprovação

no Cognos TM1 Applications.v Uma versão do servidor de aplicativos da web Apache Tomcat é

instalada com a nova versão do Cognos TM1. É possível usar essainstância do Tomcat para executar o Cognos TM1 Applications egerenciá-lo usando Cognos Configuration.

v Caso pretenda usar o Cognos TM1 Applications sem o Microsoft Excelinstalado no servidor da Web onde o Cognos TM1 Web está sendoexecutado, você precisará configurar explicitamente o parâmetroExcelWebPublishEnabled como True (T) no arquivo de configuraçãotm1s.cfg para seus servidores Cognos TM1. As versões mais antigas doCognos TM1 Contributor não exigiam que esse parâmetro fosseconfigurado.

Fazendo Backup de Dados Existentes

Antes do upgrade, assegure-se de fazer backup dos dados, aplicativos e arquivosde configuração existentes em um local seguro. Dependendo da arquitetura derede e da implementação do Cognos TM1, os dados do Cognos TM1 podem residirem mais de um computador. Faça uma lista de onde esses dados estão localizadose crie um plano para fazer backup dos dados.

Os arquivos a seguir precisam ter um backup:v Arquivos de configuração do Cognos TM1 Admin Serverv Arquivos de configuração e banco de dados do Cognos TM1 Serverv Arquivos de configuração e customizados do Cognos TM1 Web Serverv Arquivos de configuração do cliente Cognos TM1 Architectv Arquivos de configuração do cliente Cognos TM1 Perspectivesv Arquivos de configuração e aplicativo Cognos TM1 Contributor

Parando Serviços do Cognos TM1 antes do UpgradeTodos os serviços para a versão anterior do IBM Cognos TM1 devem ser paradosantes do upgrade.

Procedimento1. Use Serviços do Windows para parar todos os serviços do Cognos TM1. Isso

inclui:


v Cognos TM1 Admin Serverv Cognos TM1 Excel Servicev Cognos TM1 Server Services

2. Pare o aplicativo Cognos TM1 Contributor pmpsvc. Para isso, use asferramentas de gerenciamento para o servidor de aplicativos da web que estáexecutando o Cognos TM1 Contributor.

3. Se estiver usando a segurança do IBM Cognos Business Intelligence comCognos TM1 Applications, pare o serviço do IBM Cognos BI.

O que Fazer Depois

Faça backup dos aplicativos e dados existentes. Para obter informações adicionais,consulte “Fazendo Backup dos Dados para uma Versão Anterior do Cognos TM1”.

Fazendo Backup dos Dados para uma Versão Anterior do Cognos TM1Este tópico fornece diretrizes para o backup de dados e de arquivos deconfiguração para todos os componentes do IBM Cognos TM1 9.x.

Antes de Iniciar

Pare todos os serviços relacionados. Para obter informações adicionais, consulte“Parando Serviços do Cognos TM1 antes do Upgrade” na página 48.

Sobre Esta Tarefa

Se estiver usando atualmente uma versão anterior do Cognos TM1, você deveráfazer backup dos arquivos de configuração e diretório de dados do Cognos TM1antes de instalar o Cognos TM1 10.1. Se estiver usando Cognos TM1 Web ouCognos TM1 Contributor, você também deverá fazer backup dos arquivos deconfiguração e dados relacionados para esses componentes.

Procedimento1. Faça backup dos arquivos de configuração do Cognos TM1 Admin Server que

talvez você queira reter, como o arquivo tm1admsrv.ini localizado no diretório<TM1_Install>\bin\.

2. Faça backup dos arquivos de configuração e dados do Cognos TM1 Server nodiretório de dados e subdiretórios <TM1_Install>\Custom\TM1Data em um localseguro.

Dica: O local de dados padrão para Cognos TM1 9.5 era: C:\ProgramFiles\Cognos\TM1\Custom\TM1Data.

3. Faça backup dos arquivos de configuração do Cognos TM1 Architect e CognosTM1 Perspectives:a. Faça backup do arquivo Tm1p.ini padrão do sistema localizado aqui:

%ALLUSERSPROFILES%\Application Data\Applix\TM1\Tm1p.ini

Por exemplo: C:\Documents and Settings\All Users\ApplicationData\Applix\TM1\Tm1p.ini

b. Faça backup do arquivo Tm1p.ini específico do usuário localizado aqui:%APPDATA%\Applix\TM1\Tm1p.ini

Por exemplo: C:\Documents and Settings\user name\ApplicationData\Applix\TM1\Tm1p.ini

Capítulo 5. Fazendo Upgrade 49

4. Faça backup dos arquivos customizados e de configuração do Cognos TM1Web em um local seguro. O local padrão do Cognos TM1 Web 9.x eraC:\inetpub\wwwroot\TM1Web

a. Faça backup de uma cópia do arquivo web.config.

Dica: Talvez você queira usar algumas das configurações nesse arquivo aoconfigurar sua nova instalação do Cognos TM1 Web.

b. Faça backup de quaisquer páginas do servidor da Web customizadas quepossam ter sido criadas.

5. Faça backup da pasta applications do Cognos TM1 Contributor 9.5.x e doarquivo de configuração pmpsvc_config.xml em um local seguro.a. Faça backup da pasta \webapps\pmpsvc\WEB-INF\applications.b. Faça backup do arquivo de configuração \webapps\pmpsvc\WEB-INF\

configuration\pmpsvc_config.xml.Se tiver implementado com sua própria instalação do Apache Tomcat, verifiqueaqui: Program Files\Apache Software Foundation\Tomcat 6.0.Se tiver implementado com o Apache Tomcat fornecido com o IBM CognosBusiness Intelligence (BI), verifique aqui: Program Files\cognos\c8.

O que Fazer Depois

Remova a versão anterior do produto. Para obter informações adicionais, consulte“Desinstalando uma Versão Anterior do IBM Cognos TM1”.

Desinstalando uma Versão Anterior do IBM Cognos TM1Todos os componentes de uma versão anterior do IBM Cognos TM1 devem serremovidos e desinstalados.

Antes de Iniciar

Siga estas etapas em cada computador que deve ser atualizado. Certifique-se de terfeito backup de todos os arquivos de configuração e dados. Para obter informaçõesadicionais, consulte “Fazendo Backup dos Dados para uma Versão Anterior doCognos TM1” na página 49.

Procedimento1. Para desinstalar uma versão anterior do Cognos TM1 Server, Cognos TM1

Architect, Cognos TM1 Perspectives e Cognos TM1 Web:a. No Painel de Controle do Windows, clique em Incluir ou Remover

Programas.b. Na lista de programas atualmente instalados, selecione IBM Cognos TM1.c. Clique em Remover e siga as instruções para concluir o processo.

2. Para desinstalar o Cognos TM1 Contributor:v Remova a implementação do Cognos TM1 Contributor do servidor de

aplicativos da web sendo usado.v Desinstale a ferramenta de administração do Cognos TM1 Contributor 9.5.x e

o IBM Cognos Rich Client Framework.

O que Fazer Depois

Instalação da nova versão do produto.


Atualizando a Instalação de um Único Computador do Cognos TM1Este tópico descreve como atualizar o IBM Cognos TM1 em um único computadorem execução no sistema operacional Microsoft Windows.

Após remover a versão anterior do produto, você estará pronto para instalar.

Quando terminar, conclua o upgrade restaurando seus dados, suas definições deconfiguração e seus aplicativos.Conceitos relacionados

Capítulo 6, “Instalação de Computador Único do Cognos TM1”, na página 57Este tipo de instalação coloca o IBM Cognos TM1 em um único computador queexecuta o sistema operacional Microsoft Windows e usa as configurações padrão.Use este tipo de instalação para instalar e executar rapidamente o Cognos TM1 oupara instalar um ambiente de teste ou avaliação.

Atualizando o Cognos TM1 Server no UNIX ou LinuxÉ possível atualizar componentes do Cognos TM1 Server em um computador de64 bits executando um sistema operacional UNIX ou Linux.



“Instalando o Cognos TM1 Server no UNIX ou Linux” na página 69É possível instalar os componentes do servidor Cognos TM1 em um computadorde 64 bits que executa um sistema operacional UNIX ou Linux. Use este tipo deinstalação para instalar e executar o servidor Cognos TM1 em um computadordedicado que usuários remotos podem acessar.

Atualizando o Cognos TM1 Server no WindowsÉ possível atualizar componentes do servidor Cognos TM1 em computadores de 32bits ou 64 bits executando o sistema operacional Microsoft Windows.


Quando terminar, conclua o upgrade restaurando seus dados, suas definições deconfiguração e seus aplicativos.


Conceitos relacionados

“Instalando o Cognos TM1 Server no Windows” na página 67É possível instalar os componentes do Cognos TM1 Server em computadores de 32bits ou de 64 bits executando o sistema operacional Microsoft Windows. Use essetipo de instalação para instalar e executar o Cognos TM1 Server em umcomputador dedicado que usuários remotos podem acessar.

Atualizando os Clientes Cognos TM1 Architect e PerspectivesÉ possível atualizar os componentes do cliente IBM Cognos TM1 e o programa deinstalação do Cognos TM1 Server ou programa de instalação do Cognos TM1Client.



Capítulo 10, “Instalação do Cliente Cognos TM1”, na página 101É possível instalar os componentes do cliente IBM Cognos TM1 usando oprograma de instalação do servidorCognos TM1 ou o programa de instalação docliente Cognos TM1.

Atualizando o Cognos TM1 WebSe você tiver o IBM Cognos TM1 Web em um computador separado daquele noqual instalou o Cognos TM1 Server, execute estas etapas para atualizar o servidorda Web.



Capítulo 8, “Instalação do Cognos TM1 Web”, na página 77É possível instalar o IBM Cognos TM1 Web em um computador separado daqueleonde você instalou o Cognos TM1 Server e outros componentes do Cognos TM1.

Atualizando o Cognos TM1 Contributor para o Cognos TM1Applications

O upgrade do Cognos TM1 Contributor para o Cognos TM1 Applications requeruma série de etapas. Essas etapas incluem um processo para mover seus arquivosde aplicativo antigos para o Cognos TM1 Applications.

Antes de Iniciar

Revise as considerações a seguir antes de atualizar os arquivos de aplicativo doCognos TM1 Contributor para o Cognos TM1 Applications.


Atenção: Talvez seja necessário editar seus antigos aplicativos para torná-loscompatíveis com a versão mais nova.v Subconjuntos Dinâmicos não podem ser usados como hierarquia de aprovação

no Cognos TM1 Applications.v Aplicativos não podem compartilhar os mesmos cubos de aprovação no Cognos

TM1 Applications.

Se um aplicativo não puder ser atualizado, uma mensagem será exibida durante oprocesso de upgrade e o aplicativo será movido para um estado nãoimplementado. Aplicativos não implementados não aparecem no portal do CognosTM1 Applications, mas em vez disso, aparecem na guia de design do aplicativoCognos TM1 Performance Modeler. É possível usar o Cognos TM1 PerformanceModeler para editar e corrigir o aplicativo e depois validá-lo e implementá-lo.

Procedimento1. Parar os serviços relacionados.

Consulte o “Parando Serviços do Cognos TM1 antes do Upgrade” na página48.

2. Faça backup da pasta applications do Cognos TM1 Contributor 9.5.x e doarquivo de configuração pmpsvc_config.xml em um local seguro.a. Faça backup da pasta \webapps\pmpsvc\WEB-INF\applications.b. Faça backup do arquivo de configuração \webapps\pmpsvc\WEB-INF\

configuration\pmpsvc_config.xml.Se tiver implementado com sua própria instalação do Apache Tomcat,verifique aqui: Program Files\Apache Software Foundation\Tomcat 6.0.Se tiver implementado com o Apache Tomcat fornecido com o IBM CognosBusiness Intelligence (BI), verifique aqui: Program Files\cognos\c8.

3. Desinstale o IBM Cognos TM1 9.5.x.Consulte “Desinstalando uma Versão Anterior do IBM Cognos TM1” napágina 50

4. Desinstale a ferramenta de administração do Cognos TM1 Contributor 9.5.x eIBM Cognos Rich Client Framework:

Dica: Será necessário repetir essas etapas para cada computador em que aferramenta de administração do Cognos TM1 Contributor 9.5.x foi instalada.a. No Microsoft Windows, abra Incluir ou Remover Programas.

Atenção: Dependendo de como a ferramenta de administração foiinstalada, talvez você veja apenas uma entrada.

b. Se a entrada existir, remova primeira o IBM Cognos TM1 ContributorAdministration.

c. Remova IBM Cognos Rich Client Framework.5. Remova a implementação do aplicativo da web pmpsvc do Cognos TM1

Contributor:v Se tiver implementado com sua própria instalação do Apache Tomcat ou

IBM Websphere, use a respectiva ferramenta de gerenciamento pararemover a implementação do aplicativo da web pmpsvc.

v Se tiver implementado com o IBM Cognos BI, os arquivos de programaestarão nos seguintes locais:– C:\Program Files\cognos\c8\webapps\pmpsvc

– C:\Program Files\cognos\c8\tomcat4.1.27\work\Standalone\localhost\pmpsvc


6. Instale o Cognos TM1 Applications.Para obter detalhes, consulte Capítulo 9, “Instalação do Cognos TM1Applications”, na página 83.

7. Restaure seus arquivos de dados para cada servidor Cognos TM1 quepretende usar com o Cognos TM1 Applications.Para obter detalhes, consulte “Restaurando Dados de uma Versão Anterior noCognos TM1” na página 55.

8. Edite o arquivo de configuração tm1s.cfg para cada servidor Cognos TM1 quedeseja usar com Cognos TM1 Applications:a. Configure o parâmetro ExcelWebPublishEnabled.

Importante: Versões anteriores do Cognos TM1 Contributor sempreconsideraram esse parâmetro como sendo configurado como True e nãousavam a configuração real no arquivo tm1s.cfg do servidor Cognos TM1.A partir do Cognos TM1 10.1, o Cognos TM1 Applications usa esseparâmetro, o que exige que você configure explicitamente o parâmetro noarquivo tm1s.cfg.Para obter detalhes adicionais, consulte “ExcelWebPublishEnabled” napágina 245.

b. Configure os parâmetros AllowSeparateNandCRules eDistributedPlanningOutputDir.Para obter detalhes adicionais, consulte “Configurando um Cognos TM1Server para Trabalhar com o Cognos TM1 Applications” na página 98.

9. Se quiser usar qualquer uma de suas antigas definições de configuração,copie-as manualmente do antigo arquivo nos novos arquivos de configuraçãopara o Cognos TM1 Applications.Atenção: No Cognos TM1 Applications, o conteúdo do arquivo deconfiguração pmpsvc_config.xml anterior foi reorganizado em dois arquivosseparados; pmpsvc_config.xml e fpmsvc_config.xml.a. Copie configurações do cliente do antigo arquivo pmpsvc_config.xml no

novo arquivo pmpsvc_config.xml.b. Copie as configurações relacionadas ao servidor do antigo arquivo

pmpsvc_config.xml no novo arquivo fpmsvc_config.xml.10. Copie a pasta applications do Cognos TM1 Contributor 9.5.x anterior no

novo local para o Cognos TM1 Applications:Por exemplo, C:\Program Files\IBM\cognos\tm1\webapps\pmpsvc\WEB-INF\applications

11. Inicie os serviços relacionados do Cognos TM1 usando o IBM CognosConfiguration.a. Servidor Admin de TM1

b. TM1 Excel Service

c. TM1 Application Server

d. Inicie quaisquer servidores Cognos TM1 que você esteja usando com oCognos TM1 Applications.

12. Efetue login no portal do Cognos TM1 Applications como administrador paraatualizar seus aplicativos.Durante o processo de login, os arquivos de aplicativo na pastawebapps/pmpsvc/WEB-INF/application serão atualizados do Cognos TM1Contributor 9.5.2 para o Cognos TM1 Applications.


13. Se for solicitado que você forneça subconjuntos dinâmicos durante o processode upgrade, edite o aplicativo para torná-lo compatível.a. Abra o Cognos TM1 Performance Modeler.b. Altere o subconjunto de dinâmico para estático ou selecione um novo

subconjunto estático para usarc. Reimplemente o aplicativo e revise a segurança para o aplicativo. Parte da

segurança pode ter mudado, exigindo que você recrie as designações desegurança usando a opção Gerenciar Direitos.Para obter detalhes, consulte IBM Cognos TM1 Performance Modeler UserGuide.

14. Se for solicitado que você forneça visualizações compartilhadas durante oprocesso de upgrade, edite o aplicativo para torná-lo compatível.a. Abra o Cognos TM1 Performance Modeler.b. Para corrigir o problema, você precisará reorganizar os dados do TM1 para

que cubos de aprovação não sejam compartilhados por aplicativos.c. Salve e implemente o aplicativo.

Para obter detalhes, consulte IBM Cognos TM1 Performance Modeler UserGuide.

Restaurando Dados de uma Versão Anterior no Cognos TM1Após a instalação da nova versão do IBM Cognos TM1, conclua estas etapas pararestaurar os arquivos de configuração e banco de dados anteriores do Cognos TM1.

Antes de Iniciar

Instalação da nova versão do produto.

Procedimento1. Restaurar arquivos de configuração do Cognos TM1 Admin Server:

Atenção: A partir do IBM Cognos TM1 versão 10.1.0, o arquivo deconfiguração do TM1 Admin Server, Tm1admsrv.ini, não é mais usado ousuportado pelo Cognos TM1. As definições de configuração para o CognosTM1 Admin Server agora são configuradas e armazenadas exclusivamente naferramenta IBM Cognos Configuration. Você deve usar o Cognos Configurationpara configurar o Cognos TM1 Admin Server.a. Abra o IBM Cognos Configuration.b. Na área de janela Explorer do Cognos Configuration, expanda

Configuração Local > Ambiente e clique em TM1 Admin Server. Osparâmetros para o Admin Server são exibidos na área de janelaPropriedades.

c. Abra o antigo arquivo Tm1admsrv.ini.d. Para cada parâmetro que deseja usar com sua nova instalação, copie o valor

do parâmetro do arquivo Tm1admsrv.ini nos parâmetros correspondentes noCognos Configuration. Por exemplo, se você estava usando configuraçõesde SSL customizadas com a instalação anterior, copie os valores para essesparâmetros no Cognos Configuration.

e. No Cognos Configuration, clique em Arquivo > Salvar.2. Restaurar arquivos de configuração e dados do Cognos TM1 Server:

Dica: A partir do IBM Cognos TM1 versão 10.1.0, é possível usar o CognosConfiguration para iniciar, parar e gerenciar servidores CognosTM1.


a. Para cada Cognos TM1 Server que deseja restaurar, copie seu diretório dedados e subdiretórios no novo local para os dados: <TM1_Install>\samples\tm1.

b. Inclua cada CognosTM1 Server no Cognos Configuration onde é possíveliniciar, parar e gerenciar o servidor. Para obter detalhes, consulte “Incluindoum Servidor Cognos TM1 Existente no Cognos Configuration” na página74.

3. Restaurar arquivos de configuração do Cognos TM1 Architect e Cognos TM1Perspectives:

Se quiser restaurar quaisquer configurações da instalação anterior do CognosTM1 Architect ou Cognos TM1 Perspectives, copie os valores do antigoTm1p.ini no novo arquivo Tm1p.ini.Atenção: Se você deixar os antigos arquivos Tm1p.ini em vigor, talvez sejanecessário atualizar o caminho do diretório no arquivo para o parâmetroAdminSvrSSLCertAuthority. Por exemplo, se você estiver usando o certificadoSSL do Cognos TM1 padrão, altere manualmente o valor desse parâmetro parao novo caminho de instalação C:\Program Files\IBM\cognos\tm1\bin\ssl\applixca.pem.a. Atualize o novo arquivo Tm1p.ini padrão do sistema localizado aqui:

%ALLUSERSPROFILES%\Application Data\Applix\TM1\Tm1p.ini

Por exemplo: C:\Documents and Settings\All Users\ApplicationData\Applix\TM1\Tm1p.ini

b. Atualize o novo arquivo Tm1p.ini específico do usuário localizado aqui:%APPDATA%\Applix\TM1\Tm1p.ini

Por exemplo: C:\Documents and Settings\user name\ApplicationData\Applix\TM1\Tm1p.ini

4. Restaurar arquivos do Cognos TM1 Web:

Se estiver usando a nova versão do Cognos TM1 Web, restaure quaisquerdefinições de configuração ou arquivos customizados que deseja usar.

Nota: A partir do IBM Cognos TM1 versão 10.1.0, o diretório de instalaçãopadrão do Cognos TM1 Web é <TM1_Install>\tm1web.a. Abra o antigo arquivo Web.config e mescle seletivamente as linhas e os

parâmetros que deseja usar no novo arquivo Web.config localizado em<TM1_Install>\tm1web.

b. Se quiser usar qualquer uma das páginas do servidor Cognos TM1 Webcustomizadas anteriores, copie-as no novo diretório do Cognos TM1 Web.

5. Restaurar arquivos de configuração e aplicativo Cognos TM1 Contributor9.5.x no Cognos TM1 Applications:

Para obter detalhes, consulte “Atualizando o Cognos TM1 Contributor para oCognos TM1 Applications” na página 52.


Capítulo 6. Instalação de Computador Único do Cognos TM1

Este tipo de instalação coloca o IBM Cognos TM1 em um único computador queexecuta o sistema operacional Microsoft Windows e usa as configurações padrão.Use este tipo de instalação para instalar e executar rapidamente o Cognos TM1 oupara instalar um ambiente de teste ou avaliação.

Para configurar e instalar os recursos integrais e os componentes opcionais doCognos TM1, consulte o Guia de Instalação e Configuração do IBM Cognos TM1abrangente (http://publib.boulder.ibm.com/infocenter/ctm1/v10r1m0/topic/com.ibm.swg.ba.cognos.tm1_inst.10.1.0.doc/c_tm1_inst_intro.html).

A instalação de computador único explica como instalar e executar:v Cognos TM1 Admin Serverv Cognos TM1 Serverv Cognos TM1 Perspectivesv Cognos TM1 Architectv Cognos TM1 Webv Cognos TM1 Application Serverv Cognos TM1 Application Webv Cognos Insightv Cognos TM1 Performance Modeler

Este cenário de instalação assume que:v Você está em um único computador de 32 ou 64 bits que executa o sistema

operacional Microsoft Windows.v Você usa o software de servidor da web Apache Tomcat instalado pela instalação

do Cognos TM1.v Você usa autenticação Cognos TM1 padrão.v Você aceita as configurações padrão, incluindo inglês como o idioma.

Nem todos os componentes Cognos TM1 estão disponíveis para sistemas de 64bits. Se o componente estiver disponível como uma instalação de 64 bits, ele seráinstalado em um diretório identificado como um local de 64 bits em vez de nolocal do diretório de instalação de 32 bits padrão. Por exemplo, bin64 em vez debin.

Lembre-se: Seu navegador pode usar uma interface um pouco diferente daquelado navegador usado nas etapas descritas aqui.Conceitos relacionados

“Atualizando a Instalação de um Único Computador do Cognos TM1” na página51Este tópico descreve como atualizar o IBM Cognos TM1 em um único computadorem execução no sistema operacional Microsoft Windows.

Instalar Software ObrigatórioVocê precisa de um software obrigatório antes de instalar o IBM Cognos TM1.


http://publib.boulder.ibm.com/infocenter/ctm1/v10r1m0/topic/com.ibm.swg.ba.cognos.tm1_inst.10.1.0.doc/tm1_inst.html

Sobre Esta Tarefa

Se você não tiver estes pré-requisitos ativos, o Assistente de Instalação do CognosTM1 tentará instalá-los para você, no entanto, o assistente poderá instalar somenteum por vez. Se estiver ausente mais de um, poderá ser necessário reiniciar ainstalação até você ter todos eles. Talvez você já tenha este software instalado.

Procedimento1. Instale ou confirme se você possui:

v Microsoft .NET Framework 3.5 Service Pack 1v Microsoft Visual C++ 2005 SP1 Redistributable Packagev Microsoft ExcelEste software é usado pelo Cognos TM1 Perspectives ou pelo Cognos TM1Architect.

2. Instale ou confirme se você possui:v Microsoft .NET Framework 3.5 Service Pack 1v Microsoft Chart Controls para Microsoft .NET Framework 3.5v Software de servidor da web Microsoft Internet Information Services (IIS).Esse software é usado pelo Cognos TM1 Web ou Cognos TM1 ApplicationServer.Nos sistemas operacionais Windows 7, Windows XP e Windows Server 2008,assegure-se de que a opção IIS 6 Management Compatibility esteja ativada. Semessa configuração, o Cognos TM1 Web não pode criar os diretórios virtuaisnecessários. Procure no Web site de suporte da Microsoft a opção "IIS 6Management Compatibility" para obter mais detalhes.Consulte Ambientes de Software do Cognos TM1 10.1.0 (www.ibm.com/support/docview.wss?uid=swg27021976) para obter as informações maisrecentes sobre software obrigatório.

3. Cognos Insight e Cognos TM1 Performance Modeler podem ser ativados apartir do Cognos TM1 Applications Portal, portanto, é necessário instalar eestar apto para executar o Cognos TM1 Applications antes que você possaativar o Cognos Insight ou Cognos TM1 Performance Modeler a partir doportal.

Instalar os Componentes Básicos do Cognos TM1Use o programa de instalação para selecionar os componentes que deseja instalar eo local em seu computador onde deseja instalá-los.

Antes de Iniciarv Assegure-se de que tenha privilégios de administrador para o computador no

qual está instalando o software.v Assegure-se de que o computador tenha uma variável do sistema TEMP que

aponte para o diretório em que deseja armazenar arquivos temporários. Durantea instalação, os arquivos são copiados temporariamente nesse diretório.

v Algum software do servidor da web do Microsoft Windows não suportacaracteres não ASCII nos nomes de diretórios. Assegure-se de que os diretóriosnos quais você instala os componentes do IBM Cognos TM1 contenham apenascaracteres ASCII no nome do caminho.

v Assegure-se de que todo software obrigatório tenha sido instalado.



v Há inúmeras variedades do programa de instalação disponíveis para você.Dependendo de qual sistema operacional você estiver usando, acesse o diretóriono qual aquele que deseja instalar está armazenado:– TM1 para Windows de 32 bits– TM1 para Windows de 64 bits

Procedimento1. Para iniciar a instalação:

v Acesse o local do download para o programa de instalação do Cognos TM1que deseja usar.

v Ou insira o disco do produto IBM Cognos TM1.Se o assistente de instalação não abrir automaticamente, acesse o diretório dosistema operacional para localizar o comando issetup.exe.

2. Dependendo do software do sistema operacional, clique com o botão direito domouse ou dê um clique duplo no comando issetup.exe:v No software de sistema operacional Microsoft Windows Vista, Windows 7 ou

Windows Server 2008, clique com o botão direito do mouse no comandoissetup.exe e clique em Run as Administrator.

v Para todos os outros softwares de sistema operacional Windows, dê umclique duplo em issetup.exe.

3. Siga as orientações no assistente de instalação para selecionar todos oscomponentes.Por padrão, os componentes necessários para executar o software sãoselecionados.Se não quiser instalar o Cognos Insight ou Cognos TM1 Performance Modeler,vá para a Etapa 5.

4. Para incluir o Cognos Insight na instalação, expanda TM1 Client Tier eselecione Cognos Insight.

5. Para incluir o Cognos TM1 Performance Modeler na instalação, expanda TM1Developer Tier e selecione TM1 Performance Modeler.

6. Clique em Avançar até a instalação começar.A instalação será executada até que todos os componentes tenham sidoinstalados. Isso pode levar uma quantidade de tempo significativa.

Dica: Para sistemas operacionais Windows anteriores, é possível marcar IniciarCognos Configuration na última tela da instalação para executarimediatamente a ferramenta de configuração. No software de sistemaoperacional Microsoft Windows Vista, Windows 7 ou Windows Server 2008,não marque essa caixa e use o menu Iniciar para poder escolher Run asAdministrator durante a ativação da ferramenta Cognos Configuration.

7. Clique em Concluir.

Usar Cognos Configuration para Iniciar os Componentes do CognosTM1

Antes de poder usar o Cognos TM1, você precisa iniciar o IBM Cognos TM1Admin Server, o TM1 Excel Service, oTM1 Application Server e pelo menos umservidor de banco de dados de amostras do IBM Cognos TM1. Essa ação registraos servidores no registro de serviço do Windows. Em seguida é necessário

Capítulo 6. Instalação de Computador Único do Cognos TM1 59

configurar os serviços para que eles sejam executados sob um usuário específico.Os servidores que estão em execução em um ambiente Microsoft Windows sãoreferidos como "serviços".

Procedimento1. Se ele ainda não estiver em execução, inicie a ferramenta de configuração

clicando em Iniciar > Todos os Programas > IBM Cognos TM1 > IBM CognosConfiguration.

Lembre-se: Clique com o botão direito do mouse e use Run as Administratorno software de sistema operacional Windows Vista, Windows 7 e WindowsServer 2008.

2. Na área de janela Explorer do Cognos Configuration, expanda ConfiguraçãoLocal > Ambiente.

3. Clique com o botão direito do mouse em cada servidor que deseja iniciar eselecione Iniciar:a. Servidor Admin de TM1 É melhor iniciar o TM1 Admin Server primeiro, já

que esse servidor deve estar em execução antes que qualquer banco dedados de amostras possa ser executado.A ferramenta Cognos Configuration solicita que você salve quaisqueredições feitas nas definições de configuração. Esse processo levará maistempo na primeira vez que você salvar uma configuração conformeconfigurações criptográficas e outras ações acontecem pela primeira vez.Clique em Sim como resposta para a mensagem solicitando que você salveas configurações. Você verá também esse tipo de mensagem ao fechar oCognos Configuration.

b. TM1 Excel Service

c. TM1 Application Server

4. Expanda o nó Acesso a Dados > TM1 Server e clique com o botão direito domouse em cada servidor de banco de dados de amostras do Cognos TM1 quedeseja iniciar e selecione Iniciar. Por exemplo, inicie os bancos de dados deamostras fornecidos:a. SData

b. Amostra de Planejamento

c. GO_New_Stores

5. Clique em Arquivo > Salvar.6. Agora que todos os serviços estão registrados no registro de serviço do

Windows, é possível reconfigurá-los para usarem uma conta de usuárioespecífica:a. No Cognos Configuration, clique com o botão direito do mouse em cada

serviço que deseja alterar e selecione Parar.b. Abra Serviços do Windows.c. Clique com o botão direito do mouse em cada serviço e selecione

Propriedades.d. Insira um nome de usuário e uma senha válidos no sistema com os direitos

apropriados para o serviço. Consulte "Contas de Usuário para ExecutarServiços do Cognos TM1 no Windows" no capítulo "Planejamento" do Guiade Instalação e Configuração do IBM Cognos TM1 para obter detalhes sobre osdireitos que essa conta de usuário deve ter.

e. Feche Serviços do Windows.


7. No Cognos Configuration, clique com o botão direito do mouse e selecioneIniciar.

8. Feche o Cognos Configuration.

Executar o Cognos TM1 PerspectivesApós a instalação, é possível executar o IBM Cognos TM1 Perspectives.

Procedimento1. No menu Iniciar do Windows, clique em IBM Cognos TM1 > Perspectivas. Se

o componente não iniciar, assegure que os servidores iniciados com o CognosConfiguration ainda estejam em execução.

2. Clique em Ativar Macros quando o aviso de segurança for exibido.3. Clique em TM1 > Server Explorer, em seguida, expanda TM1 para ver os

servidores que estão disponíveis.4. Dê um clique duplo em um Cognos TM1 Server para efetuar login.

Para SData, Amostra de Planejamento ou GO_New_Stores, use estas credenciaisde login:v Nome de Usuário: admin

v Senha: apple

Dica: Para carregar o Cognos TM1 Perspectives automaticamente sempre quevocê inicia o Microsoft Excel, inclua TM1_location/Tm1p.xla na lista deferramentas de suplemento doMicrosoft Excel, em que TM1_location é odiretório de arquivos no qual o Cognos TM1 está instalado. Após concluir estaetapa, "TM1" é exibido na barra de menus do Microsoft Excel.

Executar o Cognos TM1 ArchitectApós a instalação, é possível executar a versão não Microsoft Excel do IBM CognosTM1 chamada IBM Cognos TM1 Architect.

Procedimento1. No menu Iniciar do Windows, clique em Todos os Programas > IBM Cognos

TM1 > Architect. Se o Cognos TM1 Architect não inicializar, assegure que osservidores iniciados com o Cognos Configuration ainda estejam em execução.

2. Expanda TM1 para ver os servidores que estão disponíveis.3. Dê um clique duplo em um Cognos TM1 Server para efetuar login.4. Use estas credenciais para efetuar login nos bancos de dados de amostras

SData, Amostra do Planning ou GO_New_Stores:v Nome de Usuário: admin

v Senha: apple

Executar o Cognos TM1 WebA instalação do IBM Cognos TM1 configura o IBM Cognos TM1 Web para executarcom a instalação existente do software do servidor da web Microsoft InternetInformation Services (IIS).

Antes de Iniciar

Lembre-se das seguintes informações ao usar o TM1 Web:


v Nos sistemas operacionais Windows 7, Windows XP e Windows Server 2008,assegure-se de que a opção IIS 6 Management Compatibility esteja ativada. Semessa configuração, o Cognos TM1 Web não pode criar os diretórios virtuaisnecessários. Procure no Web site de suporte da Microsoft a opção "IIS 6Management Compatibility" para obter mais detalhes.

v Consulte "Alterando Serviços do Cognos TM1 para Serem Executados como umaConta de Usuário Específica no Windows" no capítulo "Instalação do CognosTM1 Web" do Guia de Instalação e Configuração do IBM Cognos TM1 para obterdetalhes sobre como configurar o TM1 Excel Service para ser executado comoum usuário específico.

Procedimento1. Em um navegador da web, insira a seguinte URL: http://localhost/tm1web

É possível usar o termo "host local" para tornar padrão o local do computadorpara usar seu computador atual. Ou é possível inserir explicitamente oendereço IP ou o nome para o computador no qual o Cognos TM1 foiinstalado.

2. Dependendo dos outros componentes ativados, os valores da caixa Loginnormalmente serão inseridos automaticamente para você. Se não forem, épossível inserir ou alterar esses valores conforme necessário.

3. Clique em Efetuar Login.

Nota: Seu software antivírus pode avisá-lo quando o Cognos TM1 ExcelService tentar efetuar login na Web. Siga as diretrizes da empresa quanto àsegurança. Cognos TM1 Web requer acesso à Web para que uma configuraçãocomo Permitir Sempre seja ideal para todos os serviços do Cognos TM1.

Executar o Cognos TM1 Applications PortalO IBM Cognos TM1 Applications é o cliente e o portal baseados na Web usadospara executar aplicativos de planejamento construídos usando os dados do IBMCognos TM1.

Sobre Esta Tarefa

O Cognos TM1 Applications também é usado para ativar o IBM Cognos TM1Performance Modeler e pode ser usado para ativar o IBM Cognos Insight.

Procedimento1. Em um navegador da web, insira a seguinte URL: http://localhost:9510/

pmpsvc em que 9510 é a porta incomum usada pelo Cognos TM1 ApplicationServer. Se você usou uma porta diferente durante a instalação, insira esse outrovalor aqui.

2. Aceite os padrões para todas as definições de configuração para identificar oHost Administrativo, o servidor, os tipos de clientes e a URL usada peloCognos TM1 Applications Server.

3. Clique em OK.4. Insira admin e apple para username e password para os servidores de banco

de dados de amostras.5. Para concluir a instalação, rejeite a mensagem sobre a edição dos parâmetros

AllowSeparateNandCRules e DistributedPlanningOutputDir nos arquivostm1s.cfg.


Não é necessário editar esses parâmetros até começar a trabalhar com osclientes.O portal fica vazio até você construir um aplicativo usando o Cognos TM1Performance Modeler ou importar um aplicativo existente.

Executar o Cognos TM1 Performance ModelerO IBM Cognos TM1 Performance Modeler está disponível como um componentenão selecionado da instalação do IBM Cognos TM1. Você ativa o Cognos TM1Performance Modeler no portal do IBM Cognos TM1 Applications.

Procedimento1. No portal do Cognos TM1 Applications, clique no ícone Abrir Performance

Modeler .

Lembre-se: Dependendo do seu navegador, talvez você veja etapas um poucodiferentes usadas para a instalação dos componentes transferidos pordownload, como Cognos TM1 Performance Modeler.

2. Clique em OK com a opção Abrir com IBM Cognos RCP Application Updaterselecionada na caixa de diálogo provagent.cogrcp_modeler.

3. Clique em OK para rejeitar a mensagem de definições de configuração econcluir a instalação.Não é necessário editar esses parâmetros até começar a trabalhar com osclientes.

4. Clique na guia Design de Modelos para ver a estrutura e os cubos de dadosGO_New_Stores.

5. Clique na guia Design do Aplicativo para construir um novo aplicativo usandoGO_New_Stores.Consulte IBM Cognos TM1 Performance Modeler User Guide localizado no Centrode Informações do TM1 10.1.0(http://publib.boulder.ibm.com/infocenter/ctm1/v10r1m0/index.jsp) para obter detalhes sobre o uso do Cognos TM1Performance Modeler para projetar e construir aplicativos.

Executar Cognos InsightO IBM Cognos Insight está disponível como um componente não selecionado dainstalação do IBM Cognos TM1. O Cognos Insight pode ser usado como um clientepara contribuir com aplicativos e também como um construtor de área de trabalhodinâmica para criar experiências do usuário de contribuição interativa.

Procedimento1. Para executar o Cognos Insight, conclua uma das ações a seguir:

v A partir do portal do Cognos TM1 Applications, clique no ícone .Ou é possível:

v Clicar com o botão direito do mouse em um nó de um aplicativo que foiconfigurado para usar o Cognos Insight.

v Também é possível clicar no ícone de área de trabalho do Cognos Insight queé instalado.

v Cognos Insight também pode ser instalado como um componenteindependente.




Lembre-se: Dependendo do seu navegador, talvez você veja etapas um poucodiferentes usadas para a instalação dos componentes transferidos pordownload, como Cognos Insight.

2. Clique em OK com a opção Abrir com IBM Cognos RCP Application Updaterselecionada na caixa de diálogo provagent.cogrcp_insight.

3. Se você vir um aviso de arquivo executável, clique em OK para continuar coma instalação.

4. Clique em OK para indeferir a mensagem de definição de configuraçãoAllowSeparateNandCRules e DistributedPlanningOutputDir.Não é necessário editar esses parâmetros até começar a trabalhar com osclientes.Consulte o IBM Cognos Insight User Guide no Centro de Informações do TM110.1.0 (http://publib.boulder.ibm.com/infocenter/ctm1/v10r1m0/index.jsp)para obter detalhes sobre como criar áreas de trabalho do Cognos Insight e usaro Cognos Insight como um cliente para contribuir com aplicativos.

Usar o Cognos TM1 Application WebO IBM Cognos TM1 Application Web é um cliente baseado na web, usado paracontribuir nos aplicativos de planejamento e funcionar com o IBM Cognos TM1Websheets.

Antes de Iniciar

É necessário um aplicativo de planejamento antes que possa usar o Cognos TM1Application Web client. O editor de telas identifica quais clientes podem ser usadoscom um aplicativo específico.

Dica: É possível ver quais clientes o designer disponibilizou para um aplicativo,clicando com o botão direito do mouse em um nó do aplicativo quando ele forexibido no portal do IBM Cognos TM1 Applications.

Procedimento1. No portal do Cognos TM1 Applications, clique com o botão direito do mouse

em um nó em um aplicativo de planejamento.2. Selecione o Cliente do TM1 Contributor para ativar o cliente Cognos TM1

Application Web.Consulte o IBM Cognos TM1 Applications Guide localizado no Centro deInformações do Cognos TM1 10.1.0 (http://publib.boulder.ibm.com/infocenter/ctm1/v10r1m0/index.jsp) para obter detalhes sobre como contribuir com umaplicativo usando o cliente Cognos TM1 Application Web.

Outros Componentes Cognos TM1A instalação do IBM Cognos TM1 torna muitos outros componentes disponíveis epossui muitas outras maneiras de customizar a instalação.

Consulte a seguir a documentação e os componentes para obter detalhes sobreoutras maneiras de instalar, implementar e configurar o Cognos TM1:v IBM Cognos TM1 Operations Console - O IBM Cognos TM1 Operations

Console é uma ferramenta usada por administradores para monitorar aatividade dos servidores TM1 em sua rede. Consulte o Guia do IBM Cognos TM1Operations Console para obter informações adicionais.






v Interoperabilidade do TM1 Business Intelligence (BI) - Instala componentesopcionais que fornecem interação entre o IBM Cognos TM1 e o IBM CognosBusiness Intelligence (BI). Fornece suporte para dados do Cognos TM1 ViewerPortlets, acessando o Cognos TM1 a partir de consultas, relatórios e painéis doCognos BI, fornecendo clientes do Cognos TM1 a partir do Cognos BI Gateway evinculando-se ao IBM Cognos TM1 Applications a partir do Cognos BI. ConsulteGuia de Instalação e Configuração do IBM Cognos TM1 para obter mais informações.

v IBM Cognos TM1 Package Connector - Use isto para importar os pacotes doIBM Cognos Framework Manager. Consulte o Guia do IBM Cognos TM1 TurboIntegrator para obter informações adicionais.

Consulte o Guia de Instalação e Configuração do IBM Cognos TM1 abrangente paraobter detalhes sobre esses componentes adicionais e sobre outras maneiras de seinstalar e implementar o Cognos TM1.

Configurando Computadores Clientes para Exportar Dados do CognosTM1 em Formato PDF

Para exportar dados do IBM Cognos TM1 para o formato Adobe PDF deaplicativos clientes IBM Cognos TM1 em execução no Microsoft Windows,configure PDFCamp como impressora padrão e assegure-se de que o serviço doWindows para o IBM Cognos TM1 Excel Service esteja em execução como umaconta de usuário específica. Essas etapas se aplicam ao IBM Cognos TM1Perspectives, IBM Cognos TM1 Architect e IBM Cognos TM1 Web.

Antes de Iniciar

Verifique se PDFCamp está instalado corretamente confirmando se o Driver daImpressora PDFCamp existe na configuração Impressoras e Faxes do Windows.

Procedimento1. Configure a impressora padrão:

a. No Windows, abra a janela de configuração Impressoras e Faxes.b. Clique com o botão direito do mouse em Driver da Impressora PDFCamp e

selecione Configurar como Impressora Padrão.2. Assegure-se de que o serviço do Windows para o Cognos TM1 Excel Service

esteja em execução como uma conta de usuário específica, e não como umaconta do Sistema Local.a. No servidor da Web onde o Cognos TM1 Web está em execução, abra

Serviços do Windows.b. Localize a entrada para o IBM Cognos TM1 Excel Service.c. Clique com o botão direito do mouse em IBM Cognos TM1 Excel Service e

selecione Propriedades.d. Insira um usuário e uma senha para um usuário do Windows existente com

os direitos apropriados.e. Reinicie o serviço e feche os Serviços do Windows.

Para obter mais detalhes, consulte “Contas do Usuário para Execução deServiços do Cognos TM1” e “Alterando Serviços do Cognos TM1 para SeremExecutados como uma Conta de Usuário Específica no Windows”.



Capítulo 7. Instalação do Cognos TM1 Server

Use esta seção para instalar e configurar o IBM Cognos TM1 Admin Server e oIBM Cognos TM1 Server em um computador dedicado que executa o sistemaoperacional Microsoft Windows, UNIX ou Linux.

O Cognos TM1 Admin Server pode residir no mesmo computador que o CognosTM1 Server ou em um outro computador em sua rede.

Os componentes do servidor podem ser instalados em computadores de 32 bits oude 64 bits que executam o sistema operacional Microsoft Windows. Para sistemasoperacionais UNIX or Linux, somente computadores de 64 bits são suportados.

Para obter mais detalhes sobre cenários e opções de implementação, consulte“Implementando o Cognos TM1 Admin Server e o TM1 Server” na página 38.

Componentes do servidor

Os componentes do servidor Cognos TM1 incluem o seguinte:v Cognos TM1 Admin Server - necessáriov Cognos TM1 Server - necessáriov Cognos TM1 Tools - opcional

Estes componentes são agrupados juntos sob a Camada do TM1 Application noprograma de instalação.

IBM Cognos Configuration

Por padrão, o IBM Cognos Configuration também é instalado com os componentesnecessários no Windows, UNIX e Linux como a ferramenta primária para gerenciaro Cognos TM1 Admin Server e o Cognos TM1 Server. Esta ferramenta fornece umainterface com o usuário para parar e iniciar os componentes do servidor.

Instalando o Cognos TM1 Server no WindowsÉ possível instalar os componentes do Cognos TM1 Server em computadores de 32bits ou de 64 bits executando o sistema operacional Microsoft Windows. Use essetipo de instalação para instalar e executar o Cognos TM1 Server em umcomputador dedicado que usuários remotos podem acessar.Conceitos relacionados

“Atualizando o Cognos TM1 Server no Windows” na página 51É possível atualizar componentes do servidor Cognos TM1 em computadores de 32bits ou 64 bits executando o sistema operacional Microsoft Windows.

Instalar os Componentes do Cognos TM1 Server no WindowsInstale os componentes do IBM Cognos TM1 Server em um computador que usa oMicrosoft Windows.

Procedimento1. Escolha o programa de instalação que corresponde ao tipo de computador que

está sendo usado para o Cognos TM1 Server:


v Cognos TM1 de 32 bits para Windowsv Cognos TM1 de 64 bits para Windows

2. No software do sistema operacional Microsoft Windows Vista, Windows 7 ouWindows Server 2008, clique com o botão direito do mouse no comandoissetup.exe e clique em Run as Administrator. Para outros sistemasoperacionais, dê um clique duplo no arquivo issetup.exe para iniciar oassistente de instalação.

3. Siga as instruções no assistente de instalação e avance para a página Seleção doComponente.

4. Desmarque todos os componentes. Por padrão, todos os componentes sãoselecionados inicialmente.

5. Expanda a Camada do TM1 Application e selecione os componentes a seguir:v TM1 Server

v Servidor Admin de TM1

v TM1 Tools - Opcional6. Siga as instruções no assistente de instalação para concluir a instalação.7. Na página Concluir do assistente de instalação, clique em Concluir.

Usar Cognos Configuration para Iniciar Servidores CognosTM1 no Windows

Antes de poder usar o Cognos TM1 Server, você precisa iniciar o IBM Cognos TM1Admin Server no IBM Cognos Configuration. Os servidores que estão em execuçãoem um ambiente Microsoft Windows são referidos como "serviços".

Sobre Esta Tarefa

Por padrão, o Cognos Configuration registra componentes do TM1 Server paraserem executados como serviços do Windows usando a conta do Sistema Localpredefinida. No entanto, os componentes do TM1 devem ser executados como umusuário específico.

Importante: Altere os seguintes serviços do Cognos TM1 que são criados peloCognos Configuration para que os serviços sejam executados sob uma conta deusuário específica no Microsoft Windows:v Cognos TM1 Admin Serverv Cognos TM1 Serverv Cognos TM1 Excel Service

Para obter detalhes, consulte “Contas de Usuário para Execução de Serviços doCognos TM1 no Windows” na página 17.

Procedimento1. Se ele ainda não estiver em execução, inicie a ferramenta de configuração

clicando em Iniciar > Todos os Programas > IBM Cognos TM1 > IBM CognosConfiguration.

Lembre-se: Clique com o botão direito do mouse e use Run as Administratorno software de sistema operacional Windows Vista, Windows 7 e WindowsServer 2008.

2. Na área de janela Explorer do Cognos Configuration, expanda ConfiguraçãoLocal > Ambiente.


3. Clique com o botão direito do mouse em cada servidor que deseja iniciar eselecione Iniciar:a. Servidor Admin de TM1

Dica: A ferramenta Cognos Configuration solicita que você salve quaisqueredições feitas nas definições de configuração. Esse processo levará maistempo na primeira vez que você salvar uma configuração conformeconfigurações criptográficas e outras ações acontecem pela primeira vez.Clique em Sim como resposta para a mensagem solicitando que você salveas configurações. Você verá também esse tipo de mensagem ao fechar oCognos Configuration.

4. Expanda o nó Acesso a Dados > TM1 Server e clique com o botão direito domouse em cada servidor de banco de dados de amostras do Cognos TM1 quedeseja iniciar e selecione Iniciar. Por exemplo, inicie os bancos de dados deamostras fornecidos:a. SData

b. Amostra de Planejamento

c. GO_New_Stores

5. Clique em Arquivo > Salvar.6. Edite as entradas para os componentes do Cognos TM1 nos Serviços do

Windows para que elas sejam executadas sob uma conta de usuário específica.Para obter detalhes, consulte “Alterando Serviços do Cognos TM1 para SeremExecutados sob uma Conta de Usuário Específica no Windows” na página 149.

Instalando o Cognos TM1 Server no UNIX ou LinuxÉ possível instalar os componentes do servidor Cognos TM1 em um computadorde 64 bits que executa um sistema operacional UNIX ou Linux. Use este tipo deinstalação para instalar e executar o servidor Cognos TM1 em um computadordedicado que usuários remotos podem acessar.

Gerenciando Componentes após a Instalação

Após a conclusão da instalação, é possível usar o IBM Cognos Configuration paragerenciar os servidores que você quer executar. Também é possível usar os scriptsde início e parada que são fornecidos com a instalação.

Acessando e Visualizando Dados

Para visualizar e interagir com os dados armazenados em um servidor CognosTM1 em execução em um sistema UNIX, use um dos clientes Cognos TM1 em umcomputador que executa o Microsoft Windows.

Dica: É possível usar o Cognos TM1 Architect em um computador que executa oMicrosoft Windows para efetuar login remotamente em um servidor em execuçãoem um sistema UNIX.

Capítulo 7. Instalação do Cognos TM1 Server 69

Conceitos relacionados

“Atualizando o Cognos TM1 Server no UNIX ou Linux” na página 51É possível atualizar componentes do Cognos TM1 Server em um computador de64 bits executando um sistema operacional UNIX ou Linux.

Instalar os Componentes do Cognos TM1 Server nosSistemas Operacionais UNIX ou Linux

Use o assistente de instalação para selecionar os componentes do servidor parainstalação e o local de instalação no seu computador.

Para obter uma lista completa de sistemas operacionais UNIX e Linux suportados,clique na página da web Ambientes do Software Cognos TM1 do IBM CognosTM1.

Antes de Iniciar

Durante a instalação do Cognos TM1 nos sistemas operacionais UNIX ou Linux,configure os componentes para serem executados como um usuário compermissões apropriadas para binários do Cognos TM1 e bancos de dados TM1.

Para preparar a instalação do Cognos TM1, você deve concluir as tarefas descritasna lista de verificação a seguir:v Familiarize-se com os termos e conceitos do Cognos TM1.

Consulte o Guia dos Usuários do IBM Cognos TM1 e o Guia para Desenvolvedores doIBM Cognos TM1.

v Determine quais componentes deseja instalar e como eles devem ser distribuídosem seu ambiente de hardware.

Lembre-se: Somente o Cognos TM1 Admin Server e o Cognos TM1 Serverpodem ser executados no UNIX. Não é possível executar os clientes CognosTM1 ou o Cognos TM1 Web no UNIX.Para obter detalhes sobre como projetar o ambiente do TM1 ideal, consulteCapítulo 3, “Arquitetura”, na página 23 e Capítulo 4, “Transporte”, na página 37.

v Determine os requisitos de hardware e software.Consulte o Centro de Informações do IBM Cognos TM1 para os requisitos dehardware e software.Caso pretenda importar dados de outro banco de dados relacional, instaleprimeiro seu software de banco de dados.Se estiver executando o Oracle no UNIX, instale o software cliente UNIXapropriado para seu banco de dados Oracle na máquina UNIX. Use o Assistentede Configuração de Rede Oracle para especificar um nome do serviço de redelocal.

v Verifique o software X-server em sua máquina UNIX.Para executar o Assistente de Instalação do UNIX de Interface Gráfica com oUsuário, o software X-server deve ser instalado na máquina que hospedará seuscomponentes TM1. Você deve ter o software cliente X-server instalado namáquina a partir da qual você executa o Assistente de Instalação do TM1. Se osoftware X-server não estiver instalado na máquina UNIX, execute a instalaçãodo console.Se você não usar o software X-server, deverá usar uma instalação não assistida.Para obter informações adicionais, consulte Apêndice D, “ConfigurandoInstalações e Configurações Não Assistidas”, na página 285.


https://www-304.ibm.com/support/docview.wss?rs=3446&uid=swg27014444

v Instale e configure os componentes Cognos TM1 para executar como um usuáriocom permissões apropriadas para binários do Cognos TM1 e bancos de dadosdo TM1.

Procedimento1. Acesse o local no qual os arquivos de instalação foram transferidos por

download e extraídos ou insira o disco do produto.2. Acesse o diretório do sistema operacional e, em seguida, digite

./issetup

3. Siga as instruções do assistente de instalação e copie os arquivos necessáriospara seu computador.

4. Selecione os componentes que deseja instalar. Por padrão, todos oscomponentes serão instalados.

5. Na página Concluir do assistente de instalação, clique em Concluir.

Atualizar seu Ambiente JavaPara poder iniciar o IBM Cognos Configuration nos sistemas operacionais UNIX eLinux, você deve configurar a variável de ambiente JAVA_HOME.

Procedimento

Assegure que a variável de ambiente JAVA_HOME esteja configurada para umlocal do JRE válido.

Iniciar o Cognos Configuration nos Sistemas Operacionais UNIXou LinuxUse o IBM Cognos Configuration para configurar seus componentes Cognos TM1 epara iniciar e parar serviços.

Antes de Iniciar

Você deve ter configurado a variável de ambiente JAVA_HOME antes de poderiniciar o IBM Cognos Configuration.

Procedimento

Acesse o diretório install_location/bin64 e, em seguida, digite./cogconfig.sh

Iniciando o Cognos TM1 Server no UNIXÉ possível usar o IBM Cognos Configuration para iniciar e parar os servidoresCognos TM1 no UNIX. Também é possível usar os scripts de início e parada quesão fornecidos com a instalação.

Sobre Esta Tarefa

No UNIX, também é possível usar os seguintes comandos e scripts para iniciar eparar os componentes do servidor Cognos TM1. Consulte "Iniciando um UNIXTM1 Server" e "Parando um UNIX TM1 Server" no Guia de Operações do IBMCognos TM1 para obter mais detalhes.v startup_tm1admsrv.sh - iniciar Cognos TM1 Admin Serverv shutdown_tm1admsrv.sh - encerrar Cognos TM1 Admin Serverv startup_tm1s.sh - iniciar Cognos TM1 Serverv shutdown_tm1s.sh - encerrar Cognos TM1 Server


v tm1srvstop.exe - utilitário para parar o Cognos TM1 Server

Procedimento1. Inicie o IBM Cognos Configuration.2. Na janela Explorer, clique em Configuração Local > Ambiente.3. Clique com o botão direito do mouse em Cognos TM1 Admin Server e clique

em Iniciar.4. Em Acesso a Dados > Cognos TM1 Server, clique com o botão direito do

mouse em um servidor e clique em Iniciar.

Executando o Cognos TM1 no IBM AIXEsta seção contém considerações técnicas sobre como executar o Cognos TM1 nosistema operacional IBM AIX.

Configurando Limites do Recurso de Memória do IBM AIX para oCognos TM1Se você estiver executando o IBM Cognos TM1 no IBM AIX, verifique os limites derecurso de memória do AIX para ver quanta memória está disponível para oCognos TM1.

O Cognos TM1 é configurado para usar a quantidade máxima de memóriadisponível para o sistema operacional IBM AIX, conforme permitido pelaconfiguração de limite máximo do recurso de memória do AIX. Para verificar olimite máximo atual no AIX, use o comando do AIX ulimit conforme a seguir:

ulimit -d -H

Se você tiver autoridade de usuário raiz, é possível usar esse comando para alteraro limite máximo. Para obter informações adicionais sobre como usar o comandoulimit, consulte a documentação do AIX.

Usando Comandos do IBM AIX que Não Suportam Nomes deArquivos para Objetos de Controle do Cognos TM1Alguns comandos no sistema operacional IBM AIX, como sysck, não funcionamcom nomes de arquivo de objeto de controle do IBM Cognos TM1 porque essesnomes começam com o caractere }.

Por exemplo, objetos de controle Cognos TM1 geralmente possuem nomes dearquivo como }Clients.dim, }Groups.dim ou }ClientsGroups.cub.

Este problema se aplica a todos os comandos IBM AIX padrão que leem nomes dearquivos a partir de stdin, incluindo comandos e ferramentas AIX que fazembackup de dados. Estes comandos AIX falham e produzem um erro quando ocomando é usado com estes arquivos do Cognos TM1.

Nomes de Objetos e Codificação de Caracteres Cognos paraTM1 para Cognos TM1 Servers em Sistemas UNIX e Windows

As diretrizes a seguir estão relacionadas com a garantia de uma codificação decaracteres correta e consistente em nomes de objetos do Cognos TM1 para objetoscomo cubos, visualizações, dimensões e subconjuntos.


Movendo Bancos de Dados do Cognos TM1 Entre SistemasWindows e UNIXNão mova e use arquivos de banco de dados do Cognos TM1 a partir de umsistema Microsoft Windows para um sistema UNIX (ou do UNIX para o Windows)quando seus nomes de objetos do Cognos TM1 contêm caracteres não ASCII(caracteres além do conjunto de caracteres ASCII 128 original).

Este cenário é um problema devido ao possível mapeamento ou codificação decaracteres incompatíveis entre essas duas plataformas. O sistema operacionalWindows armazena nomes de diretório e do arquivo na codificação de caracteresUTF-16, enquanto o sistema operacional UNIX pode armazenar nomes usandocodificações de caracteres diferentes, dependendo de qual código de idioma estásendo usado no momento.

Por exemplo, nomes de objetos do Cognos TM1 para cubos e dimensões queincluem caracteres não ASCII não seriam exibidos corretamente nos aplicativosclientesCognos TM1 se os arquivos de banco de dados do Cognos TM1 fossemcopiados de uma plataforma e executados em uma outra na qual uma codificaçãode caracteres diferente fosse usada.

Usar o Mesmo Código de Idioma que o Sistema UNIX ao Iniciarum Servidor Cognos TM1 com Caracteres Não ASCII no NomeSe seus nomes de objetos do Cognos TM1 (para cubos, visualizações, dimensões,subconjuntos, etc.) incluírem caracteres não ASCII, use o mesmo código de idiomaao inicializar um servidor Cognos TM1 em um sistema UNIX.

Isto assegura que os nomes de objetos do Cognos TM1 e o diretório e os nomes dearquivos do Cognos TM1 relacionados no sistema UNIX sempre usem a mesmacodificação de caracteres. Iniciar o servidor Cognos TM1 com um código de idiomadiferente daquele usado anteriormente poderia fazer com que nomes de objetos doCognos TM1 fossem exibidos incorretamente se os nomes fossem criados earmazenados originalmente em um código de idioma diferente.

Por exemplo, nomes de objetos do Cognos TM1 para cubos e dimensões que sãosalvos quando o servidor está em execução sob o código de idioma en_US poderãonão ser exibidos corretamente se o servidor for reiniciado usando o código deidioma ja_JP.

Criando um novo Servidor Cognos TM1 Vazio no CognosConfiguration

É possível usar o IBM Cognos Configuration para criar um novo servidor CognosTM1 vazio.

Sobre Esta Tarefa

Estas etapas criam o arquivo de configuração tms.cfg e outros arquivos necessáriospara um novo Cognos TM1 Server vazio. Execute estas etapas somente em umdiretório vazio que não contém nenhum outro arquivo.

Dica: Se quiser incluir um TM1 Server existente no Cognos Configuration, consulte“Incluindo um Servidor Cognos TM1 Existente no Cognos Configuration” napágina 74.


Procedimento1. Use seu sistema operacional para criar uma pasta vazia para os novos

arquivos do Cognos TM1 Server.2. Abra o IBM Cognos Configuration.3. No painel Explorer, em Acesso a Dados, clique com o botão direito do mouse

em TM1 Server e clique em Novo Recurso > Instâncias do TM1 Server.4. Na caixa Nome, insira um nome para seu servidor.5. Na caixa Tipo, selecione Instância do TM1 Server e clique em OK.

O novo servidor é incluído no nó do TM1 Server e as propriedades para elesão exibidas na lista Instâncias do TM1 Server - Propriedades do Recurso.

6. Na lista Propriedades do Recurso, clique na caixa à direita do Caminho deConfiguração do TM1 Server e clique no ícone de edição.

7. Insira ou navegue até o caminho para a pasta vazia na qual deseja criar onovo servidor Cognos TM1.

Dica: Não inclua o nome do arquivo neste caminho. É necessário apenasselecionar a pasta.

8. Clique em Selecionar.9. Clique em Arquivo > Salvar.

Um novo arquivo tms.cfg é criado automaticamente na pasta. Os valores paraos parâmetros de configuração a seguir são incluídos automaticamente noarquivo.v O parâmetro ServerName é configurado com o nome do servidor

especificado.v O parâmetro DataBaseDirectory é configurado com o diretório de dados

que você especificou.v O parâmetro PortNumber é configurado com um número da porta gerado

automaticamente aleatório.10. Se estiver usando este banco de dados com o Cognos TM1 Applications, edite

o arquivo tms.cfg com os valores de parâmetros necessários. Para obterdetalhes, consulte “Configurando um Cognos TM1 Server para Trabalhar como Cognos TM1 Applications” na página 98.

11. No painel Explorer do Cognos Configuration, clique com o botão direito domouse no novo servidor e clique em Iniciar.Os arquivos básicos para o novo servidor Cognos TM1 são criados na pasta.

12. Para testar o novo servidor Cognos TM1, inicie o Cognos TM1 Architect eefetue login no banco de dados com o nome de usuário admin e nenhumasenha.

Incluindo um Servidor Cognos TM1 Existente no CognosConfiguration

É possível gerenciar um servidor Cognos TM1 existente incluindo-o no IBMCognos Configuration.

Antes de Iniciar

Este procedimento requer que você tenha um diretório de dados existente doCognos TM1 com um arquivo tm1s.cfg válido.


Procedimento1. Abra o IBM Cognos Configuration.2. No painel Explorer, em Acesso a Dados, clique com o botão direito do mouse

em TM1 Server e clique em Novo Recurso > Instâncias do TM1 Server.3. Na caixa Nome, insira o mesmo nome configurado para o parâmetro

ServerName no arquivo tm1s.cfg.4. Na caixa Tipo, selecione Instância do TM1 Server e clique em OK.

O novo servidor é incluído no nó do TM1 Server e as propriedades para elesão exibidas na lista Instâncias do TM1 Server - Propriedades do Recurso.

5. Na lista Propriedades do Recurso, clique na caixa à direita do Caminho deConfiguração do TM1 Server e clique no ícone de edição.

6. Insira ou navegue para o caminho para o diretório de dados existente doCognos TM1.

Dica: Não inclua o nome do arquivo neste caminho. É necessário apenasselecionar a pasta.

7. Clique em Selecionar.8. Clique em Arquivo > Salvar.9. No painel Explorer do Cognos Configuration, clique com o botão direito do

mouse no novo servidor e clique em Iniciar.10. Para testar esse servidor Cognos TM1, inicie o Cognos TM1 Architect e efetue

login no banco de dados.

Especificando o Local do Cognos TM1 Admin HostVocê especifica o local do IBM Cognos TM1 Admin Host de forma diferente paraclientes (interfaces com o usuário) e servidores remotos.

Sobre Esta Tarefa

O Admin Host é o computador onde o Cognos TM1 Admin Server está emexecução.

Procedimento1. Para especificar o Admin Host referido pelos clientes, como Cognos TM1

Architect ou Cognos TM1 Perspectives:v Altere o arquivo Tm1p.ini usando o menu Opções do Cognos TM1 no Server

Explorer.v Também é possível editar manualmente o parâmetro AdminHost no arquivo

de configuração do cliente Tm1p.ini.Para obter informações adicionais, consulte Apêndice C, “O Arquivo deConfiguração do Cliente Tm1p.ini”, na página 275.

2. Para especificar o Host Administrador com o qual os servidores remotos sãoregistrados, use um dos seguintes métodos:v Edite o parâmetro AdminHost no arquivo Tm1s.cfg.v Use o parâmetro da linha de comandos -v ao fazer referência à versão do

Windows do servidor Cognos TM1.Para obter informações adicionais, consulte Apêndice B, “O Arquivo deConfiguração do Servidor Tm1s.cfg”, na página 231.


Especificando diversos Cognos TM1 Admin HostsÉ possível configurar um cliente IBM Cognos TM1 para referência de diversosAdmin Hosts separando nomes de host com pontos e vírgulas.

Sobre Esta Tarefa

Um cliente que especifica diversos Admin Hosts pode acessar quaisquer servidoresCognos TM1 registrados com Cognos TM1 Admin Servers nos hosts especificados.

Procedimento

Para especificar diversos Admin Hosts referidos por clientes, como Cognos TM1Architect ou Cognos TM1 Perspectives, separe os nomes de host com pontos evírgulas:v Altere o arquivo Tm1p.ini usando o menu Opções do Cognos TM1 no Server

Explorer.v Também é possível editar manualmente o parâmetro AdminHost no arquivo de

configuração do cliente Tm1p.ini.

Para obter informações adicionais, consulte Apêndice C, “O Arquivo deConfiguração do Cliente Tm1p.ini”, na página 275.


Capítulo 8. Instalação do Cognos TM1 Web

É possível instalar o IBM Cognos TM1 Web em um computador separado daqueleonde você instalou o Cognos TM1 Server e outros componentes do Cognos TM1.

O Cognos TM1 Web deve ser instalado em um servidor da web que executa oMicrosoft Internet Information Services (IIS).

Após ter instalado o Cognos TM1 Web Server no computador separado, edite oarquivo web.config para identificar o computador remoto no qual o Cognos TM1Admin Server está em execução.

Para obter detalhes sobre a arquitetura e a implementação do Cognos TM1 Web,consulte:v “Arquitetura do Cognos TM1 Web” na página 29v “Implementando o Cognos TM1 Web” na página 39

Lista de Verificação para Instalar o Cognos TM1 Web

Os itens a seguir são obrigatórios.1. Verificar se o software obrigatório para o Cognos TM1 Web foi instalado no

servidor da web.2. Ative a opção IIS 6 IIS 6 Management Compatibility para executar o Cognos

TM1 Web com IIS 7 no Windows Vista, Windows 7 e Windows Server 2008 por.

3. Instalar o Cognos TM1 Web.4. Usar o Cognos Configuration para iniciar o serviço do Cognos TM1 Excel.5. Configure o Cognos TM1 Excel Service para executar como um usuário

específico em Serviços do Windows.6. Editar o arquivo web.config do Cognos TM1 Web para suportar um ambiente

operacional múltiplo.7. Configure o servidor da Web e os computadores clientes para que os usuários

possam exportar dados do Cognos TM1 para o formato PDF do Cognos TM1Web.

8. Executar e testar o Cognos TM1 Web a partir de seu ambiente de rede.Conceitos relacionados

“Atualizando o Cognos TM1 Web” na página 52Se você tiver o IBM Cognos TM1 Web em um computador separado daquele noqual instalou o Cognos TM1 Server, execute estas etapas para atualizar o servidorda Web.

Instalar Software Obrigatório para Cognos TM1 WebSão necessários alguns softwares obrigatórios no servidor da web antes de instalaro IBM Cognos TM1 Web.


Antes de Iniciar

Consulte Ambientes de Software do Cognos TM1 10.1.0 (www.ibm.com/support/docview.wss?uid=swg27021976) para obter as informações mais recentes sobresoftware obrigatório.

Procedimento1. Instale ou confirme se você possui:

v Software de servidor da web Microsoft Internet Information Services (IIS).Se você já tiver este software instalado, a instalação do IBM Cognos TM1configurará o IBM Cognos TM1 Web para executar com sua instalação do IISexistente.Este software é usado pelo Cognos TM1 Perspectives ou pelo Cognos TM1Architect.

2. Instale ou confirme se você possui:v Microsoft .NET Framework 3.5 Service Pack 1v Microsoft Chart Controls para Microsoft .NET Framework 3.5Este software é usado pelo Cognos TM1 Web e pelo Cognos TM1 ApplicationServer.

Configurar IIS 7 para Executar Cognos TM1 Web on Windows Vista,Windows 7 e Windows Server 2008

Antes da instalação do Cognos TM1 Web no Windows Vista, Windows 7 ouWindows Server 2008, ative a opção Internet Information Services (IIS) 6Management Compatibility no sistema operacional.

Sobre Esta Tarefa

Se a opção IIS 6 Management Compatibility não estiver ativada, os diretóriosvirtuais necessários para o Cognos TM1 Web não serão criados durante o processode instalação.

Para obter detalhes sobre a ativação dessa opção, procure no Web site da Microsoft“IIS 6 Management Compatibility”.

Procedimento

Ative o IIS 6 Management Compatibility:v No Windows Vista e Windows 7, use a ferramenta Ativar/Desativar Recursos do

Windows (disponível no Painel de Controle do Windows, Programas) paraativar as opções e subopções do Internet Information Services, Web ManagementTools, incluindo a opção IIS 6 Management Compatibilitys.

v No Windows Server 2008, use a ferramenta Windows Server Manager paraativar a opção IIS 6 Management Compatibility e as subopções para o serviço defunção do Servidor da Web (IIS).

Instalar e Configurar o Cognos TM1 WebAqui estão descritas as etapas de instalação para o IBM Cognos TM1 Web.



Sobre Esta Tarefa

Quando o IBM Cognos TM1 Web estiver instalado em um computador separado,edite o arquivo web.config para identificar o computador separado para o softwaredo servidor da Web.

Procedimento1. Execute o programa de instalação que corresponda ao tipo de computador que

está sendo usado para o Cognos TM1 Web:v 32 bits para Windowsv 64 bits para Windows

2. No software do sistema operacional Microsoft Windows Vista, Windows 7 ouWindows Server 2008, clique com o botão direito do mouse no comandoissetup.exe e clique em Run as Administrator. Para outros sistemasoperacionais, dê um clique duplo no arquivo issetup.exe.

3. Selecione somente o componente Camada do Aplicativo da Web > TM1 Web.Cancele a seleção de todos os outros componentes.

4. Siga os prompts no assistente de instalação para concluir a instalação.5. Inicie o IBM Cognos Configuration.

Atenção: Se você instalou o produto a partir do diretório de Arquivos deProgramas (x86) em um computador executando o software de sistemaoperacional Windows Vista, Windows 7 ou Windows Server 2008, inicie o IBMCognos Configuration como Administrador.

6. Clique com o botão direito do mouse em Serviço do TM1 Excel e clique emIniciar.Isto registra o Cognos TM1 Excel Service para executar como um serviço doWindows.

7. Configure o Cognos TM1 Excel Service para executar como um usuárioespecífico em Serviços do Windows.a. No Cognos Configuration, clique com o botão direito do mouse em

Serviço do TM1 Excel e selecione Parar.b. Abra Serviços do Windows e localize a entrada para o IBM Cognos TM1

Excel Service.c. Clique com o botão direito do mouse em IBM Cognos TM1 Excel Service

e selecione Propriedades.d. Insira um usuário e uma senha para um usuário do Windows existente

com os direitos apropriados.e. Feche Serviços do Windows.f. No Cognos Configuration, inicie o Serviço do TM1 Excel.

Para obter mais detalhes, consulte “Contas de Usuário para Execução deServiços do Cognos TM1 no Windows” na página 17 e “Alterando Serviços doCognos TM1 para Serem Executados sob uma Conta de Usuário Específica noWindows” na página 149

8. Use um editor de texto para atualizar os parâmetros AdminHostName eTM1ServerName no arquivo web.config do Cognos TM1 Web.Esses parâmetros permitem que o Cognos TM1 Web localize os servidoresCognos TM1 Admin Server e Cognos TM1 em sua rede.É possível localizar o arquivo web.config em:<Cognos TM1_installation_location>/TM1Web.

Capítulo 8. Instalação do Cognos TM1 Web 79

Consulte “Configurando a Página de Login Usando AdminHostName eTM1ServerName” para obter detalhes sobre estes parâmetros.

9. Para permitir que usuários exportem dados do Cognos TM1 para o formatoPDF do Cognos TM1 Web, assegure-se de que os computadores clientesestejam configurados corretamente. Para obter detalhes, consulte“Configurando Computadores Clientes para Exportar Dados do Cognos TM1em Formato PDF” na página 65.

10. Confirme se o Cognos TM1 Web está em execução inserindo a URL para oCognos TM1 Web em um navegador da web. Por exemplo:http://localhost/tm1web

Em um computador remoto, substitua localhost pelo nome ou endereço IPdo computador no qual o Cognos TM1 Web está em execução.

11. Consulte o seguinte tópico para obter detalhes sobre como configurar opçõesavançadas adicionais para o Cognos TM1 Web:

Configurando a Página de Login Usando AdminHostName eTM1ServerName

Os parâmetros AdminHostName e TM1ServerName controlam se a página delogin do IBM Cognos TM1 Web solicitará ou não que o usuário insira valores parao Host Administrador do TM1 e o servidor TM1 .

Se você definir um valor para qualquer um destes parâmetros no arquivoWeb.config, o processo de login usará o valor especificado e não solicitará estasinformações do usuário.

Parâmetro AdminHostName

Esse parâmetro especifica o nome do Host Administrador no qual um ServidorAdministrativo TM1 está em execução. Edite o parâmetro AdminHostName noarquivo Web.config usando o seguinte formato:<add key="AdminHostName" value="HostName"/>

em que HostName pode ser um dos seguintes valores:v Se HostName estiver em branco (valor-padrão), a página de login exibirá o

prompt do Host Admin.v Se HostName estiver configurado com o nome de um Host Administrador válido

do TM1 , o IBM Cognos TM1 Web usará esse Host Administrador para oprocesso de login e não solicitará informação do usuário.

Parâmetro TM1ServerName

Esse parâmetro configura o nome do servidor TM1 . Edite o parâmetroTM1ServerName no arquivo Web.config usando o seguinte formato:<add key="TM1ServerName" value="ServerName"/>

em que ServerName pode ser um dos seguintes valores:v Se ServerName estiver em branco (valor padrão), o prompt do servidor TM1 será

exibido na página de login do IBM Cognos TM1 Web, conforme mostrado aseguir.

v Se ServerName estiver configurado para um nome do servidor TM1 válido, apágina de login não exibirá um prompt para o Host Administrador nem para oservidor TM1 .


v Se o parâmetro AdminSvrSSLCertID estiver configurado incorretamente, a listasuspensa do nome do servidor será exibirá como vazia e será registrado um errono arquivo TM1Web.config. Consulte "Running TM1 in Secure Mode using SSL"no IBM Cognos TM1 Operation Guide para obter mais informações.

Depois que o usuário inserir um Nome de Usuário e uma Senha válidos, o IBMCognos TM1 Web efetuará login no servidor TM1 especificado pelo parâmetroTM1ServerName no arquivo Web.config.

Por exemplo, o parâmetro TM1ServerName pode ser definido para amostra deplanejamento, conforme mostrado no código a seguir.<add key="TM1ServerName" value="planning sample" />

Capítulo 8. Instalação do Cognos TM1 Web 81


Capítulo 9. Instalação do Cognos TM1 Applications

É possível instalar os componentes do servidor de aplicativos da web para o IBMCognos TM1 Applications em um computador dedicado separado para que osusuários em um ambiente de rede possam acessar o programa. Estes componentesincluem o Cognos TM1 Applications Server e o Cognos TM1 Application Gateway.

O Cognos TM1 Applications Server requer a implementação em um servidor deaplicativos da web baseado em Java. Ao instalar o Cognos TM1 Applications,primeiro determine qual dos servidores de aplicativos da web a seguir você desejausar:v o servidor de aplicativos da web Apache Tomcat fornecidov sua própria instalação do Apache Tomcatv sua própria instalação do IBM Websphere Application Server

Para obter detalhes sobre a arquitetura e a implementação do Cognos TM1Applications, consulte:v “Arquitetura do Cognos TM1 Applications” na página 31v “Implementando o Cognos TM1 Applications” na página 39

Implementando com a Versão Fornecida do Tomcat

A maneira mais rápida e mais fácil de instalar e implementar o Cognos TM1Application Server é usar a versão do Apache Tomcat que é fornecida e instaladacom o programa de instalação do IBM Cognos TM1. Esta maneira usa o CognosConfiguration para iniciar e parar o Cognos TM1 Application Server.

Para obter detalhes, consulte “Instalando o Cognos TM1 Applications com oApache Tomcat Fornecido” na página 84.

Implementando em seu Próprio Servidor de Aplicativos da Web

Para implementar o Cognos TM1 Applications Server com sua própria instância deum servidor de aplicativos da web baseado em Java, use o IBM CognosConfiguration para primeiro criar o archive de aplicativo da web pmpsvc.war e, emseguida, implemente manualmente o arquivo.

Para obter detalhes, consulte os seguintes tópicos:v “Instalar o Cognos TM1 Applications com sua Própria Instalação do Servidor de

Aplicativos da Web do Apache Tomcat” na página 88v “Instalar o Cognos TM1 Applications com sua Própria Instalação do IBM

Websphere” na página 92

Cognos TM1 Applications com Windows x64

Ao executar o Cognos TM1 Applications em um sistema Microsoft Windows x64,use as mesmas versões de 32 bits ou 64 bits do servidor da web Java RuntimeEnvironment (JRE) e Apache Tomcat. Não misture versões de plataformas. Porexemplo, se estiver usando a versão de 64 bits do JRE, você também deverá usar aversão de 64 bits do Apache Tomcat.


Microsoft IIS e Cognos TM1 Web

Além de requerer um servidor de aplicativos da web baseado em Java, o CognosTM1 Applications também requer Microsoft Internet Information Services (IIS) parasuportar o cliente Cognos TM1 Applications Web. Para obter mais detalhes,consulte “Configurando o Cognos TM1 Applications com o Microsoft IIS” napágina 167

Instalando o Cognos TM1 Applications com o Apache TomcatFornecido

É possível instalar o Cognos TM1 Applications em um computador separado eimplementá-lo com a instância do Apache Tomcat fornecida com a instalação.

Esta instalação é destinada para um ambiente no qual o Cognos TM1 AdminServer e o Cognos TM1 Server estão em execução em um outro computador.

Instalando o Cognos TM1 ApplicationsEste tópico fornece as etapas para instalar os arquivos necessários para o IBMCognos TM1 Applications em um computador separado.

Sobre Esta Tarefa

Use um dos programas de instalação a seguir para instalar o Cognos TM1Applications:v IBM Cognos TM1 32 Bits para Windowsv IBM Cognos TM1 64 Bits para Windows

Lembre-se: Se planeja usar o cliente Cognos TM1 Web com o Cognos TM1Applications, é necessária uma instalação do Cognos TM1 Web no mesmocomputador ou em um computador diferente em sua rede. Para instalar o CognosTM1 Web em um computador diferente, consulte Capítulo 8, “Instalação doCognos TM1 Web”, na página 77

Procedimento1. Se estiver instalando o Cognos TM1 Web no mesmo computador, instale o

software obrigatório.Para obter detalhes, consulte “Instalar Software Obrigatório para Cognos TM1Web” na página 77.

2. Nos softwares de sistema operacional Microsoft Windows Vista, Windows 7 ouWindows Server 2008, clique com o botão direito do mouse no comandoissetup.exe e clique em Run as Administrator. Para outros sistemasoperacionais, dê um clique duplo no arquivo issetup.exe.

3. No programa de instalação, selecione apenas os seguintes componentes:v Gateway do TM1 Application

v TM1 Application Server

v TM1 Web - Este componente é opcional. Selecione isto para instalar oCognos TM1 Web no mesmo computador que o Cognos TM1 Applications.

4. Siga os prompts para concluir a instalação.


Implementando o Cognos TM1 Application Server com oServidor de Aplicativos da Web Tomcat Fornecido

O IBM Cognos TM1 Application Server é executado no servidor de aplicativos daweb Apache Tomcat fornecido com a instalação. Use o Cognos Configuration paraimplementar e iniciar o Apache Tomcat antes de usar o Cognos TM1 Applications.

Procedimento1. Clique em Iniciar > Todos os Programas > IBM Cognos TM1 > IBM Cognos

Configuration.Se você instalou o produto a partir do diretório de Arquivos de Programas(x86) em um computador que executa o software do sistema operacionalWindows Vista, Windows 7 ou Windows 2008, inicie o IBM CognosConfiguration como um Administrador.

2. No painel Explorer do Cognos Configuration, expanda o nó ConfiguraçãoLocal > Ambiente, clique com o botão direito do mouse em TM1 ApplicationServer e selecione Iniciar.Isto iniciará a versão fornecida do Tomcat e, em seguida, implementará einiciará o servidor Cognos TM1 Application.

3. Clique em Arquivo > Salvar e feche IBM Cognos Configuration.

Configurando a Segurança de Autenticação para o CognosTM1 Applications

Para os servidores IBM Cognos TM1 usados com Cognos TM1 Applications, use aautenticação de segurança padrão do TM1 ou a segurança do IBM Cognos.

Sobre Esta Tarefa

Configure o modo de login de autenticação usando o parâmetroIntegratedSecurityMode no arquivo Tm1s.cfg de cada servidor Cognos TM1 quedeseja usar.

O Cognos TM1 Applications é compatível somente com os seguintes modos deautenticação de segurança do TM1:v Modo de Autenticação 1 - Autenticação de segurança padrão do TM1v Modo de Autenticação 5 - Segurança do IBM Cognos

Importante: Não use uma combinação de diferentes modos de autenticação desegurança para a mesma instalação do Cognos TM1 Applications.

Para a melhor prática, determine o modo de segurança antes de configurar oCognos TM1 Applications para usar um servidor Cognos TM1 e use esse mesmomodo de segurança com quaisquer servidores adicionais que você incluir.

Para obter mais detalhes sobre autenticação de segurança e o parâmetroIntegratedSecurityMode, consulte:v “Segurança da Autenticação” na página 171v “IntegratedSecurityMode” na página 247

Procedimento1. Abra o arquivo TM1 server data directory/Tm1s.cfg

2. Configure o parâmetro IntegratedSecurityMode para o Cognos TM1 Server.

Capítulo 9. Instalação do Cognos TM1 Applications 85

v Para usar a autenticação de segurança padrão do Cognos TM1, configureIntegratedSecurityMode=1

v Para usar a segurança do IBM Cognos, configure IntegratedSecurityMode=5

Para obter detalhes sobre como usar a segurança do IBM Cognos, consulte:v “Usando o Cognos TM1 Applications com a Segurança do Cognos Business

Intelligence” na página 162v “Usando a Segurança do Cognos com o Cognos TM1 ” na página 197

3. Salve e feche o arquivo Tm1s.cfg.4. Reinicie o Cognos TM1 Server.5. Repita estas etapas para qualquer outro Cognos TM1 Server que deseja usar

com o Cognos TM1 Applications.

Configurando o Ambiente do Servidor e do Cliente para oCognos TM1 Applications

Antes de usar o IBM Cognos TM1 Applications, é necessário especificar o CognosTM1 Admin Host, o Cognos TM1 Server e as interfaces com o usuário do clienteque você deseja usar. Na primeira vez em que você inicia o Cognos TM1Applications, o programa solicita que você configure estas opções.

Antes de Iniciar

Assegure que o Cognos TM1 Admin Server e pelo menos um Cognos TM1 Serveresteja em execução no computador local ou em um computador remoto que vocêpossa acessar.

Assegure que cada Cognos TM1 Server que você deseja usar esteja configuradocom os valores de parâmetro necessários. Para obter detalhes, consulte“Configurando um Cognos TM1 Server para Trabalhar com o Cognos TM1Applications” na página 98.

Se planeja usar o cliente Cognos TM1 Web, assegure que o servidor da webMicrosoft Internet Information Services esteja configurado para hospedar oconteúdo do Cognos TM1 Web.

Procedimento1. Inicie e efetue login no Cognos TM1 Applications:

a. Em um navegador da web, digite a URL para o Cognos TM1 Applications:http://localhost:9510/pmpsvc

b. Substitua localhost pelo nome do computador no qual o Cognos TM1Application Server está instalado.

2. Abra a página do Cognos TM1 Application Configuration:v Se esta for a primeira vez que o Cognos TM1 Applications foi iniciado desde

a instalação, a página da web do Cognos TM1 Application Configurationserá aberta.

v Se o Cognos TM1 Applications já tiver sido configurado, será solicitado quevocê forneça um nome de usuário e uma senha e, em seguida, será possívelabrir a página de configuração clicando no ícone Administrar IBM Cognos

TM1 Applications na barra de ferramentas da página principal doCognos TM1 Applications.

3. No campo Host Administrativo, insira o nome ou o endereço IP docomputador no qual o Cognos TM1 Admin Server está em execução.


Nota: Os campos Host Administrativo e Nome do Servidor aparecerão embranco se você não tiver iniciado o Cognos TM1 Admin Server e pelo menosum servidor Cognos TM1.

4. No campo Nome do Servidor, insira o nome do Cognos TM1 Server que desejausar com o Cognos TM1 Application.Por exemplo, o servidor Cognos TM1 de amostra é nomeado GO_new_stores.Clique no botão Atualizar para atualizar a lista de servidores disponíveis.

5. Selecione os clientes de contribuição de dados que deseja usar com o CognosTM1 Applications.Estes clientes estarão disponíveis quando você criar aplicativos com o IBMCognos TM1 Performance Modeler.v Incluir Cognos Insight - Conectado - Cliente IBM Cognos Insight usando

processamento em tempo real com o servidor Cognos TM1.v Incluir Cognos Insight - Distribuído - Cliente IBM Cognos Insight com

processamento local de dados. Os dados são atualizados no servidor CognosTM1 somente quando uma ação de confirmação de dados é executada.

v Incluir TM1 Application Web - Cliente Padrão. O processamento é emtempo real com o servidor. Esta opção usa a grade de dados e ainfraestrutura do cliente em gráfico do Cognos TM1 Web e requer que vocêinsira um valor para a opção URL do TM1 Application Web.

6. Se você selecionou a opção Incluir TM1 Application Web, insira um valor paraa opção URL do TM1 Application Web.Esta URL aponta para o arquivo contributor.aspx no servidor da web doMicrosoft Internet Information Services (IIS) que está hospedando o CognosTM1 Web.Por exemplo: http://WebServer/TM1Web/contributor.aspxem que WebServer é o nome do computador no qual o Cognos TM1 Web estáinstalado.

7. Clique em OK.8. Se solicitado, insira o nome de usuário e a senha para o servidor e clique em

Login.

Dica: Use admin e apple para o nome de usuário e a senha se estiver usandoum dos bancos de dados de amostras instalados.A página principal do Cognos TM1 Applications é exibida. Esta página apareceem branco até você construir e implementar aplicativos dentro do Cognos TM1Applications. Para obter mais detalhes, consulte a documentação do IBMCognos Performance Modeler e do IBM Cognos Insight.

Resultados

A mensagem a seguir indica que o servidor Cognos TM1 que você está usando nãoestá configurado corretamente para ser usado com o Cognos TM1 Applications:

The new server can be added but it may not be configured with all theoptions required by IBM Cognos TM1 Applications.

Para obter informações sobre como configurar esse servidor, consulte“Configurando um Cognos TM1 Server para Trabalhar com o Cognos TM1Applications” na página 98.


Instalar o Cognos TM1 Applications com sua Própria Instalação doServidor de Aplicativos da Web do Apache Tomcat

Esta seção descreve como instalar o Cognos TM1 Applications em um computadorseparado e implementá-lo com sua própria instalação do Apache Tomcat.

Esta instalação é destinada para um ambiente no qual o TM1 Admin Server e oTM1 Server estão em execução em um outro computador.


Sobre Esta Tarefa










Usar o IBM Cognos Configuration para Construir um Arquivode Aplicativo para um Servidor Tomcat

Use o IBM Cognos Configuration para construir o arquivo de aplicativo paraimplementar em seu servidor Apache Tomcat.

Sobre Esta Tarefa

É possível criar um arquivo Web Archive (WAR) ou um arquivo Enterprise Archive(EAR). Para obter informações sobre arquivos WAR e EAR e qual é suportado por


seu servidor de aplicativos, consulte a documentação para seu servidor deaplicativos.


Configuration.2. Clique em Ação > Construir Arquivo de Aplicativo.3. Marque o tipo de servidor de aplicativos Apache Tomcat. Clique em Avançar.4. Selecione o tipo de arquivo: arquivo WAR. O local padrão é <your

installation location>\ibm\cognos\TM1\pmpsvc.war. Clique em Avançar.5. Aguarde o Assistente para Construção de Aplicativo concluir os processos.

Clique em Concluir.

O que Fazer Depois

É possível implementar o arquivo de aplicativo em seu servidor de aplicativos.Para obter informações sobre como implementar aplicativos, consulte suadocumentação do servidor de aplicativos.



Sobre Esta Tarefa







2. Configure o parâmetro IntegratedSecurityMode para o Cognos TM1 Server.v Para usar a autenticação de segurança padrão do Cognos TM1, configure










Antes de Iniciar





















Login.


Resultados





Instalar o Cognos TM1 Applications com sua Própria Instalação doIBM Websphere

Esta seção descreve como instalar o Cognos TM1 Applications em um computadorseparado e implementá-lo com sua própria instalação do IBM Websphere.

Esta instalação é destinada a um ambiente no qual o TM1 Admin Server e o TM1Server estão em execução em um outro computador.


Sobre Esta Tarefa










Usando o IBM Cognos Configuration para Construir umArquivo de Aplicativo para um IBM Websphere

Use o IBM Cognos Configuration para construir o arquivo de aplicativo paraimplementar em seu servidor IBM Websphere.

Sobre Esta Tarefa

É possível criar um arquivo Web Archive (WAR) ou um arquivo Enterprise Archive(EAR). Para obter informações sobre arquivos WAR e EAR e qual é suportado por


seu servidor de aplicativos, consulte a documentação para seu servidor deaplicativos.


Configuration.2. Clique em Ação > Construir Arquivo de Aplicativo.3. Marque o tipo de servidor de aplicativos IBM Websphere. Clique em Avançar.4. Selecione o tipo de arquivo: arquivo WAR. O local padrão é <your

installation location>\ibm\cognos\TM1\pmpsvc.war. Clique em Avançar.5. Aguarde o Assistente para Construção de Aplicativo concluir os processos.

Clique em Concluir.

O que Fazer Depois

É possível implementar o arquivo de aplicativo em seu servidor de aplicativos.Para obter informações sobre como implementar aplicativos, consulte suadocumentação do servidor de aplicativos.

Implementar o Cognos TM1 Application Server com oWebSphere Application Server

Use o IBM WebSphere Administrative Console para implementar e executar oCognos TM1 Applications com o WebSphere Application Server.

Procedimento1. Inicie o WebSphere Application Server.

No Microsoft Windows, clique em Iniciar > Programas > IBM WebSphere >Application Server > Iniciar o Servidor.Uma janela de comando será aberta e exibirá o progresso da inicialização.Após o processo de inicialização ser concluído, a janela de comando exibirá amensagem "Servidor Iniciado". É possível minimizar esta janela de comando,mas não fechá-la. Esta janela deve permanecer aberta enquanto o WebSphereestá em execução.

2. Abra o WebSphere Administrative Console.No Windows, clique em Iniciar, Programas, IBM WebSphere, ApplicationServer, Console Administrativo.Insira seu nome de usuário e senha do WebSphere ou use o nome de usuáriopadrão do WebSphere, system, e a senha, manager.Após um login bem-sucedido, a página do WebSphere AdministrativeConsole é aberta.

3. Na área de janela Navegação do Console, localize a seção Aplicativos e cliqueem Implementar Novo.A página Instalar Novos Aplicativos é aberta.

4. Clique no botão Navegar próximo à caixa de texto Archive para localizar eselecionar o arquivo do Cognos TM1 Applications, pmpsvc.war, que vocêgerou usando o comando Construir Arquivo de Aplicativo no CognosConfiguration.

5. Clique em Abrir após selecionar o arquivo pmpsvc.war.6. Mantenha as outras opções de implementação configuradas com seus valores

padrão da seguinte forma:v O campo Plano deve ficar em branco.


v A caixa de seleção Iniciar aplicativo após instalação deve ser selecionada.v A caixa de seleção Reimplementar aplicativo não deve ser selecionada.

7. Clique em Instalar.O WebSphere instala o aplicativo Cognos TM1 Application Web. Esse processopode levar alguns minutos para ser concluído. Quando concluído, as seguintesmensagens são exibidas:O aplicativo foi implementado com sucesso.

O aplicativo foi iniciado com sucesso.

8. Para confirmar a instalação, clique em Web App WARs na seção Aplicativosda área de janela Navegação do Console pane.A página Aplicativos da Web Instalados é aberta.O Cognos TM1 Applications é listado com um link na coluna URL como/pmpsvc.Esse link fornece o Localizador Uniforme de Recursos completo para ativar oaplicativo. Por exemplo:https://localhost:8443/pmpsvc

9. Para abrir o Cognos TM1 Applications, clique no link /pmpsvc.10. Para gerenciar o aplicativo Cognos TM1 Application Web, use os links do

WebSphere para Parar, Reiniciar e Desinstalar.

Implementação de Resolução de Problemas com o IBMWebSphereSe a implementação do TM1 Applications falhar com uma mensagem de erro deespaço de heap Java, tente ajustar o parâmetro JAVA_OPTS no arquivo WebSpheresetenv.bat.

Nota: Pode ser necessário reaplicar esta mudança se você fizer upgrade oumodificar sua instalação do WebSphere em uma data posterior.

Procedimento1. Abra o arquivo WebSphere setenv.bat.

O local típico desse arquivo é:C:\Program Files\IBM\WebSphere\AppServer\bin

2. Inclua ou edite a seguinte linha da seguinte forma:set JAVA_OPTS=-Xmx512M

3. Reinicie o WebSphere.No Windows, clique em Iniciar > Programas > IBM WebSphere > ApplicationServer e inicie ou pare o servidor.



Sobre Esta Tarefa








2. Configure o parâmetro IntegratedSecurityMode para o Cognos TM1 Server.v Para usar a autenticação de segurança padrão do Cognos TM1, configure









Antes de Iniciar






















Login.


Resultados




Determinando o Link de Inicialização da URL para Cognos TM1Applications

O link exato para iniciar e efetuar logon no Cognos TM1 Applications depende dequal servidor da web você está executando e como ele é configurado.

Parâmetros de Link

Use o formato a seguir para a URL para efetuar login no Cognos TM1Applications.

https://WebServer:PortNumber/pmpsvc

Tabela 15. Cognos TM1 Applications - Parâmetros de URL

Parâmetro Descrição

WebServer Pode ser um dos seguintes:

A palavra-chave localhost se você tiver efetuado logon no servidorda web que está executando o Cognos TM1 Applications.

O nome da máquina ou o nome de domínio do servidor da webque hospeda o aplicativo Cognos TM1 Application Web.

O endereço IP do servidor da web que hospeda o aplicativoCognos TM1 Application Web.


Tabela 15. Cognos TM1 Applications - Parâmetros de URL (continuação)


PortNumber O número da porta configurado com o servidor de aplicativos daWeb.

O IBM WebSphere - Clique no link Servidor da Web no ConsoleAdministrativo do WebSphere para visualizar e editarconfigurações de porta.

Apache Tomcat - Abra o arquivo do Apache Tomcat server.xml noseguinte local para visualizar e editar as configurações de porta:

C:\Program Files\Apache Software Foundation\Tomcat6.0\conf\server.xml.

Exemplos de Link

Tabela 16. Cognos TM1 Applications - Exemplos de Link

Servidor deAplicativos da Web Cabeçalho

Apache Tomcatfornecido com ainstalação

O link padrão ao usar a versão fornecida do Tomcat é:

http://localhost:9510/pmpsvc

Apache Tomcat O link usual para o Cognos TM1 Applications com Apache Tomcaté:

http://localhost:8085/pmpsvc

IBM WebSphereApplication Server

O link usual para o Cognos TM1 Applications em execução no IBMWebSphere Application Server é:

https://localhost:8443/pmpsvc

Configurando um Cognos TM1 Server para Trabalhar com o CognosTM1 Applications

Antes de usar o IBM Cognos TM1 Server com o IBM Cognos TM1 Applications,edite o arquivo de configuração do servidor para incluir os parâmetros e valoresnecessários.

Sobre Esta Tarefa

Os parâmetros de configuração a seguir no arquivo Tm1s.cfg do Cognos TM1Server suportam diferentes subcomponentes do Cognos TM1 Applications.v Parâmetro AllowSeparateNandCRules - suporta Cognos TM1 Performance

Modeler com o Cognos TM1 Applications.Consulte o “AllowSeparateNandCRules” na página 233.

v Parâmetro DistributedPlanningOutputDir - suporta o cliente Cognos Insight -Distributed com o Cognos TM1 Applications.Consulte o “DistributedPlanningOutputDir” na página 244.

Procedimento1. Abra o arquivo de configuração do servidor do Cognos TM1 Server, Tm1s.cfg.2. Para suportar o Cognos TM1 Performance Modeler, edite ou inclua a linha a

seguir:


AllowSeparateNandCRules=T

3. Para suportar o cliente Cognos Insight – Distributed, edite ou inclua a linha aseguir:DistributedPlanningOutputDir=.\tunit

4. Salve o Tm1s.cfg.5. Reinicie o Cognos TM1 Server.6. Repita estas etapas para qualquer outro Cognos TM1 Server que deseja usar




Capítulo 10. Instalação do Cliente Cognos TM1

É possível instalar os componentes do cliente IBM Cognos TM1 usando oprograma de instalação do servidorCognos TM1 ou o programa de instalação docliente Cognos TM1.

É possível instalar os seguintes componentes do cliente:v Cognos TM1 Perspectivesv Cognos TM1 Architectv Cognos TM1 Performance Modelerv Cognos InsightConceitos relacionados

“Atualizando os Clientes Cognos TM1 Architect e Perspectives” na página 52É possível atualizar os componentes do cliente IBM Cognos TM1 e o programa deinstalação do Cognos TM1 Server ou programa de instalação do Cognos TM1Client.

Instalando o Cognos TM1 PerspectivesÉ possível instalar o IBM Cognos TM1 Perspectives executando as seguintesetapas.

Antes de Iniciar

Antes de instalar o IBM Cognos TM1 Performance Modeler, conclua as seguintestarefas:1. Instale o software que é necessário para a execução do Cognos TM1

Perspectives. Para obter informações adicionais, consulte “Instalar SoftwareObrigatório” na página 57.

2. Assegure-se de que o Cognos TM1 Admin Server e o Cognos TM1 Server aosquais deseja se conectar estejam em execução em um computador acessível emsua rede. Para obter detalhes, consulte Capítulo 7, “Instalação do Cognos TM1Server”, na página 67.

3. Assegure-se de que os usuários tenham acesso aos servidores Cognos TM1 queeles precisam usar em execução no Cognos TM1 Admin Server. Comoadministrador do Cognos TM1, você deve configurar um nome de usuário euma senha para cada usuário antes de poder acessar esse servidor.

Sobre Esta Tarefa

As etapas a seguir instalam o Cognos TM1 Perspectives em um único computador,configuram-no para localizar um Cognos TM1 Administration Server em sua redee o conectam a um servidor. Também é possível criar uma instalação não assistida.

Atenção: Se estiver atualizando e deixar os antigos arquivos de configuração docliente Tm1p.ini em vigor, talvez você precise atualizar o caminho do diretório noarquivo para o parâmetro AdminSvrSSLCertAuthority. Por exemplo, se você estiverusando o certificado SSL do Cognos TM1 padrão, altere manualmente o valordesse parâmetro para o novo caminho de instalação C:\ProgramFiles\IBM\cognos\tm1\bin\ssl\applixca.pem.


Procedimento1. Instale o Cognos TM1 Perspectives:

a. No software do sistema operacional Microsoft Windows Vista, Windows 7ou Windows Server 2008, clique com o botão direito do mouse no comandoissetup.exe e clique em Run as Administrator. Para outros sistemasoperacionais, dê um clique duplo no arquivo issetup.exe no disco deinstalação do cliente IBM Cognos TM1 ou a partir do local onde os arquivosde instalação do cliente Cognos TM1 foram transferidos por download eextraídos.

b. Na página Seleção do Componente, expanda Camada do TM1 Client,expanda Camada do Desenvolvedor e selecione a caixa de seleçãoPerspectivas.Deixe todas as outras caixas de seleção desmarcadas.

c. Siga os prompts e clique em Concluir para concluir a instalação.2. Execute o Cognos TM1 Perspectives:

a. Clique em Iniciar > IBM Cognos TM1 > Perspectivas para MS Excel. Se ocomponente não iniciar, assegure que os servidores iniciados com o CognosConfiguration ainda estejam em execução.

b. Clique em Ativar Macros quando o aviso de segurança for exibido.3. Configure o Cognos TM1 Perspectives para localizar um Cognos TM1 Admin

Server:a. No Microsoft Excel, clique em TM1 > Opções. A caixa de diálogo Opções

do TM1 é aberta.b. No campo Host Administrativo, especifique o nome do computador no

qual o Cognos TM1 Admin Server está em execução. Se desejar acessarservidores registrados em Servidores Administrativos diferentes, use umponto e vírgula para separar o nome de cada Host Administrativo. Vocêdeve inserir um nome, não um endereço IP, no campo Host Administrativo.

c. Clique em OK.d. Quando perguntado sobre a desconexão dos servidores acessados

atualmente, clique em Sim se desejar acessar uma nova lista de servidores.Os servidores disponíveis por meio do Admin Server no HostAdministrativo especificado aparecem. Se desejar continuar vendo a listaatual de servidores remotos durante esta sessão, clique em Não.

4. Dê um clique duplo em um Cognos TM1 Server para efetuar login.Para Amostra de Planejamento ou SData, use estas credenciais de login:v Nome de Usuário: admin

v Senha: apple

Dica: Para carregar o Cognos TM1 Perspectives automaticamente sempre quevocê inicia o Microsoft Excel, inclua TM1_location/Tm1p.xla na lista deferramentas de suplemento doMicrosoft Excel, em que TM1_location é odiretório de arquivos no qual o Cognos TM1 está instalado. Após concluir estaetapa, "TM1" é exibido na barra de menus do Microsoft Excel.

5. Se quiser instalar o Cognos TM1 Perspectives em diversos computadores, useas etapas anteriores para criar uma instalação não assistida que possa. Paraobter detalhes, consulte Apêndice D, “Configurando Instalações eConfigurações Não Assistidas”, na página 285.


Instalando o Cognos TM1 ArchitectÉ possível instalar o IBM Cognos TM1 Architect executando as seguintes etapas.

Antes de Iniciar

Antes de instalar o Cognos TM1 Architect, conclua as seguintes tarefas:v Instale o software necessário para a execução do Cognos TM1 Architect. Para

obter informações adicionais, consulte “Instalar Software Obrigatório” na página57.

v Assegure-se de que o Cognos TM1 Admin Server e o Cognos TM1 Server aosquais deseja se conectar estejam em execução em um computador acessível emsua rede. Para obter detalhes, consulte Capítulo 7, “Instalação do Cognos TM1Server”, na página 67.

v Assegure-se de que os usuários tenham acesso aos servidores Cognos TM1 queeles precisam usar em execução no Cognos TM1 Admin Server. Comoadministrador do Cognos TM1, você deve configurar um nome de usuário euma senha para cada usuário antes de poder acessar esse servidor.

Sobre Esta Tarefa

É possível configurar o IBM Cognos TM1 Architect para localizar o Cognos TM1Administration Server em sua rede e, em seguida, se conectar ao servidor. Tambémé possível criar uma instalação não assistida.

Atenção: Se estiver atualizando e deixar os antigos arquivos de configuração docliente Tm1p.ini em vigor, talvez você precise atualizar o caminho do diretório noarquivo para o parâmetro AdminSvrSSLCertAuthority. Por exemplo, se você estiverusando o certificado SSL do Cognos TM1 padrão, altere manualmente o valordesse parâmetro para o novo caminho de instalação C:\ProgramFiles\IBM\cognos\tm1\bin\ssl\applixca.pem.

Procedimento1. Instale o Cognos TM1 Architect:

a. No software de sistema operacional Microsoft Windows Vista, Windows 7ou Windows Server 2008, clique com o botão direito do mouse no comandoissetup.exe e clique em Run as Administrator. Para outros sistemasoperacionais, dê um clique duplo no arquivo issetup.exe no disco deinstalação do cliente IBM Cognos TM1 ou a partir do local onde os arquivosde instalação do cliente IBM Cognos TM1 foram transferidos por downloade extraídos.

b. Na página Seleção do Componente, expanda Camada do TM1 Client,expanda Camada do Desenvolvedor e selecione a caixa de seleçãoArchitect. Deixe todas as outras caixas de seleção desmarcadas.

c. Siga os prompts e clique em Concluir para concluir a instalação.2. Execute o Cognos TM1 Architect:

a. Clique em Iniciar > IBM Cognos TM1 > Architect. Se o componente nãoiniciar, assegure que os servidores iniciados com o Cognos Configurationainda estejam em execução.

3. Configure o Cognos TM1 Architect para localizar o Cognos TM1 Admin Server:a. Abra o Server Explorer.b. Selecione TM1.c. Clique em Arquivo > Opções do TM1.

Capítulo 10. Instalação do Cliente Cognos TM1 103

d. No campo Host Administrativo, especifique o nome do computador noqual o TM1 Admin Server está sendo executado. Você deve inserir umnome, não um endereço IP, no campo Host Administrativo.

Dica: Se desejar acessar servidores registrados em ServidoresAdministrativos diferentes, use um ponto e vírgula para separar o nome decada Host Administrativo.

e. Clique em OK.f. Quando perguntado sobre a desconexão dos servidores acessados

atualmente, clique em Sim se desejar acessar uma nova lista de servidores.Os servidores disponíveis por meio do Admin Server no HostAdministrativo especificado aparecem. Se desejar continuar vendo a listaatual de servidores remotos durante esta sessão, clique em Não.

4. Dê um clique duplo em um Cognos TM1 Server para efetuar login.Para Amostra de Planejamento ou SData, use estas credenciais de login:v Nome de Usuário: admin

v Senha: apple

5. Se quiser instalar o Cognos TM1 Architect em diversos computadores, use asetapas anteriores para criar uma instalação não assistida. Para obter detalhes,consulte Apêndice D, “Configurando Instalações e Configurações NãoAssistidas”, na página 285.

Instalando o Cognos TM1 Performance ModelerÉ possível escolher diferentes maneiras de distribuir e instalar o IBM Cognos TM1Performance Modeler em diversos computadores.

A tabela a seguir resume as diferentes maneiras de distribuir e instalar o CognosTM1 Performance Modeler em diversos computadores.

Tabela 17. Opções de Instalação de Diversos Computadores para o Cognos TM1Performance Modeler

Opção de Instalação Descrição

“Instalando o Cognos TM1Performance Modeler Usando oPrograma de Instalação” napágina 105

Administradores ou usuários finais podem instalar oCognos TM1 Performance Modeler em um únicocomputador usando o programa de instalação apenas doIBM Cognos TM1 Client.

Opcionalmente, use estas etapas para criar umainstalação não assistida para instalar o Cognos TM1Performance Modeler em diversos computadores.

“Instalando o Cognos TM1Performance Modeler doCognos Applications Portal” napágina 105

Como um pré-requisito, um administrador deve instalaro Cognos TM1 Applications.

Isto permite que usuários do Cognos TM1 instalem oCognos TM1 Performance Modeler em seuscomputadores na primeira vez que eles o ativam a partirdo IBM Cognos Applications Portal. Isto é chamado deinstalação fornecida.

Para obter mais informações sobre publicação de áreasde trabalho, consulte o Guia do Usuário do IBM CognosTM1 Performance Modeler.


Tabela 17. Opções de Instalação de Diversos Computadores para o Cognos TM1Performance Modeler (continuação)


“Instalando Remotamente oCognos TM1 PerformanceModeler em diversosComputadores” na página 106

Um administrador pode usar ferramentas de instalaçãode rede de terceiros para ativar o Cognos TM1Performance Modeler em diversos sistemas do clienteremotos.

Instalando o Cognos TM1 Performance Modeler Usando oPrograma de Instalação

É possível instalar interativamente uma versão independente do IBM Cognos TM1Performance Modeler em um ou mais computadores.

Procedimento1. Dê um clique duplo no arquivo issetup.exe no disco de instalação do cliente

IBM Cognos TM1 ou a partir do local no qual os arquivos de instalação docliente IBM Cognos TM1 foram transferidos por download e extraídos.

2. Na página Seleção do Componente, expanda Camada do TM1 Client, expandaCamada do Desenvolvedor e selecione a caixa de seleção PerformanceModeler. Deixe todas as outras caixas de seleção desmarcadas.

3. Siga os prompts e clique em Concluir para concluir a instalação.4. Para testar a instalação, abra o Cognos TM1 Performance Modeler a partir de

Iniciar > Programas > IBM Cognos TM1 Performance Modeler.5. Se desejar instalar o programa em diversos computadores, use as etapas

anteriores para criar uma instalação não assistida que possa. Para obterdetalhes, consulte Apêndice D, “Configurando Instalações e Configurações NãoAssistidas”, na página 285.

Instalando o Cognos TM1 Performance Modeler do CognosApplications Portal

É possível instalar o IBM Cognos TM1 Performance Modeler na primeira vez quevocê executa o componente a partir do IBM Cognos Applications Portal.

Antes de Iniciar

Antes da instalação do Cognos TM1 Performance Modeler a partir do CognosApplications Portal, o administrador deve instalar o Cognos TM1 Applications.

Procedimento1. Em um navegador da web, digite o URI do Cognos Applications Portal:

Por exemplo, http://localhost:9510/pmpsvca. Substitua localhost pelo nome do computador no qual o Cognos

Applications Portal está instalado.b. Se necessário, altere o número da porta se você usou um valor diferente no

IBM Cognos Configuration para a propriedade URI do TM1 ApplicationGateway.

2. No portal do Cognos Applications, clique no ícone Abrir Performance Modeler

.


Se essa for a primeira vez que você usou o Cognos TM1 Performance Modeler,o ícone Instalar Agora será exibido para indicar que você está prestes a instalaro cliente Cognos TM1 Performance Modeler em seu computador.

3. Clique em Instalar Agora.4. Clique em Concluir para concluir a instalação.

O que Fazer Depois

Para obter informações sobre o uso do IBM Cognos TM1 Performance Modeler,consulte o Guia do Usuário do IBM Cognos TM1 Performance Modeler.

Instalando Remotamente o Cognos TM1 Performance Modelerem diversos Computadores

Como administrador, é possível enviar a instalação do IBM Cognos TM1Performance Modeler para os usuários automaticamente. Primeiro, vocêdisponibiliza o arquivo do instalador do Cognos TM1 Performance Modeler emuma pasta compartilhada em sua rede. Então é possível usar um aplicativo comoMicrosoft Active Directory para instalar automaticamente o aplicativo cliente parausuários autenticados.

Sobre Esta Tarefa

O Cognos TM1 Performance Modeler é instalado com o uso de um arquivo doinstalador que é colocado em um local compartilhado. É possível usar o ActiveDirectory para instalar o Cognos TM1 Performance Modeler diretamente noscomputadores dos usuários.

Use o arquivo PerformanceModeler.msi para instalar o Cognos TM1 PerformanceModeler. Esse arquivo é instalado no seguinte local quando você instala ocomponente Cognos TM1 Application Gateway:

tm1 location\webapps\pmpsvc\rcp_installs

É possível usar o arquivo PerformanceModeler.msi com as opções de linha decomando do Windows Installer e também usar o Active Directory ou outrasferramentas de gerenciamento de software para enviar a instalação paracomputadores remotos.

Opções da Linha de Comandos

O arquivo PerformanceModeler.msi é um arquivo padrão do Microsoft WindowsInstaller. É possível usar o arquivo PerformanceModeler.msi com as opções de linhade comando do Windows Installer e também usar o Active Directory ou outrasferramentas de gerenciamento de software para enviar a instalação paracomputadores remotos.

A tabela a seguir lista alguns dos valores da propriedade que os administradorespodem usar para instalar o arquivo PerformanceModeler.msi. Para obter detalhescompletos, consulte o Web site do desenvolvedor da Microsoft para conhecer adocumentação sobre o "Guia do Windows Installer" e "Referência de Propriedadesdo Windows Installer".


Tabela 18. Valores de Propriedade para o Cognos TM1 Performance Modeler

Valor da Propriedade Descrição

ALLUSERS=1Instala o MSI para todos os usuários.

Esse valor da propriedade assegura que asentradas de registro para o Cognos TM1Performance Modeler estejam localizadas emHKEY_LOCAL_MACHINE.Nota: Você deve usar esta propriedade com apropriedade TARGETDIR.

ALLUSERS=""

(valor padrão)

Instala o MSI somente para o usuário que estáexecutando a instalação. Somente esse usuárioterá acesso ao aplicativo

TARGETDIR="Performance Modeler_install location" Especifica o local da instalação do MSI.

Por exemplo, TARGETDIR="C:\Program Files"

TARGETDIR=

(valor padrão)

Quando usado com ALLUSERS=""

No Windows XP, o local de instalação é

C:\Documents and Settings\username\Application Data\IBM\Cognos TM1 PerformanceModeler

No Windows 7, o local de instalação é

C:\Users\username\AppData\Roaming\IBM\Cognos TM1 Performance Modeler

Quando usado com ALLUSERS=1


C:\Documents and Settings\AllUsers\Application Data\IBM\Cognos TM1Performance Modeler


C:\Program Data\IBM\Cognos TM1 PerformanceModeler

NOUPDATE=YesImpede os usuários do Cognos TM1Performance Modeler de receberematualizações automáticas.

Este valor é recomendado quando usuáriosfinais não possuem acesso de gravação ao localde instalação do aplicativo. A autoatualizaçãorequer que usuários do Cognos TM1Performance Modeler possam gravar no localespecificado, ou padronizado para isso, pelapropriedade TARGETDIR.


Tabela 18. Valores de Propriedade para o Cognos TM1 PerformanceModeler (continuação)


NOUPDATE=No

(valor padrão)

Permite que usuários do Cognos TM1Performance Modeler recebam atualizaçõesautomáticas.

Um exemplo é mostrado nas etapas a seguir.

Procedimento1. Abra um prompt de comandos e navegue até o local do arquivo

PerformanceModeler.msi.2. Para instalar o Cognos TM1 Performance Modeler para todos os usuários,

digite o seguinte comandoPerformanceModeler.msi TARGETDIR="install_location" ALLUSERS=1

Instalando o Cognos InsightÉ possível escolher diferentes maneiras de distribuir e instalar o IBM CognosInsight em diversos computadores.

Dependendo de seu ambiente de rede do computador e de suas necessidadescomerciais, é possível instalar o aplicativo, permitir que os usuários instalemconforme necessário ou ativar o aplicativo remotamente.

A tabela a seguir resume as diferentes maneiras de distribuir e instalar o IBMCognos Insight em diversos computadores.

Tabela 19. Opções de Instalação de Diversos Computadores para o Cognos Insight


“Instalando o Cognos InsightUsando o Programa de Instalação”na página 109

Administradores ou usuários finais podem instalar oCognos Insight em um único computador usando oprograma de instalação apenas do IBM Cognos TM1Client.

Opcionalmente, use estas etapas para criar umainstalação não assistida para instalar o Cognos Insightem diversos computadores.

“Instalando o Cognos Insight aPartir do Cognos ApplicationsPortal” na página 109

Como um pré-requisito, um administrador deveinstalar o Cognos TM1 Applications.

Isto permite que usuários do Cognos TM1 instalem oCognos Insight em seus computadores na primeiravez que eles o ativam a partir do IBM CognosApplications Portal. Isto é chamado de instalaçãofornecida.

Uma instalação fornecida permite que um usuário doCognos Insight publique áreas de trabalho no IBMCognos Applications Portal. Para obter maisinformações sobre publicação de áreas de trabalho,consulte o Guia do Usuário do IBM Cognos Insight.


Tabela 19. Opções de Instalação de Diversos Computadores para o CognosInsight (continuação)


“Instalando Remotamente oCognos Insight em diversosComputadores” na página 110

Um administrador pode usar ferramentas deinstalação de rede de terceiros para ativar o CognosInsight em diversos sistemas do cliente remotos.

Instalando o Cognos Insight Usando o Programa deInstalação

É possível instalar interativamente uma versão independente do IBM CognosInsight em um ou mais computadores.

Procedimento1. No software de sistema operacional Microsoft Windows Vista, Windows 7 ou

Windows Server 2008, clique com o botão direito do mouse no comandoissetup.exe e clique em Run as Administrator. Para outros sistemasoperacionais, dê um clique duplo no arquivo issetup.exe no disco deinstalação do cliente IBM Cognos TM1 ou a partir do local onde os arquivos deinstalação do cliente IBM Cognos TM1 foram transferidos por download eextraídos.

2. Na página Seleção de Componente, expanda TM1 Client Tier e selecione acaixa de seleção Cognos Insight. Deixe todas as outras caixas de seleçãodesmarcadas.

3. Siga os prompts e clique em Concluir para concluir a instalação.4. Para testar a instalação, abra o Cognos Insight em Iniciar > Programas > IBM

Cognos Insight > IBM Cognos Insight.5. Para instalar o programa em diversos computadores, use as etapas anteriores

para criar uma instalação não assistida. Para obter detalhes, consulteApêndice D, “Configurando Instalações e Configurações Não Assistidas”, napágina 285.

Instalando o Cognos Insight a Partir do Cognos ApplicationsPortal

É possível instalar o IBM Cognos Insight na primeira vez que você executa ocomponente a partir do portal do IBM Cognos Applications.

Antes de Iniciar

Antes de instalar o Cognos Insight a partir do Cognos Connection, o administradordeve instalar o Cognos TM1 Applications.

Procedimento1. Em um navegador da web, digite o URI do portal do Cognos Applications:

Por exemplo, http://localhost:9510/pmpsvca. Substitua localhost pelo nome do computador no qual o Cognos

Applications Portal está instalado.b. Se necessário, altere o número da porta se você usou um valor diferente no

IBM Cognos Configuration para a propriedade URI do TM1 ApplicationGateway.


2. A partir do portal do Cognos Applications, clique no ícone Abrir CognosInsight.Se esta foi a primeira vez que você usou o Cognos Insight, o ícone InstalarAgora será exibido para indicar que você está prestes a instalar o clienteCognos Insight em seu computador.

3. Clique em Instalar Agora.4. Clique em Concluir para concluir a instalação.

O que Fazer Depois

O Cognos Insight está instalado agora em uma pasta em seu computador. Serápossível executar e usar o Cognos Insight das seguintes maneiras:v Será possível ativar o Cognos Insight usando o botão Abrir Cognos Insight no

Cognos TM1 Applications.v Será possível ativar o cliente Cognos Insight clicando com o botão direito do

mouse em um nó de um aplicativo que foi configurado para usar o CognosInsight.O Cognos Insight está disponível como um cliente a partir de um aplicativosomente se você configurou o ambiente do cliente para o Cognos TM1Applications usar o cliente Cognos Insight Distribuído ou Conectado.

v É possível ativar o Cognos Insight como um produto independente a partir domenu Iniciar > Programas > IBM Cognos Insight do Windows.

Instalando Remotamente o Cognos Insight em diversosComputadores

Como administrador, é possível enviar a instalação do IBM Cognos Insight para osusuários automaticamente. Primeiro você disponibiliza o arquivo do instalador doCognos Insight em uma pasta compartilhada na rede. Então é possível usar umaplicativo como Microsoft Active Directory para instalar automaticamente oaplicativo cliente para usuários autenticados.

Sobre Esta Tarefa

O Cognos Insight é instalado com o uso de um arquivo do instalador que écolocado em um local compartilhado. É possível usar o Active Directory parainstalar o Cognos Insight diretamente nos computadores do usuário.

Use o arquivo CognosInsight.msi para instalar o Cognos Insight. Esse arquivo éinstalado no seguinte local quando você instala o componente IBM Cognos TM1Application Gateway:

tm1 location\webapps\pmpsvc\rcp_installs

É possível usar o arquivo CognosInsight.msi com as opções de linha de comandodo Windows Installer e também usar o Active Directory ou outras ferramentas degerenciamento de software para enviar a instalação para computadores remotos.

Opções da Linha de Comandos

O arquivo CognosInsight.msi é um arquivo padrão do Microsoft WindowsInstaller. É possível usar o arquivo CognosInsight.msi com as opções de linha de


comando do Windows Installer e também usar o Active Directory ou outrasferramentas de gerenciamento de software para enviar a instalação paracomputadores remotos.

A tabela a seguir lista alguns valores da propriedade que os administradorespodem usar para instalar o arquivo CognosInsight.msi. Para obter detalhescompletos, consulte o Web site do desenvolvedor da Microsoft para conhecer adocumentação sobre o "Guia do Windows Installer" e "Referência de Propriedadesdo Windows Installer".

Tabela 20. Valores de Propriedade para Cognos Insight


ALLUSERS=1Instala o MSI para todos os usuários.

Esse valor da propriedade assegura queas entradas de registro para o CognosInsight estejam localizadas emHKEY_LOCAL_MACHINE.Nota: Você deve usar esta propriedadecom a propriedade TARGETDIR.

ALLUSERS=""

(valor padrão)

Instala o MSI somente para o usuário queestá executando a instalação. Somenteesse usuário terá acesso ao aplicativo

TARGETDIR="CognosInsight_install location"Especifica o local da instalação do MSI.

Por exemplo, TARGETDIR="C:\ProgramFiles"

TARGETDIR=

(valor padrão)

Quando usado com ALLUSERS=""


C:\Documents and Settings\username\Application Data\IBM\Cognos Insight


C:\Users\username\AppData\Roaming\IBM\Cognos Insight

Quando usado com ALLUSERS=1


C:\Documents and Settings\AllUsers\Application Data\IBM\CognosInsight


C:\Program Data\IBM\Cognos Insight


Tabela 20. Valores de Propriedade para Cognos Insight (continuação)


NOUPDATE=YesImpede os usuários do Cognos Insight dereceberem atualizações automáticas.

Este valor é recomendado quandousuários finais não possuem acesso degravação ao local de instalação doaplicativo. A autoatualização requer queusuários do Cognos Insight possamgravar no local especificado, oupadronizado para isso, pela propriedadeTARGETDIR.

NOUPDATE=No

(valor padrão)

Permite que usuários do Cognos Insightrecebam atualizações automáticas.

Um exemplo é mostrado nas etapas a seguir.

Procedimento1. Abra um prompt de comandos e navegue até o local do arquivo

CognosInsight.msi.2. Para instalar o Cognos Insight para todos os usuários, digite o seguinte

comandoCognosInsight.msi TARGETDIR="install_location" ALLUSERS=1


Capítulo 11. Instalação de Bancos de Dados de Amostras doCognos TM1

As amostras do IBM Cognos TM1 ilustram recursos do produto e melhorespráticas técnicas e de negócios. Também é possível usá-las para conhecer oproduto, testar e solucionar problemas.

Visão Geral das Amostras do Cognos TM1

As amostras do Cognos TM1 estão disponíveis para uma variedade de usos e sãootimizadas para diferentes clientes. Algumas das amostras estão prontas para usologo após a instalação enquanto outras requerem etapas extras para usá-las. Porpadrão, as amostras do Cognos TM1 são instaladas em dois locais diferentes. Seselecionadas no assistente de instalação, as amostras do produto são instaladasconforme a seguir:

SData, Amostra de Planejamento e GO_New_Stores

Estas amostras são instaladas por padrão no local tm1_location\samples\tm1.

SData e Amostra de Planejamento foram projetados especificamente paraserem usados com Cognos TM1.

Para usá-las, inicie cada banco de dados de amostras no CognosConfiguration após a instalação.

GO_New_Stores foi projetada para destacar o Cognos TM1 Applications etambém pode ser usada com o Cognos Insight e o Cognos TM1Performance Modeler.

Consulte “Usando a Amostra SData” na página 114, “Usando o banco dedados de Amostra do Planning” na página 114 e “Usando a AmostraGO_New_Stores” na página 115 para obter detalhes.

PData, Rules_Guide_Data, TI_Data

Estas amostras também foram projetadas especificamente para o CognosTM1, no entanto, para usá-las, você deve primeiro incluir cada servidor noCognos Configuration e, em seguida, iniciá-las individualmente. Eles estãoinstalados no local tm1_location\samples\tm1.

GO_Contributor.zip, FinanceFact.zip, greatoutdoors.zip eGreatOutdoorsSales.zip

Estas amostras são instaladas no diretório tm1_location\webcontent\samples\datasources\cubes\amdtool.

As amostras GreatOutdoorsSales.zip requerem que você restaure umbanco de dados e se conecte ao banco de dados usando uma origem dedados OLAP. Os arquivos de banco de dados são instalados com asamostras e são fornecidos para IBM DB2, Microsoft SQL Server e bancos dedados Oracle.

As outras amostras são baseadas nos arquivos .csv para seus conteúdos enão requerem que um banco de dados seja restaurado.

As amostras Recursos Humanos e Pedido no formato .csv são instaladaspara uso pelo Cognos Insight.


Consulte “Configurar a Amostra Companhia das Grandes Aventuras” napágina 116, “Usando as Amostras do Servidor TM1 com Base no Banco deDados de Amostra” na página 117 e “Configurando a Amostra Vendas deGrandes Aventuras” na página 123 para obter detalhes.

Balance sheet.cdd, HumanResources.cdd, Income-Debt Analysis.cdd e Orders.cdd.Um conjunto de amostras .cdd foi projetado especificamente para uso como construtor de área de trabalho do Cognos Insight. Essas amostras estãodisponíveis no Centro de Informações do IBM Cognos Insight(http://publib.boulder.ibm.com/infocenter/cinsight/v10r1m0).

No UNIX, use o comando ./startup_tm1s.sh para iniciar os servidores de bancode dados de amostras. Consulte "Iniciando um UNIX TM1 Server" e "Parando umUNIX TM1 Server" no Guia de Operações do IBM Cognos TM1 para obter maisdetalhes.

Usando a Amostra SDataA amostra Sdata inclui dados otimizados para uso com Cognos TM1.

Sobre Esta Tarefa

SData é selecionada como um componente padrão e é instalada por padrão nolocal do banco de dados de amostras.

Por exemplo, C:/Program Files/IBM/cognos/tm1/samples/tm1/SData

Procedimento1. Execute o Cognos TM1 Architect.2. No Cognos Configuration, clique com o botão direito do mouse e inicie o banco

de dados de SData.3. Dê um clique duplo no TM1 para abrir o banco de dados de amostras.4. Efetue login no banco de dados de amostra usando o nome de usuário padrão

admin e a senha apple.

Usando o banco de dados de Amostra do PlanningA Amostra do Planning ou amostra PlanSamp inclui dados otimizados para usocom Cognos TM1.

Sobre Esta Tarefa

Amostra do Planning é selecionada como um componente padrão e instalada porpadrão no local do banco de dados de amostras.

Por exemplo, C:/Program Files/IBM/cognos/tm1/samples/tm1/PlanSamp

Procedimento1. Execute o Cognos TM1 Architect.2. No Cognos Configuration, clique com o botão direito do mouse e inicie o banco

de dados de amostra do Planning.3. Dê um clique duplo no TM1 para abrir o banco de dados de amostras.4. Efetue login no banco de dados de amostra usando o nome de usuário padrão

admin e a senha apple.


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

Usando a Amostra GO_New_StoresA amostra GO_New_Stores inclui dados otimizados para IBM Cognos TM1Applications, Cognos Insight e Cognos TM1 Performance Modeler.

Antes de Iniciar

Antes de iniciar GO_New_Stores, verifique se você não possui nenhuma versãoanterior desse serviço em sua listagem de serviços do Microsoft Windows. Use scdelete GO_New_Stores em uma janela de comando para remover quaisquerinstâncias anteriores.

Estas instruções assumem que o Cognos TM1 e pelo menos um banco de dados deamostras diferente de GO_New_Stores já estão em execução. Consulte Capítulo 6,“Instalação de Computador Único do Cognos TM1”, na página 57 para obterdetalhes sobre como instalar o Cognos TM1.

Procedimento1. No Cognos Configuration, selecione Configuração Local, clique em <clicar no

botão de edição> e clique em Incluir.a. Digite StandaloneCertificateAuthority na caixa Nome.b. Digite True na caixa Valor.c. Clique em OK.

2. No Cognos Configuration, clique com o botão direito do mouse emGO_New_Stores e clique em Iniciar. Clique em Fechar na mensagem deconfirmação após o servidor ser iniciado.

3. Teste o banco de dados de amostras no IBM Cognos TM1 Architect:a. Execute o Cognos TM1 Architect.b. Expanda o nó TM1 e dê um clique duplo em GO_New_Stores para abrir o

banco de dados de amostras.c. Efetue login no banco de dados de amostra usando o nome de usuário

padrão admin e a senha apple.4. Teste o banco de dados de amostras no Cognos TM1 Applications e no Cognos

TM1 Performance Modeler:

Dica: Assegure-se de que seu servidor da Web e o IBM Cognos TM1Applications estejam em execução.a. Abra um navegador da web e insira http://localhost:9510/pmpsvc ou a

URL do servidor da Web que deseja usar para abrir o Cognos TM1Applications.

b. Na página Cognos TM1 Application Configuration, aceite os padrõesclicando em OK.

Dica: Por padrão, todos os clientes estão selecionados aqui para uso com aamostra GO_New_Stores. É possível limitar os clientes disponíveis cancelandoa seleção deles aqui.

c. Efetue login no banco de dados de amostra usando o nome de usuáriopadrão admin e a senha apple.

d. Para trabalhar com a amostra GO_New_Stores no Cognos TM1 PerformanceModeler, clique no ícone Abrir IBM Cognos TM1 Performance Modeler. Sefor solicitado que você instale o Cognos TM1 Performance Modeler, siga asinstruções no assistente de instalação para instalá-lo.

Capítulo 11. Instalação de Bancos de Dados de Amostras do Cognos TM1 115

Configure a Amostra GO ContributorA amostra GO Contributor usa arquivos .csv. Para usar a amostra, você devemodificar o arquivo tm1s.cfg e, em seguida, incluir o servidor usando o IBMCognos Configuration.

Procedimento1. No computador no qual você instalou o componente TM1 Server, acesse a pasta

tm1_location\webcontent\samples\datasources\cubes\amdtool.2. Extraia o conteúdo do arquivo GO_Contributor.zip.3. Na pasta na qual você extraiu o arquivo Go_Contributor.zip, acesse a pasta

Arquivos de Dados e abra o arquivo tm1s.cfg em um editor de texto.a. Assegure que o local DatabaseDirectory, o local LoggingDirectory e o

DistributedPlanningOutputDir usem o caminho correto para o local dapasta Arquivos de Dados no qual você extraiu o arquivoGo_Contributor.zip.

b. Salve e feche o arquivo.4. Abra o IBM Cognos Configuration.5. No painel Explorer, em Acesso a Dados, clique com o botão direito do mouse

em TM1 Server e clique em Novo Recurso > Instâncias do TM1 Server.a. Na caixa Nome, insira GO Contributor.b. Para o valor de caminho de configuração do TM1 Server, insira o caminho

para a pasta Data Files na qual você extraiu o arquivo Go_Contributor.zip.Por exemplo, tm1_location\webcontent\samples\datasources\cubes\amdtool\GO_Contributor\Data Files

c. No painel Explorer, clique com o botão direito do mouse em GOContributor e clique em Iniciar.

6. Teste se o novo servidor GO Contributor está disponível para o Architect.a. Abra o Architect.b. Dê um clique duplo no servidor GO Contributor.c. Na caixa Login do Servidor, insira admin na caixa Nome de Usuário e

apple na caixa Senha.7. Teste se o novo servidor GO Contributor está disponível no portal do IBM

Cognos Applications.a. Abra o portal digitando o seguinte: http://server_name:9510/pmpsvc.b. Clique no ícone Administrar IBM Cognos Application na extremidade

direitac. Em Nomes do Servidor, clique em Incluir.d. Digite o nome do servidor em Host Administrativo e, em seguida, clique

no botão Atualizar.e. Selecione a amostra GO Contributor que acabou de incluir e clique em OK.

Configurar a Amostra Companhia das Grandes AventurasA amostra Companhia das Grandes Aventuras usa arquivos .csv. Para usar aamostra, você deve modificar o arquivo tm1s.cfg e, em seguida, incluir o servidorusando o IBMCognos Configuration.


Procedimento1. No computador no qual você instalou o componente TM1 Server, acesse a pasta

tm1_location\webcontent\samples\datasources\cubes\amdtool.2. Extraia o conteúdo do arquivo greatoutdoors.zip.3. Na pasta na qual você extraiu o arquivo greatoutdoors.zip, acesse a pasta

Arquivos de Dados e abra o arquivo tm1s.cfg em um editor de texto.a. Assegure que o local DatabaseDirectory e o local LoggingDirectory usem o

caminho correto para o local da pasta Arquivos de Dados no qual vocêextraiu o arquivo greatoutdoors.zip.


em TM1 Server e clique em Novo Recurso > Instâncias do TM1 Server.a. Na caixa Nome, insira Grandes Aventuras.b. Para o valor do caminho de configuração do TM1 Server, insira o caminho

para a pasta Arquivos de Dados na qual você extraiu o arquivogreatoutdoors.zip.Por exemplo, tm1_location\webcontent\samples\datasources\cubes\amdtool\Grandes Aventuras\Arquivos de Dados

c. No painel Explorer, clique com o botão direito do mouse em GrandesAventuras e clique em Iniciar.

6. Teste se o novo servidor Grandes Aventuras está disponível no Architect.a. Abra o Architect.b. Dê um clique duplo no servidor Grandes Aventuras.c. Na caixa Login do Servidor, insira admin na caixa Nome de Usuário e

apple na caixa Senha.7. Teste se o novo servidor Grandes Aventuras está disponível no portal do IBM



no botão Atualizar.e. Selecione a amostra Grandes Aventuras que acabou de incluir e clique em

OK.

Usando as Amostras do Servidor TM1 com Base no Banco de Dadosde Amostra

A amostra Vendas de Grandes Aventuras usa dados de um banco de dados. Parausar esta amostra você deve restaurar o banco de dados, criar uma conexão ODBCcom o banco de dados e, em seguida, incluir o servidor de amostra em seusistema.

O banco de dados é fornecido para IBM DB2, Microsoft SQL Server e Oracle.

O banco de dados de amostras e o servidor Cognos TM1 que usa o banco dedados são instalados com o servidor Cognos TM1 na pasta tm1_location/webcontent/samples/datasources.


Quando você criar sua conexão ODBC, use GOSALESDW como o nome da origem dedados. Nos sistemas operacionais Microsoft Windows, crie a conexão ODBC comoum DSN do Sistema.

Restaurando Arquivos de Backup para IBM DB2Use o script que é fornecido para restaurar bancos de dados de amostras no IBMDB2.

Para configurar o banco de dados de amostras, você deve extrair o arquivo GS_DBtar.gz, customizar um arquivo de configuração e executar o script deconfiguração.

Procedimento1. Acesse a pasta tm1_location/webcontent/samples/datasources.2. Extraia o arquivo GS_DB.tar.gz e retenha a estrutura de diretório original.

Se você usar WinZip para extrair o arquivo GS_DB.tar.gz em um sistemaoperacional Microsoft Windows assegure que a opção TAR file smart CR/LFconversion não esteja selecionada.

3. Nos sistemas operacionais Linux e UNIX, modifique as permissões de arquivono arquivo setupGSDB.sh para que ele seja executável.Por exemplo,chmod u+x setupGSDB.sh

4. Se desejar alterar o arquivo de configuração de amostra para usar configuraçõesdiferentes dos valores padrão, edite o arquivo GOSalesConfig.O arquivo de configuração no Windows é GOSalesConfig.bat. O arquivo deconfiguração no Linux e UNIX é GOSalesConfig.sh.O arquivo de configuração GOSalesConfig contém as opções de configuraçãopadrão que são usadas ao criar os dados GOSALES. As definições deconfiguração padrão são listadas na tabela a seguir

Tabela 21. Definições de Configuração Padrão para Dados GOSALES

Ajuste de configuração Padrão Descrição

GOSALES_INST GS_DB Usado para definir o nomeou alias do banco de dados.

GOSALES_CREATEDB Opcional: faz com que umbanco de dados existentecom o mesmo nome sejaeliminado.

GOSALES_DB_TERRITORY EUA 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 tablespace,caso eles sejam criados peloscript.

GOSALES_GRANTEES GOSALES, DB2ADMIN Informe a lista de usuários,grupos ou PUBLIC que terãopermissões CONTROL paraos esquemas GOSALES,GOSALESHR, GOSALESMRe GOSALESRT. Essa stringdeve seguir a sintaxe docomando GRANT.


Tabela 21. Definições de Configuração Padrão para Dados GOSALES (continuação)


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.

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.

5. Para executar o script setupGSDB no modo interativo, execute o comando aseguir:v Em computadores Windows, em uma janela de comando do IBM DB2, vá

para o diretório GS_DB\win e execute o script setupGSDB.bat.v Em computadores UNIX, em um prompt de shell, origine o db2profile, vá

para o diretório GS_DB/unix e execute o script setupGSDB.sh.O script exibe um resumo das suas escolhas antes de confirmar as mudançasno ambiente. Se você aprovar as opções, pressione Enter.

6. Para executar o script setupGSDB a partir da linha de comandos, execute ocomando a seguir:v Em computadores Windows, execute o script setupGSDB.bat.v Em computadores UNIX, execute o script setupGSDB.sh.É possível executar o script setupGSDB com as seguintes opções:

Opção Descrição

-createdb Cria o banco de dados. Essa opção eliminaos bancos de dados existentes com o mesmonome. Ela cria o pool de buffers e otablespace exigidos.

-database database name Especifica o nome do banco de dados. Essevalor substitui o valor padrão de GS_DB.

-userid administration_user_ID Especifica o nome do ID de usuário deadministrador do DB2 que é usado paracriar o banco de dados.

-password administration_user_ID Especifica a senha para o ID de usuário deadministrador do DB2.

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


Por exemplo, se você for um administrador do IBM DB2 e desejar criar o bancode dados GS_DB padrão no nó local, use o seguinte comando:setupGSDB -createDB -noprompt

Se desejar criar as tabelas em um banco de dados existente denominadoSAMPLE, e desejar usar o ID de usuário de administrador db2admin, execute ocomando a seguir:setupGSDB -database SAMPLE -userid db2admin

O script solicita a senha ao se conectar ao banco de dados. O script substituiráquaisquer tabelas que já existam no banco de dados, a menos que você escolhadescartar o banco de dados.

7. Se o banco de dados de amostra GS_DB estiver instalado em um servidorremoto no ambiente, será possível vinculá-lo ao catalogar o banco de dadosremoto no computador local e, em seguida, executar o script de ajustelocalmente.a. Se o banco de dados de amostras ainda não existir no servidor remoto,

crie-o usando o comando CREATE DATABASE.O banco de dados exige um conjunto de códigos UTF-8 e um tablespacepadrão com um tamanho de página de 16 KB ou maior. Por exemplo, noservidor remoto, crie o banco de dados executando o comando a seguir:CREATEDATABASE GS_DB USING CODESET UTF-8 TERRITORY US PAGESIZE 16k

b. Em seu computador local, catalogue o banco de dados remoto usando ocomando a seguir:db2catalog tcpip node nodename remote ipaddr server port_numberdb2 catalog database GS_DB as GS_DB at node nodename

c. Em seu computador local, execute o comando a seguir:setupGSDB -database GS_DB -userid administration_user_ID

Será solicitada uma senha para que você se conecte ao banco de dados.

Restaurando Arquivos de Backup para OracleUse os scripts que são instalados com o TM1 para restaurar de forma rápida econveniente arquivos de backup para bancos de dados de amostras no Oracle.

Sobre Esta Tarefa

Para configurar o banco de dados de amostras, você deve extrair o arquivoGS_DB_ORA.tar.gz,, customizar um arquivo de configuração e executar o script deconfiguração.

Procedimento1. Acesse o tm1_location/webcontent/samples/datasources.2. Extraia o arquivo GS_DB_ORA.tar.gz e retenha a estrutura de diretório original.3. Em sistemas operacionais Linux e UNIX, modifique as permissões de arquivo

no arquivo setupGSDB.sh para que ele seja executável:chmod u+x setupGSDB.sh

4. Certifique-se de que o ID de usuário utilizado para definir o banco de dadosOracle tenha autoridade para criar usuários e executar o utilitário deimportação.

5. Opcional - Se desejar alterar o arquivo de configuração de amostra para usarconfigurações diferentes dos valores padrão, edite o arquivo GOSalesConfig.


O arquivo de configuração no Windows é GOSalesConfig.bat. O arquivo deconfiguração no UNIX é GOSalesConfig.sh.O arquivo de configuração GOSalesConfig contém as opções de configuraçãopadrão que são usadas ao criar os dados GOSALES. As definições deconfiguração padrão são listadas na tabela a seguir

Tabela 22. Definições de Configuração Padrão para Dados GOSALES


GOSALES_IMP_CMD imp Se necessário, pode sermodificado para especificaro caminho completo para aversão correta do utilitáriode importação.

GOSALES_INST Sequência do host daOracle.

GOSALES_TS GOSALES_TS Se os usuários foremcriados por scripts, usepara informar o nome dotablespace para atribuir aosusuários.

GOSALES_CREATE_TS Opcional: usado para criaro tablespace padrão parausuários.

GOSALES_TEMP_TS Se os usuários foremcriados por scripts, usepara designar nome aotablespace temporário paraatribuir aos usuários. Deixeem branco para usar otablespace temporáriopadrão.

GOSALES_SCHEMA

GOSALES_SCHEMA_PW

VENDASGA

GOSALESPW

Usado para informar onome de usuário e senhapara o usuário GOSALES.Se não for informado, serásolicitada uma senha.

GOSALESHR_SCHEMA

GOSALESHR_SCHEMA_PW

GOSALESHR

GOSALESHRPW

Usado para informar onome de usuário e a senhapara o usuárioGOSALESHR. Se não forinformado, será solicitadauma senha.

GOSALESMR_SCHEMA

GOSALESMR_SCHEMA_PW

GOSALESMR

GOSALESMRPW

Usado para informar onome de usuário e a senhapara o usuárioGOSALESMR. Se não forinformado, será solicitadauma senha.

GOSALESSRT_SCHEMA

GOSALESRT_SCHEMA_PW

GOSALESRT

GOSALESRTPW

Usado para informar onome de usuário e a senhapara o usuárioGOSALESRT. Se não forinformado, será solicitadauma senha.


Tabela 22. Definições de Configuração Padrão para Dados GOSALES (continuação)


GOSALESDW_SCHEMA

GOSALESDW_SCHEMA_PW

DWVENDASGA

GOSALESDWPW

Usado para informar onome de usuário e senhapara o usuárioGOSALESDW. Se não forinformado, será solicitadauma senha.

GOSALES_GRANTEES VENDASGA Usado para informar osusuários que terão aspermissões SELECT,INSERT, DELETE, UPDATEe ALTER para os esquemasGOSALES, GOSALESHR,GOSALESMR eGOSALESRT.

Observação: o proprietáriodo GOSALES_SCHEMAsempre receberá aconcessão do privilégioSELECT, INSERT, DELETE,UPDATE e ALTER emtodos os esquemas.

GOSALESDW_GRANTEES DWVENDASGA Usado para informar osusuários que terão aspermissões SELECT,INSERT, DELETE, UPDATEe ALTER para o esquemaGOSALESDW.

6. Para executar o script setupGSDB no modo interativo, execute o comando aseguir:v Em computadores Windows, em uma janela de comando DOS, vá para o

diretório GS_DB_ORA\win e execute o script setupGSDB.bat.v Em computadores UNIX, a partir de um prompt de shell, vá para o diretório

GS_DB_ORA/unix e execute o script setupGSDB.sh.Pressione Enter para continuar. O script exibe um resumo das suas escolhasantes de confirmar as mudanças no ambiente. Se você aprovar as opções,pressione Enter e o script fará as mudanças

7. Para executar o script setupGSDB a partir da linha de comandos, execute ocomando a seguir:v Em computadores Windows, execute o script setupGSDB.bat.v Em computadores UNIX, execute o script setupGSDB.sh.É possível executar o script setupGSDB com as seguintes opções:

Opção Descrição

-createdb Cria o banco de dados. Essa opção eliminaos bancos de dados existentes com o mesmonome. Ela cria o pool de buffers e otablespace exigidos.

-database database name Especifica o nome do banco de dados. Essevalor substitui o valor padrão de GS_DB.


Opção Descrição

-userid administration_user_ID Especifica o nome do ID de usuário deadministrador do DB2 que é usado paracriar o banco de dados.

-password administration_user_ID Especifica a senha para o ID de usuário deadministrador do DB2.

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

Por exemplo, se você for um administrador do Oracle e desejar criar osesquemas do banco de dados de amostras padrão, execute o comando a seguir:setupGSDB -createDB -noprompt

Você deseja criar as tabelas nos esquemas existentes especificados no arquivode configuração e deseja usar o ID de usuário de administrador sys. Execute ocomando a seguir:setupGSDB -YourOracleInstance-userid sys -sysdba

O script solicita a senha ao se conectar à instância Oracle. O script exclui astabelas ou exibições existentes nos esquemas especificados e os substitui.

Restaurando Arquivos de Backup para o Microsoft SQLServer

Use a ferramenta de gerenciamento do banco de dados do Microsoft SQL Serverpara restaurar de maneira rápida e conveniente arquivos de backup para bancos dedados de amostras.

Procedimento1. No computador no qual você instalou o servidor TM1, acesse o diretório a

seguir:tm1_location/webcontent/samples/datasource/Source files/sqlserver

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 o banco de dados a partir de um dispositivo e assegure que os locaisde restauração estejam corretos para os arquivos de banco de dados .ldf e.mdf.Para obter informações adicionais, consulte a documentação do Microsoft SQLServer ou a Base de Conhecimento do IBM Cognos na Central do Cliente doIBM Cognos.

4. Crie no mínimo um usuário que tenha as permissões selecionadas para todas astabelas dos bancos de dados customizados.

Configurando a Amostra Vendas de Grandes AventurasA amostra Vendas de Grandes Aventuras usa dados do banco de dados restaurado.

Procedimento1. Crie uma conexão de origem de dados ODBC para o banco de dados

restaurado.Use GOSALESDW como o nome da origem de dados. Nos sistemas operacionaisWindows, crie a conexão ODBC como um DSN do Sistema.


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

2. No computador no qual você instalou o componente TM1 Server, acesse a pastatm1_location\webcontent\samples\datasources\cubes\amdtool.

3. Extraia o conteúdo do arquivo GreatOutdoorsSales.zip.4. Na pasta na qual você extraiu o arquivo GreatOutdoorsSales.zip, acesse a

pasta Arquivos de Dados e abra o arquivo tm1s.cfg em um editor de texto.a. Assegure que o local DatabaseDirectory e o local LoggingDirectory usem o

caminho correto para o local no qual você extraiu o arquivoGreatOutdoorsSales.zip.


em TM1 Server e clique em Novo Recurso > Instâncias do TM1 Server.a. Na caixa Nome, insira GreatOutdoorsSales.b. Para o valor do caminho de configuração do TM1 Server, insira o caminho

para a pasta Arquivos de Dados na qual você extraiu o arquivoGreatOutdoorsSales.zip.Por exemplo, tm1_location\webcontent\samples\datasources\cubes\amdtool\GreatOutdoorsSales\Arquivos de Dados

c. No painel Explorer, clique com o botão direito do mouse emGreatOutdoorSales e clique em Iniciar.

7. Teste se o novo servidor GreatOutdoorsSales está disponível no Architect.a. Abra o Architect.b. Dê um clique duplo no servidor GreatOutdoorsSales.c. Na caixa Login do Servidor, insira admin na caixa Nome de Usuário e

apple na caixa Senha.8. Teste se o novo servidor GreatOutdoorsSales está disponível no portal do IBM



no botão Atualizar.e. Selecione a amostra GreatOutdoorsSales que acabou de incluir e clique em

OK.


Capítulo 12. Instalando o Cognos TM1 Operations Console

O IBM Cognos TM1 Operations Console é um aplicativo da web baseado em Javaque permite que administradores do Cognos TM1 monitorem e tomem ações sobrea atividade do servidor Cognos TM1 .

Antes de Iniciar

O Cognos TM1 Operations Console é implementado em um servidor de aplicativosda web baseado em Java, como a versão do Apache Tomcat fornecida com ainstalação do Cognos TM1 . Em vez disso, é possível usar sua própria versão doApache Tomcat. Determine a maneira em que deseja instalar.

Antes da instalação do Cognos TM1 Operations Console:v Assegure-se de que o software obrigatório Cognos TM1 esteja instalado.v Assegure-se de que o Cognos TM1 Admin Server e o servidor Cognos TM1 que

deseja monitorar estejam instalados e em execução.v Assegure-se de poder iniciar o Cognos TM1 Architect e efetuar login como

administrador no servidor Cognos TM1 que deseja monitorar.v Assegure-se de que o Apache Tomcat esteja instalado e em execução.

O Cognos TM1 Operation Console é selecionado por padrão durante a instalação.Em vez disso, é possível optar por instalá-lo em um computador separado docomputador usado para o servidor Cognos TM1 cancelando sua seleção durante ainstalação padrão, depois executando a instalação no computador separado eselecionando apenas o Cognos TM1 Operations Console.

Procedimento1. No software do sistema operacional Microsoft Windows Vista, Windows 7 ou

Windows Server 2008, clique com o botão direito do mouse no comandoissetup.exe e clique em Run as Administrator. Para outros sistemasoperacionais, dê um clique duplo no arquivo issetup.exe no disco deinstalação do IBMCognosTM1 ou a partir do local onde os arquivos deinstalação do CognosTM1 foram transferidos por download e extraídos.

2. Selecione e instale o componente Web Application Tier > Cognos TM1Operations Console.

Lembre-se: Instale os componentes IBM Cognos TM1 em um diretório quecontém apenas caracteres ASCII no nome do caminho. Alguns servidores daWeb para Windows não suportam caracteres não ASCII em nomes dediretórios.

O que Fazer Depois

Siga as instruções para o software de servidor da Web que deseja usar com oCognos TM1 Operations Console:v “Usando o Apache Tomcat Fornecido com o Cognos TM1 Operations Console”

na página 126v “Usando a Própria Versão do Apache Tomcat Fornecido” na página 130v “Usando o Websphere 7.0 e 8.0” na página 134


Usando o Apache Tomcat Fornecido com o Cognos TM1 OperationsConsole

Use o seguinte conjunto de etapas para instalar o IBM Cognos TM1 OperationsConsole se você estiver usando a versão do Apache Tomcat fornecida com oCognos TM1 .

Incluir Certificados no Keystore do JREO IBM Cognos TM1 Operations Console requer um certificado no keystore JavaRuntime Environment (JRE).

Procedimento1. Execute o comando keytool do Java para importar o certificado no keystore.

a. Abra um prompt de comandos e altere para o seguinte diretório:<location> \bin\jre\6.0\bin

em que <location> é o diretório de arquivo onde o Cognos TM1 estáinstalado.CUIDADO:Em computadores de 64 bits, certifique-se de incluir os certificados napasta bin64.

b. Execute a linha de comandos a seguir. Para propósitos de formatação, ocomando é mostrado aqui com quebras de linha, mas você deve inserir ocomando todo em uma linha.keytool -import -file "C:\<location>\bin\ssl\applixca.pem"-keystore "C:\<location>\bin\jre\6.0\lib\security\cacerts"-storepass "changeit"

Para instalações de 64 bits, destine a pasta de 64 bits ao tratar com oscertificados. Por exemplo, este comando de amostra destina o JRE de 64bits:cd C:\Program Files (x86)\ibm\cognos\TM1_64\bin64\jre\6.0\bin

O comando a seguir é um exemplo usado nos sistemas de 64 bits. Parapropósitos de formatação, este comando é mostrado com quebras de linha,mas você deve inserir o comando todo em uma linha.keytool -import -file "C:\Program Files (x86)\ibm\cognos\TM1_64\bin64\ssl\applixca.pem" -keystore "C:\Program Files (x86)\ibm\cognos\TM1_64\bin64\jre\6.0\lib\security\cacerts" -storepass "changeit"

Se você não destinar corretamente os locais de certificados de 64 bits aoexecutar uma instalação de 64 bits, receberá uma mensagem de avisoindicando que não é possível contatar os servidores.

c. Insira yes quando solicitado para confiar ou incluir o certificado.

A seguinte mensagem é exibida: O certificado foi incluído no keystore

2. Talvez seja necessário reiniciar o Apache Tomcat para que a mudança entre emvigor.

Lembre-se: Inclua novamente os certificados sempre que reinstalar o CognosTM1 .


Implementar Cognos TM1 Operations Console com a VersãoFornecida do Apache Tomcat

Use a ferramenta IBM Cognos Configuration para implementar o IBM Cognos TM1Operations Console com a versão do Apache Tomcat fornecida com a instalação doCognos TM1 . O Cognos TM1 Operations Console usa a mesma versão do Tomcatque o IBM Cognos TM1 Application Server.

Antes de Iniciar

Se você instalou o produto a partir do diretório de Arquivos de Programa (x86) emum computador executando o software de sistema operacional Microsoft WindowsVista, Windows 7 ou Windows 2008, inicie o IBM Cognos Configuration comoAdministrador.


Configuration.2. Clique com o botão direito do mouse em TM1 Applications e clique em

Iniciar.Esta etapa inicia a versão do Tomcat fornecida com o Cognos TM1 eimplementa automaticamente o Cognos TM1 Operations Console.

3. Salve os dados de configuração clicando em Arquivo > Salvar.4. Feche o Cognos Configuration clicando em Arquivo > Sair.

Criar um Grupo de Usuários para o Cognos TM1 OperationsConsole

O IBM Cognos TM1 Operations Console requer um grupo de usuários designadodo Cognos TM1 que é criado no Cognos TM1 Architect.

Procedimento1. Execute o Cognos TM1 Architect.

Lembre-se: Se o TM1 Admin Server e o servidor que você quer monitorarainda não tiverem sido iniciados, use o Cognos Configuration para iniciá-losantes da execução do Cognos TM1 Architect.

2. No Cognos TM1 Architect, dê um clique duplo no TM1 para ver os servidoresque estão em execução e disponíveis para você.

3. Clique duas vezes no servidor que deseja monitorar e efetue login nele com onome de usuário e senha para esse servidor.

4. Clique com o botão direito do mouse no servidor e selecione Segurança >Clientes e Grupos para incluir um novo grupo de usuários especificamentepara o Cognos TM1 Operations Console.

5. Selecione Grupos > Incluir Novo Grupo e inserir um nome de grupo, comomonitor ou outro nome facilmente identificável para o grupo do Cognos TM1Operations Console.Talvez seja necessário rolar pela janela para ver o grupo novo que você acaboude incluir.

6. Clique em OK.7. Designe um usuário para o novo grupo:

Capítulo 12. Instalando o Cognos TM1 Operations Console 127

Apenas esses usuários poderão efetuar login no Cognos TM1 OperationsConsole.v Para usuários de tipo de administrador, designe-os para o novo grupo e

também para o grupo integrado SecurityAdmin e/ou ADMIN.v Se quiser que o usuário de monitoramento seja um usuário padrão, designe-o

ao novo grupo e ao grupo DataAdmin do Cognos TM1 .Consulte Guia de Operações do IBM Cognos TM1 para obter detalhes sobre comodesignar grupos de segurança no Cognos TM1 .

8. Clique em OK para retornar para o Server Explorer. É possível fechar o CognosTM1 Architect.

Editar o Arquivo OpsConfig.xmlO IBM Cognos TM1 Operations Console usa um arquivo XML para identificar ogrupo de usuários, o servidor e o host administrativo a serem usados. Antes depoder executar o Cognos TM1 Operations Console, você precisa atualizar essearquivo de configuração com as informações que descrevem seu novo grupo demonitoramento.

Antes de Iniciar

Assegure-se de incluir e configurar um grupo de usuários designado no CognosTM1 Architect especificamente para o Cognos TM1 Operations Console.

Procedimento1. Edite o arquivo OpsConfig.xml usando um editor XML ou de texto.

v Para o Apache Tomcat fornecido com a instalação do Cognos TM1 , oarquivo está localizado aqui:TM1_location\webapps\tm1operationsconsole\WEB-INF\configuration

v Se você estiver usando sua própria versão do Apache Tomcat, o arquivo serálocalizado aqui:C:\Program Files\Apache Software Foundation\Tomcat 6.0\webapps\tm1operationsconsole\WEB-INF\configuration

2. Atualize o arquivo OpsConfig.xml com o host administrativo, o servidor enomes dos grupos.O arquivo OpsConfig.xml de amostra a seguir está configurado para o servidorCognos TM1 de amostra sdata em execução no computador local com umgrupo de usuários denominado "monitor."<ops>

<adminhost name="localhost"><server name = "sdata">

<group>monitor</group></server>

</adminhost></ops>

3. Salve e feche o arquivo OpsConfig.xml.

Configurar Microsoft Internet Explorer 8 para o Cognos TM1Operations Console

Você precisa fazer algumas configurações adicionais para usar o navegador da Webdo Microsoft Internet Explorer 8 com o IBM Cognos TM1 Operations Console.


Procedimento1. No Internet Explorer 8, ative a opção para atualizar as páginas da Web a cada

visita.2. Desative as opções para depuração de script.

Para obter informações adicionais, consulte a documentação do MicrosoftInternet Explorer.

Iniciar e Efetuar Login no Cognos TM1 Operations ConsolePara executar o IBM Cognos TM1 Operations Console, insira a URL que identificaa porta e o nome do servidor para o componente.

Procedimento1. Em um navegador da Web, digite o seguinte endereço da web:

http://server_name:port_number/tm1operationsconsole

em quev server_name é o computador onde o Cognos TM1 Operations Console e seu

servidor de aplicativos da web estão instalados.

Dica: É possível usar a palavra-chave localhost se você estiver atualmenteconectado ao servidor da Web que está executando o Cognos TM1Application Web. Ou é possível usar o nome da máquina, o nome dedomínio ou o endereço IP do servidor da Web que hospeda o aplicativo.

v port_number é o número da porta em que o servidor de aplicativos da Webestá sendo executado. Para a versão do Apache Tomcat que é fornecida coma instalação do Cognos TM1 , o número da porta padrão é 9510.

Dica: Para uma versão diferente do Apache Tomcat, abra o arquivoserver.xml do Apache Tomcat no local C:\Program Files\Apache SoftwareFoundation\Tomcat 6.0\conf\ para determinar a configuração da porta que aversão do Tomcat está usando.

2. Na página de login, insira valores para os seguintes campos e, em seguida,clique em Login.v TM1 Host Administrativo

v Nome do Servidor

v Nome do Grupo

v Nome de Usuário

v Nome da Senha

Dica: Se você receber a mensagem de erro No server specified inOpsConfig.xml, verifique o seguinte:v Assegure-se de que o servidor Cognos TM1 configurado no arquivo

OpsConfig.xml esteja em execução.v Assegure-se de ter executado as etapas para incluir certificados no keystore

Java Runtime Environment (JRE) para o Cognos TM1 Operations Console.v Assegure-se de ter inserido o nome do grupo de usuários do Cognos TM1

Operations Console corretamente no arquivo OpsConfig.xml.Consulte o IBM Cognos TM1 Operations Console Guide para começar a usar oCognos TM1 Operations Console.


Usando a Própria Versão do Apache Tomcat FornecidoUse o seguinte conjunto de etapas se você estiver usando a própria versão doApache Tomcat.

Verificar a Variável de Ambiente do Usuário do JREO Cognos TM1 Operations Console precisa da variável de ambiente do usuário docaminho de classe configurada.

Se você estiver usando sua própria instalação do Apache Tomcat, verifique sepossui a seguinte variável de ambiente de usuário do Windows para o caminho doJRE.v Nome de Variável: classpathv Valor da Variável: .;C:\Program Files\Java\jre6\bin

Se estiver usando o Tomcat fornecido com a instalação do Cognos TM1 , a variávelserá configurada para você.

Incluir Certificados no Keystore do JREO IBM Cognos TM1 Operations Console requer um certificado no keystore JavaRuntime Environment (JRE).

Procedimento1. Execute o comando keytool do Java para importar o certificado no keystore.

a. Abra um prompt de comandos e altere para o seguinte diretório:<location> \bin\jre\6.0\bin

em que <location> é o diretório de arquivo onde o Cognos TM1 estáinstalado.CUIDADO:Em computadores de 64 bits, certifique-se de incluir os certificados napasta bin64.

b. Execute a linha de comandos a seguir. Para propósitos de formatação, ocomando é mostrado aqui com quebras de linha, mas você deve inserir ocomando todo em uma linha.keytool -import -file "C:\<location>\bin\ssl\applixca.pem"-keystore "C:\<location>\bin\jre\6.0\lib\security\cacerts"-storepass "changeit"

Para instalações de 64 bits, destine a pasta de 64 bits ao tratar com oscertificados. Por exemplo, este comando de amostra destina o JRE de 64bits:cd C:\Program Files (x86)\ibm\cognos\TM1_64\bin64\jre\6.0\bin

O comando a seguir é um exemplo usado nos sistemas de 64 bits. Parapropósitos de formatação, este comando é mostrado com quebras de linha,mas você deve inserir o comando todo em uma linha.keytool -import -file "C:\Program Files (x86)\ibm\cognos\TM1_64\bin64\ssl\applixca.pem" -keystore "C:\Program Files (x86)\ibm\cognos\TM1_64\bin64\jre\6.0\lib\security\cacerts" -storepass "changeit"

Se você não destinar corretamente os locais de certificados de 64 bits aoexecutar uma instalação de 64 bits, receberá uma mensagem de avisoindicando que não é possível contatar os servidores.

c. Insira yes quando solicitado para confiar ou incluir o certificado.

A seguinte mensagem é exibida: O certificado foi incluído no keystore


2. Talvez seja necessário reiniciar o Apache Tomcat para que a mudança entre emvigor.

Lembre-se: Inclua novamente os certificados sempre que reinstalar o CognosTM1 .

Implementar o Cognos TM1 Operations ConsoleAntes de começar a usar o IBM Cognos TM1 Operations Console, você deveimplementá-lo no Apache Tomcat.

Antes de Iniciarv Inicie uma instância do Apache Tomcat no computador no qual deseja

implementar o Cognos TM1 Operations Console.v Assegure-se de que possa acessar o console do Apache Tomcat Manager.v Se você não tiver usado o Tomcat Manager anteriormente, inclua um usuário e

uma função no arquivo tomcat-users.xml antes que possa efetuar login. Paraobter informações adicionais, consulte a documentação do Apache Tomcat.

Procedimento1. Com o Apache Tomcat em execução, clique em Iniciar > Programas > Tomcat

Manager. Insira o nome de usuário e senha, se eles forem necessários parainstância do Apache Tomcat.

2. No Tomcat Manager, role para baixo até a seção Implementar e localize asubseção Arquivo WAR para implementar.CUIDADO:Se uma versão anterior do Cognos TM1 Operations Console já tiver sidoimplementada, use a opção undeploy no Tomcat Manager para remover aimplementação da versão anterior.

3. Clique em Navegar para localizar o archive de aplicativo da webtm1operationsconsole.war do Cognos TM1 Operations Console. O local típicodesse arquivo é install_location/webapps/tm1operationsconsole.war

4. Clique em OK.5. No Tomcat Manager, clique em Implementar.

Quando a implementação for concluída, o Cognos TM1 Operations Consoleserá exibido como /tm1operationsconsole na seção Aplicativos do TomcatManager.

Criar um Grupo de Usuários para o Cognos TM1 OperationsConsole

O IBM Cognos TM1 Operations Console requer um grupo de usuários designadodo Cognos TM1 que é criado no Cognos TM1 Architect.

Procedimento1. Execute o Cognos TM1 Architect.

Lembre-se: Se o TM1 Admin Server e o servidor que você quer monitorarainda não tiverem sido iniciados, use o Cognos Configuration para iniciá-losantes da execução do Cognos TM1 Architect.

2. No Cognos TM1 Architect, dê um clique duplo no TM1 para ver os servidoresque estão em execução e disponíveis para você.


3. Clique duas vezes no servidor que deseja monitorar e efetue login nele com onome de usuário e senha para esse servidor.

4. Clique com o botão direito do mouse no servidor e selecione Segurança >Clientes e Grupos para incluir um novo grupo de usuários especificamentepara o Cognos TM1 Operations Console.

5. Selecione Grupos > Incluir Novo Grupo e inserir um nome de grupo, comomonitor ou outro nome facilmente identificável para o grupo do Cognos TM1Operations Console.Talvez seja necessário rolar pela janela para ver o grupo novo que você acaboude incluir.

6. Clique em OK.7. Designe um usuário para o novo grupo:

Apenas esses usuários poderão efetuar login no Cognos TM1 OperationsConsole.v Para usuários de tipo de administrador, designe-os para o novo grupo e

também para o grupo integrado SecurityAdmin e/ou ADMIN.v Se quiser que o usuário de monitoramento seja um usuário padrão, designe-o

ao novo grupo e ao grupo DataAdmin do Cognos TM1 .Consulte Guia de Operações do IBM Cognos TM1 para obter detalhes sobre comodesignar grupos de segurança no Cognos TM1 .

8. Clique em OK para retornar para o Server Explorer. É possível fechar o CognosTM1 Architect.

Editar o Arquivo OpsConfig.xmlO IBM Cognos TM1 Operations Console usa um arquivo XML para identificar ogrupo de usuários, o servidor e o host administrativo a serem usados. Antes depoder executar o Cognos TM1 Operations Console, você precisa atualizar essearquivo de configuração com as informações que descrevem seu novo grupo demonitoramento.

Antes de Iniciar

Assegure-se de incluir e configurar um grupo de usuários designado no CognosTM1 Architect especificamente para o Cognos TM1 Operations Console.

Procedimento1. Edite o arquivo OpsConfig.xml usando um editor XML ou de texto.

v Para o Apache Tomcat fornecido com a instalação do Cognos TM1 , oarquivo está localizado aqui:TM1_location\webapps\tm1operationsconsole\WEB-INF\configuration

v Se você estiver usando sua própria versão do Apache Tomcat, o arquivo serálocalizado aqui:C:\Program Files\Apache Software Foundation\Tomcat 6.0\webapps\tm1operationsconsole\WEB-INF\configuration

2. Atualize o arquivo OpsConfig.xml com o host administrativo, o servidor enomes dos grupos.O arquivo OpsConfig.xml de amostra a seguir está configurado para o servidorCognos TM1 de amostra sdata em execução no computador local com umgrupo de usuários denominado "monitor."


<ops><adminhost name="localhost">

<server name = "sdata"><group>monitor</group>

</server></adminhost>

</ops>

3. Salve e feche o arquivo OpsConfig.xml.

Configurar Microsoft Internet Explorer 8 para o Cognos TM1Operations Console

Você precisa fazer algumas configurações adicionais para usar o navegador da Webdo Microsoft Internet Explorer 8 com o IBM Cognos TM1 Operations Console.

Procedimento1. No Internet Explorer 8, ative a opção para atualizar as páginas da Web a cada

visita.2. Desative as opções para depuração de script.

Para obter informações adicionais, consulte a documentação do MicrosoftInternet Explorer.

Iniciar e Efetuar Login no Cognos TM1 Operations ConsolePara executar o IBM Cognos TM1 Operations Console, insira a URL que identificaa porta e o nome do servidor para o componente.

Procedimento1. Em um navegador da Web, digite o seguinte endereço da web:

http://server_name:port_number/tm1operationsconsole

em quev server_name é o computador onde o Cognos TM1 Operations Console e seu

servidor de aplicativos da web estão instalados.

Dica: É possível usar a palavra-chave localhost se você estiver atualmenteconectado ao servidor da Web que está executando o Cognos TM1Application Web. Ou é possível usar o nome da máquina, o nome dedomínio ou o endereço IP do servidor da Web que hospeda o aplicativo.

v port_number é o número da porta em que o servidor de aplicativos da Webestá sendo executado. Para a versão do Apache Tomcat que é fornecida coma instalação do Cognos TM1 , o número da porta padrão é 9510.

Dica: Para uma versão diferente do Apache Tomcat, abra o arquivoserver.xml do Apache Tomcat no local C:\Program Files\Apache SoftwareFoundation\Tomcat 6.0\conf\ para determinar a configuração da porta que aversão do Tomcat está usando.

2. Na página de login, insira valores para os seguintes campos e, em seguida,clique em Login.v TM1 Host Administrativo

v Nome do Servidor

v Nome do Grupo

v Nome de Usuário

v Nome da Senha


Dica: Se você receber a mensagem de erro No server specified inOpsConfig.xml, verifique o seguinte:v Assegure-se de que o servidor Cognos TM1 configurado no arquivo

OpsConfig.xml esteja em execução.v Assegure-se de ter executado as etapas para incluir certificados no keystore

Java Runtime Environment (JRE) para o Cognos TM1 Operations Console.v Assegure-se de ter inserido o nome do grupo de usuários do Cognos TM1

Operations Console corretamente no arquivo OpsConfig.xml.Consulte o IBM Cognos TM1 Operations Console Guide para começar a usar oCognos TM1 Operations Console.

Usando o Websphere 7.0 e 8.0É possível instalar o IBM Cognos TM1 Operation Console no Websphere.

Importar Certificados do WebsphereSiga estas etapas para importar os certificados necessários para a execução do IBMCognos TM1 Operations Console no IBM WebSphere.

Procedimento1. Abra o Websphere Admin Console.2. No Websphere Administration Console, acesse Segurança > Certificados SSL e

Gerenciamento de Chaves Definições de Configuração, selecione GerenciarConfigurações de Segurança do Terminal.

3. Selecione a Configuração de Saída apropriada para acessar a célula, emseguida, clique em Nó.

4. Em Itens Relacionados, clique em Armazenamentos de Chaves e Certificadose clique no keystore NodeDefaultTrustStore.

5. Em Propriedades Adicionais, clique em Certificados de Assinante e Recuperara Partir da Porta.

6. Defina as configurações do Cognos TM1 Admin.a. Nome do Host: Insira o nome do computador no qual o Cognos TM1

Admin Server está sendo executado.b. Porta: 5498c. Alias: <um alias para este campo>.

d. Clique em Recuperar Informações do Assinante.e. Verifique se as informações de certificado são para um certificado que é

possível confiar.f. Clique em Aplicar e Salvar para salvar a Configuração Principal.

7. Após ter salvado com sucesso a Configuração Principal para o Cognos TM1Admin Server, use a mesma tela para definir as configurações para o CognosTM1 Server:a. Nome do Host: Insira o nome do computador onde o Cognos TM1 está

sendo executado.b. Porta: insira o número da porta listado no arquivo tm1s.cfg deste servidor.c. Alias: <um alias para este campo>.

d. Clique em Recuperar Informações do Assinante.

e. Verifique se as informações de certificado são para um certificado que épossível confiar.

f. Clique em Aplicar e Salvar para salvar a Configuração Principal novamente.


Implementando Cognos TM1 Operations Console noWebSphere

Siga estas etapas para implementar o IBM Cognos TM1 Operations Console em umservidor da Web IBM WebSphere.

Antes de Iniciar

Consulte a documentação do Websphere para obter detalhes sobre como usar oIBM Websphere.

Antes da implementação, assegure-se de que o Cognos TM1 Operations Consolefoi instalado quando você instalou o Cognos TM1 . Cognos TM1 OperationsConsole é um componente de aplicativo da Web que é selecionado por padrão. Sevocê não o instalou, é possível executar novamente a instalação e selecionar apenaso Cognos TM1 Operations Console para instalar somente esse componente.

Após a instalação, determine o local do arquivo tm1operations.war, quegeralmente é C:/<installation_location>/webapps

Procedimento1. Abra e efetue login no Websphere Administrative Console.2. Na área de janela direita em Aplicativos, clique em Novo Aplicativo > Novo

Aplicativo Corporativo.3. Especifique o endereço do arquivo tm1operationsconsole.war e clique em

Avançar.4. Selecione Atalho e clique em Avançar.5. Em Selecionar Aplicativos de Instalação, aceite os padrões clicando em

Avançar.6. Em Mapear Módulo para Servidores, selecione o(s) servidor(es) no(s) qual(is)

deseja instalar os módulos que estão em seu aplicativo e clique em Avançar.7. Em Mapear Hosts Virtuais para Módulos da Web, especifique o host virtual

no qual deseja instalar os módulos da web que estão em seu aplicativo eclique em Avançar.

8. Em Mapear Raízes de Contexto para Módulos da Web, insira a Raiz deContexto como /tm1operationsconsole

9. Clique em Salvar para salvar a Configuração Principal.10. Inclua um grupo de usuários de monitoramento no Cognos TM1 . Consulte

“Criar um Grupo de Usuários para o Cognos TM1 Operations Console” napágina 127 para obter detalhes.

11. Edite o arquivo OpsConfig.xml. Consulte “Editar o Arquivo OpsConfig.xml”na página 128 para obter detalhes.

Iniciando o Cognos TM1 Operations Console no WebSphereApós incluir certificados e implementar o IBM Cognos TM1 Operations Console,inicie-o a partir do navegador da Web.

Procedimento1. No Websphere Enterprise Application, marque o tm1operationsconsole.war

2. Clique em Iniciar.3. Abra um navegador web.


4. Insira a URL para o Cognos TM1 Operations Console, por exemplo,http://localhost:9080/tm1operationsconsole/


Capítulo 13. Instalação das Ferramentas Cognos TM1

Um conjunto de utilitários e ferramentas do Cognos é instalado quando ocomponente TM1 Application Tier > TM1 Tools é selecionado durante ainstalação.

Estas ferramentas são componentes opcionais que é possível escolher para nãoinstalar cancelando a seleção do componente TM1 Tools durante a instalação. Estasferramentas são instaladas em <TM1_location>/bin

As ferramentas instaladas neste grupo incluem:v TM1RunTI

TM1RunTI é uma ferramenta de interface de linha de comandos que podeiniciar um processo TM1 TurboIntegrator (TI) de dentro de qualquer aplicativocapaz de emitir comandos do sistema operacional.Local: <TM1_location>/binNome do Arquivo: tm1runti.exeConsulte o capítulo "Editando Procedimentos Avançados" do Guia do IBM CognosTM1 TurboIntegrator.

v tm1xfer

O utilitário tm1xfer compacta e move objetos do servidor IBM Cognos TM1 deuma plataforma para uma outra plataforma enquanto preserva nomescompostos por letras maiúsculas e minúsculas para objetos nas plataformasMicrosoft Windows e UNIX.Local: <TM1_location>/binNome do Arquivo: tm1xfer.cmd e tm1xfer.jar

Consulte o capítulo "Ferramentas e Utilitários" do Guia de Operações do IBMCognos TM1.

Outras ferramentas disponíveis para Cognos TM1 incluem:v Cognos TM1 Operations Console

O Cognos TM1 Operations Console pode monitorar diversos servidores TM1 efornece recursos de formatação extensivos para arquivos de log. O Cognos TM1Operations Console possui seu próprio componente que pode ser selecionado nainstalação. Consulte o Guia do IBM Cognos TM1 Operations Console para obterdetalhes.

v TM1 Top

O TM1 Top monitora um único servidor Cognos TM1. Instalado por padrão.Consulte o capítulo "Desempenho e Monitoramento do Sistema" do Guia deOperações do IBM Cognos TM1 para obter detalhes.

v odbc_test

A ferramenta odbc_test é usada para diagnosticar e testar uma conexão ODBCdo IBM Cognos TM1 no UNIX. Consulte o capítulo "Ferramentas e Utilitários"do Guia de Operações do IBM Cognos TM1 para obter detalhes.



Capítulo 14. Instalação de Interoperabilidade do Cognos TM1e do Cognos Business Intelligence

Use o programa de instalação de interoperabilidade do IBM Cognos TM1 BusinessIntelligence (BI) para integrar o IBM Cognos TM1 em um ambiente do IBMCognos BI existente. Esse programa de instalação instala componentes quesuportam Cognos TM1 Viewer Portlets em painéis do Cognos BI, fornecendo IBMCognos Insight do Cognos BI Gateway e vinculando a IBM Cognos TM1Applications do Cognos BI.

Requisitos de Instalação

Revise as seguintes considerações e requisitos antes da instalação:v Os recursos de interoperabilidade do Cognos TM1 BI são suportados com o IBM

Cognos BI 10.1.1.v Você deve instalar os arquivos de interoperabilidade do Cognos TM1 BI em uma

instalação existente do Cognos BI.v O local da instalação padrão é: c:\Arquivos de Programas\IBM\cognos\c10

v Você deve ter a variável de ambiente TM1_PATH especificada antes de se conectarao Cognos TM1 em um ambiente UNIX.

Componentes e Funcionalidade

O programa de instalação de interoperabilidade do Cognos TM1 BI instala osseguintes componentes e funcionalidade. Você deve instalar o programa deinstalação de interoperabilidade do Cognos TM1 BI em todos os locais do CognosBI Gateway e Cognos BI Application Server para ativar esses recursos.v Camada do Aplicativo TM1

Instala os arquivos necessários para Cognos TM1 Viewer Portlets que permitemque páginas do IBM Cognos Connection acessem visualizações do cubo eplanilhas da web do TM1.

v Camada do Aplicativo da Web

– Instala cópias dos arquivos de instalação para IBM Cognos Insight para queesse cliente possa ser aprovisionado pelo Cognos BI Gateway.

– Instala os arquivos necessários que fornecem vinculação para o Cognos TM1Applications a partir do Cognos BI.

Atenção: Para ativar o relatório do Cognos BI com relação às origens de dados doCognos TM1, use o programa de instalação do Cognos TM1 10.1 Client parainstalar a opção de APIs requerida do Cognos TM1 em um diretório adjacente emtodos os servidores Cognos BI que estão executando serviços de relatórios noMicrosoft Windows. Isso se aplica às novas instalações do Cognos TM1 10.1 e àsinstalações do Cognos TM1 10.1 existentes, que configuram subsequentemente oCognos BI. Para obter detalhes, consulte “Ativando Relatório do Cognos BI emOrigens de Dados do Cognos TM1” na página 141.

Instalar a Interoperabilidade do Cognos TM1 BISiga estas etapas para instalar a interoperabilidade do IBM Cognos TM1 BI.


Sobre Esta Tarefa

Este programa de instalação instala os arquivos necessários sob o mesmo diretóriono qual seus componentes Cognos existentes estão instalados. Por exemplo, se seuscomponentes Cognos existentes estiverem instalados em C:\Arquivos deProgramas\IBM\cognos\c10, você deverá instalar os arquivos de interoperabilidadeneste mesmo local.

Os Cognos TM1 Viewer Portlets precisam ser instalados em todos oscomputadoresCognos em um ambiente de relatório.

Procedimento1. Pare o serviço do IBM Cognos.2. Dê um clique duplo no arquivo issetup.exe para o programa de instalação de

interoperabilidade do IBM Cognos TM1 BI.3. Siga as instruções no assistente de instalação e selecione os componentes que

deseja instalar:v Camada do Aplicativo TM1

v TM1 Contributor Gateway

Nota: Para obter uma descrição dos recursos instalados com cada componente,consulte Capítulo 14, “Instalação de Interoperabilidade do Cognos TM1 e doCognos Business Intelligence”, na página 139.

4. Revise o resumo de instalação e clique em Avançar.5. Na página Concluir, visualize os arquivos de log se for necessário e clique em

Concluir.6. Execute as etapas de configuração adicionais para a funcionalidade de

interoperabilidade que deseja ativar.Por exemplo,v “Configurar a Interoperabilidade do Cognos TM1 BI para Usar Segurança do

IBM Cognos”v “Configurar o Cognos BI para o Cognos TM1 Viewer Portlets”

7. Reinicie o serviço do IBM Cognos.

Configurar a Interoperabilidade do Cognos TM1 BI para UsarSegurança do IBM Cognos

Se desejar usar os componentes IBM Cognos para mostrar cubos do Cognos TM1ou Planilhas da Web do Cognos TM1 sem precisar efetuar login no Cognos TM1,você deverá configurar o servidor Cognos TM1 para usar a segurança do IBMCognos.

Para obter informações adicionais, consulte a seção “Usando a Segurança doCognos com o Cognos TM1 ” na página 197 neste guia.

Configurar o Cognos BI para o Cognos TM1 Viewer PortletsSe você protegeu seus servidores de dados Cognos TM1 com a segurança do IBMCognos, deverá especificar o local dos computadores que estão executando oCognos TM1 Web para que os usuários possam acessar as visualizações do cubo eas planilhas da web do Cognos TM1 a partir do Cognos TM1 Viewer Portlets.


Sobre Esta Tarefa

O arquivo Cognos variables_TM1.xml precisa incluir o nome do servidor da webque executa o Cognos TM1 Web quando os Cognos TM1 Viewer Portlets estão seconectando a um Cognos TM1 Server usando a autenticação de segurança doCognos. Neste cenário, o arquivo variables_TM1.xml é referenciado pelo arquivode configuração do servidor do Cognos TM1 Server, tm1s.cfg.

Procedimento1. No diretório Cognos_BI_location\templates\ps\portal, abra o arquivo

variables_TM1.xml em um editor de texto.2. Na linha com <url></url>, especifique o local para os arquivos

TM1WebLoginHandler.aspx e TM1WebMain.aspx.Por exemplo,<url>http://TM1Webserver/TM1Web/TM1WebLoginHandler.aspx</url><url>http://TM1Webserver/TM1Web/TM1WebMain.aspx</url>

em que TM1Webserver é o nome do computador no qual o Cognos TM1 Webestá em execução.

3. Inclua mais especificações de URL até ter listado cada servidor que estáexecutando o Cognos TM1 Web.

4. Salve o arquivo.

Desinstalar a Interoperabilidade do Cognos TM1 BISe você não precisar mais da interoperabilidade do IBM Cognos TM1 BI ou estiverplanejando fazer upgrade para uma liberação mais nova, desinstale oscomponentes de interoperabilidade.

Procedimento1. No menu Iniciar, clique em Programas > IBM Cognos 10, Desinstalar

Interoperabilidade do IBM Cognos TM1 BI > Desinstalar Interoperabilidadedo IBM Cognos TM1 BI.

2. Na página Desinstalar Seleção de Idioma, selecione o idioma para o assistentede desinstalação e clique em Avançar.

3. Selecione Interoperabilidade do IBM Cognos TM1 BI e clique em Avançar.4. Quando a desinstalação for concluída, clique em Concluir.

Alguns arquivos e pastas permanecem no computador até você removê-losmanualmente. Se você estiver planejando uma atualização, não exclua osarquivos e as pastas.

Ativando Relatório do Cognos BI em Origens de Dados do CognosTM1

Para ativar relatório do Cognos BI com relação a origens de dados do CognosTM1, use o programa de instalação do Cognos TM1 Client para instalar osarquivos de API requeridos do Cognos TM1 em todos os servidores Cognos BI queestão executando serviços de relatório no Microsoft Windows.

Sobre Esta Tarefa

Estas etapas se aplicam às novas instalações do Cognos TM1 10.1 e às instalaçõesdo Cognos TM1 10.1 existentes, que configuram subsequentemente o Cognos BI.

Capítulo 14. Instalação de Interoperabilidade do Cognos TM1 e do Cognos Business Intelligence 141

Procedimento1. Execute o programa de instalação do IBM Cognos TM1 Client:

v No software de sistema operacional Microsoft Windows Vista, Windows 7 ouWindows Server 2008, clique com o botão direito do mouse no comandoissetup.exe e clique em Run as Administrator.

v Para outros sistemas operacionais Windows, dê um clique duplo no arquivoissetup.exe.

2. Na página Local da Instalação, selecione um diretório adjacente no servidorCognos BI que está executando serviços de relatórios no Microsoft Windows.

3. Na página Seleção de Componente, expanda TM1 Client Tier e selecione aopção a seguir:TM1 APIs

Deixe todas as outras caixas de seleção desmarcadas.4. Siga os prompts e clique em Concluir para concluir a instalação.


Capítulo 15. Instalação do Cognos TM1 Package Connector

O IBM Cognos TM1 suporta a conectividade com os pacotes do IBM CognosBusiness Intelligence (BI) com relação a determinadas origens de dados.

Consulte a página do software suportado no Centro de Informações do CognosTM1 10.1.0 (http://publib.boulder.ibm.com/infocenter/ctm1/v10r1m0/index.jsp)para obter detalhes das origens de dados suportadas.

Consulte o capítulo "Importando Dados Usando o IBM Cognos TM1 PackageConnector" no Guia do IBM Cognos TM1 Turbo Integrator para obter informaçõesadicionais sobre como usar o Cognos TM1 Package Connector.

O Cognos TM1 Package Connector é um componente opcional disponível comoum CD separado ou como download a partir da instalação principal do CognosTM1.

Requisitos do Cognos TM1 Package ConnectorConsulte os Centros de Informações do IBM Cognos Business Intelligence e doIBM Cognos TM1 para obter mais detalhes sobre as plataformas, versões e osrequisitos suportados.

O Cognos TM1 Package Connector requer os seguintes componentes:v Cognos TM1 9.5.1 ou posterior.

O Cognos TM1 Package Connector deve ser instalado no servidor Cognos TM1 enas máquinas do cliente administrativo nas quais processos do Turbo Integratorestão sendo criados para qualquer origem de dados que está sendo usada.

v IBM Cognos Business Intelligence Server. Consulte o Centro de Informações doCognos BI para obter as versões específicas suportadas.

v IBM Cognos Framework Manager para criação de pacote.v Se sua origem de dados for SAP, o SAP Business Warehouse será necessário.

Consulte o Centro de Informações para obter versões específicas suportadas.v O software do cliente de banco de dados de 32 bits é necessário em todas as

plataformas nas quais o Cognos TM1 Package Connector é instalado para aorigem de dados específica que está sendo usada. Para SAP BW, isto requer aGUI SAP ou os arquivos de biblioteca SAP RFCSDK e DLLs. Consulte o“Ativando a Conectividade para SAP a Partir do Cognos TM1” na página 144.

Instalando o Cognos TM1 Package ConnectorSiga estas etapas para instalar o IBM Cognos TM1 Package Connector:

Procedimento1. Insira o disco do Cognos TM1 Package Connector na máquina servidor do

Cognos TM1.2. Execute o issetup.exe localizado na pasta do sistema para seu sistema

operacional, por exemplo, win32.Isto ativa o Cognos Installer.

3. Conclua os prompts de instalação conforme apropriado para sua instalação.




É possível instalar o produto em uma pasta compatível existente do Cognos BI.Não é necessário criar um local do Cognos BI separado para o Cognos TM1Package Connector.

4. Na tela Concluir, selecione a caixa de seleção Iniciar IBM CognosConfiguration para ativar a janela de configuração automaticamente. Sepreferir, é possível deixar esta caixa desmarcada e ativar o CognosConfiguration manualmente após a instalação.

Instalando o Cognos TM1 Package Connector no Windows 7ou Vista

Por padrão, o diretório temporário para o IBM Cognos TM1 Package Connector noCognos Configuration está no local Arquivos de Programa.

Os aplicativos Microsoft Vista ou Windows 7 não têm permissão para gravar nolocal Arquivos de Programas. Isto pode resultar em um erro ao escolher o CognosTM1 Package Connector a partir do Cognos TM1 Perspectives no Windows 7 eVista.

Para evitar esse problema, escolha Run as Administrator ao executar o MicrosoftExcel. Ou, no Cognos Configuration for Cognos TM1 Package Connector é possívelalterar a configuração do Temporary files location para um diretório que sejagravável pelo usuário.

Ativando a Conectividade para SAP a Partir do Cognos TM1Para ativar a conectividade para SAP, o servidor requer os arquivos de bibliotecaSAP RFCSDK de 32 bits e DLLs no IBM Cognos TM1 Admin Client e no servidorIBM Cognos TM1.

Para obter estes arquivos no Microsoft Windows, instale a GUI SAP. Para UNIX,consulte “Instalando o Cognos TM1 Package Connector no UNIX” na página 146.

Configurando o Cognos TM1 Package ConnectorQuando tiver instalado o IBM Cognos Business Intelligence (BI) TM1 PackageConnector, você terá acesso à Ferramenta de Configuração da IBM.

Se a ferramenta Cognos Configuration não foi ativada automaticamente, é possívelusar a opção Menu Iniciar, IBM Cognos, IBM Cognos Configuration paraativá-la.

Procedimento1. Ative ou abra o Cognos Configuration.2. Selecione o nó Ambiente na janela Explorador de Configuração Local. As

configurações atuais para URI são exibidas.3. Configure o Gateway URI para apontar para o servidor Cognos BI no qual os

pacotes são implementados.O Gateway URI está no formato dehttp[s]://<host IP address>:<port>/<BI_SERVER_virtual_dir>/cgi-bin/cognos.cgi.

Consulte o Guia de Operações do IBM Cognos TM1 ou a documentação doCognos BI para obter informações adicionais sobre os URIs.

4. Insira o URI na coluna Valor do nó Outras Configurações de URI.O Dispatch URI está no formato de


http[s]://<host IP address>:<port>/p2pd/servlet/dispatch.

5. Após o URI ser configurado, clique em Salvar para salvar a configuração.A janela de progresso da configuração verifica o status de suas entradas. Apósa conclusão, clique em Fechar. Se você encontrou um erro, verifique suasconfigurações e reinsira os valores.

6. Feche a janela do Cognos Configuration.

Configurando a Variável de AmbienteNo Microsoft Windows, após você ter instalado o IBM Cognos TM1 PackageConnector, a variável de ambiente do sistema TM1_PACKAGE_CONNECTOR éconfigurada com o diretório de instalação especificado na instalação, por exemploC:\Arquivos de Programas\ibm\Cognos\c10\bin.

É possível alterar esse local se necessário editando a variável ou criando umavariável de ambiente do sistema.

A variável do sistema é criada pela instalação mais recente do Cognos TM1Package Connector. Se o Cognos TM1 Package Connector10 e o Cognos TM1Package Connector8 estiverem coinstalados no mesmo computador, a instalaçãomais recente entrará em vigor com base na configuração de variável do sistemafeita pela instalação.

O local da instalação do Microsoft Windows padrão para Cognos TM1 PackageConnector10 é C:\Arquivos de Programas\ibm\cognos\c10 enquanto o do CognosTM1 Package Connector8 é C:\Arquivos de Programas\ibm\Cognos\c8.

Configurando o Parâmetro de Configuração do ServidorCognos TM1 (Opcional)

Para o processo do IBM Cognos TM1 Turbo Integrator ser executado no servidorCognos TM1, inclua o parâmetro CognosTM1InterfacePath no arquivo deconfiguração do servidor TM1 (tm1s.cfg) para o servidor Cognos TM1 no qualseus dados irão residir após a importação do pacote do Cognos BusinessIntelligence (BI).

Atenção: As informações a seguir se aplicam somente ao usar um sistemaoperacional Microsoft Windows.

O valor do CognosTM1InterfacePath informa ao Cognos TM1 Server onde localizaro Cognos TM1 Package Connector. Isso não será necessário se a variável deambiente TM1_PACKAGE_CONNECTOR estiver definida. Se esse parâmetroestiver definido, ele substituirá a variável de ambienteTM1_PACKAGE_CONNECTOR.

Insira o local do Cognos TM1 Package Connector no arquivo tm1s.cfg do servidorCognos TM1 no qual o Cognos TM1 Package Connector está instalado, porexemplo:CognosTM1InterfacePath=C:\Program Files\ibm\cognos\c10\bin

Lembre-se:

A variável CognosTM1InterfacePath é requerida somente ao usar o Cognos TM1Package Connector no UNIX (AIX, Solaris, Linux).

Capítulo 15. Instalação do Cognos TM1 Package Connector 145

O TM1_Package_CONNECTOR é uma variável de ambiente do sistema queidentifica o local da instalação do Cognos TM1 Package Connector em um sistemaoperacional Windows.

cognosTM1InterfacePath é usado no tm1s.cfg do servidor Cognos TM1 no UNIX,no entanto, se ele for incluído no arquivo tm1s.cfg de um TM1server no Windows,poderá sobrescrever o valor configurado no TM1_Package_Connector.

Cognos TM1 Package Connector no Computador ClienteApós ter instalado e configurado o IBM Cognos TM1 Package Connector noCognos TM1 Server, instale e configure outra cópia do computador clienteadministrador. Use as mesmas configurações para as duas instalações.

Executando o TM1 Package ConnectorConsulte o capítulo "Importando Dados Usando o IBM Cognos TM1 PackageConnector" do Guia do IBM Cognos TM1 TurboIntegrator para obter detalhes sobrecomo executar o Cognos TM1 Package Connector.

Instalando o Cognos TM1 Package Connector no UNIXPara instalar o IBM Cognos TM1 Package Connector no UNIX, siga as mesmasinstruções que para a instalação do Microsoft Windows fazendo os seguintesajustes:

Procedimento1. Use o Java Standard Edition 6 de 32 bits (ou Java SE 6 de 32 bits).2. Configure a variável de ambiente JAVA_HOME=<java_location>, em que

<java_location> é o local da instalação Java de 32 bits.3. Copie os arquivos em <Package_Connector_install_location>/bin/jre/6.0/

lib/ext* para JAVA_HOME/jre/lib/ext.4. Inicie o cogconfig.sh do <Package_Connector_install_location>/bin.5. Coloque os arquivos de biblioteca SAP RFCSDK de 32 bits e DLLs na máquina

UNIX.6. Configure um código de idioma que use a página de códigos UTF-8 para

manipular dados Unicode. Isto é opcional.7. Configure o servidor Cognos TM1 incluindo o parâmetro no arquivo tm1s.cfg:

CognosTM1InterfacePath=/<Package_Connector_install_location>/bin

8. Configure seu ambiente para usar os DLLs SAP e o Cognos TM1 PackageConnector:a. Inclua o diretório lib do RFCSDK no caminho da procura de:,

$LD_LIBRARY_PATH ou $LIBPATHb. Exporte (torne públicas) estas variáveis: $LIBPATH e $LD_LIBRARY_PATH

v O local onde as bibliotecas estão localizadas é diferente em váriasplataformas UNIX:Solaris e Linux: LD_LIBRARY_PATHHPUX: SHLIB_PATHAIX: LIBPATH


Capítulo 16. Instalação do Cognos TM1 Workflow

O IBM Cognos TM1 Workflow é um componente opcional da instalação do IBMCognos TM1.

Consulte Instruções do TM1 Workflow (http://www-01.ibm.com/support/docview.wss?uid=swg27023302) para obter instruções completas sobre comoinstalar o TM1 Workflow.

O IBM Cognos TM1 Workflow Administrator Guide fornece informações sobre ouso do TM1 Workflow. É possível localizar esse manual no Centro de Informaçõesdo IBM Cognos TM1 10.1.0 (http://publib.boulder.ibm.com/infocenter/ctm1/v10r1m0/index.jsp).






Capítulo 17. Configuração Avançada

Esta seção descreve a configuração avançada para customizar o IBM Cognos TM1para suas necessidades de negócios e seu ambiente específicos após ter concluídoas etapas de instalação iniciais.

Alterando Serviços do Cognos TM1 para Serem Executados sob umaConta de Usuário Específica no Windows

Ao usar o IBM Cognos Configuration para gerenciar os serviços do Cognos TM1,você precisa alterar a conta de usuário padrão que executa serviços do MicrosoftWindows para o Cognos TM1 Server, Cognos TM1 Admin Server e Cognos TM1Excel Service. Por padrão, o Cognos Configuration registra esses serviços sob aconta predefinida do Sistema Local Microsoft Windows. Porém, esses serviçosdevem ser alterados para serem executados como uma conta de usuário específica.

Antes de Iniciar

Revise os privilégios de conta necessários para usar uma conta de usuário diferenteda conta do Sistema Local. Para obter detalhes, consulte “Contas de Usuário paraExecução de Serviços do Cognos TM1 no Windows” na página 17.

Sobre Esta Tarefa

Use os Serviços do Windows para alterar a conta do usuário para um componentedo Cognos TM1 configurado para ser executado como um serviço.

Procedimento1. Abra o IBM Cognos Configuration.2. Expanda a árvore Explorer > Configuração Local:

a. Expanda o nó Configuração Local > Ambiente.b. Expanda o nó Acesso a Dados > TM1 Server.

3. Clique com o botão direito do mouse em cada componente Cognos TM1 quedeseja alterar e selecione Parar.v Servidor Admin de TM1

v TM1 Excel Service

v Cognos TM1 Server name - o nome para cada servidor que você possui noCognos Configuration.

Dica: Não é necessário parar o componente TM1 Application Server.4. Abra Serviços do Windows.5. Localize o componente Cognos TM1 que deseja atualizar e altere a conta do

usuário para o serviço do Windows que o executa:a. Clique com o botão direito do mouse no serviço, selecione Propriedades e,

em seguida, clique na guia Efetuar Logon.b. Insira um novo nome de usuário e uma nova senha para o serviço.c. Repita estas etapas para qualquer outro componente Cognos TM1 em

execução como um serviço do Windows que você deseja alterar.6. Feche Serviços do Windows.


7. No Cognos Configuration, reinicie cada serviço que foi alterado:Clique com o botão direito do mouse no item e selecione Iniciar.

8. Feche o Cognos Configuration.

Configuração do Idioma do Cognos TM1IBM Cognos TM1 configura automaticamente o idioma para o Cognos TM1 Server,interface com o usuário do cliente e mensagens, detectando o atual idioma daconta do usuário do sistema operacional ou navegador da web onde eles estão emexecução. É possível substituir esta configuração automática e configurar o CognosTM1 para usar um idioma específico a partir de qualquer um dos idiomassuportados.

Para obter detalhes sobre os idiomas suportados, consulte “Códigos de Idioma doCognos TM1” na página 151.

Detecção Automática do Idioma

O Cognos TM1 usa o processo a seguir para detectar e configurar automaticamenteo idioma no tempo de execução:1. O servidor e os clientes do Cognos TM1 que são executados no Microsoft

Windows tentam detectar e usar o idioma que está configurado no código deidioma do sistema operacional para o usuário atual. No Windows, isso éconfigurado com Opções Regionais e de Idiomas. O idioma detectado seráusado se ele corresponder a um dos idiomas suportados.

Importante: Por padrão, qualquer Cognos TM1 Server iniciado com o IBMCognos Configuration é configurado inicialmente para ser executado como umserviço do Windows usando uma conta do usuário reservado do Sistema LocalWindows. Se quiser que o Cognos TM1 Server use o idioma com base em umaconta do usuário específica, altere o serviço para ser executado como usuário econfigure o idioma para o usuário com Opções Regionais e de Idiomas doWindows. Para obter detalhes, consulte “Alterando Serviços do Cognos TM1para Serem Executados sob uma Conta de Usuário Específica no Windows” napágina 149.

2. Os componentes do servidor e cliente também verificam uma substituição combase no parâmetro de configuração do Cognos TM1 Language:v O servidor verifica o parâmetro Language no arquivo de configuração

Tm1s.cfg. Se um código de idioma válido for configurado, esse idioma seráusado para as mensagens do servidor.

v Os componentes do cliente verificam o parâmetro Language no arquivo deconfiguração Tm1p.ini. Se um código de idioma válido for configurado, esseidioma será usado na interface com o usuário.

3. Se o idioma configurado em qualquer um dos casos acima não corresponder aum idioma válido suportado, o inglês será usado..

Configuração do Idioma para Componentes do Cognos TM1

Os idiomas são configurados separadamente para os seguintes componentes doCognos TM1.


Tabela 23. Resumo da Configuração de Idioma para Componentes do Cognos TM1

Componente Configuração do Idioma

Cognos TM1 Server Use o parâmetro Language no arquivo Tm1s.cfg paraconfigurar um idioma específico para um Cognos TM1Server.

Para obter detalhes, consulte “Configurando o Idioma parao Servidor Cognos TM1” na página 152

Cognos TM1 Architect,

Cognos TM1 Perspectives

Use o parâmetro Language no arquivo Tm1p.ini paraconfigurar um idioma específico para clientes Cognos TM1que são executados no Microsoft Windows.

Para obter detalhes, consulte “Configurando o Idioma paraClientes do Cognos TM1 no Windows” na página 152

Cognos TM1 Web Use as configurações de idioma em seu navegador da Webpara selecionar um idioma específico para o Cognos TM1Web.

Para obter detalhes, consulte Definindo Configurações deIdioma no Microsoft Internet Explorer

Códigos de Idioma do Cognos TM1A tabela a seguir resume os códigos de idioma para os Idiomas Suportados no IBMCognos TM1.

Language Código

Português do Brasil bra

Croata hry

Tcheco csy

Chinês (Simplificado) sch

Chinês (Tradicional) tch

Dinamarquês dan

Alemão deu

Espanhol esp

Finlandês fin

Francês fra

Húngaro hun

Italiano ita

Japonês jpn

Cazaque kaz

Coreano kor

Norueguês nor

Polonês pol

Romeno rom

Russo rus

Sueco sve

Turco trk

Capítulo 17. Configuração Avançada 151

Configurando o Idioma para o Servidor Cognos TM1Use o parâmetro Language no arquivo Tm1s.cfg para configurar um idiomaespecífico para o IBM Cognos TM1 Server.

Sobre Esta Tarefa

O parâmetro de configuração Language para o Cognos TM1 Server controla oidioma para mensagens geradas pelo servidor. O parâmetro também se aplica àinterface com o usuário da caixa de diálogo quando você executa o servidor comoum aplicativo em vez de um serviço do Windows.

Para obter mais detalhes sobre o parâmetro Language do Cognos TM1 Server,consulte Parâmetro Language no Arquivo Tm1s.cfg.

Nota: Se quiser que o Cognos TM1 Server use um idioma com base em uma contado usuário em vez de o parâmetro Language, altere o serviço do MicrosoftWindows que executa o Cognos TM1 Server para ser executado como um usuárioespecífico. Para obter detalhes, consulte “Alterando Serviços do Cognos TM1 paraSerem Executados sob uma Conta de Usuário Específica no Windows” na página149.

Procedimento1. Use um editor de texto para abrir o arquivo de configuração do Cognos TM1

Server, Tm1s.cfg.Para obter detalhes do local, consulte “Local do Arquivo Tm1s.cfg” na página231.

2. Edite ou inclua o parâmetro Language com o código de idioma que deseja usar.Por exemplo:Language=deu

Para obter uma lista de códigos de idioma suportados, consulte “Códigos deIdioma do Cognos TM1” na página 151.

3. Salve e feche o arquivo Tm1s.cfg.4. Reinicie o Cognos TM1 Server.

Configurando o Idioma para Clientes do Cognos TM1 noWindows

Use o parâmetro Language no arquivo Tm1p.ini para configurar um idiomaespecífico para clientes do IBM Cognos TM1 que são executados no MicrosoftWindows tais como o Cognos TM1 Architect e o Cognos TM1 Perspectives.

Sobre Esta Tarefa

Para obter detalhes sobre este parâmetro, consulte Parâmetro Language no ArquivoTm1p.ini.

Nota: O parâmetro Language para clientes do Cognos TM1 é separado doparâmetro de mesmo nome para o Cognos TM1 Server.

Procedimento1. Use um editor de texto para abrir o arquivo de configuração do cliente Cognos

TM1, Tm1p.ini.


Para obter detalhes do local, consulte “Local do Arquivo Tm1p.ini” na página275.

2. Edite ou inclua o parâmetro Language com o código de idioma que deseja usar.Por exemplo:Language=sch

Para obter uma lista de códigos de idioma suportados, consulte “Códigos deIdioma do Cognos TM1” na página 151.

3. Salve e feche o arquivo Tm1p.ini.4. Reinicie o cliente Cognos TM1.

Configurando o Idioma no Internet Explorer para o CognosTM1 Web

As configurações de idiomas no Microsoft Internet Explorer determinam qualidioma é usado na interface do IBM Cognos TM1 Web. No Microsoft InternetExplorer, altere as configurações de idioma para exibir seu idioma principal noCognos TM1 Web.

Alterando Números de Porta Padrão para Cognos TM1 Admin ServerSe você alterar os valores padrão para o Número da Porta do Host do TM1Admin Server ou o Número da Porta SSL do TM1 Admin Server no IBM CognosConfiguration, será necessário atualizar manualmente os novos valores no arquivode serviços do UNIX e do Microsoft Windows em todos os computadores afetadosem seu ambiente. Este arquivo do sistema operacional não é atualizado peloCognos TM1.

Sobre Esta Tarefa

Atualize o arquivo de serviços do sistema operacional em qualquer computadorque executa componentes do Cognos TM1 que precisam se comunicar com oCognos TM1 Admin Server. Por exemplo:v Cognos TM1 Serverv Clientes da área de trabalho do Cognos TM1 tais como Cognos TM1 Architect

ou Cognos TM1 Perspectivesv Aplicativos Cognos TM1 customizados criados com o Cognos TM1 API.v Cognos TM1 Web (apenas servidor da web)

Procedimento1. Localize e abra o arquivo de serviços para o sistema operacional específico.

v Para UNIX, o local típico do arquivo de serviços é:/etc/services

v Para Windows, o local típico do arquivo de serviços é:C:\WINDOWS\system32\drivers\etc\services

2. Inclua ou edite as entradas a seguir no arquivo de serviços com os novosnúmeros de porta. Por exemplo:tm1adminsvr 5400/tcp # Added by IBM Cognos TM1

tm1admsrv_ssl 5403/tcp # Added by IBM Cognos TM1

3. Salve e feche o arquivo.4. Repita estas etapas para cada computador que executa componentes do Cognos

TM1 que se comunicam com o Cognos TM1 Admin Server.


Configurando o Cognos TM1 para Usar IPv6Para usar o IBM Cognos TM1 com Protocolo da Internet versão 6 (IPv6), configureuma combinação de parâmetros do Cognos TM1 e uma variável de ambiente desistema operacional.

Sobre Esta Tarefa

Por padrão, o Cognos TM1 usa IPv4.

É possível configurar o Cognos TM1 para usar um dos seguintes modos paraespecificar qual protocolo da Internet você quer que o Cognos TM1 use com suarede.

ipv4 Configuração padrão. Usada para redes IPv4.

dual Usada para transição de IPv4 para IPv6. Ambos os protocolos sãosuportados.

ipv6 Usada para redes IPv6.

Procedimento1. Configure o Cognos TM1 Admin Server:

a. No computador onde o Cognos TM1 Admin Server está em execução, abrao Cognos Configuration.

b. Expanda o nó Configuração Local > Ambiente e clique em TM1 AdminServer.

c. Na área de janela Propriedades do Componente, configure a opção Suportea IP do TM1 Admin Server como Dual (IPv4 e IPv6), IPv4 ou IPv6.

d. Se for necessário, inclua o endereço IPv6 no arquivo do sistema operacional/etc/hosts no UNIX e no Microsoft Windows. Em alguns casos,dependendo do ambiente de rede e da configuração de DNS, talvez sejanecessário executar essa etapa adicional para executar com sucesso oCognos TM1 Admin Server e o Cognos TM1 Server no modo IPv6.

e. Inclua a variável de ambiente TM1_IPVersion conforme descrito na etapa 3.2. Configure o Cognos TM1 Server:

a. No computador onde o Cognos TM1 Server está em execução, abra oarquivo tm1s.cfg.

b. Configure o parâmetro IPversion para o modo IP que deseja usar.Por exemplo, para especificar que sua rede usa o protocolo IPv6, inclua oparâmetro da seguinte forma:IPVersion=ipv6

Para obter detalhes adicionais, consulte “IPVersion” na página 249.c. Se for necessário, inclua o endereço IPv6 no arquivo do sistema operacional

/etc/hosts no UNIX e no Microsoft Windows.d. Inclua a variável de ambiente TM1_IPVersion conforme descrito na etapa 3.

3. Inclua a variável de ambiente TM1_IPVersion no sistema operacional para cadacomputador que se comunica diretamente com o Cognos TM1 Admin Servere/ou TM1 Server.Use o formato do valor e o nome de variável a seguir:TM1_IPVersion=ip_mode

em que ip_mode pode ser um dos seguintes valores:v Dual


v IPv6

v IPv4

A variável de ambiente TM1_IPVersion é obrigatória em qualquer computadorque esteja executando qualquer um dos seguintes componentes do CognosTM1:v Cognos TM1 Admin Serverv Cognos TM1 Serverv Ferramentas de administrador do Cognos TM1, como TM1 Top ou o

utilitário tm1srvstop.exe.v Cognos TM1 Web (apenas servidor da web)v Servidor Cognos TM1 Applicationv Clientes Cognos TM1:

– Cognos TM1 Architect– Cognos TM1 Perspectives– Cognos Insight– Cognos TM1 Performance Modeler

v Aplicativos customizados que usam o Cognos TM1 API.

Nota: Você não precisa configurar essa variável de ambiente em computadoresque usam apenas um navegador da web para acessar o Cognos TM1 Web.

4. Reinicie quaisquer servidores Cognos TM1 modificados.5. Teste a conexão entre o servidor Cognos TM1 e os aplicativos clientes.

Configurando Computadores Clientes para Exportar Dados do CognosTM1 em Formato PDF

Para exportar dados do IBM Cognos TM1 para o formato Adobe PDF deaplicativos clientes IBM Cognos TM1 em execução no Microsoft Windows,configure PDFCamp como impressora padrão e assegure-se de que o serviço doWindows para o IBM Cognos TM1 Excel Service esteja em execução como umaconta de usuário específica. Essas etapas se aplicam ao IBM Cognos TM1Perspectives, IBM Cognos TM1 Architect e IBM Cognos TM1 Web.

Antes de Iniciar

Verifique se PDFCamp está instalado corretamente confirmando se o Driver daImpressora PDFCamp existe na configuração Impressoras e Faxes do Windows.

Procedimento1. Configure a impressora padrão:

a. No Windows, abra a janela de configuração Impressoras e Faxes.b. Clique com o botão direito do mouse em Driver da Impressora PDFCamp e

selecione Configurar como Impressora Padrão.2. Assegure-se de que o serviço do Windows para o Cognos TM1 Excel Service

esteja em execução como uma conta de usuário específica, e não como umaconta do Sistema Local.a. No servidor da Web onde o Cognos TM1 Web está em execução, abra

Serviços do Windows.b. Localize a entrada para o IBM Cognos TM1 Excel Service.


c. Clique com o botão direito do mouse em IBM Cognos TM1 Excel Service eselecione Propriedades.

d. Insira um usuário e uma senha para um usuário do Windows existente comos direitos apropriados.

e. Reinicie o serviço e feche os Serviços do Windows.

Para obter mais detalhes, consulte “Contas do Usuário para Execução deServiços do Cognos TM1” e “Alterando Serviços do Cognos TM1 para SeremExecutados como uma Conta de Usuário Específica no Windows”.

Configuração Avançada do Cognos TM1 WebEsta seção descreve etapas de configuração adicionais para o IBM Cognos TM1Web que podem ser necessárias para seu ambiente após você concluir a instalaçãoinicial.

Dependendo de seu ambiente, é possível executar a configuração adicional para oservidor da web que está executando o Cognos TM1 Web e para os navegadoresda web que os usuários usarão para se conectar ao Cognos TM1 Web.

Configuração do Navegador da Web para o Cognos TM1 Web

Os usuários se conectam ao Cognos TM1 Web usando um dos navegadores da websuportados em execução em seus próprios computadores. Alguma configuraçãoadicional pode ser necessária. Consulte os tópicos a seguir:v “Configurando o Idioma no Internet Explorer para o Cognos TM1 Web” na

página 153v “Exibindo e Inserindo Números com Base em Configurações Regionais” na

página 157v “Configurando o Internet Explorer para o Cognos TM1 Web” na página 158v “Executando o Cognos TM1 Web no Navegador da Web Firefox” na página 158

Configuração do Servidor da Web para o Cognos TM1 Web

Se necessário, execute estas etapas adicionais em seu servidor da Web paraconfigurar e executar o Cognos TM1 Web.v “Executando a Versão de 64 Bits do Cognos TM1 Web no Windows x64” na

página 159v “Executando a Versão de 64 Bits do Cognos TM1 Web no Windows x64” na

página 159v “Executando o Cognos TM1 Web em um Servidor WAN e Exportando Arquivos

Excel e PDF” na página 160

Configurando a Página de Login Usando AdminHostName eTM1ServerName

Os parâmetros AdminHostName e TM1ServerName controlam se a página delogin do IBM Cognos TM1 Web solicitará ou não que o usuário insira valores parao Host Administrador do TM1 e o servidor TM1 .

Se você definir um valor para qualquer um destes parâmetros no arquivoWeb.config, o processo de login usará o valor especificado e não solicitará estasinformações do usuário.


Parâmetro AdminHostName

Esse parâmetro especifica o nome do Host Administrador no qual um ServidorAdministrativo TM1 está em execução. Edite o parâmetro AdminHostName noarquivo Web.config usando o seguinte formato:<add key="AdminHostName" value="HostName"/>

em que HostName pode ser um dos seguintes valores:v Se HostName estiver em branco (valor-padrão), a página de login exibirá o

prompt do Host Admin.v Se HostName estiver configurado com o nome de um Host Administrador válido

do TM1 , o IBM Cognos TM1 Web usará esse Host Administrador para oprocesso de login e não solicitará informação do usuário.

Parâmetro TM1ServerName

Esse parâmetro configura o nome do servidor TM1 . Edite o parâmetroTM1ServerName no arquivo Web.config usando o seguinte formato:<add key="TM1ServerName" value="ServerName"/>

em que ServerName pode ser um dos seguintes valores:v Se ServerName estiver em branco (valor padrão), o prompt do servidor TM1 será

exibido na página de login do IBM Cognos TM1 Web, conforme mostrado aseguir.

v Se ServerName estiver configurado para um nome do servidor TM1 válido, apágina de login não exibirá um prompt para o Host Administrador nem para oservidor TM1 .

v Se o parâmetro AdminSvrSSLCertID estiver configurado incorretamente, a listasuspensa do nome do servidor será exibirá como vazia e será registrado um errono arquivo TM1Web.config. Consulte "Running TM1 in Secure Mode using SSL"no IBM Cognos TM1 Operation Guide para obter mais informações.

Depois que o usuário inserir um Nome de Usuário e uma Senha válidos, o IBMCognos TM1 Web efetuará login no servidor TM1 especificado pelo parâmetroTM1ServerName no arquivo Web.config.

Por exemplo, o parâmetro TM1ServerName pode ser definido para amostra deplanejamento, conforme mostrado no código a seguir.<add key="TM1ServerName" value="planning sample" />

Configurando o Idioma no Internet Explorer para o CognosTM1 Web

As configurações de idiomas no Microsoft Internet Explorer determinam qualidioma é usado na interface do IBM Cognos TM1 Web. No Microsoft InternetExplorer, altere as configurações de idioma para exibir seu idioma principal noCognos TM1 Web.

Exibindo e Inserindo Números com Base em ConfiguraçõesRegionais

Se estiver executando o cliente IBM CognosTM1 Web em um idioma diferente doidioma de seu sistema operacional, você deverá assegurar que seu idioma donavegador da web e a configuração regional do Microsoft Windows estejamconfigurados com o mesmo valor.


Isto permitirá que você exiba e insira números no Cognos TM1 Web com base emuma configuração regional específica.

Por exemplo, se você tiver um S.O. em inglês, mas desejar executar o Cognos TM1Web em francês, o idioma de seu navegador deverá ser configurado para francês eo idioma da configuração regional de seu computador deverá ser configuradocomo francês.

Configurações Regionais e de Idioma do Windows

Acesse as configurações regionais do Windows abrindo o recurso OpçõesRegionais e de Idioma no Painel de Controle do Windows.

Configurações de Idioma do Navegador da Web

Acesse a configuração de idioma do navegador da Web conforme descrito na seção“Configurando o Idioma no Internet Explorer para o Cognos TM1 Web” na página153.

Configurando o Internet Explorer para o Cognos TM1 WebSe estiver usando o IBM CognosTM1 Web com o Microsoft Internet Explorer,certifique-se de ter esta configuração de segurança ativada para permitir quejanelas de diálogo do Cognos TM1 Web sejam exibidas corretamente.

Altere as configurações de segurança da seguinte forma:v Permitir que Web sites abram janelas sem barras de endereço ou barras de

status.v Permitir janelas iniciadas por script sem restrições de tamanho ou posição.

Se o Internet Explorer não estiver configurado corretamente, alguns diálogos doCognos TM1 Web poderão aparecer truncados.

Executando o Cognos TM1 Web no Navegador da Web FirefoxHá problemas e limitações de configuração ao executar o IBM Cognos TM1 Webcom o navegador da Web Mozilla Firefox 2.0 em sistemas Microsoft Windows eApple Mac OS X.

Ativando a Opção do Windows Aumentar ou Diminuir deJavaScriptPor padrão, o Mozilla Firefox 2.0 desativa a opção JavaScript para aumentar oudiminuir janelas pop-up. O IBM CognosTM1 Web requer que esta opção estejaativada para controlar corretamente a exibição das janelas pop-up, caixas dediálogo e mensagens do Cognos TM1 .

Funcionalidade de Zoom em Planilhas da WebO recurso de zoom no IBM Cognos TM1 Websheets não é suportado no MozillaFirefox nos sistemas Microsoft Windows e Apple Mac OS X.

Ao visualizar planilhas da Web no Firefox, os ícones Aumentar Zoom, DiminuirZoom e Visualização Normal não são exibidos.

Ativando a Exibição de Fontes Symbol e WingdingsSe você usar fontes Symbol ou Wingdings, deverá concluir as etapas a seguir paraconfigurar o Mozilla Firefox para exibir estas fontes.


Procedimento1. Abra o arquivo fontEncoding.properties do Firefox em um editor de texto.

Se você aceitou o diretório de instalação padrão quando instalou o Firefox, ocaminho completo para este arquivo é C:\Arquivos de Programas\MozillaFirefox\res\fonts\fontEncoding.properties.

2. Localize as seguintes linhas:# Symbol font

encoding.symbol.ttf = Adobe-Symbol-Encoding

3. Substitua as linhas acima pelas seguintes:# Symbol font

#-- Enabling Symbol and other fonts for Mozilla on Windows

encoding.symbol.ttf = windows-1252

encoding.wingdings.ttf = windows-1252

encoding.wingdings2.ttf = windows-1252

encoding.wingdings3.ttf = windows-1252

encoding.webdings.ttf = windows-1252

4. Save o arquivo fontEncoding.properties.

Executando a Versão de 64 Bits do Cognos TM1 Web noWindows x64

Para executar a versão de 64 bits do IBM Cognos TM1 Web em um sistemaMicrosoft Windows x64, você deve:v Configurar o Microsoft Internet Information Services (IIS) para executar no

modo de 64 bits.v Registrar a versão de 64 bits do Microsoft .NET Framework 3.5 SP1.

Alternando o IIS para o Modo de 64 BitsAlterne o Microsoft IIS para o modo de 64 bits usando estas etapas.

Procedimento1. Abra um prompt de comandos.2. Insira e execute o seguinte comando:

cscript %SYSTEMDRIVE%\inetpub\adminscripts\adsutil.vbsSET W3SVC/AppPools/Enable32bitAppOnWin64 0

Registrando a Versão de 64 Bits do .NET FrameworkRegistre a versão de 64 bits do .NET Framework usando estas etapas.

Procedimento1. Certifique-se de que a versão de 64 bits do Microsoft .NET Framework 3.5 SP1

esteja instalada no servidor da Web.2. Abra um prompt de comandos.3. Altere para o seguinte diretório:

C:\WINDOWS\Microsoft.NET\Framework64\v2.0.50727)

Nota: O IBM Cognos TM1 Web requer o Microsoft .NET Framework 3.5 SP1,no entanto, o .NET 2.0 permanece no sistema após o upgrade de .NET e énecessário para esta etapa.

4. Insira e execute o seguinte comando:aspnet_regiis.exe -i


Resultados

Seu sistema agora está configurado para executar a versão de 64 bits do CognosTM1 Web.

Para obter mais informações sobre como executar a versão de 64 bits do ASP.NET,consulte o seguinte artigo técnico da Microsoft:http://support.microsoft.com/?id=894435

Executando o Cognos TM1 Web em um Servidor WAN eExportando Arquivos Excel e PDF

Se você estiver executando o IBM CognosTM1 Web em um servidor WAN (Redede Longa Distância) e desejar permitir que os usuários exportem arquivosMicrosoft Excel e PDF a partir do Cognos TM1 Web, será necessário definirconfigurações de segurança específicas no Microsoft Internet Explorer.

Como um servidor WAN reside na zona de Internet, o Internet Explorer aplica umperfil de segurança diferente quando comparado a servidores na zona de IntranetLocal. Para exportar arquivos com sucesso do Cognos TM1 Web em um ambientede WAN, você deve incluir o servidor Cognos TM1 Web como um site confiávelnas configurações de segurança para o Internet Explorer.

Incluindo o Cognos TM1 Web como um Site Confiável noInternet Explorer

Se estiver usando o Microsoft Internet Explorer e executando o IBM Cognos TM1Web em um servidor da WAN, você deverá incluir o servidor Cognos TM1 Webcomo um site confiável e, em seguida, customizar as configurações de segurançapara sites confiáveis.

Incluindo o Cognos TM1 Web como um Site Confiável noInternet ExplorerSe estiver usando o Microsoft Internet Explorer e executando o IBM Cognos TM1Web em um servidor da WAN, você deverá incluir o servidor Cognos TM1 Webcomo um site confiável e, em seguida, customizar as configurações de segurançapara sites confiáveis.

Procedimento1. Abra o Microsoft Internet Explorer.2. Clique em Ferramentas >Opções da Internet.

O diálogo Opções da Internet se abre.3. Clique na guia Segurança.4. Clique em Sites Confiáveis e, em seguida, clique no botão Sites.5. Insira a URL do servidor Cognos TM1 Web na caixa Incluir este website na

zona.6. Clique em Incluir.7. Feche a caixa de diálogo Sites Confiáveis.8. Na guia Segurança do diálogo Opções da Internet, clique em Sites Confiáveis

e, em seguida, clique no botão Nível Customizado.O diálogo Configurações de Segurança - Zona de Sites Confiáveis se abre.

9. Localize as configurações para Downloads e clique em Ativar para a opçãoPrompt Automático para Downloads de Arquivo.


10. Clique em OK.

Usando ClearType no Cognos TM1 Web Server para Aprimorara Exibição e a Renderização de Planilhas da Web

Para aprimorar a exibição das Planilhas da Web do IBM Cognos TM1,especialmente as que incluem uma combinação de áreas de janela congeladas edescongeladas com texto agrupado dentro de células, instale o Microsoft ClearTypeTuner no servidor Cognos TM1 Web.

Esta ferramenta ajuda o Cognos TM1 Web a manter a mesma altura de linha entreáreas de janela congeladas e descongeladas nas planilhas da web. A instalação emsistemas do cliente é opcional.

Instalando e Ativando o ClearType Tuner

Procedimento1. Faça download e instale o Microsoft ClearType Tuner a partir do Web site da

Microsoft.2. Após a instalação, abra Ajuste do ClearType no Painel de Controle do

Microsoft Windows.3. Clique na guia Introdução e certifique-se de que a opção Ativar ClearType

esteja selecionada.4. Clique na guia Avançado e, em seguida, clique no botão Configurar Fonte de

Amostra. Escolha uma fonte para a amostra de texto e, em seguida, clique emOK.

5. Na guia Avançado, clique para ativar a opção Aplicar todas as configuraçõesaos padrões para novos usuários e sistema.

6. Clique em OK.

7. Reinicie o computador.

Configurando o Cognos TM1 Web para Executar no WindowsVista

O sistema Microsoft Windows Vista é um ambiente suportado para aplicativos deprodução ou desenvolvimento do IBM Cognos TM1 . No entanto, é possívelexecutar o Cognos TM1 Web e visualizar Planilhas da Web em um sistemaWindows Vista apenas para demonstração ou uso pessoal.

Se você não configurar o Windows Vista conforme explicado nas etapas a seguir, oCognos TM1 Web exibirá um erro quando você visualizar planilhas da web outentar exportar dados para uma planilha Microsoft Excel.

Esta configuração é para usuários que desejam efetuar logon em um computadorque executa o Windows Vista e trabalham diretamente com o Cognos TM1 Webnesse sistema. Ela não é destinada para acessar remotamente o Cognos TM1 Web apartir de um navegador da Web em um outro computador.

Procedimento1. Clique em Iniciar, Todos os Programas, Acessórios, Executar.

A caixa de diálogo Executar se abre2. Na caixa de diálogo Executar, digite dcomcnfg e, em seguida, clique em OK.

A ferramenta do Windows Component Services é aberta.3. Expanda a árvore até o seguinte nó:


Raiz do Console, Serviços de Componente, Computadores, Meu Computador,Configuração DCOM.

4. Sob o nó Config DCOM, role para baixo e selecione o item AplicativoMicrosoft Excel.

5. Clique com o botão direito do mouse no item Aplicativo Microsoft Excel e, emseguida, clique em Propriedades.A caixa de diálogo Propriedades se abre.

6. Clique na guia Identidade e, em seguida, clique para ativar a opção O usuáriointerativo.

7. Clique em OK para fechar a caixa de diálogo Propriedades e, em seguida,feche a janela Serviços de Componente.

Configuração Avançada do Cognos TM1 ApplicationsÉ possível executar tarefas de configuração avançadas para customizar suainstalação dos componentes IBM Cognos TM Application.

Usando o Cognos TM1 Applications com a Segurança doCognos Business Intelligence

É possível configurar o IBM Cognos TM1 Applications para usar a segurança doIBM Cognos Business Intelligence (BI). Essa configuração requer que os usuáriosefetuem login no Cognos TM1 Applications como um usuário válido que existe noservidor Cognos BI.

Quando você usa o Cognos TM1 Applications com segurança do Cognos BI, oCognos TM1 Application Server pode ser hospedado em um servidor deaplicativos da web de uma das seguintes formas:v Em um computador diferente com o Apache Tomcat que foi fornecido com a

instalação do Cognos TM1v Em um computador diferente com sua instalação do Apache Tomcat ou IBM

Websphere.v Opcionalmente, é possível implementar o Cognos TM1 Applications com o

servidor da Web Apache Tomcat que é fornecido com o Cognos BI.

Em todos os casos, você deve editar o arquivo planning.html e copiá-lo noservidor Cognos BI para que o servidor Cognos BI conheça o local do Cognos TM1Application Server.

Configurando Cognos TM1 Applications para Usar Segurança doCognos Business IntelligencePara configurar o IBM Cognos TM1 Applications para usar segurança do IBMCognos Business Intelligence (BI), você trabalha com arquivos nos computadoreshospedando esses dois componentes, mais o computador no qual o Cognos TM1Server está em execução.

Procedimento1. Configure o servidor Cognos TM1 para usar segurança do Cognos BI.

Para obter detalhes completos, consulte “Usando a Segurança do Cognos com oCognos TM1 ” na página 197.a. Encerre o servidor Cognos TM1.b. Abra o arquivo de configuração Tm1s.cfg em um editor de texto.c. Configure o parâmetro IntegratedSecurityMode como 5 da seguinte forma:



d. Salve e feche Tm1s.cfg.e. Reinicie o servidor Cognos TM1.

2. Edite o arquivo planning.html.

Importante: Os valores para o parâmetro planningServices nesse arquivo sãonecessários para assegurar que o servidor Cognos BI só redirecione usuáriospara locais aprovados. O local do Cognos TM1 Application Server de onde ousuário efetua login deve ser validado como um dos locais aprovados nessearquivo, ou o servidor Cognos BI não redirecionará o usuário.a. Localize o arquivo planning.html:

Cognos TM1 location\webapps\pmpsvc\gateway_files\planning.html

Dica: Talvez você tenha que expandir primeiro o arquivoplanning_gateway.zip para acessar esse arquivo.

b. Abra o arquivo e localize as seguintes linhas:// Update the following to point to the location of the planningservice(s)

var planningServices = ["http://machine.company.com:9510"];

c. Configure o parâmetro planningServices no local do Cognos TM1Application Server.v Se você estiver executando o Cognos TM1 Application Server com o

Apache Tomcat fornecido com a instalação do Cognos TM1:var planningServices = ["http://web_server_address:9510"];

v Se você estiver executando o Cognos TM1 Application Server com oApache Tomcat fornecido com a instalação do Cognos BI:var planningServices = ["http://web_server_address:9300"];

v Se você estiver executando o Cognos TM1 Application Server com seupróprio servidor de aplicativos da web, use o local e o número da portapara esse sistema.

Dica:

Se você estiver usando o mesmo servidor Cognos BI para autenticardiferentes instâncias do Cognos TM1 Applications que estão em execuçãoem diversos computadores, use uma lista separada por vírgulas de nomescompletos de domínio (FQDN) para cada computador. Por exemplo:

var planningServices = ["http://machine1.company.com:port_number","http://machine2.company.com:port_number"];

Dica:

Se o Cognos TM1 Application Server estiver em execução em um servidorda Web que pertence a diversos domínios, use uma lista separada porvírgulas para inserir o nome completo do domínio para cada domínio. Porexemplo:

var planningServices = ["http://computer_A.domain_1:port_number","http://computer_A.domain_2:port_number","http://computer_A.domain_3:port_number"];


d. Salve e feche o arquivo planning.html.3. Copie o arquivo planning.html atualizado e outros arquivos necessários do

Cognos TM1 Applications no servidor Cognos BI.Na pasta Cognos TM1 location\webapps\pmpsvc\gateway_files\

v Copie planning.html em C10 Install Dir\webcontent.v Copie variables_plan.xml em C10 Install Dir\templates\ps\portal.v Copie icon_active_application.gif em C10 Install Dir\webcontent\ps\

portal\images.4. Configure os parâmetros de tempo limite da sessão para o Cognos TM1

Applications e a segurança do Cognos BI para assegurar a detecção de tempolimite adequada.Para obter detalhes, consulte “Configurando Valores de Tempo Limite daSessão para o Cognos TM1 Applications e Segurança do Cognos BI”.

5. Reinicie o servidor Cognos BI.6. Configure Cognos TM1 Applications com valores para IBM Cognos Gateway URI

e IBM Cognos Dispatcher URI .a. Abra o Cognos TM1 Applications usando o formato do link a seguir:

http://web_server_name:port_number/pmpsvc

Por exemplo: http://localhost:9510/pmpsvcb. Efetue login e abra a página do Cognos TM1 Applications Configuration:

v Se estiver executando o Cognos TM1 Applications pela primeira vez, apágina Configuração será aberta após você efetuar login.

v Se você já tiver configurado o Cognos TM1 Applications, abra a páginaConfiguração clicando no ícone Administrar IBM Cognos TM1

Applications na barra de ferramentas da página de portal do TM1Applications.

c. Na página TM1 Applications Configuration, insira valores para osseguintes parâmetros do Cognos TM1 e do Cognos BI:v Insira valores nos campos TM1 Admin Host e Nome do Servidor e

configure as opções para os clientes de contribuição de dados que desejausar. Para obter detalhes, consulte “Configurando o Ambiente doServidor e do Cliente para o Cognos TM1 Applications” na página 86.

v Configure o parâmetro URI do IBM Cognos Gateway. Por exemplo:http://CognosServerName/ibmcognos/cgi-bin/cognos.cgi

v Configure o parâmetro URI do IBM Cognos Dispatcher. Por exemplo:http://CognosServerName:9300/p2pd/servlet/dispatch

Substitua CognosServerName pelo nome do sistema onde o servidor daWeb Cognos BI está em execução.

7. Para testar a configuração, efetue login no Cognos TM1 Applications usandoum navegador da web em um computador remoto. Se você vir o erro a seguir,revise as configurações para o parâmetro planningServices no arquivoplanning.html no servidor Cognos BI.O parâmetro de serviço de planejamento não foi especificado ou não éum dos locais configurados

Configurando Valores de Tempo Limite da Sessão para oCognos TM1 Applications e Segurança do Cognos BIAo usar o IBM Cognos TM1 Applications com a segurança do IBMCognosBusiness Intelligence, configure o tempo limite da sessão pmpsvc com umvalor mais alto do que o tempo limite da sessão do CAM para assegurar a


detecção do tempo limite adequado. Se o tempo limite da sessão do Cognos TM1Applications (pmpsvc) for configurado com um valor inferior ao tempo limite dasessão de segurança do Cognos BI (CAM), o Cognos TM1 Applications nãodetectará corretamente uma finalização de sessão do CAM e não atingirá o tempolimite.

Sobre Esta Tarefa

Para assegurar que o Cognos TM1 Applications possa detectar corretamente umafinalização de sessão do CAM, configure o tempo limite da sessão pmpsvc com umvalor mais alto do que o tempo limite da sessão do CAM.v O tempo limite da sessão pmpsvc é o número de segundos de inatividade após

os quais o Cognos TM1 Applications finaliza uma sessão do usuário. O valorpadrão é 3.600 segundos (1 hora).

v O tempo limite da sessão do CAM é o número de segundos de inatividade apósos quais a segurança do Cognos finaliza uma sessão do usuário. O valor padrãoé 3.600 segundos (1 hora).

Procedimento1. Configure o parâmetro de tempo limite da sessão pmpsvc.

Insira um valor para o atributo timeout do elemento service / session noarquivo pmpsvc_config.xml. Esse arquivo está localizado no diretórioWEB-INF/configuration.Por exemplo:v Quando o Cognos TM1 Applications é implementado com o Apache Tomcat

fornecido com a instalação do Cognos TM1, o arquivo pmpsvc_config.xmlencontra-se aqui:Cognos_TM1_install_location\webapps\pmpsvc\WEB-INF\configuration

v Quando o Cognos TM1 Applications é implementado com uma versãoseparada do Apache Tomcat, o arquivo encontra-se aqui:C:\Program Files\Apache Software Foundation\Tomcat version_number\webapps\pmpsvc\WEB-INF\configuration

Use o formato para o atributo service / session / timeout conforme definidono arquivo de definição de esquema XML pmpsvc_config.xsd localizado nomesmo diretório

2. Configure o tempo limite da sessão do CAM usando o IBM CognosConfiguration.Insira um valor no campo Tempo Limite de Inatividade em Segundos naseção Segurança/Autenticação do Cognos Configuration.

Implementando o Cognos TM1 Applications no Servidor daWeb Cognos BI

É possível implementar o IBM Cognos TM1 Applications no servidor da web doIBM Cognos BI. Essa configuração usa a versão do Apache Tomcat instalada peloCognos BI.

Procedimento1. Use IBM Cognos Configuration para construir o arquivo de aplicativo que

implementa o servidor da Web Cognos BI.Para obter detalhes, consulte “Usar o IBM Cognos Configuration para Construirum Arquivo de Aplicativo para um Servidor Tomcat” na página 88.


2. Copie e implemente os arquivos do Cognos TM1 Applications a seguir noservidor da web do Cognos BI.

Copie de TM1 Install Dir Em C10 Install Dir

O arquivo de aplicativo gerado com CognosConfiguration:pmpsvc.war

C:\Arquivos de Programas\IBM\cognos\tm1\webapps

\webapps

Cognos TM1 location\webapps\pmpsvc\gateway_files\planning.htmlNota: Você pode precisar primeiro expandiro arquivo planning_gateway.zip paraacessar os arquivos de gateway.

\webcontent

Cognos TM1 location\webapps\pmpsvc\gateway_files\variables_plan.xml

\templates\ps\portal

Cognos TM1 location\webapps\pmpsvc\gateway_files\icon_active_application.gif

\webcontent\ps\portal\images

3. Reinicie o servidor Cognos.4. Abra o Cognos TM1 Applications usando o formato do link a seguir:

http://Cognosx_ServerName:9300/pmpsvc

em que x é a versão de BI que está sendo usada.5. Efetue login e abra a página do Cognos TM1 Applications Configuration:

v Se estiver executando o Cognos TM1 Applications pela primeira vez, apágina Configuração será aberta após você efetuar login.

v Se você já tiver configurado o Cognos TM1 Applications, poderá reabrir apágina Configuração clicando no botão Administrar IBM Cognos TM1

Applications na barra de ferramentas da página de portal do TM1Applications.

6. Na página TM1 Applications Configuration, insira valores para os seguintesparâmetros do Cognos TM1 e do Cognos BI:v Insira valores nos campos TM1 Admin Host, Nome do Servidor e

Localizador Uniforme de Recursos do Web Client do TM1. Para obterdetalhes, consulte “Configurando o Ambiente do Servidor e do Cliente parao Cognos TM1 Applications” na página 86.

v Configure o parâmetro URI do IBM Cognos Gateway como:http://Cognosx_ServerName/cognos_dir/cgi-bin/cognos.cgi

v Configure o parâmetro URI do IBM Cognos Dispatcher como:http://Cognosx_ServerName:9300/p2pd/servlet/dispatch

Substitua Cognosx_ServerName pelo nome do sistema no qual o servidor daweb do IBM Cognos BI está em execução.

Resultados

O Cognos TM1 Applications agora está configurado para usar a segurança doCognos e a instância do servidor da web Apache Tomcat que é fornecido com oIBM Cognos.


Configurando o Cognos TM1 Applications com o Microsoft IISO IBM Cognos TM1 Applications usa o IBM Cognos TM1 Web e o MicrosoftInternet Information Services (IIS) para suportar o cliente Cognos TM1 ApplicationWeb. O cliente Cognos TM1 Application Web permite que os usuários visualizem eeditem dados do aplicativo de planejamento no formato de grade. Se desejarpermitir que os usuários usem o Cognos TM1 Application Web, configure estaopção no Cognos TM1 Applications.

Sobre Esta Tarefa

Quando instalar o Cognos TM1 Web, os arquivos necessários para o cliente CognosTM1 Application Web serão copiados no local da instalação do Cognos TM1 Web.

O arquivo principal para o Cognos TM1 Application Web é:

contributor.aspx

O local da instalação é:

TM1_install_location\TM1Web

Configure o parâmetro de URL do Cognos TM1 Application Web no Cognos TM1Applications para apontar para o arquivo contributor.aspx neste local.

Procedimento1. Use a página Configuração do Cognos TM1 Application para configurar o

parâmetro de URL do Cliente Cognos TM1 Web:v Se estiver executando o Cognos TM1 Applications pela primeira vez, use a

página Configuração que é aberta quando você inicia o programa.Para obter detalhes adicionais, consulte “Configurando o Ambiente doServidor e do Cliente para o Cognos TM1 Applications” na página 86.

v Se você já estiver usando o Cognos TM1 Applications, poderá reabrir apágina Configuração clicando no botão Administrar IBM Cognos TM1

Applications na barra de ferramentas no Cognos TM1 Applications.2. No campo Localizador Uniforme de Recursos do Web Client do TM1, insira o

local do Localizador Uniforme de Recursos no arquivo contributor.aspx.Por exemplo:http://WebServer/TM1Web/contributor.aspx

Configurando o Cognos TM1 Applications para Usar DiversosCognos TM1 Servers

Quando você inicia o IBM Cognos TM1 Applications pela primeira vez, é possívelinserir somente um servidor Cognos TM1 com o qual deseja trabalhar.

Para inserir servidores adicionais, use a página Configuração do Cognos TM1Applications disponível a partir da página de portal do Cognos TM1 Applications.

Importante: Para usar diversos servidores Cognos TM1 no Cognos TM1Applications, todos eles devem usar a mesma autenticação de segurança(autenticação padrão do Cognos TM1 ou segurança do Cognos BI) e incluir omesmo nome do usuário administrador e a mesma senha. Para obter detalhes,consulte “Considerações de Segurança para Cognos TM1 Applications” na página40.


Após incluir diversos servidores Cognos TM1, eles estarão disponíveis quandousar o IBM Cognos TM1 Performance Modeler para projetar seus aplicativos deplanejamento.

Para obter detalhes adicionais, consulte o Guia do Usuário do IBM Cognos TM1Performance Modeler.

Procedimento1. Efetue login no Cognos TM1 Applications.2. Na barra de ferramentas da página de portal do Cognos TM1 Applications,

clique no botão Administrar Cognos TM1 Applications .A página Configuração do IBM Cognos TM1 Applications é aberta

3. Na seção Nomes de Servidor, clique em Incluir.A caixa de diálogo Incluir Servidor é aberta.

4. Insira valores para o seguinte:v Host Administrativo - Especifica o nome do computador ou endereço IP do

Host Administrativo no qual o Cognos TM1 Admin Server está em execução.v Nome do Servidor - Configura o nome do servidor Cognos TM1 para usar

com o Cognos TM1 Applications. Por exemplo: amostra de planejamento.Clique no botão Atualizar para atualizar a lista Nome do Servidor com osservidores disponíveis para o Admin Host inserido.

5. Após inserir as informações do servidor, clique em OK.O Host Administrativo e o nome do servidor Cognos TM1 inseridos sãoincluídos na seção Nomes do Servidor.

6. Para incluir mais servidores, clique em Incluir e repita as etapas.7. Quando tiver concluído a inclusão de servidores TM1, clique em OK na página

Configuração do IBM Cognos TM1 Applications.

Resultados

Os servidores Cognos TM1 incluídos agora podem ser usados para projetar seusaplicativos de planejamento.

Fonte para Exportação do Cognos TM1 Applications para PDFA fonte a ser usada para a exportação de PDF no IBM Cognos TM1 Applicationspode ser especificada usando o parâmetro SyncfusionPDFExportFont web.config.

Se esse parâmetro não for especificado, o sistema detectará o código do idioma emque o usuário está e selecionará a fonte apropriada. Se o código do idioma não forchinês ou japonês, a fonte usada será Arial. Use esta configuração para substituir oidioma usado ao exportar no Cognos TM1 Applications.

Configurando a Segurança da Função do Cognos TM1TurboIntegrator no Insight

Quando você abre uma área de trabalho do IBM Cognos Insight que foicompartilhada por meio do IBM Cognos Connection, talvez você queira restringir aexecução de algumas funções do TurboIntegrator, principalmente aquelas quepodem destruir ou modificar arquivos de dados.

Existem diversas funções do TurboIntegrator que podem gravar arquivos, excluirarquivos e executar comandos. Quando você recebe uma área de trabalho


compartilhada do Insight, é possível que os processos do TurboIntegrator dentroda área de trabalho incluam funções que executem ações indesejadas. Para evitarque processos executem ações potencialmente prejudiciais, a instalação do Insightinclui um arquivo de configuração chamado TMIFunctions.cfg, que pode ser usadopara evitar ou restringir a execução de funções do TurboIntegrator.

Qualquer função do TurboIntegrator pode ser totalmente impedida de serexecutada. As funções ASCIIOutput, TextOutput e ASCIIDelete também podem serconfiguradas para execução no modo restrito. Quando uma função é executada nomodo restrito, ela é limitada a agir sobre arquivos dentro do diretório de dados edos subdiretórios do TM1 Server.

Quando você instala o IBM Cognos Insight, uma versão padrão doTM1Functions.cfg é criada em C:\Documents and Settings\<user>\ApplicationData\IBM\Cognos Insight\bins\bin_xxxx. <user> é o nome de usuário sob o qualvocê instalou o Insight e xxxx é a versão de sua instalação.

A versão padrão do TM1Functions.cfg aparece da seguinte forma:ExecuteCommand=0AsciiOutput=1TextOutput=1AsciiDelete=1

Quando uma função é configurada como 0 no TM1Functions.cfg, ela é impedidade ser executada. Qualquer tentativa de executar essa função fará oTurboIntegrator emitir uma exceção de segurança.

Quando uma função é configurada como 1 no TM1Functions.cfg, ela é executadano modo restrito. Apenas as funções ASCIIOutput, TextOutput e ASCIIDeletepodem ser configuradas para execução no modo restrito.

Quando uma função não está presente no TM1Functions.cfg, ela é executadacompletamente irrestrita.

Exemplos de Funções em Execução no Modo Restrito

Quando uma função é configurada para execução no modo restrito, qualquercaminho relativo passado como um argumento para a função é assumido comoenraizado no diretório de dados do TM1 Server e permitido. Qualquer caminhoabsoluto para um diretório acima do diretório de dados do TM1 Server impedeque a função seja executada e faz com que uma exceção de segurança seja emitidano tempo de execução.

Por exemplo, assuma AsciiDelete=1 no TM1Functions.cfg. Nesse caso, a função

ASCIIDelete('logs\sample.log’);

é permitida e exclui o arquivo sample.log do subdiretório de logs do diretório dedados do TM1 Server.

Porém, a função

ASCIIDelete('c:\autoexec.bat’);


não será executada e causará uma exceção de segurança, já que especifica umarquivo no nível raiz da unidade, que está acima do diretório de dados do TM1Server.

Da mesma forma, assuma TextOutput=1 no TM1Functions.cfg. Nesse caso, a função

TextOutput('logs\sample.txt’, 'this is sample text’);

é permitida e grava uma sequência no arquivo sample.txt no subdiretório de logsdo diretório de dados do TM1 Server.

Ao contrário, a função

TextOutput('c:\autoexec.bat’, 'del *.* -r –f’);

não é permitida devido ao caminho ser especificado no nível raiz da unidade. Essafunção fará com que uma exceção de segurança seja emitida no tempo deexecução.

Editando o Arquivo TM1Functions.cfgO arquivo TM1Functions.cfg permite evitar ou restringir a execução de funçõespotencialmente nocivas do TurboIntegrator contidas em uma área de trabalhocompartilhada do IBM Cognos Insight.

Sobre Esta Tarefa

Quando você instala o IBM Cognos Insight, uma versão padrão doTM1Functions.cfg é criada em C:\Documents and Settings\<user>\ApplicationData\IBM\Cognos Insight\bins\bin_xxxx. <user> é o nome de usuário sob o qualvocê instalou o Insight e xxxx é a versão de sua instalação. É possível modificaresse arquivo de configuração para restringir ainda mais a execução da função oupermitir a execução da função.

Procedimento1. Abra o TM1Functions.cfg em um editor de texto.2. Para impedir completamente a execução de uma função, configure o nome da

função igual a 0. Por exemplo, ExecuteCommand=0 ou ServerShutdown=0.3. Para permitir que uma função seja executada no modo restrito, configure o

nome da função igual a 1. Por exemplo, AsciiDelete=1. Apenas as funçõesASCIIOutput, TextOutput e ASCIIDelete podem ser configuradas para execuçãono modo restrito.

4. Para permitir que uma função seja executada sem impedimento, exclua o nomeda função do TM1Functions.cfg.

5. Salve e feche o TM1Functions.cfg.


Capítulo 18. Configuração de Segurança

Após instalar o IBM Cognos TM1, é possível configurar os modos de autenticaçãoe segurança específicos que você deseja usar.

Segurança da Autenticação

A configuração de segurança de autenticação ou de login inclui a seleção do tipode segurança de login que controlará o acesso de usuário aos diferentescomponentes do Cognos TM1.

Segurança de Transmissão de Dados

A configuração de segurança inclui opcionalmente a configuração do Cognos TM1para usar SSL para transmissão de dados protegidos.

Segurança Adicional

Um outro nível de segurança do Cognos TM1 é a segurança de objeto. Este tipo desegurança permite controlar o acesso a objetos do TM1 específicos em seu modelode dados, mas ele não é configurado durante o processo inicial de instalação econfiguração.

Para obter mais informações sobre os procedimentos requeridos para configurar asegurança para objetos do Cognos TM1, consulte o IBM Cognos TM1 DeveloperGuide.

Segurança da AutenticaçãoA configuração de segurança de autenticação ou login inclui a seleção do tipo desegurança de login que controlará o acesso de usuário aos diferentes componentesdo IBM Cognos TM1.

Visão Geral da AutenticaçãoÉ possível configurar o IBM Cognos TM1 Server para usar um modo deautenticação específico para controlar o acesso de login de usuário.

Por padrão, ao instalar o Cognos TM1 Server, ele é configurado para usar aautenticação padrão do Cognos TM1 .

Após instalar o Cognos TM1 Server, é possível alterar o método de autenticaçãoalterando os parâmetros nos arquivos de configuração do TM1 .

Tabela 24. Métodos de Autenticação do Cognos TM1 Server

Métodos de Autenticação Descrição

Autenticação do TM1 O Cognos TM1 Server solicita um nome de usuário e senha evalida as informações de login com relação às informações delogin do cubo de segurança.

Login Integrado O Microsoft Windows executa a autenticação do Cognos TM1.


Tabela 24. Métodos de Autenticação do Cognos TM1 Server (continuação)

Métodos de Autenticação Descrição

Autenticação LDAP O Cognos TM1 Server solicita um nome de usuário e senha evalida as informações de login com relação a um servidorLDAP externo.

Segurança do IBM Cognos O servidor Cognos TM1 autentica usuários usando segurançado IBM Cognos.

Visão Geral de Autenticação do Cognos TM1 PadrãoCom a autenticação do IBM Cognos TM1 , o Cognos TM1 Server verifica o nomede usuário e a senha com relação aos nomes de usuários e senhas no banco dedados Cognos TM1 .

Visão Geral do Login IntegradoCom o Login Integrado, o IBM Cognos TM1 usa a autenticação de rede doMicrosoft Windows para acessar seus dados do Cognos TM1 . Após efetuar loginem sua estação de trabalho do Microsoft Windows, é possível acessar o CognosTM1 sem inserir um nome de usuário e uma senha novamente.

O Login Integrado é suportado somente no Microsoft Windows. Não é possívelusar o Login Integrado para acessar um servidor UNIX Cognos TM1 .

Figura 5. Processo de Autenticação com o IBM Cognos TM1 Server


Visão Geral da Autenticação LDAPCom a autenticação LDAP, um serviço de segurança LDAP que é externo ao IBMCognos TM1 autentica um login (a partir do Cognos TM1 versão 8.2.2). É possívelincluir, modificar e excluir informações de segurança do usuário de um local - oservidor LDAP ou Microsoft Windows Active Directory.

Segurança do CognosO servidor IBM Cognos TM1 pode autenticar usuários usando a segurança do IBMCognos.

Figura 6. Processo de Autenticação Usando Login Integrado

Figura 7. Processo de Autenticação Usando LDAP

Capítulo 18. Configuração de Segurança 173

A segurança do Cognos é um componente da estrutura IBM Cognos que gerencia oacesso de usuário aos dados. A segurança do Cognos gerencia a autorização e aautenticação por meio de provedores de segurança de terceiros, tal como LDAP ouActive Directory. Quando um usuário é autenticado por meio da segurança doCognos, ele recebe um "passaporte" de segurança do Cognos. Este passaporte é,então, usado pelos aplicativos Cognos TM1 para determinar as permissões dousuário (função e associação ao grupo) e a identidade.

Considerações de Segurança para Cognos TM1 ApplicationsÉ possível usar a autenticação de segurança padrão do IBM Cognos TM1 ou asegurança doIBM Cognos para os Cognos TM1 Servers usados com Cognos TM1Applications.

Não use uma combinação de diferentes modos de autenticação de segurança paraa mesma instalação do Cognos TM1 Applications.

Determine o modo de segurança antes de configurar o Cognos TM1 Applicationspara usar um servidor Cognos TM1 e use esse mesmo modo de segurança comquaisquer servidores adicionais incluídos.

Para obter detalhes sobre o uso de segurança do Cognos, consulte “Usando oCognos TM1 Applications com a Segurança do Cognos Business Intelligence” napágina 162.

Usando o Parâmetro IntegratedSecurityMode com Cognos TM1Applications

Para configurar o modo de autenticação de segurança do Cognos TM1, use oparâmetro IntegratedSecurityMode no arquivo Tm1s.cfg de cada servidor CognosTM1 que deseja usar.

Importante: O componente Cognos TM1 Applications é compatível somente comos modos de autenticação de segurança do Cognos TM1 1 e 5.

Por exemplo, para usar a autenticação de segurança padrão do Cognos TM1,configure o parâmetro IntegratedSecurityMode como 1 para cada servidor.


Para usar segurança do IBM Cognos, configure o parâmetroIntegratedSecurityMode como 5.


Para obter mais detalhes sobre o parâmetro IntegratedSecurityMode, consulte aseção "Configuração do Sistema TM1" no Guia de Operações do IBM Cognos TM1.

Configurando a Segurança de Cognos TM1 Applications para diversosCognos TM1 Servers

Se quiser usar diversos servidores Cognos TM1 com Cognos TM1 Applications,todos eles deverão ser configurados para usar a mesma autenticação de segurança(autenticação padrão Cognos TM1 ou segurança do Cognos) e incluir o mesmonome de usuário administrador e senha.


Para obter detalhes adicionais, consulte “Configurando o Cognos TM1 Applicationspara Usar Diversos Cognos TM1 Servers” na página 167.

utilitário ETLDAPO utilitário ETLDAP permite mover informações de seu diretório LDAP(Lightweight Directory Access Protocol) para o IBM Cognos TM1 .

É possível usar ETLDAP para incluir usuários LDAP no Cognos TM1 ao usar oCognos TM1 com Login Integrado e Autenticação LDAP.

Nota: É possível usar somente o utilitário ETLDAP para incluir novos usuáriosLDAP no Cognos TM1 . O ETLDAP não modifica, atualiza ou exclui usuáriosexistentes no Cognos TM1 .

O ETLDAP, uma ferramenta de carregamento LDAP, fornece a seguintefuncionalidade:v Extrai informações sobre o usuário de um servidor LDAP ou Active Directory.v Cria um elemento UniqueID na dimensão }ClientProperties.v Inclui usuários no cubo }ClientProperties.v Preenche o campo UniqueID no cubo }ClientProperties com o nome de usuário

qualificado por domínio do usuário incluído no banco de dados IBM CognosTM1 . Por exemplo, o ETLDAP grava o nome [email protected] no cubo}ClientProperties.

Como o administrador do Cognos TM1 , é possível executar estas tarefas usandoETLDAP:v Incluir muitos nomes de usuário a partir de um servidor LDAP no banco de

dados Cognos TM1 rapidamente.v Migrar informações de um banco de dados LDAP legado para o Cognos TM1 .v Executar uma ou mais consultas para especificar os usuários que deseja criar no

Cognos TM1 e, em seguida, exportar os usuários para os cubos de segurança doCognos TM1 .

v Atualizar o Cognos TM1 com novos usuários que foram incluídos no servidorLDAP desde o carregamento inicial de dados do usuário no Cognos TM1 .

Nota: O utilitário ETLDAP não está disponível quando o Cognos TM1 server éconfigurado para usar a autenticação do IBM Cognos Access Manager (CAM).

Modificando Atributos LDAPO valor de um atributo que você recupera de um diretório LDAP pode nãocorresponder precisamente ao que você deseja inserir no cubo de segurança doIBM Cognos TM1 .

Neste caso, você deve modificar alguns atributos LDAP antes de executar oETLDAP.

Por exemplo, é possível combinar todos os usuários dos grupos LDAP R&D,Controle de Qualidade e Documentação em um único grupo Cognos TM1denominado Engenharia. Para suportar estes requisitos, é possível estender umaclasse Java com um único método que precisa ser substituído.

A classe stringFilter contém um método com a seguinte assinatura:String filterString(String attrName, String value)


No tempo de execução, é transmitido a este método o nome de cada atributoLDAP que corresponde a uma entrada de mapeamento e seu valor. A Sequênciaque ele retorna é incluída no banco de dados Cognos TM1 .

O código a seguir demonstra a implementação da classe stringFilter,combinando todos os usuários dos grupos LDAP R&D, Garantia de Qualidade eDocumentação em um único grupo Cognos TM1 denominado Engenharia.

A classe stringFilter procura instâncias do atributo LDAP 'ou', que é o campo denomes do Grupo do Cognos TM1 . Se o valor for 'P&D', 'Garantia de Qualidade'ou 'Documentação', será retornado 'Engenharia'. Os usuários de qualquer um dos 3grupos LDAP são incluídos em um único grupo 'Engenharia' do Cognos TM1 .Qualquer outro valor de grupo permanece inalterado.// The stringFilter class provides the abilityto transformstrings

// which are read from the LDAP database before theyare inserted into // TM1’s datastore.

// To implement this feature, create a class which extendsstringFilter

// and contains a method ’filterString’ with the followingsignature:

//

// String filterString(String attrName, String value)

//

//

public class myStringFilter extends stringFilter

{

public String filterString(String attrName, String value)

{

if (attrName.equals("ou"))

{

if ( (attrName.equals("R&D")) ||

(attrName.equals("Quality Assurance")) ||

(attrName.equals("Documentation")) )

return "Engineering";

else

return value;

}

else

return value;

}

}

Após você gravar e compilar o código Java, coloque a classe em algum lugar nocaminho de classe. Em seguida, clique em Editar > Opções e insira seu nome nocampo Nome de Classe.

Executando ETLDAPÉ possível executar ETLDAP a partir do sistema operacional Microsoft Windowsou da janela de comando DOS com parâmetros da linha de comandos.


Procedimento1. Se desejar executar ETLDAP a partir do sistema operacional Microsoft

Windows, conclua as ações a seguir:v Clique em Iniciar > Programas > IBM Cognos > TM1 > Administração >

ETLDAP.v Configure os elementos requeridos.

Tabela 25. Elementos na Caixa de Diálogo Ferramenta de Carregamento LDAP.

Campo ou Botão Descrição

Procurar DNExibe o nó LDAP no qual a procura foi originada. O ETLDAPnão procura entradas acima deste nível na árvore.

FiltroExibe a sequência de consultas que filtra as entradas nodiretório e gera os registros correspondentes.

AtributosExibe os valores de atributo para entradas LDAP que ajudamna validação dos registros retornados pela procura. Quandoas informações de LDAP são exportadas para o TM1 , oETLDAP recupera os atributos necessários para criar usuáriosTM1 válidos.

Nota: Os atributos servem apenas para propósitos deexibição.

Escopo da ProcuraEspecifica o ponto de início da procura e o nível de procura.Selecione Um Nível para especificar todas as entradas umnível abaixo do DN de Procura base, mas não o próprio DNbase. Selecione Nível de Subárvore para procurar todas asentradas abaixo do DN base, incluindo o DN base.

Tabela de ResultadosExibe os resultados da procura. Clique nos cabeçalhos dacoluna para classificar os dados, ou clique com o botão direitodo mouse em uma linha e clique em Visualizar Entrada paraexaminar todos os atributos para essa entrada.

Botão de ProcuraExecuta a procura usando os parâmetros selecionados.

Botão de ExportaçãoExporta o conjunto de usuários exibido para o TM1 com basenas configurações da caixa de diálogo Opções.

2. Se desejar executar o ETLDAP a partir da janela de comando DOS, conclua asações a seguir:v Clique em Iniciar > Programas > Acessórios >Prompt de Comandos.v Insira a seguinte linha de comandos:

java etldap options

v Inclua os parâmetros requeridos.


Tabela 26. Parâmetros da Linha de Comandos Suportados


-f nome do arquivo Transmite o nome de um arquivo de sessão salva paracarregar todas as definições de configuração de uma sessãoanterior.

Ao executar o ETLDAP em modo não assistido (em lote),você deve incluir um nome para o arquivo de salvamento desessão. Se este arquivo não contiver as senhas necessáriaspara se conectar ao LDAP e as servidor Cognos TM1 , umamensagem de erro será gravada no arquivo de log e a sessãoserá finalizada.

-batch Executa o ETLDAP em modo de linha de comandos seminterface com o usuário. Requer a opção -f.

-secure Ao executar o ETLDAP em modo em lote, a transmissãodeste sinalizador remove todas as senhas do arquivo desessão referido pelo sinalizador -f após elas terem sido lidas.

Este parâmetro lê o arquivo de salvamento no início da sessãoe, em seguida, regrava o arquivo com as senhas removidas.Enquanto estiver em uso, você executa o ETLDAP e especificaas senhas com a interface com o usuário. Em seguida, saia doETLDAP e execute a versão de linha de comandos,especificando a opção '-secure'. Isto assegura que as senhasficaram disponíveis apenas durante o curto período de tempogasto para a inicialização do utilitário.

-help Exibe a Ajuda on-line para estes parâmetros da linha decomandos.

Configurando Parâmetros de Login do LDAPÉ possível configurar os parâmetros de login de LDAP.

Procedimento1. Na caixa de diálogo Ferramenta de Carregamento de LDAP, clique em Arquivo

> Conectar.2. Insira as seguintes informações do host e do usuário.

Painel Campo Descrição

Informações do Host HostInsira o nome do host ouendereço IP da máquina naqual o servidor LDAP estáem execução.



PortaA porta na qual o servidorLDAP está em execução. Seuma porta não forespecificada, a 636 seráusada. O Cognos TM1 tentaligar um servidor LDAP naporta segura especificada. Sevocê não inserir um valorLDAPPort, o Cognos TM1usará o valor padrão daporta 636

VersãoMuito provavelmente, oETLDAP ignorará o númeroda versão. A maioria dosservidores LDAP suportamconexões de tipos versão 2ou versão 3; o ETLDAP usaqualquer funcionalidadeespecífica de qualquer umadas versões.

Opção SSLDetermina se a comunicaçãoentre o servidor LDAP e oETLDAP ocorre em um canalcriptografado seguro. Amenos que você estejavisualizando informaçõesseguras em uma rede nãosegura, deixe esta opçãodesativada.

Opção AnômimaA maioria dos servidoresLDAP possuem algumacamada de configuração desegurança que requer quevocê seja autenticado comoum usuário conhecido. Emalguns sistemas, os usuáriosanônimos podem navegar nodiretório, mas não recuperaro esquema. Em outrossistemas, um usuárioanônimo pode ter acesso aalgumas áreas não segurasdo diretório, mas não aoutras.



Informações do Usuário DSN do UsuárioEm muitos casos, seudiretório LDAP impede queusuários Anônimos acessemou modifiquem dados. Nestecaso, podem ser necessáriosum Nome Distinto (DN) esenha para concluir aextração de informações desegurança LDAP.

Por exemplo, o nome NormLodin pode referir-se a umapessoa que trabalha naBlodget, Inc. No LDAP, elepossui um Nome Distintoque distingue-oexclusivamente das demaisentidades na rede.

Norm pode inserir asseguintes informações nocampo Informações sobre oUsuário.

uid=nlodin, ou=People,o=Blodget.com

SenhaInsira uma senha quecorresponda ao DN doUsuário.

3. Para ver se a conexão foi bem-sucedida, clique em Testar.4. Clique em OK.

Você estabeleceu uma conexão com seu servidor LDAP com os parâmetrosespecificados.

Construindo uma Consulta LDAPUse uma consulta LDAP para incluir usuários e grupos LDAP no IBM CognosTM1.

Antes de Iniciar

Uma consulta LDAP consiste nos seguintes elementos principais:v DN de Procura - Um diretório LDAP é organizado como uma estrutura em

árvore, com um nó-raiz e várias ramificações fora desta raiz. O DN de Procuraespecifica em qual nó a procura foi originada. As entradas acima deste nível naárvore são procuradas. Você deve especificar o DN base correto para obter osresultados desejados.

v Filtro - Uma sequência de consultas que filtra as entradas no diretório LDAP egera os registros correspondentes. É possível criar filtros complexos usando umacombinação dos seguintes símbolos:& (E)| (OU)! (NÃO)


* caractere curinga( ) parênteses para aninhamentoPara obter instruções sobre como construir sequências de filtros LDAP, consulteo manuais e recursos on-line do LDAP, incluindo o padrão LDAP, RFC 2254, TheString Representation of LDAP Search Filters.

v Escopo - Enquanto o DN de Procura especifica o ponto de início da procura, oatributo Escopo indica o nível de espessura no qual a procura ocorre. Existemdois níveis de Escopo:Um Nível - Especifica que o LDAP procura todas as entradas um nível abaixodo DN base, mas não inclui o próprio DN base.Nível de Subárvore - Indica que o LDAP procura todos os registros em todos osníveis, incluindo o DN base.O diagrama a seguir ilustra o efeito da configuração de Escopo em uma procura.

v Atributos - Descreve cada entrada LDAP e seus valores. Inclui uma listaseparada por vírgula de valores a serem retornados para os registros quecorrespondem à sequência de filtros. Existem dois atributos LDAP:Atributo do Usuário - Inclua este atributo no diretório LDAP. Por exemplo, cnou mail.Atributo Operacional - O servidor LDAP cria e mantém este atributo. Porexemplo, numSubordinates.Os atributos para uma entrada podem incluir:Presente sem valorPresente com um ou mais valoresNão presente. Se um atributo for opcional, ele poderá não existir para umaentrada.

Nota: Certifique-se de solicitar apenas os atributos necessários. Se você solicitartodos os atributos, um conjunto de resultados grande poderá aumentarsignificativamente o tempo de processamento no servidor LDAP e os requisitosde memória no servidor e no cliente.

Figura 8. Efeito da Configuração de Escopo em uma Procura


Procedimento1. Especifique o DN de Procura, Sequência de Filtros, Atributos e Escopo para sua

consulta.2. Clique em Procurar.

Você vê uma lista de entradas na tabela, a menos que haja erros de sintaxe se acadeia de filtros não corresponder a nenhum registro no diretório.

3. Examine o conjunto de resultados.v Ele inclui nomes que você não deseja ver?v As entradas importantes estão ausentes?v Você precisa construir várias consultas para capturar a lista de registros de

seu interesse?4. Faça mudanças na sequência de filtros.5. Clique em Procurar.6. Examine o conjunto de resultados.7. Repita as etapas 3 a 6 até ter uma lista de registros importantes.8. Clique em Arquivo, Salvar como para salvar sua consulta LDAP como um

arquivo de texto.

Nota: É possível usar a consulta LDAP salva em um momento posterior. Parafazer isso, clique em Arquivo > Abrir na caixa de diálogo Ferramenta deCarregamento LDAP. O ETLDAP preenche o DN, Sequência de Filtros,Atributos e Escopo para sua consulta LDAP.

Conectando-se ao Cognos TM1 ServerSiga estas etapas para se conectar ao servidor IBM Cognos TM1 .

Procedimento1. Clique em Editar > Login > TM1.2. Insira as seguintes informações do servidor:

Campo Descrição

HostO nome da máquina do servidor na qual o ServidorAdministrativo do TM1 está em execução.

porta SSLInsira o número da porta configurada que será usada peloservidor administrativo. O padrão é 5498

ServidorO nome do servidor TM1 ao qual você deseja se conectar.

Clique em Servidor e, em seguida, no botão Navegar paraselecionar um servidor da lista de Servidores.

Nome de UsuárioO nome de um usuário com privilégios de Administrador noservidor TM1 de destino.

SenhaA senha do usuário administrador.

3. Para ver se a conexão foi bem-sucedida, clique em Testar.4. Clique em OK.


Mapeando Atributos LDAP para Campos Cognos TM1Os diretórios LDAP contêm muitos atributos, alguns dos quais você padroniza, eoutros que você inclui ou customiza para seu ambiente. Você deve especificar orelacionamento entre os atributos LDAP e os campos IBM Cognos TM1 necessáriosmanualmente.

Antes de Iniciar

Você deve estar familiarizado com o esquema LDAP.

Procedimento1. Clique em Editar > Mapeamento > TM1.2. Para cada campo do Cognos TM1 necessário (vermelho), selecione um atributo

de esquema LDAP.Para cada usuário, o Cognos TM1 requer um nome exclusivo e um nome dogrupo. Por exemplo, você poderá mapear o atributo de nome em seu esquemaLDAP para o usuário Cognos TM1 e mapear o atributo de departamento para ogrupo do Cognos TM1 .

3. Clique em OK.

Especificando as Opções de Exportação do ETLDAPÉ possível especificar as opções de exportação do ETLDAP.

Procedimento1. Clique em Editar > Opções.2. Selecione Ativar Login Integrado.3. Insira um nome da região que contenha os usuários que você deseja transferir.4. Limpe Salvar Senhas.

Quando você limpar Salvar Senhas, o ETLDAP removerá todas as senhasnecessárias para conectar-se aos servidores antes da gravação do arquivo desalvamento de sessão. Na próxima vez em que você executar o ETLDAP,precisará inserir as senhas novamente.

5. Defina Máximo de Resultados da Procura e Limite de Tempo de Procuracomo 0.

6. Clique em OK.

Exportando Informações de LDAP para o Cognos TM1É possível exportar informações de LDAP para o IBM Cognos TM1 .

Procedimento1. Clique em Exportar.

O ETLDAP move os recursos recuperados do diretório LDAP para o TM1 eregistra a atividade de exportação de dados em um arquivo de log.

Nota: É possível abrir o log antes de exportar registros para controlar oprogresso da exportação.

2. Clique em Visualizar, Log para abrir o Log de Sessão.O Log de Sessão mostra um resumo dos usuários LDAP que ETLDAP exportoue criou no Cognos TM1 . O ETLDAP gera aleatoriamente as senhas de usuáriodo Cognos TM1 e as inclui no banco de dados do Cognos TM1 .


Nota: Se você usar Login Integrado, os usuários do Cognos TM1 não usarão assenhas do Cognos TM1 e você não precisará coordenar senhas entre o CognosTM1 e o Microsoft Windows. Se você não usar Login Integrado, os usuários doCognos TM1 deverão alterar suas senhas durante a primeira sessão de login.Para obter detalhes, consulte “Login Integrado” na página 185.

Executando ETLDAP no Modo de Atualização para Incluir NovosUsuários LDAPÉ possível executar ETLDAP no modo de Atualização para atualizar o IBM CognosTM1 com novos usuários LDAP que ainda não existem no Cognos TM1 . Para isso,especifique uma data na seção Filtro da consulta LDAP.

Sobre Esta Tarefa

Ao executar o ETLDAP pela primeira vez, é necessário recuperar todos os registrosdo servidor LDAP que atendem aos requisitos organizacionais. Defina estesrequisitos usando o parâmetro de Filtro. Após recuperar todos os registros deusuário e grupo, carregue-os no banco de dados IBM Cognos TM1 .

Após usar ETLDAP para carregar inicialmente usuários LDAP no Cognos TM1 , épossível usar somente a ferramenta para recuperar e incluir novos usuários LDAPque ainda não existem no Cognos TM1 . Não é possível usar o utilitário ETLDAPpara atualizar ou excluir usuários existentes no Cognos TM1 com base emmudanças no diretório LDAP.

Conforme novos usuários são incluídos em seu servidor LDAP, é possível incluí-losno Cognos TM1 especificando uma data na seção Filtro de sua consulta LDAP. Ouso de uma data na seção Filtro executa o ETLDAP no modo de Atualização. Épossível editar o Filtro LDAP para selecionar apenas novos registros do usuárioque atendem seus requisitos de procura originais, desde a última vez que oETLDAP foi executado.

Nota: Executar ETLDAP no modo de Atualização inclui somente novos usuáriosLDAP que ainda não existem no Cognos TM1 . ETLDAP não atualiza atributos dousuário nem exclui usuários do Cognos TM1 existentes.

Procedimento1. Determine o último atributo de registro modificado para especificar uma data

na seção Filtro de sua consulta LDAP.Todos os servidores LDAP suportam um último atributo de registromodificado, que inclui estes atributos de registro de data e hora:v LDAP Padrão - modifytimestampv Microsoft Active Directory - whenChangedDurante uma sessão de exportação, o ETLDAP examina todos os registrosconforme processa-os e armazena a data do registro alterado mais recentementeno arquivo de Log de Sessão, conforme mostrado na amostra a seguir:newest record modified: Thu Jan 23 07:00:42 EST 2003(20030123070042.0Z)

2. Localize a linha de registro mais recente no Log de Sessão LDAP.3. Copie a parte do registro de data e hora da sequência entre parênteses do Log

de Sessão LDAP para a seção Filtro de sua consulta LDAP.Importante: Certifique-se de estar de acordo com a sintaxe suportada porFiltros LDAP. Para obter informações adicionais, consulte o documento doprotocolo de padrões da Internet, RFC 2254, The String Representation of LDAPSearch Filters.


A tabela a seguir mostra uma sequência de Filtros de amostra, sem mudanças eapós a modificação, para servidores LDAP e Active Directory.v Um servidor LDAP padrão usa o atributo modifytimestamp.v Um servidor LDAP com o Microsoft Active Directory usa o atributo

whenChanged.

Sequência de Filtros de Amostra Sequência de Filtros após a Modificação

Sequência inicial(&(objectclass=person)(|(department=R&D)

(department=Documentation)))

Modificado para o LDAP padrão(&(objectclass=person)(modifytimestamp>

=20030515162433Z)(|(department=R&D*)

(department=QA)))

Modificado para o Active Directory(&(objectclass=person)(whenChanged>

=20030515162433.0Z)(|(department=R&D*)

(department=QA)))

4. Depois de fazer as mudanças necessárias na linha Filtro, salve os dados dasessão com um nome que identifique-os claramente como uma consulta deatualização incremental.

5. Execute ETLDAP usando os novos dados da sessão.

Login IntegradoO Login Integrado permite usar a autenticação de rede do Microsoft Windows paracontrolar o acesso aos dados do IBM Cognos TM1 .

Nesse modelo de segurança, é possível usar o utilitário ETLDAP (consulteExecutando ETLDAP) ou outras etapas para mover informações de login doMicrosoft Windows do usuário e do grupo para o banco de dados do Cognos TM1. Os usuários que desejam acessar os dados do Cognos TM1 por meio dos clientesCognos TM1 devem efetuar login no Microsoft Windows primeiro. Após elesefetuarem login com sucesso no Microsoft Windows, o Cognos TM1 não solicitainformações de login.

O Login Integrado corresponde ao nome qualificado por domínio que você usapara efetuar login no Microsoft Windows com um nome no campo UniqueID docubo }ClientProperties. Se houver uma correspondência, o Cognos TM1 permitiráque você efetue login.

Como exemplo, suponha que você efetue login com o nome de usuário Robert nodomínio company.com. Quando você dá um clique duplo em um servidor noServer Explorer, o Cognos TM1 consulta o cubo }ClientProperties e examina ocampo UniqueID desse cubo. Robert possui um nome qualificado de domínio derobert@company. Desde que Robert efetue login no domínio COMPANY com onome Robert, o Login Integrado deve funcionar para este usuário.

Se o Login Integrado não puder corresponder ao nome qualificado por domíniousado para efetuar login no Microsoft Windows com um nome no campoUniqueID do cubo }ClientProperties, o Cognos TM1 exibirá uma mensagem de errodizendo que o nome do cliente não existe no servidor.


O Login Integrado é suportado somente no Microsoft Windows. Não é possívelusar o Login Integrado para acessar uma versão do UNIX do servidor CognosTM1 .

Configurando o Cognos TM1 para Usar o Login IntegradoUse a lista de verificação a seguir como um guia geral para configurarcomponentes do IBM Cognos TM1 para usar o Login Integrado como o método deautenticação de login para todos os usuários.

Lista de Verificação

1. Conclua a instalação do servidor Cognos TM1 e certifique-se de que vocêconsiga executar e efetuar login nele.

2. Execute o Utilitário ETLDAP para extrair os dados de login do usuário e dogrupo a partir de seu diretório LDAP e carregar esses dados no cubo desegurança do TM1 . O ETLDAP cria usuários do Cognos TM1 a partir dosdados LDAP especificados. Estes usuários são membros do mesmo grupo aoqual eles foram designados em seu diretório LDAP.Para obter detalhes, consulte “Executando ETLDAP” na página 176.

3. Configure o servidor Cognos TM1 e os componentes do cliente para usar oLogin Integrado.

Tabela 27. Resumo da Configuração de Login Integrado para Componentes Cognos TM1

Componente Configuração Necessária

Cognos TM1 Server Configure os parâmetros de Login Integrado noarquivo Tm1s.cfg para qualquer banco de dadosTM1 que deseja usar com o Login Integrado.

Para obter detalhes, consulte “Configurando oLogin Integrado para o Servidor Cognos TM1 ” napágina 188

Cognos TM1 Clients Ative a opção Usar Login Integrado para CognosTM1 Architect e Cognos TM1 Perspectives .

Para obter detalhes, consulte “Configurando oCognos TM1 Perspectives para Usar LoginIntegrado” na página 192 e “Configurando oCognos TM1 Architect para Usar o LoginIntegrado” na página 192


Tabela 27. Resumo da Configuração de Login Integrado para Componentes CognosTM1 (continuação)

Componente Configuração Necessária

Cognos TM1 Web Defina as configurações a seguir para Cognos TM1Web:

v Arquivo Web.config: Configure parâmetros noarquivo Web.config que ativem o Login Integradopara Cognos TM1 Server Web.

v Segurança da Pasta: Configure a segurança dousuário para as pastas do Cognos TM1 ServerWeb no servidor da web.

v Microsoft IIS:Configure o Microsoft InternetInformation Services (IIS) para usar autenticaçãoIntegrada do Windows.

Nota: Você também poderá precisar verificar e/ouconfigurar manualmente as configurações desegurança do NTLM ou do Kerberos.

Para obter detalhes, consulte “Configurando oLogin Integrado para Cognos TM1 Web UsandoNTLM” na página 191

4. Configure os direitos de acesso para usuários do Cognos TM1.Para obter detalhes, consulte “Configurando Direitos de Acesso para Usuáriosdo Cognos TM1 ”.

Configurando Direitos de Acesso para Usuários do Cognos TM1Para um usuário do IBM Cognos TM1 acessar qualquer dado, pode ser necessáriodesignar esse usuário a outros grupos do Cognos TM1 . Este tópico explica comoincluir um usuário no grupo de administradores.

Por exemplo, para um usuário publicar objetos públicos na web por meio doCognos TM1 Web, o usuário deve ser um membro do grupo de administradoresdo Cognos TM1 .

Procedimento1. Inicie o Cognos TM1 Architect.2. Clique em Arquivo > Opções.3. Limpe a opção Usar Login Integrado.4. Clique em OK.5. Na área de janela em árvore do Server Explorer, clique duas vezes no TM1

para abrir a lista de servidores.6. Clique duas vezes no nome do servidor.7. Efetue login usando seu ID de login e senha de administrador.

v Nome do administrador (padrão) - adminv Senha do administrador (padrão) - apple

8. Clique com o botão direito do mouse no nome do servidor e clique emSegurança > Clientes e Grupos.

9. Selecione um usuário para incluir no grupo de administradores. Use a barrade rolagem para rolar para a esquerda, onde é exibida uma lista de grupos.

10. Para incluir o usuário no grupo de administradores, selecione a caixa deseleção na coluna ADMIN para esse usuário.


11. Clique em OK.

Configurando o Login Integrado para o Servidor Cognos TM1É possível modificar uma instalação do IBM Cognos TM1 para usar o LoginIntegrado sem reinstalar o Cognos TM1 . Para fazer isso, execute ETLDAP emodifique vários arquivos de configuração do Cognos TM1 .

Procedimento1. Execute o ETLDAP e importe as informações do usuário e do grupo de seu

servidor LDAP, conforme descrito em “Executando ETLDAP” na página 176.2. Encerre o servidor Cognos TM1 .3. Edite os parâmetros a seguir no arquivo Tm1s.cfg localizado em seu diretório

de dados do servidor Cognos TM1 :v Defina o parâmetro IntegratedSecurityMode como 2.v Defina o parâmetro SecurityPackageName para o protocolo de segurança

usado para Login Integrado, como Kerberos (padrão) ou NTLM.No exemplo a seguir, o servidor está configurado para usar Kerberos.[TM1S]

SecurityLogging=F

SecurityPackagename=Kerberos


Servername=myserver

DatabaseDirectory=C:\Program Files\

4. Salve e saia do Tm1s.cfg.5. Reinicie o servidor Cognos TM1 .6. Configure os diferentes clientes Cognos TM1 para usar o Login Integrado

configurando a opção Usar Login Integrado na interface com o usuárioassociada.v “Configurando o Cognos TM1 Architect para Usar o Login Integrado” na

página 192.v “Configurando o Cognos TM1 Perspectives para Usar Login Integrado” na

página 192.

Resultados

Agora é possível efetuar login em seu servidor Cognos TM1 usando LoginIntegrado por meio do Cognos TM1 Architect ou do Cognos TM1 Perspectives .

Para obter informações sobre como configurar o Login Integrado para Cognos TM1Web, consulte “Configurando o Login Integrado para Cognos TM1 Web UsandoNTLM” na página 191.

Configurando o Login Integrado para o Cognos TM1 WebUsando KerberosÉ possível configurar o IBM Cognos TM1 Web para usar Login Integrado com oprotocolo de segurança Kerberos.

Sobre Esta Tarefa

Se você usar o protocolo de segurança Kerberos, poderá configurar o servidor daWeb para usar uma conta do sistema ou uma conta do usuário do domínio, deacordo com sua preferência.


Em todos os casos, você deve verificar se o Cognos TM1 Web está configuradocorretamente para usar o Login Integrado. Para verificar isto, certifique-se de que aseção system.web do arquivo Web.config do Cognos TM1 Web inclua a linha aseguir para o parâmetro authentication.

<authentication mode="Windows" />

Procedimento1. Para determinar se seu servidor da web está em execução no Modo de

Isolamento do IIS 5.0, conclua as ações a seguir:a. Execute Gerenciamento do Computador.b. Clique com o botão direito do mouse em Web sites e escolha Propriedades.Se a caixa de seleção Executar o serviço da WWW no modo de isolamento doIIS 5.0 estiver selecionada, isto indica que você está executando o servidor daWeb no modo de isolamento do IIS 5.

2. Configure seu servidor da web para executar o protocolo de segurançaKerberos no servidor da web concluindo as ações a seguir:a. Abra um prompt de comandos.b. Migre para o diretório inetpub/AdminScripts.c. Execute o seguinte comando para definir o protocolo de segurança para

Kerberos:cscript adsutil.vbs set w3svc/1/NTAuthenticationProviders

"Negotiate,NTLM"

O parâmetro Negotiate,NTLM força o servidor da Web a tentar usar oKerberos primeiro. Se o Kerberos falhar, o servidor da Web usará NTLM.Tenha cuidado para não deixar um espaço em branco antes de NTLM.

3. Conceda os direitos de delegação da conta da máquina do servidor da webexecutando o painel de controle Usuários e Computadores do Active Directorya partir do controlador de domínio de rede e designando direitos de delegaçãoà conta de serviço do TM1 .Há uma forma segura de delegação chamada Delegação Restrita. Com aDelegação Restrita, é possível configurar o serviço do Microsoft ActiveDirectory para restringir os serviços e servidores que seu aplicativo ASP.NETpode acessar com a identidade personificada. A Delegação Restrita requerautenticação do Kerberos. É possível configurar o sistema para delegação.Consulte sua documentação do Microsoft Windows para obter informaçõesadicionais.

4. Para incluir a conta de serviço do Cognos TM1 no arquivo machine.config emseu servidor da web, conclua as ações a seguir:a. Edite machine.config no servidor da Web. O arquivo machine.config está

localizado no seguinte local:C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\CONFIG

b. Localize a seção Atributos processModel.password="AutoGenerate"

c. Altere os campos de nome de usuário e senha para o nome qualificado pordomínio e senha da conta de serviço do Cognos TM1 .

d. Salve o arquivo e saia do editor.e. Reinicie o serviço de administrador do IIS.

5. Para criar um novo conjunto de aplicativos para seu diretório virtual da webdo Cognos TM1 Web, conclua as ações a seguir:


a. Clique com o botão direito do mouse em Conjuntos de Aplicativos e cliqueem Novo, Conjunto de Aplicativos.

b. Insira TM1 Web para o ID do Conjunto de Aplicativos.c. Escolha Usar configurações padrão para o novo conjunto de aplicativos e

clique em OK.

Nota: Se você criar um conjunto de aplicativos para o Cognos TM1 Web e,em seguida, desinstalar, esse conjunto de aplicativos não será excluído. Se,posteriormente, você reinstalar e selecionar o login integrado durante ainstalação customizada, o diretório virtual do Cognos TM1 Web seráreconfigurado com o conjunto de aplicativos padrão, não com o CognosTM1 Web.

6. Para configurar o conjunto de aplicativos para usar a identidade de rede sob aqual você executa os serviços do Cognos TM1 , conclua as ações a seguir:a. Clique com o botão direito do mouse no conjunto de aplicativos do Cognos

TM1 Web e clique em Propriedades > Identidade.b. Clique em Configurável.c. Insira o mesmo usuário do domínio e a mesma senha que foram usados

pelos serviços do Cognos TM1 .d. Clique em OK.

7. O usuário do domínio do Cognos TM1 deve pertencer ao grupo IIS_WPG noservidor da web. Para incluir o usuário do domínio no grupo, conclua as açõesa seguir:a. Execute a ferramenta de administração de Gerenciamento de

Computadores.b. Navegue para a pasta Grupos em Ferramentas do Sistema > Usuários e

Grupos Locais > Grupos.c. Clique com o botão direito do mouse no grupo IIS_WPG e clique em

Incluir no Grupo.d. Clique em Incluir e inclua o nome qualificado de domínio no grupo

IIS_WPG. Use o mesmo nome usado por seus serviços do CognosTM1 .8. Para configurar o conjunto de aplicativos para seu diretório virtual do Cognos

TM1 Web, conclua as ações a seguir:a. Execute o Gerenciador do IIS.b. Clique com o botão direito do mouse no diretório virtual do TM1 Web e

escolha Propriedades.c. Defina a opção Conjunto de Aplicativos para TM1 Web.

9. Para configurar o nome do principal de serviço (SPN), conclua as ações aseguir:a. Faça download do utilitário SetSPN.exe a partir do Web site da Microsoft.b. Como um administrador de domínio, execute os seguintes comandos:

setspn -A HTTP/web_server_name domain_name\user_acct_for_TM1_services

setspn -A HTTP/webservername.domain_name domain_name\user_acct_for_TM1_services


Configurando o Login Integrado para Cognos TM1 Web UsandoNTLMConfigure manualmente o IBM Cognos TM1 Web para usar Login Integradoeditando os parâmetros de configuração no arquivo de configuração da web,configurando o Microsoft Internet Information Services (IIS) e configurando asegurança da pasta.

Procedimento1. Para editar os parâmetros de configuração, conclua as ações a seguir:

a. Abra o arquivo Web.config para o Cognos TM1 Web.Este arquivo geralmente está localizado em C:\ProgramFiles\IBM\cognos\tm1\TM1Web.

b. Localize a seção <appSettings> e edite o seguinte parâmetro da seguinteforma:<add key="IntegratedLogin" value="true" />

c. Localize as configurações de autenticação na seção <system.web> e edite osseguintes parâmetros, da seguinte forma:<authentication mode=" Windows "/>

<identity impersonate="true"/>

d. Salve e feche o arquivo Web.config.2. Para configurar o Microsoft Internet Information Services (IIS) para ele

funcionar com o Login Integrado, certifique-se de que o IIS esteja configuradopara usar a autenticação Integrada do Windows.Esta opção é ativada por padrão no IIS. Para obter informações adicionais,consulte a documentação do Microsoft IIS.

3. Verifique se o serviço do NTLM Windows está em execução. Certifique-se deque o serviço do Provedor de Suporte de Segurança do NTLM esteja disponívele em execução como um serviço do Windows.

4. Para configurar o parâmetro SecurityPackageName no arquivo TM1s.cfg,conclua estas ações:a. Encerre seu servidor Cognos TM1.b. Abra TM1s.cfg em um editor de texto.c. Insira o parâmetro do SecurityPackageName.d. Salve TM1s.cfg.e. Reinicie seu servidor Cognos TM1.

5. Para configurar a segurança para as pastas IIS, conclua as ações a seguir:a. No servidor da Web que executa o Cognos TM1 Web, use o Microsoft

Windows Explorer para localizar as pastas do IIS para Cognos TM1 Web.O local padrão é: C:\Arquivos de Programas\IBM\cognos\tm1\TM1Web.

b. Clique com o botão direito do mouse em cada uma das pastas a seguir,clique em Propriedades, clique na guia Segurança e assegure que o grupoUsuários Autenticados tenha permissão configurada como ControleIntegral.v TM1Web\css

v TM1Web\images

v TM1Web\scripts

v TM1Web\TempCharts

v TM1WebEx\ExcelSheet

v TM1WebEx\UserTempDir


c. Reinicie o IIS.

Configurando Navegadores da Web para Login IntegradoApós configurar o IBM Cognos TM1 Web com Login Integrado, você deve, então,configurar os navegadores da Web nos sistemas do cliente que acessarão o CognosTM1 Web.

Procedimento1. Se estiver usando o Microsoft Internet Explorer, especifique se a URL do

Cognos TM1 Web é um site confiável.Por exemplo, ative o logon Automático com o nome de usuário e a opção desenha atuais e a opção Ativar Autenticação Integrada do Windows no InternetExplorer.Para obter informações adicionais, consulte a documentação do MicrosoftInternet Explorer.

2. Se estiver usando o Mozilla Firefox, localize e edite as preferências a seguirpara que elas incluam uma lista separada por vírgula de prefixos de URL oudomínios para o local de seu servidor da web do TM1 .network.automatic-ntlm-auth.trusted-uris

network.negotiate-auth.delegation-uris

network.negotiate-auth.trusted-uris

Por exemplo, insira localhost se estiver executando o Cognos TM1 Weblocalmente ou insira o nome do servidor se estiver executando o Cognos TM1Web em um servidor da web dedicado.Para obter informações adicionais, consulte sua documentação do MozillaFirefox.

Configurando o Cognos TM1 Architect para Usar o LoginIntegradoApós configurar o Login Integrado para o servidor IBM Cognos TM1 , é possívelusá-lo para acessar seus dados do Cognos TM1 por meio do Cognos TM1 Architect.

Procedimento1. Execute o Cognos TM1 Architect.2. Clique em Arquivo > Opções.3. Verifique se a caixa de seleção Usar Login Integrado está selecionada.4. Clique em OK.5. Na área de janela em árvore do Server Explorer, clique duas vezes para abrir a

lista de servidores.6. Clique duas vezes no servidor para o qual você exportou informações do

usuário e do grupo LDAP.Você deve efetuar login sem ser solicitado para inserir um nome de usuário ouuma senha.

Configurando o Cognos TM1 Perspectives para Usar LoginIntegradoApós configurar o Login Integrado para o servidor IBM Cognos TM1 , serápossível usá-lo para acessar seus dados do Cognos TM1 por meio do Cognos TM1Perspectives . TM1 Architect


Procedimento1. Execute o Microsoft Excel.2. Clique em TM1 , Server Explorer.

O TM1 Server Explorer é exibido.3. Clique em Arquivo > Opções.4. Verifique se a caixa de seleção Usar Login Integrado está selecionada.5. Clique em OK.6. Na área de janela em árvore do Server Explorer, clique duas vezes para abrir a

lista de servidores.7. Clique duas vezes no servidor para o qual você exportou informações do

usuário e do grupo LDAP.O TM1 Perspectives deve efetuar login automaticamente no Cognos TM1 semsolicitar um nome de usuário ou uma senha.

Efetuando Login no Cognos TM1 Web com Login IntegradoApós configurar um servidor IBM Cognos TM1 e o Cognos TM1 Web para usarLogin Integrado, é possível usar este modo de autenticação para efetuar login eacessar seus dados por meio do Cognos TM1 Web.

Procedimento1. Execute o Microsoft Internet Explorer.2. Insira o seguinte Localizador Uniforme de Recursos na caixa Endereço do

navegador:http:// Nome do Servidor da Web / Nome do Diretório Virtual /TM1WebLogin.aspx

3. Insira o nome do host do Cognos TM1 Server Admin Server no campo HostAdministrativo.

4. Clique na seta Servidor.5. Clique em Efetuar Login.

Autenticação LDAPÉ possível configurar a autenticação IBM Cognos TM1 usando um servidor LDAP.

Validando Usuários com um Servidor LDAPA validação LDAP permite centralizar todas as senhas de usuário em um servidorLDAP externo.

Quando seus usuários IBM Cognos TM1 efetuam login, o nome de usuário e asenha fornecidos são validados com relação às informações mantidas em seuservidor LDAP. É possível especificar uma senha e chave a serem usadas antes daconexão do servidor para autenticação LDAP, ou o servidor pode conectar-sediretamente, sem o uso de uma senha.

Como um pré-requisito para configurar a autenticação LDAP, é necessário ter umconhecimento aprofundado de LDAP e de sua função na estrutura de segurança derede. Se você não for o administrador LDAP para sua rede, consulte seuadministrador LDAP para configurar corretamente o Cognos TM1 para usar aautenticação LDAP.

Nota: Seu servidor LDAP deve ser configurado para usar SSL para se comunicarcom sucesso com o Cognos TM1 .


Parâmetros de Autenticação LDAPUse os parâmetros a seguir no arquivo Tm1s.cfg para configurar e suportar aautenticação LDAP.

PasswordSource:

Compara a senha inserida pelo usuário com a senha armazenada.

Tipo de parâmetro: opcional, estático

Cognos TM1 (Padrão): Compara a senha inserida pelo usuário com a senha nobanco de dados Cognos TM1 .

LDAP: Compara a senha inserida pelo usuário com a senha armazenada noservidor LDAP.

LDAPPort:

O IBM Cognos TM1 tenta ligar-se a um servidor LDAP na porta seguraespecificada, porta 636.

Esta deve ser uma porta segura (SSL).

Se você não inserir um valor de LDAPPort, o Cognos TM1 usará o valor padrão,porta 636.

LDAPHost:

Usa o nome de domínio ou representação em sequência pontilhada do endereço IPdo host do servidor LDAP.

Se você não inserir um valor para LDAPHost, o IBM Cognos TM1 usará o valorpadrão, localhost.

LDAPWellKnownUserName:

O servidor IBM Cognos TM1 usa o nome de usuário conhecido para efetuar loginno LDAP e consultar o nome enviado pelo usuário.

Um nome distinto de LDAP.

Por exemplo:uid=bjensen,ou=people,o=company.com

Este é um parâmetro necessário quando o parâmetro LDAPUseServerAccount éconfigurado como False.

LDAPSearchBase:

Especifica o nó na árvore LDAP na qual o IBM Cognos TM1 inicia a procura porusuários válidos.

Um nome distinto (DN) de base no diretório LDAP. Por exemplo:ou=people,o=company.com

Por exemplo, se os nomes distintos estiverem no formato:


uid-bjensen, ou-people, o=company.com

a base de procura será:ou-people, o=company.com

Este é um campo necessário.

LDAPSearchField:

O nome do atributo LDAP que espera-se que contenha o nome do usuário do IBMCognos TM1 que está sendo validado.

Se não for inserido um valor LDAPSearchField, o valor-padrão será cn, quetambém é o valor padrão para o Microsoft Active Directory.

LDAPUseServerAccount:

Determina se é necessária uma senha para conectar-se ao servidor ao usar aautenticação LDAP.

Tipo de parâmetro: opcional, estáticov Para se conectar diretamente ao servidor LDAP usando a autenticação integrada,

configure este parâmetro como T. Configure este parâmetro como T sempre queo servidor IBM Cognos TM1 e o servidor LDAP existirem no mesmo domínio.

v Para usar uma senha antes de conectar-se, defina este parâmetro como F.Quando LDAPUseServerAccount for definido como F, também será necessáriodefinir “LDAPPasswordFile” e “LDAPPasswordKeyFile” para conectar-se comêxito ao servidor LDAP usando SSL.

LDAPPasswordFile:

Define o arquivo de senhas usado quando LDAPUseServerAccount não for usado.Este é o caminho completo do arquivo .dat que contém a senha criptografada paraa chave privada do IBM Cognos TM1 server Admin Server.

Tipo de parâmetro: opcional, a menos que “LDAPUseServerAccount”=F, estático

Esse parâmetro usa o caminho completo para um arquivo .dat.

LDAPPasswordKeyFile:

Define a chave de senha usada quando LDAPUseServerAccount não for usado.

Tipo de parâmetro: opcional, a menos que “LDAPUseServerAccount”=F, estático

Esse parâmetro usa o caminho completo do arquivo .dat que contém a chave usadapara criptografae e decriptografar a senha da chave privada.

Este arquivo deve ser gerado usando o utilitário tm1crypt, conforme descrito em“Executando o Utilitário TM1Crypt” na página 218.

Configurando a Validação de LDAPPara configurar a validação de LDAP, você alterará a senha no arquivo TM1s.cfgpara que possa, então, importar nomes de seu diretório LDAP e modificardesignações de grupo para novos usuários. Em seguida, altere a senha de voltapara as credenciais de LDAP.


Antes de Iniciar

Para configurar a validação LDAP, as seguintes informações são necessárias:v Um nome que o servidor Cognos TM1 pode usar para efetuar login no LDAP. É

possível testar a validade deste nome usando ETLDAP.v A porta SSL na qual o servidor LDAP está em execução. O padrão é 636.v O nome ou endereço IP do servidor LDAP que você deseja usar para validação.

Procedimento1. Para usar suas credenciais do Cognos TM1 para efetuar login,altere o

parâmetro de senha no TM1s.cfg concluindo estas ações:a. Edite TM1s.cfg no diretório de dados IBM Cognos TM1 server .b. Modifique PasswordSource=LDAP para ler PasswordSource=TM1

c. Salve e saia do TM1s.cfg.d. Recicle seu servidor Cognos TM1 .

2. Para importar nomes de seu diretório LDAP no Cognos TM1 , conclua estasações:a. Use o procedimento descrito em “utilitário ETLDAP” na página 175.b. Use as seguintes informações de login do Cognos TM1 :

v Usuário administrador (padrão) - Adminv Senha do administrador (padrão) - appleUse o usuário especificado durante a instalação para efetuar login no LDAP.

3. Para modificar designações de grupo para novos usuários, conclua as seguintesações:a. Efetue login no Cognos TM1 como um administrador.b. Clique com o botão direito do mouse no nome do servidor no Server

Explorer e clique em Segurança, Clientes e Grupos.c. Modifique as designações de grupos para seus novos usuários conforme

necessário.Para cada usuário do Cognos TM1 que ETLDAP incluiu em seu banco dedados, você deve designar esse usuário para o mesmo grupo ao qual elespertencem no diretório LDAP. Por exemplo, se NadiaC for um membro dogrupo gymnasts em seu diretório LDAP, ETLDAP criará o usuário Nadiac ecriará o grupo gymnasts dentro do Cognos TM1 . Nadiac é exibido na caixade diálogo Clientes/Grupos como membro de ginastas.

4. Para alterar a senha de volta para as credenciais de LDAP, conclua estas ações:a. Edite TM1s.cfg no diretório de dados IBM Cognos TM1 server .b. Modifique PasswordSource=TM1 para ler PasswordSource=LDAP

c. Defina o status da conexão:v Para conectar-se diretamente ao servidor, inclua a linha a seguir:

LDAPUseServerAccount=T

v Para usar uma senha antes de se conectar ao servidor, inclua as seguinteslinhas:LDAPPasswordFile= arquivo

LDAPPasswordKey= chave

d. Salve e saia do arquivo TM1s.cfg.e. Recicle seu servidor Cognos TM1 .


Agora você deve conseguir efetuar login no Cognos TM1 com um nomeque você incluiu a partir de seu diretório LDAP.

Usando a Segurança do Cognos com o Cognos TM1É possível usar a segurança do IBM Cognos com o IBM Cognos TM1 .

Para obter detalhes completos sobre os conceitos de segurança, a terminologia e aimplementação do Cognos, consulte o Guia de Administração e Segurança do Cognos.

Visão Geral da Segurança do CognosO servidor IBM Cognos TM1 pode autenticar usuários usando a segurança do IBMCognos.

A segurança do Cognos é um componente da estrutura IBM Cognos que gerencia oacesso de usuário aos dados. A segurança do Cognos gerencia a autorização e aautenticação por meio de provedores de segurança de terceiros, tal como LDAP ouActive Directory. Quando um usuário é autenticado por meio da segurança doCognos, ele recebe um "passaporte" de segurança do Cognos. Este passaporte é,então, usado pelos aplicativos Cognos TM1 para determinar as permissões dousuário (função e associação ao grupo) e a identidade.

Ao usar a segurança do Cognos, um passaporte do Cognos é necessário para seconectar ao Cognos TM1 . É apresentada uma tela de logon ao usuário requerendoum namespace, um nome de usuário e uma senha ao efetuar login pela primeiravez no Cognos TM1 ou em qualquer outro componente ativado para segurança doCognos. Uma vez autenticado por segurança do Cognos, um passaporte é emitidoao usuário. Este passaporte fornece automaticamente as credenciais do usuário aoacessar qualquer outro aplicativo ativado para segurança do Cognos (incluindo oCognos TM1 ). Quando um usuário se conecta ao servidor Cognos TM1 por meiode um servidor Cognos específico que foi configurado para logon comum,nenhuma entrada do usuário direta é necessária para acessar servidores CognosTM1 adicionais (ou outros aplicativos Cognos) que são configurados parareferenciar o mesmo servidor Cognos.

Quando um usuário tenta acessar o servidor Cognos TM1 , o servidor valida opassaporte para autenticar o usuário. Isto é feito consultando um servidor Cognospara a identidade do passaporte. Se o passaporte for válido, a consulta retornaráuma coleção de informações sobre segurança e autenticação para o usuário. Estasinformações contêm as funções e grupos com os quais o usuário tem associação,bem como a conta (nome de usuário) associada ao passaporte. Se o nome deusuário já existir no Cognos TM1 , sua associação existente será validada comrelação aos grupos do Cognos TM1 existentes. Se o usuário não existir, ele seráincluído e designado aos grupos de usuários apropriados no servidor Cognos TM1.

Após conectar-se ao CAM, duas novas pastas são criadas no diretório installdir: odiretório de configuração possui o arquivo epC8ITK.ini e o diretório Logs possuidiversos epC8ITK_2008-03-13.log.v o diretório de configuração possui epC8ITK.iniv o diretório de Logs possui vários epC8ITK_<datestamp>.log

Acesso Anônimo e o Servidor Cognos TM1Para configurar com êxito definições de configuração e procedimentos para ativar aautenticação de segurança do IBM Cognos no servidor IBM Cognos TM1 , seuservidor Cognos não deve ser configurado para permitir acesso anônimo. Se o


acesso anônimo estiver ativado no servidor Cognos, não será possível efetuarlogon em um namespace a partir do Cognos TM1 ao importar grupos do Cognosno Cognos TM1 .

Configurando o Cliente Cognos TM1Você deve incluir dois parâmetros em seu arquivo Tm1p.ini para permitir aexecução de tarefas administrativas relacionadas à segurança do IBM Cognos apartir de seu cliente Cognos TM1 .

Procedimento1. Abra o arquivo de configuração Tm1p.ini em um editor de texto. Tm1p.ini está

localizado no diretório C:\Documents and Settings\user name\ApplicationData\Applix\TM1.

2. Inclua os seguintes parâmetros no arquivo Tm1p.ini.

Tabela 28. Parâmetros para o Arquivo Tm1p.ini

Nome do Parâmetro Descrição

CognosGatewayURI O URI para o Cognos Server que o IBM CognosConnection usou para autenticar clientes do Cognos TM1. O URI é especificado no formato

http[s]://host/cognos_location/cgi-bin/cognos.cgi

Por exemplo: http://10.121.25.121/cognos_location/cgi-bin/cognos.cgi

AllowImportCAMClients Determina se os clientes do Cognos podem serimportados no Cognos TM1 . Este parâmetro deve serconfigurado como T ao configurar a segurança doCognos no Cognos TM1 .

O arquivo Tm1p.ini deve incluir parâmetros semelhantes aos seguintes:AllowImportCAMClients = T

CognosGatewayURI = http://10.111.25.121/cognos_location/cgi-bin/cognos.cgi

3. Salve e feche Tm1p.ini.4. Reinicie seu cliente Cognos TM1 .

Definindo um Usuário do Cognos para Atuar como umAdministrador do Cognos TM1Para administrar com sucesso o IBM Cognos TM1 ao usar a autenticação do IBMCognos, um usuário existente do Cognos deve ser incluído no grupo ADMIN doCognos TM1 .

Este usuário do Cognos será usado para importar os grupos do Cognos no CognosTM1 .

Procedimento1. Efetue login no Cognos TM1 como um administrador.2. No Server Explorer, clique em Servidor > Segurança > Clientes/Grupos.3. Na caixa de diálogo Clientes/Grupos, clique em Clientes > Incluir Novo

Cliente.A caixa de diálogo Logon do Cognos aparece.

4. Insira o seu ID do usuário e senha do Cognos e, em seguida, clique em OK.


5. Na caixa Nome, clique no namespace no qual você está com login efetuado.

Nota: Somente usuários do namespace no qual você efetuou login podem serimportados no Cognos TM1 . Outros namespaces podem aparecer na caixaNome, mas não é possível importar usuários deles.O conteúdo da caixa Nome é atualizado para exibir os diretórios disponíveisno namespace selecionado.

6. Ative a opção Mostrar usuários na lista.7. Navegue para o diretório contendo o usuário do Cognos que deseja definir

como um administrador do Cognos TM1 . Na maioria das circunstâncias, vocêdefinirá seu próprio usuário do Cognos como um administrador do CognosTM1 , pois você deve conhecer o ID do usuário e a senha do Cognos paraconcluir tarefas administrativas.

8. Selecione o usuário.

9. Clique no ícone de seta verde do para mover o usuário selecionado para alista Entradas Selecionadas.

10. Clique em OK para importar o usuário do Cognos no Cognos TM1 .O usuário aparece como um novo cliente na janela Cliente/Grupos, mas não édesignado a nenhum grupo do Cognos TM1 .

11. Designe o novo usuário ao grupo ADMIN e clique em OK.12. Encerre o servidor Cognos TM1 .13. Abra o arquivo de configuração Tm1s.cfg em um editor de texto.14. Configure o parâmetro IntegratedSecurityMode para indicar que o servidor

deve usar autenticação do IBM Cognos. O valor de parâmetro exato dependedos componentes Cognos TM1 específicos que estão sendo usados:v Se não estiver usando o componente Cognos TM1 Applications, configure o

parâmetro como 4.IntegratedSecurityMode=4

v Se estiver usando o Cognos TM1 Applications com a segurança do Cognos,configure o parâmetro como 5 para suportar grupos de usuários do CognosTM1 e do Cognos.IntegratedSecurityMode=5

15. Salve e feche Tm1s.cfg.16. Reinicie o servidor Cognos TM1 .

Importando os Grupos do Cognos no Cognos TM1Após um usuário do IBM Cognos ser definido como o administrador do CognosTM1 , esse usuário pode importar os grupos do Cognos no Cognos TM1 .

Você deve importar somente os grupos do Cognos que deseja permitir que acessemo servidor Cognos TM1 .

Procedimento1. No Server Explorer, dê um clique duplo em seu servidor Cognos TM1 .

A caixa de diálogo Logon do Cognos aparece.2. Efetue logon como o usuário Cognos que você definiu como o administrador

do Cognos TM1 .3. No Server Explorer, clique em Servidor, em seguida, em Segurança, em

seguida, em Clientes/Grupos.4. Na janela Clientes/Grupos, clique em Grupos e em Incluir Novos Grupos.


5. Na caixa Nomes, clique no namespace ao qual está atualmente conectado.

Nota: Somente grupos do namespace ao qual você está conectado podem serimportados no Cognos TM1 . Outros namespaces podem aparecer na caixaNome, mas não é possível importar grupos deles.

6. Navegue por meio da estrutura de diretório e selecione os grupos do Cognosque deseja importar no Cognos TM1 .

7. Clique no ícone de seta verde do para mover o usuário selecionado para alista Entradas Selecionadas.

8. Clique em OK para importar os grupos do Cognos no Cognos TM1 .Se você revisar a seção Designação de Grupo de Usuários da janelaClientes/Grupos, deverá ver os grupos do Cognos incluídos em seu servidor.

Criando UsuáriosQuando o servidor IBM Cognos TM1 é configurado para usar a autenticação doCognos, não é possível criar novos clientes diretamente no servidor Cognos TM1 .

Em vez disso, toda administração do cliente é executada no Cognos.

Quando um usuário do Cognos acessa o Cognos TM1 , o usuário é validado edesignado automaticamente aos grupos do Cognos TM1 apropriados. Não hánecessidade de designar usuários manualmente aos grupos no Cognos TM1 .

Administrando a Segurança de Objeto do Cognos TM1Embora a autenticação do IBM Cognos gerencie automaticamente usuários noservidor IBM Cognos TM1, o administrador do Cognos TM1 ainda deve gerenciara segurança do objeto para permitir que usuários do Cognos visualizem e usemobjetos do Cognos TM1 .

Para obter detalhes sobre como administrar a segurança de objeto do Cognos TM1, consulte a segurança do Cognos com o Cognos TM1 Developer Guide.

Configurando o Cognos TM1 Web para Usar a Segurança doCognosPara permitir que usuários efetuem login com sucesso no IBM Cognos TM1 Webquando o Cognos TM1 Server usa autenticação IBM Cognos, um arquivovariables_TM1.xml deve estar presente no diretório cognos_location\templates\ps\portal.

O arquivo variables_TM1.xml deve ser configurado para incluir a URL do servidorda Web usada para entregar o Cognos TM1 Web.

O arquivo variables_TM1.xml é incluído como parte da instalação do Cognos TM1Viewer Portlets. Para obter detalhes sobre como instalar e configurar o ViewerPortlets, consulte a segurança do IBM Cognos com o Guia de Instalação eConfiguração do IBM Cognos TM1 .

Configurando Valores de Tempo Limite da Sessão para oCognos TM1 Applications e Segurança do Cognos BIAo usar o IBM Cognos TM1 Applications com a segurança do IBMCognosBusiness Intelligence, configure o tempo limite da sessão pmpsvc com umvalor mais alto do que o tempo limite da sessão do CAM para assegurar adetecção do tempo limite adequado. Se o tempo limite da sessão do Cognos TM1Applications (pmpsvc) for configurado com um valor inferior ao tempo limite da


sessão de segurança do Cognos BI (CAM), o Cognos TM1 Applications nãodetectará corretamente uma finalização de sessão do CAM e não atingirá o tempolimite.

Sobre Esta Tarefa

Para assegurar que o Cognos TM1 Applications possa detectar corretamente umafinalização de sessão do CAM, configure o tempo limite da sessão pmpsvc com umvalor mais alto do que o tempo limite da sessão do CAM.v O tempo limite da sessão pmpsvc é o número de segundos de inatividade após

os quais o Cognos TM1 Applications finaliza uma sessão do usuário. O valorpadrão é 3.600 segundos (1 hora).

v O tempo limite da sessão do CAM é o número de segundos de inatividade apósos quais a segurança do Cognos finaliza uma sessão do usuário. O valor padrãoé 3.600 segundos (1 hora).

Procedimento1. Configure o parâmetro de tempo limite da sessão pmpsvc.

Insira um valor para o atributo timeout do elemento service / session noarquivo pmpsvc_config.xml. Esse arquivo está localizado no diretórioWEB-INF/configuration.Por exemplo:v Quando o Cognos TM1 Applications é implementado com o Apache Tomcat

fornecido com a instalação do Cognos TM1, o arquivo pmpsvc_config.xmlencontra-se aqui:Cognos_TM1_install_location\webapps\pmpsvc\WEB-INF\configuration

v Quando o Cognos TM1 Applications é implementado com uma versãoseparada do Apache Tomcat, o arquivo encontra-se aqui:C:\Program Files\Apache Software Foundation\Tomcat version_number\webapps\pmpsvc\WEB-INF\configuration

Use o formato para o atributo service / session / timeout conforme definidono arquivo de definição de esquema XML pmpsvc_config.xsd localizado nomesmo diretório

2. Configure o tempo limite da sessão do CAM usando o IBM CognosConfiguration.Insira um valor no campo Tempo Limite de Inatividade em Segundos naseção Segurança/Autenticação do Cognos Configuration.

Efetuando Login no Cognos TM1 TopO utilitário IBM Cognos TM1 Top permite efetuar login na sessão atual do CognosTM1 Top executando o comando V do Cognos TM1 Top.

Para efetuar login com sucesso no Cognos TM1 Top, você deve fornecer o ID deNamespace IBM Cognos do namespace (não o nome descritivo), juntamente comum nome de usuário e uma senha Cognos válidos.

Considerações sobre o Administrador ao Usar a Autenticação doCognosOs administradores do IBM Cognos TM1 devem estar cientes de alguns problemasao configurar o servidor Cognos TM1 para usar a autenticação do IBM Cognos.

As questões são as seguintes:


v Revise a descrição dos modos de segurança do Cognos TM1 4 e 5 para oparâmetro IntegratedSecurityMode. Você deve entender como estes diferentesmodos controlam se os usuários do Cognos podem ou não pertencer aos gruposde usuários do Cognos TM1 . Para obter detalhes, consulte a descrição doparâmetro IntegratedSecurityMode no Guia de Operações do IBM Cognos TM1 .

v Não é possível usar o Cognos TM1 para designar permanentemente um usuáriodo Cognos a um outro grupo do Cognos. Qualquer designação do usuário feitano Cognos TM1 para um grupo do Cognos não é salva de volta no Cognos.Quando um usuário do Cognos efetua login no Cognos TM1 , as designações dogrupo no Cognos substituem quaisquer designações do grupo do Cognos feitasno Cognos TM1 .

v Se você renomear um usuário do Cognos após importar esse usuário no CognosTM1 , deverá, então, excluir o usuário no Cognos TM1 para atualizar o CognosTM1 com o novo nome de usuário. Após excluir o usuário no Cognos TM1 , onovo nome aparecerá na próxima vez que o usuário efetuar login.

Considerações sobre o Usuário ao Usar a Autenticação doCognosOs usuários do IBM Cognos TM1 devem estar cientes dos problemas que podemsurgir ao acessar o servidor Cognos TM1 configurado para usar a autenticação doIBM Cognos.

Comportamento de Autenticação:

Regras controlam o comportamento de autenticação ao efetuar logon no servidorIBM Cognos TM1 que usa autenticação do IBM Cognos.

As regras são as seguintes:v Se o logon comum estiver ativado no IBM Cognos e você tiver efetuado login

anteriormente em um aplicativo IBM Cognos e mantiver uma sessão ativa, nãoserão solicitadas credenciais ao efetuar login no servidor Cognos .

v Se o logon comum estiver ativado no IBM Cognos e você não tiver efetuadologin anteriormente em um aplicativo IBM Cognos, serão solicitadas ascredenciais ao efetuar logon no servidor Cognos TM1 .

v Se o logon comum não estiver ativado no IBM Cognos, serão solicitadascredenciais ao efetuar logon no servidor Cognos TM1 , mesmo se o servidorestiver configurado para usar autenticação do IBM Cognos.

Sessões de Segurança do Cognos Privadas:

Quando um servidor IBM Cognos é configurado para usar logon comum, serásolicitado que você forneça as credenciais somente uma vez.

Quaisquer conexões subsequentes com outros aplicativos ativados para segurançado IBM Cognos (incluindo o Cognos TM1 ) que são configurados para referenciaro mesmo servidor IBM Cognos ocorrerão automaticamente, desde que seupassaporte de segurança do Cognos seja válido.

Por exemplo, se você tiver três servidores Cognos TM1 disponíveis, todosconfigurados para usar o mesmo servidor IBM Cognos, depois que se conectar aoprimeiro servidor como o usuário X no namespace Y, todas as conexões com osoutros servidores Cognos TM1 ocorrerão automaticamente usando o passaporte dousuário X a partir do namespace Y.


Em algumas circunstâncias, talvez você deseje efetuar logon no servidor CognosTM1 como um usuário diferente daquele identificado por seu passaporte desegurança do Cognos. Para acomodar isso, a opção Efetuar logon como permitesubstituir a autenticação automática que geralmente ocorre com um passaporte,enquanto mantém a validade do passaporte para uso posterior. Ao efetuar logonno servidor Cognos TM1 usando a opção Efetuar Logon Como, uma sessãoprivada será estabelecida. As credenciais usadas para estabelecer a sessãoparticular não são armazenadas em um passaporte e não são compartilhadas comnenhum outro aplicativo. Qualquer passaporte existente permanece válido e podeser usado para acessar outros aplicativos ativados para segurança do IBM Cognos.

Procedimento

1. No Server Explorer, clique em Servidor e em Efetuar logon como.2. Na janela Logon do Cognos, insira o ID do Usuário e a Senha que deseja usar

para efetuar logon no servidor Cognos TM1 .3. Clique em OK.

Estabelecendo uma Replicação com a Segurança do Cognos:

Ao estabelecer uma conexão de replicação com o servidor IBM Cognos TM1 queusa autenticação do IBM Cognos, você deve fornecer o ID do Namespace IBMCognos do namespace.

Não forneça o nome descritivo do namespace.

Usando SSL para Segurança de Transmissão de DadosÉ possível configurar o IBM Cognos TM1 para usar o SSL para proteger atransmissão de dados.

Visão Geral para Usar SSL para Segurança de Transmissão deDados

Todos os componentes IBM Cognos TM1 se comunicam com o Cognos TM1Admin Server usando SSL.

O Admin Server suporta clientes Cognos TM1 mais antigos que não podem usarSSL atendendo em duas portas; uma segura, a outra não segura. Os clientesCognos TM1 que podem usar SSL se conectam ao Admin Server por meio da portasegura, enquanto que clientes mais antigos que são incapazes de usar SSL seconectam ao Admin Server por meio da porta não segura.

Quando o servidor Cognos TM1 se registra no Admin Server, o servidor CognosTM1 especifica se ele está usando SSL ou não. Quando um cliente Cognos TM1contatar o Admin Server, a lista de servidores Cognos TM1 disponíveis variará deacordo com qual porta o cliente usa para se conectar ao Admin Server. Se o clienteusa a porta segura, o Admin Server responde com uma lista de todos os servidoresCognos TM1 disponíveis na rede. Se o cliente usar a porta não segura, o AdminServer responderá com uma lista apenas daqueles servidores Cognos TM1 que nãousam SSL.


Certificados GeradosQuando você instala o IBM Cognos TM1 , todos os certificados e outros arquivosrequeridos para implementar SSL são colocados no diretório TM1_install_dir\bin\SSL.

Os certificados contidos neste diretório são emitidos pela autoridade de certificaçãoApplix, Inc., que foi criada usando o OpenSSL. A senha usada era "applix".

Quando você instala o Cognos TM1 , o Servidor Administrativo, o servidor CognosTM1 e o cliente Cognos TM1 são todos configurados para usar SSL, contando comos certificados instalados no diretório TM1_install_dir\bin\SSL. Embora oscertificados Cognos TM1 permitam uma implementação SSL pronta, você devesubstituir estes certificados por seus próprios certificados (bem como uma lista derevogação de certificado) se desejar maximizar a segurança. Para o Cognos TM1Web, todos os certificados raízes devem ser instalados no armazenamento decertificados na máquina que os servidores estão usando para executar o CognosTM1 Web.

O diretório TM1_install_dir\bin\SSL contém os seguintes certificados e arquivos.Os arquivos com uma extensão .pem são o formato Privacy Enhanced Mail. Osarquivos com uma extensão .der são Distinguished Encoding Rules.v Applixca.pem - o certificado da autoridade raiz pública

Figura 9. Usando SSL para Segurança de Transmissão de Dados


v Applixcacrl.pem - a lista de revogação de certificadov Applixca.der - o certificado da propriedade de administrador público em

formato DER usado para armazenamentos de certificados Javav tm1admsvrcert.pem - o certificado do Servidor Administrativo contendo o par

de chaves pública/privadav tm1svrcert.pem - o certificado do servidor Cognos TM1 contendo o par de

chaves pública/privadav dh512.pem - o arquivo que contém a chave de 512 bits Diffie-Hellman

pré-geradav dh1024.pem - o arquivo que contém a chave de 1024 bits Diffie-Hellman

pré-geradav tm1store - o armazenamento de certificados Java contendo o certificado da

propriedade de administrador públicov tm1cipher.dat - o arquivo criptografado contendo a senha usada para acessar a

chave privada do servidorv tm1key.dat - a chave usada para criptografar e decriptografar tm1cipher.dat

Configurando o Cognos TM1 Admin Server para Usar SSLUse o IBM Cognos Configuration para configurar o IBM Cognos TM1 AdminServer para usar SSL.

Nota: A partir do IBM Cognos TM1 versão 10.1, estes parâmetros são configuradosexclusivamente no Cognos Configuration e não são mais configurados no arquivode configuração Tm1admsrv.ini.

Abra o Cognos Configuration e edite os parâmetros relacionados a SSL conformedescrito na tabela a seguir.


SupportNonSSLClients Este parâmetro determina se o Servidor Administrativosuporta clientes Cognos TM1 não SSL.

Defina SupportNonSSLClients = T para configurar oServidor Administrativo para suportar clientes não SSL epara receber conexões do cliente em portas seguras (SSL) enão seguras.

Defina SupportNonSSLClients = F para configurar oServidor Administrativo para suportar apenas conexões docliente SSL em uma única porta segura.

SSLCertAuthority O caminho completo do arquivo da autoridade decertificação do Cognos TM1 Admin Server.

SSLCertificate O caminho completo do arquivo de certificado do CognosTM1 Admin Server, que contém o par de chavespública/privada.



DHFile-512 O nome do caminho completo do arquivo que contém umachave de 512 bits Diffie-Hellman pré-gerada.

A geração de parâmetros Diffie-Hellman pode serdispendiosa em termos computacionais. Para minimizar oconsumo de recursos e reduzir a quantidade de temponecessário para carregar o servidor Cognos TM1 , da chaveDiffie-Hellman de 512 bits deve ser gerada previamente earmazenada em um arquivo que é chamado quando oServidor Administrativo inicia.

DHFile-1024 O caminho completo do arquivo que contém uma chave de1024 bits Diffie-Hellman pré-gerada.

A geração de parâmetros Diffie-Hellman pode serdispendiosa em termos computacionais. Para minimizar oconsumo de recursos e reduzir a quantidade de temponecessário para carregar o servidor Cognos TM1 , a chaveDiffie-Hellman de 1024 bits deve ser gerada previamente earmazenada em um arquivo que é chamado quando oServidor Administrativo inicia.

SSLPrivateKeyPwdFile O caminho completo do arquivo que contém a senhacriptografada para a chave privada do Cognos TM1 AdminServer.

SSLPwdKeyFile O caminho completo do arquivo que contém a chave usadapara criptografar e decriptografar a senha para a chaveprivada.



ExportSvrSSLCert Especifica se o certificado do Cognos TM1 Admin Serverdeve ser exportado a partir do armazenamento decertificados do Windows.

Se ExportSvrSSLCert=T, o certificado do ServidorAdministrativo será exportado do armazenamento decertificados Windows quando o certificado for solicitadopelo Servidor Administrativo.

Se ExportSvrSSLCert=T, você também deverá configurar osseguintes parâmetros:

SvrSSLExportKeyID

SSLCertificateID

SSLPrivateKeyPwdFile

SSLPwdKeyFile

SSLCertAuthority

SvrSSLExportKeyID

ExportSvrSSLCert

ClientExportSSLSvrKeyID

Para obter detalhes sobre como usar seus próprioscertificados de segurança e como exportar certificados doarmazenamento de certificados do Windows, consulte“Usando Certificados Independentes” na página 217.

SSLCertificateID Especifica o nome do principal para quem o certificado doCognos TM1 Admin Server é emitido.

SSLCertRevocationFile O caminho completo do arquivo de revogação decertificado do Cognos TM1 Admin Server.

Um arquivo de revogação de certificado existirá apenas nocaso de revogação de um certificado.

SvrSSLExportKeyID Especifica a chave de identidade usada para exportar ocertificado do Servidor Administrativo a partir doarmazenamento de certificados do Microsoft Windows.

Este parâmetro será necessário apenas se você optar porusar o armazenamento de certificados.

Configurando o Servidor Cognos TM1 para Usar SSLPara configurar um servidor IBM Cognos TM1 para usar SSL, você deve configurarvários parâmetros no Tm1s.cfg, um arquivo de configuração do servidor CognosTM1 .

A tabela a seguir descreve todos os parâmetros relacionados a SSL que podem serdefinidos no arquivo de configuração Tm1s.cfg. Observe que esta tabela descreve


apenas os parâmetros de Tm1s.cfg que estão relacionados a SSL; os demaisparâmetros de Tm1s.cfg são descritos em “Parâmetros no Arquivo Tm1s.cfg” napágina 232.


UseSSL Ativa ou desativa o SSL no servidor CognosTM1 .

Defina UseSSL=T para ativar SSL. Com estaconfiguração, somente clientes Cognos TM19.1 e posterior poderão se conectar de formasegura ao servidor.

Defina UseSSL=T para desativar SSL. Comesta configuração, todos os clientes CognosTM1 , incluindo clientes mais antigos quenão suportam SSL, poderão se conectar aoservidor no modo inseguro.

AdminSvrSSLCertID Especifica o nome do principal para quem ocertificado do Cognos TM1 Admin Server éemitido.

Se o AdminSvrSSLCertID estiverconfigurado incorretamente, o menususpenso do servidor no Cognos TM1 Webserá exibido vazio e um erro será registradono arquivo TM1web.log.

AdminSvrSSLCertAuthority O caminho completo do arquivo daautoridade de certificação que emitiu ocertificado do Cognos TM1 Admin Server.

AdminSvrSSLCertRevList O caminho completo do arquivo derevogação de certificado emitido pelaautoridade de certificação que emitiuoriginalmente o certificado do Cognos TM1Admin Server. Um arquivo de revogação decertificado existirá apenas no caso derevogação de um certificado

ExportAdminSvrSSLCert Especifica se o certificado do Cognos TM1Admin Server deve ser exportado a partirdo armazenamento de certificados doMicrosoft Windows.

Se ExportAdminSvrSSLCert=T, o certificadodo Servidor Administrativo será exportadodo armazenamento de certificados doMicrosoft Windows quando o certificado forsolicitado pelo servidor Cognos TM1 .

AdminSvrSSLExportKeyID Especifica a chave de identidade usada paraexportar o certificado do ServidorAdministrativo a partir do armazenamentode certificados do Microsoft Windows.



SSLCertificate O caminho completo do arquivo decertificado que contém o par de chavespública/privada.

SSLCertAuthority O nome do arquivo de autoridade decertificação do servidor Cognos TM1 . Estearquivo deve residir no computador no qualo servidor Cognos TM1 está instalado.

SSLCertRevocationFile O nome do arquivo de revogação decertificado do servidor Cognos TM1 . Umarquivo de revogação de certificado existiráapenas no caso de revogação de umcertificado. Este arquivo deve residir nocomputador no qual o servidor Cognos TM1está instalado.

SSLCertificateID O nome do principal para quem ocertificado do servidor Cognos TM1 éemitido.

ExportSvrSSLCert Especifica se o certificado do servidorCognos TM1 deve ser exportado a partir doarmazenamento de certificados do Windows.

Se ExportSvrSSLCert=T, o certificado doservidor Cognos TM1 será exportado doarmazenamento de certificados do Windowsquando o certificado for solicitado peloservidor Cognos TM1 .

Se ExportAdminSvrSSLCert=T, também seránecessário definir os seguintes parâmetrosTm1s.cfg:

AdminSvrSSLCertID

AdminSvrSSLExportKey

ExportSvrSSLCert

SvrSSLExportKeyID

SSLCertificateID

SSLPwdKeyFile

SSLPrivateKeyPwdFile

SSLCertAuthority

ClientExportSSLSvrCert

Para obter detalhes sobre como usar seuspróprios certificados de segurança e exportarcertificados do armazenamento decertificados do Microsoft Windows, consulte"Usando Certificados Independentes".



SvrSSLExportKeyID A chave de identidade usada para exportaro certificado do servidor Cognos TM1 apartir do armazenamento de certificados doWindows.

Este parâmetro será necessário apenas sevocê escolher usar o armazenamento decertificados definindo ExportSvrSSLCert=T.

SSLPrivateKeyPwdFile O caminho completo do arquivo que contéma senha criptografada para a chave privada.

SSLPwdKeyFile O caminho completo do arquivo que contéma chave usada para criptografar edecriptografar a senha para a chave privada.

ClientExportSSLSvrCert Especifica se o cliente Cognos TM1 deverecuperar o certificado de autoridade decertificação, que foi usado originalmentepara emitir o certificado do servidor CognosTM1 , a partir do armazenamento decertificados do Microsoft Windows.

Se ClientExportSSLSvrCert=T, o certificadode autoridade de certificação será exportadodo armazenamento de certificados nocomputador do cliente quando solicitadopelo cliente Cognos TM1 .

ClientExportSSLSvrKeyID A chave de identidade usada pelo clienteTM1 para exportar o certificado deautoridade de certificação, que foi usadooriginalmente para emitir o certificado doservidor Cognos TM1 , a partir doarmazenamento de certificados do Windows.

DHFile-512 O caminho completo do arquivo que contéma chave de 512 bits Diffie-Hellmanpré-gerada.

A geração de parâmetros Diffie-Hellmanpode ser muito dispendiosa em termoscomputacionais. Para minimizar este custo, achave Diffie-Hellman de 512 bits pode sergerada previamente e armazenada em umarquivo que é chamado quando o servidorCognos TM1 inicia.



DHFile-1024 O nome do caminho completo do arquivoque contém a chave de 1024 bitsDiffie-Hellman pré-gerada.

A geração de parâmetros Diffie-Hellmanpode ser muito dispendiosa em termoscomputacionais. Para minimizar este custo, achave Diffie-Hellman de 1024 bits pode sergerada previamente e armazenada em umarquivo que é chamado quando o servidorCognos TM1 inicia.

Configurando os Clientes Cognos TM1 para Usar SSLPara configurar os clientes IBM Cognos TM1 Architect ou Perspectives para usarSSL, você deve configurar várias opções na caixa de diálogo Opções do CognosTM1 .1. Abra o Cognos TM1 Architect ou Cognos TM1 Perspectives, Server Explorer.2. Em Server Explorer, clique em Arquivo > Opções.3. Edite as opções de SSL na seção Secure Socket Layer (SSL) do Servidor

Administrativo.

A tabela a seguir descreve todas as opções relacionadas a SSL que podem serconfiguradas na caixa de diálogo Opções do TM1 e lista os parâmetros Tm1p.inicorrespondentes.

Nome da OpçãoParâmetro de Tm1p.iniCorrespondente Descrição

Autoridade deCertificação

AdminSvrSSLCertAuthority O caminho completo do arquivo daautoridade de certificação que emitiu ocertificado do Cognos TM1 AdminServer.

Lista de Revogaçãode Certificado

AdminSvrSSLCertRevList O caminho completo do arquivo derevogação de certificado emitido pelaautoridade de certificação que emitiuoriginalmente o certificado do CognosTM1 Admin Server. Um arquivo derevogação de certificado existiráapenas no caso de revogação de umcertificado.

ID do Certificado AdminSvrSSLCertIDNota: O nome do principal para quemo certificado do Cognos TM1 AdminServer é emitido.

O valor desse parâmetro deve seridêntico ao parâmetro SSLCertificateIDpara o IBM Cognos TM1 Admin Serverconforme configurado no IBM CognosConfiguration.


Nome da OpçãoParâmetro de Tm1p.iniCorrespondente Descrição

UsarArmazenamentode Certificados

ExportAdminSvrSSLCert Selecione esta opção se desejar que ocertificado de autoridade decertificação que emitiu originalmente ocertificado do Servidor Administrativodo Cognos TM1 seja exportado a partirdo armazenamento de certificados doMicrosoft Windows no tempo deexecução.

Selecionar esta opção na caixa dediálogo Opções do Cognos TM1 éequivalente a configurarExportAdminSvrSSLCert=T no arquivoTm1p.ini.

Quando esta opção é selecionada, vocêtambém deve configurar um valor parao ID do Certificado de Exportação naCaixa de Diálogo Opções do CognosTM1 .

Exportar ID doCertificado

AdminSvrSSLExportKeyID A chave de identidade usada paraexportar o certificado de autoridade decertificação, que emitiu originalmente ocertificado do Servidor Administrativodo Cognos TM1 , a partir doarmazenamento de certificados.

Este parâmetro será necessário apenasse você escolher usar oarmazenamento de certificadosdefinindo ExportAdminSvrSSLCert=T.

Configurando o Cognos TM1 Web para Usar SSLPara ativar SSL no IBM Cognos TM1 Web, você deve modificar o valor para achave AdminSvrSSLCertID no arquivo de configuração do Cognos TM1 Web,Web.config.

O arquivo Web.config está localizado no diretório TM1Web em seu servidor daWeb. O local padrão desse diretório é:

Cognos_TM1_install_location\TM1Web

A chave AdminSvrSSLCertID é exibida na seção appSetting localizada na partesuperior do arquivo de configuração. Você deve configurar o valor da chaveAdminSvrSSLCertID para o nome do principal para quem o certificado do CognosTM1 Admin Server é emitido.

A entrada padrão AdminSvrSSLCertID no arquivo Web.config é:

<!-AdminSvrSSLCertID: Admin Server SSL Certificate ID -->

<add key="AdminSvrSSLCertID" value="tm1adminserver" />


Essa entrada padrão configura o Cognos TM1 Web para usar os certificados SSLpadrão SSL que são incluídos como parte da instalação do Cognos TM1 .

Para usar seus próprios certificados SSL customizados, configure o atributo valuedesse parâmetro para o nome do certificado que você está usando para ocertificado SSL do Cognos TM1 Admin Server.

Configurando o Cognos TM1 Applications para Usar SSLPara configurar o IBM Cognos TM1 Applications para usar SSL com seus próprioscertificados customizados, configure SSL para os outros componentes do CognosTM1 que interagem com Cognos TM1 Applications, configure os servidores daWeb que suportam Cognos TM1 Applications e edite a configuração do CognosTM1 Applications.

Antes de Iniciar

Instale e configure Cognos TM1 Applications sem SSL e assegure-se de poderexecutar e efetuar login no programa.

Procedimento1. Configure TM1 Admin Server para usar SSL.

Consulte o “Configurando o Cognos TM1 Admin Server para Usar SSL” napágina 205.

2. Configure TM1 Server para usar SSL.Consulte o “Configurando o Servidor Cognos TM1 para Usar SSL” na página207.

3. Configure TM1 Web para usar SSL.Consulte o “Configurando o Cognos TM1 Web para Usar SSL” na página 212.

4. Copie os arquivos de certificado na pasta SSL do Cognos TM1 Applications:Cognos TM1 install location\webapps\pmpsvc\WEB-INF\bin\ssl

5. Se estiver usando seus próprios certificados, importe-os da seguinte forma.a. No computador executando o Cognos TM1 Admin Server, use IBM Cognos

Configuration para atualizar os parâmetros SSL para o Admin Server.Consulte o “Editando Parâmetros SSL no Cognos Configuration para UsarCertificados Independentes” na página 219.

b. No computador executando Cognos TM1 Server, execute a ferramentatm1crypt.exe

Consulte o “Executando o Utilitário TM1Crypt” na página 218.c. No computador executando Cognos TM1 Web, importe o certificado no

armazenamento de certificados do Microsoft Windows.Consulte o “Incluindo seu Certificado no Armazenamento de Certificadosdo Microsoft Windows” na página 217.

6. No computador onde o Cognos TM1 Web está em execução, assegure-se de queo Microsoft Internet Information Services (IIS) esteja configurado para usar SSL.Para obter detalhes, consulte no Web site de suporte da Microsoft o artigo#299875, “Como Implementar SSL no IIS”.

7. No computador executando o Cognos TM1 Application Server, configureApache Tomcat para usar SSL. Para obter detalhes, procure no Web site dadocumentação do Apache “Configuração SSL”. As etapas gerais incluem:a. Criar um keystore usando keytool Java Development Kit (JDK).


b. Configurar o arquivo server.xml do Tomcat para que o Tomcat usekeystore.

c. Criar uma solicitação de assinatura usando keytool JDK.d. Assinar a solicitação e obter resposta do certificado da autoridade de

certificação.e. Importar o certificado no keystore usado pelo Tomcat.f. Importar CA raiz no keystore usado pelo Tomcat.

8. No computador executando o Cognos TM1 Application Server, edite o arquivode configuração do Cognos TM1 Applications, fpmsvc_config.xml.a. Abra o arquivo fpmsvc_config.xml:

v Se o Cognos TM1 Applications com o Apache Tomcat fornecido foiimplementado, procure o arquivo aqui:Cognos TM1 install location\webapps\pmpsvc\WEB-INF\configuration

v Se você implementou com um servidor de aplicativos da web diferente,procure o arquivo aqui:program files for web application server\webapps\pmpsvc\WEB-INF\configuration

b. Edite ou inclua a seguinte entrada sob a seção </tm1><servers>:<certificate authority="authority_file_name" id="id_name" />

em que authority_file_name é o nome do arquivo de certificado e id_name é onome do certificado. Esse arquivo deve estar localizado na pasta:Cognos TM1 install location\webapps\pmpsvc\WEB-INF\bin\ssl

Lembre-se: Você deve copiar manualmente este arquivo neste local.c. Para especificar uma lista de revogação de certificados SSL, use o atributo

opcional revocationList. Se for especificado, o arquivo com o mesmo nomedeverá estar na pasta \pmpsvc\WEB-INF\bin\ssl.

d. Para especificar o ID de autoridade e de certificado para um Cognos TM1Admin Server, inclua a mesma seção <certificate authority /> na seçãoadmin_host. Se um certificado não for especificado, o padrão será usado.

9. Atualize a configuração de URL para o cliente Cognos TM1 Application Web:a. Efetue login no Cognos TM1 Applications.

b. Clique no ícone Administrar o IBM Cognos TM1 Applications na barrade ferramentas da página principal do Cognos TM1 Applications.

c. Clique na caixa de seleção TM1 Application Web e clique em Editar.d. Atualize o valor no campo URL para a URL segura para sua instalação do

Cognos TM1 Web. Por exemplo:https://web server name/TM1Web/contributor.aspx

e. Clique em OK.

Configurando o Utilitário Cognos TM1 Top para Usar SSLO utilitário IBM Cognos TM1 Top pode ser configurado para usar SSL ao secomunicar com o Cognos TM1 Admin Server incluindo cinco parâmetrosespecíficos de SSL no arquivo Tm1top.ini.



AdminSvrSSLCertAuthority O caminho completo do arquivo daautoridade de certificação que emitiu ocertificado do Cognos TM1 Admin Server.

AdminSvrSSLCertID O nome do principal para quem ocertificado do Cognos TM1 Admin Server éemitido.

AdminSvrSSLCertRevList O caminho completo do arquivo derevogação de certificado emitido pelaautoridade de certificação que emitiu ocertificado do Cognos TM1 Admin Server.

Um arquivo de revogação de certificadoexistirá apenas no caso de revogação de umcertificado.

ExportAdminSvrSSLCert Indica se o certificado de autoridade decertificação que emitiu o certificado doCognos TM1 Admin Server deve serexportado a partir do armazenamento decertificados do Microsoft Windows no tempode execução.

Para exportar o certificado de autorização decertificação no tempo de execução, definaExportAdminSvrSSLCert=T.

AdminSvrSSLExportKeyID A chave de identidade usada para exportaro certificado de autoridade de certificaçãoque emitiu o certificado do servidor CognosTM1 Admin a partir do armazenamento decertificados do Windows.

Este parâmetro será necessário apenas sevocê escolher usar o armazenamento decertificados definindoExportAdminSvrSSLCert=T.

Configurando a API TM1 C API para Usar SSLVárias rotinas públicas estão disponíveis como parte da Interface de Programaçãode Aplicativos TM1 C. Estas rotinas podem ser usadas para configurar um clientepara comunicar-se com o Servidor Administrativo usando SSL.

Para obter detalhes adicionais, consulte "Configurando a API TM1 C para UsarSSL" no Guia da API do IBM Cognos TM1 .

Configurando a API Java do Cognos TM1 para Usar SSLOs certificados usados por um cliente Java para validar o servidor devem residirno arquivo de armazenamento confiável CAcerts do sistema Java ou seremespecificados na linha de comandos do aplicativo.

O armazenamento confiável CAcerts do sistema Java reside no diretório Java\lib\security.


Por exemplo:C:\Program Files\Java\JDK1.5.0_04\lib\security

A senha padrão para CAcert é "changeit". O Java fornece um executável chamadokeytool.exe para este propósito. Por exemplo:keytool -keystore ..\lib\security\cacerts -alias Company-import -file Companyca.der

Opcionalmente, se o acesso for restrito ao armazenamento confiável CAcert dosistema, um armazenamento confiável poderá ser criado. Por exemplo:keytool -keystore tm1store -alias Companyca -import -fileACompanyca.der

Ao iniciar o aplicativo Java, este keystore deve ser especificado. Se for necessáriauma senha, ela também deve ser fornecida. Por exemplo:java -Djavax.net.ssl.trustStore=bin\ssl\tm1store -Djavax.net.ssl.

trustStorePassword=Companycom.mycompany.MyApp

Informações adicionais são fornecidas na especificação da interface de programaçãode aplicativos para Java 2 Platform Standard Edition. A versão de Java mínimasuportada é 1.4.2.

Configurando o Utilitário ETLDAP do Cognos TM1 para UsarSSL

Antes de poder se conectar ao servidor LDAP usando SSL, você deve executar ocomando a seguir para incluir seu certificado no armazenamento do IBM CognosTM1 no diretório TM1_install_dir\axajre\bin:

Exemplo:C:\Program Files\Cognos\Tm1\axajre\bin >keytool -keystore"C:\Program Files\Cognos\Tm1\bin\ssl\tm1store" -alias Applixldapca-import -file c:\temp\certificate_name.cer

No comando acima, substitua o nome do arquivo de certificado porcertificate_name.cer.

Quando for solicitada a senha do keystore, insira 'applix'.

Você receberá a confirmação que o certificado foi incluído no keystore do CognosTM1.

Ao conectar-se ao servidor LDAP, você deve selecionar a opção SSL.

Se não for selecionada a opção SSL, o servidor LDAP não poderá autenticar asinformações sobre o usuário.

Ao executar o utilitário ETLDAP a partir de uma linha de comandos, é necessáriofornecer os dois seguintes parâmetros para ativar SSL.



-Djavax.net.sll.truststore Use este parâmetro para especificar ocaminho completo para o armazenamentode certificados Java que contém o certificadode propriedade de administrador público.

Por exemplo, para usar o armazenamento decertificados do Java instalado com o CognosTM1 , use o parâmetro-Djavax.net.sll.truststore= C:\ProgramFiles\Cognos\TM1\bin\ssl\tm1store

-Djavax.net.ssl.trustStorePassword Use este parâmetro para especificar a senhausada para criar o armazenamento decertificados Java.

Por exemplo, para especificar a senha usadapara criar o armazenamento de certificadosJava instalado com o Cognos TM1 , use oparâmetro-Djavax.net.ssl.trustStorePassword=applix

Usando Certificados IndependentesEmbora uma instalação padrão do IBM Cognos TM1 seja configurada para usarSSL contando com os certificados instalados no diretório TM1_install_dir\bin\SSL,você deve usar seus próprios certificados para maximizar a segurança.

As seções a seguir descrevem como usar certificados independentes paraimplementar o SSL.

Incluindo seu Certificado no Armazenamento de Certificados doMicrosoft WindowsÉ possível incluir um certificado independente no armazenamento de certificadosdo Microsoft Windows e configurar o IBM Cognos TM1 para usar o certificado noarmazenamento.

Procedimento1. No menu Iniciar do Windows, clique em Iniciar > Executar e insira mmc para

abrir o Microsoft Management Console.2. Clique em Arquivo > Incluir/Remover Snap-in no Microsoft Management

Console.3. Clique em Incluir.4. Selecione Certificados e clique em Incluir.5. Selecione Minha Conta de Usuário e clique em Concluir. Clique em OK.6. Clique com o botão direito do mouse em Pessoal em Certificados - Usuário

Atual e selecione Todas as Tarefas > Importar. Clique em Avançar.7. Clique em Procurar e selecione o arquivo .pfx que contém as informações de

certificado. Clique em Avançar.8. Insira uma senha para a chave privada e selecione a opção Marcar esta chave

como exportável. Clique em Avançar.9. Configure a tela conforme necessário e clique em Avançar.


10. Clique em Concluir na tela final do Assistente para Importação deCertificados.

Executando o Utilitário TM1CryptO utilitário TM1Crypt (TM1Crypt.exe) criptografa a senha necessária para oservidor IBM Cognos TM1 para acessar a chave privada.

A senha é criptografada usando Advanced Encryption Standard, 256 bit, CipherBlock Chaining (AES-256-CBC).

Local

O utilitário TM1Crypt, tm1crypt.exe, é instalado no diretório:

TM1_install_dir\bin

Sintaxe

Execute o utilitário TM1Crypt a partir de um prompt de comandos usando aseguinte sintaxe:

tm1crypt.exe -pwd password -keyfile filename -outfile filename -validate

Opções de Comando

Tabela 29. Opções para o Utilitário TM1Crypt

Opção Descrição

-pwd A senha para a chave privada. Esta deve ser a mesma senha usada paracriptografar seu certificado na Etapa 11 acima.

-keyfile O nome do arquivo .dat que será gerado para conter a chave usada paracriptografar e decriptografar a senha para a chave privada.

Se este parâmetro não for especificado, TM1Crypt gerará um arquivochamado tm1key.dat.

-outfile O nome do arquivo .dat que será gerado para conter a senhacriptografada para a chave privada.

Se este parâmetro não for especificado, TM1Crypt gerará um arquivochamado tm1cipher.dat.

-validate Se você incluir o parâmetro -validate, o utilitário decriptografará a senhacriptografada e exibirá o resultado como texto não criptografado.

O texto exibido deve corresponder à senha especificada com o parâmetro-pwd.

Este parâmetro não permite a validação de arquivos de saída.

Exemplo

Por exemplo, o comando

tm1crypt.exe -pwd abc123 -keyfile btkey.dat -outfile btprk.dat -validate


gera dois arquivos:v btkey.dat - contém a chave usada para criptografar/decriptografar a senha para

a chave privadav btprk.dat - contém a senha criptografada para a chave privada.

Os arquivos gerados são gravados no diretório TM1_install_dir\bin.

Editando Parâmetros SSL no Cognos Configuration para UsarCertificados IndependentesApós incluir seu certificado no Microsoft Windows Certificate Store, use o IBMCognos Configuration para atualizar os parâmetros SSL para o Cognos TM1Admin Server.

Nota: A partir do IBM Cognos TM1 versão 10.1, estes parâmetros são configuradosexclusivamente no Cognos Configuration e não são mais configurados no arquivode configuração Tm1admsrv.ini.

Tabela 30. Parâmetros SSL no Cognos Configuration que Suportam CertificadosIndependentes


ExportSvrSSLCert Este parâmetro deve ser definido como T para permitir que oServidor Administrativo recupere o certificado do Armazenamentode Certificados.

ExportSvrSSLCert=T

SSLCertAuthority O nome da autoridade que emitiu seu certificado.

É possível determinar esse valor consultando Microsoft ManagementConsole e clicando em Certificados > Pessoais > Certificados. Onome da autoridade é exibido na coluna Emitido por da área dejanela de Propriedades.

SSLCertificateID O nome do principal para quem o certificado do IBM Cognos TM1Admin Server é emitido.

É possível determinar esse valor consultando Microsoft ManagementConsole e clicando em Certificados > Pessoais > Certificados. Onome do principal é exibido na coluna Emitido para da área dejanela de Propriedades.

SSLPrivateKey-PwdFile

O caminho completo para o arquivo .dat que contém a senhacriptografada para a chave privada.

O nome deste arquivo é especificado pelo parâmetro -outfile quandovocê executa o utilitário TM1Crypt.

Por exemplo, se você executar o utilitário TM1Crypt a partir doseguinte comando:

tm1crypt.exe -pwd abc123 -keyfile btkey.dat -outfile btprk.dat-validate

o valor de parâmetro correto é:

SSLPrivateKeyPwdFile=C:\Program Files\Cognos\TM1\bin\btprk.dat


Tabela 30. Parâmetros SSL no Cognos Configuration que Suportam CertificadosIndependentes (continuação)


SSLPwdKeyFile O caminho completo para o arquivo .dat que contém a chave usadapara criptografar e decriptografar a senha para a chave privada.

O nome deste arquivo é especificado pelo parâmetro -keyfile quandovocê executa o utilitário TM1Crypt.

Por exemplo, se você executar o utilitário TM1Crypt a partir doseguinte comando:

tm1crypt.exe -pwd abc123 -keyfile btkey.dat -outfile btprk.dat-validate

o valor de parâmetro correto é:

SSLPwdKeyFile=C:\Program Files\Cognos\TM1\bin\btkey.dat

SvrSSLExportKeyID Especifica a chave de identidade usada para exportar o certificadodo Servidor Administrativo do armazenamento de certificados doWindows.

Na maioria dos casos, o valor de SvrSSLExportKeyID será idênticoao valor de SSLCertificateID.

Editando o Arquivo Tm1s.cfgApós incluir seu certificado no Microsoft Windows Certificate Store, inclua osparâmetros necessários no arquivo Tm1s.cfg.

Tabela 31. Parâmetros SSL para o Arquivo Tm1s.cfg

Parâmetro Valor

AdminSvrSSLCertID Especifica o nome do principal para quem o certificado doIBM Cognos TM1 Admin Server é emitido.

AdminSvrSSLExportKeyID Especifica a chave de identidade usada para exportar ocertificado do Servidor Administrativo a partir doarmazenamento de certificados do Microsoft Windows.

ClientExportSSLSvrCert Especifica se o cliente Cognos TM1 deve recuperar ocertificado de autoridade de certificação, que foi usadooriginalmente para emitir o certificado do servidor CognosTM1 , a partir do armazenamento de certificados doMicrosoft Windows.

Se ClientExportSSLSvrCert=T, o certificado de autoridadede certificação será exportado do armazenamento decertificados quando solicitado pelo cliente TM1 .

ClientExportSSLSvrKeyID A chave de identidade usada pelo cliente Cognos TM1 paraexportar o certificado de autoridade de certificação, que foiusado originalmente para emitir o certificado do servidorCognos TM1 , a partir do armazenamento de certificadosdo Microsoft Windows.


Tabela 31. Parâmetros SSL para o Arquivo Tm1s.cfg (continuação)

Parâmetro Valor

ExportAdminSvrSSLCert Especifica se o certificado do Cognos TM1 Admin Serverdeve ser exportado a partir do armazenamento decertificados do Microsoft Windows.

Se ExportAdminSvrSSLCert=T, o certificado do ServidorAdministrativo será exportado do armazenamento decertificados do Microsoft Windows quando o certificado forsolicitado pelo servidor Cognos TM1 .

ExportSvrSSLCert Este parâmetro deve ser configurado como T para ativar oservidor Cognos TM1 para recuperar o certificado doArmazenamento de Certificados.

ExportSvrSSLCert=T

SSLCertAuthority O nome da autoridade que emitiu seu certificado.

É possível determinar esse valor consultando MicrosoftManagement Console e clicando em Certificados > Pessoais> Certificados. O nome da autoridade é exibido na colunaEmitido por da área de janela de Propriedades.

SSLCertificateID O nome do principal para quem o certificado do CognosTM1 Server é emitido.

É possível determinar esse valor consultando MicrosoftManagement Console e clicando em Certificados > Pessoais> Certificados. O nome do principal é exibido na colunaEmitido para da área de janela de Propriedades.

SSLPrivateKey-PwdFile

O caminho completo para o arquivo .dat que contém asenha criptografada para a chave privada.

O nome deste arquivo é especificado pelo parâmetro-outfile quando você executa o utilitário TM1Crypt.

Por exemplo, se você executar o utilitário TM1Crypt apartir do seguinte comando:

tm1crypt.exe -pwd abc123 -keyfile btkey.dat -outfilebtprk.dat -validate

o valor de parâmetro correto é SSLPrivateKeyPwdFile=C:\Program Files\Cognos\TM1\bin\btprk.dat

SSLPwdKeyFile O caminho completo para o arquivo .dat que contém achave usada para criptografar e decriptografar a senha paraa chave privada.

O nome deste arquivo é especificado pelo parâmetro-keyfile quando você executa o utilitário TM1Crypt.

Por exemplo, se você executar o utilitário TM1Crypt apartir do seguinte comando:

tm1crypt.exe -pwd abc123 -keyfile btkey.dat -outfilebtprk.dat -validate

o valor de parâmetro correto é SSLPwdKeyFile=C:\ProgramFiles\Cognos\TM1\bin\btkey.dat


Tabela 31. Parâmetros SSL para o Arquivo Tm1s.cfg (continuação)

Parâmetro Valor

SvrSSLExportKeyID Especifica a chave de identidade usada para exportar ocertificado do servidor Cognos TM1 a partir doarmazenamento de certificados do Microsoft Windows.

Na maioria dos casos, o valor de SvrSSLExportKeyID seráidêntico ao valor de SSLCertificateID.

Usando Certificados Independentes em seu Sistema de ArquivosÉ possível implementar o SSL usando certificados independentes armazenados emseu sistema de arquivos.

Basta incluir seu certificado, a autoridade de certificação, os arquivos de senha, etc.no diretório TM1_install_dir\bin\SSL e modificar os parâmetros de configuraçãodo IBM Cognos TM1 apropriados para apontarem para seus arquivosindependentes.


Capítulo 19. Manutenção da Instalação do Cognos TM1 10.1

Após a instalação com sucesso do IBM Cognos TM1, é possível executar tarefas demanutenção, como instalar componentes adicionais, fazer backup de dados edesinstalar a versão atual.

Instalando componentes adicionaisÉ possível retornar para o Assistente de Instalação do Cognos TM1 parainstalar componentes adicionais que não estão instalados. Se você tentarreinstalar a mesma versão do IBM Cognos TM1 que já está instalada, a telaManutenção do Programa será aberta com as opções a seguir:

Fazendo backup de dadosAo fazer upgrade para uma nova versão do Cognos TM1, é possível fazerbackup manualmente e restaurar seus dados existentes do Cognos TM1.

Desinstalando a versão atual

Remover - Use esta opção para desinstalar o Cognos TM1 do computador.Para obter detalhes, consulte Desinstalando o Cognos TM1 10.1.

Fazendo Backup de Dados para Cognos TM1 10.1Este tópico descreve como fazer o backup dos dados do Cognos TM1.

Sobre Esta Tarefa

Se estiver usando atualmente o IBM Cognos TM1, siga estas etapas para fazerbackup do diretório de dados e dos arquivos de configuração do Cognos TM1.

Se estiver usando o Cognos TM1 Web em um servidor da Web, você tambémdeverá fazer backup dos dados e dos arquivos relacionados para esse componente.Se estiver usando Cognos TM1 Applications, você também deverá fazer backupdos dados e dos arquivos relacionados separadamente.

Procedimento1. Salve uma cópia do conteúdo do diretório de dados e subdiretórios

<TM1_Install>\samples\ do banco de dados do IBM Cognos TM1 em um localseguro.

2. Salve uma cópia de todos os arquivos de configuração do Cognos TM1 quequeira reter, como o arquivo tm1admsrv.ini localizado no diretório<TM1_Install>\bin\.

3. Se você usar o Cognos TM1 Web, faça backup do arquivo web.config equaisquer páginas do servidor Cognos TM1 Web customizadas em um localseguro. O local padrão desses arquivos é <TM1_Install>\TM1Web.

4. Se estiver usando o Cognos TM1 Architect ou Cognos TM1 Perspectives, salveo arquivo Tm1p.ini no %ALLUSERSPROFILES%\Application Data\Applix\TM1\ eno %USERPROFILE%\Application Data\Applix\TM1\.Na maioria dos casos, os caminhos completos para esses arquivos sãoC:\Documents and Settings\All Users\Application Data\Applix\TM1\Tm1p.inie C:\Documents and Settings\<username>\Application Data\Applix\TM1\Tm1p.ini.


5. Se você usar Cognos TM1 Applications, consulte “Fazer Backup de seus Dadosdo Cognos TM1 Applications” na página 225 para conhecer as etapas parafazer o backup dos arquivos de configuração e dos dados relacionados.

Modificando Componentes Instalados do Cognos TM1É possível modificar sua atual instalação, incluir componentes e alterar parâmetrosde instalação.

Sobre Esta Tarefa

Só é possível instalar componentes usando o assistente de instalação, e não épossível remover componentes usando esse método.

Procedimento1. Insira o CD de instalação do IBM Cognos TM1 em sua unidade de CD.

Se a execução automática estiver ativada em sua unidade de CD, o Assistentede Instalação do Cognos TM1 será exibido. Se a execução automática nãoestiver ativada, execute issetup.exe no diretório raiz do CD de instalação parainiciar o Assistente de Instalação do Cognos TM1.

2. Clique em Avançar.3. Selecionar Modificar na tela Manutenção do Programa e clique em Avançar.

A tela Seleção do Componente aparece, mostrando o estado atual de suainstalação do Cognos TM1. Itens instalados atualmente são exibidos com umícone de unidade de disco próximo do nome do componente. Itens nãoinstalados atualmente são exibidos com um X próximo do nome.A manutenção do programa não inclui alterar o local do diretório de instalaçãodo Cognos TM1. Para alterar o local do diretório de instalação, remova todos osarquivos do Cognos TM1 e reinstale o Cognos TM1 em um outro local.

4. Selecione os componentes do Cognos TM1 que deseja modificar e clique emAvançar.

5. Clique em Instalar para iniciar as modificações.6. Clique em Concluir quando as modificações forem concluídas.

Desinstalando o Cognos TM1 10.1Para remover e desinstalar todos os componentes do IBM Cognos TM1, siga estasetapas.

Nota: Se estiver desinstalando e reinstalando o Cognos TM1 Applications, consultea seção “Desinstalando Cognos TM1 Applications” na página 225 para conhecer asetapas necessárias adicionais. A desinstalação também tem um efeito no conjuntode aplicativos do Cognos TM1. Consulte o Guia do Usuário do IBM Cognos TM1 Webpara obter informações adicionais.

Antes de Iniciar

Dependendo dos componentes instalados, talvez você tenha que executar etapasseparadas para removê-los. Antes de começar a desinstalar o Cognos TM1 10.1,você deve ter concluído o backup de todos os dados do Cognos TM1.


Sobre Esta Tarefa

Procedimento1. Desinstale o Cognos Insight:

a. No Painel de Controle do Windows, escolha Adicionar ou RemoverProgramas.

b. Na lista de programas atualmente instalados, selecione IBM Cognos TM1Insight.

c. Clique em Remover e siga as instruções para concluir o processod. Verifique o diretório de arquivos de programas para ver se quaisquer

arquivos permanecem. Em caso afirmativo, exclua-os manualmente.2. Desinstale o Cognos TM1 Performance Modeler:

a. No Painel de Controle do Windows, escolha Adicionar ou RemoverProgramas.

b. Na lista de programas atualmente instalados, selecione IBM CognosPerformance Modeler.

c. Clique em Remover e siga as instruções para concluir o processod. Verifique o diretório de arquivos de programas para ver se quaisquer

arquivos permanecem. Em caso afirmativo, exclua-os manualmente.3. Desinstale os componentes principais do TM1 - servidor,

a. No menu Iniciar do Microsoft Windows, clique em Programas > IBMCognos TM1 > Desinstalar IBM Cognos TM1 > Desinstalar IBM CognosTM1.

b. Selecione o idioma para o assistente de desinstalação e clique em Avançar.c. Na tela Selecionar os Pacotes que Deseja Desinstalar, clique na caixa de

seleção da opção IBM Cognos TM1 e selecione Avançar. O programa dedesinstalação remove os componentes, mas pode levar algum tempo.Quando isso for concluído, será solicitado que você reinicie seu computador.

d. Escolha a opção para reiniciar agora ou mais tarde e clique em Concluir.

Desinstalando Cognos TM1 ApplicationsO IBM Cognos TM1 Applications precisa de diversas etapas para realizar umbackup e uma exportação completos de dados, caso você queira manter os dadosdo aplicativo.

As tarefas descritas aqui permitem:v Fazer Backup de seus Dados do Cognos TM1 Applicationsv Exportar dados do Cognos TM1 Applicationsv Parar todos os serviços relacionadosv Desinstalar o Cognos TM1 Applicationsv Remover a implementação do Cognos TM1 Application do Apache Tomcat se

usado.v Remover a implementação do Cognos TM1 Applications do WebSphere se

usado.v Reimportar aplicativos exportados na versão atual do Cognos TM1 Applications.

Fazer Backup de seus Dados do Cognos TM1 ApplicationsEste tópico descreve como fazer o backup de arquivos de configuração e dadospara o Cognos TM1 Applications.

Capítulo 19. Manutenção da Instalação do Cognos TM1 10.1 225

Procedimento

Salve uma cópia de backup da pasta applications do Cognos TM1 Applications edos arquivos de configuração pmpsvc_config.xml e fpmsvc_config.xml.Os locais típicos para esses itens são:v <TM1_Install>\webapps\pmpsvc\WEB-INF\applications

v <TM1_Install>\webapps\pmpsvc\WEB-INF\configuration\pmpsvc_config.xml

v <TM1_Install>\webapps\pmpsvc\WEB-INF\configuration\fpmsvc_config.xml

Se estiver usando a segurança do IBM Cognos BI com o Cognos TM1 Applications,estes itens estarão localizados no seguinte local:<Your Program Files>\cognos\cx\webapps\pmpsvcem que x é a versão do Cognos BI que está sendo usado.

Exportando Aplicativos do Cognos TM1 10.1 ApplicationsÉ possível exportar um aplicativo do IBM Cognos TM1 Applications 10.1 parasalvar uma cópia de backup ou para mover o aplicativo para outra instância doCognos TM1 Applications.

Sobre Esta Tarefa

Um archive é criado e contém os arquivos XML que descrevem a estrutura e asegurança do seu aplicativo.

Procedimento1. Abra o portal TM1 Cognos Applications.2. Clique no ícone Exportar Aplicativo na coluna Ações.3. Na caixa de diálogo Download de Arquivo, clique em Salvar.4. Navegue para o diretório no qual deseja salvar o arquivo de exportação.5. Clique em Salvar.

Parando Serviços Relacionados no Cognos TM1 10.1Este tópico descreve como parar serviços relacionados.

Procedimento1. Abra o Cognos Configuration.2. Pare todos os serviços a seguir:

v TM1 Admin Serverv TM1 Excel Servicesv todas as instâncias do serviço do TM1 Serverv TM1 Application Server

3. Se estiver usando a segurança do IBM Cognos Business Intelligence comCognos TM1 Applications, pare o serviço do IBM Cognos BI.

4. Se estiver executando qualquer serviço do Cognos TM1 que não foiconfigurado inicialmente e iniciado por meio do Cognos Configuration, pareesses serviços no console de serviços do Windows.

Desinstalando o Cognos TM1 10.1 ApplicationsEtapas para desinstalar o IBM Cognos TM1 Applications.


Procedimento1. Remova a implementação e desinstale o Cognos TM1 Applications.2. No Painel de Controle do Windows, escolha Adicionar ou Remover Programas.3. Na lista de programas atualmente instalados, selecione IBM Cognos TM1

Applications.

4. Clique em Remover e siga as instruções para concluir o processo5. Verifique o diretório de arquivos de programas para ver se quaisquer arquivos

permanecem. Em caso afirmativo, exclua-os manualmente.

Remover Implementação do Cognos TM1 Applications noApache Tomcat

Este tópico descreve como remover a implementação do IBM Cognos TM1Applications no Apache Tomcat.

Procedimento1. Abra o Tomcat Manager.2. Clique em Remover Implementação para a entrada /pmpsvc na lista

Aplicativos.3. Clique em OK para confirmar.

É implementação do aplicativo é removida da lista Aplicativos do TomcatManager.

Dica: Se a entrada /pmpsvc ainda for mostrada na lista Aplicativos apósremover a implementação, pare e reinicie o Tomcat e, em seguida, clique emRemover Implementação uma segunda vez.

4. Verifique se as pastas e os arquivos do aplicativo Cognos TM1 Application Weba seguir foram excluídos. Pare o Tomcat e exclua esses arquivos se eles aindaexistirem.Pastas:

v C:\Program Files\Apache Software Foundation\webapps\pmpsvc

v C:\Program Files\Apache Software Foundation\Tomcat 6.0\webapps\pmpsvc

v C:\Program Files\Apache Software Foundation\Tomcat6.0\work\Catalina\localhost\pmpsvc

Arquivos:

v C:\Program Files\Apache Software Foundation\Tomcat6.0\webapps\pmpsvc.war

Se estiver usando a segurança do IBM Cognos Business Intelligence com oCognos TM1 Applications, estes itens estarão localizados nos seguintes locais:v C:\Program Files\cognos\cx\webapps\pmpsvc

v C:\Program Files\cognos\cx\tomcat4.1.27\work\Standalone\localhost\pmpsvc

em que x é a versão do Cognos BI que está sendo usado.

Remover Implementação do Cognos TM1 Applications noWebSphere

Este tópico descreve como remover implementação do IBM Cognos TM1Applications no IBM WebSphere.

Capítulo 19. Manutenção da Instalação do Cognos TM1 10.1 227

Procedimento1. Abra o WebSphere Administrative Console.2. Na área de janela Navegação do Console, localize a seção Aplicativos e clique

em Web App WARs.A página Aplicativos da Web Instalados é aberta.

3. Localize a entrada para /pmpsvc na coluna Localizador Uniforme de Recursose clique em Desinstalar.

4. Clique em OK para confirmar a desinstalação.O WebSphere exibe a seguinte mensagem quando concluir:Aplicativo desinstalado

default/pmpsvc

Importando Aplicativos da Versão Atual de Volta para a VersãoAtual do Cognos TM1 Applications

É possível importar um aplicativo exportado do IBM Cognos TM1 Applications devolta para o IBM Cognos TM1 Applications.

Procedimento1. Abra o portal Cognos TM1 Applications.2. Clique no botão Importar Aplicativo.3. Selecione o servidor Cognos TM1 no qual deseja importar o aplicativo.4. Próximo do campo Arquivo de Aplicativo, clique em Navegar.5. Navegue para o arquivo de aplicativo (.zip) e clique em Abrir.6. Selecione a opção Importar Segurança do Aplicativo se quiser importar

configurações de segurança com o aplicativo.7. Selecione a opção Importar Propriedades do Aplicativo se quiser importar

configurações de propriedades com o aplicativo.8. Clique em Importar.


Apêndice A. Recursos de Acessibilidade

Os recursos de acessibilidade ajudam os usuários que têm deficiências físicas comomobilidade reduzida ou visão limitada a usar produtos de tecnologia dainformação.

Consulte o IBM Accessibility Center para obter mais informações sobre ocompromisso que a IBM tem com a acessibilidade.

O IBM Accessibility Center está disponível on-line em http://www.ibm.com/able.

Atalhos de Teclado para o 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.

Ação Tecla de Atalho

Mover para o próximo campo em uma página Guia

Mover para o campo anterior em uma pá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ção anterior 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.


Mover para o próximo campo em umapágina

Guia

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

Mover para a seleção anterior em uma lista Seta para cima


http://www.ibm.com/able

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.


Aceitar o contrato de licença Alt+A

Recusar o acordo de licença Alt+D

Encerrar o assistente de instalação Alt+x

Atalhos de Teclado para o Cognos ConfigurationOs atalhos de teclado, ou teclas de atalho, oferecem um método mais fácil enormalmente mais rápido para navegar e usar o software

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 tarefas principais no IBM Cognos Configuration no sistemaoperacional Windows.


Salvar a configuração atual Crtl+S

Fechar o 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 tarefas principais no Cognos Configuration no sistema operacionalUNIX ou Linux.


Salvar a configuração atual Guia

Fechar o Cognos Configuration Shift+Tab

Renomear o item selecionado Alt+F4


Apêndice B. O Arquivo de Configuração do Servidor Tm1s.cfg

O arquivo Tm1s.cfg é um arquivo ASCII que especifica informações do ambientepara um servidor IBM Cognos TM1 .

Um arquivo Tm1s.cfg padrão é criado no diretório de dados do servidor CognosTM1 quando você instala uma cópia do servidor Cognos TM1 . A maioria dosparâmetros disponíveis é documentada no arquivo de configuração. Se umparâmetro não é instalado por padrão, ele tem a linha comentada no arquivo deconfiguração. É possível editar o arquivo Tm1s.cfg para refletir o ambiente doservidor remoto associado removendo o comentário do parâmetro que deseja usare configurando o valor correto.

Para obter uma listagem alfabética de todos os parâmetros no arquivo deconfiguração do servidor, consulte “Parâmetros no Arquivo Tm1s.cfg” na página232.

Local do Arquivo Tm1s.cfgO local do arquivo Tm1s.cfg depende do tipo de servidor que está sendo usado.v Se estiver usando a ferramenta IBM Cognos Configuration para iniciar e parar

seus servidores IBM Cognos TM1, será possível visualizar o caminho deconfiguração para um servidor Cognos TM1 clicando no nome do servidor naárvore do Explorer do Cognos Configuration.

v Se estiver executando o servidor remoto Cognos TM1 como um serviço doMicrosoft Windows (Tm1sd.exe), e você usou o programa de instalação doCognos TM1 para instalar o servidor, o sistema usará o arquivo Tm1s.cfg queestá localizado no diretório de dados do servidor especificado durante ainstalação.

v Se estiver executando o servidor remoto Cognos TM1 como umaplicativoWindows (Tm1s.exe), especifique o local do arquivo Tm1s.cfg usando oparâmetro -z na linha de comandos quando você iniciar o servidor, a partir deum atalho ou de um prompt de comandos.Por exemplo, este comando especifica que o Cognos TM1 usará o arquivoTm1s.cfg localizado no diretório c:\salesdata:c:\ProgramFiles\Cognos\TM1\bin\tm1s.exe -z c:\salesdata

Se o parâmetro -z apontar para um diretório contendo espaços, será necessáriocolocar o diretório entre aspas duplas. Por exemplo, -z "c:\sales data".

v Se estiver executando um servidor Cognos TM1 no UNIX, e você usou oprograma de instalação do Cognos TM1 para instalar o servidor, o sistema usaráo arquivo Tm1s.cfg que está localizado no diretório de dados do servidorespecificado durante a instalação.

Arquivo Tm1s.cfg de AmostraEste é um arquivo Tm1s.cfg de amostra.

Seu arquivo tm1s.cfg também pode incluir comentários que descrevem osparâmetros.#Security mode


#(there are typically some information comments here.)

[TM1S]

ServerLogging=F

SecurityPackageName=Kerberos


UseSSL=T

ServerName=Planning Sample

DataBaseDirectory=C:\Program Files\Cognos\TM1\Custom\TM1Data\PlanSamp\

AdminHost=xxxxxxxx

PortNumber=12345

ClientMessagePortNumber= 5433

Language=ENG

SaveTime=

DownTime=

ProgressMessage=True

AuditLogOn=F

AuditLogMaxFileSize= 100 MB

AuditLogUpdateInterval=60

#ServerCAMURI=http://L3L0833-6457A26:9300/p2pd/servlet/dispatch

#ClientCAMURI=http://L3L0833-6457A26/cognos8/cgi-bin/cognos.cgi

#ClientPingCAMPassport=900

#Optional CAM parameters

#CAMSSLCertificate=

#CAMSSLCertRevList=

#SkipSSLCAMHostCheck=TRUE

#SkipSSLCAMHostCheck=TRUE

Parâmetros no Arquivo Tm1s.cfgOs parâmetros no arquivo Tm1s.cfg são descritos aqui.

Parâmetro Dinâmico

Os valores de parâmetros dinâmicos podem ser editados enquanto o servidor IBMCognos TM1 está em execução.

O servidor Cognos TM1 pesquisa continuamente o arquivo Tm1s.cfg em intervalosde 60 segundos para determinar se quaisquer valores de parâmetros dinâmicosforam alterados. Se o servidor detectar uma mudança no valor de parâmetro, onovo valor será aplicado imediatamente. Os parâmetros dinâmicos sãoidentificados com uma instrução que descreve-os como "dinâmicos" nesta lista.

Parâmetro Estático

Os valores de parâmetros estáticos são lidos a partir do arquivo Tm1s.cfg somentequando o servidor IBM Cognos TM1 é iniciado. Se desejar alterar um valor deparâmetro estático, você deverá encerrar o servidor Cognos TM1 , editar o valor noarquivo Tm1s.cfg e, em seguida, reiniciar o servidor.

A maioria dos parâmetros no arquivo Tm1s.cfg são estáticos.


Espaços em Valores

Se um valor de parâmetro contiver espaços, coloque os valores de parâmetro entreaspas duplas.

AdminHostEspecifica o nome do computador ou endereço IP do Host Admin no qual oServidor Administrativo está em execução.

Tipo de parâmetro: obrigatório, estático

Para especificar diversos Hosts Administradores, separe cada nome de host comum ponto e vírgula ao executar no Microsoft Windows ou usando dois pontos aoexecutar em um UNIX. Por exemplo:v Use o formato AdminHost=hostname1;hostname2 em um servidor Windows

Cognos TM1 .v Use o formato AdminHost=hostname1:hostname2 em um servidor UNIX Cognos

TM1 .

Alguns outros exemplos incluem:v AdminHost=boston;newyork

v AdminHost=192.168.1.17;192.168.1.22

v AdminHost=boston;192.168.1.17;192.168.1.22;myserver;192.168.1.40

Nota: A sequência que especifica o(s) host(s) administrador(es) está limitada a 1020caracteres ou bytes.

AllowReadOnlyChore RescheduleFornece aos usuários acesso READ a uma tarefa de organização de processos, e acapacidade para ativar, desativar e replanejar tarefas de organização de processos.


Quando a linha AllowReadOnlyChoreReschedule=T for incluída no arquivoTm1s.cfg para um servidor, os usuários com acesso READ a uma tarefa deorganização de processos poderão clicar com o botão direito do mouse em umatarefa de organização de processos no Server Explorer e alternar a opção AtivarProgramação ou escolher a opção Editar Tarefa de Organização de Processos. Aopção Editar Tarefa de Organização de Processos estará disponível apenas quandouma tarefa de organização de processos não estiver ativada.

Quando um usuário com acesso READ a uma tarefa de organização de processosselecionar a opção Editar Tarefa de Organização de Processos, apenas a tela deprogramação do Assistente de Configuração de Tarefa de Organização de Processosserá aberta.

A tela de programação permite que o usuário defina parâmetros de programaçãopara a tarefa de organização de processos, mas não permite que o usuário edite alista de processos que formam a tarefa de organização de processos.

AllowSeparateNandCRulesQuando ativado, este parâmetro permite especificar expressões de regra para osníveis N: e C: em linhas separadas usando definições de ÁREA idênticas.

Apêndice B. O Arquivo de Configuração do Servidor Tm1s.cfg 233


Por exemplo,[’Budget’,’Argentina’]=N:Expression;

[’Budget’,’Argentina’]=C:Expression;

são instruções de regra válidas ao incluir o parâmetro AllowSeparateNandCRulesno arquivo Tm1s.cfg e definir como T.

Este parâmetro também causa efeito sobre como as regras numéricas e desequência são aplicadas às células. Sem esse parâmetro, a primeira instrução daregra, que é encontrada para um determinada definição de ÁREA, é aplicada àscélulas dentro do escopo dessa definição. Se qualquer célula dentro da definição deÁREA for numérica e a regra for uma regra de sequência, a célula será consideradanão derivada porque houve uma correspondência que não foi aplicada a ela.

Por exemplo, considere as instruções:[’1 Quarter’]=s:’str_value’;Not following.

[’1 Quarter’]=n:77;

Se o parâmetro AllowSeparateNandCRules não estiver configurado (ou estiverconfigurado como F), a primeira instrução de regra corresponderá a qualquercélula que usa '1 Trimestre' como um de seus elementos. Se a célula for uma célulade sequência, o valor da célula será configurado como 'str_value'. Se a célula foruma célula numérica, ela não será considerada regra derivada, pois umacorrespondência não foi localizada (a primeira regra), mas a própria regra não foiaplicada.

Se o parâmetro AllowSeparateNandCRules for configurado como T, as células desequência que usam '1 Trimestre' serão configuradas como 'str_value' e as célulasnuméricas que usam '1 Trimestre' serão configuradas como 77.

Para definir o parâmetro como T, inclua a seguinte linha no Tm1s.cfg:AllowSeparateNandCRules=T

AllRuleCalcStargateOptimizationO parâmetro AllRuleCalcStargateOptimization pode melhorar o desempenho nocálculo de visualizações que contêm apenas valores calculados por regras.


Geralmente, o Cognos TM1 executa cálculos para consolidações padrão e, emseguida, calcula valores para consolidações baseadas em regras, que podem acabarsubstituindo valores nas consolidações padrão. O parâmetroAllRuleCalcStargateOptimization fornece otimização que primeiro verifica se cadavalor na visualização é calculado por regras e, em seguida, prossegue da seguinteforma:v Se cada valor na visualização for calculado pela regra, o Cognos TM1 ignorará

os cálculos desnecessários para consolidações padrão e executará somente asconsolidações calculadas pela regra.

v Se a visualização contiver apenas um único valor que não seja calculado porregras, este parâmetro de otimização não terá nenhum efeito.


Quando este parâmetro estiver definido como True, ocorrerá algum processamentoadicional para cada visualização solicitada, para primeiro verificar se a visualizaçãocontém apenas valores calculados por regras. Para a maioria das visualizações, esteprocessamento adicional é mínimo, devido a otimização parar quando o primeirovalor na visualização é considerado como não calculado por regras.

Para ativar este parâmetro, configure o valor do parâmetro como T no arquivo deconfiguração do servidor Cognos TM1 , Tm1s.cfg, conforme a seguir:AllRuleCalcStargateOptimization=T

A configuração padrão é desativado (F).

AuditLogMaxFileSizeIndica o tamanho máximo do arquivo que um arquivo de log de auditoria pode terantes de ser fechado e criado um novo arquivo.

Tipo de parâmetro: opcional dinâmico

Este valor deve incluir unidades de KB (kilobytes), MB (megabytes) ou GB(gigabytes). Por exemplo, para limitar o tamanho do arquivo de log a 100 MB,insira o seguinte:

AuditLogMaxFileSize=100 MB

O intervalo de valores inclui:v Valor-padrão: 100 MBv Valor mínimo: 1 KBv Valor máximo: 2 GB

AuditLogMaxQueryMemoryIndica a quantidade máxima de memória que o IBM Cognos TM1 pode usar aoexecutar uma consulta de log de auditoria e recuperar o conjunto de resultados.


Este valor deve incluir unidades de KB (kilobytes), MB (megabytes) ou GB(gigabytes). Por exemplo:

AuditLogMaxQueryMemory=100 MB


AuditLogMaxTempFileSizeIndica o tamanho máximo do arquivo que o arquivo de log de auditoriatemporário pode crescer antes de o Cognos TM1 mover os dados do arquivo parao log de auditoria final.



Este valor deve incluir unidades de KB (kilobytes), MB (megabytes) ou GB(gigabytes). Por exemplo:AuditLogMaxTempFileSize=100MB


AuditLogOnAtiva (T) ou desativa (F) a criação de log de auditoria.


Por exemplo:v Para ativar a criação de log de auditoria, configure AuditLogOn=T

v Para desativar a criação de log de auditoria, defina AuditLogOn=F

A configuração padrão é F.

AuditLogUpdateIntervalIndica a quantidade máxima de tempo, em minutos, que o IBM Cognos TM1espera antes de mover os eventos do arquivo de auditoria temporário para o logde auditoria final.


Por exemplo:

AuditLogUpdateInterval=60

O valor-padrão é 60 (sessenta minutos).

O valor mínimo é 1 (um minuto).

Nota: É possível atualizar manualmente o log de auditoria com os eventos maisrecentes a qualquer momento que desejar usando o comando Processar Eventos deLog de Auditoria no Server Explorer. Para obter detalhes, consulte "Atualizando oLog de Auditoria com os Eventos Mais Recentes" no Guia de Operações do IBMCognos TM1 .

CalculationThresholdForStorageDefine um número mínimo de cálculos de regra necessários para uma única célulaou visualização Stargate, além do qual o servidor IBM Cognos TM1 armazena oscálculos para uso durante a sessão do servidor atual.


Por exemplo, quando um usuário solicita valores derivados da regra a partir doservidor Cognos TM1 , a partir de uma única célula ou uma visualização Stargate,o servidor geralmente precisa executar diversos cálculos de regra para chegar nosvalores derivados da regra solicitados.


CalculationThresholdForStorage tem um efeito direto no consumo de memória eno desempenho. Um valor de parâmetro alto resulta em menor consumo dememória e desempenho mais lento. Um valor de parâmetro baixo resulta em maiorconsumo de memória e desempenho mais rápido.

Se você não incluir CalculationThresholdForStorage no Tm1s.cfg, o limite decálculo inclusão será 50.

CAMSSLCertificateO caminho completo e nome do certificado SSL a ser usando durante a conexãocom o dispatcher interno.

Por exemplo, C:\AxTM1\Install_Dir\ssl\CognosCert.cer.

Tipo de parâmetro: estático

Necessário somente quando o servidor CAM é configurado para usar SSL.

CheckFeedersMaximumCellsLimita o número de células verificadas pela opção Alimentadores de Verificação noCube Viewer.

CheckFeedersMaximumCells é um parâmetro opcional que pode ser incluído noTm1s.cfg. Se este parâmetro não for incluído no Tm1s.cfg, os Alimentadores deVerificação verificarão 3.000.000 de células, por padrão.


Quando o Cognos TM1 verifica alimentadores a partir de uma célula altamenteconsolidada, ele deve verificar todas as intersecções que se aplicam à célula. Emaplicativos grandes, o servidor Cognos TM1 estará indisponível por umaquantidade significativa de tempo enquanto o Cognos TM1 está verificando todasas intersecções.

Para limitar o número de células verificadas ao usar Alimentadores de Verificação(o que, por sua vez, limita a quantidade de tempo que o servidor Cognos TM1 ficaindisponível), inclua CheckFeedersMaximumCells em Tm1s.cfg e configure oparâmetro com o número de células que deseja verificar.

Por exemplo, para limitar Alimentadores de Verificação a 1.000.000 de células,insira a seguinte linha:

CheckFeedersMaximumCells=1,000,000

ClientCAMURIO URI para o IBM Cognos Server IBM Cognos Connection usado para autenticarclientes Cognos TM1 .


O URI é especificado no formato http[s]://<host>/cognos8/cgi-bin/cognos.cgi.

Por exemplo, http://10.121.25.121/cognos8/cgi-bin/cognos.cgi


ClientPingCAMPassportIndica o intervalo, em segundos, em que um cliente deve executar ping noservidor CAM para manter seu passaporte ativo.


Se ocorrer um erro ou o passaporte expirar, o usuário será desconectado doservidor Cognos TM1 .

CAMPortalVariableFileO caminho para o arquivo variables_TM1.xml na instalação do IBM Cognos.

Tipo de parâmetro: Necessário para interoperabilidade do IBM Cognos, estático.

O parâmetro CAMPortalVariableField é necessário somente ao usar o IBM CognosBusiness Intelligence (BI) com o Cognos TM1 Web e o Cognos TM1 Server.

Configure este parâmetro com um caminho relativo conforme a seguir:

CAMPortalVariableFile=portal\variables_TM1.xml

Nota: O local do arquivo exato no servidor IBM Cognos BI é:Cognos_location\templates\ps\portal\variables_TM1.xml.

O arquivo variables_TM1.xml é incluído como parte da instalação do IBM CognosTM1 BI Interoperability (Viewer Portlets). Para obter detalhes, consulte Capítulo 14,“Instalação de Interoperabilidade do Cognos TM1 e do Cognos BusinessIntelligence”, na página 139.

ClientMessagePortNumberIdentifica uma porta secundária usada para aceitar mensagens de clientesrelacionadas ao progresso e ao último cancelamento de uma operação longa, semcomprometer as reservas de encadeamento.

Tipo de parâmetro: opcional estático para mudanças/configuração dinâmica

Se nenhum número da porta for especificado no arquivo de configuração, onúmero da porta será escolhido dinamicamente e definido na inicialização doservidor. No entanto, ele não pode ser alterado durante a execução do servidor.

Esta porta adicional assegura que nenhuma outra solicitação do servidor poderácontinuar o processamento durante a espera de um cancelamento do usuário.

Por padrão, este número da porta é designado automática e dinamicamentequando o servidor Cognos TM1 inicia. Não é necessário definirClientMessagePortNumber para um número específico, a menos que firewalls ououtros problemas de rede exijam que a porta listener seja um númerobem-conhecido.

CUIDADO:Certifique-se de designar números de portas exclusivos para as portas demensagens do servidor e do cliente. Se você tiver dois servidores em execução namesma máquina com o mesmo número da porta, a atividade de mensagempoderá causar uma falha do sistema.


Consulte também “PortNumber” na página 260 e “ProgressMessage” na página261.

ClientPropertiesSyncIntervalEspecifica a frequência (em segundos) na qual propriedades do cliente sãoatualizadas no cubo de controle de }ClientProperties. Configure como 1800segundos para atualizar o cubo a cada 30 minutos.

A atualização frequente pode causar consumo desnecessário de tempo de CPU epode causar a conexão/desconexão de usuários até a conclusão da operação.


ClientVersionMaximumEspecifica a versão cliente máxima que pode se conectar ao servidor TM1 .


O valor de parâmetro ClientVersionMaximum é expresso como uma sequência deversões que usa o seguinte formato:

m.n.tffhh

m = número da liberação principal,

n = número da liberação secundária

t = número da liberação de manutenção

ff = número do fix pack

hh = número do hot fix

Usando este formato, a configuração do ClientVersionMaximum = 9.4.10305especifica que a versão cliente máxima que pode se conectar ao servidor é 9.4.1.

Se o arquivo Tm1s.cfg não incluir um valor de parâmetro ClientVersionPrecision,apenas o número da liberação principal, o número da liberação secundária e onúmero da liberação de manutenção serão usados para impor a compatibilidadeentre o cliente e o servidor. Usando o exemplo acima,

Se ClientVersionMaximum não for configurado explicitamente, o valor-padrão seráigual à versão do servidor instalado atualmente.

Os valores de parâmetro válidos estão no intervalo de x00 - versão do servidorinstalada atualmente, em que x é a versão base do servidor TM1 instaladoatualmente. Por exemplo, os valores de parâmetro válidos para o servidor TM1 9.0SP3 estão no intervalo de 900 a 903.

Não é possível definir ClientVersionMaximum como um valor maior que a versãodo servidor instalada no momento. Não é possível conectar versões clientes maisrecentes a versões do servidor mais antigas.


ClientVersionMinimumEspecifica a versão cliente mínima que pode se conectar ao servidor IBM CognosTM1 .


O valor de parâmetro ClientVersionMinimum é expresso como uma sequência deversões que usa o seguinte formato:

m.n.tffhh






Usando este formato, a configuração do ClientVersionMinimum = 9.4.10305especifica que a versão cliente mínima que pode se conectar ao servidor é 9.4.1.

Se o arquivo Tm1s.cfg não incluir um valor de parâmetro ClientVersionPrecision,apenas o número da liberação principal, o número da liberação secundária e onúmero da liberação de manutenção serão usados para impor a compatibilidadeentre o cliente e o servidor.

Se o parâmetro ClientVersionMinimum não estiver configurado explicitamente, ovalor-padrão será 8.4.00000, que corresponde à versão 8.4.

Você não deve configurar ClientVersionMinimum com um valor inferior à versãobase do servidor Cognos TM1 instalado atualmente. Não há um limite superiorpara ClientVersionMinimum. No entanto, se ClientVersionMinimum for maior queClientVersionMaximum, apenas os clientes com um número da versão igual aClientVersionMaximum poderão conectar-se ao servidor.

ClientVersionPrecisionEste parâmetro permite identificar mais precisamente as versões mínima e máximade clientes que podem se conectar ao servidor IBM Cognos TM1 .


Os valores de parâmetro ClientVersionMinimum e ClientVersionMaximum sãoexpressos como uma sequência de versões que usa o seguinte formato:

m.n.tffhh







Usando este formato, a sequência de versões 9.4.10305 indicará a liberaçãoprincipal 9, a liberação secundária 4, a liberação de manutenção 1, fix pack 3 e hotfix 5.

Se ClientVersionPrecision não for configurado no Tm1s.cfg ou se estiverconfigurado como 0, apenas o número da liberação principal, o número daliberação secundária e o número da liberação de manutenção serão usados paraimpor a compatibilidade entre o cliente e o servidor. Neste caso, qualquer clienteda liberação principal 9, liberação secundária 4, liberação de manutenção 1 e maisrecente poderão se conectar ao servidor.

É possível impor a compatibilidade da versão cliente e do servidor mais precisaincluindo ClientVersionPrecision no arquivo Tm1s.cfg e configurando o parâmetropara um dos seguintes valores.v 1 - Indica que o número do fix pack será imposto, mas não o número do hot fix.v 2 - Indica que o número do fix pack e o número do hot fix serão impostos.

Exemplos

Se ClientVersionMinumum = 9.4.10305 e ClientVersionPrecision = 1, apenas osclientes da liberação principal 9, liberação secundária 4, pacote de manutenção 1,fix pack 3 ou posterior poderão se conectar ao servidor. Neste caso, o número dohot fix não será imposto ao determinar a compatibilidade entre servidor/cliente.

Se ClientVersionMinumum = 9.4.10305 e ClientVersionPrecision = 2, apenas osclientes da liberação principal 9, liberação secundária 4, pacote de manutenção 1,fix pack 3, hot fix 5 ou posterior poderão se conectar ao servidor. Neste caso, osnúmeros do fix pack e do hot fix serão impostos ao determinar a compatibilidadeentre servidor/cliente.

CognosInterfacePathEspecifica o local do servidor IBM Cognos Business Intelligence para usar aoimportar dados de um Pacote Cognos para o TM1 usando o IBM Cognos TM1Package Connector.

Consulte o Guia do IBM CognosTM1 TurboIntegrator para obter informaçõesadicionais.

Tipo de Parâmetro:estático, opcional/necessário somente ao usar o Cognos TM1Package Connector.

DataBaseDirectoryEspecifica o diretório de dados a partir do qual o servidor carrega cubos,dimensões e outros objetos.

É possível listar vários diretórios de dados, separando-os com pontos e vírgulas.

Tipo de parâmetro: obrigatório, estático

Para obter detalhes, consulte “Visão Geral do Diretório de Dados” na página 27.


DefaultMeasuresDimensionIdentifica se uma dimensão das medidas é criada. O IBM Cognos TM1 não requerque uma dimensão das medidas seja definida para um cubo. Opcionalmente, épossível definir uma dimensão das medidas, modificando as propriedades docubo.

Para obter informações adicionais, consulte o tópico, "}CubeProperties", no Guia deOperações do IBM Cognos TM1 .

Tipo de parâmetro: opcional, mas alguns aplicativos OLAP podem requerer esseparâmetro (consulte a descrição abaixo para obter detalhes), estático

Alguns aplicativos OLAP requerem a presença de uma dimensão de medidas emtodos os cubos, e poderão falhar se essa dimensão não estiver presente. Paraacomodar estes aplicativos, configure DefaultMeasureDimension=T para instruir oservidor Cognos TM1 para definir automaticamente a última dimensão em umcubo como a dimensão das medidas quando um novo cubo é criado no servidorCognos TM1 .

Se DefaultMeasureDimension for definido como F ou omitido de Tm1s.cfg, umadimensão das medidas não será definida para quando um cubo for criado.

DisableMemoryCacheDesativa o cache de memória usado pelo gerenciador de memória do IBM CognosTM1 .


Ative este parâmetro apenas para depurar fugas de memória. Ao ativar esteparâmetro, pode ocorrer uma redução no desempenho do servidor.

Por exemplo, quando o DisableMemoryCache=T é configurado, ele desativa o cachede memória usado pelo gerenciador de memória do IBM Cognos TM1 . Aconfiguração padrão é DisableMemoryCache=F.

DisableSandboxingDetermina se os usuários podem usar ambientes de simulações no servidor.


Por padrão, este parâmetro não está presente no arquivo de configuração que ativao recurso ambiente de simulação para todos os usuários.DisableSandboxing=F

Quando a criação de ambiente de simulação é ativada desta maneira, osadministradores podem Negar ou Conceder o uso de Áreas de Trabalho Pessoaisou diversos ambientes de simulação em uma base por grupo de usuários usandoDesignações de Capacidade. Para obter mais detalhes, consulte "Designações deCapacidade" no Guia de Operações do IBM Cognos TM1 .

Para colocar todos os grupos de usuários no modo Writeback Direto, inclua aseguinte linha no Tm1s.cfg:DisableSandboxing=T


Quando DisableSandboxing=T, as Designações de Capacidade são ignoradas.

DisableWorksheetViewDisableWorksheetView desativa as funções VIEW contidas em planilhas da fatia.

As planilhas da fatia que contêm uma função VIEW permanecem funcionais, mas afunção não gera uma visualização Stargate.


Entre em contato com o suporte ao cliente para determinar se esse parâmetro éaplicável a seu sistema.

De modo geral, você deve desativar as funções VIEW da planilha quando trabalharcom dimensões de linha ou de coluna extremamente grandes em planilhas da fatia.A função VIEW gera uma visualização Stargate que contém todos os elementos dedimensão de linha e de coluna, e não apenas os elementos contidos nossubconjuntos de linhas e de colunas atuais. Com a visualização Stargate, é possívelque ocorra uma redução no desempenho quando, por exemplo, uma dimensão dalinha contiver 9.000 elementos, mas apenas 20 elementos forem realmente usadosno subconjunto de linhas.

Para desativar as funções VIEW de planilha da fatia, inclua a seguinte linha noTm1s.cfg:

DisableWorksheetView=T

Display_Info_DBType_R8Display_Info_DBType_R8 instrui o servidor IBM Cognos TM1 a armazenar dadosda coluna DISPLAY_INFO como DBTYPE_R8.


Entre em contato com o suporte ao cliente para determinar se este parâmetro éaplicável ao seu sistema Cognos TM1 .

Por padrão, o Cognos TM1 armazena DISPLAY_INFO como DBTYPE_UI4. Quandoo provedor OLE DB do Cognos TM1 processa uma solicitação do ADO 2.7 para osdados da coluna DISPLAY_INFO, o provedor precisa converter os dados da colunaCognos TM1 de DBTYPE_UI4 para um DBTYPE_R8. O provedor OLE DB doCognos TM1, então, retorna os dados da coluna convertidos para o cliente OLE DB(ADO neste caso).

O ADO 2.7 espera que IRowset::GetData retorne um número inteiro e usa apenasos primeiros 4 bytes dos dados da coluna convertidos. No entanto, os dadosretornados são um número real de 8 bytes e, por isso, todas as informações nosúltimos 4 bytes são perdidas. Isto faz o ADO 2.7 retornar zeros para todos os itensda coluna DISPLAY_INFO.

Quando você inclui o parâmetro Display_Info_DBType_R8 no arquivo Tm1s.cfg econfigura o parâmetro como T, o servidor Cognos TM1 armazena os dados dacoluna DISPLAY_INFO como DBTYPE_R8 com os 4 bytes relevantes deinformações nos primeiros 4 bytes. O parâmetro Display_Info_DBType_R8 asseguraque as informações não serão perdidas quando o ADO converter os dados de voltapara um número inteiro de 4 bytes. O parâmetro também assegura que o ADO 2.7


retornará os valores corretos para as propriedades de um membro do conjunto delinhas do eixo. Além disso, o parâmetro assegura que qualquer cliente OLE DB(como o ADO 2.6) que esteja solicitando a propriedade DISPLAY_INFO como umvalor de 4 bytes obterá os valores corretos.

DistributedPlanningOutputDirDistributedPlanningOutputDir define o diretório no qual TUnits são gravadasquando um aplicativo distribuído do Cognos Insight é implementado.


Os clientes distribuídos do Cognos Insight distributed precisam de informaçõeschamadas "tunits". Estes dados são criados quando um aplicativo é implementadoe são atualizados conforme o servidor Cognos TM1 é executado. O local dodiretório usado para este propósito é configurado usando este parâmetro.

Para implementar os aplicativos clientes distribuídos do Cognos Insight usandoeste banco de dados, remova o comentário ou inclua este parâmetro comoDistributedPlanningOutputDir=<location of the tunit directory>.

O nome do caminho especificado pode ser absoluto ou relativo para o diretório dedados do servidor Cognos TM1.

Por exemplo:

Configuração de Amostra Ação

DistributedPlanningOutputDir=tunit Cria um diretório tunit sob o diretório dedados do servidor Cognos TM1.

DistributedPlanningOutputDir=../tunit Cria um diretório tunit como um irmão nodiretório de dados do servidor Cognos TM1.

DistributedPlanningOutputDir=C:\ProgramFiles\IBM\cognos\tm1\samples\tm1\GO_New_Stores\tunit

Cria um diretório tunit no localespecificado.

DownTimeEspecifica um período em que o servidor ficará inativo automaticamente.


O formato do parâmetro DownTime é dd:hh:mm, em que:v dd é o número de dias a partir de hoje. (Por exemplo, 00 é hoje e 01 é amanhã.)v hhmm é a hora do dia em formato de 24 horas.

Por exemplo, DownTime = 01:03:30 especifica que você deseja desativar o servidorno dia seguinte às 3h30 da manhã.

O parâmetro DownTime não está disponível quando você executa o servidorCognos TM1 como um serviço do Windows.

Ao usar o parâmetro DownTime no servidor UNIX Cognos TM1 , você deveconfigurar o parâmetro RunningInBackground como T. Se RunningInBackground=F,o servidor solicitará a confirmação antes de encerrar e não poderá ser encerradosem confirmação manual de um administrador.


ExcelWebPublishEnabledAtiva a publicação dos arquivos Microsoft Excel no IBM Cognos TM1 Web, bemcomo a exportação de arquivos Excel do Cognos TM1 Web, quando o Excel nãoestá instalado no Web Server.


Se ExcelWebPublishEnabled=T, os arquivos Excel no Cognos TM1 Applicationspodem ser publicados no Cognos TM1 Web sem usar Excel no servidor da web. Demodo semelhante, planilhas da websheets e Cubeviewers podem ser exportados doCognos TM1 Web em usar Excel no servidor da web.

Quando Excel não está disponível no servidor da web, os arquivos Excel noCognos TM1 Applications devem ser publicados explicitamente no Cognos TM1Web.

Para obter detalhes sobre o procedimento necessário para publicar arquivos Excel,consulte o IBM Cognos TM1 Developer Guide.

Para obter detalhes sobre limitações ao exportar do Cognos TM1 Web sem usarExcel no servidor da web, consulte o Guia do Usuário do IBM Cognos TM1 .

Restrição: Não é possível publicar arquivos .xlsx do Excel 2007 no Cognos TM1Web quando o Excel não está disponível no servidor da web. Estes arquivos devemser salvos no formato .xls do Excel 2003 se desejar publicá-los no Cognos TM1Web.

ForceReevaluationOfFeedersForFedCellsOnDataChangeQuando este parâmetro é configurado, uma instrução do alimentador é forçada aser reavaliada quando os dados mudam.


Quando o IBM Cognos TM1 Server calcula alimentadores, o processo pode seruma "cadeia" de alimentadores, em que a célula A alimenta a célula B, e há umaregra de alimentador para a célula B, de modo que a regra execute e alimente acélula C, etc. Os alimentadores para células numéricas só são avaliados quandouma célula muda do valor vazio para algum valor diferente de zero, já quequalquer valor diferente de zero na célula já teria configurado quaisqueralimentadores.

Não é necessário reavaliar os alimentadores quando uma célula muda de um valordiferente de zero para outro.

Normalmente, durante a avaliação de alimentadores, se uma regra de alimentadoré avaliada e a célula de destino já foi alimentada, o processo de alimentação para.

As regras de alimentadores não são mais processadas porque a presença doalimentador na célula de destino indica que as regras de alimentador para a célulade destino já foram executadas e não é necessário executá-las novamente.

Considere as seguintes regras de alimentador:['A’]=>['B’];


A regra de alimentador para a célula B depende de alguns valores de dados docubo:[B]=>DB(cube-name,!dim1,DB(cube2-name,...),!dim2);['C’]=>['D’];['X’]=>['B’];

Quando a regra de alimentador para B é avaliada inicialmente, oDB(cube2-name,...) é avaliado para produzir um nome de elemento, como C.Portanto, B alimenta C, e depois C alimenta D. Quando essa célula X muda de zeropara não zero. Essa mudança também alimenta B. Mas B já está alimentado,portanto, o processo de alimentação para e a regra de alimentador para B nunca éavaliada, assim, nenhuma "mudança" na saída da regra, que pode ocorrer devido auma mudança de dados subjacente direcionada pela instrução DB(...), seráavaliada. Se o parâmetro de configuraçãoForceReevaluationOfFeedersForFedCellsOnDataChange estiver configurado, apresença de um alimentador na célula B não finalizará o processamento doalimentador. Em vez disso, a regra do alimentador para B será executada. Como aregra do alimentador para B é dependente de dados, o destino para o alimentadorpode ser o antigo C ou pode ser alguma outra célula, e essa célula será alimentada.Observe que a configuração desse parâmetro forçará mais avaliações doalimentador, que podem ter um impacto no desempenho.

Para ativar esse parâmetro, configureForceReevaluationOfFeedersForFedCellsOnDataChange=T.

Em uma liberação anterior, esse parâmetro era chamadoReevaluateConditionalFeeders

GroupsCreationLimitConfigura o número máximo de grupos que podem ser criados em uma sessão doservidor IBM Cognos TM1 .


O parâmetro GroupsCreationLimit aceita um valor de qualquer número inteiropositivo. O número máximo de grupos para GroupsCreationLimit é 65535. Onúmero máximo de grupos que podem existir em um servidor é 65535. Se vocênão usar o parâmetro, o número padrão de grupos será 20.

Por exemplo, para criar 50 grupos por sessão do servidor, insira a seguinte linha:GroupsCreationLimit=50

Dica: Quando o Cognos TM1 aloca a memória para armazenar informações desegurança, o servidor calcula a quantidade de memória necessária com base, emparte, no valor de GroupsCreationLimit. Em algumas circunstâncias, quando seumodelo Cognos TM1 for grande e o parâmetro GroupsCreationLimit forconfigurado com um valor excepcionalmente alto, o servidor tentará alocarmemória além da capacidade disponível no servidor. O servidor Cognos TM1falhará em carregar e emitirá uma mensagem Servidor Sem Memória. Para evitaresta situação, defina GroupsCreationLimit como um valor que reflita com precisãoo número máximo de grupos de usuários que podem ser criados durante umasessão do servidor.

O valor GroupsCreationLimit não é aplicado quando você cria grupos com afunção AddGroup no TurboIntegrator.


IdleConnectionTimeOutSecondsEspecifica um limite de tempo limite para conexões do cliente inativas, emsegundos.


Por exemplo, se você incluir a seguinte linha no Tm1s.cfg, o servidor desconectaráas conexões do cliente inativas após 900 segundos.IdleConnectionTimeOutSeconds=900

IntegratedSecurityModeEste parâmetro configura o modo de autenticação do usuário a ser usado peloservidor IBM Cognos TM1 .


Embora o nome do parâmetro se concentre no Modo de Segurança Integrado, asconfigurações 2, 3 e 4 são usadas para configurar outros tipos de segurança.

Use o seguinte formato para definir este parâmetro:

IntegratedSecurityMode=x

em que x pode ser um valor para um dos seguintes modos de segurança.

Cognos Business Intelligence 8 e 10 são suportados.

Modo de Segurança Descrição

1 O servidor usa o modo seguro (segurança do Cognos TM1 padrão).

Com esta autenticação, o servidor Cognos TM1 verifica o nome deusuário e a senha com relação aos nomes de usuário e senhas nobanco de dados Cognos TM1 .

2 Este modo permite voltar e avançar alternadamente entre o loginintegrado e a segurança do Cognos TM1 nativa.

3 O servidor usa o Login Integrado.

O Login Integrado usa a autenticação de rede do Microsoft Windowspara controlar o acesso aos dados do Cognos TM1 .

Se você usar este modo de segurança, também deverá definir oparâmetro “SecurityPackageName” na página 265.

Para obter detalhes adicionais, consulte “Login Integrado” na página185.


Modo de Segurança Descrição

4 O servidor usa a autenticação de segurança do IBM Cognos BI.

Considerações ao usar este modo:

No Cognos TM1, os usuários do Cognos BI podem pertencersomente aos grupos do Cognos BI e a qualquer um dos três gruposde administradores internos do Cognos TM1 (ADMIN, DataAdmin eSecurityAdmin). A associação nos grupos de usuários do CognosTM1 (não administrador) não é suportada para usuários do CognosBI quando eles efetuam login no Cognos TM1 .

Não é possível usar o Cognos TM1 para designar permanentementeum usuário do Cognos BI para um outro grupo do Cognos BI.Qualquer designação de usuário feita no Cognos TM1 para umgrupo do Cognos BI não é salva de volta no Cognos BI. Quando umusuário do Cognos BI efetua login no Cognos TM1, as designaçõesde grupo no Cognos BI substituem quaisquer designações de grupodo Cognos BI feitas no Cognos TM1 .

5 O servidor usa a autenticação de segurança do IBM Cognos BI esuporta grupos de usuários do Cognos TM1 e do Cognos BI.

Use o modo de segurança 5 quando estiver executando o IBMCognos TM1 Applications com segurança do IBM Cognos BI.

Considerações ao usar este modo:

v No Cognos TM1, os usuários do Cognos BI podem pertencer aosgrupos do Cognos BI e do Cognos TM1 .

v Não é possível usar o Cognos TM1 para designarpermanentemente um usuário do Cognos BI para um outro grupodo Cognos BI. Qualquer designação de usuário feita no CognosTM1 para um grupo do Cognos BI não é salva de volta no CognosBI. Quando um usuário do Cognos BI efetua login no Cognos TM1, as designações do grupo no Cognos BI substituem quaisquerdesignações de grupo do Cognos BI feitas no Cognos TM1.

IPAddressEste parâmetro permite especificar diversos endereços IP para um servidor IBMCognos TM1 individual.

Por exemplo, um servidor pode usar um endereço IP para clientes em um firewalle um endereço IP diferente para clientes fora do firewall.


Nota: Quando este parâmetro é usado no arquivo Tm1s.cfg, o Cognos TM1 Servere o Servidor Administrativo devem ser executados no mesmo computador. Se esteparâmetro for usado no arquivo Tm1s.cfg, mas o Cognos TM1 Server e o ServidorAdministrativo residirem em computadores diferentes, os clientes Cognos CognosTM1 receberão um erro quando tentarem efetuar login no Cognos TM1 Server.

Se o Cognos TM1 Server e o Servidor Administrativo residirem em computadoresdiferentes, será possível configurar o Servidor Administrativo para usar diversos


endereços IP para um Cognos TM1 Server individual incluindo um arquivo deinicialização denominado Tm1admsrv.ini no diretório no qual o executável AdminServer reside.

A sintaxe para Microsoft Windows usa como separador de elemento um ponto evírgula, por exemplo, a configuração a seguir especifica dois endereços IP para oservidor TM1 :IPAddress="130.5.32.0; 130.5.64.0"

Atenção: Os endereços devem ser colocados entre um único conjunto de aspas eseparados por um ponto e vírgula.

Quando especificar vários endereços IP para um servidor, o ServidorAdministrativo associado reconhecerá todos os endereços, mas exibirá apenas oprimeiro endereço IP na janela do Servidor Administrativo.

A sintaxe para UNIX usa como separador de elementos um sinal de dois pontos.Por exemplo, IPAddress=130.5.32.0: 130.5.64.0

IPVersionEste parâmetro indica o protocolo da Internet usado pelo servidor IBM CognosTM1 para identificar endereços IP na rede.

Por exemplo, para especificar que sua rede usa protocolo IPV6, inclua o parâmetroIPVersion=ipv6 no arquivo tm1s.cfg.


As configurações válidas são:v ipv4

Configuração padrão. Usada para redes IPv4.v dual

Usada para transição de IPv4 para IPv6. Ambos os protocolos são suportados.v ipv6

Usada para redes IPv6.

Notas de Configuração

Se você configurar esse parâmetro como ipv6 ou dual, use a ferramenta CognosConfiguration para alterar a opção Suporte de IP do TM1 Admin Server pararefletir a mudança.

Para permitir que clientes reconheçam essa mudança, inclua e configure a variávelde ambiente TM1_IPVersion no sistema operacional como ipv6 ou dual.

A configuração deste parâmetro como dual ou IPV6 sem que a rede adequadaesteja em execução pode resultar na redução do desempenho.

Nota: Em alguns casos, dependendo do ambiente de rede e da configuração deDNS, talvez seja necessário incluir também o endereço IPv6 no arquivo do sistemaoperacional /etc/hosts no UNIX e Microsoft Windows para executar com sucessoo Cognos TM1 Admin Server e o Cognos TM1 Server no modo IPv6.


Para obter detalhes completos sobre a configuração de todos os componentes doCognos TM1 para usar IPv6, consulte “Configurando o Cognos TM1 para UsarIPv6” na página 154.

JobQueuingAtiva o enfileiramento para envios de Área de Trabalho Pessoal ou de Ambientede Simulação.


Configure este parâmetro como JobQueuing=T para que todos os envios doambiente de simulação sejam processados usando a Fila de Tarefas. Quando esseparâmetro for configurado como F ou não no arquivo de configuração, os enviosde ambiente de simulação não serão processados em uma fila.

Quando esse parâmetro for ativado, o ícone de envio será exibido na barra deferramentas.

Consulte a descrição de Enfileiramento de Tarefas no capítulo Ambiente deSimulação e Writeback do Guia do Usuário do IBM Cognos TM1 para obter regiãodetalhes.

JobQueueMaxWaitTimeQuando o encadeamento de fila é executado, ele bloqueia todas as solicitaçõesrecebidas para assegurar que possa obter os bloqueios necessários para processaruma tarefa na fila.

As novas solicitações são bloqueadas pela quantidade de tempo configurada noparâmetro JobQueueMaxWaitTime.


Padronizado como 100 ms.

Se as solicitações atualmente em execução não tiverem concluído neste momento, oencadeamento de fila voltará à retenção para JobQueueThreadSleepTime e assolicitações recebidas terão permissão para continuar.

Para fornecer ao encadeamento de fila maior prioridade, configureJobQueueMaxWaitTime com um número maior.

Se o parâmetro JobQueueMaxWaitTime estiver configurado como zero no arquivo deconfiguração e o Enfileiramento de Tarefas estiver ativado, a fila continuarátentando até poder processar, bloqueando efetivamente qualquer outra atividadeaté ser concluída.

Consulte Enfileiramento de Tarefas no Guia do Usuário do IBM Cognos TM1 paraobter mais detalhes.

JobQueueThreadPoolSizeO parâmetro JobQueueThreadPoolSize permite que o IBM Cognos TM1 usediversos encadeamentos para processar a Fila de Tarefas do Cognos TM1,fornecendo maior thru-put e processamento de solicitações do ambiente desimulação quando o servidor Cognos TM1 está configurado para usar Interação


Paralela. Quando o servidor não estiver sendo executado no modo de InteraçãoParalela, este parâmetro não terá efeito, e somente um único encadeamento seráusado para processar solicitações na Fila de Tarefas.


Por padrão, se este parâmetro não é configurado quando o servidor Cognos TM1está em execução no modo de Interação Paralela, o Cognos TM1 usa um valorigual a 1 e o servidor Cognos TM1 usa somente um encadeamento único paraprocessar solicitações na Fila de Tarefas.

Configure esse parâmetro no arquivo Tm1s.cfg usando o seguinte formato:

JobQueueThreadPoolSize=x

em que x representa o número de encadeamentos que deseja usar para processarsolicitações da Fila de Tarefas do Cognos TM1.

Por exemplo:

JobQueueThreadPoolSize=3

Por padrão, se este parâmetro não é configurado, o Cognos TM1 usa um valorigual a 1.

JobQueueThreadSleepTimeJobQueueThreadSleepTime determina a frequência com a qual o encadeamento queprocessa a fila é executado quando há tarefas enfileiradas.


Padronizado como 10 segundos.

LanguageConfigura o idioma usado para o servidor IBM Cognos TM1 . Este parâmetro seaplica às mensagens geradas pelo servidor e também é usado na interface com ousuário da caixa de diálogo do servidor quando você executa o servidor como umaplicativo em vez de um serviço do Windows.


Os valores válidos atualmente são:

Language Código


Croata hry

Tcheco csy



Dinamarquês dan

Alemão deu

Espanhol esp


Language Código

Finlandês fin

Francês fra

Húngaro hun

Italiano ita

Japonês jpn

Cazaque kaz

Coreano kor

Norueguês nor

Polonês pol

Romeno rom

Russo rus

Sueco sve

Turco trk

LDAPUseServerAccountDetermina se é necessária uma senha para conectar-se ao servidor ao usar aautenticação LDAP.

Tipo de parâmetro: opcional, estáticov Para se conectar diretamente ao servidor LDAP usando a autenticação integrada,

configure este parâmetro como T. Configure este parâmetro como T sempre queo servidor IBM Cognos TM1 e o servidor LDAP existirem no mesmo domínio.

v Para usar uma senha antes de conectar-se, defina este parâmetro como F.Quando LDAPUseServerAccount for definido como F, também será necessáriodefinir “LDAPPasswordFile” na página 195 e “LDAPPasswordKeyFile” napágina 195 para conectar-se com êxito ao servidor LDAP usando SSL.

LDAPPasswordFileDefine o arquivo de senhas usado quando LDAPUseServerAccount não for usado.Este é o caminho completo do arquivo .dat que contém a senha criptografada paraa chave privada do IBM Cognos TM1 server Admin Server.

Tipo de parâmetro: opcional, a menos que “LDAPUseServerAccount” na página195=F, estático

Esse parâmetro usa o caminho completo para um arquivo .dat.

LDAPPasswordKeyFileDefine a chave de senha usada quando LDAPUseServerAccount não for usado.

Tipo de parâmetro: opcional, a menos que “LDAPUseServerAccount” na página195=F, estático

Esse parâmetro usa o caminho completo do arquivo .dat que contém a chave usadapara criptografae e decriptografar a senha da chave privada.


Este arquivo deve ser gerado usando o utilitário tm1crypt, conforme descrito em“Executando o Utilitário TM1Crypt” na página 218.

LockPagesInMemoryQuando este parâmetro é ativado, o Windows corta páginas do espaço de processodo IBM Cognos TM1 , mas não as páginas no disco.


Se um servidor Cognos TM1 em execução no sistema operacional Windows de 64bits estiver inativo por um longo período de tempo, a memória física utilizada peloservidor Cognos TM1 será paginada fora do disco. Esta é uma função do sistemaoperacional Windows de 64 bits e não do Cognos TM1 . Isto pode causardegradação do desempenho em bancos de dados grandes do Cognos TM1 aotentar acessar dados após um período inativo.

Para maximizar o desempenho ao executar um banco de dados grande CognosTM1 no Windows de 64 bits, configure LockPagesInMemory=T no arquivo Tm1s.cfg.

Quando este parâmetro está ativado, o Windows ainda corta páginas do espaço doprocesso do Cognos TM1 , mas não as pagina no disco. Isto beneficia odesempenho do servidor Cognos TM1 porque os objetos não são mais colocadosna memória virtual, mas, em vez disso, permanecem na RAM física.

LoggingDirectoryEspecifica o diretório no qual o servidor salva seus arquivos de log.

Se este parâmetro não for fornecido, os arquivos de log serão salvos no primeirodiretório de dados especificado pelo parâmetro DataBaseDirectory.


Nota: O valor do parâmetro LoggingDirectory deve ser encapsulado por aspas, seusar espaços, por exemplo, LoggingDirectory=C:/Data Files/Logfiles. Ainicialização do Cognos TM1 Server falhará se aspas não forem usadas nesse caso.Observe também que outros parâmetros, tais como DataBaseDirectory, nãorequerem necessariamente aspas quando um valor contiver espaços.

LogReleaseLineCountDefine o número de linhas que uma procura do Log de Transações acumulará emum estado bloqueado antes de liberar temporariamente para que outra atividadedo Log de Transações possa continuar.


Por padrão, este valor é definido em 5000 linhas.

MaskUserNameInServerToolsDetermina se os nomes de usuário nas ferramentas de administração do servidor(TM1 Top e TM1 Operations Console) são ou não mascaradas até um usuário serverificado explicitamente como tendo acesso de administrador.



Quando MaskUserNameInServerTools é configurado como TRUE, os nomes deusuário são mascarados nas ferramentas de administração do servidor até ousuário que está trabalhando na ferramenta de administração ser verificadoexplicitamente como um administrador. Consulte o Guia do IBM Cognos TM1Operations Console para obter detalhes sobre como verificar o acesso deadministrador ao Operations Console. Consulte o Guia de Operações do IBMCognos TM1 para obter detalhes sobre como verificar o acesso de administrador aoTM1 Top.

Quando MaskUserNameInServerTools é configurado como FALSE, os nomes deusuário são exibidos nas ferramentas de administração do servidor para todos osusuários, independentemente do status do administrador.

Se MaskUserNameInServerTools não estiver presente no Tm1s.cfg, ocomportamento padrão será exibir nomes de usuário nas ferramentas deadministração do servidor para todos os usuários, independentemente do status doadministrador.

MaximumCubeLoadThreadsEspecifica se as fases de carregamento do cubo e cálculo do alimentador docarregamento do servidor são multiencadeadas, portanto, vários núcleos doprocessador podem ser usados em paralelo.

Isto resulta em tempos de carregamento do servidor reduzidos.


Para executar no modo multiencadeado, você deve configurarMaximumCubeLoadThreads com o número de núcleos de processador no servidorCognos TM1 que deseja dedicar ao carregamento de cubo e ao processamento doalimentador.

Geralmente, o melhor desempenho é obtido quando o parâmetro é configuradocom um valor igual a (número de núcleos de processador disponíveis) - 1. Por exemplo,se o servidor Cognos TM1 estiver em execução em um computador com quatronúcleos de processador, MaximumCubeLoadThreads deverá ser configurado como3. Isto assegura que um núcleo de processador esteja disponível para executaroutros aplicativos enquanto o servidor Cognos TM1 está sendo carregado.

Quando MaximumCubeLoadThreads for definido como 0, o carregamento do cuboe o processamento do alimentador NÃO serão multiencadeados. Este é ocomportamento padrão quando MaximumCubeLoadThreads não estáexplicitamente definido no arquivo Tm1s.cfg.

Nota: Quando MaximumCubeLoadThreads é ativado, o Cognos TM1 não podegerenciar a ordem na qual os alimentadores são calculados. Pode haver casos emque a ordem de processamento terá um efeito adverso em seu aplicativo, devido aalgumas dependências de ordem de avaliação no ambiente multiencadeado.

Se seu modelo Cognos TM1 usar alimentadores condicionais nos quais a cláusulada condição contém um valor alimentado, você deverá configurarMaximumCubeLoadThreads=0 ou excluir o parâmetro do arquivo the Tm1s.cfg paradesativar o uso de diversos encadeamentos no momento do carregamento.


MaximumLoginAttemptsDefine o número máximo permitido de tentativas de login do usuário com falhano servidor.

Se você não incluir MaximumLoginAttempts no Tm1s.cfg, por padrão, o servidorpermitirá três tentativas de login.


Por exemplo, se você incluir a linha MaximumLoginAttempts=5 no Tm1s.cfg, oservidor aplicará um limite de cinco tentativas de login com falha por usuário. Seum usuário não efetuar login com sucesso no servidor Cognos TM1 dentro donúmero especificado de tentativas, o servidor emitirá um erro.

Após um usuário ter excedido o número máximo especificado de tentativas delogin com falha, o servidor Cognos TM1 rejeitará quaisquer tentativas de loginsubsequentes pelo usuário.

O parâmetro MaximumLoginAttempts é aplicado por sessão do servidor. Se umusuário exceder o número máximo de tentativas, ele não poderá efetuar login nasessão do servidor Cognos TM1 atual, a menos que o administrador do CognosTM1 altere sua senha. No entanto, após a reciclagem do servidor Cognos TM1 , ousuário poderá efetuar login com esta senha existente.

MaximumMemoryForSubsetUndoDefine a quantidade máxima de memória, em kilobytes, a ser dedicada aoarmazenamento da pilha Desfazer/Refazer para o Editor de Subconjunto.

Por exemplo, incluir a linha MaximumMemoryForSubsetUndo=20480 no arquivode configuração instrui o servidor a alocar 20480 kilobytes (20 MB) de memóriapara a pilha Desfazer/Refazer.


Geralmente, subconjuntos maiores requerem maiores quantidades de memória paraarmazenar uma pilha Desfazer/Refazer utilizável. Se você achar que o servidorCognos TM1 não está armazenando um número suficiente de etapasDesfazer/Refazer para seus subconjuntos, aumente o valor deMaximumMemoryForSubsetUndo.

Se este parâmetro não estiver explicitamente definido no arquivo Tm1s.cfg, aquantidade máxima de memória dedicada ao recurso Desfazer/Refazer do Editorde Subconjunto será de 10240 kilobytes (10 MB).

MaximumSynchAttemptsDefine o número máximo de vezes que um processo de sincronização em umservidor planeta tentará reconectar-se a uma rede antes de o processo falhar.


O parâmetro MaximumSynchAttempts pode ser usado para melhorar aestabilidade de um processo de sincronização que está em execução em umaconexão de rede instável, como uma rede de longa distância (WAN) com altalatência, largura da banda e qualidade de transmissão insatisfatórias.


Para especificar o número máximo de vezes que um processo de sincronizaçãodeve tentar estabelecer uma conexão de rede, inclua a seguinte linha no Tm1s.cfgpara o servidor planeta:

MaximumSynchAttempts=n

em que n representa o número de tentativas de conexão de rede que o processo desincronização deve fazer antes de o processo falhar.

O valor-padrão é 1, que significa que o processo de sincronização tentará conectarapenas uma vez e não tentará reconectar se a conexão for perdida. Estecomportamento padrão é o mesmo comportamento das versões do Cognos TM1anteriores à 9.5.1 em que um processo de sincronização falharia se a conexão derede fosse perdida.

Um valor 0 significa tentativas de conexão de rede ilimitadas.

Este parâmetro pode ser configurado para funcionar com o parâmetroSyncUnitSize. Para obter informações adicionais, consulte “SyncUnitSize” napágina 270.

O exemplo a seguir mostra como usar o parâmetro MaximumSynchAttempts como parâmetro SyncUnitSize:SyncUnitSize=2000

MaximumSynchAttempts=100

MaximumTILockObjectsUm parâmetro de configuração do servidor que configura o número máximo deobjetos de bloqueio para um processo do TurboIntegrator. Usado pela funçãosynchronized() do TurboIntegrator.

O servidor mantém uma lista dos objetos de bloqueio do TurboIntegrator criados.Toda vez que o usuário chama a função synchronized() em um objeto de bloqueio,o servidor primeiro verifica se o objeto de bloqueio já está na lista. Se não estiver, oservidor criará um novo objeto de bloqueio e o inserirá na lista.

Para obter detalhes adicionais, consulte o tópico "Serializing TurboIntegratorprocesses using synchronized()" no IBM Cognos TM1TurboIntegrator Guide.

Mesmo que todos os processos do TurboIntegrator que tenham feito referência aum objeto de bloqueio tenham sido encerrados, é possível que o objeto de bloqueionão seja imediatamente removido da lista para liberar a memória. Isso ocorreporque é provável que, posteriormente, o mesmo processo ou alguns outrosprocessos chamem a função synchronized() nesse mesmo objeto de bloqueio.

O parâmetro de configuração do servidor MaximumTILockObjects em tm1s.cfgcontrola o crescimento da lista de objetos de bloqueio do TurboIntegrator criados.Quando o número de objetos de bloqueio na lista atinge MaximumTILockObjects,o servidor inicia uma operação de limpeza. Ela remove alguns objetos de bloqueioda lista se eles não estiverem sendo usados por nenhum processo doTurboIntegrator no momento.

Se o parâmetro MaximumTILockObjects não estiver configurado explicitamente emtm1s.cfg, será considerado um valor padrão igual a 2000.



MaximumUserSandboxSizeDefine a quantidade máxima de memória RAM (em MB) a ser alocada por usuáriopara áreas de trabalho pessoais ou ambientes de simulações.

Se o parâmetro MaximumUserSandboxSize não for definido, o tamanho máximopadrão será de 100 MB em um sistema de 32 bits e de 500 MB em um sistema de64 bits.


Para especificar uma quantidade máxima de alocação de memória para áreas detrabalho pessoais ou ambientes de simulações, inclua a seguinte linha no Tm1s.cfg:

MaximumUserSandboxSize=n

em que n representa a quantidade de memória em MB a ser alocada.

MaximumViewSizeDefine a quantidade máxima de memória (em MB) a ser alocada quando umusuário acessar uma visualização.

Se o parâmetro MaximumViewSize não for definido, o tamanho máximo padrão davisualização será de 100 MB em um sistema de 32 bits e de 500 MB em um sistemade 64 bits.


Para especificar uma quantidade máxima de alocação de memória paravisualizações, inclua a seguinte linha no Tm1s.cfg:MaximumViewSize=n

em que n representa a quantidade de memória em MB a ser alocada.

MaxUndoHoldLineCountMaxUndoHoldLineCount determina por quanto tempo uma operação Desfazer ouRefazer bloqueia o arquivo Tm1s.log.


Quando o arquivo Tm1s.log atingir tamanhos de 1 GB ou mais, uma operaçãoDesfazer ou Refazer poderá bloquear o arquivo Tm1s.log por um longo períodoinaceitável, impedindo que outros encadeamentos acessem o arquivo de log.MaxUndoHoldLineCount permite especificar o intervalo, expresso como o númerode registros a serem processados entre liberações de bloqueios, no qual umaoperação Desfazer ou Refazer permite que outros encadeamentos acessem oarquivo Tm1s.log.

Para especificar o intervalo no qual o servidor Cognos TM1 deve liberar o bloqueiono arquivo Tm1s.log, inclua a linha a seguir no Tm1s.cfg:MaxUndoHoldLineCount=n


em que n representa o número de registros a serem processados antes de umaoperação Desfazer/Refazer abandonar e readquirir o bloqueio no Tm1s.log.Quando MaxUndoHoldLineCount for definido, uma operação Desfazer/Refazerprocessará o número de registros especificados pelo valor de parâmetro, emseguida, liberará o bloqueio, permitirá que outros encadeamentos acessem oarquivo de log e readquirirá o bloqueio.

Se MaxUndoHoldLineCount não estiver definido explicitamente, o valor-padrãoserá 5000.

MessageCompressionAtiva a compactação de mensagens para mensagens grandes, que reduzsignificativamente o tráfego da rede.

O parâmetro é ativado por padrão.


Para desativar a compactação de mensagens, inclua a seguinte linha no Tm1s.cfg:MessageCompression=F

NetRecvBlockingWaitLimitSecondsAltera o tempo máximo que o servidor aguarda para que um cliente envie apróxima solicitação de uma longa espera para períodos de espera mais curtos, paraque seja possível cancelar um encadeamento, se necessário.

O parâmetro é ativado por padrão.


Por padrão, o servidor pode esperar por uma entrada durante um longo período, oque pode resultar e encadeamentos mantidos por um longo período e outrosproblemas.

Este parâmetro instrui o servidor Cognos TM1 para executar a espera como umasérie de esperas mais curtas repetidas e fornece ao servidor a oportunidade decancelar ou pausar o encadeamento. Quando configurado como zero (o padrão), éusado o comportamento de legado de uma longa espera.

NetRecvMaxClientIOWaitWithinAPIsSecondsTempo máximo para um cliente executar E/S no intervalo de tempo entre achegada do primeiro pacote de dados para um conjunto de APIs por meio deprocessamento, até o envio da resposta.


Requer que o cliente manipule a E/S de modo adequado após iniciar assolicitações da API. Esse parâmetro foi projetado para se proteger de conexões queficam vazias, mas não para criar um erro de soquete ou criar outras possibilidadescomo a interrupção de um cliente.

O valor padrão é 0, o que significa que não há limite de tempo.


ParallelInteractionAtiva/desativa a Interação Paralela para todos os cubos de controle e criados pelousuário em um servidor IBM Cognos TM1.

A Interação Paralela é um recurso relacionado ao servidor Cognos TM1 quepermite maior simultaneidade de operações de leitura e gravação no mesmo objetode cubo. Para obter mais detalhes, consulte "Usando Interação Paralela com umServidor Cognos(r) TM1(r)" no Guia de Operações do IBM Cognos TM1.


A partir do Cognos TM1 versão 10.1, a Interação Paralela é ativada por padrão, oqual usa a Interação Paralela para todos os cubos no servidor TM1 .

Para desativar manualmente a Interação Paralela para todos os cubos, configureParallelInteraction=F.

PasswordMinimumLengthEspecifica um comprimento mínimo de senha para clientes que acessam o servidor.


Por exemplo, defina PasswordMinimumLength=8 para aplicar um comprimentomínimo de senha de 8 caracteres.

Nota: Este parâmetro afeta apenas senhas definidas ou alteradas após o parâmetroter sido definido. Ele não tem efeito em senhas antigas, inalteradas e que contêmmenos caracteres do que o número aplicado por PasswordMinimumLength

PasswordSourceCompara a senha inserida pelo usuário com a senha armazenada.


Cognos TM1 (Padrão): Compara a senha inserida pelo usuário com a senha nobanco de dados Cognos TM1 .

LDAP: Compara a senha inserida pelo usuário com a senha armazenada noservidor LDAP.

PerformanceMonitorOnInicia automaticamente o preenchimento dos cubos de controle }Stats quando umservidor inicia.

Os cubos de controle contêm estatísticas que podem ser revisadas para monitorar odesempenho do sistema. Para obter detalhes sobre cubos de controle, consulte"Cubos de Controle" no Guia de Operações do IBM Cognos TM1.


Por exemplo, para ativar o Monitor de Desempenho, definaPerformanceMonitorOn=T. Para desativar o Monitor de Desempenho, definaPerformanceMonitorOn=F


PersistentFeedersPara melhorar o tempo de recarga dos cubos com alimentadores, configure oparâmetro de configuração PersistentFeeders como true (T) para armazenar osalimentadores calculados em um arquivo .feeders.

Qualquer instalação com tempo de carregamento do servidor de mais de 5 minutosprovavelmente melhora seu desempenho usando este parâmetro.


Quando este parâmetro é configurado como T e o servidor encontra um arquivo dealimentador persistente, ele carrega os alimentadores salvos, o que reduz o temponormalmente gasto para recalcular esses alimentadores. Os alimentadores sãosalvos quando os dados são salvos ou as regras são editadas. Você não salva osalimentadores explicitamente

Para instalações com cálculos de alimentador muito complexos, persistiralimentadores e, em seguida, recarregá-los na inicialização do servidor melhorará odesempenho. Para alimentadores simples, o tempo gasto para ler alimentadores dodisco pode exceder o tempo para recalcular os alimentadores, mas a maioria dasinstalações se beneficiará.

Usar o recurso de Alimentadores Persistentes aumentará o tamanho do seu sistemaapenas no disco. O tamanho da memória não é afetado pelo uso deste parâmetro.

PersistentFeeders=T

Para obter informações adicionais, consulte "Usando Alimentadores Persistentes"no Guia de Operações do IBM Cognos TM1.

PortNumberDefine o número da porta do servidor usado para distinguir entre váriosservidores em execução no mesmo computador.

Quando diversos servidores IBM Cognos TM1 são instalados em um únicocomputador, cada servidor deve usar um número de porta exclusivo.


Quando você instala um servidor Cognos TM1 , o número da porta padrão é12345. Os números de portas válidos estão entre 5001 e 49151.

Se o arquivo Tm1s.cfg não contiver o parâmetro PortNumber, o servidor CognosTM1 usará a porta 5000. Servidores Cognos TM1 locais usam a porta 5000. A portausada para Mensagens para os Clientes também deve ter um número de portaexclusivo e ser definida como 5001, por padrão, quando o parâmetroClientMessagePortNumber for usado.

PrivilegeGenerationOptimizationQuando o servidor TM1 gera privilégios de segurança a partir de um cubo decontrole de segurança, ele lê cada célula a partir desse cubo.

Se o cubo de controle de segurança for preenchido de forma esparsa, isto resultaráem processamento desnecessário e em um tempo de carregamento maior. Um


exemplo de cubo de segurança preenchido de forma esparsa seria um que possuiuma proporção maior de configurações de segurança em comparação comconfigurações de segurança definidas.


Para tratar este problema, o parâmetro PrivilegeGenerationOptimization pode serincluído no arquivo Tm1s.cfg, da seguinte forma:PrivilegeGenerationOptimization=T

Quando este parâmetro for configurado como T, o servidor Cognos TM1 lerásomente as células preenchidas em cubos de segurança. No caso de um cubo desegurança preenchido de modo esparso, isto reduzirá dramaticamente o tempo decarregamento do servidor Cognos TM1 .

Nota: Se você preencher as configurações de segurança por meio de regras edesejar usar este parâmetro, deverá gravar alimentadores para as regras quepreenchem seus cubos de segurança. Como as configurações de segurança sãoarmazenadas como sequências, as regras que preenchem seus cubos de segurançadevem incluir a função FeedStrings.

ProgressMessageEste parâmetro determina se os usuários têm a opção de cancelar cálculos devisualização muito longos.

Quando um usuário abre uma visualização que usa uma quantidade significativade tempo para calcular (geralmente uma visualização com altos níveis deconsolidação ou regras complexas), o IBM Cognos TM1 monitora o progresso doprocesso. Quando ProgressMessage=T, será aberta uma caixa de diálogo quepermite ao usuário Parar a Visualização da Construção.


Se o usuário clicar em Parar Visualização de Construção, a visualização serádescartada no cliente, mas o cálculo da visualização continuará no servidor. Emalguns casos, isto pode bloquear o servidor.v Se ProgressMessage=F, a opção Parar Visualização de Construção não será

oferecida e o usuário não poderá cancelar operações longas. Esta configuraçãoajuda a evitar possíveis bloqueios do servidor em versões 9.1 SP3 a 9.4.

v Quando ProgressMessage=T ou não estiver presente no arquivo Tm1s.cfg, aopção Parar Visualização de Construção será aberta durante cálculos devisualização longos, portanto, o usuário pode cancelar o progresso, se necessário.Para versões 9.4 ou mais recentes, o usuário pode designar um Número de Portaexclusivo usando ClientMessagePortNumber. Esta porta adicional permite queestas mensagens de progresso percorram uma porta secundária para que oprocessamento do servidor possa continuar, sem bloquear reservas deencadeamento.

Nota: Para evitar bloquear potencialmente os servidores, o Cognos TM1 9.1 SP3até 9.4 tem ProgressMessage=F inserido no arquivo Tm1s.cfg durante a instalaçãode servidor. A partir do Cognos TM1 9.4, as mensagens de progresso podem viajarpor meio da porta secundária designada por ClientMessagePortNumber para que oCognos TM1 9.4 e posterior tenha ProgressMessage=T configurado por padrão.


ProportionSpreadToZeroCellsPermite executar uma difusão proporcional a partir de uma consolidação sem gerarum erro quando todas as células folha contém valores iguais a zero.

Neste caso, o Cognos TM1 aplica uma difusão igual nas células vazias quando oparâmetro ProportionSpreadToZeroCells está ativado. Esta funcionalidade é ativadapor padrão no Cognos TM1 9.5.2 e posterior.


Comportamento Quando ProportionSpreadToZeroCells estáAtivado

Esse parâmetro e funcionalidade são ativados por padrão, permitindo que umaoperação de difusão seja concluída sem erros quando uma difusão proporcional éexecutada em uma consolidação na qual todas as células folha são iguais a zero.Neste cenário, o Cognos TM1 converte a entrada digitada de "P###" para "LS*###"e aplica a difusão como uma difusão igual.

Quando este parâmetro é ativado e dados existem em qualquer uma das célulasfolhas, o comportamento é o mesmo que em versões anteriores do Cognos TM1 aoexecutar uma difusão proporcional.

Esse parâmetro fica ligado por padrão e não é necessário ativá-lo. Entretanto, casodeseje configurá-lo explicitamente, configure o parâmetroProportionSpreadToZeroCells como T (True) no arquivo de configuração Tm1s.cfg,conforme a seguir.

ProportionSpreadToZeroCells=T

Comportamento Quando ProportionSpreadToZeroCells estáDesativado

Configurar este parâmetro como F (False) desativa este recurso e fornece o mesmocomportamento que as versões pré-9.5.2 do Cognos TM1. Você verá um erroquando tentar executar uma das seguintes operações de difusão proporcionais:v No TM1 Contributor - Insira um número em uma célula consolidada na qual

todas as células folhas para essa consolidação contêm zeros.v No TM1 Contributor e em outros clientes do TM1 - Execute uma operação de

difusão proporcional inserindo um código de difusão e um número tal como"P###" em uma célula ou acesse uma difusão proporcional a partir do menuativado pelo botão direito do mouse ou do menu do TM1 (apenas TM1Perspectives) quando todas as células folhas para essa consolidação contêmzeros.

Estas operações fazem o servidor TM1 executar uma difusão proporcional, mas aoperação falha porque todas as células folhas contêm zeros.

Para desativar essa nova funcionalidade, configure o parâmetroProportionSpreadToZeroCells como F (False) no arquivo de configuração Tm1s.cfgconforme a seguir.

ProportionSpreadToZeroCells=F


RawStoreDirectoryIndica o local do arquivo de log temporário, não processado, para criação de logde auditoria, se a criação de log ocorrer em um diretório diferente do diretório dedados.

Tipo de parâmetro: opcional, dinâmico.

Se este parâmetro não for inserido, o arquivo de log de auditoria não processadoserá salvo, por padrão, no diretório listado no parâmetro DataBaseDirectory.

Para obter detalhes sobre outros parâmetros de criação de log de auditoria,consulte “AuditLogMaxFileSize” na página 235, “AuditLogMaxQueryMemory” napágina 235, “AuditLogMaxTempFileSize” na página 235, “AuditLogOn” na página236 e “AuditLogUpdateInterval” na página 236.

ReceiveProgressResponseTimeoutSecsO parâmetro ReceiveProgressResponseTimeoutSecs configura o servidor parainterromper a conexão do cliente e liberar recursos durante uma longa espera poruma ação Cancelar.


Quando o servidor Cognos TM1 está executando operações longas para um cliente,mensagens de "progresso" periódicas são enviadas para o aplicativo cliente CognosTM1 . O cliente responde a estas mensagens com uma indicação se o usuáriopressionou o botão Cancelar, neste caso, a operação longa é finalizada. Estasrespostas são geradas automaticamente pelo código de rede no aplicativo cliente;não há interação com o usuário envolvida. Depois de enviar a mensagem deprogresso, o servidor espera uma resposta do aplicativo cliente. Como o servidorestá aguardando, o encadeamento do cliente continuará retendo bloqueios derecurso no servidor Cognos TM1 , evitando que outros usuários façam outrassolicitações do servidor que requerem os mesmos bloqueios de recurso.

Em algumas situações particulares, mais notavelmente ao executar os clientesCognos TM1 em um ambiente Citrix, a resposta do aplicativo cliente nunca chegade volta no servidor Cognos TM1 , fazendo com que o servidor aguarde umaquantidade infinita de tempo. Isto resulta em um bloqueio do sistema, porque oencadeamento do cliente suspende os bloqueios de recursos que nunca sãoliberados.

O parâmetro ReceiveProgressResponseTimeoutSecs permite configurar seu servidorpara detectar esta situação e interromper a conexão do cliente, liberando osrecursos. Quando o parâmetro for definido como um intervalo válido (emsegundos), o processo do servidor finalizará a conexão do cliente, liberandobloqueios de recursos, se o servidor não detectar a resposta do aplicativo clientedentro do intervalo especificado.

Por exemplo, se ReceiveProgressResponseTimeoutSecs=20 e o aplicativo cliente nãoresponder à mensagem de progresso enviada do servidor em 20 segundos, aconexão do cliente será finalizada. Mais uma vez, não é necessária nenhuma açãodo usuário para gerar esta resposta. A resposta é gerada automaticamente peloaplicativo cliente, portanto, se a resposta não chegar em 20 segundos, isto será umaindicação de que há algo seriamente errado com o cliente ou a rede subjacente.


ReceiveProgressResponseTimeoutSecs é um parâmetro do Tm1s.cfg opcional. Se oparâmetro não estiver presente no arquivo Tm1s.cfg, os processos não serãofinalizados quando um cliente não responder a uma mensagem de progresso doservidor Cognos TM1 .

Para algumas instalações do Cognos TM1 (versão 9.4 ou posterior), oClientMessagePortNumber define um encadeamento separado para usar paramensagens de cancelamento sem bloquear reservas. QuandoClientMessagePortNumber estiver disponível,ReceiveProgressResponseTimeoutSecs não será usado.

RunningInBackgroundQuando você inclui a linha RunningInBackground=T no Tm1s.cfg, o servidor UNIXIBM Cognos TM1 é executado no modo de plano de fundo.


RulesOverwriteCellsOnLoadEvita que as células seja sobrescritas no carregamento do servidor em dadosderivados de regras.


Durante o processamento de alimentadores para um cubo, o valor de um cubopoderá eliminado se houver uma regra para essa célula. Quando o cubo que tinhauma célula eliminada é salvo, o valor é apagado, portanto, a ação não tem efeitono cubo. Entretanto, se a regra for editada, mas o cubo não for modificado emseguida, o cubo não será salvo no disco. Nesse caso, é possível que valores decélula reais sejam eliminados quando as regras forem executadas.

O parâmetro RulesOverwriteCellsOnLoad pode ser usado para evitar a ação dezeramento após a edição de uma regra.

Caso esteja alterando regras e essas regras, em razão de diversas edições, façamcom que algumas células que possuem dados se tornem derivadas de regras,inclua RulesOverwriteCellsOnLoad=F no arquivo de configuração.

Se esse parâmetro for configurado como True ou não estiver presente, sempre queo servidor for carregado, as células derivadas de regras serão eliminadas comozero. Os valores de dados nessas células serão perdidos mesmo que, em seguida, aregra seja alterada para que a célula não seja mais derivada de regra.

Por padrão, esse parâmetro não está presente no arquivo de configuração ou estáconfigurado como True.RulesOverwriteCellsOnLoad=F

SAPLoggingEnabledQuando um processo do Turbo Integrator importa objetos e/ou dados do SAPRFC, é possível configurar seu servidor IBM Cognos TM1 para registrar todaatividade entre o Cognos TM1 e o SAP.

Tipo de parâmetro: opcional/usado apenas no software 9.0. Use uma propriedadepara configurar esse valor no 9.1 e nas versões superiores; estático


Quando um processo do Turbo Integrator importa objetos e/ou dados do SAPRFC, é possível configurar seu servidor Cognos TM1 para registrar toda atividadeentre o Cognos TM1 e o SAP.

Inclua a linha SapLoggingEnabled=T no arquivo Tm1s.cfg para ativar a criação delog do SAP. Se este parâmetro não estiver presente no arquivo Tm1s.cfg, ou se oparâmetro estiver definido como F, a atividade do SAP não será registrada.

Se SapLoggingEnabled=T, também será necessário definir o parâmetroSapLogFilePath.

SAPLogFilePathEste parâmetro define o arquivo de log para receber informações de criação de logdo SAP.

Tipo de parâmetro: opcional/usado apenas no software 9.0. Use uma propriedadepara configurar esse valor no 9.1 e nas versões superiores; estático

Especifique o caminho completo para o arquivo de log, por exemplo,SapLogFilePath=c:\SAPdata\tm1_sap.log.

SaveTimeDefine a hora do dia para executar um salvamento automático de dados doservidor; salva os cubos a cada dia subsequente no mesmo horário. Assim comoum encerramento regular, SaveTime renomeia o arquivo de log, abre um novoarquivo de log e continua a execução após o salvamento.


O parâmetro SaveTime não está disponível ao executar o servidor Cognos TM1como um serviço do Windows.

O formato do parâmetro SaveTime é dd:hh:mm, em que:v dd é o número de dias, a partir de hoje, em que o sistema iniciará o salvamento

automático de dados. Por exemplo, 00 é hoje, 01 é amanhã.v hh:mm é a hora do dia em formato de 24 horas.

SecurityPackageNameSe você configurar o servidor IBM Cognos TM1 para usar Login Integrado, oparâmetro SecurityPackageName definirá o pacote de segurança que autentica seunome de usuário e sua senha no Microsoft Windows.


Os valores válidos são:v Kerberos (padrão) - versões suportadas Microsoft Windows.v NTLM - instalações Microsoft Windows antigas, tal como Microsoft Windows

NT.

Para obter descrições completas de todos os modos de segurança de login,incluindo o Login Integrado, consulte “Login Integrado” na página 185.


ServerCAMURIEspecifica o URI para o dispatcher interno que o servidor IBM Cognos TM1 deveusar para se conectar ao CAM.

O URI é especificado no formato http[s]://host IP address:port/p2pd/servlet/dispatch.


Por exemplo,http://10.121.25.121:9300/p2pd/servlet/dispatch

ouhttps://10.121.25.121:9300/p2pd/servlet/dispatch

ServerLoggingGera um log com os detalhes da atividade de segurança no servidor IBM CognosTM1 que estão associados ao Login Integrado.

O arquivo de log, denominado Tm1server.log, é salvo no diretório de dados doservidor Cognos TM1 . O parâmetro ServerLogging é útil somente se seu servidorCognos TM1 foi configurado para usar Login Integrado.


Defina ServerLogging como T no Tm1s.cfg. Observe também que, se oServerLogging=T estiver configurado, você deverá renomear o arquivo de log

tm1server.log da mensagem do servidor Cognos TM1 editando o parâmetrocorrespondente no arquivo tm1s-log.properties do arquivo de configuração docriador de logs.

ServerNameConfigura o nome do servidor IBM Cognos TM1 . Se você não fornecer esteparâmetro, o Cognos TM1 nomeará o servidor Local e o tratará como um servidorlocal.


ServicePrincipalNameEspecifica o nome do principal de serviço (SPN) ao usar Login Integrado com TM1Web e delegação restrita.

Tipo de Parâmetro:v Opcionalv Estático

Se você alterar este valor de parâmetro, reinicie o servidor TM1 para aplicar onovo valor.

Use o formato a seguir para incluir o parâmetro no arquivo Tm1s.cfg:

ServicePrincipalName=SPN


O valor configurado aqui deve corresponder ao nome do serviço que também foimapeado para uma conta de domínio no controlador de domínio do ActiveDirectory usando a ferramenta de linha de comandos Microsoft, setspn.exe.

Por exemplo, se você usar setspn.exe para incluir um SPN conforme a seguir:

setspn -a FPM/TM1 WbSvr_Account

será necessário configurar o parâmetro ServicePrincipalName como este:

ServicePrincipalName=FPM/TM1

Para obter informações adicionais sobre delegação restrita e configuração de SPN,procure no website Microsoft o tópico "Complemento Técnico Kerberos paraWindows".

SkipLoadingAliasesUse SkipLoadingAliases para acelerar o carregamento do servidor e a atualizaçãode visualizações, ignorando o carregamento de aliases.


Entre em contato com o suporte ao cliente para determinar se este parâmetro éaplicável ao seu sistema Cognos TM1 .

Os valores válidos são:v T - Aliases ignoradosv F - Aliases carregados

SkipSSLCAMHostCheckIndica se o processo de confirmação de ID do certificado SSL pode ser ignorado.

O padrão é False.


Importante: Esse parâmetro só deve ser configurado como True se um certificadogenérico estiver sendo usado para propósitos de demonstração.

SpreadingPrecisionUse o parâmetro SpreadingPrecision para aumentar ou reduzir a margem de errode difusão de cálculos.


A aritmética de ponto flutuante em computadores não é 100% precisa. Quando umcomputador calcula números muito pequenos, é aplicada uma margem de erro aocálculo. Se o computador incluir um conjunto de números, e a soma resultante forpróxima do valor de destino dentro da margem de erro, a soma será consideradaprecisa.

A margem de erro para determinados cálculos do Cognos TM1 é controlada pormeio do parâmetro SpreadingPrecision. O valor-padrão é SpreadingPrecision=1e-8.Este valor é usado nos seguintes cenários de difusão:


v Difusão a partir de uma célula consolidada.v Difusão em células folhas cujo valor consolidado tem uma retenção aplicada.

Difusão a partir de uma Consolidação

Quando você executa uma difusão de dados proporcional a partir de uma célulaconsolidada, o Cognos TM1 grava os números em cada célula no intervalo e obtémo total para recalcular a consolidação. O total de todas as células na consolidação éentão comparado com o valor original fornecido para a função de difusão. O totalpode ser diferente do valor de destino devido às regras aplicadas aos elementosnível n ou à própria célula consolidada.

Se as regras forem de tal forma que o valor resultante não corresponda ao valordesejado de difusão, um erro será gerado e a operação de difusão não seráexecutada.

Se SpreadingPrecision=1e-8, o total calculado pelo Cognos TM1 para aconsolidação deverá estar dentro de 0,000001% do valor de destino (99,999999% deprecisão) ou Cognos TM1 exibe um erro. Um erro de mais de US$ 0,01 em umadifusão consolidada de US$ 1.000.000 resulta em um erro.

É possível aumentar ou reduzir a margem de erro para estes tipos de cálculosusando o parâmetro SpreadingPrecision.

Os exemplos a seguir incluem valores válidos para o parâmetroSpreadingPrecision:v SpreadingPrecision=1e-4

v SpreadingPrecision=1e-8



SpreadingPrecision (Suspensões Consolidadas)Especifica a margem de erro para a difução de cálculos de suspensão consolidada.


O parâmetro SpreadingPrecision também tem um efeito nestas condições:v Ao difundir valores para algumas células folhas que fazem roll-up para uma

consolidaçãov Uma consolidação com uma retenção aplicada a ela

Por exemplo, suponha que você tenha a consolidação Q1 com os valores Jan, Fev eMar.

Se Q1- tiver uma suspensão consolidada aplicada, e você difundir valores para jane fev, o Cognos TM1 fará o seguinte:v Aplicará a difusão a Jan e Fev.v Ajustará Mar.v Incluirá os três elementos nível n juntos.v Comparará a soma dos elementos nível n com o valor de Q1.


Se a soma for precisa dentro da margem de erro especificada pelo parâmetroSpreadingPrecision, a difusão será bem-sucedida. Se a soma estiver fora damargem de erro especificada pelo parâmetro SpreadingPrecision, o Cognos TM1gerará um erro.

SubsetElementBreatherCountEste parâmetro gerencia a maneira como o IBM Cognos TM1 manipula ocomportamento de bloqueio para subconjuntos.


QuandoSubsetElementBreatherCount=-1

O servidor Cognos TM1 nunca libera o bloqueio nos subconjuntos quando outrassolicitações para o subconjunto estão pendentes. Esta configuração é o padrão. Elepode otimizar o desempenho de visualização para um único usuário, mas pelocusto da simultaneidade multiusuário.

QuandoSubsetElementBreatherCount=0

o servidor Cognos TM1 libera o bloqueio nos subconjuntos quando outrassolicitações para o subconjunto estão pendentes, readquire o bloqueio após assolicitações pendentes serem processadas. Esta configuração melhora odesempenho quando vários usuários tentam acessar o mesmo subconjunto,principalmente quando o subconjunto contém mais de 100 elementos.

StartupChoresStartupChores é um parâmetro de configuração que identifica uma lista de tarefasde organização de processos que executa na inicialização do servidor.


Para executar uma tarefa de organização de processos antes que os usuáriosefetuem login ou antes da execução de qualquer outra tarefa de organização deprocessos, inclui este parâmetro com os nomes das tarefas de organização dosprocessos a ser executados separadas por vírgulas, por exemplo:StartupChores=ChoreName1:ChoreName2:ChoreName3:ChoreNameN

Se este parâmetro não for especificado, então nenhuma Tarefa de organização deprocessos será executada. Se o nome especificado não corresponder a uma tarefade organização de processos existente, então um erro é gravado no log do servidore a execução continua para a tarefa de organização de processos seguinte.

O valor do parâmetro de configuração pode ser recuperado por um aplicativocliente como uma propriedade de servidor chamada StartupChores utilizando achamada de TM1ObjectPropertyGet existente.

Essa é uma propriedade somente leitura e operações em conjunto são rejeitadas. Ovalor da propriedade pode ser alterado editando-se o arquivo de configuração ereinicializando o servidor.


SyncUnitSizeDefine a frequência de salvamento de um ponto de verificação durante umprocesso de sincronização, caso haja uma falha de conexão de rede.


Nota: Ao usar SyncUnitSize, você também deve configurar o parâmetroMaximumSynchAttempts. Para obter informações adicionais, consulte“MaximumSynchAttempts” na página 255.

Se você configurar os parâmetros SyncUnitSize e MaximumSynchAttempts e umprocesso de sincronização for interrompido por uma falha de conexão de rede, oprocesso tentará reconectar-se e concluir a sincronização, começando a partir doúltimo ponto de verificação.

Para definir este parâmetro, inclua a seguinte linha no arquivo Tm1s.cfg para oservidor planeta:SyncUnitSize=n

em que n representa o número de registros de sincronização gravados no arquivode log de transações, Tm1s.log, após o qual um ponto de verificação será salvo.

O valor-padrão é 1000.

O valor mínimo recomendado é 500.

UserDefinedCalculationsAtiva consolidações definidas pelo usuário em um servidor IBM Cognos TM1 .


Por padrão, UserDefinedCalculations é ativado.

Para desativar consolidações definidas pelo usuário em um servidor, inclua aseguinte linha no Tm1s.cfg:UserDefinedCalculations=F

UseLocalCopiesforPublicDynamicSubsetsPermite que subconjuntos dinâmicos públicos melhorem o desempenho e reduzamo bloqueio usando cópias locais do subconjunto, quando possível.

Por padrão, ou se o parâmetro não estiver presente no arquivo tm1s.cfg,UseLocalCopiesforPublicDynamicSubsets é ativado. Para restaurar o métodoanterior de salvamento de Subconjuntos Dinâmicos, configure esse parâmetro comoF.


UseSQLFetch UseSQLFetchScroll UseSQLExtendedFetchEstes parâmetros instruem o IBM Cognos TM1 a usar uma chamada de buscaespecífica.



Quando você executa o processo Turbo Integrator que extrai informações de umaorigem de dados ODBC, o Cognos TM1 tenta usar a chamada de busca de SQLmais eficiente possível. O Cognos TM1 consulta o driver ODBC para determinarquais das chamadas de Busca de SQL a seguir usar para extrair os dados:

SQLFetch(), uma função ODBC 1

SQLFetchScroll(), uma função ODBC 2

SQLExtendedFetch(), uma função ODBC 3

Todos estes parâmetros são dinâmicos.

Se o Cognos TM1 não receber nenhuma resposta quando consultar o driver ODBC,seu processo do Cognos TM1 resultará em um erro, a menos que um dosparâmetros a seguir esteja configurado como T em seu arquivo Tm1s.cfg:

UseSQLFetch

UseSQLFetchScroll

UseSQLExtendedFetch

Estes parâmetros instruem o Cognos TM1 a usar uma chamada de buscaespecífica. Certifique-se de que a chamada especificada no Tm1s.cfg sejaapropriada para o driver ODBC que está sendo acessado, e que seja possívelespecificar apenas um destes parâmetros no Tm1s.cfg.

Por exemplo, para instruir o servidor Cognos TM1 a usar a chamadaSQLExtendedFetch() para extrair dados de uma origem ODBC, inclua a linha aseguir no Tm1s.cfg:UseSQLExtendedFetch=T

UseSSLAtiva ou desativa SSL no servidor Cognos IBM TM1 .

Tipo de parâmetro: opcional/obrigatório para usar SSL; estático

Defina UseSSL=T para ativar SSL. Com esta configuração, somente clientes CognosTM1 9.1 e posterior poderão se conectar de forma segura ao servidor.

Defina UseSSL=T para desativar SSL. Com esta configuração, todos os clientesCognos TM1 , incluindo clientes mais antigos que não suportam SSL, poderão seconectar ao servidor no modo inseguro.

Quando UseSSL=T, você deverá definir vários outros parâmetros de Tm1s.cfg quegerenciam a implementação de SSL. Para obter detalhes sobre estes parâmetros,consulte “Usando SSL para Segurança de Transmissão de Dados” na página 203.

UseStargateForRulesIndica se uma regra usa a visualização Stargate.



Por padrão, sempre que uma regra fizer referência a um valor calculado, o valorserá recuperado de uma visualização Stargate armazenada na memória (sedisponível). Na maioria dos casos, o uso da visualização Stargate para regrasresulta em uma melhoria significativa no desempenho. É mais eficiente recuperarum valor calculado da memória do que solicitar e recuperar um cálculo doservidor.

Em alguns casos exclusivos que são difíceis, senão impossíveis, para determinarantecipadamente e poder determinar apenas por meio tentativa e erro, arecuperação de um valor calculado a partir de uma visualização Stargate érealmente mais lenta do que a solicitação e recuperação do valor a partir doservidor. Nestas instâncias, inclua a linha a seguir no Tm1s.cfg para instruir asregras do Cognos TM1 para sempre recuperar os valores calculados a partir doservidor e melhorar o desempenho.UseStargateForRules=F

Entre em contato com o suporte ao cliente antes de incluir o parâmetroUseStargateForRules.

ViewConsolidationOptimizationAtiva ou desativa a otimização da consolidação da visualização no servidor IBMCognos TM1 .


O uso deste parâmetro melhora o desempenho do cálculo de elementosconsolidados. Por padrão, ViewConsolidationOptimization é ativado no servidorCognos TM1 .

A otimização de consolidação de visualização armazena os valores consolidadosque usam componentes de elemento folha no eixo de linha ou de coluna. Porexemplo, considere a estrutura da dimensão Ano, 1Trimestre com os valores Jan,Fev e Mar.

Quando um subconjunto de linhas ou de colunas usar o elemento Jan, asconsolidações 1 Trimestre e Ano serão calculadas e armazenadas para referênciafutura. Isto melhora o desempenho, mas aumenta a quantidade de memórianecessária para uma determinada visualização.

Para desativar a otimização de consolidação de visualização, inclua a seguintelinha no Tm1s.cfg:

ViewConsolidationOptimization=F

ViewConsolidationOptimizationMethodEste parâmetro define o método usado para atingir a otimização de consolidaçãoda visualização quando o parâmetro ViewConsolidationOptimization é ativado noservidor IBM Cognos TM1 .


Existem dois métodos que ViewConsolidationOptimization pode usar para calculare armazenar consolidações: ARRAY ou TREE. O método ARRAY armazenaconsolidações em uma matriz temporária. O método TREE armazena consolidaçõesem uma árvore.


ViewConsolidationOptimizationMethod deve ser definido como TREE na maioriadas circunstâncias. Esta configuração fornece o melhor desempenho em operaçõesnormais e quando os dados são esparsos nos eixos de visualização.

No caso incomum quando as dimensões de eixos tiverem apenas alguns elementosfolha fazendo roll up para muitas consolidações,ViewConsolidationOptimizationMethod deverá ser definido como ARRAY.

Para definir este parâmetro, inclua a linha apropriada no arquivo de configuração:ViewConsolidationOptimizationMethod=TREE

ViewConsolidationOptimizationMethod=ARRAY

Se ViewConsolidationOptimizationMethod não for definido explicitamente noarquivo Tm1s.cfg, o método ARRAY será usado por padrão.



Apêndice C. O Arquivo de Configuração do Cliente Tm1p.ini

O arquivo Tm1p.ini especifica as informações do ambiente para os clientes do IBMCognos TM1 (Cognos TM1 Perspectives, Cognos TM1 Architect e Cognos TM1Clients) .

Local do Arquivo Tm1p.iniO IBM Cognos TM1 instala uma versão padrão do sistema do arquivo Tm1p.ini etambém cria uma versão específica do usuário do arquivo.

As duas versões do arquivo Tm1p.ini são armazenadas em locais diferentes.

Arquivo Tm1p.ini Padrão do Sistema

Quando você instala o IBM Cognos TM1 , o local da instalação para a versãopadrão do sistema do arquivo Tm1p.ini é:%ALLUSERSPROFILES%\Application Data\Applix\TM1\Tm1p.ini.

Na maioria dos casos, o caminho completo para esta versão do arquivo Tm1p.ini é:C:\Documents and Settings\All Users\Application Data\Applix\TM1\Tm1p.ini.

A versão padrão do sistema do Tm1p.ini permite que diversos usuários usem oCognos TM1 em um determinado computador. O Tm1p.ini deve estar presente naprimeira vez que um usuário iniciar o Cognos TM1 no computador, já que osparâmetros na versão padrão do sistema controlam o comportamento dainicialização inicial do cliente Cognos TM1 para cada usuário.

Arquivo Tm1p.ini Específico do Usuário

Após um usuário iniciar o Cognos TM1 no computador, uma cópia específica dousuário do Tm1p.ini é criada em:%APPDATA%\Applix\TM1\Tm1p.ini

Na maioria dos casos, o caminho completo para a versão específica do usuário doarquivo Tm1p.ini é:

C:\Documents and Settings\user name\ApplicationData\Applix\TM1\Tm1p.ini.

A cópia específica do usuário do Tm1p.ini aceita todas as configurações deparâmetro e mudanças para o usuário e controla o comportamento do clienteCognos TM1 para todas as sessões do usuário subsequentes do cliente CognosTM1 .

A caixa de diálogo Opções do Cognos TM1 também armazena muitas destasconfigurações. Essas configurações podem ser alteradas usando a caixa de diálogoOpções do TM1 ou editando o arquivo Tm1p.ini. Os parâmetros de Tm1p.ini e asOpções do TM1 são descritos aqui.

Parâmetros no Arquivo Tm1p.iniOs parâmetros a seguir podem ser usados no arquivo Tm1p.ini.


AdminHostExibe o nome do Host Admin no qual um Servidor Administrativo está emexecução. Em Opções do IBM Cognos TM1 , use Host Administrativo dosParâmetros de Login.

AdminSvrSSLCertAuthorityO caminho completo do arquivo da autoridade de certificação que emitiu ocertificado do IBM Cognos TM1 Admin Server.

Em Opções do Cognos TM1 , use Autoridade de Certificação.

AdminSvrSSLCertIDO nome do principal para quem o certificado do IBM Cognos TM1 Admin Server éemitido.

Nota: O valor desse parâmetro deve ser idêntico ao SSLCertificateIDparameterpara o Cognos TM1 Admin Server conforme configurado no IBM CognosConfiguration.

Esse parâmetro também pode ser configurado para clientes na janela Cognos TM1Options campo > ID de Certificado.

AdminSvrSSLCertRevListO caminho completo do arquivo de revogação de certificado emitido pelaautoridade de certificação que emitiu o certificado do IBM Cognos TM1 AdminServer.

Um arquivo de revogação de certificado existirá apenas no caso de revogação deum certificado. Em Opções do Cognos TM1 , use Lista de Revogação deCertificado.

AdminSvrSSLExportKeyIDA chave de identidade usada para exportar o certificado de autoridade decertificação, que emitiu originalmente o certificado do IBM Cognos TM1 AdminServer, a partir do armazenamento de certificados.

Este parâmetro será necessário apenas se você escolher usar o armazenamento decertificados definindo ExportAdminSvrSSLCert=T.

No Cognos TM1 Options, use o ID do Certificado de Exportação.

AdvancedRulesEditorIndica o tipo de Editor de Regras usado.

O Editor de Regras Avançado possui uma interface aprimorada.v T - É usado o Editor de Regras Avançado.v F (Padrão)- É usado o Editor de Regras Básico.

AllowImportCamClientsEste parâmetro é requerido somente ao configurar o IBM Cognos TM1 para usarautenticação do CAM.


Ele deve ser configurado como T durante a importação de um usuárioadministrativo do CAM no Cognos TM1.

Se o servidor Cognos TM1 não estiver configurado para usar autenticação CAM,esse parâmetro deve ser configurado como F ou omitido do arquivo Tm1p.ini.

Para obter detalhes, consulte “Acesso Anônimo e o Servidor Cognos TM1 ” napágina 197.

BrowseDisplayReadsRightToLeftIndica como os dados são orientados no Cube Viewer.

Os dados podem ser exibidos da direita para a esquerda ou da esquerda para adireita.v T - Os dados são orientados da direita para a esquerda.v F (Padrão) - Os dados são orientados da esquerda para a direita.

ClassicSliceModeIndica se a opção Fatia no Cube Viewer gera fatias clássicas ou fatias dinâmicas.v T - A opção Fatia gera fatias clássicas.v F - A opção Fatia gera fatias dinâmicas.

CognosGatewayURIEste parâmetro só é obrigatório durante a configuração do IBM Cognos TM1 parauso de autenticação do IBM Cognos Security (CAM).

Ele deve ser configurado para o URI do gateway do IBM Cognos. O URI éespecificado no formato http[s]:/<host>/cognosx/cgi-bin/cognos.cgi ouhttp[s]:/<host>/ibmcognos/cgi-bin/cognos.cgi.

Por exemplo, http://win2003test/ibmcognos/cgi-bin/cognos.cgi.

Se seu servidor Cognos TM1 não estiver configurado para usar autenticação doCAM, este parâmetro deverá ser omitido a partir do arquivo Tm1p.ini.

Para obter detalhes, consulte “Acesso Anônimo e o Servidor Cognos TM1 ” napágina 197.

ConnectLocalAtStartupIndica se o IBM Cognos TM1 Architect ou o IBM Cognos TM1 Perspectives seconecta automaticamente ao servidor local na inicialização.v T (Padrão) - O Cognos TM1 se conecta ao servidor local na inicialização.v F - O Cognos TM1 não se conecta ao servidor local na inicialização.

DataBaseDirectoryUsa o caminho completo para o diretório de dados do servidor local.

É possível especificar vários diretórios de dados, separando os nomes de diretórioscom pontos e vírgulas.

Apêndice C. O Arquivo de Configuração do Cliente Tm1p.ini 277

DimensionDownloadMaxSizeUm valor do limite do número de elementos em uma dimensão, além do qual adimensão é transferida por download e armazenada em cache no cliente IBMCognos TM1 .

Para melhorar o desempenho ao trabalhar com grandes dimensões, incluaDimensionDownloadMaxSize para que as grandes dimensões sejam armazenadasem cache no cliente.

DisplayApplicationsIndica se o grupo de Aplicativos fica visível no Server Explorer na inicialização.v T - O grupo de Aplicativos fica visível no Server Explorer.v F - O grupo de Aplicativos não aparece no Server Explorer.

DisplayChoresIndica se o grupo de Tarefas de Organização de Processos fica visível no ServerExplorer na inicialização.v T - O grupo de Tarefas de Organização de Processos fica visível no Server

Explorer.v F - O grupo de Tarefas de Organização de Processos não aparece no Server

Explorer.

DisplayControlCubesIndica se o grupo de Cubos de Controle fica visível no Server Explorer nainicialização.v T - O grupo de Cubos de Controle fica visível no Server Explorer.v F - O grupo de Cubos de Controle não aparece no Server Explorer.

DisplayCubesIndica se o grupo de Cubos fica visível no Server Explorer na inicialização.v T - O grupo de Cubos fica visível no Server Explorer.v F - O grupo de Cubos não aparece no Server Explorer.

DisplayDimensionsIndica se o grupo de Dimensões fica visível no Server Explorer na inicialização.v T - O grupo de Dimensões fica visível no Server Explorer.v F - O grupo de Dimensões não aparece no Server Explorer.

DisplayExplorerPropertiesWindowIndica se a área de janela de Propriedades fica visível no Server Explorer nainicialização.v T - A área de janela de Propriedades fica visível.v F (Padrão) - A área de janela de Propriedades não aparece.

DisplayProcessesIndica se o grupo de Processos fica visível no Server Explorer na inicialização.v T - O grupo de Processos fica visível no Server Explorer.v F - O grupo de Processos não aparece no Server Explorer.


DisplayReplicationsIndica se o grupo de Replicações fica visível no Server Explorer na inicialização.v T - O grupo de Replicações fica visível no Server Explorer.v F - O grupo de Replicações não aparece no Server Explorer.

ExpandRowHeaderWidthIndica se os Cabeçalhos de Linhas serão automaticamente expandidos paraacomodar a largura da entrada mais longa na coluna.v T (Padrão) - Os cabeçalhos de linhas são expandidos automaticamente.v F - O cabeçalho de linha deve ser manualmente expandido quando necessário.

ExportAdminSvrSSLCertSelecione esta opção se desejar que o certificado de autoridade de certificação queemitiu originalmente o certificado do Servidor Administrativo do IBM CognosTM1 seja exportado a partir do armazenamento de certificados do MicrosoftWindows no tempo de execução.v T (Padrão) - O certificado original é exportado do armazenamento de

certificados do Windows.v F - O certificado original não é exportado.

Em Opções do Cognos TM1 , selecione Usar Armazenamento de Certificados.

Quando esta opção é selecionada, você também deve configurar um valor para oID do Certificado de Exportação na caixa de diálogo Opções do Cognos TM1 ouAdminSvrSSLExportKeyID.

InSpreadsheetBrowserIndica se o In-Spreadsheet Browser ou o Cube Viewer é o navegador padrão.v T - In-Spreadsheet Browser é o navegador padrão. Ao clicar duas vezes em um

cubo ou visualização, ela se abre em um documento do Excel.v F (Padrão) - Cube Viewer é o navegador padrão. Ao clicar duas vezes em um

cubo ou visualização, ela se abre no Cube Viewer.

IntegratedLoginIndica se seu cliente IBM Cognos TM1 usa o Login Integrado ou a segurança doCognos TM1 padrão para efetuar login no servidor Cognos TM1 e em outroscomponentes Cognos TM1 .v T - Cliente usa Login Integrado, no qual seu nome de usuário e sua senha de

login do Microsoft Windows são usados para acessar o servidor Cognos TM1 eoutros componentes.

v F (Padrão) - Cliente usa a segurança do Cognos TM1 padrão, na qual um nomede usuário e uma senha devem ser explicitamente fornecidos, ao efetuar loginno servidor Cognos TM1 e em outros componentes.

Antes de ativar este parâmetro, consulte seu administrador do Cognos TM1 paradeterminar se o Login Integrado está implementado em seu servidor Cognos TM1 .

Em Opções do Cognos TM1 , use Login Integrado.


LanguageIndica o idioma usado na interface do cliente do IBM Cognos TM1 .

Os clientes tentarão ler a partir do código de idioma e usarão isso para configuraro idioma. Esse idioma será usado se ele corresponder a um dos idiomassuportados. Se o idioma inserido não corresponder a um idioma suportado, oinglês será usado.

Para substituir o padrão, é possível configurar Language explicitamente notm1p.ini usando os códigos a seguir:

Language Código


Croata hry

Tcheco csy



Dinamarquês dan

Alemão deu

Espanhol esp

Finlandês fin

Francês fra

Húngaro hun

Italiano ita

Japonês jpn

Cazaque kaz

Coreano kor

Norueguês nor

Polonês pol

Romeno rom

Russo rus

Sueco sve

Turco trk

LocalServerNetworkProtocolDetermina o protocolo que o servidor IBM Cognos TM1 local usa para secomunicar com os clientes. No momento, a única configuração válida é TCP.

MainWindowLayoutInfoGera coordenadas de dimensão e de posição para a janela do Server Explorer;permite que as dimensões e posição do Server Explorer sejam mantidas entresessões.

As coordenadas são geradas automaticamente quando você move ou redimensionaa janela do Server Explorer.


PreviousAdminHostsLista até seis dos Hosts Administrativos acessados mais recentemente a partir dalista de Hosts Administrativos de Opções do IBM Cognos TM1 .

PreviousDataDirectoriesLista até seis dos diretórios de dados acessados mais recentemente na lista deDiretórios de Dados do Servidor Local a partir da janela Opções do IBM CognosTM1 .

Os diretórios acessados em uma única sessão são separados por pontos e vírgulas.Os diretórios acessados em diferentes sessões são separados por vírgulas.

SecurityAssignmentWindowLayoutInfoGera coordenadas de dimensão e de posição para a janela Clientes/Grupos;permite que dimensões e posição de Clientes/Grupos sejam mantidas entresessões.

As coordenadas são geradas automaticamente quando você move ou redimensionaa janela Clientes/Grupos.

SentMsgsToServerCountWarningO parâmetro SentMsgsToServerCountWarning serve apenas para uso dedesenvolvimento. O parâmetro é definido como F por padrão.

Certifique-se de não alterar a configuração padrão.

ShowAdminHostChangeWarningEsse parâmetro indica se um aviso será exibido ou suprimido quando oAdminHost for alterado.v T (Padrão)- Quando um AdminHost for alterado, será exibida uma mensagem

de aviso.v F - Nenhuma mensagem será exibida quando o AdminHost for alterado.

ShowAliasAttributeWarningEsse parâmetro indica se um aviso será exibido ou suprimido quando o Atributode Alias for alterado.v T (Padrão)- Quando um Atributo de Alias for alterado, será exibida uma

mensagem de aviso.v F - Nenhuma mensagem será exibida quando o Atributo de Alias for alterado.

ShowChoresSchedulingWarningEsse parâmetro indica se um aviso será exibido ou suprimido quando aprogramação da tarefa de organização de processos for alterada.v T (Padrão)- Quando uma programação da tarefa de organização de processos for

alterada, será exibida uma mensagem de aviso.v F - Nenhuma mensagem será exibida quando uma programação da tarefa de

organização de processos for alterada.


ShowCubeReplicationWarningEsse parâmetro indica se um aviso será exibido ou suprimido quando um cubo forreplicado.v T (Padrão) - Quando um cubo for replicado, será exibida uma mensagem de

aviso.v F - Nenhuma mensagem será exibida quando um cubo for replicado.

ShowDimDeleteElementWarningEsse parâmetro indica se um aviso será exibido ou suprimido quando umelemento de dimensão for excluído.v T (Padrão)- Quando um elemento de dimensão for excluído, será exibida uma

mensagem de aviso.v F - Nenhuma mensagem será exibida quando um elemento de dimensão for

excluído.

ShowDimensionAccessWarningEsse parâmetro indica se um aviso será exibido ou suprimido quando umadimensão for acessada.v T (Padrão)- Quando uma dimensão for acessada, será exibida uma mensagem de

aviso.v F - Nenhuma mensagem será exibida quando uma dimensão for acessada.

ShowDynamicSubsetWarningEsse parâmetro indica se um aviso será exibido ou suprimido quando umSubconjunto Dinâmico for alterado.v T (Padrão)- Quando um Subconjunto Dinâmico for alterado, será exibida uma

mensagem de aviso.v F - Nenhuma mensagem será exibida quando um Subconjunto Dinâmico for

alterado.

ShowPickOperationWarningEsse parâmetro indica se um aviso será exibido ou suprimido quando os dadosforem copiados usando a opção Selecionar Elementos.v T (Padrão)- Será exibida uma mensagem de aviso sempre que os dados forem

copiados usando a opção Selecionar Elementos.v F - Nenhuma mensagem será exibida quando os dados forem copiados usando a

opção Selecionar Elementos.

ShowProcessUNASCIIWarningEntre o armazenamento da sessão, se deve exibir ou suprimir um aviso quandouma origem de dados ASCII é processada.v T (Padrão)- Quando uma origem de dados ASCII for processada, será exibida

uma mensagem de aviso.v F - Nenhuma mensagem será exibida quando uma origem de dados ASCII for

processada.

ShowProcessUNODBCWarningEsse parâmetro indica se um aviso será exibido ou suprimido quando uma origemde dados ODBC for processada.


v T (Padrão)- Sempre que uma origem de dados ODBC for processada, seráexibida uma mensagem de aviso.

v F - Nenhuma mensagem será exibida quando uma origem de dados ODBC forprocessada.

SliceNewWorkbookDetermina quantas fatias são geradas a partir do Cube Viewer.v T - Insere fatias em uma nova pasta de trabalho.v F (Padrão) - Insere fatias em uma nova planilha da pasta de trabalho atual.

SubsetWindowLayoutInfoGera coordenadas de dimensão e de posição para a janela do Editor deSubconjunto; permite que as dimensões e posição do Editor de Subconjunto sejammantidas entre sessões.

As coordenadas são geradas automaticamente quando você move ou redimensionaa janela do Editor de Subconjunto.

TM1RebuildDefaultDetermina se as planilhas são recalculadas na abertura por padrão

Por padrão, quando você corta uma visualização no Microsoft Excel a partir doIBM Cognos TM1, a pasta de trabalho contém uma variável nomeada pelo nível depasta de trabalho, TM1RebuildOption, que é configurada como 1. Isto faz com queas planilhas no catálogo sejam reconstruídas na abertura (forçando que umrecálculo ocorra em cada folha no catálogo). Esta ação é necessária se as folhascontêm Formulários Ativos. Se não estiver trabalhando com Formulários Ativos,você não poderá desejar que todas as pastas de trabalho usem este comportamentopadrão.

Todas as planilhas são recalculadas quando uma pasta de trabalho do Cognos TM1é aberta. A pasta de trabalho foi criada por cortes a partir do Cognos TM1Perspectives e contém a variável nomeada pelo nível da pasta de trabalhoTM1RebuildOption = 1.

Por padrão, a partir do Cognos TM1 9.4.1, todos os novos catálogos criados porcortes possuem uma variável nomeada pelo nível da pasta de trabalhoTM1RebuildOption=1 neles. Isto faz a pasta de trabalho ser reconstruída na abertura,causando um recálculo de todas as folhas que são importantes para FormuláriosAtivos mas podem não ter o comportamento desejado se você está trabalhandoprincipalmente com planilhas de Formulário Não Ativo.

Para evitar que as folhas usem o padrão de sempre reconstruir ao cortar, altereTM1RebuildDefault de T para F (ou inclua TM1RebuildDefault=F se ele ainda nãoexistir) em seu arquivo tm1p.ini. Quando TM1RebuildDefault=F, os catálogos têm avariável nomeada no nível da pasta de trabalho configurada comoTM1RebuildOption=0 on slicing. Isto é equivalente a como o Cognos TM1trabalhava antes da introdução dos Formulários Ativos.

Se esta opção for configurada como T ou não existir, o corte a partir de umavisualização no Cognos TM1 Perspectives configurará a variável nomeada no nívelda pasta de trabalho TM1RebuildOption como 1, o que força a reconstrução naabertura. Se esta opção for F, a variável de nome TM1RebuildOption será


configurada como 0, o que não reconstrói. Para um relatório específico, porexemplo, um Formulário Ativo, é possível configurar a variável de nome como 1em vez do padrão 0.

Por padrão, uma nova instalação não possui o parâmetro TM1RebuildDefault, oqual fornece o comportamento padrão de corte com TM1RebuildOption=1.


Apêndice D. Configurando Instalações e Configurações NãoAssistidas

Defina uma instalação e uma configuração não assistidas para instalar umaconfiguração idêntica em vários computadores em sua rede ou automatizar oprocesso de instalação e configuração especificando opções e configurações parausuários.

Antes de definir uma instalação e uma configuração não assistidas, assegure quetodos os requisitos e pré-requisitos do sistema sejam atendidos e que todos osprodutos de terceiros sejam instalados e configurados.

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. Use um arquivo de configuração pré-configurado de um outro computador.4. Execute a ferramenta de configuração no modo silencioso.

Instalações não AssistidasUse um arquivo de especificação de transferência (.ats) para copiar componentesdo IBM Cognos em seu computador sem que seja solicitada nenhuma informação.

Por padrão, toda vez que você instala os componentes IBM Cognos usando oassistente de instalação, as opções selecionadas são registradas em um arquivo deespecificação de transferência. Portanto, se você já instalou os componentes IBMCognos em um computador de amostra, será possível usar o arquivo deespecificação de transferência gerado como um modelo para instalações nãoassistidas em computadores diferentes.

Se o assistente de instalação não for utilizado para instalar componentes, serápossível utilizar o arquivo de especificação de transferência padrão chamadoresponse.ats que está disponível no disco. É necessário modificar o arquivoresponse.ats para seu ambientes antes de poder utilizá-lo em instalaçõesautônomas.

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.

Configurando uma Instalação não AssistidaUse os seguintes códigos do produto TM1 para uma instalação não assistida.

Procedimento

Siga as instruções descritas em Configurando uma Instalação Não Assistida(http://publib.boulder.ibm.com/infocenter/cbi/v10r1m0/index.jsp?topic=%2Fcom.ibm.swg.im.cognos.inst_cr_winux.10.1.0.doc%2Finst_cr_winux_id28690c8bi_SetUpUnattendedInstallation.html) substituindo osseguintes códigos do produto TM1.


http://publib.boulder.ibm.com/infocenter/cbi/v10r1m0/index.jsp?topic=%2Fcom.ibm.swg.im.cognos.inst_cr_winux.10.1.0.doc%2Finst_cr_winux_id28690c8bi_SetUpUnattendedInstallation.html

Tabela 32.

Código do Produto Produto

TM1APPTIER_APP=1 TM1 Applications Tier

TM1SERVER_APP=1 TM1 Server

TM1ADMINSERVER_APP=1 Servidor Admin de TM1

TM1TOOLS_APP=1 TM1 Tools

TM1WEBAPPTIER_APP=1 TM1 Web Applications Tier

TM1CONTRIBGATEWAY_APP=1 TM1 Applications Gateway

TM1CONTRIBSERVICE_APP=1 TM1 Applications Server

TM1WEB_APP=1 TM1 Web

TM1OPERATIONSCONSOLE_APP=1 TM1 Operations Console

TM1CLIENTTIER_APP=1 TM1 Client Tier

TM1PERSPECTIVES_APP=1 TM1 Perspectives

TM1COGNOSINSIGHT_APP=1 Cognos Insight

TM1APIS_APP=1 TM1 API

TM1DEVTIER_APP=1 TM1 Developer Tier

TM1ARCHITECT_APP=1 TM1 Architect

TM1PERFMOD_APP=1 TM1 Performance Modeler

TM1SAMPLETIER_APP=1 TM1 Sample Tier

É possível ver o conteúdo desse arquivo no local tm1_location/instlog no arquivo.ats.

Configurando uma Configuração Não AssistidaAntes de fazer uma configuração não assistida, você deve exportar umaconfiguração de um outro computador que tem os mesmos componentes do IBMCognos TM1 instalados. É possível então executar o IBM Cognos Configuration nomodo silencioso.

A configuração exportada contém as propriedades dos componentes do CognosTM1 que você instalou no computador de origem. Se fizer mudanças àconfiguração global, será preciso também copiar o arquivo de configuração globaldo computador de origem para o computador onde planeja executar umaconfiguração não assistida.

Antes de Iniciar

Assegure que as definições de configuração no computador local sejamapropriadas para uso na configuração de um outro computador com os mesmoscomponentes instalados.

Procedimento1. 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.3. Na caixa Nome de arquivo, digite um nome para o arquivo de configuração.4. Clique em Salvar.


5. Copie o arquivo de configuração exportado a partir do computador de origemou do local de rede no diretório tm1_location/configuration no computadorno qual planeja executar uma configuração não assistida.

6. Renomeie o arquivo para cogstartup.xml.7. Se você alterou a configuração global no computador de origem, copie o

arquivo coglocale.xml do computador de origem para o diretóriotm1_location/configuration no computador no qual planeja executar umaconfiguração não assistida.

8. Acesse o diretório tm1_location/bin.9. Digite o comando de configuração:

cogconfig.bat -s

Para visualizar mensagens de log que foram geradas durante uma configuraçãonão assistida, consulte o arquivo cogconfig_response.csv no diretóriotm1_location/logs.

Resultados

Verifique se a configuraçã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.

O Cognos Configuration aplica as definições de configuração especificadas nacópia local do cogstartup.xml, criptografa as credenciais, gera certificados digitaise, se aplicável, inicia o serviço ou processo do IBM Cognos.

Configurando uma Desinstalação Não AssistidaConfigure uma desinstalação não assistida para automatizar a remoção decomponentes em diversos computadores que têm os mesmos componentes ou pararemover componentes em um ambiente UNIX ou Linux que não tem o MicrosoftXWindows.

Procedimento1. Acesse tm1_locaton/instlog.2. Abra o arquivo de especificação de transferência .ats para o produto em um

editor de texto.O formato de nome do arquivo do arquivo .ats da especificação detransferência é ts-product_code-version-yyyymmdd_hhmm.ats

Consulte “Configurando uma Instalação não Assistida” na página 285 paraobter uma lista dos códigos do produto TM1.É necessário editar somente um arquivo .ats por produto.

3. Na seção chamada [Component List], especifique os componentes a seremremovidos.v Para remover o componente, digite 1

v Para deixar o componente instalado, digite 0

Por padrão, todos os componentes instalados estão configurados para seremremovidos.

4. Salve e feche o arquivo.5. Repita as etapas de 2 a 4 para cada produto instalado.6. Na linha de comandos do sistema operacional, vá para o diretório

tm1_location/uninstall.

Apêndice D. Configurando Instalações e Configurações Não Assistidas 287

7. No prompt de comandos, digite o seguinte comando:v No Windows,

uninst -u -s

v No UNIX ou Linux,./uninst -u -s

v No UNIX ou Linux sem XWindows,./uninstnx -u -s


Apêndice E. Resolvendo um Problema

Resoluçã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.

Responder às questões a seguir pode ajudá-lo a identificar a origem de umproblema que está ocorrendo com um produto IBM Cognos:1. A configuração é suportada?2. O que você está fazendo quando o problema ocorre?

v Planejamentov Instalação do produtov Fazendo upgrade ou migrando o produtov Fazendo tarefas de administração do sistema ou configuraçãov Desenvolvendo aplicativosv Ativando ou implementando o produtov Executando o produtov Instalando ou fazendo mudanças nos produtos de hardware ou software

relacionadosv Recuperando ou reiniciando o produto ou sistemav Diagnosticando um problema ou executando um auxílio de diagnóstico

3. O problema está relacionado ao software IBM Cognos? Se sim, quais, se houver,mensagens de erro ou códigos de erro foram emitidos?

4. É possível reproduzir o problema para garantir que não é só um simples erro?5. Você verificou locais, diretórios, caminhos e acesso de arquivo?6. Você revisou toda a documentação relevante, incluindo notas sobre a liberação

e notas técnicas?7. Você verificou se quaisquer mudanças recentes em seu ambiente de

computação pode ser responsável pelo problema?8. Se estas perguntas e respostas não o levarem a uma resolução, poderão ser

necessárias informações adicionais ou você poderá precisar coletar dadosdiagnósticos. Esses dados são necessários para que um representante desuporte técnico da IBM solucione problemas de forma efetiva e o ajude naresolução do problema.

Cognos Information CentersOs IBM Cognos Information Centers incluem documentação para cada liberação.Esta documentação também está disponível por meio de menus de ajuda doproduto.

Todos os Centros de Informações do Cognos, incluindo toda a documentaçãotraduzida, estão disponíveis no centro de informações do IBM Cognos BusinessIntelligence and Performance Management.

Para localizar links para os problemas conhecidos e os Authorized ProgramAnalysis Reports (APARs) mais recentes, acesse as notas sobre a liberaçãodisponíveis em cada Centro de Informações.




Support PortalO 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 todos os recursos de suporte IBM a partir deum local. É possível padronizar as páginas para focar nas informações e recursosnecessários para prevenção de problemas e uma resolução de problemas maisrápida. Familiarize-se com o IBM Support Portal visualizando os vídeos de demo.

Localize o conteúdo do Cognos necessário selecionando seus produtos a partir doIBM Support Portal.

Reunindo InformaçõesAntes de contatar o Suporte IBM, será necessário coletar dados diagnósticos(informações do sistema, sintomas, arquivos de log, rastreios, etc.) que sãonecessários para resolver um problema. Reunir estas informações ajudará afamiliarizá-lo com o processo de resolução de problemas e poupar seu tempo.

Informações sobre quais dados coletar estão disponíveis no formulário de notastécnicas MustGather.

Solicitações de ServiçoAs solicitações de serviço também são conhecidas como Relatórios deGerenciamento de Problemas (PMRs). Existem vários métodos para submeterinformações de diagnóstico para o IBM® Software Technical Support.

Para abrir um PMR ou para trocar informações com o suporte técnico, visualize apágina Trocando Informações com o Suporte Técnico do Suporte ao Software IBM.Os PMRs também podem ser submetidos diretamente usando a ferramenta desolicitações de serviço (PMRs) ou um dos outros métodos suportados detalhadosna página Trocando Informações.

Support Assistant LiteO IBM Support Assistant é uma oferta de software complementar que fornece umambiente de trabalho para ajudá-lo na determinação de problema.

O IBM Cognos suporta atualmente o IBM Support Assistant Lite. Este utilitárioautomatiza a coleção de dados específica do produto. Ele identifica os arquivos dedados que analistas do Suporte IBM precisam para diagnosticar e recuperar-se deproblemas operacionais ocasionais com produtos IBM.

Cognos Customer CenterO IBM Cognos Customer Center fornece informações, atualizações e recursos deresolução de problemas específicos do Cognos.

Para visualizar informações de resolução de problemas do Cognos, acesse oCognos Customer Center e visualize as informações em "Contatando o Suporte" ou"Solucionando Problemas de Recursos"


https://www.ibm.com/blogs/SPNA/entry/the_ibm_support_portal_videos

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

http://www-01.ibm.com/software/data/support/cognos_mustgather.html

http://www-01.ibm.com/software/data/support/cognos_mustgather.html

http://www-01.ibm.com/software/support/exchangeinfo.html

http://www-947.ibm.com/support/entry/portal/Open_service_request/Software/Information_Management/Cognos_Business_Intelligence_and_Financial_Performance_Management

http://www-947.ibm.com/support/entry/portal/Open_service_request/Software/Information_Management/Cognos_Business_Intelligence_and_Financial_Performance_Management


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

Fix CentralO Fix Central fornece correções e atualizações para seu software, hardware esistema operacional.

Use o menu suspenso para navegar para suas correções de produtos no FixCentral. Também é possível visualizar a ajuda do Fix Central..

Ferramentas de Determinação de ProblemasVárias ferramentas de determinação de problemas do IBM Cognos estãodisponíveis para diagnosticar e solucionar problemas comuns.

Estas ferramentas podem ser transferidas por download a partir da páginaUtilitários de Diagnóstico do Cognos. O IBM Education Assistant fornece vídeo eoutros recursos de treinamento em algumas destas ferramentas de diagnósticonoWeb site Determinação de Problema do IBM Education Assistant.

Fóruns e ComunidadesOs fóruns do produto IBM Cognos oferecem um local para compartilhar ideias esoluções com seus parceiros na comunidade do IBM Cognos.

Os fóruns do Cognos ativos estão disponíveis em Fóruns e Comunidades doCognos.

Business Analytics Support NotebookO Business Analytics Support Notebook fornece notícias e atualizações do IBMBusiness Analytics Support (incluindo Cognos e SPSS).

Visualize as atualizações de informações mais recentes, incluindo atualizações devídeo, em Business Analytics Support Notebook.

Feeds RSS de Suporte de SoftwareOs feeds RSS de Suporte ao Software IBM são um formato rápido, fácil e leve demonitorar o novo conteúdo incluído nos websites.

Após download de um leitor RSS ou plug-in do navegador, é possível subscreveros feeds do produto IBM em Feeds RSS do Suporte ao Software IBM.

Procurando e Navegando por Produtos CognosO acesso às informações do produto IBM Cognos agora pode ser configurado noIBM Support Portal, que fornece a capacidade de ver todos os seus links em umaúnica página.

Melhores práticas para procurar e navegar por informações do produto Cognosestão disponíveis na página Melhores Práticas de Procura do IBM Cognos SupportPortal e da Nota Técnica.

Apêndice E. Resolvendo um Problema 291

http://www-933.ibm.com/support/fixcentral/

http://www-933.ibm.com/support/fixcentral/

http://www-947.ibm.com/systems/support/fixes/en/fixcentral/help/getstarted.html

http://www-01.ibm.com/software/data/support/cognos_diagnostictools.html

http://www-01.ibm.com/software/data/support/cognos_diagnostictools.html

http://publib.boulder.ibm.com/infocenter/ieduasst/imv1r0/index.jsp?topic=/com.ibm.iea.cognos/cognos/8.0/ProblemDetermination.html

http://www.ibm.com/developerworks/data/community/#cognos

http://www.ibm.com/developerworks/data/community/#cognos

https://www.ibm.com/developerworks/mydeveloperworks/blogs/roller-ui/rendering/feed/cognossupport/entries/atom?lang=en

https://www-01.ibm.com/software/support/rss/

https://www-304.ibm.com/support/docview.wss?uid=swg21373237

https://www-304.ibm.com/support/docview.wss?uid=swg21373237


Avisos

Estas informações foram desenvolvidas para produtos e serviços oferecidos emtodo o mundo.

É 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 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 utilizados. Qualquerproduto, programa ou serviço funcionalmente equivalente, que não infrinjanenhum direito de propriedade intelectual da IBM poderá ser utilizado 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 na autorização de licença quevocê adquiriu.

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 garante direitoalgum sobre tais patentes. Pedidos de licença devem ser enviados, por escrito,para:

Gerência de Relações Comerciais e Industriais da IBM BrasilAv. Pasteur, 138-146BotafogoRio de Janeiro, RJCEP 22290-240

Para pedidos de licença relacionados 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 pedidos de licença, por escrito, para:

Intellectual Property LicensingLegal and Intellectual Property LawIBM Japan Ltd.1623-14, Shimotsuruma, Yamato-shiKanagawa 242-8502 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 exclusão de garantias expressas ou implícitas em certas transações; portanto, essadisposição pode não se aplicar ao Cliente.

Essas informações podem conter imprecisões técnicas ou erros tipográficos. Sãofeitas alterações periódicas nas informações aqui contidas; tais alterações 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 desseproduto IBM e a utilização desses Web sites é de inteira responsabilidade doCliente.

A IBM pode utilizar 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 comobjetivo de permitir: (i) a troca de informações entre programas criadosindependentemente e outros programas (incluindo este) e (ii) a utilização mútuadas informaçõ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 Contrato com o Cliente IBM,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 meio de extrapolação. Os resultados reaispodem variar. Os usuários deste documento devem verificar os dados aplicáveispara seu ambiente 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 fontesdisponí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 alterações ou cancelamento sem aviso prévio e representam apenas metase objetivos.

Estas informações contêm exemplos de dados e relatórios utilizados nas operaçõesdiárias de negócios. Para ilustrá-los da forma mais completa possível, os exemplos


podem incluir nomes de indivíduos, empresas, marcas e produtos. Todos estesnomes são fictícios e qualquer semelhança com nomes e endereços utilizados poruma empresa real é mera coincidência.

Se estas informações estiverem sendo exibidas em cópia eletrônica, as fotografias eilustrações coloridas podem não aparecer.

Marcas Registradas

IBM, o logotipo IBM, ibm.com, TM1 e Cognos são marcas ou marcas registradas daInternational Business Machines Corp., registradas em vários países no mundotodo. Outros nomes de produtos e serviços podem ser marcas registradas da IBMou de outras empresas. Uma lista atual de marcas registradas da IBM estádisponível na Web em “ Copyright and trademark information ” emwww.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 Linux é uma marca registrada de Linus Torvalds nos Estados Unidos e/ou emoutros países.

v UNIX é uma marca registrada do The Open Group nos Estados Unidos e 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 295

http://www.ibm.com/legal/copytrade.shtml


Índice Remissivo

Caracteres Especiais.NET 3.5 SP1 Framework 14.NET Framework 18

Numéricos32 bits 3764 bits 37

Aacesso

privilégios, diretório de dados 28AdminHost 233, 276AdminSvrSSLCertAuthority 276AdminSvrSSLCertID 207, 276AdminSvrSSLCertRevList 207, 276AdminSvrSSLExportKeyID 207, 276AdvancedRulesEditor 276AllowImportCamClients 277AllowImportCAMClients 198AllowReadOnlyChore Reschedule 233AllowSeparateNandCRules 62, 234AllRuleCalcStargateOptimization 234Amostra de Planejamento 114

Iniciar 60, 68amostra GO 116amostras 113Apache tomcat

remover implementação 227aplicativo da web 34Aplicativos de TM1

camada de dados 34com a segurança do IBM Cognos BI 162com tempo limite da sessão de segurança do IBM

Cognos 165, 201desinstalando o Applications 227em execução 62instalando em um único computador 41modo de autenticação de segurança 40, 85, 89, 94, 174opções de implementação 40usando com diversos servidores TM1 168

Architect 27Armazenamento CalculationThresholdFor 236arquitetura 23arquitetura da Web 29arquivo .cfg 28, 231arquivo .ini 28, 275arquivo .rej 25arquivo de inicialização 28, 275arquivo de log de transações 25arquivo response.ats 285Arquivo Tm1p.ini 28, 275Arquivo Tm1s.cfg 28, 231

amostra 231local 231parâmetros 232

arquivos de configuração 17aspas 232ASPNET 19

atalhos de teclado 229Cognos Configuration 230

Ativar Macros 61atualizando para o Cognos TM1 Applications 52AuditLogMaxFileSize 235AuditLogMaxQueryMemory 235AuditLogMaxTempFileSize 235AuditLogOn 236AuditLogUpdateInterval 236autenticação 171, 174, 197

diagrama de login integrado 172importando grupos no TM1 199login integrado 171para TM1 Viewer Portlets 141

autenticação, diagrama LDAP 173autenticação, LDAP 171autenticação do Cognos 174, 197

definindo um administrador 198Autenticação LDAP 193

configurando a validação 196ETLDAP 196modificando as designações do grupo 196parâmetros 194TM1S.cfg 196validando usuários 193

Autoridade AdminSvrSSLCert 207

Bbackup

Aplicativos de TM1 223, 226Backup de dados 49Backup de versão anterior 49banco de dados de amostras GOSALES 117BD OLE 37BrowseDisplayReadsRightToLeft 277

Ccaixa de diálogo Ferramenta de Carregamento LDAP 177camada 2 34camada 3 34CAMID 174, 197caminho de classe 130CAMPortalVariableFile 238CAMSSLCertificate 237caracteres ASCII em nomes de diretório 58caracteres não ascii e movimentação 73cenário de instalação 57certificado 216

armazenamento 205autoridade 205revogação 205

certificados 204, 217chave de identidade 205chave privada 205CheckFeedersMaximumCells 237ClassicSliceMode 277ClientCAMURI 237clientes não SSL 205


ClientExportSSLSvrCert 207ClientExportSSLSvrKeyID 207ClientMessagePortNumber 238ClientPingCAMPassport 238ClientPropertiesSyncInterval 239ClientVersionMaximum 239ClientVersionMinimum 240ClientVersionPrecision 240codificação de caracteres 73códigos de idioma 150, 151códigos do produto 285Cognos Configuration 58, 68Cognos Connection 60Cognos Insight 58

em execução 63instalando 63, 109

Cognos TM1 Applicationsvisão geral da arquitetura 31

Cognos TM1 Operations Console 126, 130Cognos TM1 Performance Modeler

instalando 105CognosGatewayURI 198, 277CognosInterfacePath 241comandos do sistema de 64 bits 126, 130Companhia de Aventuras de Amostra 117componentes 57componentes adicionais 223componentes do cliente 9componentes do servidor 9componentes do TM1 9conectando-se a um servidor 182conectividade SAP 144conexão de replicação 203configuração 16configuração da página de login 80, 156configuração do código de idioma 39configuração do idioma 150, 152configuração regional 39configurações padrão 15configurando a validação 196configurando componentes 71configurar 60, 68configurar a página de login 80, 156conjunto de aplicativos 188conjunto de aplicativos da web 188ConnectLocalAtStartup 277Conta de Serviço do TM1 17controles de gráfico 20Controles de Gráfico 14credenciais de login 61criptografar 205

DDataBaseDirectory 241, 277decriptografar 205DefaultMeasuresDimension 242designações de grupo 196desinstalação 224, 287

interoperabilidade do TM1 BI 141TM1 Viewer Portlets 141

DHFile-1024 205, 207DHFile-512 205, 207Diffie-Hellman 205DimensionDownloadMaxSize 278diretório de dados

acesso à rede necessário 28

diretório de dados (continuação)caminho 27definição 27diversos 28privilégio de acesso 28segurança 28servidor local 28servidor remoto 28

diretório de dados do caminho 27DisableMemoryCache 242DisableSandboxing 242DisableWorksheetView 243Display_Info_DBType_R8 243DisplayApplications 278DisplayChores 278DisplayControlCubes 278DisplayCubes 278DisplayDimensions 278DisplayExplorerPropertiesWindow 278DisplayProcesses 278DisplayReplications 279DistributedPlanningOutputDir 62, 244diversos Hosts Administrativos 24diversos servidores 31do Express 24, 27domínios

conta 39instalando sem 20

DownTime 244

Eefetuando login

TM1 Operations Console 129, 133Efetuar Logon Como 203elementos de consulta

LDAP 180Endereço IP 249Enfileiramento 250ETLDAP

atributo de registro modificado LDAP 184atributos de mapeamento LDAP para campos TM1 183atualizando o TM1 com novos usuários LDAP 184Botão Exportar 177botão Procurar 177campo Atributos 177Campo DN de Procura 177campo Filtro 177conectando-se a um servidor 182configurando parâmetros de login de LDAP 178construindo a consulta LDAP 180elementos de consulta LDAP 180executando a partir do DOS 177executando no modo de atualização 184exportando os usuários LDAP para TM1 183modificando atributos LDAP 175opção Escopo da Procura 177opções de exportação 183Tabela de Resultados 177

ETLDAP, autenticação LDAP 196ExcelWebPublishEnabled 245ExpandRowHeaderWidth 279ExportAdminSvrSSLCert 207, 279exportando dados PDF 65, 155exportar para configuração do código de idioma em PDF 168ExportSvrSSLCert 205, 207, 219extensão do arquivo .blb 26


extensão do arquivo .cho 26extensão do arquivo .cub 26extensão do arquivo .dim 26extensão do arquivo .dit 26extensão do arquivo .pro 26extensão do arquivo .rux 26extensão do arquivo .sub 26extensão do arquivo .tbu 26extensão do arquivo .tqu 26extensão do arquivo .tru 26extensão do arquivo .vue 26extensão do arquivo .xdi 26extensão do arquivo .xru 26extensões do arquivo 26

Ffazendo backup dos dados 223Ferramentas 137Fila de Tarefas 250Firefox 192funções do TurboIntegrator 168

restringindo a execução do 170

GGO_New_Stores 115

Iniciar 60, 68GroupsCreationLimit 246grupo de usuários do TM1 Operations Console 127, 131grupos de usuários do TM1 Operations Console 128, 132

IIBM AIX

comandos não suportados com TM1 72executando o TM1 com 72limites de recurso de memória 72

idioma 39idioma para clientes 280IdleConnectionTimeOutSeconds 247IIS 42, 188IIS 5 188IIS 6 188IIS 7 78IIS_WPG 188implementação 34implementando

TM1 Operations Console 127, 131impressora padrão 65, 155incluindo um servidor 73incluir e remover programas 50inicialização 19

propriedades 18Iniciando 135Iniciar 115

serviços 60, 68servidor Cognos Application 85TM1 Operations Console 129, 133

iniciar IBM Cognos Configuration 71Insight

restrições da função do TurboIntegrator 168InSpreadsheetBrowser 279instalação 15instalação da web de diversos computadores 79instalação de diversos computadores 67

instalação distribuída 38instalação do cliente 7, 101instalação do TM1 Applications 34instalação do TM1 Server no Linux 69instalação do TM1 Server no Unix 69instalação do TM1 Server no Windows 67instalação do UNIX 7instalação do Windows de 32 bits 7instalação do Windows de 64 bits 7instalação não assistida 285, 287instalação silenciosa 285instalando 137

IBM Cognos BI 285instalação não assistida 285usando arquivo de especificação de transferência

(.ats) 285instalando clientes TM1 101IntegratedLogin 279IntegratedSecurityMode 247Interação Paralela

parâmetro JobQueueThreadPoolSize 251parâmetro ParallelInteractiong 259

Internet Explorer 192interoperabilidade 139Interoperabilidade 7, 238interoperabilidade do TM1 BI 139

desinstalação 141intervalo de pulsação 24introdução xiIPAddress 248

Jjanela de comando DOS 177Java 42

SSL 215JobQueueMaxWaitTime 250JobQueueThreadSleepTime 251

KKerberos 188

LLanguage 251LDAP

atributo de registro modificado 184atributos de mapeamento para campos TM1 183atualizando o TM1 com novos usuários 184autenticação 171, 173configurando os parâmetros de login 178construindo uma consulta 180executando ETLDAP no modo de atualização 184exportando os usuários para TM1 183modificando atributos 175

LDAPHost 194LDAPPasswordFile 194, 195, 252LDAPPasswordKeyFile 194, 195, 252LDAPPort 194LDAPSearchBase 194LDAPSearchField 194LDAPUseServerAccount 194, 195, 252LDAPWellKnownUserName 194limitando 31

Índice Remissivo 299

Linuxiniciar o servidor TM1 71instalação 70instalação do TM1 Server 69

locais 15localização de informações xiLocalServerNetworkProtocol 280LockPagesInMemory 253log

arquivo 25LoggingDirectory 253login 201login, integrado 185login integrado 171, 172, 192

Architect 192campo UniqueID 185configurando 186configurando manualmente 188cubo }ClientProperties 185direitos de acesso 187Kerberos 188TM1 Perspectives 193TM1 Web 188, 193visão geral 185

LogReleaseLineCount 253

MMainWindowLayoutInfo 280manter instalação 223MaskUserNameInServerTools 253MaximumCubeLoadThreads 254MaximumLoginAttempts 255MaximumMemoryForSubsetUndo 255MaximumTILockObject 256MaximumUserSandboxSize 257MaximumViewSize 257MaxUndoHoldLineCount 257MessageCompression 258metadados 25Microsoft .Net 58Microsoft Internet Explorer 192Microsoft Visual C++ 58modificação de componentes 224modificando

designações de grupo 196modificar instalação 224modo de autenticação de segurança

Aplicativos de TM1 40, 85, 89, 94, 174Mozilla 192

NNetRecvBlockingWaitLimitSeconds 258NetRecvMaxClientIOWaitWithinAPIsSeconds 258no Websphere 134nome de usuário 21

padrão para amostras 15Nome do Principal de Serviço 188nomes de objetos do TM1 73nomes e códigos de idioma não ascii 73novos clientes 200Novos recursos de instalação 1números de porta 15

Oopções de implementação 37

PPackage Connector Windows 7 144Parâmetro AdminHost 211, 215

SSL 207parâmetro de configuração CognosTM1InterfacePath 146parâmetro JobQueueThreadPoolSize 251parâmetro Language para clientes 152parâmetro Language para o servidor 152parâmetro MaximumSynchAttempts 255Parâmetro PersistentFeeders 260Parâmetro SyncUnitSize 270Parâmetro Tm1s.cfg necessário

AdminHost 233CAMPortalVariableFile 238CAMSSLCertificate (depende do CAM) 237DataBaseDirectory 241UseSSL (para SSL) 271

Parâmetro Tm1s.cfg Opcional 195, 252AllowReadOnlyChore Reschedule 233AllowSeparateNandCRules 234AllRuleCalcStargateOptimization 234AuditLogMaxFileSize 235AuditLogMaxQueryMemory 235AuditLogMaxTempFileSize 235AuditLogOn 236AuditLogUpdateInterval 236CalculationThresholdForStorage 236CAMSSLCertificate 237CheckFeedersMaximumCells 237ClientCAMURI 237ClientMessagePortNumber 238ClientPingCAMPassport 238ClientPropertiesSyncInterval 239ClientVersionMaximum 239ClientVersionMinimum 240ClientVersionPrecision 240CognosInterfacePath 241DefaultMeasuresDimension (pode ser necessário

OLAP) 242DisableMemoryCache 242DisableSandboxing 242DisableWorksheetView 243Display_Info_DBType_R8 243DistributedPlanningOutputDir 244DownTime 244ExcelWebPublishEnabled 245ForceReevaluationOfFeedersForFedCellsOnDataChange 245GroupsCreationLimit 246IdleConnectionTimeOutSeconds 247IntegratedSecurityMode 247IPAddress 248IPV6 249JobQueueMaxWaitTime 250JobQueueThreadSleepTime 251JobQueuing 250Language 251LDAPPasswordKeyFile 195, 252LDAPUseServerAccount 195, 252LockPagesInMemory 253LoggingDirectory 253LogReleaseLineCount 253MaskUserNameInServerTools 253


Parâmetro Tm1s.cfg Opcional (continuação)MaximumCubeLoadThreads 254MaximumLoginAttempts 255MaximumMemoryForSubsetUndo 255MaximumSynchAttempts 255MaximumTILockObject 256MaximumUserSandboxSize 257MaximumViewSize 257MaxUndoHoldLineCount 257MessageCompression 258NetRecvBlockingWaitLimitSeconds 258NetRecvMaxClientIOWaitWithinAPIsSeconds 258PasswordMinimumLength 259PasswordSource 194, 259PerformanceMonitorOn 259PortNumber 260PrivilegeGenerationOptimization 260ProgressMessage 261ProportionSpreadToZeroCells 262RawStoreDirectory 263ReceiveProgressResponseTimeoutSecs 263RulesOverwriteCellsOnLoad 264RunningInBackground 264SAPLogFilePath 265SAPLoggingEnabled 264SaveTime 265SecurityPackageName 265ServerCAMURI 266ServerLogging 266ServerName 266ServicePrincipalName 266SkipLoadingAliases 267SkipSSLCAMHostCheck 267SpreadingPrecision 267StartupChores 269SubsetElementBreatherCount 269SyncUnitSize 270UseExtendedFetch 270UseLocalCopiesforPublicDynamicSubsets 270UserDefinedCalculations 270UseSQLFetch 270UseSQLFetchScroll 270UseStargateForRules 271ViewConsolidationOptimization 272ViewConsolidationOptimizationMethod 272

parâmetrosSSL 205

parar Contributor 48parar serviços 48, 226passaporte 174, 197passaporte de segurança Cognos 174, 197PasswordMinimumLength 259PasswordSource 194, 259pdata 27Performance Modeler 58

instalando 63PerformanceMonitorOn 259Planejamento 7planejamento de Upgrade 47planilhas da web 64ponto como domínio local 21porta SSL 15portlets 139PortNumber 260PreviousAdminHosts 281PreviousDataDirectories 281PrivilegeGenerationOptimization 260

privilégios de administrador 58privilégios na Conta do Serviço 17ProgressMessage 261ProportionSpreadToZeroCells 262

RRawStoreDirectory 263ReceiveProgressResponseTimeoutSecs 263recursos alterados 3recursos de acessibilidade 229regras de logon 202Remover versão anterior 50requisitos 14Requisitos do TM1 Package Connector 143resolução de problemas

identificando problemas 289restaurando arquivos de amostra de backup para Microsoft

SQL 123restaurando dados após o upgrade 55restaurar arquivos de backup para Oracle 120restaurar banco de dados de amostras no DB2 118revogação 205RulesOverwriteCellsOnLoad 264Run as Administrator 58RunningInBackground 264

Ssalvando dados 25SAPLogFilePath 265SAPLoggingEnabled 264SaveTime 265sdata 27Sdata 114SData

Iniciar 60, 68SecurityAssignmentWindowLayoutInfo 281SecurityPackageName 265segurança 172

IIS 191para TM1 Viewer Portlets 141

segurança do Cognos 197com tempo limite de sessão do TM1 Applications 165, 201com TM1 Viewer Portlets 141considerações do administrador 201considerações do usuário 202

segurança do Cognos BIcom o TM1 Applications 162

senhapadrão para amostras 15

senhas 205SentMsgsToServerCountWarning 281ServerCAMURI 266ServerLogging 266ServerName 266ServicePrincipalName 266serviço do Admin Server 48serviço do BI 48serviço do Excel 19, 48serviço do TM1 Server 48serviços 16servidor 25, 38

diversos 31Servidor Admin de TM1

Iniciar 60, 68


servidor Administrativo 25Servidor Administrativo 24, 38servidor Cognos Application

Iniciar 85servidor da Web 31servidor da web IIS 18servidor local 28servidor remoto 231

diretório de dados 28operações 25

servidor TM1 Application 41, 42servidor TM1 Excel

Iniciar 60servidores

incluindo 73SetSPN.exe 188ShowAdminHostChangeWarning 281ShowAliasAttributeWarning 281ShowChoresSchedulingWarning 281ShowCubeReplicationWarning 282ShowDimDeleteElementWarning 282ShowDimensionAccessWarning 282ShowDynamicSubsetWarning 282ShowPickOperationWarning 282ShowProcessUNASCIIWarning 282ShowProcessUNODBCWarning 283sintaxe da máquina local 21Sintetização 270SkipLoadingAliases 267SkipSSLCAMHostCheck 267SliceNewWorkbook 283software e hardware 14software obrigatório 58Solaris 17SpreadingPrecision 267, 268SSL 203

parâmetros 205TM1 Top 215

SSLCertAuthority 205, 207, 219SSLCertificate 205, 207SSLCertificateID 205, 207, 219SSLCertRevocationFile 205, 207SSLPrivateKeyPwdFile 205, 207, 219SSLPwdKeyFile 205, 207, 219StartupChores 269SubsetElementBreatherCount 269SubsetWindowLayoutInfo 283SupportNonSSLClients 205SvrSSLExportKeyID 205, 207, 219

Tteclas de atalho 229

IBM Cognos Configuration 230tipos de instalação 7TM1 Application

com Microsoft IIS 167configuração do servidor 86, 90, 95implementando no IBM WebSphere 93instalando em computadores separados 42

TM1 Application Serveropções de implementação 40

TM1 Application Webem execução 64

TM1 Architectem execução 61

TM1 da Conta do Serviço 17

TM1 Excel Service 65, 155TM1 Operation Console 134TM1 Operations Console 64, 135

arquivo OpsConfig.xml 128, 132criando grupos de usuários 127, 131efetuando login 129, 133incluindo certificados 126, 130Iniciar 127, 129, 133instalando 125Microsoft Internet Explorer 8 129, 133

TM1 Package Connector 64TM1 Perspectives

em execução 61TM1 Server

iniciando no Linux 71iniciando no UNIX 71Iniciar 60, 68

TM1 Viewer Portlets 64, 139desinstalação 141

TM1 Webcom Windows Vista, Windows 7 e Windows Server

2008 78em execução 61executando no Windows Vista 161IIS 7 78

TM1Crypt 218TM1Functions.cfg 170tm1p.ini

local 275parâmetros 275

TM1RebuildDefault 283TM1S.cfg 196TM1Top 201Turbo Integrator

restringindo execução de função 168

UUNIX

iniciar o servidor TM1 71instalação 70instalação do TM1 Server 69servidor 231

upgrade de computador único 51upgrade do Architect 52upgrade do Contributor para o TM1 Applications 52upgrade do Perspectives 52upgrade do servidor Linux 51upgrade do servidor Unix 51upgrade do servidor Windows 51upgrade do Web 52URI do dispatch 144URI do gateway 144usando a segurança do Cognos 200UserDefinedCalculations 270UseSQLExtendedFetch 270UseSQLFetch 270UseSQLFetchScroll 270UseSSL 207, 271UseStargateForRules 271usuários

incluindo com ETLDAP 175utilitário ClearType Tuner

no servidor da Web 161utilitário ETLDAP 175Utilitário TM1 Top

SSL 215


Vvalidação 196variables_TM1.xml 200variável de ambiente TM1_Package_Connector 145variável do sistema TEMP 58ViewConsolidationOptimization 272ViewConsolidationOptimizationMethod 272Viewer Portlets 238visão geral do upgrade 47Vista

Package Connector 144Visual C++ 2005 SP1 Redistributable Package 14

WWeb client 32WebSphere 134

desinstalação 228Windows

instalação 67Windows 7 58, 78Windows 7 Package Connector 144Windows Server 2008 58, 78Windows Vista 58, 78

configurando para TM1 Web 161
