ibm cognostm1 versão 10.2.2public.dhe.ibm.com/.../docs/pt-br/10.2.2/tm1_inst.pdf · ibm cognostm1...

IBM Cognos TM1Versão 10.2.2.3

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

Informações do Produto

Este documento se aplica ao IBM Cognos TM1 Versão 10.2.2.3 e pode também ser aplicado às liberaçõessubsequentes.

Licensed Materials - Property of IBM

© Copyright IBM Corporation 2007, 2015.

Índice

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

Capítulo 1. O que há de novo . . . . . . . . . . . . . . . . . . . . . . . . . . 1O que há de novo para a instalação e configuração do Cognos TM1 na versão 10.2.2 . . . . . . . . . . . 1

Novas amostras estão disponíveis . . . . . . . . . . . . . . . . . . . . . . . . . . . 1Novos recursos no TM1 Mobile Contributor . . . . . . . . . . . . . . . . . . . . . . . . 1Interoperabilidade do Cognos TM1 para o programa de instalação removido do Cognos BI . . . . . . . . 1Novos arquivos de configuração para usar o Cognos TM1 Web com a segurança do Cognos . . . . . . . 2

O que Há de Novo para a Instalação e a Configuração do Cognos TM1 na Versão 10.2.0 . . . . . . . . . . 3Novos Requisitos de Instalação no Cognos TM1 10.2.0 . . . . . . . . . . . . . . . . . . . . 3Instalação da Documentação Traduzida . . . . . . . . . . . . . . . . . . . . . . . . . 3Agora, o Cognos TM1 Web Usa um Servidor de Aplicativos da Web Baseado em Java. . . . . . . . . . 4Novo Aplicativo Cognos TM1 Mobile Contributor para o Cognos TM1 10.2.0. . . . . . . . . . . . . 5Novas Maneiras de Abrir o Cognos TM1 Performance Modeler . . . . . . . . . . . . . . . . . 6Novas Amostras de Pontuação . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6Nova Integração com o Cognos Analysis for Microsoft Excel . . . . . . . . . . . . . . . . . . 6Novo Parâmetro TM1 Admin Server Certificate Versão para SSL . . . . . . . . . . . . . . . . . 6

Capítulo 2. Planejando sua Instalação do Cognos TM1 . . . . . . . . . . . . . . . 7Programas de Instalação Disponíveis . . . . . . . . . . . . . . . . . . . . . . . . . . . 7Componentes Disponíveis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Componente de Instalação de Camada do Aplicativo do TM1 . . . . . . . . . . . . . . . . . . 9Componente de Instalação Camada do Aplicativo da Web . . . . . . . . . . . . . . . . . . . 10Componente de Instalação de Camada de Cliente do TM1. . . . . . . . . . . . . . . . . . . 11Componente de Camada do Desenvolvedor . . . . . . . . . . . . . . . . . . . . . . . 12Componente de Instalação de Amostras . . . . . . . . . . . . . . . . . . . . . . . . . 13Componente de Instalação de Documentação Traduzida . . . . . . . . . . . . . . . . . . . 13Componentes de Instalação Adicionais Não Listados . . . . . . . . . . . . . . . . . . . . 14

Diferenciação de Cliente do TM1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14Clientes de Usuário Final . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14Clientes de Administração . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

Requisitos de Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17Valores de Instalação Padrão . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18Visão Geral da Configuração . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Cognos Configuration e Cognos TM1. . . . . . . . . . . . . . . . . . . . . . . . . . 20Arquivos e Parâmetros de Configuração do Cognos TM1 . . . . . . . . . . . . . . . . . . . 20

Contas de Usuário para Executar Serviços do Cognos TM1 no Windows . . . . . . . . . . . . . . . 21Instalando o TM1 em Redes sem Domínios . . . . . . . . . . . . . . . . . . . . . . . . . 22

Sintaxe da Máquina Local . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

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

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

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

Arquitetura do Cognos TM1 Applications . . . . . . . . . . . . . . . . . . . . . . . . . 33Camada 1 do Cognos TM1 Applications: Web Clients . . . . . . . . . . . . . . . . . . . . 34Cognos TM1 Applications Camada 2: Servidor da Web . . . . . . . . . . . . . . . . . . . . 35Camada 3 do Cognos TM1 Applications: Dados . . . . . . . . . . . . . . . . . . . . . . 36

© Copyright IBM Corp. 2007, 2015 iii

Capítulo 4. Transporte . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37Implementando 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 ao Usar o Cognos TM1 Applications . . . . . . . . . . . . . . . . 40Implementando Todos os Componentes Cognos TM1 Applications em um Único Computador . . . . . . 41Implementando os Componentes Cognos TM1 Applications em Computadores Separados . . . . . . . . 42

Implementando Aplicativos Clientes do Cognos TM1 . . . . . . . . . . . . . . . . . . . . . 43Implementando o Cognos TM1 Mobile Contributor . . . . . . . . . . . . . . . . . . . . . . 43

Configurando o Cognos TM1 Mobile Contributor para exibir os servidores e cubos do TM1 . . . . . . . 45Visualizando os cubos de marcação de desempenho e diagramas de impacto no Cognos TM1 MobileContributor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46Criando e visualizando os itens da lista de observação do Scorecarding no Cognos TM1 Mobile Contributor . . 47

Capítulo 5. Fazendo Upgrade . . . . . . . . . . . . . . . . . . . . . . . . . . 49Planejando o Upgrade . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50Fazendo o upgrade do Cognos TM1 versão 10.2.0 . . . . . . . . . . . . . . . . . . . . . . 51Atualizando a partir do Cognos TM1 Versão 10.1.x . . . . . . . . . . . . . . . . . . . . . . 52Atualizando do Cognos TM1 Versão 9.x . . . . . . . . . . . . . . . . . . . . . . . . . . 54

Parando os Serviços do Cognos TM1 9.x antes do Upgrade . . . . . . . . . . . . . . . . . . 54Fazendo Backup dos Dados para uma Versão Anterior do Cognos TM1 9.x . . . . . . . . . . . . . 55Desinstalando uma Versão Anterior do IBM Cognos TM1 9.x . . . . . . . . . . . . . . . . . . 56Atualizando a Instalação de um Único Computador do Cognos TM1 . . . . . . . . . . . . . . . 56Atualizando o Cognos TM1 Server no UNIX ou Linux . . . . . . . . . . . . . . . . . . . . 57Atualizando o Cognos TM1 Server no Windows . . . . . . . . . . . . . . . . . . . . . . 57Atualizando os Clientes Cognos TM1 Architect e Perspectives . . . . . . . . . . . . . . . . . 57Atualizando o Cognos TM1 Web . . . . . . . . . . . . . . . . . . . . . . . . . . . 58Atualizando o Cognos TM1 Contributor para o Cognos TM1 Applications . . . . . . . . . . . . . 58Restaurando os Dados e Arquivos de Configuração a partir do Cognos TM1 Versão 9.x na Versao Atual . . . 61

Planilhas .xls do Microsoft Excel . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62Salvando Direitos de Segurança ao Importar ou Restaurar um Cognos TM1 Application. . . . . . . . . . 63

Capítulo 6. Integração do Cognos TM1 com Outros Softwares IBM Cognos . . . . . . 65Segurança do Cognos TM1 e do Cognos BI . . . . . . . . . . . . . . . . . . . . . . . . . 66Usando o Cognos TM1 Package Connector para Importar Dados do Cognos BI no Cognos TM1 . . . . . . . 66

Instalação do Cognos TM1 Package Connector . . . . . . . . . . . . . . . . . . . . . . 67Cognos TM1 como uma Origem de Dados com o Cognos BI . . . . . . . . . . . . . . . . . . . 71

Ativando o Relatório do Cognos BI nas Origens de Dados do Cognos TM1 . . . . . . . . . . . . . 71Cognos TM1 iWidgets e Cognos Workspace . . . . . . . . . . . . . . . . . . . . . . . . 72Cognos TM1 e Cognos Analysis for Microsoft Excel . . . . . . . . . . . . . . . . . . . . . . 72

Configurando a conexão única do Cognos TM1 para o Cognos Analysis for Excel . . . . . . . . . . . 74Integração do Cognos TM1 Applications com o Cognos BI e o portal do Cognos Connection . . . . . . . . 75

Capítulo 7. Instalação de Computador Único do Cognos TM1 . . . . . . . . . . . . 77Instalar o Software Obrigatório . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77Instalar os Componentes Básicos do Cognos TM1 . . . . . . . . . . . . . . . . . . . . . . 78Use Cognos Configuration para Iniciar os Componentes do Cognos TM1. . . . . . . . . . . . . . . 79Executar o Cognos TM1 Perspectives . . . . . . . . . . . . . . . . . . . . . . . . . . . 80Executar o Cognos TM1 Architect . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81Executar o Cognos TM1 Web . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81Execute o Cognos TM1 Application Web. . . . . . . . . . . . . . . . . . . . . . . . . . 81Executar o Cognos TM1 Performance Modeler. . . . . . . . . . . . . . . . . . . . . . . . 82Executar Cognos Insight . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83Usar o Cognos TM1 Application Web. . . . . . . . . . . . . . . . . . . . . . . . . . . 83Outros Componentes Cognos TM1 . . . . . . . . . . . . . . . . . . . . . . . . . . . 84Configurando Computadores Clientes para Exportar Dados do Cognos TM1 em Formato PDF . . . . . . . 85

Capítulo 8. Instalação do Cognos TM1 Server . . . . . . . . . . . . . . . . . . . 87Instalando o Cognos TM1 Server no Windows. . . . . . . . . . . . . . . . . . . . . . . . 87

iv Guia de instalação e configuração

Instalar os Componentes do Cognos TM1 Server no Windows . . . . . . . . . . . . . . . . . 87Usar Cognos Configuration para Iniciar Servidores Cognos TM1 no Windows . . . . . . . . . . . . 88Alterando Serviços do Cognos TM1 para Serem Executados sob uma Conta de Usuário Específica no Windows 89

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

Configuração do Idioma do Cognos TM1 . . . . . . . . . . . . . . . . . . . . . . . . . 96Códigos de Idioma do Cognos TM1 . . . . . . . . . . . . . . . . . . . . . . . . . . 97Configurando o Idioma para o Servidor Cognos TM1 . . . . . . . . . . . . . . . . . . . . 98Configurando o Idioma para Clientes do Cognos TM1 no Windows . . . . . . . . . . . . . . . 98Configurando o Idioma do Navegador da Web para Cognos TM1 Web . . . . . . . . . . . . . . 99

Criando um novo Servidor Cognos TM1 Vazio no Cognos Configuration . . . . . . . . . . . . . . . 99Incluindo um Servidor Cognos TM1 Existente no Cognos Configuration . . . . . . . . . . . . . . 100Especificando o Local do Cognos TM1 Admin Host . . . . . . . . . . . . . . . . . . . . . 101Especificando diversos Cognos TM1 Admin Hosts . . . . . . . . . . . . . . . . . . . . . . 101Configuração Avançada do Cognos TM1 Admin Server e do Cognos TM1 Server . . . . . . . . . . . 102

Alterando Números de Porta Padrão para Cognos TM1 Admin Server . . . . . . . . . . . . . . 102Configurando o Cognos TM1 para Usar IPv6. . . . . . . . . . . . . . . . . . . . . . . 103

Capítulo 9. Instalação do Cognos TM1 Operations Console . . . . . . . . . . . . 105Instalando o Cognos TM1 Operations Console Usando o Software do Servidor da Web Apache Tomcat Fornecido 105Usando o Cognos Configuration para Implementar o Cognos TM1 Operations Console . . . . . . . . . 106Instalação avançada do Cognos TM1 Operations Console. . . . . . . . . . . . . . . . . . . . 106

Instalando o Cognos TM1 Operations Console em uma máquina separada . . . . . . . . . . . . . 106Instalando o Cognos TM1 Operations Console com sua própria instalação do servidor de aplicativos da webApache Tomcat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107Instalando o Cognos TM1 Operations Console no IBM WebSphere . . . . . . . . . . . . . . . 109

Configurando o Cognos TM1 Operations Console . . . . . . . . . . . . . . . . . . . . . . 112Iniciando e efetuando login no Cognos TM1 Operations Console . . . . . . . . . . . . . . . . . 113

Capítulo 10. Instalação do Cognos TM1 Web . . . . . . . . . . . . . . . . . . . 115Instalando o TM1 Web com o servidor de aplicativos Apache Tomcat fornecido . . . . . . . . . . . . 115

Instalando e Configurando o Cognos TM1 Web no Microsoft Windows . . . . . . . . . . . . . . 116Instalando e Configurando o Cognos TM1 Web no UNIX. . . . . . . . . . . . . . . . . . . 117

Instalando o TM1 Web com o IBM WebSphere . . . . . . . . . . . . . . . . . . . . . . . 118Implementando o TM1 Web para um IBM WebSphere Application Server . . . . . . . . . . . . . 119Importando certificados SSL para o TM1 Web . . . . . . . . . . . . . . . . . . . . . . 120

Modificando os Parâmetros de Configuração do Cognos TM1 Web . . . . . . . . . . . . . . . . 121Parâmetros de Configuração do Cognos TM1 Web . . . . . . . . . . . . . . . . . . . . . 121Editando o Arquivo de Configuração do Cognos TM1 Web . . . . . . . . . . . . . . . . . . 124Configurando a Página de Login do Cognos TM1 Web Usando os Parâmetros AdminHostName eTM1ServerName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125Configurando uma Página Inicial Customizada do IBM Cognos TM1 Web . . . . . . . . . . . . . 126Definindo as Configurações de Inicialização e Aparência do IBM Cognos TM1 Web . . . . . . . . . . 131Alterando o Tamanho de Página do Cube Viewer . . . . . . . . . . . . . . . . . . . . . 134Definindo o Número Máximo de Planilhas a Serem Exportadas de um Cube Viewer . . . . . . . . . 134Agrupando Valores de Sequência nas Visualizações do Cubo . . . . . . . . . . . . . . . . . 135

Configuração do Navegador da Web para o Cognos TM1 Web . . . . . . . . . . . . . . . . . . 135Configurando o Idioma do Navegador da Web para Cognos TM1 Web . . . . . . . . . . . . . . 135Exibindo e Inserindo Números no Cognos TM1 Web com Base em Configurações Regionais . . . . . . . 136Configurando o Internet Explorer para o Cognos TM1 Web . . . . . . . . . . . . . . . . . . 136Executando o Cognos TM1 Web em um Servidor WAN e Exportando Arquivos Excel e PDF . . . . . . . 137

Capítulo 11. Instalação do Cognos TM1 Application Server. . . . . . . . . . . . . 139Instalando o Cognos TM1 Application Server com o Apache Tomcat fornecido . . . . . . . . . . . . 140

Instalando os componentes da camada de aplicativos Cognos TM1 . . . . . . . . . . . . . . . 140Implementando o Cognos TM1 Application Server com o Servidor de Aplicativos da Web Tomcat Fornecido 141Configurando a segurança de autenticação para o Cognos TM1 Application Web. . . . . . . . . . . 141

Índice v

Configurando o ambiente do servidor e do cliente para o Cognos TM1 Application Web . . . . . . . . 142Configurações do Cognos TM1 Application Server no Cognos Configuration . . . . . . . . . . . . 144

Determinando o link de Inicialização da URL para o Cognos TM1 Application Web . . . . . . . . . . . 145Configurando um Cognos TM1 Server para trabalhar com o Cognos TM1 Application Web . . . . . . . . 146Configurando o IBM Cognos TM1Application Web. . . . . . . . . . . . . . . . . . . . . . 147Criação de Log do Cognos TM1 Application Server . . . . . . . . . . . . . . . . . . . . . 148Instalação e configuração avançadas do Cognos TM1 Application Server . . . . . . . . . . . . . . 150

Instale o Cognos TM1 Application Server com sua própria instalação do servidor de aplicativos da web doApache Tomcat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150Instale o Cognos TM1 Application Server com sua própria instalação do IBM Websphere . . . . . . . . 153Configurando o Cognos TM1 Application Web para usar vários servidores Cognos TM1 . . . . . . . . 159Usando um proxy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160Configurando a Segurança da Função do Cognos TM1 TurboIntegrator no Insight . . . . . . . . . . 161

Capítulo 12. Instalação da Camada de Desenvolvedor e de Cliente do Cognos TM1 165Instalando o Cognos TM1 Perspectives . . . . . . . . . . . . . . . . . . . . . . . . . . 165Instalando o Cognos TM1 Architect . . . . . . . . . . . . . . . . . . . . . . . . . . . 167Instalando o Cognos TM1 Performance Modeler. . . . . . . . . . . . . . . . . . . . . . . 168

Instalando o Cognos TM1 Performance Modeler Usando o Programa de Instalação . . . . . . . . . . 169Instalando o Cognos TM1 Performance Modeler do portal do Cognos TM1 Applications . . . . . . . . 170Instalando Remotamente o Cognos TM1 Performance Modeler em diversos Computadores . . . . . . . 170Configurando a Criação de Log para o Cognos TM1 Performance Modeler . . . . . . . . . . . . . 173Evitar exceções OutOfMemory lançadas pelo TM1 Performance Modeler . . . . . . . . . . . . . 173

Instalando o Cognos Insight . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174Instalando o Cognos Insight Usando o Programa de Instalação . . . . . . . . . . . . . . . . . 174Instalando o Cognos Insight a partir do portal do Cognos TM1 Applications . . . . . . . . . . . . 175Instalando Remotamente o Cognos Insight em diversos Computadores . . . . . . . . . . . . . . 176Configurando a Criação de Log para o Cognos Insight . . . . . . . . . . . . . . . . . . . 178

Instalando APIs do Cognos TM1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178Configurando Computadores Clientes para Exportar Dados do Cognos TM1 em Formato PDF . . . . . . . 179

Capítulo 13. Instalação de Bancos de Dados de Amostras do Cognos TM1. . . . . . 181Usando os Bancos de Dados de Amostra Instalados por Padrão . . . . . . . . . . . . . . . . . 182Usando o GO_Contributor e os bancos de dados de amostra da Companhia das Aventuras . . . . . . . . 183

Usando as amostras do servidor de vendas de grandes aventuras com base no banco de dados de amostras 183

Capítulo 14. Instalação das Ferramentas Cognos TM1 . . . . . . . . . . . . . . . 191

Capítulo 15. Configuração de Segurança . . . . . . . . . . . . . . . . . . . . 193Segurança da Autenticação . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193

Visão Geral da Autenticação . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193utilitário ETLDAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197Login Integrado . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206Autenticação LDAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213Usando a Segurança do Cognos com o Cognos TM1 . . . . . . . . . . . . . . . . . . . . 219

Usando SSL para Segurança de Transmissão de Dados . . . . . . . . . . . . . . . . . . . . 233Visão Geral para Usar SSL para Segurança de Transmissão de Dados. . . . . . . . . . . . . . . 233Certificados Gerados . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234Configurando o Cognos TM1 Admin Server para Usar SSL . . . . . . . . . . . . . . . . . . 235Configurando o Servidor Cognos TM1 para Usar SSL . . . . . . . . . . . . . . . . . . . . 237Configurando os Clientes Cognos TM1 para Usar SSL. . . . . . . . . . . . . . . . . . . . 242Configurando o Cognos TM1 Web para Usar SSL . . . . . . . . . . . . . . . . . . . . . 243Configurando o Cognos TM1 Applications para Usar SSL . . . . . . . . . . . . . . . . . . 245Configurando a API TM1 C API para Usar SSL . . . . . . . . . . . . . . . . . . . . . . 248Configurando a API Java do Cognos TM1 para Usar SSL. . . . . . . . . . . . . . . . . . . 248Configurando o Utilitário ETLDAP do Cognos TM1 para Usar SSL . . . . . . . . . . . . . . . 249Usando bCertificados Independentes com SSL e Cognos TM1 . . . . . . . . . . . . . . . . . 250

Capítulo 16. Manutenção de sua Instalação do Cognos TM1 . . . . . . . . . . . . 257Fazendo Backup de Dados e Arquivos de Configuração para Cognos TM1 . . . . . . . . . . . . . . 257

vi Guia de instalação e configuração

Modificando Componentes Instalados do Cognos TM1 . . . . . . . . . . . . . . . . . . . . 258Desinstalando o Cognos TM1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259Desinstalando e Implementando o Cognos TM1 Applications . . . . . . . . . . . . . . . . . . 260

Fazendo Backup de seus dados do Cognos TM1 Applications . . . . . . . . . . . . . . . . . 261Exportando os Aplicativos do Cognos TM1 Applications . . . . . . . . . . . . . . . . . . . 261Parando Serviços Relacionados no Cognos TM1 . . . . . . . . . . . . . . . . . . . . . . 262Desinstalando Cognos TM1 Applications . . . . . . . . . . . . . . . . . . . . . . . . 262Removendo Implementação do Cognos TM1 Applications no Apache Tomcat . . . . . . . . . . . . 263Removendo a Implementação do Cognos TM1 Applications no WebSphere. . . . . . . . . . . . . 264

Restaurando os dados e arquivos de configuração no Cognos TM1 versão 10.2.2 . . . . . . . . . . . . 265Restaurando Arquivos de Aplicativo e Configuração no Cognos TM1 Applications . . . . . . . . . . . 266Importando uma Definição de Aplicativo no Cognos TM1 Applications . . . . . . . . . . . . . . . 267

Capítulo 17. Recursos de Acessibilidade . . . . . . . . . . . . . . . . . . . . 269Atalhos de Teclado para o Assistente de Instalação . . . . . . . . . . . . . . . . . . . . . . 269Atalhos de Teclado para o Cognos Configuration . . . . . . . . . . . . . . . . . . . . . . 270

Apêndice A. O arquivo de configuração do servidor tm1s.cfg . . . . . . . . . . . 271Local do arquivo tm1s.cfg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271Arquivo tm1s.cfg de amostra . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271Parâmetros no arquivo tm1s.cfg . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272

AdminHost . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273AdminSvrSSLCertAuthority . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273AdminSvrSSLCertID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273AdminSvrSSLCertRevList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274AdminSvrSSLExportKeyID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274AllowReadOnlyChore Reschedule . . . . . . . . . . . . . . . . . . . . . . . . . . 274AllowSeparateNandCRules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274AllRuleCalcStargateOptimization . . . . . . . . . . . . . . . . . . . . . . . . . . . 275ApplyMaximumViewSizeToEntireTransaction. . . . . . . . . . . . . . . . . . . . . . . 276AuditLogMaxFileSize. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276AuditLogMaxQueryMemory . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276AuditLogOn. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277AuditLogUpdateInterval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277AutomaticallyAddCubeDependencies . . . . . . . . . . . . . . . . . . . . . . . . . 277CacheFriendlyMalloc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278CalculationThresholdForStorage . . . . . . . . . . . . . . . . . . . . . . . . . . . 278CAMPortalVariableFile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278CAMSSLCertificate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279CertificateVersion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279CheckFeedersMaximumCells . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279ClientCAMURI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280ClientExportSSLSvrCert . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280ClientExportSSLSvrKeyID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280ClientPingCAMPassport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280ClientMessagePortNumber . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281ClientPropertiesSyncInterval . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281ClientVersionMaximum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281ClientVersionMinimum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282ClientVersionPrecision . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283CognosMDX.AggregateByAncestorRef . . . . . . . . . . . . . . . . . . . . . . . . . 284CognosMDX.CellCacheEnable . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284CognosMDX.PrefilterWithPXJ . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284CognosMDX.SimpleCellsUseOPTSDK . . . . . . . . . . . . . . . . . . . . . . . . . 285CognosMDX.UseProviderCrossJoinThreshold . . . . . . . . . . . . . . . . . . . . . . . 285CognosTM1InterfacePath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285DataBaseDirectory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286DefaultMeasuresDimension. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286DHFile-512 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286DHFile-1024 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286

Índice vii

DHFile-2048 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287DisableMemoryCache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287DisableSandboxing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287Display_Info_DBType_R8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288DistributedPlanningOutputDir . . . . . . . . . . . . . . . . . . . . . . . . . . . 288DownTime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289EnableODBCproxy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289ExcelWebPublishEnabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289ExportAdminSvrSSLCert . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290ExportSvrSSLCert . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290ForceReevaluationOfFeedersForFedCellsOnDataChange . . . . . . . . . . . . . . . . . . . 291HTTPPortNumber . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292HTTPSessionTimeoutMinutes . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292IdleConnectionTimeOutSeconds . . . . . . . . . . . . . . . . . . . . . . . . . . . 292IntegratedSecurityMode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293IPAddress . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294IPVersion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295JavaClassPath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296JavaJVMArgs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296JavaJVMPath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296JobQueuing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296JobQueueMaxWaitTime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297JobQueueThreadPoolSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297JobQueueThreadSleepTime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298Idioma . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298LDAPHost . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299LDAPPasswordFile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299LDAPPasswordKeyFile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299LDAPPort . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299LDAPSearchBase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299LDAPSearchField . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300LDAPSkipSSLCertVerification . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300LDAPSkipSSLCRLVerification . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300LDAPUseServerAccount. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300LDAPVerifyCertServerName . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301LDAPVerifyServerSSLCert . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301LDAPWellKnownUserName . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302LockPagesInMemory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302LoggingDirectory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303LogReleaseLineCount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303MagnitudeDifferenceToBeZero. . . . . . . . . . . . . . . . . . . . . . . . . . . . 303MaskUserNameInServerTools . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304MaximumCubeLoadThreads . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304MaximumLoginAttempts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305MaximumMemoryForSubsetUndo . . . . . . . . . . . . . . . . . . . . . . . . . . 305MaximumSynchAttempts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305MaximumTILockObjects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306MaximumUserSandboxSize. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307MaximumViewSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307MessageCompression. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307MTQ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307MTQ.OperationProgressCheckSkipLoopSize . . . . . . . . . . . . . . . . . . . . . . . 308MTQ.SingleCellConsolidation . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308NetRecvBlockingWaitLimitSeconds . . . . . . . . . . . . . . . . . . . . . . . . . . 309NetRecvMaxClientIOWaitWithinAPIsSeconds. . . . . . . . . . . . . . . . . . . . . . . 309ODBCLibraryPath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309OracleErrorForceRowStatus. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310ParallelInteraction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310PasswordMinimumLength . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310PasswordSource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310PerfMonIsActive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311

viii Guia de instalação e configuração

PerformanceMonitorOn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311PersistentFeeders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311PortNumber . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312PrivilegeGenerationOptimization . . . . . . . . . . . . . . . . . . . . . . . . . . . 312ProgressMessage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313ProportionSpreadToZeroCells . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313RawStoreDirectory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314ReceiveProgressResponseTimeoutSecs . . . . . . . . . . . . . . . . . . . . . . . . . 315RulesOverwriteCellsOnLoad . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315RunningInBackground . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316SaveTime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316SecurityPackageName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316ServerCAMURI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317ServerCAMURIRetryAttempts . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317ServerLogging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318ServerName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318ServicePrincipalName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318SkipLoadingAliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319SkipSSLCAMHostCheck . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319SpreadingPrecision . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319SSLCertAuthority . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320SSLCertificate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321SSLCertificateID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321SSLCertRevocationFile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321SSLPrivateKeyPwdFile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321SSLPwdKeyFile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321StartupChores . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322SubsetElementBreatherCount . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322SvrSSLExportKeyID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323SyncUnitSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323TM1ConnectorforSAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323UnicodeUpperLowerCase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324UseLocalCopiesforPublicDynamicSubsets . . . . . . . . . . . . . . . . . . . . . . . . 324UseNewConnectorforSAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325UserDefinedCalculations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325UseSQLFetch UseSQLFetchScroll UseSQLExtendedFetch . . . . . . . . . . . . . . . . . . . 325UseSSL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326UseStargateForRules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326ViewConsolidationOptimization . . . . . . . . . . . . . . . . . . . . . . . . . . . 327ViewConsolidationOptimizationMethod . . . . . . . . . . . . . . . . . . . . . . . . 327ZeroWeightOptimization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328

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

AdminHost . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330AdminSvrSSLCertAuthority . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330AdminSvrSSLCertID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330AdminSvrSSLCertRevList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331AdminSvrSSLExportKeyID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331AdvancedRulesEditor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331AllowImportCamClients. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331BrowseDisplayReadsRightToLeft . . . . . . . . . . . . . . . . . . . . . . . . . . . 331ClassicSliceMode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332CognosGatewayURI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332ConnectLocalAtStartup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332DataBaseDirectory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332DimensionDownloadMaxSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332DisplayApplications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332DisableWritebackOnDisconnect . . . . . . . . . . . . . . . . . . . . . . . . . . . 333DisableWritebackOnTM1Formulas . . . . . . . . . . . . . . . . . . . . . . . . . . 333

Índice ix

DisplayChores . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333DisplayControlCubes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333DisplayCubes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334DisplayDimensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334DisplayExplorerPropertiesWindow . . . . . . . . . . . . . . . . . . . . . . . . . . 334DisplayProcesses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334DisplayReplications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334ExpandRowHeaderWidth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334ExportAdminSvrSSLCert . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334InSpreadsheetBrowser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335IntegratedLogin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335Idioma . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335LocalServerNetworkProtocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336MainWindowLayoutInfo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336PreviousAdminHosts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336PreviousDataDirectories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336SecurityAssignmentWindowLayoutInfo. . . . . . . . . . . . . . . . . . . . . . . . . 336SentMsgsToServerCountWarning . . . . . . . . . . . . . . . . . . . . . . . . . . . 336ShowAdminHostChangeWarning. . . . . . . . . . . . . . . . . . . . . . . . . . . 337ShowAliasAttributeWarning . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337ShowChoresSchedulingWarning . . . . . . . . . . . . . . . . . . . . . . . . . . . 337ShowCubeReplicationWarning. . . . . . . . . . . . . . . . . . . . . . . . . . . . 337ShowDimDeleteElementWarning . . . . . . . . . . . . . . . . . . . . . . . . . . . 337ShowDimensionAccessWarning . . . . . . . . . . . . . . . . . . . . . . . . . . . 337ShowDynamicSubsetWarning . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337ShowPickOperationWarning . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338ShowProcessUNASCIIWarning . . . . . . . . . . . . . . . . . . . . . . . . . . . 338ShowProcessUNODBCWarning . . . . . . . . . . . . . . . . . . . . . . . . . . . 338SliceNewWorkbook . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338SubsetWindowLayoutInfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338TM1RebuildDefault . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338

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

Configurando uma Instalação não Assistida . . . . . . . . . . . . . . . . . . . . . . . 341Configurando uma Configuração Não Assistida . . . . . . . . . . . . . . . . . . . . . . . 342Configurando uma Desinstalação Não Assistida . . . . . . . . . . . . . . . . . . . . . . . 343

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

Avisos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349

Índice Remissivo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353

x 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 na web, incluindo toda a documentação traduzida,acesse IBM Knowledge Center (http://www.ibm.com/support/knowledgecenter).

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

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

http://www.ibm.com/support/knowledgecenter/

Termo de responsabilidade das amostras

A Companhia de Aventuras de Amostras, Companhia das Grandes Aventuras,Vendas GA, qualquer variação do nome Aventuras de Amostra, Grandes Aventurase Amostras de Planejamento descrevem operações de negócios fictícias com dadosde amostra usados para desenvolver aplicativos de amostra para a IBM e para osclientes IBM. Esses registros fictícios incluem dados de amostra para transações devendas, distribuição de produtos, finanças e recursos humanos. Qualquersemelhança com nomes, endereços, números de contato ou valores de transaçãoreais é mera coincidência. Outros arquivos de amostras podem conter dadosfictícios gerados manualmente ou por máquinas, dados reais compilados de fontesacadêmicas ou públicas, ou dados usados com a permissão do proprietário dosdireitos autorais, para o uso como dados de amostra para o desenvolvimento deaplicativos de amostras. Os nomes de produtos citados podem ser marcasregistradas dos respectivos proprietários. A cópia não autorizada está proibida.

xii Guia de instalação e configuração

Capítulo 1. O que há de novo

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

Para obter toda a documentação do TM1 disponível atualmente, acesse a página deboas-vindas do TM1 (http://www.ibm.com/support/knowledgecenter/SS9RXT/welcome).

O que há de novo para a instalação e configuração do Cognos TM1 naversão 10.2.2

A lista a seguir identifica os recursos novos e alterados de instalação econfiguração no IBM Cognos TM1 versão 10.2.2.

Novas amostras estão disponíveisA liberação 10.2.2. inclui os novos bancos de dados de amostras.

O Proven Techniques é um novo banco de dados de amostra instalado por padrão.

O banco de dados de amostra do GO_Scorecards também é, agora, instalado porpadrão.

Consulte o Capítulo 13, “Instalação de Bancos de Dados de Amostras do CognosTM1”, na página 181.

Novos recursos no TM1 Mobile ContributorOs novos recursos foram incluídos ao TM1 Mobile Contributor versão 10.2.2.

TM1 Mobile Contributor inclui os novos recursos a seguir:v Marcador de desempenhov Lista de Observaçãov Navegaçãov Notificações push

Consulte o “Implementando o Cognos TM1 Mobile Contributor” na página 43.

Interoperabilidade do Cognos TM1 para o programa deinstalação removido do Cognos BI

A partir do IBM Cognos TM1 versão 10.2.2, a Interoperabilidade do TM1 para oprograma de instalação do Business Intelligence (BI) não está mais disponível. Osarquivos incluídos agora estão incluídos por padrão no programa de instalaçãoprincipal do Cognos TM1.

Essa alteração aplica-se a todos os sistemas operacionais suportados para o CognosTM1 versão 10.2.2.

© Copyright IBM Corp. 2007, 2015 1

http://www.ibm.com/support/knowledgecenter/SS9RXT/welcome


Os arquivos que foram instalados anteriormente pela Interoperabilidade do TM1para o programa de instalação do BI estão agora incluídos no arquivobi_interop.zip localizado no diretório a seguir:

<TM1 installation location>\bi_interop

Por exemplo, no Windows:

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

Para usar o novo arquivo bi_interop.zip:1. Extraia e mescle o conteúdo do arquivo bi_interop.zip no diretório raiz de sua

instalação existente do Cognos BI:Por exemplo: C:\Program Files\IBM\cognos\c10_64\

Nota: O arquivo bi_interop.zip contém uma estrutura de diretório que mesclaos arquivos nos subdiretórios \templates e \webcontent.

2. Edite os parâmetros nos arquivos extraídos para o componente que você desejaintegrar com o Cognos TM1 e Cognos BI.

Cognos TM1 Applications

Os arquivos extraídos ativam o Cognos TM1 Applications para aintegração com a segurança do Cognos BI e o portal do CognosConnection.

Para obter mais informações, acesse “Usando o Cognos TM1Applications com a Segurança do Cognos” na página 228 e “Integraçãodo Cognos TM1 Applications com o Cognos BI e o portal do CognosConnection” na página 75.

Cognos Analysis for Microsoft Excel

O Cognos Analysis for Microsoft Excel usa os arquivos extraídos paraacessar os servidores do Cognos TM1 que estão usando a autenticaçãodo Cognos BI com a conexão única (SSO).

Para obter mais informações, consulte “Configurando a conexão únicado Cognos TM1 para o Cognos Analysis for Excel” na página 74.

Novos arquivos de configuração para usar o Cognos TM1Web com a segurança do Cognos

A partir da versão 10.2.2 do IBM Cognos TM1, os arquivos que permitem que oCognos TM1 Web use a autenticação de segurança do Cognos são fornecidos emum novo local.

Os arquivos foram fornecidos anteriormente no arquivo tm1web_gateway.zip, masagora são organizados em dois arquivos compactados separados em um novolocal:v Local antigo: <TM1 installation location>\webapps\tm1web\gateway_files\

v Novo local: <TM1 installation location>\webapps\tm1web\bi_files\

Para obter mais informações sobre o uso desses arquivos para ativar a segurançado Cognos BI com o Cognos TM1 Web, consulte “Configurando o Cognos TM1Web para usar a Segurança do Cognos” na página 225.

2 Guia de instalação e configuração

O que Há de Novo para a Instalação e a Configuração do Cognos TM1na Versão 10.2.0

A lista a seguir identifica os recursos novos e alterados de instalação econfiguração no IBM Cognos TM1 versão 10.2.0.

Novos Requisitos de Instalação no Cognos TM1 10.2.0Existem novos pré-requisitos de software para a 10.2.0:

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 o Cognos TM1 Software Environments(http://www.ibm.com/support/docview.wss?uid=swg27038140).

Instalação no Microsoft Windowsv O Microsoft .NET Framework é necessário para o Editor de Regras Avançado e a

publicação para o recurso da web no Cognos TM1 Architect e no TM1Perspectives.

v Pacote Redistribuível do Microsoft Visual C++ 2010 (x86 e x64)Ambas as versões x86 e x64 serão necessárias em um sistema Windows de 64bits se você planejar executar algum aplicativo cliente de 32 bits do TM1 como oCognos TM1 Architect e o TM1 Perspectives.

Instalação no UNIX

Instale sua própria cópia do Java™ Runtime Environment (JRE). A instalação doCognos TM1 não fornece um JRE para instalações do UNIX.

Instalação da Documentação TraduzidaDurante a instalação, é possível escolher instalar traduções de idioma específico dadocumentação online necessária. Por padrão, a versão em inglês da documentaçãoonline sempre é instalada e não pode ser desmarcada.

Esta opção instala a documentação adicional, traduzida do inglês para os idiomasselecionados, no local de instalação. O tempo de instalação aumenta conforme onúmero de idiomas selecionado. Por padrão, a documentação em inglês sempre éinstalada. Esta opção não afeta a interface com o usuário do Cognos TM1 ou asmensagens emitidas pelo software, que são sempre instaladas para todos osidiomas suportados.

Para instalar um idioma específico para a ajuda da documentação, durante ainstalação expanda o nó Documentação Traduzida e selecione os outros idiomasque você deseja instalar.

Quando as traduções de idioma adicional estiverem instaladas, o Cognos TM1detectará o idioma a ser usado para a ajuda online com base nas configurações doambiente. Por exemplo, se você tiver instalado a documentação traduzida para ofrancês e as configurações do navegador estiverem configuradas para francês, aajuda online ficará em francês.

Lembre-se: A configuração Seleção do Idioma de Instalação na primeira tela doassistente de instalação apenas define o idioma para o assistente de instalação. O

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

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

idioma que será usado para o software Cognos TM1 é determinado pelasconfigurações de idioma do software do sistema operacional e no arquivo deconfiguração do Cognos TM1 tm1s.cfg.

Para obter mais informações sobre como o Cognos TM1 detecta qual idioma deveser usado, consulte “Configuração do Idioma do Cognos TM1” na página 96.

Agora, o Cognos TM1 Web Usa um Servidor de Aplicativos daWeb Baseado em Java

Agora, o IBM Cognos TM1 Web é executado em um servidor de aplicativos daweb Java como o Apache Tomcat.

Por padrão, a instalação do Cognos TM1 configura o Cognos TM1 Web para usar oservidor de aplicativos da web Tomcat fornecido com a instalação do Cognos TM1.

Arquitetura do Cognos TM1 Web

Para obter mais informações sobre a arquitetura do Cognos TM1 Web, consulte“Arquitetura do Cognos TM1 Web” na página 31.

Etapas de Configuração para o Microsoft .NET Framework NãoNecessárias

O Cognos TM1 Web versão 10.2.0 não requer ou usa o Microsoft .NET Framework.As etapas de configuração necessárias quer eram relacionadas às versões anterioresdo .NET Framework do Cognos TM1 Web não são mais necessárias na versão10.2.0.

Novo Diretório de Instalação Padrão para o TM1 Web

A partir da versão 10.2.0, o diretório de instalação padrão para o Cognos TM1 Webé:

<TM1_install>\webapps\tm1web\

Nova URL Padrão para Iniciar o TM1 Web

Use a nova URL a seguir para abrir o Cognos TM1 Web versão 10.2.0:

http://localhost:9510/tm1web/

Novos Arquivo de Configuração e Parâmetros do TM1 Web

O Cognos TM1 Web versão 10.2.0 usa um novo arquivo de configuração chamadotm1web_config.xml. Esse arquivo substitui o arquivo web.config das versõesanteriores do Cognos TM1 Web. O novo arquivo inclui um subconjunto dosparâmetros anteriores, porque os parâmetros relacionados ao Microsoft .NETFramework foram removidos.

O local do novo arquivo de configuração é:

<TM1_install>\webapps\tm1web\web-inf\configuration

Um novo parâmetro chamado GzipCompressionEnabled foi incluído para especificarse as respostas do servidor da web são compactadas.


O TM1 Web Suporta Planilhas do Microsoft Excel nos Formatos.xlsm e .xslx

O Cognos TM1 Web versão 10.2 usa os formatos de arquivo Open XML (arquivos.xlsm e .xslx) para as planilhas do Microsoft Excel criadas usando o Excel 2007 ouposterior.

Se você estiver usando arquivos existentes do Microsoft Excel no formato .xlsantigo, use a ferramenta de conversão do Cognos TM1 no Cognos TM1 Architectpara converter os arquivos.

Para obter mais informações, consulte “Planilhas .xls do Microsoft Excel” napágina 62.

A Configuração de Segurança da Web do TM1 Foi Alterada

Várias etapas foram alteradas para a configuração dos diferentes tipos deautenticação e segurança de transmissão de dados para o Cognos TM1 Web.

Segurança de autenticação do TM1 Web e Cognos

As etapas para configurar o Cognos TM1 Web para usar a segurança doCognos foram alteradas. Para obter mais informações, consulte“Configurando o Cognos TM1 Web para usar a Segurança do Cognos” napágina 225.

Autenticação do TM1 Web e do Microsoft Windows com o Kerberos

As etapas para configurar o Cognos TM1 Web para usar a segurança doCognos foram alteradas. Para obter mais informações, consulte“Configurando o Login Integrado para o Cognos TM1 Web Usando oKerberos” na página 209.

Configuração do TM1 Web e SSL

A partir do Cognos TM1 Web versão 10.2.0, para ativar SSL no IBMCognos TM1 Web, você deverá incluir um certificado no keystore do JavaRuntime Environment (JRE). Para obter mais informações, consulte“Configurando o Cognos TM1 Web para Usar SSL” na página 243.

Novo Aplicativo Cognos TM1 Mobile Contributor para oCognos TM1 10.2.0

O IBM Cognos TM1 Mobile Contributor é um novo aplicativo remoto para o AppleiPad.

O aplicativo Cognos TM1 Mobile conecta-se a um IBM Cognos TM1 Server ecoexiste com outros programas de desktop e da web que se conectam ao mesmoservidor. Use o Aplicativo remoto para:v Acessar todos os aplicativos de planejamento do Cognos TM1 Applicationsv Visualizar o status de envio para todos os nós de aprovaçãov Interagir com visualizações do cubo no formato de gráfico ou grade.v Alterar valores no iPad e enviá-los novamente ao plano no qual os dados serão

atualizados no servidor Cognos TM1.

Para obter mais informações, consulte “Implementando o Cognos TM1 MobileContributor” na página 43.

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

Novas Maneiras de Abrir o Cognos TM1 Performance ModelerA partir da versão 10.2, o processo de instalação instala um atalho para o IBMCognos TM1 Performance Modeler no menu Iniciar do Microsoft Windows e nodesktop do Windows.

Para iniciar o aplicativo a partir do menu Iniciar do Windows:

Clique em Iniciar > IBM Cognos TM1 Performance Modeler > IBM Cognos TM1Performance Modeler

Para iniciar o aplicativo a partir do desktop, localize o ícone para o IBM CognosTM1 Performance Modeler.

Novas Amostras de PontuaçãoExiste um novo banco de dados de amostras que pode ser usado com os novosrecursos do Cognos TM1 Scorecard.

O banco de dados de amostras Go_Scorecards pode ser incluído na instância doservidor TM1 no Cognos Configurations. A amostra GO_Scorecards contém muitasestruturas de dados de amostra que podem ser usadas para o TM1 Scorecarding.Um aplicativo de amostra também está disponível para ser usado com pontuações.

Para obter mais informações, consulte “Novas Amostras de Pontuação”.

Nova Integração com o Cognos Analysis for Microsoft ExcelAgora, o IBM Cognos Analysis for Microsoft Excel é integrado às origens de dadosdo IBM Cognos TM1.

Use o Cognos Analysis for Microsoft Excel com as origens de dados do IBMCognos TM1 para inserir e efetuar writeback de valores para os cubos do TM1. OCognos Analysis for Microsoft Excel permite que os usuários do Microsoft Excelacessem diretamente as informações seguras e controladas de forma centralizadado IBM Cognos para melhorar a tomada de decisões.

Para obter informações sobre como implementar o Cognos TM1 com o CognosAnalysis for Microsoft Excel, consulte “Cognos TM1 e Cognos Analysis forMicrosoft Excel” na página 72.

Para obter mais informações sobre o uso do Cognos Analysis for Microsoft Excel,consulte o IBM Cognos Analysis for Microsoft Excel User Guide, versão 10.2.0..

Novo Parâmetro TM1 Admin Server Certificate Versão paraSSL

Um novo parâmetro chamado TM1 Admin Server Certificate Version foi incluídono IBM Cognos Configuration para especificar qual versão dos certificados SSLgerados pelo TM1 deve ser usada.

Esse parâmetro pode ser usado para escolher a versão de criptografia de 1024 bitsou a nova criptografia de 2048 bits dos certificados do TM1 padrão. Por padrão, aversão de criptografia de 1024 bits dos certificados gerados pelo TM1 é usada.

Para obter mais informações, consulte “Configurando o Cognos TM1 Admin Serverpara Usar SSL” na página 235.


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

A chave para uma instalação bem-sucedida é o planejamento. Este capítulodescreve as opções que farão com que o processo de implementação ocorra semproblemas.

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

TM1 para 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 para 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 as interfaces de clientes/usuário padrão do Cognos TM1 earquivos de suporte API do TM1 relacionados. Estes componentes estãodisponíveis somente como versões de 32 bits.v Cognos TM1 Architectv Cognos TM1 Perspectivesv Cognos TM1 APIsv Cognos TM1 Performance Modelerv 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.

Nota: Você também pode usar o programa de instalação do TM1 Clientpara ativar o relatório IBM Cognos BI em comparação às origens de dadosdo Cognos TM1. Usar o programa de instalação do TM1 Client para estepropósito instalará os arquivos da API do Cognos TM1 em seus servidoresCognos BI que estão executando serviços de relatório no MicrosoftWindows. Para obter detalhes adicionais, consulte “Ativando o Relatóriodo Cognos BI nas Origens de Dados do Cognos TM1” na página 71.

TM1 para UNIX e Linux

Inclui somente as versões do UNIX e Linux dos componentes do CognosTM1 a seguir.v Cognos TM1 Admin Serverv Cognos TM1 Serverv Os servidores de aplicativos da web do Cognos TM1 (o Cognos TM1

Web, o Cognos TM1 Applications, o Cognos TM1 Operations Console)

Use o programa de instalação do Cognos TM1 UNIX para instalar essescomponentes em qualquer um dos sistemas operacionais suportados, UNIXou Linux. Um programa de instalação separado está disponível para cadaum destes sistemas operacionais 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 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.

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 um


ambiente de software específicos. Consulte as seções a seguir para obterinformações sobre os componentes de instalação.

Componente de Instalação de Camada do Aplicativo do TM1A Camada do Aplicativo no programa de instalação do IBM Cognos TM1 inclui oscomponentes fundamentais como o Cognos TM1 Admin e componentes doservidor Cognos TM1.

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

Tabela 1. Requisitos do Sistema para os Componentes de Camada do Cognos TM1Application

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, como cubos e dimensões namemória. Ele responde às solicitações docliente ao concluir cálculos, consolidações eatualizações conforme o 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 8, “Instalação doCognos TM1 Server”, na página 87.

TM Admin Server Windows de 32 bits

Windows de 64 bits

UNIX de 64 bits

Um processo que controla todos osservidores Cognos TM1 que são executadosem uma rede. Um servidor administrativoexecutado em um servidor de HostAdministrativo.

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 8, “Instalação doCognos TM1 Server”, na página 87.

TM1 Tools 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 14, “Instalação dasFerramentas Cognos TM1”, na página 191.

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

Componente de Instalação Camada do Aplicativo da WebOs componentes de instalação Camada do Aplicativo da Web requerem umservidor de aplicativos da web no qual serão executados. Por padrão, eles sãoconfigurados para funcionar com o servidor de aplicativos da web Java fornecido.

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


Cognos TM1Application Gateway

Windows de 32 bits

Windows de 64 bits

Componente da web Java que oferece ofornecimento dos componentes do CognosTM1 Performance Modeler e do CognosInsight para usuários remotos.

Esse componente é instalado com ocomponente Cognos TM1 ApplicationServer.

Consulte o Capítulo 11, “Instalação doCognos TM1 Application Server”, na página139.

TM1 ApplicationServer

Windows de 32 bits

Windows de 64 bits

Aplicativo da web Java que fornece osuporte primário para o IBM Cognos TM1Applications.

O componente do Cognos TM1 Applicationsé usado para projetar, implementar eexecutar aplicativos de planejamentogerenciados baseados em contribuição nosdados do Cognos TM1. Este componentetambém interage com os componentesCognos TM1 Performance Modeler eCognos Insight.

Esse componente requer um servidor deaplicativos da web Java e o Java RuntimeEnvironment (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 11, “Instalação doCognos TM1 Application Server”, na página139.


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


TM1 Web Windows de 32 bits

Windows de 64 bits

Os componentes do servidor da web e docliente que são executados no servidor deaplicativos da web Java fornecido.

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 10, “Instalação doCognos TM1 Web”, na página 115.

TM1 OperationsConsole

Windows de 32 bits

Windows de 64 bits

O aplicativo da web Java que fornece umaferramenta de monitoramento baseada naweb para os administradores do CognosTM1 monitorarem e agirem sobre umaatividade 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 “Instalando o Cognos TM1Operations Console Usando o Software doServidor da Web Apache Tomcat Fornecido”na página 105.

Componente de Instalação de Camada de Cliente do TM1A camada de cliente no programa de instalação do IBM Cognos TM1 contémferramentas para usuários finais e uma coleção das APIs do Cognos TM1.

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

Cognos Insight Windows de 32 bits Interface rich client Java baseada em Eclipseque pode ser iniciada independentementeou 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 174.

APIs do TM1 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.

Consulte o “Instalando APIs do CognosTM1” na página 178.

Componente de Camada do DesenvolvedorA Camada do Desenvolvedor no programa de instalação do IBM Cognos TM1contém ferramentas para o modelador e o desenvolvedor do Cognos TM1.

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 do Windows paraadministrar, criar e manter dados emetadados em ambos os servidores CognosTM1 local e remoto.

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

TM1 PerformanceModeler

Windows de 32 bits Interface rich client Java baseada me Eclipseque é iniciada 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 168.

Componente de Instalação de AmostrasUma coleção de bancos de dados de amostra do IBM Cognos TM1 é fornecida coma instalação.

A tabela a seguir inclui a descrição e o sistema operacional para o componente deamostras.

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 amostra doCognos TM1:

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

Componente de Instalação de Documentação TraduzidaEsse componente permite selecionar e instalar a documentação traduzida paraidiomas diferentes de inglês suportados no IBM Cognos TM1.

Por padrão, a documentação em inglês sempre é instalada e sua seleção não podeser cancelada. É possível selecionar ou cancelar a seleção de idiomas específicos, noentanto, o tempo de instalação aumentará de acordo com o número de idiomasselecionados.


Para obter informações sobre os idiomas suportados, consulte “Códigos de Idiomado Cognos TM1” na página 97.

A opção de documentação traduzida não afeta os idiomas de mensagens einterfaces com o usuário:v Essa opção não afeta as mensagens emitidas pelo software, que sempre são

instaladas para todos os idiomas suportados.v Essa opção não afeta o idioma usado na interface com o usuário do Cognos

TM1, que é baseado na configuração no sistema operacional do usuário atual.Para obter informações sobre como configurar idiomas, consulte “Configuraçãodo Idioma do Cognos TM1” na página 96.

Componentes de Instalação Adicionais Não ListadosAlguns componentes não são listados ou não podem ser selecionados no programade instalação.

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 do Cognos TM1 Não Listados no Assistente deInstalação


Aplicativo TM1 OLEDB Provider

Windows de 32 bits

Windows de 64 bits

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

Diferenciação de Cliente do TM1O IBM Cognos TM1 fornece diversos clientes para administradores/desenvolvedores e usuários final. Entender esses clientes e diferenciar entre elespode ajudar a decidir qual cliente é mais apropriado para suas necessidades.

Todos os clientes são descritos totalmente na documentação do IBM Cognos TM1.v O Guia do Usuário do Cognos TM1 Performance Modeler descreve os recursos de

desenvolvimento e administrativos do Cognos TM1 Performance Modeler.v O Guia do Cognos TM1 Developer descreve os recursos de desenvolvimento e

administrativos do Cognos TM1 Architect e do Cognos TM1 Perspectives.v O Guia do Cognos TM1 Operations Console descreve como monitorar e administrar

os servidores com o Cognos TM1 Operations Console.v O Guia do Usuário do Cognos TM1 descreve os recursos de análise do usuário

final do Cognos TM1 Architect e do Cognos TM1 Perspectives.v O Guia do Usuário do Cognos Insight descreve os recursos de análise do usuário

final do Cognos Insight.v O Guia do Usuário da Web do Cognos TM1 descreve os recursos de análise do

usuário final do Cognos TM1 Web.v O Guia do Cognos TM1 Applications descreve os recursos de análise do usuário

final do Cognos TM1 Application Web.

Clientes de Usuário FinalVários clientes de usuário final estão disponíveis para interagir com os dados doIBM Cognos TM1.


IBM Cognos Insight

O IBM Cognos Insight é um cliente para o TM1 Application Web e também umaferramenta de análise pessoal que pode ser usada para analisar quase qualquerconjunto de dados. No contexto do Cognos TM1 Application Web, o CognosInsight é um aplicativo cliente completo que é fornecido localmente ou como umdownload remoto. Quando usado como um cliente do Cognos TM1 ApplicationWeb, há dois modos nos quais o Cognos Insight pode ser usado: Modo Conectadoe Modo Desconectado.

O Modo Conectado cria uma conexão ativa e bidirecional com o servidor CognosTM1. Quaisquer dados que são atualizados no servidor TM1 são atualizados nocliente do Insight quando executar um recálculo no Insight. Isso assegura que osdados no cliente do Insight estejam sempre atuais quando executar análise oucontribuir com um plano. O trade-off da conexão ativa com o servidor TM1 é quemais tráfego é gerado na LAN e uma carga mais pesada é imposta no servidorTM1 em comparação com o Modo Desconectado. O Modo Conectado deve serusado por usuários que possuem uma conexão rápida com o servidor TM1 e quenão haja nenhuma latência de rede.

O Modo Desconectado está atualmente disponível apenas com os nós de nível defilho. O Modo Desconectado faz o download e cria uma cópia local da fatia doservidor Cognos TM1 (parte de modelo e de dados do TM1) com a qual você estátrabalhando. O benefício disso é que ele distribui a carga de trabalho que oservidor TM1 teria que manter em qualquer outro modo de conexão. Oprocessamento é distribuído entre o cliente e o servidor TM1 neste modo. O ModoDesconectado é benéfico para usuários com uma LAN de alta latência ou parausuários que estiverem distantes geograficamente do servidor TM1. Quando umusuário abre o Cognos Insight no Modo Desconectado, a fatia do modelo do TM1 étransferida por download e armazenada em cache. Toda a interação com os dadosocorre com relação ao cache local, aumentando grandiosamente a velocidade daresposta.

IBM Cognos Analysis for Microsoft Excel

IBM Cognos Analysis for Microsoft Excel é desejado para usuários que trabalhamem ambientes de rede global. É o cliente de escolha para usuários queimplementaram primeiramente o Microsoft Excel para analisar as informações doTM1 e construir seus próprios layouts customizados utilizando a funcionalidadenativa do Microsoft Excel. Cognos Analysis for Microsoft Excel também é benéficopara usuários que precisam acessar ambos dados do Cognos TM1 e do CognosBusiness Intelligence a partir da mesma interface do cliente Excel.

Cognos Analysis for Microsoft Excel oferece os seguintes benefícios:v Otimizado para redes de longa distância (WANs).v Fornece um ambiente de planilha familiar que não requer um nível de

conhecimento poderoso no Excel para analisar e contribuir para os dados doCognos TM1.

v Combina os recursos do Microsoft Excel com uma abordagem de arrastar esoltar para analisar os cubos do Cognos TM1.

v Fornece um modo "baseado em intervalo " flexível que permite incluir formatose cálculos do usuário diretamente dentro da planilha.

v Fornece acesso nativo aos objetos de dados do TM1, como cubos, visualizações,subconjunto de dimensão, aliases e ambiente de simulação.


v Fornece a capacidade de combinar leitura/gravação baseada no Microsoft ExcelTM1 Planning com análise somente leitura com relação às origens de dados doCognos Business Intelligence na mesma interface da planilha.

Use o IBM Cognos TM1 Perspectives em vez do Cognos Analysis for MicrosoftExcel quando quiser executar o seguinte:v Usar a recuperação de dados baseados em fórmula e atualizações do TM1.v Projetar e construir TM1 Websheets e Active Forms.v Use as tarefas administrativas como atualizações de metadados e Botões de Ação

dentro de uma planilha (Scripts do Integrador Turbo).v Use as macro extensões do TM1 Perspectives VBA para construir aplicativos

customizados do Microsoft Excel.

Para obter mais informações, consulte o Guia do Usuário do IBM Cognos Analysis forMicrosoft Excel Versão.

IBM Cognos TM1 Application Web

O IBM Cognos TM1 Application Web é um Web client com área de cobertura zeroque permite abrir e trabalhar com os Cognos TM1 Applications usando qualquernavegador da web suportado. Siga a página de fluxo de trabalho do Cognos TM1Application Web, que pode abrir um nó, obter propriedade, inserir dados econtribuir com um plano. O Cognos TM1 Application Web é mais útil quando umapolítica corporativa proíbe a instalação de um cliente local ou quando é usado umsistema operacional diferente do Microsoft Windows, já que todos os thick clientsdo TM1 são baseados no Windows.

IBM Cognos TM1 Web

O IBM Cognos TM1 Web é um Web client com área de cobertura zero que permiteanalisar e modificar os dados do Cognos TM1 a partir de qualquer navegador daweb suportado. O Cognos TM1 Web não permite acessar a página de fluxo detrabalho do Cognos TM1 Application Web. Consequentemente, não é possívelparticipar do Cognos TM1 Applications com o TM1 Web.

Clientes de AdministraçãoEsses clientes do IBM Cognos TM1 podem ser usados para administrar seus dadose modelos do Cognos TM1.

IBM Cognos TM1 Performance Modeler

O IBM Cognos TM1 Performance Modeler é a ferramenta de modelagem maisrecente do Cognos TM1, que permite criar ou gerar rapidamente dimensão, cubos,regras, processos e outros objetos. O Performance Modeler simplifica o processo demodelagem ao gerar automaticamente as regras e os alimentadores necessáriospara seus aplicativos. O Performance Modeler também introduz uma importaçãoguiada, um processo simplificado para importar dados e metadados em umservidor TM1. O Performance Modeler deve ser usado como a ferramenta dedesenvolvimento e de manutenção primária para todos os modelos novos eexistentes do Cognos TM1.


IBM Cognos TM1 Architect

O IBM Cognos TM1 Architect é uma ferramenta de modelagem mais antiga doCognos TM1 que suporta a criação e a manutenção de todos os objetos do TM1. OTM1 Architect não suporta a geração automática do alimentador e de regras e nãofornece os recursos de importação guiados. Os usuários do Architect sãoincentivados a mudar para o Cognos TM1 Performance Modeler como o ambientede desenvolvimento principal dos modelos do TM1.

IBM Cognos TM1 Perspectives

O IBM Cognos TM1 Perspectives é o Suplemento do Excel do TM1. O Cognos TM1Perspectives é uma ferramenta mais antiga que pode ser usada para odesenvolvimento de modelo do Cognos TM1 e para analisar dados por meio dosrecursos do Microsoft Excel. Assim como oCognos TM1 Architect, o Perspectivessuporta a criação e a manutenção de todos os objetos do TM1, mas não fornece osrecursos avançados do Performance Modeler. Os usuários finais que precisarem dainterface de Suplemento do Excel e da capacidade de usar a funcionalidade doMicrosoft Excel, como geração de gráfico, enquanto trabalham com os dados doTM1 podem usar o Perspectives. Caso contrário, os administradores sãoincentivados a mudar para o Performance Modeler como o ambiente dedesenvolvimento principal de todo os modelos do TM1.

IBM Cognos TM1 Operations Console

O IBM Cognos TM1 Operations Console é uma ferramenta de operações baseadasna web designada para facilitar o monitoramento, suporte e gerenciamento deservidores Cognos TM1, fornecendo maior insight nas operações diárias doservidor. O Cognos TM1 Operations Console permite monitorar dinamicamenteencadeamentos em execução em diversos servidores TM1 em um determinadomomento. É possível classificar e filtrar a atividade de encadeamento, bem comoplanejar a criação de log da atividade do servidor. O Operations Console tambémfornece um recurso de verificação de funcionamento que determina o estado atualde cada servidor TM1 que estiver sendo monitorado. O Operations Console deveser a interface de opção para os administradores do Cognos TM1 que estiveremgerenciando um ambiente do TM1 de escala corporativa.

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 os sistemas operacionais, correções, servidores da web enavegadores da web, visitando o Cognos TM1 Software Environments(http://www.ibm.com/support/docview.wss?uid=swg27040698).

Software Obrigatório

O Cognos TM1 requer a instalação de componentes de software específicos antesque ele possa ser instalado e usado.



Tabela 7. Componentes de Terceiros Obrigatórios

Componente de Pré-requisito Descrição

Microsoft Excel Obrigatório para Cognos TM1 Perspectives.

Pacote Redistribuível doMicrosoft Visual C++ 2010

Necessário para as instalações do Cognos TM1 noMicrosoft Windows.

Microsoft .NET Framework Requerido para Cognos TM1 Perspectives e Cognos TM1Architect.

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

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

Em um sistema Microsoft Windows de 64 bits:

C:\Program Files\IBM\cognos\tm1_64

Número da porta doAdmin Server

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

O valor padrão é 5495 (descoberto).

Esse valor é configurado no IBM Cognos Configuration.

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

O valor padrão é 5498 (assegurado)

Esse valor é configurado no IBM Cognos Configuration.

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.

Esse valor é configurado com o parâmetro PortNumber noarquivo de configuração do servidor Tm1s.cfg.


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

Item Descrição e Valor Padrão

Número da Porta deMensagem do ClienteCognos TM1

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

Esse valor é configurado com o parâmetroClientMessagePortNumber no arquivo de configuração doservidor Tm1s.cfg.

O valor padrão é blank.

Por padrão, esse número da porta é designado automaticamentee dinamicamente quando o servidor Cognos TM1 é iniciado.Você não precisa configurar o ClientMessagePortNumber para umnúmero específico a menos que os firewalls ou outros problemasde rede precisem que a porta do listener seja um número bemconhecido.

CUIDADO:Se você optar por definir um valor específico para o parâmetroClientMessagePortNumber, em vez de tê-lo atribuídodinamicamente, certifique-se de atribuir números de portasexclusivos para todos os servidores Cognos TM1 e portas demensagens de clientes que você está usando. Se você tiver doisservidores em execução na mesma máquina com o mesmonúmero da porta, a atividade de mensagem poderá causar umconflito ou interrupção do sistema.

Nome do host do AdminServer

Especifica o nome do computador ou endereço IP do HostAdministrativo no qual um Cognos TM1 Admin Server estásendo executado.

O valor padrão está em branco e usa o localhost pararepresentar o computador no qual a instalação é executada.

Este valor é configurado com o parâmetro AdminHost nosarquivos de configuração Tm1s.cfg e Tm1p.cfg.

Nomes do ServidorCognos TM1 de amostra

Amostra de Planejamento

SData

GO_New_Stores

Credenciais de Login:

Nome de Usuário: admin

Senha: apple

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.

Servidor Cognos TM1Application

Inicie e pare o servidor de aplicativos da web Apache Tomcatfornecido que suporta os componentes a seguir:

v IBM Cognos TM1 Web

v IBM Cognos TM1 Applications

v IBM Cognos TM1 Operations Console

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

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.

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


Tabela 10. Resumo das Opções de Configuração para Diferentes Componentes do CognosTM1

Configuração Descrição

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

Consulte o Apêndice A, “O arquivo de configuração doservidor tm1s.cfg”, na página 271.

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

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

Cognos TM1 Web

Arquivotm1web_config.xml

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

Consulte o “Modificando os Parâmetros de Configuração doCognos TM1 Web” na página 121.


pmpsvc_config.xml

fpmsvc_config.xml

Arquivos de configuração do Cognos TM1 Applications

As configurações do cliente são armazenadas no arquivopmpsvc_config.xml.

As configurações do servidor são armazenadas no arquivofpmsvc_config.xml.

Consulte Capítulo 11, “Instalação do Cognos TM1 ApplicationServer”, na página 139 e “Fazendo Backup de seus dados doCognos TM1 Applications” na página 261.

Cognos TM1 OperationsConsole

Configuração do Cognos TM1 Operations Console

Consulte o “Instalando o Cognos TM1 Operations ConsoleUsando o Software do Servidor da Web Apache TomcatFornecido” na página 105.

Contas de Usuário para Executar Serviços do Cognos TM1 noWindows

Quando o IBM Cognos Configuration é usado para iniciar o Cognos TM1 AdminServer e o Cognos TM1 Server, eles são registrados para serem executados comoserviços do Windows usando a Conta do Sistema Local do Microsoft Windowsdefinida. Você deve alterar manualmente esses serviços para serem executados sobuma conta de usuário específica.

Execute os Serviços do Cognos TM1 com uma Conta de Usuáriodo Windows Específica

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

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 do CognosTM1 executado 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 89.

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 do usuário para execução de serviços do Cognos TM1 no Windows deveser incluída no grupo de proprietários do banco de dados para acessar tabelas SQLe visualizações.

A conta deve ter os seguintes privilégios na máquina local:

Nota: Nem todas essas propriedades estão disponíveis em todas as versões doWindows, como o Windows Server 2008 R2 e mais recente. Consulte adocumentação do Microsoft Windows para as propriedades disponíveisatualmente.v Agir como parte do sistema operacionalv Ignorar a verificação transversalv Aumentar cotas (Ajustar cotas de memória para um processo)v 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

Use os recursos Configurações de Segurança e Política de Grupo no MicrosoftWindows para configurar esses privilégios de segurança. Por exemplo, noMicrosoft Windows 7, clique em Ferramentas Administrativas > Política deSegurança Local e, em seguida, clique para expandir Configurações de Segurança> Políticas Locais > Designação de Direitos do Usuário.

Para configurar os privilégios de leitura e gravação para o Registro do Windows,use o editor de Registro do Windows.

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

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 cotas


v 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 uma abreviação para o domínio da máquina local aoespecificar 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 de tecnologia da informação e com asnecessidades comerciais das pessoas em sua organização que usarão o IBM CognosTM1.

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

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 Cliente Cognos TM1 Webv 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 osistema, 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 .

Camada 3: Dados

TM1 Server

TM1 Admin Server

Cognos Configuration

Camada 1: Clientes e Interfaces com o Usuário

Clientes de Desktop Web Clients

Camada 2: Servidores de Aplicativos da WebServidor da Web

Figura 1. Visão Geral Resumida da Arquitetura de Cliente/Servidor do 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 LAN ou WAN normal, todos esses clientes se comunicam 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, esseservidor 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 .

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.

Clientes do TM1

TM1 Server

Os clientes do TM1 recuperam valores do cubo do servidor. Os clientes também enviam edições para valores de cubo ao TM1 Server

Diretório de dados

Enquanto o TM1 Server está em execução, todos os dados do cubo residem na RAM.Todas as edições recebidas dos clientes do TM1 são armazenadas em um arquivo de log de transações denominado Tm1s.log

Quando o TM1 Server é encerrado,ou quando um comando SalvarDados explícito é emitido, quaisquermudanças nos valores do cubo sãogravadas a partir do arquivo de log transacionalpara o diretório de dados

Quando o TM1 Server éiniciado, todos os dados do TM1 sãocarregados a partir do diretório de dados do TM1 na RAM namáquina servidor

Figura 2. Operações de um Servidor Remoto

Capítulo 3. Arquitetura 27

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

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

.rux Regra compilada

.sub Subconjunto de dimensões


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

Extensão do Arquivo Descrição

.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

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.

Nota: Não é possível armazenar os arquivos cube (.cub) e rules (.rux) emdiretórios de dados separados. O arquivo .rux deve residir no mesmo diretório queo arquivo .cub com o qual ele está associado. Se o arquivo .rux não estiver nomesmo diretório que o arquivo .cub associado, as regras não serão carregadasadequadamente.

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 mais informações, consulte Apêndice B, “O Arquivo de Configuraçãodo Cliente Tm1p.ini”, na página 329.

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 A, “Oarquivo de configuração do servidor tm1s.cfg”, na página 271.

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 Cognos TM1 Software Environments (http://www.ibm.com/support/docview.wss?uid=swg27040698) para obter os navegadores da web suportadosatualmente.

Camada 2: Servidor de Aplicativos da Web

O Cognos TM1 Web é executado no servidor de aplicativos da web baseado emJava.

Essa camada fornece suporte para converter e exibir planilhas da web do MicrosoftExcel como Planilhas da web do Cognos TM1. Esse serviço também exporta

TM1 Server

Camada 3: Dados

TM1 Admin Server

Servidor da web TM1 Web (em execução no Apache Tomat)

Cliente do TM1 Web(em navegador da web

suportado)

Camada 2: Servidor de Aplicativos da Web


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



Websheets de volta para os formatos Microsoft Excel e PDF.

Camada 3: Dados

Esta camada inclui o Cognos TM1 Admin Server e pelo menos um Cognos TM1Server.

IBM Cognos TM1 Admin Server

O Cognos TM1 Admin Server pode ser instalado em qualquer computadorna LAN, mas deve residir no mesmo segmento da LAN que o CognosTM1 Server. Normalmente, o Cognos TM1 Server e o Cognos TM1 AdminServer são instalados no mesmo computador.

IBM Cognos TM1 Server

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

A versão do Cognos TM1 usada em seu ambiente do Cognos TM1 Webdeve ser igual ou mais recente do que a versão do Cognos TM1 Web queestá sendo executa. Se a versão do Cognos TM1 Web que está sendoexecutada for mais recente do que a versão do Servidor Cognos TM1, osusuários receberão um erro ao 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 mesmoCognos TM1 Admin Server e em que usuários possuem a mesma combinação denome 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 Cognos TM1 Admin Server, o IBM Cognos TM1 Webefetuará seu login automaticamente nesses outros servidores em uma baseconforme necessário. Este comportamento é diferente do Cognos TM1 Architect edo Cognos TM1 Perspectives nos quais é necessário efetuar login em outrosservidores 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 101.

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.

Camada 3: Dados

Servidor Cognos TM1

Cognos TM1 Admin Server


Cognos TM1 Performance Modeler

Servidor de Aplicativos da Web Baseado em Java(IBM WebSphere ou Apache Tomcat)

Cognos TM1 Application Gateway

Cognos Insight(Distribuído)


Camada 2: Servidores da Web

Clientes de Contribuição de Dados

Cognos Insight(Conectado)

Cognos TM1Application Web

Cognos Insight

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


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.


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 principalponto de início para ambos os usuários, administradores e nãoadministradores. Esta página fornece uma lista de aplicativos disponíveisque são filtrados para o usuário atual. Clicar em um aplicativo nestapágina abre a página do fluxo de trabalho.

Os administradores e desenvolvedores de aplicativos também podem abriro Cognos TM1 Performance Modeler e o Cognos Insight a partir da barrade ferramentas do Cognos TM1 Applications.

Página do Cognos TM1 Application

A página do Cognos TM1 Application (página do fluxo de trabalho)permite gerenciar tarefas dentro de um único aplicativo. Esse cliente exibecada nó com o qual um usuário é responsável por contribuir e/ou revisarem um plano específico. Dependendo de como você configurar oaplicativo, o usuário poderá abrir o cliente Cognos Insight ou o clienteCognos 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 CognosTM1 Applications que permitem que os usuários trabalhem com dados nosformatos de grade 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


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

Clientes Descrição

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 programaremotamente usando o Windows Installer e outras ferramentas de gerenciamentode software. Para obter detalhes, consulte “Instalando o Cognos TM1 PerformanceModeler” na página 168.

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

Cognos TM1 Applications Camada 2: Servidor da WebA camada de servidores da web contém o servidor de aplicativos da web baseadoem Java necessário.

Servidor de Aplicativos da Web Java

Os seguintes componentes requerem um servidor de aplicativos da web baseadoem Java. É possível usar a versão do Apache Tomcat que é fornecida com ainstalação ou sua própria instalação de um dos servidores de aplicativos da webbaseados em Java suportados.


Servidor Cognos TM1 ApplicationO aplicativo da web baseado em Java que fornece o suporte primário parao IBM Cognos TM1 Applications.

Cognos TM1 Application GatewayO componente da web baseado em Java que oferece o fornecimento doscomponentes do Cognos TM1 Performance Modeler e do Cognos Insightpara usuários finais remotos.

Cliente Cognos TM1 Application WebUma interface com o usuário opcional baseada na tecnologia do CognosTM1 Web para visualizar e editar dados do aplicativo. Se você estiverusando essa opção, os arquivos de suporte para ela serão executados nestemesmo servidor de aplicativos da web.

Usando a Segurança e o Servidor da Web Fornecidos peloCognos BI

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” na página 228.

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 secomunica 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 Servidor Cognos TM1 Application

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 Servidor Cognos TM1 Applicationv 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.


Tabela 14. Instalando os Componentes do Servidor Cognos TM1

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

Os serviços do Cognos TM1 devem ser executados em computadores configuradoscom o mesmo código de idioma. Não é possível, por exemplo, instalar algunsserviços em um computador que executa o código de idioma inglês dos EUA eoutros serviços em um computador que executa o código de idioma alemão.Configure o código de idioma usando a opção Padrões e Formatos no MenuIniciar, Configurações Regionais e Locais do Microsoft Windows.

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 Capítulo 10, “Instalação do Cognos TM1 Web”, napágina 115.

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 33 e Capítulo 11, “Instalação do Cognos TM1 Application Server”, napágina 139.

v Para suportar a integração com os componentes do IBM Cognos BusinessIntelligence (BI), assim como usar o Cognos TM1 Viewer Portlets e iWidgets.Para obter detalhes, consulte “Cognos TM1 iWidgets e Cognos Workspace” napágina 72.

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 ao Usar o Cognos TM1Applications

É 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” na página 228.

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.

Se IntegratedSecurityMode=5 for usada para o IBM Cognos TM1 Server e o IBMCognos TM1 Applications, não será possível designar direitos para os grupos deTM1 nativos no diálogo Gerenciar direitos. Somente os Grupos do Cognosimportados para o TM1 Server, estarão disponíveis. Isso significa que não épossível usar os grupos de TM1 nativos e grupos do Cognos em paralelo, porque oSecMode está limitando quais grupos podem ser usados

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 ApplicationWeb para usar vários servidores Cognos TM1” na página 159.

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 Servidor Cognos TM1 Applicationv 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 os 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.

É 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


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.

Essa configuração combina o servidor de aplicativos da web Java para os CognosTM1 Applications e IBM Cognos TM1 Web no mesmo computador, mas localiza acamada de dados (servidor Cognos TM1) em um computador separado.

Implementar Servidores de Aplicativos da Web emComputadores Separados

Essa configuração instala o servidor de aplicativos da web para o servidor deaplicativos da web Java para o Cognos TM1 Applications e o Cognos TM1 Web emseus próprios computadores. A camada de dados também poderia ser instalada emum destes computadores ou em seu próprio computador dedicado.

Implementar Todos os Componentes em ComputadoresSeparados

Essa configuração instala os servidores de aplicativo da web Java para o CognosTM1 Applications and Cognos TM1 Web e o Cognos TM1 Admin Server e o(s)servidor(es) Cognos TM1 todos em computadores 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 15. Cenários de Instalação para Implementação do IBM Cognos TM1 Applications

Cenários de instalação Etapas da Instalação

Executando todos os aplicativosda web Java juntos em umcomputador separado

Use o programa de instalação do Cognos TM1 parainstalar o Cognos TM1 Application Server, o Cognos TM1Application Gateway e o Cognos TM1 Web nocomputador que executa o servidor de aplicativos da webJava.

Executando o Cognos TM1Web em um computadorseparado

Use o programa de instalação do Cognos TM1 parainstalar o Cognos TM1 Web em um computadorseparado.

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.


Tabela 15. Cenários de Instalação para Implementação do IBM Cognos TM1Applications (continuação)

Cenários de instalação Etapas da 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 mais informações, consulte “Implementando oCognos TM1 Admin Server e o TM1 Server” 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 ou um link da web)v Cognos TM1 Applications (usando uma URL ou um link da web)

Implementando o Cognos TM1 Mobile ContributorO IBM Cognos TM1 Mobile Contributor é um aplicativo remoto para o Apple iPadque se conecta a um IBM Cognos TM1 Server e coexiste com outras áreas detrabalho e aplicativos da web que se conectam ao mesmo servidor.

Os usuários remotos podem acessar seus aplicativos de planejamento do IBMCognos TM1 Applications, visualizar o status de envio para todos os nós deaprovação e interagir com as visualizações do cubo no formato de grade ou gráficono aplicativo do iPad. Os usuários também podem alterar valores no iPad eenviá-los novamente ao plano no qual os dados serão atualizados no servidor IBMCognos TM1.

Visão Geral do Sistema

O aplicativo remoto conecta-se e interage com um Cognos TM1 Server e umCognos TM1 Application Server. Os envios iniciados em um cliente (navegador daweb, aplicativo de desktop ou remoto) podem ser continuados ou concluídos emoutro.

Para os usuários, os conceitos do Cognos TM1 Mobile Contributor são consistentescom outras interfaces de usuário de contribuição, com a exceção de que os gestossão consistentes com um dispositivo móvel, baseado em toque.

Os principais componentes do sistema incluem:v Cognos TM1 Mobile Contributor for iPadv Cognos TM1 Serverv Servidor Cognos TM1 Application


Uma conexão de rede wireless é necessária no iPad para permitir que o CognosTM1 Mobile Contributor se conecte com os dados remotos do TM1.

Tarefas de Instalação e Configuração para os Administradoresdo TM1

O Cognos TM1 Server e o Cognos TM1 Application Server devem estar instaladose em execução para que o Cognos TM1 Mobile Contributor possa ser usado.

Instale o Cognos TM1 Applications em um sistema que esteja disponível na redewireless.1. Instale e execute o Cognos TM1 Applications.

v Use o IBM Cognos Configuration para assegurar-se de que o TM1Application Server e o TM1 Server estejam em execução.

v Assegure-se de que o Cognos TM1 Application Server esteja acessível na suarede wireless.

v Implemente e ative um aplicativo de planejamento com o Cognos TM1Applications.

2. Forneça o nome do host e o número da porta do Cognos TM1 ApplicationServer para os usuários do aplicativo. Os usuários deverão inserir essasinformações no aplicativo do iPad para conectarem-se ao Cognos TM1.O nome do host deve possuir o formato:web_server_name.domain_name.comO número da porta do servidor padrão para a instalação padrão do CognosTM1 é 9510.

3. Se o servidor da web que suporta o Cognos TM1 Mobile Contributor forconfigurado para SSL, os usuários deverão configurar a opção Ativar SSL comoON.

Configurando o Cognos TM1 Mobile Contributor no iPad

Como usuário do iPad, instale o Cognos TM1 Mobile Contributor no iPaddiretamente a partir do Apple App Store. Abra o App Store e procure o “IBMCognos TM1” para localizar e, em seguida, instalar o aplicativo.

Após instalar e executar o Cognos TM1 Mobile Contributor pela primeira vez,configure o aplicativo para que seja possível se conectar ao Cognos TM1Application Server.1. No iPad, abra o Cognos TM1 Mobile Contributor.2. Na tela de boas-vindas, toque no botão Incluir nova conexão (+).3. No diálogo Conectar, insira as seguintes informações para conectar-se ao

Cognos TM1 Application Server:v No campo Host, insira o nome do servidor da web que suporta o Cognos

TM1 Mobile Contributor.Por exemplo: webserver.example.com

v No campo Nome da Conexão, insira sua própria descrição de texto para essaconexão.

v Para a Porta do Servidor, use o número da porta padrão 9510. Se ainstalação do TM1 estiver configurada para usar um número da portadiferente, insira esse valor.

v Se o servidor da web que suporta o Cognos TM1 Mobile Contributor estiverconfigurado para segurança de SSL (https://), configure a opção Ativar SSLcomo ON.


4. Toque em Conectar para salvar e iniciar o uso da conexão.5. Se solicitado, insira o nome de usuário e senha para concluir a conexão.

Configurando o Cognos TM1 Mobile Contributor para exibir osservidores e cubos do TM1

É possível explorar os servidores e cubos do Cognos TM1 diretamente no CognosTM1 Mobile Contributor sem criar e implementar um Cognos TM1 Application apartir do Cognos TM1 Performance Modeler. No entanto, nesse caso, os recursossuportados pelos aplicativos do TM1 como o fluxo de trabalho e as anotações nãoestão disponíveis.

Antes de Iniciar

Para efetuar o login no Cognos TM1 Mobile Contributor, deve-se ter acesso a pelomenos um servidor do Cognos TM1 registrado com o serviço de planejamento doCognos TM1 Applications. Caso contrário, não será possível conectar no CognosTM1 Mobile Contributor.

Sobre Esta Tarefa

Para acessar e exibir os servidores e cubos do Cognos TM1 diretamente no CognosTM1 Mobile Contributor, primeiro inclua o servidor na janela do Cognos TM1Applications Configuration. Após configurar o Cognos TM1 Applications, serápossível efetuar o login em uma conexão no Cognos TM1 Mobile Contributor paraver todos os aplicativos e servidores disponíveis.

Procedimento1. Abra o Cognos TM1 Applications e, em seguida, abra a janela de configuração.2. Inclua um servidor do Cognos TM1 na lista.

Para obter mais informações, consulte Configurando opções de configuração doCognos TM1 Applications (http://www.ibm.com/support/knowledgecenter/SS9RXT_10.2.2/com.ibm.swg.ba.cognos.tm1_cont_ug.10.2.2.doc/t_settingapplicationconfigurationoptions_na5571.html).

3. Abra o Cognos TM1 Mobile Contributor e crie uma conexão que aponte para osistema que esteja executando o Cognos TM1 Applications.

4. Efetue o login na conexão.Os aplicativos e servidores disponíveis são exibidos. Um ícone diferente émostrado para os aplicativos e servidores.


http://www.ibm.com/support/knowledgecenter/SS9RXT_10.2.2/com.ibm.swg.ba.cognos.tm1_cont_ug.10.2.2.doc/%20t_settingapplicationconfigurationoptions_na5571.html

http://www.ibm.com/support/knowledgecenter/SS9RXT_10.2.2/com.ibm.swg.ba.cognos.tm1_cont_ug.10.2.2.doc/%20t_settingapplicationconfigurationoptions_na5571.html

5. Para visualizar os cubos e visualizações disponíveis, selecione um Cognos TM1Server.

Visualizando os cubos de marcação de desempenho ediagramas de impacto no Cognos TM1 Mobile Contributor

É possível visualizar e interagir com os cubos de Scorecarding e os diagramas deimpacto no Cognos TM1 Mobile Contributor. Use esse recurso para monitorar odesempenho de suas métricas de chave direita em seu tablet visualizando o status,tendência e os valores reais na grade de dados e nos formatos de diagrama devisualização.

Sobre Esta Tarefa

Os cubos de marcação de desempenho podem estar em um TM1 Application oudiretamente em um TM1 Server.

Procedimento1. Para abrir um cubo de marcação de desempenho:

a. Abra e efetue o login em uma conexão no menu da barra lateral do CognosTM1 Mobile Contributor.

b. Dê um toque em um TM1 Application ou um TM1 Server que contenhapelo menos um cubo de marcação de desempenho.v Para um TM1 Server, selecione um cubo de marcação de desempenho e,

em seguida, selecione uma visualização.v Para um TM1 Application, selecione um nó na hierarquia e, em seguida,

selecione uma visualização.c. O cubo de marcação de desempenho mostra os ícones de indicador de

métrica para o Status e Trend corretos nas células da grade de dados.É possível usar os ícones do indicador de métrica para criar os itens Listade observação. Para obter mais informações, consulte “Criando evisualizando os itens da lista de observação do Scorecarding no CognosTM1 Mobile Contributor” na página 47.


2. Para visualizar um diagrama de impacto marcação de desempenho:

a. Dê um toque em Configurações e selecione uma opção Layout ouGráfico ou Ambos.As opções de layout disponíveis incluem os modos de exibição a seguir:v Grade exibe somente uma grade de dados.v Gráfico exibe somente um gráfico.v Ambos exibe uma grade de dados e um gráfico.

b. Para dar um zoom no diagrama de impacto, use uma pitada two-finger ouespremer gesto.

c. Para panoramizar ou mover o diagrama, use um toque e arraste.d. Para expandir e reduzir os nós no diagrama, dê um toque nos ícones + e –.

Criando e visualizando os itens da lista de observação doScorecarding no Cognos TM1 Mobile Contributor

É possível usar a lista de observação do Scorecarding no Cognos TM1 MobileContributor para monitorar as métricas importantes, como a renda e o lucro.


Sobre Esta Tarefa

Um item da lista de observação pode ser criado somente para as células quecontenham um indicador de métrica do Scorecarding para o Status ou Trend.

Quando o valor de um item da lista de observação for atualizado, uma notificaçãoserá exibida no aplicativo e também na lista Centro de Notificações do iOS.

Procedimento1. Para criar um item da lista de observação do Scorecarding:

a. Abra uma visualização do cubo no Cognos TM1 Mobile Contributor.A visualização do cubo pode estar em um TM1 Application ou diretamenteem um TM1 Server.

b. Para incluir um item da lista de observação, dê um toque e mantenha umacélula Status ou Trend na grade de dados.Espere a célula a ser destacada e automaticamente incluída na lista deobservação.

2. Para visualizar sua lista de observação:

a. Clique no ícone menu para exibir a barra lateral.

b. Clique no ícone da lista de observação .3. Para visualizar o item da lista de observação no cubo relacionado, dê um toque

no item e, em seguida, clique em Ir.4. Para alterar o nome de um item da lista de observação, dê um toque duplo no

item e insira um novo nome.5. Para excluir um item da lista de observação, deslize os dedos através do item

na lista de observação, em seguida, dê um toque em Excluir.


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.

Fazendo o upgrade da versão 10.2.0

Fazer o upgrade do Cognos TM1 versão 10.2.0 para a versão 10.2.2 requer umadesinstalação manual completa e depois uma instalação completa da nova versão.

Para obter mais informações, consulte “Fazendo o upgrade do Cognos TM1 versão10.2.0” na página 51.

Atualizando a partir da Versão 10.1.x

Fazer o upgrade do Cognos TM1 versão 10.1 ou 10.1.1 para a versão 10.2.2 requeruma desinstalação manual completa e depois uma instalação completa da novaversão.

Uma diferença principal entre as versões 10.1.x e 10.2.x, é o servidor de aplicativosda web necessário para o Cognos TM1 Web. Iniciando com a versão 10.2.0, oCognos TM1 Web não usa o Microsoft Internet Information Services (IIS), mas, emvez disso, usa um servidor de aplicativos da web Java, como a versão do ApacheTomcat fornecida.

Para obter mais informações, consulte “Atualizando a partir do Cognos TM1Versão 10.1.x” na página 52.

Atualizando da Versão 9.x

Fazer o upgrade do Cognos TM1 versão 9.0.x, 9.1.x ou 9.5.x para a versão 10.2.2requer uma desinstalação manual completa e depois uma instalação completa danova versão.

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.

Para obter mais informações, consulte “Atualizando do Cognos TM1 Versão 9.x”na página 54.

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 novaversã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ê atualmente usa eimplementou.

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 TM1 9.0.x e 9.1.x são convertidos automaticamentepara Unicode quando forem abertos (iniciados) com um servidor CognosTM1 versão 9.4 ou superior. Após um banco de dados do TM1 maisantigo ser convertido em Unicode, ele não poderá mais ser aberto nasversões anteriores do TM1.

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

Cognos TM1 WebA partir do IBM Cognos TM1 versão 10.2.0, o Cognos TM1 Web éexecutado em um servidor de aplicativos da web Java, como a versão doApache Tomcat fornecida. O Cognos TM1 Web versão 10.2.0 e mais recentenão requer ou usa o Microsoft .NET Framework.v A partir do Cognos TM1 Web versão 10.2.0, o diretório de instalação

padrão para o Cognos TM1 Web foi alterado de C:\inetpub\wwwroot\TM1Web para <TM1_Install>\tm1web.

v O Cognos TM1 Web versão 10.2.0 e mais recente usa um novo arquivode configuração chamado tm1web_config.xml. Esse arquivo substitui oarquivo web.config das versões anteriores do Cognos TM1 Web. O novoarquivo inclui um subconjunto dos parâmetros anteriores, porque osparâmetros relacionados ao Microsoft .NET Framework foramremovidos.O local do novo arquivo de configuração é:<TM1_install>\webapps\tm1web\web-inf\configuration

Se você desejar usar quaisquer configurações do arquivo de configuraçãoanterior do Cognos TM1 Web, será possível mesclar seletivamente asconfigurações de parâmetros do arquivo antigo Web.config no novoarquivo tm1web_config.xml.

v Várias etapas foram alteradas para configurar os diferentes tipos deautenticação e segurança de transmissão de dados para o TM1 Web.



v Atenção: Você precisará editar seus aplicativos anteriores no CognosTM1 Performance Modeler, se eles usarem os recursos a seguir:– 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 Cognos TM1 Applications egerenciá-la usando o Cognos Configuration.

v Se você planeja usar o Cognos TM1 Applications sem Microsoft Excelinstalado no servidor da web onde estiver executando o Cognos TM1Web, precisará configurar explicitamente o parâmetroExcelWebPublishEnabled para True (T) no arquivo de configuraçãotm1s.cfg para seus servidores Cognos TM1. As versões mais antigas doCognos TM1 Contributor não precisavam 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, seus dados 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 banco de dados e configuração do Cognos TM1 Serverv Arquivos customizados e configuração do servidor Cognos TM1 Webv Arquivo de configuração do cliente Cognos TM1 Architectv Arquivo de configuração do cliente Cognos TM1 Perspectivesv Arquivos de configuração e aplicativo do Cognos TM1 Contributor

Fazendo o upgrade do Cognos TM1 versão 10.2.0Ao fazer o upgrade do IBM Cognos TM1 da versão 10.2.0 para a versão 10.2.2, seránecessário desinstalar a versão anterior e, em seguida, instalar a versão atual. Nãoé possível instalar o IBM Cognos TM1 versão 10.2.2 diretamente sobre a versão10.2.0. Você também deve planejar fazer backup dos dados e arquivos deconfiguração existentes antes de desinstalar a versão anterior.

Sobre Esta Tarefa

As etapas a seguir fornecem um guia geral para o upgrade do Cognos TM1 versão10.2.0 para a versão atual.

Procedimento1. Faça backup dos dados e dos arquivos de configuração existentes:

Você deve planejar fazer backup dos dados e arquivos de configuraçãoexistentes para um local seguro para todos os computadores em que oscomponentes Cognos TM1 estiverem instalados. Para obter detalhes, consulteos tópicos a seguir:

Capítulo 5. Fazendo Upgrade 51

v “Fazendo Backup de Dados e Arquivos de Configuração para Cognos TM1”na página 257

v “Fazendo Backup de seus dados do Cognos TM1 Applications” na página261

2. Desinstale todos os componentes do Cognos TM1:Se você instalou a versão anterior do Cognos TM1 em um ambientedistribuído, será necessário desinstalar os componentes TM1 a partir de cadacomputador.v “Desinstalando o Cognos TM1” na página 259v “Desinstalando e Implementando o Cognos TM1 Applications” na página 260

3. Instale a versão atual do IBM Cognos TM1:Consulte os tópicos a seguir, dependendo do seu ambiente de computador e dequais componentes Cognos TM1 você deseja instalar.v Capítulo 7, “Instalação de Computador Único do Cognos TM1”, na página 77v Capítulo 8, “Instalação do Cognos TM1 Server”, na página 87v Capítulo 10, “Instalação do Cognos TM1 Web”, na página 115v Capítulo 11, “Instalação do Cognos TM1 Application Server”, na página 139v Capítulo 12, “Instalação da Camada de Desenvolvedor e de Cliente do

Cognos TM1”, na página 165v “Instalando o Cognos TM1 Operations Console Usando o Software do

Servidor da Web Apache Tomcat Fornecido” na página 1054. Para fazer o upgrade do Cognos TM1 Mobile Contributor, use o recurso de

atualização disponível no Apple App Store em seu iPad.5. Após instalar a nova versão do Cognos TM1 Applications, remova o cache do

navegador da web. Se o cache não for removido, o navegador poderá combinararquivos do Cognos TM1 Applications antigo e do Cognos TM1 Applicationsnovo juntos.

6. Restaure os arquivos de configuração e os dados anteriores do Cognos TM1:Dependendo de quais componentes você instalou, atualize cada computadorcom os arquivos de configuração e dados anteriores.v “Restaurando os dados e arquivos de configuração no Cognos TM1 versão

10.2.2” na página 265v “Restaurando Arquivos de Aplicativo e Configuração no Cognos TM1

Applications” na página 266

Atualizando a partir do Cognos TM1 Versão 10.1.xAo atualizar o IBM Cognos TM1 versão 10.1.x para a versão 10.2.2, será necessáriodesinstalar a versão anterior e, em seguida, instalar a versão atual. Não é possívelinstalar o IBM Cognos TM1 versão 10.2.2 diretamente sobre a versão 10.1.x. Vocêtambém deve planejar fazer backup dos dados e arquivos de configuraçãoexistentes antes de desinstalar a versão anterior.

Antes de Iniciar

Revise as alterações na versão atual do Cognos TM1 nos tópicos a seguir:v “Planejando o Upgrade” na página 50v “O que há de novo para a instalação e configuração do Cognos TM1 na versão

10.2.2” na página 1


v “O que Há de Novo para a Instalação e a Configuração do Cognos TM1 naVersão 10.2.0” na página 3

Uma diferença principal entre as versões 10.1.x e 10.2.x, é o servidor de aplicativosda web necessário para o Cognos TM1 Web. O Cognos TM1 Web versão 10.2.x nãousa o Microsoft Internet Information Services (IIS) mas, em vez disso, usa umservidor de aplicativos da web Java, como a versão fornecida do Apache Tomcat.

Sobre Esta Tarefa

As etapas a seguir fornecem um guia geral para o upgrade do Cognos TM1 versão10.1.x para a versão atual.

Procedimento1. Faça backup dos dados e dos arquivos de configuração existentes:

Você deve planejar fazer backup dos dados e arquivos de configuraçãoexistentes para um local seguro para todos os computadores em que oscomponentes Cognos TM1 estiverem instalados. Para obter detalhes, consulteos tópicos a seguir:v “Fazendo Backup de Dados e Arquivos de Configuração para Cognos TM1”

na página 257v “Fazendo Backup de seus dados do Cognos TM1 Applications” na página

2612. Desinstale todos os componentes do Cognos TM1:

Se você instalou a versão anterior do Cognos TM1 em um ambientedistribuído, será necessário desinstalar os componentes TM1 a partir de cadacomputador.v “Desinstalando o Cognos TM1” na página 259v “Desinstalando e Implementando o Cognos TM1 Applications” na página 260

3. Instale a versão atual do IBM Cognos TM1:Consulte os tópicos a seguir, dependendo do seu ambiente de computador e dequais componentes Cognos TM1 você deseja instalar.v Capítulo 7, “Instalação de Computador Único do Cognos TM1”, na página 77v Capítulo 8, “Instalação do Cognos TM1 Server”, na página 87v Capítulo 10, “Instalação do Cognos TM1 Web”, na página 115v Capítulo 11, “Instalação do Cognos TM1 Application Server”, na página 139v Capítulo 12, “Instalação da Camada de Desenvolvedor e de Cliente do

Cognos TM1”, na página 165v “Instalando o Cognos TM1 Operations Console Usando o Software do

Servidor da Web Apache Tomcat Fornecido” na página 1054. Após instalar a nova versão do Cognos TM1 Applications, remova o cache do

navegador da web. Se o cache não for removido, o navegador poderá combinararquivos do Cognos TM1 Applications antigo e do Cognos TM1 Applicationsnovo juntos.

5. Restaure os arquivos de configuração e os dados anteriores do Cognos TM1:Dependendo de quais componentes você instalou, atualize cada computadorcom os arquivos de configuração e dados anteriores.v “Restaurando os dados e arquivos de configuração no Cognos TM1 versão

10.2.2” na página 265v “Restaurando Arquivos de Aplicativo e Configuração no Cognos TM1

Applications” na página 266


Atualizando do Cognos TM1 Versão 9.xFazendo o upgrade do IBM Cognos TM1 da versão 9.x para a versão 10.2.2 requeruma desinstalação completa e um procedimento de instalação.

Antes de Iniciar

Revise as diferenças entre o Cognos TM1 versão 9.x e a versão atual. Uma série deetapas de configuração e diretórios de instalação foram alterados entre a versão 9.xe 10.x. Para obter detalhes, consulte os seguintes tópicos:v “Planejando o Upgrade” na página 50v “O que há de novo para a instalação e configuração do Cognos TM1 na versão

10.2.2” na página 1v “O que Há de Novo para a Instalação e a Configuração do Cognos TM1 na

Versão 10.2.0” na página 3

Sobre Esta Tarefa

As etapas a seguir fornecem um guia geral para atualizar o Cognos TM1 versão 9.xpara a versão atual.

Procedimento1. Pare os serviços para componentes Cognos TM1 9.x.2. Faça backup dos arquivos de configuração e dos dados.3. Desinstale o Cognos TM1 versão 9.x.4. Instale a versão atual.5. Restaure os arquivos de configuração e os dados.

Parando os Serviços do Cognos TM1 9.x antes do UpgradeTodos os serviços para IBM Cognos TM1 versão 9.x devem ser interrompidos antesde atualizar para a nova versão.

Procedimento1. Use o Windows Services para parar todos os serviços do Cognos TM1 9.x. Isso

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

2. Se você estiver usando o Cognos TM1 Contributor, pare o aplicativo CognosTM1 Contributor pmpsvc.Para isso, use as ferramentas de gerenciamento para o servidor de aplicativosda 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 mais informações,consulte “Fazendo Backup dos Dados para uma Versão Anterior do Cognos TM19.x” na página 55.


Fazendo Backup dos Dados para uma Versão Anterior doCognos TM1 9.x

Este 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 mais informações, consulte“Parando os Serviços do Cognos TM1 9.x antes do Upgrade” na página 54.

Sobre Esta Tarefa

Se estiver usando atualmente uma versão anterior do Cognos TM1 9.x, deve fazerbackup dos arquivos de configuração e diretório dos dados Cognos TM1 antes deinstalar a nova versão 10.x do Cognos TM1.

Se você estiver usando o Cognos TM1 Web 9.x ou Cognos TM1 Contributor 9.5.x,também deve fazer backup dos arquivos de configuração e dados relacionadospara 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:

%ALLUSERSPROFILE%\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

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 mais informações, consulte“Desinstalando uma Versão Anterior do IBM Cognos TM1 9.x”.

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

Antes de Iniciar

Certifique-se de ter feito backup de todos os arquivos de configuração e dados.Para obter mais informações, consulte “Fazendo Backup dos Dados para umaVersão Anterior do Cognos TM1 9.x” na página 55.

Sobre Esta Tarefa

Execute estas etapas em cada computador que deve ser atualizado.

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 do servidor de aplicativos da web a implementação do Cognos TM1

Contributor que você está usando.v Desinstale a ferramenta de administração do Cognos TM1 Contributor 9.5.x e

o IBM Cognos Rich Client Framework.Para obter detalhes, consulte “Atualizando o Cognos TM1 Contributor para oCognos TM1 Applications” na página 58.

O que Fazer Depois

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

Atualizando a Instalação de um Único Computador do CognosTM1

Este 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 7, “Instalação de Computador Único do Cognos TM1”, na página 77Este 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.


Quando terminar, conclua o upgrade restaurando seus dados, suas definições deconfiguração e seus aplicativos.Conceitos relacionados:“Instalando o Cognos TM1 Server no UNIX ou Linux” na página 90É possível instalar os componentes do Cognos TM1 Server em um computador de64 bits que executa um sistema operacional UNIX ou Linux. Use este tipo deinstalação para instalar e executar o Cognos TM1 Server 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 87É 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.


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


Capítulo 12, “Instalação da Camada de Desenvolvedor e de Cliente do CognosTM1”, na página 165É possível instalar os componentes da camada de desenvolvedor e de cliente doIBM Cognos TM1 usando o programa de instalação do servidor Cognos TM1 ou oprograma de instalação do cliente 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.


Quando terminar, conclua o upgrade restaurando seus dados, suas definições deconfiguração e seus aplicativos.Conceitos relacionados:Capítulo 10, “Instalação do Cognos TM1 Web”, na página 115É possível instalar o IBM Cognos TM1 Web em um computador diferente daqueleno qual o servidor Cognos TM1 e os outros componentes do Cognos TM1 foraminstalados.

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 os Serviços do Cognos TM1 9.x antes do Upgrade” napágina 54.

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 9.x” napágina 56

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 11, “Instalação do Cognos TM1Application Server”, na página 139.

7. Restaure seus arquivos de dados para cada Cognos TM1 Server que pretendeusar com o Cognos TM1 Applications.Para obter detalhes, consulte “Restaurando os Dados e Arquivos deConfiguração a partir do Cognos TM1 Versão 9.x na Versao Atual” na página61.

8. Edite o arquivo de configuração tm1s.cfg para cada Cognos TM1 Server 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 Cognos TM1 Server. Apartir 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 289.


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

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

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

Nota: O processo de upgrade poderá levar algum tempo, dependendo daquantia de direitos que precisarem ser aplicados no aplicativo. Para obter maisinformações, consulte “Salvando Direitos de Segurança ao Importar ouRestaurar um Cognos TM1 Application” na página 63.

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 os Dados e Arquivos de Configuração a partir doCognos TM1 Versão 9.x na Versao Atual

Apó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 TM19.x.

Antes de Iniciar


Procedimento1. Restaure seus arquivos de configuração 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 para os parâmetroscorrespondentes no Cognos Configuration. Por exemplo, se você estavausando configurações de SSL customizadas com a instalação anterior, copieos valores para esses parâmetros no Cognos Configuration.

e. No Cognos Configuration, clique em Arquivo > Salvar.2. Restaure seus 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 seus servidores CognosTM1.a. Para cada Cognos TM1 Server que deseja restaurar, copie seu diretório de

dados e subdiretórios no novo local para os dados: <TM1_Install>\samples\tm1.

b. Inclua cada servidor CognosTM1 no Cognos Configuration no qual épossível iniciar, parar e gerenciar o servidor. Para obter detalhes, consulte“Incluindo um Servidor Cognos TM1 Existente no Cognos Configuration”na página 100.

3. Restaure seus arquivos de configuração do Cognos TM1 Architect e CognosTM1 Perspectives:

Se desejar restaurar alguma configuração da sua instalação anterior do CognosTM1 Architect ou Cognos TM1 Perspectives, copie os valores do antigo arquivoTm1p.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 SSL padrão, altere manualmente o valor para esteparâmetro para o 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:



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


4. Restaure seus arquivos do Cognos TM1 Web:

Se você estiver usando a nova versão do Cognos TM1 Web, será possívelrestaurar algumas das definições de configuração que deseja usar.Abra o arquivo Web.config antigo e mescle seletivamente as linhas e osparâmetros que deseja usar no novo arquivo tm1web_config.xml localizado em<TM1_install>\webapps\tm1web\web-inf\configuration.

Nota: O Cognos TM1 Web versão 10.2.0 usa um novo arquivo de configuraçãochamado tm1web_config.xml. Esse arquivo substitui o arquivo web.config dasversões anteriores do Cognos TM1 Web. Para obter mais informações, consulte“Modificando os Parâmetros de Configuração do Cognos TM1 Web” na página121.

5. Restaure os arquivos de configuração e aplicativo no Cognos TM1Applications:

Para restaurar os arquivos de configuração e aplicativo a partir do Cognos TM1Contributor 9.5.x na versão atual de Cognos TM1 Applications, consulte“Atualizando o Cognos TM1 Contributor para o Cognos TM1 Applications” napágina 58.

Planilhas .xls do Microsoft ExcelO IBM Cognos TM1 Web versões 10.2.0 e mais recente usam os formatos dearquivo Open XML para planilhas do Microsoft Excel criadas usando o Excel 2007ou mais recente.

Se você estiver usando os arquivos do Microsoft Excel existentes no formato .xlsmais antigo, use a ferramenta de conversão do Cognos TM1 para converter osarquivos. Se o seu arquivo original contiver macros, a ferramenta de conversão doCognos TM1 converterá o arquivo original em um arquivo .xlsm ativado paramacro, caso contrário, ele será convertido em um arquivo .xslx padrão.

A opção Converter arquivos do Excel em formato OpenXML Excel no CognosTM1 Architect Server Explorer converte uma planilha .xls única ou todas asplanilhas em uma pasta. Apenas usuários administrativos possuem a opçãodisponível. A conversão renomeia os arquivos para preservar o máximo de linkspossível após a conversão. Alguns links e botões de ação precisam ser atualizados,dependendo das permissões que podem ter sido alteradas como resultado damovimentação para a segurança baseada em célula que ocorreu na versão 10.2.0.


Em alguns casos, os Intervalos Nomeados do arquivo original podem serrenomeados no arquivo convertido durante o processo de conversão.

Por padrão, um backup das planilhas pré-convertidas é salvo. Por padrão, umarquivo de logtambém é gerado.

Salvando Direitos de Segurança ao Importar ou Restaurar um CognosTM1 Application

No IBM Cognos TM1 Applications 10.2, a operação para salvar os direitos desegurança em um Cognos TM1 Application pela primeira vez pode sersignificativamente mais lenta do que nas liberações anteriores. Talvez esse atrasoocorra ao executar um upgrade e restaurar arquivos de aplicativo ou importar umaplicativo e os direitos de segurança relacionados manualmente.

Esse é um efeito conhecido de um novo design de segurança para o TM1Applications que fornece uma maior flexibilidade do design do aplicativo.Especificamente, a capacidade de compartilhar uma dimensão de Hierarquia deAprovação entre mais de um aplicativo foi incluída no Cognos TM1 Applications10.2. Agora, o Cognos TM1 Applications também permite implementar váriosaplicativos, protegidos independentemente, para diferentes ciclos do processo denegócios. Por exemplo, para operar um aplicativo de Orçamento e um aplicativode Previsão ao mesmo tempo, com base no mesmo cubo subjacente, permitindovariações de Orçamento versus Previsão em tempo real.

É importante observar que o atraso significativo no desempenho apenas é visto naprimeira vez em que os direitos são salvos para um aplicativo. A operação desalvamento de direitos também é executada ao restaurar arquivos de aplicativomanualmente ou quando um aplicativo é importado no Cognos TM1 ApplicationsPortal e você seleciona a opção para incluir os direitos de segurança durante oprocesso de importação.

Nos salvamentos subsequentes dos direitos, uma análise diferenciada seráexecutada para assegurar que o tempo gasto para processar os direitos seja umafunção do grau de mudança realizado. Por exemplo, uma mudança pequena nosdireitos será processada rapidamente. Esse é o principal fator na operação dodia-a-dia de um TM1 Application, em que provavelmente a atualização dosdireitos é feita rotineiramente para refletir as mudanças incrementais nos negócios.Mudanças de grande escala são incomuns depois que um aplicativo entra emprodução, portanto, as mudanças de rotina nos direitos serão processadasrapidamente.

Nota: Anteriormente, era necessário alterar esses direitos manualmente a partir dainterface com o usuário do portal doCognos TM1 Performance Modeler ou doCognos TM1 Applications. No entanto, a liberação do Cognos TM1 10.2 fornece acapacidade de automatizar essas mudanças a partir da linha de comandos pelaprimeira vez.


Capítulo 6. Integração do Cognos TM1 com Outros SoftwaresIBM Cognos

Existe várias maneiras diferentes de integrar o IBM Cognos TM1 com o IBMCognos Business Intelligence (BI) e outros aplicativos IBM Cognos. Esse tópicoresume algumas das abordagens de integração mais típicas e inclui links parainformações relacionadas.

As principais opções para integrar o Cognos TM1 com o software Cognos incluema segurança de autenticação, o relatório de dados e a interação dados/objetos. Aconfiguração de integração entre Cognos TM1 e Cognos BI envolve umacombinação de tarefas de instalação e configuração nos computadores hospedandoo servidor e os componentes de servidor da Web. Em alguns casos, a instalação e aconfiguração são necessárias em computadores de usuários finais individuais.

Segurança da Autenticação

É possível configurar o servidor Cognos TM1 para autenticar usuáriosusando segurança do Cognos BI. Com essa configuração, qualquerinterface com o usuário do Cognos TM1 ou outro aplicativo customizadodeve usar um nome de usuário e uma senha válidos do servidor CognosBI para acessar dados do Cognos TM1.

IBM Cognos TM1


Use o TM1 como uma origem de dados

Exiba e interaja com os objetos de dados do TM1

IBM Cognos Business Intelligence

IBM Cognos TM1 Package Connector

IBM Cognos TM1 Mobile Contributor

IBM Cognos InsightIBM Cognos Workspace

Pontos de integração do TM1 com o software IBM Cognos

Importar dados no TM1 do Cognos BI

Banco de dados

IBM Cognos Analysis for Microsoft ExcelIBM Cognos Business Intelligence

Figura 5. Visão Geral da Integração do Cognos TM1 com Outros Aplicativos IBM Cognos


Importando Dados do Cognos BI no Cognos TM1

O IBM Cognos TM1 Package Connector é atualmente suportado para usocom pacotes IBM Cognos Business Intelligence com relação ao SAPBusiness Warehouse e outras origens de dados ODBC e relacionais. Épossível usar o Cognos TM1 Package Connector para importar dadosdessas origens no Cognos TM1 usando um processo do Cognos TM1TurboIntegrator.

Usando o Cognos TM1 como uma origem de dados com o software Cognos

É possível configurar o IBM Cognos BI para acessar servidores e cubos doCognos TM1 a partir dos aplicativos Cognos BI como o Cognos ReportStudio e o Cognos Query Studio.

Também é possível acessar dados do TM1 de dentro do IBM CognosAnalysis for Microsoft Excel.

Exibindo e interagindo com objetos de dados do Cognos TM1

É possível acessar, visualizar e interagir com os seguintes objetos de dadosdo Cognos TM1 no IBM Cognos Workspace e no IBM Cognos Insight:v Visualizações do cubo e gráficos do TM1v Planilhas da web do TM1v cubos e diagramas do TM1 Scorecarding

Segurança do Cognos TM1 e do Cognos BI

É 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 219v “Usando o Cognos TM1 Applications com a Segurança do Cognos” na página

228

Usando o Cognos TM1 Package Connector para Importar Dados doCognos BI no Cognos TM1

O IBM Cognos TM1 Package Connector é suportado atualmente para ser usadocom os pacotes do IBM Cognos Business Intelligence (BI) com relação ao SAPBusiness Warehouse e outras origens de dados ODBC e relacionais. É possível usaro Cognos TM1 Package Connector para importar dados dessas origens no CognosTM1 usando um 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 “Instalação do Cognos TM1 Package Connector” para obter instruçõesde instalação.

v Consulte o capítulo “Importando Dados Usando o IBM Cognos TM1 PackageConnector” no IBM Cognos TM1 TurboIntegrator Guide para obter maisinformações sobre o uso do TM1 Package Connector.

v Consulte Cognos Business Intelligence (http://www.ibm.com/support/knowledgecenter/SSEP7J/welcome).

v Consulte Cognos TM1 Software Environments (http://www.ibm.com/support/docview.wss?uid=swg27040698) para obter especificações sobre o softwaresuportado.

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

Instalação do Cognos TM1 Package ConnectorO IBM Cognos TM1 suporta a conectividade com os pacotes do IBM CognosBusiness Intelligence (BI) com relação a determinadas origens de dados.

O Cognos TM1 Package Connector é um componente opcional de 32 bitsdisponível como um CD ou um download separado da instalação principal doCognos TM1. Esse componente deve ser instalado em seu próprio diretório.

Para obter informações sobre as origens de dados suportadas, consulte CognosTM1 Software Environments (http://www.ibm.com/support/docview.wss?uid=swg27040698).

Para obter informações sobre o uso do Cognos TM1 Package Connector, consulte ocapítulo “Importando Dados Usando o IBM Cognos TM1 Package Connector” noIBM Cognos TM1 TurboIntegrator Guide.

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.Para obter mais informações, consulte Cognos TM1 Software Environments(http://www.ibm.com/support/docview.wss?uid=swg27040698).

v IBM Cognos Business Intelligence Server.Para obter informações sobre as específicas versões suportadas, consulte CognosBusiness Intelligence (http://www.ibm.com/support/knowledgecenter/SSEP7J/welcome).

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 a

Capítulo 6. Integração do Cognos TM1 com Outros Softwares IBM Cognos 67

http://www.ibm.com/support/knowledgecenter/SSEP7J/welcome







GUI SAP ou os arquivos de biblioteca SAP RFCSDK e DLLs. Consulte o“Ativando a Conectividade para SAP a Partir do Cognos TM1”.

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.Instale o Cognos TM1 Package Connector em seu próprio diretório. Não oinstale em uma pasta existente do Cognos BI.

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

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 for ativada automaticamente, serápossível usar a opção Menu Iniciar > IBM Cognos > IBM Cognos Configurationpara ativá-la.

Procedimento1. Ative ou abra o Cognos Configuration.


2. Selecione o nó Ambiente na janela Explorador de Configuração Local. Asconfigurações atuais para URI são exibidas.

3. Configure o Gateway URI para apontar para o servidor Cognos BI no qual ospacotes 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 mais informações sobre os URIs.

4. Insira o URI na coluna Valor do nó Outras Configurações de URI.O Dispatch URI está no formato dehttp[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 Ambiente:

No Microsoft Windows, após instalar o IBM Cognos TM1 Package Connector, avariável de ambiente do sistema TM1_PACKAGE_CONNECTOR é configurada para odiretório de instalação especificado na instalação, por exemplo, C:\ProgramFiles\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.

O local de instalação padrão do Microsoft Windows para o Cognos TM1 PackageConnector10 é C:\program Files\ibm\cognos\c10.

Configurando o Parâmetro de Configuração do Servidor Cognos 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 apenas é necessária quando o Cognos TM1Package Connector é usado no UNIX (AIX, Solaris, Linux).

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

Apó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 IBM Cognos TM1 TurboIntegrator Guide para obter detalhes de comoexecutar 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_PATH


AIX: LIBPATH

Cognos TM1 como uma Origem de Dados com o Cognos BIÉ possível configurar o IBM Cognos Business Intelligence (BI) para acessar osservidores e cubos do Cognos TM1 a partir do Cognos Report Studio e CognosQuery Studio.

Para ativar o relatório do Cognos BI com relação às origens de dados do CognosTM1, instale os arquivos de API necessários do Cognos TM1 em todos osservidores Cognos BI que estiverem executando serviços de consulta e relatório noMicrosoft Windows. Consulte o “Ativando o Relatório do Cognos BI nas Origensde Dados do Cognos TM1”.

Para obter mais detalhes sobre o Cognos BI, consulte os recursos a seguir:v Centro de Informações do IBM Cognos Business Intelligence 10.2.1

(http://pic.dhe.ibm.com/infocenter/cbi/v10r2m1/index.jsp).v Guia de Administração e Segurança do IBM Cognos Business Intelligence > “Origens

de Dados e Conexões” > “Origem de Dados do TM1”

Ativando o Relatório do Cognos BI nas Origens de Dados doCognos TM1

Para ativar o relatório do Cognos Business Intelligence (BI) com relação a origensde dados do Cognos TM1, use o programa de instalação do Cognos TM1 Clientpara instalar os arquivos de API necessários do Cognos TM1 em todos osservidores do Cognos BI que estão executando serviços de relatório e serviços deconsulta no Microsoft Windows.

Sobre Esta Tarefa

Essas etapas aplicam-se a novas instalações do Cognos TM1 10.2.x e as instalaçõesdo Cognos TM1 10.2.x existentes que configuram subsequentemente o Cognos BIem sistemas que executam o Microsoft Windows.

Procedimento1. Execute o programa de instalação do IBM Cognos TM1 Client:

v No software do sistema operacional Microsoft Windows Vista, Windows 7 ouWindows Server 2008, clique com o botão direito no arquivo issetup.exe eclique em Executar como Administrador.

v Para outros sistemas operacionais Windows, clique duas vezes no arquivoissetup.exe.

2. Na página Local de Instalação, selecione um diretório adjacente no servidorCognos BI que está executando serviços de consulta ou relatório no MicrosoftWindows.

3. Na página Seleção de Componente, expanda TM1 Client Tier e selecione aopção a seguir:APIs do TM1

Deixe todas as outras caixas de seleção desmarcadas.4. Siga os prompts e clique em Concluir para concluir a instalação.


http://pic.dhe.ibm.com/infocenter/cbi/v10r2m1/index.jsp

Cognos TM1 iWidgets e Cognos WorkspaceÉ possível exibir objetos de dados do IBM Cognos TM1 Web, como visualizaçõesdo cubo, gráficos e planilhas da web no IBM Cognos Workspace.

Após instalar e executar o Cognos TM1 Web com sucesso, configure e trabalhe como Cognos TM1 iWidgets no ambiente do IBM Cognos Business Intelligence e doCognos Workspace.

Configurando o Cognos Workspace para Usar o Cognos TM1iWidgets

Para usar os dados do IBM Cognos TM1 no IBM Cognos Workspace, você deverámodificar os seguintes arquivos de configuração na instalação do IBM Cognos BI.v tm1_contribution.atom

v tm1_en.properties

Para obter mais informações, consulte o tópico Configurando o IBM CognosWorkspace para usar dados do IBM Cognos TM1 (http://pic.dhe.ibm.com/infocenter/cbi/v10r2m1/topic/com.ibm.swg.ba.cognos.inst_cr_winux.10.2.1.doc/c_cnfgbux4tm1.html) no IBM Cognos Business Intelligence Installation andConfiguration Guide 10.2.1 no IBM Cognos Business Intelligence 10.2.1 InformationCenter (http://pic.dhe.ibm.com/infocenter/cbi/v10r2m1/index.jsp).

Trabalhando com Dados do Cognos TM1 no Cognos Workspace

É possível acessar os objetos de dados desenvolvidos no Cognos TM1 de dentro doCognos Workspace em tempo real. No Cognos Workspace, é possível navegar peloconteúdo do TM1 na guia Conteúdo e incluir os relatórios do TM1 na área detrabalho, sob as seguintes condições:v O Cognos TM1 deve estar instalado e configurado como parte do ambiente do

IBM Cognos Business Intelligence. Se você alterar o ambiente do BI para usarSSL, também deverá alterar o TM1 Web para usar SSL.

v Você deve possuir as permissões e os recursos para visualizar e interagir com oconteúdo do Cognos TM1

Para obter mais informações sobre o uso dos dados do TM1 no Cognos Workspace,consulte os tópicos a seguir no IBM Cognos Workspace User Guide 10.2.0 no Centrode Informações do IBM Cognos Business Intelligence 10.2.1 (http://pic.dhe.ibm.com/infocenter/cbi/v10r2m1/index.jsp).v Conteúdo do Cognos TM1 (http://pic.dhe.ibm.com/infocenter/cbi/v10r2m1/

topic/com.ibm.swg.ba.cognos.ug_buxc.10.2.1.doc/c_ug_buxc_tm1_content.html)v Incluindo o conteúdo do Cognos TM1 no Cognos Workspace

(http://pic.dhe.ibm.com/infocenter/cbi/v10r2m1/topic/com.ibm.swg.ba.cognos.ug_buxc.10.2.1.doc/c_ug_buxc_tm1_content_adding.html)

Cognos TM1 e Cognos Analysis for Microsoft ExcelUse o IBM Cognos Analysis for Microsoft Excel com as origens de dados do IBMCognos TM1 para inserir e efetuar writeback de valores para os cubos do TM1.Também é possível criar um botão de comando no Cognos Analysis for MicrosoftExcel para replicar a funcionalidade do botão de ação a partir do IBM Cognos TM1Perspectives.


http://pic.dhe.ibm.com/infocenter/cbi/v10r2m1/topic/com.ibm.swg.ba.cognos.inst_cr_winux.10.2.1.doc/c_cnfgbux4tm1.html

http://pic.dhe.ibm.com/infocenter/cbi/v10r2m1/topic/com.ibm.swg.ba.cognos.inst_cr_winux.10.2.1.doc/c_cnfgbux4tm1.html





http://pic.dhe.ibm.com/infocenter/cbi/v10r2m1/topic/com.ibm.swg.ba.cognos.ug_buxc.10.2.1.doc/c_ug_buxc_tm1_content.html

http://pic.dhe.ibm.com/infocenter/cbi/v10r2m1/topic/com.ibm.swg.ba.cognos.ug_buxc.10.2.1.doc/c_ug_buxc_tm1_content_adding.html

O IBM Cognos Analysis for Microsoft Excel permite que os usuários do MicrosoftExcel acessem diretamente as informações protegidas e controladas de formacentralizada do IBM Cognos para uma melhor tomada de decisão. O CognosAnalysis for Microsoft Excel é uma ferramenta baseada no Microsoft Excel que osautores de relatórios profissionais usam para construir relatórios sofisticados, comvárias planilhas e várias consultas com relação a vários bancos de dados. Com oIBM Cognos Analysis for Microsoft Excel, é possível usar os dados do IBM Cognosdentro do Excel para explorar e analisar dados e criar relatórios, como relatórios defaturas, instruções e vendas e inventário semanais.

Para obter mais informações, consulte o IBM Cognos Analysis for Microsoft Excel,Versão 10.2.2, Guia do Usuário.

Usando Dados do Cognos TM1 no Cognos Analysis forMicrosoft Excel

É possível usar os dados do Cognos TM1 com o Cognos Analysis for MicrosoftExcel das seguintes maneiras.

Use as visualizações flex para relatórios complexos do IBM Cognos TM1

Ao trabalhar com uma origem de dados do Cognos TM1, é possível usaras visualizações do flex para combinar dados de vários crosstabs ou várioscubos de crosstab em uma planilha e, em seguida, aprimorar os dadosusando fórmulas, formatos e referências de célula do Microsoft Excel.

Faça contribuições a um plano em um servidor IBM Cognos TM1

É possível usar o IBM Cognos Analysis for Microsoft Excel para criar umaexploração para revisar, analisar e atualizar a parte do plano corporativoque foi designada a você.

Execute as funções do IBM Cognos TM1 TurboIntegrator

No Cognos Analysis for Microsoft Excel, é possível criar um botão decomando para replicar a funcionalidade do botão de ação a partir do IBMCognos TM1 Perspectives. O botão de comando pode executar umprocesso do Cognos TM1 TurboIntegrator ou outro processo customizado.

Conectando o Cognos Analysis for Microsoft Excel aos Dadosdo Cognos TM1

Use o ícone Opções na barra de ferramentas do Cognos Analysis for MicrosoftExcel para configurar uma conexão com um servidor Cognos TM1.

Configure a conexão com uma URL no seguinte formato:

http://server_name:port_number

em que server_name é o endereço IP do computador ou o nome do computador eport_number é a porta na qual o Cognos TM1 Application Server está em execução.O número da porta padrão para o Cognos TM1 é 9510.

Por exemplo:

http://mysystem:9510

Para obter mais informações, consulte os tópicos a seguir no IBM Cognos Analysisfor Microsoft Excel, Versão 10.2.2, Guia do Usuário:


v “Configure conexões com os sistemas IBM Cognos”v “Configure a autenticação do usuário”v “Efetuando logon em um servidor IBM Cognos”

Configurando a conexão única do Cognos TM1 para o CognosAnalysis for Excel

Permitindo a conexão única (SSO) que está configurada para a autenticação doIBM Cognos Business Intelligence para trabalhar através do IBM Cognos Analysisfor Microsoft Excel ao acessar um Cognos BI assegurado. O servidor IBM CognosTM1 requer que algumas etapas de configuração adicionais sejam aplicadas àinstalação do Cognos TM1.

Sobre Esta Tarefa

Semelhante às etapas necessárias para permitir o acesso a servidores TM1assegurados por BI para o TM1 Web, o acesso do Cognos Analysis for Excel requerque alguns arquivos sejam colocados na instalação do IBM Cognos BI Gateway eque algumas definições de configuração sejam implementadas também.

O Cognos Analysis for Microsoft Excel requer uma instância do Cognos BIGateway para um ponto de entrada dedicado. Essa instância do Cognos BIGateway deve ser ativada de acordo com as etapas descritas em “Usando oCognos TM1 Applications com a Segurança do Cognos” na página 228. Emparticular, isso assegura que a instalação do Gateway será complementada por trêsarquivos necessários (pmhub.html, planning.html e variables_plan.xml).

Nota: Os arquivos necessários são incluídos no arquivo bi_interop.zip localizadono diretório <TM1 installation location>\bi_interop.

Procedimento1. Na instalação selecionada do Cognos BI Gateway para o ponto de entrada do

Cognos Analysis for Excel, navegue em Cognos_root\templates\ps\portal\ emque Cognos_root é o diretório no qual o Cognos BI foi instalado.

2. Abra o arquivo variables_plan.xml.3. Verifique se a tag <url>../pmhub.html</url> existe abaixo <url>../

planning.html</url>. O texto a seguir é um exemplo do arquivovariables_plan.xml:<?xml version="1.0" encoding="UTF-8"?><CRNenv><urls><url>../planning.html</url><url>../pmhub.html</url></urls><cookies><param name="cam_passport"/><param name="CRN"/></cookies></CRNenv>

4. Feche o arquivo.5. Navegue em Cognos_root\webcontent em que Cognos_root é o diretório no qual

o Cognos BI foi instalado.6. Abra o pmhub.html para editá-lo.7. Inclua os locais do serviço PMHub. Isso permite que o SSO funcione.


8. Certifique-se de que a conta de usuário que está executando o servidor da webtenha a permissão para acessar o pmhub.html. Se não for possível acessar opmhub.html em um navegador da web, verifique o arquivo de propriedadespmhub.html.

9. Edite a tela de configuração PMHub.a. Em um navegador da web, insira http://servername:port

number/pmhub/pm/admin para abrir a tela de configuração.Por exemplo: http://localhost:9510/pmhub/pm/admin

b. Expanda o nó para Configurações >com.ibm.ba.pm.resource.security.dictionary e insira os valores para aspropriedades a seguir:v CAMBIURL

v CAMGatewayURL

Integração do Cognos TM1 Applications com o Cognos BI e o portaldo Cognos Connection

Se sua instalação do TM1 usa a segurança do Cognos para a autenticação, osusuários do Cognos BI poderão usar o portal do Cognos Connection para abrir osaplicativos do TM1 em vez de o portal do TM1 Applications. No entanto, osadministradores ainda precisam usar o TM1 Applications para configurar egerenciar os aplicativos.

Ao configurar o TM1 Applications para usar a segurança do Cognos, você tambémativará o portal do Cognos Connection para exibir uma pasta que contenha oslinks para os aplicativos disponíveis do TM1. A lista exata dos aplicativos exibidosdepende dos direitos do usuário atual.

O arquivo planning.html fornece as informações para o Cognos BI e o portal doCognos Connection para exibir os links para o TM1 Applications. Para obter maisinformações, consulte “Usando o Cognos TM1 Applications com a Segurança doCognos” na página 228.

Nota: Você deve ter a variável de ambiente TM1_PATH especificada antes deconectar ao Cognos TM1 em um ambienteUNIX.


Capítulo 7. 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 abrangente localizado na página deBoas-vindas doCognos TM1 (http://www.ibm.com/support/knowledgecenter/SS9RXT/welcome). Selecione a versão do TM1 que está sendo usada, em seguida,selecione Instalar > Guia de instalação e configuração do TM1.

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 Servidor Cognos TM1 Applicationv 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 a autenticação do 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ágina56Este tópico descreve como atualizar o IBM Cognos TM1 em um único computadorem execução no sistema operacional Microsoft Windows.

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



Sobre Esta Tarefa

Se você não tiver estes pré-requisitos ativos, o Assistente de Instalação do CognosTM1 exibirá uma mensagem sobre eles. Se qualquer um desses prerequisitosestiver ausente, será necessário instalá-los antes de poder continuar. Talvez você játenha este software instalado.

Procedimento

Para Cognos TM1 Perspectives ou Cognos TM1 Architect, instale ou confirme quevocê possui:v Microsoft .NET Frameworkv Pacote Redistribuível do Microsoft Visual C++ 2010v Microsoft Excel

Revise a lista mais recente de ambientes suportados pelo Cognos TM1, incluindoas informações sobre os sistemas operacionais, correções, servidores da web enavegadores da web, visitando o Cognos TM1 10.2.2 Software Environments(http://www.ibm.com/support/docview.wss?uid=swg27040698).

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 em que 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 arquivo issetup.exe:




v Para todos os outros softwares do 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 or Cognos TM1 Performance Modeler,vá para a Etapa 5.

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

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

6. Clique em Avançar até que a instalação ser iniciada.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 mais antigos, é possível marcarIniciar Cognos Configuration na última tela da instalação para executarimediatamente a ferramenta de configuração. No software do 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.

Use 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 Application Server, e pelo menos um servidor de dados deamostra do IBM Cognos TM1. Essa ação registra os servidores no registro deserviço do Windows. Então você precisa configurar os serviços para que eles sejamexecutados sob um usuário específico. Os servidores que estão em execução emum ambiente Microsoft Windows são referidos 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 e use Executar como Administrador nosoftware do sistema operacional Windows Vista, Windows 7 e Windows Server2008.

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

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

que o servidor deve estar em execução antes que qualquer banco de dadosde amostras possa ser executado.

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

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 comoconfigurações criptográficas e outras ações acontecerem pela primeira vez.Clique em Sim na resposta para a mensagem solicitando que você salve asconfigurações. Você também verá esse tipo de mensagem ao fechar oCognos Configuration.

b. 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 deamostra fornecidos:a. SData

b. Amostra de Planejamento

c. GO_New_Stores

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

Windows, é possível reconfigurá-los para usar uma conta do usuário específico: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 em seu sistema com os

direitos de serviço apropriados. Consulte “Contas do Usuário para executaros serviços Cognos TM1 no Windows” no capítulo“Planejando suainstalação do Cognos TM1” do Guia de Instalação e Configuração do IBMCognos TM1 para obter detalhes sobre os direitos que essa conta de usuáriodeve ter.É possível localizar o Guia de Instalação do TM1 para a versão do TM1 quevocê está usando na página de Boas-vindas do Cognos TM1(http://www.ibm.com/support/knowledgecenter/SS9RXT/welcome).

e. Feche Serviços do Windows.7. No Cognos Configuration, clique com o botão direito do mouse em cada

servidor e selecione Iniciar.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 > Perspectives. 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 de Planejamento 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 versão fornecida do servidor de aplicativos da web Apache Tomcat.

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

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 Logingeralmente são inseridos automaticamente para você. Se não forem, é possívelinserir ou alterar esses valores conforme necessário.

3. Clique em Efetuar Login.

Execute o Cognos TM1 Application WebO IBM Cognos TM1 Application Web é o cliente baseado na web e o portal usadospara executar aplicativos desenvolvidos usando dados do IBM Cognos TM1.

Sobre Esta Tarefa

O Cognos TM1 Application Web 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. Especifique as definições de configuração para o Host Administrativo, servidor,tipos de clientes e a URL para o Cognos TM1 Application Web.

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

amostra.5. Para concluir a instalação, rejeite a mensagem sobre a edição dos seguintes

parâmetros no arquivo tm1s.cfg.v AllowSeparateNandCRules

v ForceReevaluationOfFeedersForFedCellsOnDataChange

v DistributedPlanningOutputDir

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 ModelerIBM Cognos TM1 Performance Modeler está disponível como um componente nãoselecionado da instalação do IBM Cognos TM1. Você ativa o Cognos TM1Performance Modeler a partir do portal do IBM Cognos TM1 Applications.

Sobre Esta Tarefa

Após a instalação do Cognos TM1 Performance Modeler, também é possível iniciaro programa a partir do ícone de área de trabalho que é instalado ou do menuIniciar do Microsoft Windows. Clique em Iniciar > Todos os Programas > IBMCognos TM1 Performance Modeler > IBM Cognos TM1 Performance Modeler.

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

Modeler .

Lembre-se: Dependendo do seu navegador, você pode ver etapas um poucodiferentes para instalar os componentes transferidos por download, comoCognos TM1 Performance Modeler.

2. Clique em OK com Abrir com IBM Cognos RCP Application Updaterselecionado 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 a página de Boas-vindas do Cognos TM1 (http://www.ibm.com/support/knowledgecenter/SS9RXT/welcome). Selecione a versão do TM1 quevocê está usando, em seguida, a categoria Modelo e design. O IBM CognosTM1 Performance Modeler User Guide fornece detalhes sobre a construção demodelos.

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

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

v No portal do Cognos TM1 Applications, clique no ícone Cognos Insight .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 Use o menu Iniciar do Microsoft Windows. Clique em Iniciar > Todos osProgramas > IBM Cognos Insight > IBM Cognos Insight.

v O 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 o Cognos Insight.

2. Clique em OK com Abrir com IBM Cognos RCP Application Updaterselecionado 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.

O que Fazer Depois

Consulte o Cognos Insight Knowledge Center (http://www.ibm.com/support/knowledgecenter/SSVJ22/welcome) para obter detalhes sobre como criar as áreasde trabalho do Cognos Insight e usar o Cognos Insight como um cliente paracontribuir com os 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 seja possível usar o CognosTM1 Application Web. O editor de telas identifica quais clientes podem ser usadoscom um aplicativo específico.



http://www.ibm.com/support/knowledgecenter/SSVJ22/welcome?l

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

Procedimento1. No Cognos TM1 Application Web, clique em um aplicativo de planejamento.2. Clique em Abrir Cognos TM1 Application para ativar o cliente Cognos TM1

Application Web.Consulte o Guia do Usuário do IBM Cognos TM1 Web para obter detalhes sobrecomo contribuir para um aplicativo usando o Cognos TM1 Application Web.Acesse a página de Boas-vindas do Cognos TM1 (http://www.ibm.com/support/knowledgecenter/SS9RXT/welcome), selecione a versão do TM1 quevocê está usando, selecione a categoria Analisar e criar e, em seguida, o Guiado TM1 Applications.

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:

Outros Componentes Cognos TM1

Consulte a documentação relacionadas para obter detalhes sobre essescomponentes adicionais para o Cognos TM1.

IBM Cognos TM1 Operations Console

O IBM Cognos TM1 Operations Console é uma ferramenta usada poradministradores para monitorar a atividade dos servidores TM1 na rede.Consulte o Guia do IBM Cognos TM1 Operations Console para obter maisinformações.

IBM Cognos TM1 Mobile Contributor

O IBM Cognos TM1 Mobile Contributor é um novo aplicativo remoto parao Apple iPad que se conecta a um IBM Cognos TM1 Server e possibilitaaos usuários remotos acessarem todos os seus aplicativos de planejamentodo IBM Cognos TM1 Applications.

Marcando o desempenho com o IBM Cognos TM1Marcando o desempenho com o IBM Cognos TM1 integra as capacidadesde gerenciamento de estratégia e marcadores de desempenho no CognosTM1 para fornecer a melhor integração de gerenciamento de desempenhocom planejamento. É possível criar soluções de marcador de desempenhoque contenham diagramas de impacto interativos, mapas de estratégia ediagramas customizados que monitoram seus principais indicadores dedesempenho (KPIs). Para mais informações, consulte o Guia do IBMCognos TM1Performance Modeler.

Integração do Cognos TM1 com outro software do IBM Cognos

Consulte a integração do “Cognos TM1 com outro capítulo do software do IBMCognos ” para obter detalhes sobre as seguintes maneiras de integrar o CognosTM1 com outro software do IBM Cognos.



Segurança do IBM Cognos Business Intelligence

É possível configurar o servidor Cognos TM1 para autenticar os usuáriosque usam a segurança do IBM Cognos Business Intelligence (BI).

Relatório do IBM Cognos BI

É possível configurar o IBM Cognos Business Intelligence (BI) para acessaros servidores e cubos do Cognos TM1 dos aplicativos do Cognos BI comoo Cognos Report Studio e o Cognos Query Studio.

iWidgets na área de trabalho do IBM Cognos

É possível exibir os objetos de dados do IBM Cognos TM1 Web, comovisualizações do cubo, gráficos e planilhas da web como iWidgets na áreade trabalho do IBM Cognos.

IBM Cognos Analysis for Microsoft Excel

Use o IBM Cognos Analysis for Microsoft Excel com as origens de dadosdo IBM Cognos TM1 para inserir e efetuar writeback de valores para oscubos do TM1.

IBM Cognos TM1 Package Connector

O IBM Cognos TM1 Package Connector é usado para importar os pacotesdo IBM Cognos Framework Manager. Consulte o Guia do IBM Cognos TM1Turbo Integrator para obter mais informações.

Configurando Computadores Clientes para Exportar Dados do CognosTM1 em Formato PDF

Para exportar dados do IBM Cognos TM1 para o formato Adobe PDF a partir dosaplicativos clientes IBM Cognos TM1 em execução no Microsoft Windows,configure PDFCamp como sua impressora padrão. Essas etapas se aplicam ao IBMCognos TM1 Perspectives, 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. No Windows, abra a janela de configuração Impressoras e Faxes.2. Clique com o botão direito do mouse em Driver da Impressora PDFCamp e

selecione Configurar como Impressora Padrão.


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

Use esta seção para instalar e configurar o IBM Cognos TM1 Admin Server e oservidor IBM Cognos TM1 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 57É 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 no arquivo issetup.exe eclique em Executar como Administrador. Para outros sistemas operacionais, dêum clique duplo no arquivo issetup.exe para iniciar o assistente 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 Server

Para obter detalhes, consulte “Contas de Usuário para Executar Serviços doCognos TM1 no Windows” na página 21.

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 do 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 comoconfigurações criptográficas e outras ações acontecerem pela primeira vez.Clique em Sim na resposta para a mensagem solicitando que você salve asconfigurações. Você também verá 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 deamostra 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”.

Alterando Serviços do Cognos TM1 para Serem Executadossob uma Conta de Usuário Específica no Windows

Ao usar o IBM Cognos Configuration para gerenciar os serviços do Cognos TM1,será necessário alterar a conta de usuário padrão que executa os serviços doMicrosoft Windows para o Cognos TM1 Admin Server e quaisquer servidoresCognos TM1 que forem iniciados com o Cognos Configuration. Por padrão, oCognos Configuration registra esses serviços sob a conta predefinida do SistemaLocal Microsoft Windows. Porém, esses serviços devem ser alterados para seremexecutados 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 paraExecutar Serviços do Cognos TM1 no Windows” na página 21.

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

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

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.

Instalando o Cognos TM1 Server no UNIX ou LinuxÉ possível instalar os componentes do Cognos TM1 Server em um computador de64 bits que executa um sistema operacional UNIX ou Linux. Use este tipo deinstalação para instalar e executar o Cognos TM1 Server 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 Cognos TM1 Serverem 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.Conceitos relacionados:“Atualizando o Cognos TM1 Server no UNIX ou Linux” na página 57É 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 no IBM Cognos TM1 consulte Ambientes de software do Cognos TM1(http://www.ibm.com/support/docview.wss?uid=swg27040698).



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 se preparar para instalar o Cognos TM1, deve-se 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: Apenas os componentes do servidor Cognos TM1 podem serexecutados no UNIX ou Linux. Não é possível executar os clientes Cognos TM1no UNIX.Para obter detalhes sobre como projetar o ambiente do TM1 ideal, consulteCapítulo 3, “Arquitetura”, na página 25 e Capítulo 4, “Transporte”, na página 37.

v Determine os requisitos de hardware e software.Revise a lista mais recente de ambientes suportados pelo Cognos TM1, incluindoinformações sobre os sistemas operacionais, correções, servidores da web enavegadores da web, visitando o Cognos TM1 Software Environments(http://www.ibm.com/support/docview.wss?uid=swg27040698).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 Instale sua própria cópia do Java Runtime Environment (JRE). A instalação doCognos TM1 não fornece um JRE para instalações do UNIX.

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 mais informações, consulte Apêndice C, “Configurando Instalações eConfigurações Não Assistidas”, na página 341.

v Instale e configure os componentes do Cognos TM1 para executar como umusuário com permissões apropriadas para binários do Cognos TM1 e bancos dedados do 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.6. Se você estiver instalando o IBM Cognos TM1 Application Server no Linux com

um Sun Java Runtime Environment, também deverá concluir as seguintesetapas para instalar os arquivos Xerces adicionais necessários.a. Vá para a página de downloads no website Xerces, http://

xerces.apache.org/mirrors.cgi.b. Faça download da distribuição binária para o Java:Xerces-J-

bin.2.11.0.zip.c. Extraia xercesImpl.jar e xml-apis.jar e copie-os para o diretório

tm1_install_dir/webapps/pmpsvc/WEB-INF/lib.d. Reinicie o serviço do TM1 Applications.

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 seus servidoresCognos TM1 no UNIX ou Linux. Também é possível usar os scripts de início eparada que sã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 Server


http://xerces.apache.org/mirrors.cgi

http://xerces.apache.org/mirrors.cgi

v tm1srvstop.exe - utilitário para parar o Cognos TM1 Serverv shutdown_tm1s.sh - método alternativo para encerrar um servidor Cognos TM1v startup_pmpsvc.sh - iniciar o Cognos TM1 Application Serverv shutdown_pmpsvc.sh - encerrar o Cognos TM1 Application 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 mais informações sobre como usar o comando ulimit,consulte a documentação do AIX.

Executando o ajuste de desempenho para o Cognos TM1 no IBMAIXSe você estiver executando o IBM Cognos TM1 no IBM AIX, ajuste o seu ambientepara melhorar o desempenho.

Dependendo do aplicativo e uso, os testes mostram que as mudanças descritasneste tópico podem resultar em um aumento de 5-25% no desempenho em versõesanteriores do TM1.

Configurações do ambiente

As configurações do ambiente a seguir são apropriadas para todos as liberações doTM1 no AIX a partir de setembro de 2014.export AIXTHREAD_SCOPE=Sexport AIXTHREAD_MNRATIO=1:1export MALLOCOPTIONS=multiheap:32,pool:0x20000000export SPINLOOPTIME=300export AIXTHREAD_MUTEX_FAST=ONexport LDR_CNTRL=DATAPSIZE=16M@TEXTPSIZE=16M@STACKPSIZE=16M


export AIXTHREAD_AFFINITY=first-touchexport MEMORY_AFFINITY=MCMexport OBJECT_MODE=64 export YIELDLOOPTIME=0

Virtual Memory Manager (VMM)

O Virtual Memory Manager (VMM) deve ser ajustado para o tamanho e númerode páginas grandes para reservar. Somente usuários raiz ou usuários que têm osprivilégios necessários podem ajustar o VMM. Consulte a documentação do AIXpara o conjunto completo de opções vmo que podem ser usadas para ajustar osparâmetros do VMM.

Nota: Ativar páginas grandes aumenta a memória do TM1 Server por 10-15%.

O comando a seguir ativa as páginas grandes com as configurações sugeridas parao TM1 Server:vmo -o lgpg_regions=2000 -o lgpg_size=16777216

Para conceder privilégios a usuários não raiz, utilize o comando a seguir:chuser capabilities=CAP_BYPASS.RAC_VMM,CAP_PROPAGATE userid

Para verificar se o TM1 Server está em execução com páginas grandes ativadas,execute o comando a seguir:ps -Zdef | grep tm1

Ativando o alinhamento de objeto para a plataforma do IBM Power

O parâmetro CacheFriendlyMalloc no arquivo tm1s.cfg é permitido paraalinhamento de memória que é específico para a plataforma Power. Testar mostraque ativar esta opção fornece maiores benefícios para cenários de alto uso decontagem do usuário. Os cenários de uso de contagem de usuário únicos ou baixospodem ver pouco ou nenhum benefício. Por padrão, a opção estará desativada.Para ativar a opção, inclua a seguinte linha no arquivo tm1s.cfg:CacheFriendlyMalloc=T

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 os nomes do arquivo de objeto de controle do IBM Cognos TM1 porque essesnomes de arquivos começam com o caractere de chave de fechamento }.

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 manualmente os arquivos de banco de dados do Cognos TM1 deum sistema Microsoft Windows para um sistema UNIX (ou do UNIX para oWindows) quando os nomes de objeto do Cognos TM1 contiverem caracteres quenão sejam ASCII (caracteres além do conjunto de 128 caracteres ASCII original).

Em vez de mover os arquivos manualmente, use o utilitário tm1xfer para moverdados do TM1 entre diferentes plataformas.

Utilitário tm1xfer

O utilitário tm1xfer compacta e move objetos do TM1 Server de uma plataformapara outra plataforma preservando os nomes compostos por letras maiúsculas eminúsculas dos objetos em ambas as plataformas Microsoft Windows e UNIX. Paraobter mais informações, consulte o tópico “tm1xfer” no Guia de Operações do IBMCognos TM1.

Movendo Arquivos Manualmente

A movimentação manual de arquivos é um problema por causa da possívelcodificação de caracteres ou mapeamento incompatível entre essas duasplataformas. O sistema operacional Windows armazena nomes de diretório e doarquivo na codificação de caracteres UTF-16, enquanto o sistema operacional UNIXpode armazenar nomes usando codificações de caracteres diferentes, dependendode 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.


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

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

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


Tabela 16. Resumo da Configuração de Idioma para Componentes do CognosTM1 (continuação)

Componente Configuração do Idioma

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 98

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 “Configurando o Idioma doNavegador da Web para Cognos TM1 Web” na página 99

Códigos de Idioma do Cognos TM1A tabela a seguir resume os códigos de idioma para os Idiomas Suportados no IBMCognos TM1.

Idioma Código

Português do Brasil bra

Croata hrv

Tcheco csy

Chinês (Simplificado) sch

Chinês (Tradicional) tch

Dinamarquês dan

Belga nld

Alemão deu

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

Espanhol esp

NLB slv

Sueco sve

Tailandês tha

Turco trk


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

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

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

3. Salve e feche o arquivo Tm1s.cfg.4. Reinicie o servidor Cognos TM1.

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

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

3. Salve e feche o arquivo Tm1p.ini.4. Reinicie o cliente Cognos TM1.

Configurando o Idioma do Navegador da Web para CognosTM1 Web

As configurações de idiomas no navegador da web determinam qual idioma seráusado na interface do IBM Cognos TM1 Web.

Sobre Esta Tarefa

Siga essas etapas gerais para configurar o Microsoft Internet Explorer e MozillaFirefox para exibir o IBM Cognos TM1 Web em seu idioma principal. Para obterinformações mais detalhadas, consulte a documentação do navegador da web.

Procedimento1. Dependendo de qual navegador da web você está usando, use as opções de

idioma disponíveis para selecionar e configurar seu idioma principal.v No Internet Explorer, as opções de idiomas geralmente estão localizadas no

menu Ferramentas > Opções de Internet > Geral > Idiomas.v No Firefox, as opções de idiomas geralmente são localizadas no menu

Ferramentas > Opções > Conteúdo > Idiomas.2. Inclua seu idioma para a lista de idiomas.3. Organize a lista de forma que seu idioma de preferência esteja na parte

superior da lista.

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

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 de entrada e clique noícone de edição.

7. Insira ou navegue até o caminho para a pasta vazia na qual deseja criar onovo Cognos TM1 Server.

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 Application Web” na página 146.

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 Cognos TM1 Server são criados na pasta.

12. Para testar o novo Cognos TM1 Server, inicie o Cognos TM1 Architect e efetuelogin no banco de dados com o nome de usuário admin e nenhuma senha.

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âmetroServerName 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 Cognos TM1 Server, 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 mais informações, consulte Apêndice B, “O Arquivo de Configuraçãodo Cliente Tm1p.ini”, na página 329.

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 mais informações, consulte Apêndice A, “O arquivo de configuraçãodo servidor tm1s.cfg”, na página 271.

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 mais informações, consulte Apêndice B, “O Arquivo de Configuração doCliente Tm1p.ini”, na página 329.

Configuração Avançada do Cognos TM1 Admin Server e do CognosTM1 Server

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 Números de Porta Padrão para Cognos TM1 AdminServer

Se 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.5. Edite o arquivo tm1web_config.xml para especificar o número da porta do

servidor administrativo.v Se você estiver usando SSL, edite o parâmetro AdminHostSSLPort.v Se você não estiver usando SSL, edite o parâmetro AdminHostPort.

O arquivo tm1web_config.xml está localizado em <TM1 installlocation>\webapps\tm1web\WEB-INF\configuration\.Para obter mais detalhes sobre o arquivo tm1web_config.xml, consulte“Editando o Arquivo de Configuração do Cognos TM1 Web” na página 124 e“Parâmetros de Configuração do Cognos TM1 Web” na página 121.

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 295.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 do administrador do Cognos TM1, como TM1 Top, ETLDAP 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 Cognos TM1 Server e os aplicativos clientes.


Capítulo 9. Instalação do Cognos TM1 Operations Console

O programa de instalação do IBM Cognos TM1 instala o IBM Cognos TM1Operations Console com o servidor de aplicativos da web fornecido. Também épossível instalar o TM1 Operations Console com seu próprio servidor deaplicativos da web. O TM1 Operations Console é um componente opcional,baseado em Java, usado para monitorar a atividade de servidores Cognos TM1.

Instalando o Cognos TM1 Operations Console Usando o Software doServidor da Web Apache Tomcat Fornecido

O IBM Cognos TM1 Operations Console é um componente opcional baseado emJava para monitorar a atividade dos servidores Cognos TM1.

Antes de Iniciar

O Cognos TM1 Operations Console é instalado, por padrão, quando você instala oCognos TM1 e usa o software do servidor da web Apache Tomcat fornecido.

Antes de instalar o Cognos TM1 Operations Console:v Assegure-se de que o software obrigatório do Cognos TM1 esteja instalado.v Assegure-se de que o Cognos TM1 Admin Server, o TM1 Application Server,

oCognos TM1 Server que deseja monitorar e o TM1 Sdata Server estejaminstalados e em execução.

v Assegure-se de que seja possível iniciar o Cognos TM1 Architect e efetuar logincomo um administrador no Cognos TM1 Server que deseja monitorar.

v Todos os serviços devem estar em execução em uma única conta de domínio. OAssistente 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 É possível monitorar os servidores Cognos TM1 versão 9.5.2 usando o CognosTM1 Operations Console. No entanto, como nem toda a funcionalidade estádisponível com o sistema 9.5.2, será possível executar apenas o monitoramentobásico e visualizar um status de pulsação dos servidores 9.5.2 em execução ouoffline.

v Fazendo upgrade: devido às mudanças na configuração, em particular osarquivos de planejamento de log compartilhados, não é possível usar osarquivos de configuração do Cognos TM1 Operations Console de uma versão9.x. Os dados do servidor, a configuração do usuário e as informações deplanejamento devem ser inseridos novamente.

Procedimento1. Nos softwares 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 Executar como Administrador. 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. Assegure-se de que o componente Web Application Tier > Cognos TM1Operations Console esteja selecionado.

Lembre-se: Instale os componentes IBM Cognos TM1 em um diretório quecontenha apenas caracteres ASCII no nome do caminho. Alguns servidores daWeb para Windows não suportam caracteres não ASCII em nomes dediretórios.

Usando o Cognos Configuration para Implementar o Cognos TM1Operations Console

Inicie o TM1 Applications Server no Cognos Configuration para implementar oApache Tomcat necessário para executar o TM1 Operations Console.

Antes de Iniciar

Se você instalou o produto a partir do diretório Arquivos de Programas (x86) emum computador executando o software do sistema operacional Microsoft WindowsVista, Windows 7 ou Windows 2008, inicie o IBM Cognos Configuration como umAdministrador.

Procedimento1. Clique em Iniciar > Todos os Programas > IBM Cognos TM1 > IBM Cognos

Configuration.2. Clique com o botão direito do mouse em TM1 Application Server 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.

Instalação avançada do Cognos TM1 Operations ConsoleOs tópicos a seguir fornecem informações adicionais sobre outras maneiras deinstalar o Cognos TM1 Operations Console.

Instalando o Cognos TM1 Operations Console em umamáquina separada

É possível instalar somente o Cognos TM1 Operations Console em uma máquinaque esteja separada dos servidores que estiverem sendo monitorados.

Procedimento1. Instale o Cognos TM1 seguindo o processo usual, mas selecione somente o TM1

Operations Console na lista de componentes da web. Por padrão, isso tambéminstala o Cognos TM1 Applications Server e outros serviços.

2. Após a instalação, na máquina separada, pare o TM1 Application Service.3. Exclua o diretório installation_location/webapps/pmpsvc e os diretórios

installation_location/webapps/p2pd.4. Reinicie o TM1 Application Service.


Instalando o Cognos TM1 Operations Console com suaprópria instalação do servidor de aplicativos da web ApacheTomcat

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.

Ao implementar o Cognos TM1 Operations Console, o Performance ManagementHub também é implementado.

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. Ao utilizar seu própriosoftware do servidor da web, você deverá instalar os certificados e implementar osarquivos war.

Consulte "Usando SSL ao monitorar o TM1 Applications Server" no Guia do CognosTM1 Operations Console para obter mais informações sobre como instalarcertificados.

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 se vocêtem a variável de ambiente do usuário Microsoft Windows a seguir para ocaminho do JRE.v Nome de Variável: classpathv Valor da variável: .;C:\Program Files\Java\jre7\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\7.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\7.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\ibm\cognos\TM1_64\bin64\jre\7.0\bin

Capítulo 9. Instalação do Cognos TM1 Operations Console 107

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\ibm\cognos\TM1_64\bin64\ssl\tm1ca_v2.pem" -keystore "C:\Program Files\ibm\cognos\TM1_64\bin64\jre\7.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 Console para o ApacheTomcatSe você estiver usando sua própria instalação do Apache Tomcat, deveimplementar o IBM Cognos TM1 Operations Console para o Tomcat.

Antes de Iniciarv Inicie uma instância do Apache Tomcat no computador em que 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.

v Construa os arquivos de aplicativos usando o IBM Cognos Configuration.Consulte “Construindo arquivos de aplicativo para um servidor Tomcat” napágina 150

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.

Lembre-se: Se uma versão anterior do Cognos TM1 Operations Console já tiversido implementada, 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 web do CognosTM1 Operations Console construído usando o IBM Cognos Configuration.

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.


Instalando o Cognos TM1 Operations Console no IBMWebSphere

É possível implementar o Cognos TM1 Operations Console no IBM WebSphereApplication Server.

Ao implementar o Cognos TM1 Operations Console, o Performance ManagementHub também é implementado.

Esta instalação é destinada para um ambiente no qual os servidores TM1 AdminServer e TM1 estão em execução em um outro computador.

Para implementar o Operations Console para o WebSphere, conclua estas tarefas:v Construa os arquivos de aplicativo usando o Cognos Configuration. Consulte o

“Construindo arquivos de aplicativo para um servidor IBM WebSphere” napágina 153. Um arquivo pmhub.war é criado no mesmo local como os arquivostm1web.war e pmpsvc.war. O local padrão é <your installationlocation>\ibm\cognos\TM1\pmhub.war.

Nota: É possível utilizar o formato de arquivo EAR em vez de WAR.v Implemente o arquivo pmhub.war para o servidor de aplicativos do Webspherev Recupere os certificados dos servidores TM1 Admin Server e TM1v Configure as comunicações de saída a partir do Websphere para o TM1 Admin

Server

Implementando o Cognos TM1 Operations Console em um IBMWebSphere Application ServerUse o console administrativo do IBM WebSphere para implementar e executar oTM1 Operations Console em um WebSphere Application Server.

Antes de Iniciarv Instale o IBM WebSphere Application Server.v Crie um perfil usando a Ferramenta de Gerenciamento de Perfil.v Inicie o WebSphere Application Server utilizando o perfil que você criou.

No Microsoft Windows, clique em Iniciar > Todos os Programas > IBMWebSphere Application Server > Perfis > [Nome do Perfil] > Iniciar oservidor.Uma janela de comando será aberta e exibirá o progresso da inicialização.Depois que o processo de inicialização for concluído, a janela de comandosexibirá a mensagem, "Servidor iniciado." É possível minimizar esta janela decomando, mas não fechá-la. Esta janela deve permanecer aberta enquanto oWebSphere está em execução.

v Construa os arquivos de aplicativo usando o Cognos Configuration. Consulte o“Construindo arquivos de aplicativo para um servidor IBM WebSphere” napágina 153. O Operations Console e o Performance Management Hub estãocontidos no arquivo pmhub.war.

Para obter informações sobre como instalar o WebSphere e criar um perfil, consultea documentação do WebSphere.

Sobre Esta Tarefa

Essas etapas são baseadas no IBM WebSphere Application Server 8.5.5. As etapaspara a versão 8.5 são semelhantes.


Nota: Depois de iniciar a conclusão das etapas no assistente de instalação doaplicativo WebSphere, clique em Cancelar para sair se optar por não instalar oaplicativo. Não vá simplesmente para outra página do console administrativo semantes clicar em Cancelar em uma página da instalação do aplicativo.

Procedimento1. Abra o console administrativo do WebSphere.

v No Windows, clique em Iniciar > Todos os Programas > IBM WebSphereApplication Server > Perfis > [Nome do Perfil] > Console administrativo.Ou acesse https://localhost:9043/ibm/console/.

v No UNIX, clique em Aplicativos > IBM Websphere > IBM WebsphereApplication Server > Perfis > [Nome do Perfil] > Console administrativo.Ou acesse https://localhost:9043/ibm/console/.

2. Efetue login usando o perfil do WebSphere que você criou. O consoleadministrativo é aberto.

3. Configure o tamanho da memória da pilha da JVM.a. Clique em Servidores > Tipos de Servidor > WebSphere application

Servers.b. Clique no servidor no qual você está implementando o Operations

Console.c. Na Infraestrutura do Servidor, clique em Java e Gerenciamento de

Processo > Definição de Processo.d. Em Propriedades Adicionais, clique em Java Virtual Machine.e. No campo Argumentos Genéricos da JVM, inclua -Xmso512k.

Nota: Não implemente o Operations Console Server até ter configurado amemória da pilha. Se fizer isso, o Operations Console será implementado,mas o WebSphere Application Server não será iniciado.Não use o arquivo startServer.sh para configurar o tamanho da memóriada pilha. O WebSphere remove a configurção do -Xmso do arquivo quandoo servidor é iniciado e a substitui com o valor padrão, que é muitopequeno.

f. Clique em Aplicar e, em seguida, clique em OK . Clique em Salvar.4. Clique em Aplicativos > Novo Aplicativo e, em seguida, clique em Novo

Aplicativo Corporativo.5. Clique em Navegar para localizar e selecionar o arquivo pmhub.war que você

gerou usando o comando Construir Arquivo de Aplicativo no CognosConfiguration. Clique em Abrir.

6. Clique em Avançar.7. Clique em Fast Path e, em seguida, clique em Avançar.8. Clique em Etapa 4: Mapear raízes de contexto para módulos da web.9. Na caixa Raiz de Contexto, digite /pmhub. Clique em Avançar.

10. Clique em Concluir. O WebSphere instala o aplicativo. Esse processo podedemorar alguns minutos para ser concluído.Quando a instalação estiver concluída, o WebSphere exibirá "Aplicativopmhub_war instalado com sucesso."

11. Clique em Salvar.12. Clique em Aplicativos > Tipos de Aplicativo > Websphere Enterprise

Applications.


13. Marque a caixa de seleção ao lado de pmhub_war e, em seguida, clique emIniciar. O WebSphere exibe "Aplicativo pmhub_war no servidor server_name enó nó iniciados com sucesso. A coleta pode precisar ser atualizada paramostrar o status atual."

O que Fazer Depois

A próxima etapa será recuperar certificados SSL do TM1 Admin Server eservidores TM1.

Recuperando certificados SSL dos servidores TM1 Admin Servere TM1Depois de ter implementado o arquivo de aplicativos, pmhub.war, para o IBMWebSphere Application Server, a próxima etapa será recuperar os certificados SSLdos servidores TM1 Admin Server e TM1.

Procedimento1. No console administrativo do In the IBM WebSphere, expanda Segurança e,

em seguida, clique em Gerenciamento de certificado e chave SSL.2. Em Itens Relacionados, clique em Armazenamentos de chaves e certificados.3. Clique no keystore NodeDefaultTrustStore.4. Em Propriedades Adicionais, clique em Certificados de assinantes.5. Clique em Recuperar a partir da porta. Insira as seguintes informações:

v No campo Host, insira o nome do host do TM1 Admin Server.v No campo Porta, insira 5498, o número da porta do TM1 Admin Server.v No campo Alias, insira TM1AdminServer_cert.

6. Clique em Recuperar informações do assinante. O Websphere recupera ocertificado SSL do TM1 Admin Server.

7. Verifique se as informações de certificado são para um certificado que épossível confiar.

8. Clique em Aplicar e, em seguida, clique em Salvar.9. Repita estas etapas para os servidores TM1 que você deseja monitorar com o

Operations Console. Por exemplo:v No campo Host, insira o nome do host do servidor TM1.v No campo Porta, insira o número da porta do servidor TM1.v No campo Alias, insira TM1ServerName_cert.

Dica: O número da porta de um servidor TM1 é configurado no arquivotm1s.cfg no parâmetro PortNumber

10. Salve as mudanças.

O que Fazer Depois

A próxima etapa é para configurar as comunicações de saída entre o Websphere eo TM1 Admin Server.

Configurando comunicações de saída para o TM1 Admin ServerDepois de ter implementado o arquivo de aplicativos, pmhub.war, para o IBMWebSphere Application Server e recuperado certificados SSL, a próxima etapa seráconfigurar as comunicações de saída do WebSphere para o TM1 Admin Server.


Procedimento1. No console administrativo do WebSphere, expanda Segurança e clique em

Gerenciamento de chave e certificado SSL.2. Em Definições de Configuração, clique em Gerenciar Configurações de

Segurança do Terminal.3. Expanda Saída > [node]Node01Cell > nós.4. Clique em [[node]Node01Cell, em que nó é o nome do servidor no qual você

está implementando o Operations Console.5. Em Itens Relacionados, clique em Configurações de SSL do terminal de saída

dinâmico.6. Clique no keystore NodeDefaultTrustStore.7. Clique em Novo.8. No campo Nome, insira tm1admin.9. No campo Descrição, insira conexão ssl.

10. Em Informações de Conexão, insira *,*,5498 e, em seguida, clique em Incluir.

Nota: O valor 5498 é o número da porta SSL do TM1 Admin Server conformeespecificado no Cognos Configuration.

11. Clique em Aplicar e, em seguida, clique em OK .12. Salve as mudanças.13. Reinicie o WebSphere Application Server.14. Em um navegador da web, insira a URL para executar o Operations Console,

http://localhost:port/pmhub/pm/opsconsole/. Substitua porta com o númeroda porta do host virtual no qual você implementou o pmhub.war. Por exemplo:http://localhost:9080/pmhub/pm/opsconsole/. A página de login doOperations Console é exibida.

Configurando o Cognos TM1 Operations ConsolePor padrão, o Cognos TM1 Operations Console é configurado para usar umadminhost de amostra do host local, um servidor do sdata e um grupo chamadoadministração para autenticação de modo que seja possível ativar e executarrapidamente. Se preferir, é possível editar essas configurações para customizar oservidor de autenticação.

Procedimento1. Insira http://servername:port number/pmhub/pm/admin para abrir a tela de

configuração.2. Para alterar o host administrativo, o servidor e o grupo padrão para

monitoramento, expanda o nócom.ibm.ba.pm.opsconsole.monitor.tm1.TM1OpsConsoleMonitor e selecione aopçãocom.ibm.ba.pm.opsconsole.monitor.tm1.TM1OpsConsoleMonitor.dictionary.Clique em cada configuração para alterá-las. Se quiser usar o Microsoft InternetExplorer 8 com Cognos TM1 Operations Console, consulte a documentação doMicrosoft Internet Explorer e assegure essas configurações:v Ative a opção para atualizar páginas da web com cada visitav Desative as opções para depuração de script


Iniciando e efetuando login no Cognos TM1 Operations ConsolePara abrir o IBM Cognos TM1 Operations Console, insira a URL que identifica aporta e o nome do servidor para o componente.

Procedimento1. Em um navegador da web, digite o seguinte endereço da web:

http://servername:port number/pmhub/pm/opsconsole.em quev server_name é o computador em que o Cognos TM1 Operations Console e o

servidor de aplicativos da web estão instalados. Será possível usar apalavra-chave localhost se você estiver registrado atualmente no servidor daweb que está executando o Cognos TM1 Application Web. Ou é possível usaro nome da máquina, o nome de domínio ou o endereço IP do servidor daWeb 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 fornecida com ainstalação do Cognos TM1, o número da porta padrão é 9510. Para umaversão diferente do Apache Tomcat, abra o arquivo server.xml do ApacheTomcat no local C:\Program Files\Apache Software Foundation\Tomcat6.0\conf\ para determinar a configuração da porta que a versão do Tomcatestá usando.

2. Na página de login, insira valores para os seguintes campos e, em seguida,clique em Login. Para usar o grupo de monitoramento padrão, insirav Namespace: Use o menu suspenso para selecionar o Namespace disponível.

Se o sistema for um sistema protegido por CAM, o namespace é onamespace do BI contra quem o sistema do TM1 é protegido. Se o sistemanão for protegido por CAM, o namespace é adminhost/tm1 server, porexemplo localhost/SData

v Nome do Usuário: adminv Senha: appleConsulteConfigurando o TM1 Operations Console para obter a introdução.


http://www.ibm.com/support/knowledgecenter/SS9RXT_10.2.2/com.ibm.swg.ba.cognos.tm1_ops_console.10.2.2.doc/c_tm1_ops_console_configuration_tasks.html

Capítulo 10. Instalação do Cognos TM1 Web

É possível instalar o IBM Cognos TM1 Web em um computador diferente daqueleno qual o servidor Cognos TM1 e os outros componentes do Cognos TM1 foraminstalados.

É possível implementar o TM1 Web em um servidor de aplicativos Apache Tomcatou no IBM WebSphere Application Server. Consulte:v “Instalando o TM1 Web com o servidor de aplicativos Apache Tomcat fornecido”v “Instalando o TM1 Web com o IBM WebSphere” na página 118

Ao instalar o TM1 Web, o TM1 Applications Web também é instalado.

Para obter detalhes sobre a arquitetura do Cognos TM1 Web, consulte “Arquiteturado Cognos TM1 Web” na página 31.

Lista de Verificação para Instalar o Cognos TM1 Web

Os seguintes itens são uma lista de verificação geral para a instalação do CognosTM1 Web.v Instalar o Cognos TM1 Web.v Se você estiver usando o Tomcat, use o IBM Cognos Configuration para iniciar o

servidor de aplicativos da web para o Cognos TM1 Web.Se você estiver usando o WebSphere Application Server, use o consoleadministrativo do WebSphere para iniciar o servidor de aplicativos.

v Executar e testar o Cognos TM1 Web a partir de seu ambiente de rede.v Edite o arquivo de configuração do Cognos TM1 Web para suportar um

ambiente com vários computadores. Consulte o “Configurando a Página deLogin do Cognos TM1 Web Usando os Parâmetros AdminHostName eTM1ServerName” na página 125.

v Configure a autenticação e a segurança da transmissão de dados. Consulte oCapítulo 15, “Configuração de Segurança”, na página 193.

v Configure opções adicionais no arquivo de configuração do CognosTM1 Web.Consulte o “Modificando os Parâmetros de Configuração do Cognos TM1 Web”na página 121.

v Configure os navegadores da web no ambiente. Consulte o “Configuração doNavegador da Web para o Cognos TM1 Web” na página 135.

Conceitos relacionados:“Atualizando o Cognos TM1 Web” na página 58Se 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.

Instalando o TM1 Web com o servidor de aplicativos Apache Tomcatfornecido

É possível instalar o Cognos TM1 Web em um computador separado eimplementá-lo com a instância do Apache Tomcat fornecida com a instalação


A instalação do IBM Cognos TM1 configura o Cognos TM1 Web para serexecutado com a versão fornecida do servidor de aplicativos da web ApacheTomcat.

Após instalar o Cognos TM1 Web no computador separado, edite o arquivo deconfiguração do Cognos TM1 Web para identificar o computador remoto no qual oCognos TM1 Admin Server está executando.

Instalando e Configurando o Cognos TM1 Web no MicrosoftWindows

Essas etapas descrevem como instalar o IBM Cognos TM1 Web em um computadorseparado que esteja executando o Microsoft Windows. Essas etapas são aplicadasao usar o servidor de aplicativos Apache Tomcat fornecido.

Sobre Esta Tarefa

Este procedimento também instala o utilitário do IBM Cognos Configuration. Use oCognos Configuration para iniciar e parar o servidor de aplicativos.

Quando o IBM Cognos TM1 Web for instalado em um computador separado, editeo arquivo de configuração para identificar o IBM Cognos TM1 Admin Server e osservidores IBM Cognos TM1 na rede que você deseja usar com o Cognos TM1Web.

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 no arquivo issetup.exe eclique em Executar como Administrador. Para outros sistemas operacionais,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. 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.Inicia o servidor de aplicativos da web fornecido para o Cognos TM1 Web.

7. 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:9510/tm1web/

Em um computador remoto, substitua host local pelo nome ou endereço IPdo computador no qual o Cognos TM1 Web está em execução.

8. Configure o Cognos TM1 Web para conectar-se aos servidores Cognos TM1remotos na rede.


Se você desejar que o Cognos TM1 Web se conecte a um Cognos TM1 AdminServer ou a um servidor Cognos TM1 específico na rede, configure osparâmetros AdminHostName e TM1ServerName no arquivo de configuração doCognos TM1 Web, o tm1web_config.xml.Consulte o “Configurando a Página de Login do Cognos TM1 Web Usando osParâmetros AdminHostName e TM1ServerName” na página 125.

9. Configure as opções de segurança para o Cognos TM1 Web.É possível configurar a segurança de autenticação, como o Login Integrado ouo IBM Cognos Security e a segurança de transmissão de dados, como SSL,dependendo do sistema e do ambiente de rede.Consulte o Capítulo 15, “Configuração de Segurança”, na página 193.

10. Configure opções adicionais no arquivo de configuração do CognosTM1 Web.Consulte o “Modificando os Parâmetros de Configuração do Cognos TM1Web” na página 121.

11. Revise as etapas para a configuração do navegador da web.É possível configurar as opções do navegador da web como o idioma e asconfigurações regionais para os usuários.Consulte o “Configuração do Navegador da Web para o Cognos TM1 Web” napágina 135.

Instalando e Configurando o Cognos TM1 Web no UNIXA instalação do IBM Cognos TM1 Web em um sistema UNIX requer a importaçãodo certificado para o keystore do Java no UNIX. Essas etapas se aplicam se vocêestiver usando o servidor de aplicativos Apache Tomcat fornecido.

Antes de Iniciar

Você deverá configurar a variável de ambiente JAVA_HOME antes que seja possíveliniciar o IBM Cognos Configuration. O Cognos Configuration é usado para iniciaro servidor de aplicativos da web para o Cognos TM1 Web.

Sobre Esta Tarefa

A importação do certificado para o keystore do Java no UNIX é necessária paraativar o Cognos TM1 Web para exibir a lista de servidores Cognos TM1disponíveis.

Procedimento1. Execute o programa de instalação:

a. Acesse o local no qual os arquivos de instalação foram transferidos pordownload e extraídos ou insira o disco do produto.

b. Acesse o diretório do sistema operacional e, em seguida, digite./issetup

c. Avance para a tela Seleção de Componente.d. Selecione somente o componente Camada do Aplicativo da Web > TM1

Web.Cancele a seleção de todos os outros componentes.

e. Siga os prompts no assistente de instalação para concluir a instalação.2. Importe o certificado para o keystore do Java no UNIX.

a. Altere o diretório para o local do compartimento associado ao JAVA_HOME.

Capítulo 10. Instalação do Cognos TM1 Web 117

b. Execute o comando a seguir:keytool -import -file “/bin64/ssl/applixca.pem” -keystore“/usr/java7/jre/lib/security/cacerts” -storepass “changeit”

3. Inicie o IBM Cognos Configuration:Acesse o diretório install_location/bin64 e, em seguida, digite o comando aseguir:./cogconfig.sh

4. Inicie o servidor de aplicativos da web para o Cognos TM1 Web: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.

5. Confirme se o Cognos TM1 Web está em execução inserindo a URL para oCognos TM1 Web em um navegador da web em um computador remoto. Porexemplo:http://<unix_web_server>:9510/tm1web/

Substitua <unix_web_server> pelo nome ou o endereço IP do computador noqual o Cognos TM1 Web está em execução.

O que Fazer Depois

Dependendo do sistema e do ambiente de rede, execute as seguintes etapas deconfiguração adicionais:v Configure o Cognos TM1 Web para conectar a um Cognos TM1 Admin Server

específico ou ao servidor Cognos TM1 na sua rede.Consulte o “Configurando a Página de Login do Cognos TM1 Web Usando osParâmetros AdminHostName e TM1ServerName” na página 125.

v Configure as opções de segurança para o Cognos TM1 Web.Consulte o Capítulo 15, “Configuração de Segurança”, na página 193.

v Configure opções adicionais no arquivo de configuração do CognosTM1 Web.Consulte o “Modificando os Parâmetros de Configuração do Cognos TM1 Web”na página 121.

v Revise as etapas para a configuração do navegador da web.Consulte o “Configuração do Navegador da Web para o Cognos TM1 Web” napágina 135.

Instalando o TM1 Web com o IBM WebSphereÉ possível implementar o Cognos TM1 Web para o IBM WebSphere ApplicationServer. Ao instalar o TM1 Web, o TM1 Applications Web também é instalado.

Para instalar o TM1 Web e o TM1 Applications Web em um WebSphereApplication Server, conclua estas tarefas:v Construa os arquivos de aplicativo usando o Cognos Configuration. Consulte o

“Construindo arquivos de aplicativo para um servidor IBM WebSphere” napágina 153. Um arquivo tm1web.war foi criado. O local padrão é <yourinstallation location>\ibm\cognos\TM1\tm1web.war.

Nota: É possível utilizar o formato de arquivo EAR em vez de WAR.v Implemente o arquivo tm1web.war no WebSphere Application Serverv Importe ocertificado SSL do TM1 no WebSphere


Implementando o TM1 Web para um IBM WebSphereApplication Server

Use o console administrativo do IBM WebSphere para implementar e executar oTM1 Web e TM1 Applications Web em um WebSphere Application Server


No Microsoft Windows, clique em Iniciar > Todos os Programas > IBMWebSphere Application Server > Perfis > [Nome do Perfil] > Iniciar oservidor.Uma janela de comando será aberta e exibirá o progresso inicial. Depois que oprocesso inicial for concluído, a janela de comandos exibirá a mensagem,"Servidor iniciado." É possível minimizar esta janela de comando, mas nãofechá-la. Esta janela deve permanecer aberta enquanto o WebSphere está emexecução.

v Construa os arquivos de aplicativo usando o Cognos Configuration. Consulte o“Construindo arquivos de aplicativo para um servidor IBM WebSphere” napágina 153.


Sobre Esta Tarefa



Procedimento1. Abra o console administrativo do WebSphere.

v No Windows, clique em Iniciar > Todos os Programas > IBM WebSphereApplication Server > Perfis > [Nome do Perfil] > Console administrativo.Ou acesse https://localhost:9043/ibm/console/.



3. Clique em Aplicativos > Novo Aplicativo e, em seguida, clique em NovoAplicativo Corporativo.

4. Clique em Navegar para localizar e selecionar o arquivo tm1web.war que vocêgerou usando o comando Construir Arquivo de Aplicativo no CognosConfiguration. Clique em Abrir.

5. Clique em Avançar.6. Clique em Fast Path e, em seguida, clique em Avançar.


7. Clique em Etapa 4: Mapear raízes de contexto para módulos da web.8. Na caixa Raiz de Contexto, digite /tm1web. Clique em Avançar.9. Clique em Concluir. O WebSphere instala o aplicativo. Esse processo pode

demorar alguns minutos para ser concluído.Quando a instalação estiver concluída, o WebSphere exibirá "aplicativotm1web_war instalado com sucesso."

10. Clique em Salvar.11. Clique em Aplicativos > Tipos de Aplicativo > Websphere Enterprise

Applications.12. Marque a caixa de opção ao lado de tm1web_war e, em seguida, clique em

Iniciar. O WebSphere exibe "Aplicativo tm1web_war no servidor server_name enó nó iniciados com sucesso. A coleta pode precisar ser atualizada paramostrar o status atual."

O que Fazer Depois

A próxima etapa é para importar certificados TM1 no keystore.

Importando certificados SSL para o TM1 WebDepois de ter implementado o arquivo de aplicativos, tm1web.war, para o IBMWebSphere Application Server, a próxima etapa será importar os certificados SSLdo TM1 para o keystore.

Sobre Esta Tarefa

Para o TM1 Web, todos os certificados raiz devem ser instalados noarmazenamento de certificados no computador no qual o TM1 Web estáexecutando.

Procedimento1. No console administrativo do IBM WebSphere, expanda Segurança e, em

seguida, clique em Gerenciamento de certificado e chave SSL.2. Em Itens Relacionados, clique em Armazenamentos de chaves e certificados.3. Clique no keystore NodeDefaultTrustStore.4. Em Propriedades Adicionais, clique em Certificados de assinantes.5. Clique em Incluir.6. Insira as seguintes informações:

v No campo Alias, insira applixca.pem.v No campo Nome do Arquivo, insira o caminho completo e o nome do

arquivo do certificado SSL para TM1, por exemplo TM1_install_dir\bin\SSL\applixca.pem

Nota: Se você estiver usando seus próprios certificados SSL, insira ocaminho e o nome do arquivo do certificado raiz

v Para o campo Tipo de dados, mantenha o valor padrão.7. Clique em Aplicar e, em seguida, clique em OK .8. Confirme se o Cognos TM1 Web está em execução inserindo a URL para o

Cognos TM1 Web em um navegador da web. Por exemplo:http://host:port/tm1web/

Em um computador remoto, substitua host pelo nome ou endereço IP docomputador no qual o Cognos TM1 Web está em execução. Substitua porta


pelo número da porta do host virtual no qual você implementou o tm1web.war.Por exemplo: http://server1:9080/tm1web.

O que Fazer Depois

A próxima etapa é configurar o TM1 Web. Consulte “Modificando os Parâmetrosde Configuração do Cognos TM1 Web” e “Configuração do Navegador da Webpara o Cognos TM1 Web” na página 135.

Modificando os Parâmetros de Configuração do Cognos TM1 WebO arquivo tm1web_config.xml é um arquivo XML que contém os parâmetros deconfiguração do IBM Cognos TM1 Web.

A partir do Cognos TM1 Web versão 10.2, o novo arquivo tm1web_config.xmlsubstitui o arquivo web.config a partir de versões anteriores do Cognos TM1 Web.

Os parâmetros deste arquivo controlam os recursos a seguir do IBM Cognos TM1Web.v Nó de visualizaçõesv Tamanho de página do Cube Viewerv Número de planilhas a serem exportadas de um Cube Viewerv Configurações de inicialização e aparência do IBM Cognos TM1 Web

Parâmetros de Configuração do Cognos TM1 WebOs parâmetros de configuração do IBM Cognos TM1 Web são armazenados noarquivo tm1web_config.xml.

O arquivo tm1web_config.xml se encontra no local a seguir:

<TM1 install location>\webapps\tm1web\WEB-INF\configuration\

Os parâmetros a seguir estão disponíveis.

AdminHostNameSe configurado, os usuários não serão solicitados a inserir um valor para oHost de Administração durante o login.

Consulte o “Configurando a Página de Login do Cognos TM1 Web Usandoos Parâmetros AdminHostName e TM1ServerName” na página 125.

AdminHostPortSe configurado, o cliente tentará usar essa porta ao invés da porta padrãodo Host de Administração.

AdminHostSSLPortSe configurado, o cliente tentará usar essa porta ao invés da porta padrãodo Host SSL de Administração.

CrossDomainAccessList

Especifica o nome de domínio em que os TM1 iWidgets estão em execução.Por exemplo, inclua o nome do domínio em que o IBM Cognos Workspaceestá em execução.

Use um asterisco (*) para permitir que o Cognos TM1 Web e o CognosWorkspace acessem um ao outro através de domínios diferentes.


Se você especificar diversas URLs, separe cada uma usando uma vírgula.

CubeViewerColumnPageSizeEspecifica o número de colunas para buscar em uma página do CubeViewer.

Consulte o “Alterando o Tamanho de Página do Cube Viewer” na página134.

CubeViewerRowPageSizeEspecifica o número de linhas para buscar em uma página do CubeViewer.

Consulte o “Alterando o Tamanho de Página do Cube Viewer” na página134.

CubeviewerStringWrapConfigurações para agrupamento de célula de sequência no Cube Viewer.

Consulte o “Agrupando Valores de Sequência nas Visualizações do Cubo”na página 135.

CustomCAMLogoutUrl

Especifica a URL de uma página de logout dedicado para o CA SiteMinderquando TM1 está configurado para utilizar a segurança do CAM (modo 4ou 5). Esta página de logout deve ser acessada no logout para que o cookiede sessão do SiteMinder possa ser invalidado.

Quando um usuário clica em Logoff no TM1 Web, o logout do CAMocorre primeiro. Então, a página de logout SiteMinder é chamada.

GzipCompressionEnabledDetermina se as respostas do servidor da web serão compactadas. Osvalores válidos são true/false.

HideCubeviewerToolBarSe configurado para true, todas as barras de ferramentas do Cube Viewernão serão exibidas.

Consulte o “Parâmetro HideCubeviewerToolBar” na página 133.

HideTabBarSe configurado para true, diversas guias não serão exibidas.

Consulte o “Parâmetro HideTabBar” na página 132.

HideWebsheetToolBarSe configurado para true, todas as barras de ferramentas de planilha nãoserão exibidas.

Consulte o “Parâmetro HideWebsheetToolBar” na página 133.

HomePageObjectSe configurado, o objeto do tipo Planilha, Cube Viewer ou URL seráexibido após o usuário efetuar login.

Consulte o “Configurando uma Página Inicial Global para Todos osUsuários” na página 128.

IntegratedSecurityModuleNameEspecifica o nome do módulo de login no arquivo apontado pelo arquivode configuração de login java.security.

MaximumSheetsForExportNúmero máximo de planilhas permitidas para Exportar.


Consulte o “Definindo o Número Máximo de Planilhas a Serem Exportadasde um Cube Viewer” na página 134.

NavTreeCollapsedOnStartDetermina se o painel de navegação será reduzido ou expandido após umusuário efetuar login.

Consulte o “Parâmetro NavTreeCollapsedOnStart” na página 132.

NavTreeDisplayServerViewEspecifica se o nó de Visualização do Servidor será exibido na árvore denavegação. Os valores válidos são Y e N.

Consulte o “Exibindo ou Ocultando o Nó de Visualizações na Área deJanela de Navegação” na página 134.

NavTreeHiddenDetermina se o painel de navegação será exibido após um usuário efetuarlogin.

Consulte o “Parâmetro NavTreeHidden” na página 131.

RecalcOnDataValidationChange

Especifica se o comportamento de recálculo padrão será substituídoquando alterar o valor de uma lista de validação de dados.

Se configurado para true, um recálculo será acionado quando um valor emuma lista de validação de dados for alterado.

Se configurado para false, um recálculo não será acionado quando umvalor em uma lista de validação de dados for alterado.

RecalcOnPicklistChange

Especifica se o comportamento de recálculo padrão será substituídoquando alterar o valor de uma lista de seleção.

Se configurado para true, um recálculo será acionado quando um valor emuma lista de seleção for alterado.

Se configurado para false, um recálculo não será acionado quando umvalor em uma lista de seleção for alterado.

TM1ServerNameSe configurado, os usuários não serão solicitados a selecionar um TM1Server para se conectar durante o login.

Consulte o “Configurando a Página de Login do Cognos TM1 Web Usandoos Parâmetros AdminHostName e TM1ServerName” na página 125.

UseBookRecalcSetting

O parâmetro UseBookRecalcSetting é incluído no arquivotm1web_config.xml. Quando configurado como verdadeiro, o servidor daweb utiliza o modo no qual a planilha do Excel foi publicada. Se a planilhado Excel tiver sido publicada no modo recalc Manual, as planilhas dedados não serão enviadas novamente ao cliente até que um recálculo sejaexecutado.

O parâmetro UseBookRecalcSetting usa o formato a seguir no arquivotm1web_config.xml:<add key="UseBookRecalcSetting" value="false" />

em que o valor é "false" ou "true"


Se você configurar o UseBookRecalcSetting como true, o TM1 Webrespeitará as configurações de recálculo na planilha do Excell.

Quando as opções de cálculo forem configuradas como automáticas:v se você configurar o UseBookRecalcSetting = "true", a planilha da web

será recalculada automaticamente quando você alterar a função SUBNM.v se você configurar o UseBookRecalcSetting = "false", a planilha da

web será recalculada automaticamente quando você alterar a funçãoSUBNM.

Quando Opções de Cálculo for configurado como Manual:v se você configurar o UseBookRecalcSetting = "true", a planilha da web

não será recalculada automaticamente. Para recalcular, deve-se clicarmanualmente no botão recalc.

v se você configurar o UseBookRecalcSetting = "false", a planilha daweb será recalculada automaticamente quando você alterar a funçãoSUBNM.

WebsheetBackgroundRecalculationMode

Especifica o nível de recálculo em segundo plano que ocorre para umaplanilha da web.

Chamadas WebSheetService.scrollWebSheet podem demorar váriossegundos porque os dados não estão prontamente disponíveis. Use oparâmetro WebsheetBackgroundRecalculationMode para recalcular omanual no segundo plano para que os dados necessários estejam prontosquando forem solicitados.

Se configurado como 0 (valor padrão), apenas a área em buffer (visível)será calculada em uma atualização de uma planilha.

Se configurada como 1, a área adjacente à área em buffer é calculada, alémda área em buffer. Isso melhora o tempo de espera se o usuário rolar umpouco para fora da área inicialmente visível.

Se configurada como 2, a planilha atual inteira é calculada. Isso melhora otempo de espera se o usuário rolar para qualquer área da planilha atual.

Se configurada como 3, a planilha atual inteira será calculada. Isso melhorao tempo de espera se o usuário for para qualquer área da planilha atual oupara outra planilha.

Nota: Quanto maior o número da configuração, mais as células serãocalculadas, significando que há uma carga maior no servidor da Web.

Editando o Arquivo de Configuração do Cognos TM1 WebÉ possível editar o arquivo de configuração do IBM Cognos TM1 Web paraconfigurar diferentes parâmetros.

O arquivo de configuração do Cognos TM1 Web é um arquivo xml que deve seraberto apenas com um editor de tipo XML. Abri-lo usando um editor de textocomum como o Microsoft Wordpad pode resultar na inclusão de caracteresincorretos que podem corromper o arquivo.

A partir do Cognos TM1 Web versão 10.2, o novo arquivo tm1web_config.xmlsubstitui o arquivo web.config a partir de versões anteriores do Cognos TM1 Web.


Procedimento1. Localize e abra o arquivo tm1web_config.xml no local a seguir:

<TM1 install location>\webapps\tm1web\WEB-INF\configuration\

Nota: O arquivo tm1web_config.xml é um arquivo xml que deve ser abertoapenas com um editor de tipo XML. Abri-lo usando um editor de texto regularcomo Microsoft Word Pad pode fazer com que sejam incluídos caracteresincorretos que podem corromper o arquivo.

2. Edite os parâmetros e salve suas mudanças.3. Efetue login no IBM Cognos TM1 Web para ver o resultado de suas edições.

Configurando a Página de Login do Cognos TM1 Web Usandoos Parâmetros AdminHostName e TM1ServerName

Os parâmetros AdminHostName e TM1ServerName controlam se a página de login doIBM Cognos TM1 Web solicita ou não que o usuário insira valores para o hostadministrativo do TM1 e servidor TM1 .

Se você configurar um valor para um desses parâmetros no arquivotm1web_config.xml e, em seguida, o processo de login usará o valor especificado enão solicitará essas informaçõ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 tm1web_config.xml usando o formato a seguir:<add key="AdminHostName" value="HostName"/>

em que HostName pode ser um dos valores a seguir:v Se o HostName estiver em branco (valor padrão), a página de login exibirá o

prompt Host Administrativo.v Se o HostName estiver configurado para o nome de um Host Administrativo

válido do TM1 , o IBM Cognos TM1 Web usará esse Host Administrativo para oprocesso de login e não solicitará nada do usuário.

Parâmetro TM1ServerName

Esse parâmetro configura o nome do servidor TM1 . Edite o parâmetroTM1ServerName no arquivo tm1web_config.xml usando o formato a seguir:<add key="TM1ServerName" value="ServerName"/>

em que ServerName pode ser um dos valores a seguir: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.v Se o ServerName estiver configurado para um nome de servidor TM1 válido, a

página de login não exibirá um prompt para o Host Administrativo ou servidorTM1 .

v Se o parâmetro AdminSvrSSLCertID estiver configurado incorretamente, o nomedo servidor será exibido como vazio em uma lista suspensa e um erro seráregistrado no arquivo de log do Cognos TM1 Web. Consulte “Executando o TM1no Modo Seguro usando o SSL” no IBM Cognos TM1 Guia de Operações paraobter 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 tm1web_config.xml.

Por exemplo, o TM1ServerName parâmetro pode ser configurado para amostra deplanejamento, conforme mostrado no código a seguir.<add key="TM1ServerName" value="planning sample" />

Configurando uma Página Inicial Customizada do IBM CognosTM1 Web

É possível configurar uma página inicial customizada do IBM Cognos TM1 Webpara exibir uma Planilha da Web, uma visualização do cubo ou um LocalizadorUniforme de Recursos depois que os usuários efetuam login com sucesso no IBMCognos TM1 Web. Esta página inicial pode oferecer aos usuários um ponto deinício para acessar e trabalhar com dados do TM1 .

Uma página inicial pode ser configurada globalmente para todos os usuários doIBM Cognos TM1 Web ou designada individualmente para diferentes usuários ouconjuntos de usuários. Por exemplo, se você configurar a opção de página inicialpara exibir um arquivo HTML ou outro tipo de página da Web, poderá forneceraos usuários instruções, tarefas, links ou qualquer outro conteúdo que possa serexibido em uma página da Web.

Se uma página inicial estiver configurada, ela será exibida na primeira guia no IBMCognos TM1 Web e não poderá ser fechada pelos usuários. Quando configurado,um link de Início é exibido na área de cabeçalho do IBM Cognos TM1 Web,permitindo que os usuários retornem facilmente para a página inicial.

Uma página inicial do IBM Cognos TM1 Web pode ser configurada em uma dasduas seguintes maneiras:v Página inicial diferente para usuários diferentes do IBM Cognos TM1 Web -

Use o diálogo Configurações do Cliente no TM1 Architect e Server Explorer paraconfigurar uma página inicial de inicialização para clientes diferentes (usuários)do IBM Cognos TM1 Web.

v Página inicial global de todos os Usuários da Web do IBM Cognos TM1 Web- Use o parâmetro HomePageObject no arquivo tm1web_config.xml paraconfigurar uma página inicial que se aplique globalmente a todos os usuários doIBM Cognos TM1 Web.

Nota: Qualquer designação de ambiente que fizer com o diálogo Configurações doCliente pode substituir a configuração global no arquivo tm1web_config.xml sevocê configurar AllowOverwrite=true no parâmetroHomePageObject do arquivotm1web_config.xml.

Configurando Diferentes Páginas Iniciais para UsuáriosIndividuaisO diálogo Configurações do Cliente, no Architect e no Server Explorer, configurauma página inicial de inicialização para clientes diferentes (usuários) do IBMCognos TM1 Web.

Por exemplo, é possível designar uma página inicial para usuários do IBM CognosTM1 Web no departamento de Vendas e outra página inicial para usuários dodepartamento de Finanças.


Nota: É possível usar o diálogo Configurações do Cliente para designar páginasiniciais para usuários específicos, substituindo a configuração da página inicialglobal do parâmetro HomePageObject no arquivo tm1web_config.xml.

Procedimento1. No Architect ou Server Explorer, clique com o botão direito do mouse no

servidor e selecione Segurança, Clientes/Grupos.O diálogo Clientes/Grupos se abre.

2. Clique em Configurações.O diálogo Configurações do Cliente se abre.

3. Selecione o cliente da lista Cliente Atual ao qual a configuração de páginainicial será aplicada.

4. Insira uma planilha da Web, visualização do cubo ou Localizador Uniforme deRecursos para a página inicial, da seguinte forma:v Para exibir um Localizador Uniforme de Recursos, digite o endereço do

Localizador Uniforme de Recursos, incluindo o protocolo http://, na caixaPágina Inicial. É possível inserir um Localizador Uniforme de Recursos paraum Web site ou um arquivo individual.

v Para selecionar uma planilha da Web ou visualização do cubo como a páginainicial, clique em Navegar. O diálogo Selecionar uma Página Inicial do IBMCognos TM1 Web é aberto onde for possível selecionar uma referência parauma planilha da Web ou uma visualização de cubo na árvore de Aplicativos.

Depois de selecionar uma referência de planilha da Web ou de visualização docubo, clique em OK para retornar ao diálogo Configurações do Cliente.

5. Selecione as configurações que controlam a aparência da área de janela deNavegação.

Nota: As configurações da área de janela de Navegação que você configuraraqui se aplicarão apenas se o parâmetro correspondente no arquivotm1web_config.xml for configurado para AllowOverwrite=true. Para obterdetalhes, consulte “Definindo as Configurações de Inicialização e Aparência doIBM Cognos TM1 Web” na página 131.As configurações disponíveis para controlar a aparência da área de janela deNavegação incluem:v Incluir a Área de Janela de Navegação - Determina se a área de janela de

Navegação será exibida ou não quando o cliente selecionado efetuar login noIBM Cognos TM1 Web.

v Abrir Área de Janela no Login - Configura a área de janela de Navegaçãopara ser exibida no modo expandido quando o cliente selecionado efetuarlogin no IBM Cognos TM1 Web.

v Fechar Área de Janela no Login - Configura a área de janela de Navegaçãopara ser exibida em seu modo minimizado quando o cliente selecionadoefetuar login no IBM Cognos TM1 Web.

v Salvar Configurações da Área de Janela de Navegação do Cliente -Determina se as configurações pessoais da área de janela de Navegação serãosalvas quando o cliente efetuar logout do IBM Cognos TM1 Web.

6. Selecione uma das opções da lista Aplicar a para configurar qual cliente ouclientes poderão visualizar a página inicial.v Cliente Atual - Aplica a configuração da página inicial apenas ao cliente

selecionado na Lista de Clientes atual.


v Clientes Selecionados - Ativa o botão Selecionar para que seja possível abriro Editor de Subconjunto para selecionar uma coleção de clientes que usarão amesma configuração de página inicial.

v Todos os Clientes - Aplica a mesma configuração da página inicial a todosos clientes do TM1 .

Se você escolher Clientes Selecionados e, em seguida, clicar em Selecionar, oEditor de Subconjunto será aberto para que seja possível selecionar umsubconjunto de clientes do TM1 que possam usar a página inicial.Use o Editor de Subconjunto para selecionar um subconjunto de clientes e, emseguida, clique em OK para retornar ao diálogo Configurações do Cliente. Onúmero de clientes selecionados no Editor de Subconjunto é resumido nodiálogo Configurações do Cliente.

7. Clique em Aplicar Configurações para configurar a página inicial para ocliente ou clientes selecionados na lista Aplicar a.

8. Repita as etapas 4, 5, 6 e 7 para configurar uma página inicial para umconjunto diferente de clientes do TM1 .

9. Clique em OK para fechar o diálogo Configurações do Cliente.Agora você configurou uma página inicial para o IBM Cognos TM1 Web. Osclientes selecionados do IBM Cognos TM1 Web verão a página inicialdesignada na próxima vez que efetuarem login com sucesso no IBM CognosTM1 Web.

Configurando uma Página Inicial Global para Todos os UsuáriosO parâmetro HomePageObject, no arquivo tm1web_config.xml ativa uma páginainicial global que é exibida para todos os usuários da web do IBM Cognos TM1Web.

Nota: É possível substituir o parâmetro HomePageObject global usando o diálogoConfigurações do Cliente para designar páginas iniciais diferentes para usuários doCognos TM1. Para obter detalhes, consulte “Configurando Diferentes PáginasIniciais para Usuários Individuais” na página 126

O parâmetro HomePageObject funciona para três tipos de objetos:v Cubeviewerv Planilha da Webv URL

O objeto de página inicial é exibido após o usuário efetuar login com êxito no IBMCognos TM1 Web.

Usando o Parâmetro HomePageObject:

Como usar o parâmetro HomePageObject.

O parâmetro HomePageObject usa o seguinte formato:

<add key="HomePageObject" value="ObjectPath ;Type= ObjectType ;Description=ObjectTitle ; AllowOverwrite =true" />

em que:v ObjectPath é o caminho para o objeto planilha da Web, visualização do cubo ou

Localizador Uniforme de Recursos que você deseja abrir. O formato exato docaminho depende do tipo de objeto.


v ObjectType é a palavra-chave para o objeto que você deseja abrir; planilha daWeb, cubeviewer ou Localizador Uniforme de Recursos.

v ObjectTitle é um título curto designado ao objeto exibido na barra de título donavegador da Web e na guia da página inicial no IBM Cognos TM1 Web.

v AllowOverwrite pode ser definido como um valor true ou false, da seguinteforma:

Se AllowOverwrite=true for configurado, o parâmetro HomePageObject poderá sersubstituído ao configurar uma página inicial diferente para clientes específicosusando o diálogo Configurações do Cliente no Architect e no Server Explorer.

Se AllowOverwrite=false for configurado, o parâmetro HomePageObject seráaplicado globalmente a todos os usuários do TM1 e não poderá ser configuradoindividualmente com o diálogo Configurações do Cliente no Architect e ServerExplorer.

As seções a seguir descrevem como usar o parâmetro HomePageObject paraplanilhas da Web, visualizações do cubo e Localizadores Uniformes de Recursos.

Configurando uma Página Inicial Global do IBM Cognos TM1 Web para umaVisualização do Cubo:

Use o seguinte formato para configurar uma visualização do cubo como a páginainicial do IBM Cognos TM1 Web.value=CubeName$$ViewName$$Status

em que os argumentos a seguir são separados por caracteres $$:v CubeName é o nome do cubo ao qual a visualização pertence.v ViewName é o nome da visualização do cubo a ser exibida.v Status é o status público ou particular da visualização do cubo.

Nota: Você deve incluir um valor de PUBLIC ou PRIVATE para identificarcorretamente a visualização do cubo específica que deseja abrir.

Por exemplo, para abrir uma visualização pública chamada Preço a partir deSalesCube:&ltadd key="HomePageObject" value="SalesCube$$Price$$Public;Type=cubeviewer;Description=MyStartCube;AllowOverwrite=true"/>

Configurando uma Página Inicial Global do IBM Cognos TM1 Web para umaPlanilha da Web:

É possível designar uma planilha da Web como a página inicial do IBM CognosTM1 Web, dependendo de como o arquivo do Excel foi incluído no TM1 .

Abrindo uma Planilha da Web que Referencia um Arquivo do Excel Fora do TM1:

É possível abrir uma planilha da Web que referencia um arquivo do Excel.

Procedimento

Use o formato:value="WebsheetPath


em que WebsheetPath é o local e nome do arquivo do Excel. Este pode ser umcaminho para um arquivo local, ou um caminho UNC para um arquivo localizadoem uma rede.Por exemplo, para definir um caminho de rede UNC para a planilha da Web:value=//MySystem/Samples/classic_slice.xls

Resultados

O parâmetro HomePageObject completo é semelhante ao seguinte:<add key="HomePageObject" value="//MySystem/Samples/classic_slice.xls;Type=websheet;

Description=MyWebsheet;AllowOverwrite=true"/>

Abrindo um Objeto da Planilha da Web que foi Transferido por Upload para o ServidorTM1:

É possível abrir um objeto da planilha da Web que foi transferido por upload.

Procedimento

1. No Server Explorer, use a área de janela Propriedades para localizar o nomedesignado pelo TM1 para o arquivo do Excel transferido por upload.

2. Defina o parâmetro de valor usando o seguinte formato:value="TM1://ServerName/blob/PUBLIC/.\}Externals\TM1 _Filename

em que:v ServerName é o nome do servidor TM1 no qual o arquivo do Excel está

localizado.v TM1 _location é o nome que o TM1 designou ao arquivo Excel transferido

por upload.Por exemplo:value="TM1://sdata/blob/PUBLIC/.\}Externals\Report_2006.xls_20070123212746.xls

A linha do parâmetro completo HomePageObject é semelhante à seguinte:<add key="HomePageObject" value="TM1://sdata/blob/PUBLIC/.\}Externals\Report_2006.xls_20070123212746.xls;Type=websheet;Description=MyUploaded Websheet;AllowOverwrite=true" />

Nome do usuário designado para um arquivo do Excel transferido por upload Nome designado do TM1 de um arquivo do Excel transferido por upload

Figura 6. Exemplo de um nome designado para um arquivo Excel transferido por upload no Server Explorer


Configurando uma Página Inicial Global do IBM Cognos TM1 Web para umaURL:

É possível configurar o parâmetro HomePageObject para uma URL.

Use este formato:value="URL_Path

Em que URL_Path pode apontar para um Web site ou um arquivo de página daWeb individual.

Por exemplo:v Para definir a página inicial para um Localizador Uniforme de Recursos que

aponte para um arquivo:<addkey="HomePageObject" value="homepage.html;Type=URL;

Description=MyStart Page;AllowOverwrite=true"/>

v Para definir a página inicial para um Localizador Uniforme de Recursos queaponte para um Web site:<addkey="HomePageObject" value="http://www.ibm.com;Type=URL;

Description=IBM;AllowOverwrite=true"/>

Definindo as Configurações de Inicialização e Aparência doIBM Cognos TM1 Web

É possível controlar a aparência da área de janela de Navegação, da barra de guiase das barras de ferramentas Planilha da Web e Cubeviewer quando os usuáriosefetuam login no IBM Cognos TM1 Web.

Esses parâmetros estão localizados no arquivo tm1web_config.xml e se aplicamglobalmente a todos os usuários do IBM Cognos TM1 Web.

Nota: Para obter detalhes sobre como usar o parâmetro HomePageObject paraconfigurar uma página inicial customizada, consulte “Configurando uma PáginaInicial Customizada do IBM Cognos TM1 Web” na página 126.

Parâmetro NavTreeHiddenO parâmetro NavTreeHidden determina se a área de janela de Navegação seráexibida quando os usuários efetuarem login no IBM Cognos TM1 Web.

Isto pode ser útil se você estiver exibindo uma página inicial customizada parausuários e desejar ocultar totalmente a área de janela de Navegação.

O parâmetro HomePageObject usa o seguinte formato no arquivotm1web_config.xml:<add key="NavTreeHidden" value="false;AllowOverwrite=true"/>

em que:

value pode ser true ou falsev Se configurado como false, a área de janela de Navegação será exibida quando

os usuários efetuarem login no IBM Cognos TM1 Web.v Se configurado como true, a área de janela de Navegação não será exibida

quando os usuários efetuarem login no IBM Cognos TM1 Web.


AllowOverwrite pode ser definido como true ou false, da seguinte forma:v Se você configurar o AllowOverwrite=true, o parâmetro NavTreeHidden será

designado globalmente para todos os usuários, mas poderá ser substituído porclientes individuais usando o diálogo Configurações do Cliente no Architext eServer Explorer.

v Se você configurar o AllowOverwrite=false, o parâmetro NavTreeHidden seaplicará globalmente a todos os usuários do TM1 e não poderá ser substituídopor clientes individuais usando o diálogo Configurações do Cliente no Architecte Server Explorer.

Parâmetro NavTreeCollapsedOnStartO parâmetro NavTreeCollapsedOnStart determina se a área de janela deNavegação será minimizada ou expandida quando os usuários efetuarem login. Sereduzida, será exibida uma pequena barra vertical para fornecer ao usuário umamaneira de restaurar a área de janela.

O parâmetro NavTreeCollapsedOnStart usa o formato a seguir no arquivotm1web_config.xml:<add key="NavTreeCollapsedOnStart" value="false;AllowOverwrite=true"/>

em que:

value pode ser true ou false.v Se o valor for configurado como false, a área de janela de Navegação será

expandida e exibida em seu modo padrão quando os usuários efetuarem loginno IBM Cognos TM1 Web.

v Se o valor for configurado como true, a área de janela de Navegação seráreduzida quando os usuários efetuarem login no IBM Cognos TM1 Web.

AllowOverwrite pode ser definido como true ou false, da seguinte forma:v Se você configurar o AllowOverwrite=true, o parâmetro

NavTreeCollapsedOnStart será designado globalmente para todos os usuários,mas poderá ser substituído por clientes individuais usando o diálogoConfigurações do Cliente no Explorer do Architext e do Server do TM1 .

v Se você configurar o AllowOverwrite=false, o parâmetroNavTreeCollapsedOnStart se aplicará globalmente a todos os usuários do TM1 enão poderá ser substituído por clientes individuais usando o diálogoConfigurações do Cliente no Explorer do Architect e do Server do TM1 .

Parâmetro HideTabBarO parâmetro HideTabBar determina se o IBM Cognos TM1 Web poderá exibirvárias guias quando um usuário abrir vários objetos do IBM Cognos TM1 Web, ouse apenas uma visualização será exibida.

Isto pode ser útil se você desejar limitar os usuários a uma visualização de cadavez.


O parâmetro HideTabBar usa o formato a seguir no arquivo tm1web_config.xml:<add key="HideTabBar" value="false;AllowOverwrite=true"/>

em que value pode ser true ou false.v Se value for definido como false, várias guias poderão ser exibidas. Este é o

comportamento padrão do IBM Cognos TM1 Web.v Se value for definido como true, várias guias não serão exibidas e apenas um

objeto poderá ser aberto de cada vez.

A opção AllowOverwrite não é usada no momento para este parâmetro.

Parâmetro HideWebsheetToolBarO parâmetro HideWebsheetToolBar determina se a barra de ferramentas daplanilha da Web será exibida quando os usuários abrirem uma planilha da Web.

O parâmetro HideWebsheetToolBar usa o formato a seguir no arquivotm1web_config.xml:<add key="HideWebsheetToolBar" value="false;AllowOverwrite=true"/>

em que value pode ser true ou false.v Se o valor for configurado como false, a barra de ferramentas da planilha da

Web será exibida no IBM Cognos TM1 Web.v Se o valor for configurado como true, a barra de ferramentas da planilha da Web

não será exibida no IBM Cognos TM1 Web.


Parâmetro HideCubeviewerToolBarO parâmetro HideCubeviewerToolBar determina se a barra de ferramentas deCubeviewer será exibida quando os usuários abrirem uma visualização do cubo.

O parâmetro HideCubeviewerToolBar usa o formato a seguir no arquivotm1web_config.xml:<add key="HideCubeviewerToolBar" value="false;AllowOverwrite=true"/>

em que value pode ser true ou false.v Se o valor for configurado como false, a barra de ferramentas da planilha da

Web será exibida no IBM Cognos TM1 Web.v Se o valor for configurado como true, a barra de ferramentas da planilha da Web

não será exibida no IBM Cognos TM1 Web.


Exemplo do Parâmetro HideTabBar Configurado como false

Figura 7. Exemplo do parâmetro HideTabBar


Exibindo ou Ocultando o Nó de Visualizações na Área de Janelade NavegaçãoÉ possível exibir ou ocultar o nó de Visualizações na área de janela de Navegação.

Procedimento1. Edite tm1web_config.xml no diretório virtual do IBM Cognos TM1 Web.2. Localize NavTreeDisplayServerView, que controla a exibição do nó de

Visualização do Servidor. O valor-padrão, Y, exibe o nó de Visualizações naárea de janela de Navegação.

<add key="NavTreeDisplayServerView" value="Y" />

3. Para ocultar o nó de Visualizações, altere o valor de NavTreeDisplayServerViewpara N.

4. Salve tm1web_config.xml.5. Efetue login no IBM Cognos TM1 Web.

Agora a área de janela de Navegação é exibida sem o nó de Exibição.

Alterando o Tamanho de Página do Cube ViewerÉ possível alterar o número de linhas e colunas exibidas no Cube Viewer do TM1 oIBM Cognos TM1 .

Por parão, o Web Cube Viewer exibe as páginas dos dados do TM1 com 20 colunase 100 linhas e inclui a lista de dimensões na contagem de linhas.

Procedimento1. Edite tm1web_config.xml.2. Localize o seguinte código:

CubeViewerRowPageSize

CubeViewerColumnPageSize

3. Altere o valor para o tamanho de página de linha e/ou coluna.4. Salve tm1web_config.xml.5. Efetue login no IBM Cognos TM1 Web.

Por exemplo, se você definir o tamanho de página de linha como 10, o CubeViewer exibirá nove linhas de dados, mais a linha de dimensões.

Definindo o Número Máximo de Planilhas a Serem Exportadasde um Cube Viewer

Por padrão, o número máximo de planilhas que podem ser exportadas de umCube Viewer para uma impressora é de 100. É possível configurar o IBM CognosTM1 Web para exportar mais planilhas.

Procedimento1. Edite tm1web_config.xml.2. Localize o seguinte código:

MaximumSheetsForExport

3. Altere o valor para o número máximo de planilhas a serem exportadas.4. Salve tm1web_config.xml.5. Efetue login no IBM Cognos TM1 Web.

Agrupando Valores de Sequência nas Visualizações do CuboUse CubeviewerStringWrap para configurar os parâmetros usados ao visualizar ascélulas do elemento de sequência em uma Visualização do Cubo da Web.

Para controlar a maneira pela qual uma visualização é exibida e agrupada,configure os valores usando o parâmetro CubeviewerStringWrap e salve o arquivode configuração da web. As células que não são exibidas ainda são editáveis emuma área rolável ao clicar na região agrupada.

AtivadoLigue ou desligue o agrupamento das células de sequência nestavisualização. Quando configurado como "False", a largura da coluna serácorrespondente à maior sequência para qualquer linha na visualizaçãoatual. Configure como "True" por padrão para ligar o agrupamento usandoesses parâmetros padrão.

MinCharactersToWrapConfigure o número mínimo de caracteres necessários antes doagrupamento. Por exemplo, os valores de sequência com menos de 50caracteres não serão agrupados em uma célula. Configure para 50, porpadrão.

MaxDisplayCharactersConfigure o número máximo de caracteres a ser exibido na célula desequência. A célula pode conter mais do que esse número de caracteres,mas eles serão exibidos apenas ao clicar duas vezes na célula. Se oMinCharactersToWrap for 50 e o MaxDisplayCharacters for 200, as célulasde sequência que contêm 200 caracteres ou mais consumirãoaproximadamente 4 linhas. Configure para 200, por padrão.

WidthOfWrapCellConfigure o número de caracteres usados na parte agrupada da exibição.Configure para 240, por padrão.

Use o formato a seguir no arquivo tm1web_config.xml (a lista a seguir possui umretorno nele para clareza, mas esse retorno não deve ser inserido).<add key="CubeviewerStringWrap" value="Enabled=true;MinCharactersToWrap=50;MaxDisplayCharacters=200;WidthOfWrapCell=240" />

Lembre-se: CubeviewerStringWrap não se aplica às planilhas da web.

Configuração do Navegador da Web para o Cognos TM1 WebEssa seção descreve as etapas de configuração do navegador da web para o IBMCognos TM1 Web que podem ser necessárias para o ambiente após a conclusão dainstalação inicial.

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.

Configurando o Idioma do Navegador da Web para CognosTM1 Web

As configurações de idiomas no navegador da web determinam qual idioma seráusado na interface do IBM Cognos TM1 Web.


Sobre Esta Tarefa

Siga essas etapas gerais para configurar o Microsoft Internet Explorer e MozillaFirefox para exibir o IBM Cognos TM1 Web em seu idioma principal. Para obterinformações mais detalhadas, consulte a documentação do navegador da web.

Procedimento1. Dependendo de qual navegador da web você está usando, use as opções de

idioma disponíveis para selecionar e configurar seu idioma principal.v No Internet Explorer, as opções de idiomas geralmente estão localizadas no

menu Ferramentas > Opções de Internet > Geral > Idiomas.v No Firefox, as opções de idiomas geralmente são localizadas no menu

Ferramentas > Opções > Conteúdo > Idiomas.2. Inclua seu idioma para a lista de idiomas.3. Organize a lista de forma que seu idioma de preferência esteja na parte

superior da lista.

Exibindo e Inserindo Números no Cognos TM1 Web com Baseem Configurações Regionais

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 do Navegador da Web para Cognos TM1 Web” na página99.

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


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

É possível instalar os componentes do servidor de aplicativos da web para o IBMCognos TM1 em um computador dedicado separado para que os usuários em umambiente de rede possam acessar o programa. Estes componentes incluem oCognos TM1 Application 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 Application Server,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 do WebSphere Application Server

Para obter detalhes sobre a arquitetura e implementação do Cognos TM1Application Server, consulte:v “Arquitetura do Cognos TM1 Applications” na página 33v “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 Application Server com oApache Tomcat fornecido” na página 140.

Implementando em seu Próprio Servidor de Aplicativos da Web

Para implementar o Cognos TM1 Application 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 do aplicativo da web pmpsvc.war e, emseguida, implemente manualmente o arquivo.

Para obter detalhes, consulte os seguintes tópicos:v “Instale o Cognos TM1 Application Server com sua própria instalação do

servidor de aplicativos da web do Apache Tomcat” na página 150v “Instale o Cognos TM1 Application Server com sua própria instalação do IBM

Websphere” na página 153

Cognos TM1 Application Server com x64 Windows

Ao executar o Cognos TM1 Application Server em um sistema Microsoft Windowsx64 com Apache Tomcat, use as mesmas versões 32 bits ou 64 bits do Java RuntimeEnvironment (JRE) e do servidor da web Apache Tomcat. Não misture versões deplataformas. Por exemplo, se estiver usando a versão de 64 bits do JRE, vocêtambém deverá usar a versão de 64 bits do Apache Tomcat.


Integrando o Cognos TM1 Application Server com o Cognos BI eo portal do Cognos Connection

Se a sua instalação do TM1 usar a segurança do Cognos para autenticação, osusuários do Cognos BI poderão usar o portal do Cognos Connection para abrir osaplicativos do TM1 em vez do portal do TM1 Applications Web. No entanto, osadministradores ainda precisam usar o TM1 Applications Web para configurar egerenciar os aplicativos.

Ao configurar o TM1 Application Server para utilizar a segurança do Cognos, vocêtambém permitirá que o portal do Cognos Connection exiba uma pasta contendoos links para os aplicativos disponíveis do TM1. A lista exata dos aplicativosexibidos depende dos direitos do usuário atual.

O arquivo planning.html fornece as informações para o Cognos BI e o portal doCognos Connection para exibir os links para aplicativos do TM1. Para obter maisinformações, consulte “Usando o Cognos TM1 Applications com a Segurança doCognos” na página 228.

Instalando o Cognos TM1 Application Server com o Apache Tomcatfornecido

É possível instalar o Cognos TM1 Application Server em um computador separadoe implementá-lo com a instância do Apache Tomcat que é fornecida com ainstalaçã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 os componentes da camada de aplicativos CognosTM1

Este tópico fornece as etapas para instalar os arquivos necessários para o IBMCognos TM1 Application Server e seus componentes em um computador separado.

Sobre Esta Tarefa

Use um dos programas de instalação a seguir para instalar os componentes dacamada de aplicativos do Cognos TM1:v IBM Cognos TM1 32 Bits para Windowsv IBM Cognos TM1 64 Bits para Windows

Lembre-se: Se você planeja usar o cliente Cognos TM1 Web, será necessária umainstalação do Cognos TM1 Web no mesmo computador ou em um computadordiferente em sua rede. Para instalar o Cognos TM1 Web em um computadordiferente, consulte Capítulo 10, “Instalação do Cognos TM1 Web”, na página 115

Procedimento1. No software do sistema operacional Microsoft Windows Vista, Windows 7 ou

Windows Server 2008, clique com o botão direito no arquivo issetup.exe eclique em Executar como Administrador. Para outros sistemas operacionais, dêum clique duplo no arquivo issetup.exe.

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

3. 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 e o Cognos TM1 Application Server.


Configuration.Se você instalou o produto a partir do diretório Arquivos de Programas (x86)em um computador executando o software do sistema operacional WindowsVista, Windows 7 ou Windows 2008, inicie o IBM Cognos Configuration comoAdministrador.

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 Cognos TM1 Application Server.

3. Clique em Arquivo > Salvar e feche IBM Cognos Configuration.

Configurando a segurança de autenticação para o CognosTM1 Application Web

Para os servidores IBM Cognos TM1 usados com o Cognos TM1 Application Web,use a autenticaçã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 Application Web é compatível com os modos de autenticação desegurança do TM1 a seguir: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 Application Web.

Para obter uma melhor prática, determine o modo de segurança antes deconfigurar o Cognos TM1 Application Web para usar um servidor Cognos TM1 euse esse mesmo modo 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:

Capítulo 11. Instalação do Cognos TM1 Application Server 141

v “Segurança da Autenticação” na página 193v “IntegratedSecurityMode” na página 293

Procedimento1. Abra o arquivo TM1 server data directory/Tm1s.cfg

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


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

página 228v “Usando a Segurança do Cognos com o Cognos TM1” na página 219

3. Salve e feche o arquivo Tm1s.cfg.4. Reinicie o servidor Cognos TM1.5. Repita estas etapas para qualquer outro servidor Cognos TM1 que deseja usar

com o Cognos TM1 Application Web.

Configurando o ambiente do servidor e do cliente para oCognos TM1 Application Web

Antes de usar o IBM Cognos TM1 Application Web, é necessário especificar oCognos TM1 Admin Host, o Cognos TM1 Server e as interfaces com o usuário docliente que você deseja usar. Na primeira vez em que o Cognos TM1 ApplicationWeb é iniciado, o programa solicita que você configure estas opções.

Antes de Iniciar

Assegure-se de que o TM1 Admin Server e pelo menos um servidor TM1 esteja emexecução no computador local ou em um computador remoto que possa seracessado.

Certifique-se de que cada servidor TM1 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 TM1Application Web” na página 146.

Se você planeja usar o Cognos TM1 Application Web, certifique-se de saber o nomedo servidor da web e o número da porta em que o Cognos TM1 Web está emexecução.

Procedimento1. Inicie e efetue login no Cognos TM1 Application Web:

a. Em um navegador da web, digite a URL para o Cognos TM1 ApplicationWeb: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 Application Web foi iniciado

desde a instalação, a página Configuração será aberta.


v Se o Cognos TM1 Application Web já tiver sido configurado, serãosolicitados um nome de usuário e senha e, em seguida, será possível abrir apágina de configuração clicando no botão Administrar IBM Cognos TM1

Applications na barra de ferramentas da página principal do CognosTM1 Application Web.

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 servidor TM1 que deseja usarcom o Cognos TM1 Application Web.Por exemplo, é possível especificar a amostra do servidor TM1GO_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 Application Web.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 TM1.v Incluir Cognos Insight - Distribuído - Cliente IBM Cognos Insight com

processamento local de dados. Os dados são atualizados para o servidorTM1 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.Essa URL aponta para o arquivo Contributor.jsp no servidor da web que estáhospedando o Cognos TM1 Web.Por exemplo:http://WebServer:9510/tm1web/Contributor.jsp

em 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 Application Web é exibida. Esta páginaaparece em branco até você construir e implementar aplicativos dentro doCognos TM1 Application Web. Para obter mais detalhes, consulte adocumentação do IBM Cognos 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 ApplicationWeb:

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 TM1Application Web” na página 146.

Configurações do Cognos TM1 Application Server no CognosConfiguration

É possível definir as configurações para o Cognos TM1 Application Server noCognos Configuration.

No Cognos Configuration, clique em Ambiente > TM1 Application Server.

Tempo limite de sessão (min)Tempo após o qual o TM1 Server se desconecta se não ocorrer nenhumaatividade. O padrão é 60 minutos.

Forçar caminhos qualificadosQuando configurado como Verdadeiro, um nome de máquina que éfornecido como o Host Admin resolve para um nome completo dodomínio. Quando configurado como Falso, apenas o nome da máquina éusado.

Provedor de notificações

v DLS (Serviço de Entrega): Se um servidor de correio for configurado,emails serão enviados, mas nenhuma notificação será exibida na caixa deentrada do Cognos.

v HTS (Serviço de Tarefa Manual): Notificações são enviadas para a caixade entrada do Cognos; os emails também são enviados se um servidorde correio estiver configurado.

Por padrão, é deixado em branco para não receber notificações.

Ativar ponto de visualização de negóciosVerdadeiro significa que o Ponto de Visualização de Negócios podeinteragir com essa instalação. Falso impede que o Ponto de Visualização deNegócios interaja.

Nome da pasta do Cognos ConnectionEspecifica o nome da pasta do Cognos Connection na qual os hyperlinkspara os aplicativos TM1 implementados estão contidos. O padrão é IBMCognos TM1 Application - Meus Aplicativos

URI do despachante do TM1 Application ServiceO URI usado para o servlet de dispatcher, por exemplohttp://localhost:9510/pmpsvc/dispatcher/servlet

ID do usuário e senhaID do Usuário e Senha utilizados para autenticação.

Em TM1 Application Server, clique com o TM1 Clients.


URI de fornecimentoEspecifica um URI para ser usado para configurar manualmente os locaisdo msi.

Permitir instalações provisionadasVerdadeiro permite que os usuários sem os clientes instalados provisioneme instalem a partir do TM1 Application Server. Falso bloqueia os usuáriosde provisionar e instalar o software cliente.

Permitir atualizações provisionadasVerdadeiro permite que as atualizações que estão instaladas no TM1Application Server, como uma versão de Fix Pack, sejam fornecidas para osclientes quando os usuários se conectarem da próxima vez. Falso impedeque as atualizações sejam fornecidas.

Ativar publicação a partir do Cognos InsightVerdadeiro permite que um usuário com direitos do Administradorpublique a partir do Cognos Insight. Falso desaprova a operação depublicação para todos os usuários.

Frequência de ping do Cognos Insight (segundos)Determina com que frequência o Cognos Insight verifica a conectividadecom o TM1 Application Server. Se o Cognos Insight não receber qualquerresposta enquanto estiver no modo distribuído, ele será colocadoimplicitamente no modo offline. O padrão é 30 segundos.

Determinando o link de Inicialização da URL para o Cognos TM1Application Web

O link exato para iniciar e efetuar logon no Cognos TM1 Application Web dependede qual servidor da web você está executando e como ele é configurado.

É possível ver a URL de inicialização padrão para o Cognos TM1 Application Webno IBM Cognos Configuration.1. Abra o Cognos Configuration.2. Clique para expandir Configuração Local > Ambiente e, em seguida, selecione

TM1 Application Server.3. A URL é listada na coluna de valor para o campo URI do TM1 Application

Server Gateway.Por exemplo: http://localhost:9510/pmpsvc

Parâmetros de Link

Use o formato a seguir para a URL para efetuar login no Cognos TM1 ApplicationWeb.

https://WebServer:PortNumber/pmpsvc


Tabela 17. Cognos TM1 Application Web - Parâmetros da URL

Parâmetro Descrição

WebServer Pode ser um dos seguintes:

A palavra-chave localhost se você estiver atualmente com loginefetuado no servidor da web que está executando o Cognos TM1Application Server.

O nome da máquina ou o nome de domínio do servidor da webque hospeda o Cognos TM1 Application Server.

O endereço IP do servidor da web que hospeda o Cognos TM1Application Server.

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 18. Cognos TM1 Application Web - 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 Application Web com o ApacheTomcat é:

http://localhost:8085/pmpsvc

IBM WebSphereApplication Server

O link usual para o Cognos TM1 Application Web em execução noIBM WebSphere Application Server é:

https://localhost:8443/pmpsvc

Configurando um Cognos TM1 Server para trabalhar com o CognosTM1 Application Web

Antes de usar o IBM Cognos TM1 Server com o IBM Cognos TM1 ApplicationWeb, edite o arquivo de configuração do TM1 Server para incluir os parâmetros evalores necessários.

Sobre Esta Tarefa

Os seguintes parâmetros de configuração no arquivo Tm1s.cfg do Cognos TM1Server suportam diferentes subcomponentes do Cognos TM1 Application Web.v Parâmetro AllowSeparateNandCRules - suporta o Cognos TM1 Performance

Modeler com o Cognos TM1 Application Web.


Consulte o “AllowSeparateNandCRules” na página 274.v Parâmetro DistributedPlanningOutputDir - suporta o Cognos Insight - o cliente

distribuído com o Cognos TM1 Application Web.Consulte o “DistributedPlanningOutputDir” na página 288.

v Parâmetro ForceReevaluationOfFeedersForFedCellsOnDataChange - suporta oCognos TM1 Performance Modeler com o Cognos TM1 Application Web.Quando este parâmetro é configurado, uma instrução do alimentador é forçada aser reavaliada quando os dados mudam.Consulte o “ForceReevaluationOfFeedersForFedCellsOnDataChange” na página291.

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. Edite ou inclua o parâmetroForceReevaluationOfFeedersForFedCellsOnDataChange.

5. Salve o arquivo Tm1s.cfg.6. Reinicie o servidor Cognos TM1.7. Repita estas etapas para qualquer outro servidor Cognos TM1 que você deseja

usar com o Cognos TM1 Application Web.

Configurando o IBM Cognos TM1Application WebIBM Cognos TM1 uses IBM Cognos TM1 Web para suportar o cliente Cognos TM1Application Web. O Cognos TM1 Application Web permite que os usuáriosvisualizem e editem dados do aplicativo de planejamento no formato de grade. Sedesejar permitir que os usuários usem o Cognos TM1 Application Web, seránecessário configurar esta opção.

Sobre Esta Tarefa

Ao instalar o Cognos TM1 Web, os arquivos necessário para o Cognos TM1Application Web serão copiados para o local de instalação do Cognos TM1 Web.

O arquivo principal para o Cognos TM1 Application Web é:

Contributor.jsp

O local de instalação padrão é:

TM1_install_location\webapps\tm1web

Configure o parâmetro URL do Cognos TM1 Application Web no Cognos TM1Application Web para apontar para o arquivo Contributor.jsp neste local.

Procedimento1. Abra a página Configuração no Cognos TM1 Application Web:


v Se estiver executando o Cognos TM1 Application Web pela primeira vez, usea página Configuração que é aberta quando o programa é iniciado.Para obter detalhes adicionais, consulte “Configurando o ambiente doservidor e do cliente para o Cognos TM1 Application Web” na página 142.

v Se você já estiver usando o Cognos TM1 Application Web, poderá reabrir apágina Configuração clicando no botão Administrar IBM Cognos TM1

Applications na barra de ferramentas no Cognos TM1 Application Web.2. No campo URL do TM1 Application Web, insira o local da URL do arquivo

Contributor.jsp.Use o formato:http://WebServer:port_number/tm1web/Contributor.jsp

Por exemplo:http://webserver.example.com:9510/tm1web/Contributor.jsp

3. Clique em OK. A página de login para o Cognos TM1 Application Web seráexibida.

Criação de Log do Cognos TM1 Application ServerÉ possível monitorar a atividade e o desempenho do IBM Cognos TM1 ApplicationServer configurando e visualizando o arquivo de log do TM1 Application Server.

O Cognos TM1 Application Server usa a estrutura log4j para controlar a criação delog dos serviços de planejamento (pmpsvc). As configurações de criação de log sãodinâmicas - as mudanças feitas no arquivo de propriedade de criação de log serãodetectadas enquanto o serviço estiver em execução.

Arquivo de Propriedade de Criação de Log

A criação de log é configurada no arquivo a seguir:

<tm1_installation_location>\webapps\pmpsvc\WEB-INF\configuration\log4j.properties

Por exemplo, o local de instalação padrão em um sistema Microsoft Windows de32 bits é:

C:\Program Files\IBM\cognos\tm1\webapps\pmpsvc\WEB-INF\configuration\

Em um sistema Windows de 64 bits:

C:\Program Files\IBM\cognos\tm1_64\webapps\pmpsvc\WEB-INF\configuration\

Saída do Arquivo de Log

Por padrão, o serviço é configurado para registrar apenas mensagens de ERRO emum arquivo de texto contendo todas as entradas de log por um período de 24horas. O arquivo de log e o diretório localizam-se aqui:

<tm1_installation_location>\webapps\pmpsvc\WEB-INF\logs\pmpsvc.log

Os arquivos de log mais antigos para dias anteriores são nomeados com o formato:

pmpsvc.log.YYYY-MM-DD


Níveis de Mensagem de Arquivo de Log

Há quatro níveis de detalhes que podem ser registrados. Cada nível contém todasas entradas de log para esse nível e cada nível superior.

Tabela 19. Descrição de nível

Nível Descrição

ERROR Resulta eventos excepcionais que fazem com que o serviço não sejacapaz de concluir a operação atual.

WARNING Resulta condições a partir das quais o serviço pode continuar, masdevem ser solucionadas por um administrador.

INFO Resulta informações para cada uma das operações de serviço.

DEPURAÇÃO Resulta informações de rastreio de detalhes para as operações deserviço.

Exemplos de Ativação de Criação de Log

O nível de criação de log de informações é controlado alterando o nível sob asseguintes duas raízes de serviço:v log4j.logger.com.ibm.cognos

v log4j.logger.com.cognos

Todos os componentes do serviço são situados abaixo dessas árvores, portanto, aalteração do nível de criação de log para elas registrará todos os eventos nessenível.

Por exemplo, para alterar o serviço para registrar no nível INFO, altere essasentradas para o seguinte:#System logging settingslog4j.rootLogger=ERROR, TextFilelog4j.logger.com.ibm.cognos=INFOlog4j.logger.com.cognos=INFO

A criação de log mais específica está disponível alterando o nível de criação de logpara as classes inferiores a esses níveis superiores. Por exemplo, é possível obter acriação de log AVISO para tudo, menos para registrar chamadas de processos doTurboIntegrator no nível DEBUG.#System logging settingslog4j.rootLogger=ERROR, TextFilelog4j.logger.com.ibm.cognos=WARNINGlog4j.logger.com.cognos=WARNINGlog4j.logger.com.ibm.cognos.pmpsvc.handler.util.PmtaProcessUtil=DEBUG

É possível ativar o desempenho da criação de log no serviço comentando a criaçãode log padrão e incluindo as seguintes entradas de desempenho no arquivo depropriedades:# System logging settings#log4j.rootLogger=ERROR, Console, TextFile#log4j.logger.com.ibm.cognos=DEBUG#log4j.logger.com.cognos=DEBUG#log4j.logger.com.cognos.org=ERROR#log4j.logger.com.ibm.cognos.perf=ERROR

# Performance logging settingslog4j.rootLogger=ERROR, perfConsole, perfTextlog4j.logger.com.ibm.cognos.perf=DEBUG


Nota: Também é possível monitorar o TM1 Application Server usando o TM1Operations Console. Consulte o Guia do IBM Cognos TM1 Operations Console.

Instalação e configuração avançadas do Cognos TM1 ApplicationServer

É possível executar tarefas de instalação e configuração avançadas para customizarsua instalação dos componentes do IBM Cognos TM Application Server.

Instale o Cognos TM1 Application Server com sua própriainstalação do servidor de aplicativos da web do ApacheTomcat

Esta seção descreve como instalar o Cognos TM1 Application Server em umcomputador separado e implementá-lo com sua própria instalação do ApacheTomcat.

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.

Construindo arquivos de aplicativo para um servidor TomcatUse o IBM Cognos Configuration para construir os arquivos 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 porseu servidor de aplicativos, consulte a documentação para seu servidor deaplicativos.


Configuration.2. Clique em Ação > Construir Arquivos de Aplicativo.3. Em Aplicativos, selecione TM1 Application Server.4. Marque o tipo de servidor de aplicativos Apache Tomcat. Clique em Avançar.5. Selecione o tipo de arquivo e o local para salvar os arquivos. O local padrão é

<your installation location>\ibm\cognos\TM1\.Clique em Avançar.6. Aguarde o Assistente para Construção de Aplicativo concluir o processo.

Clique em Concluir.

O que Fazer Depois

É possível implementar o arquivo de aplicativo em seu servidor de aplicativos.

Configurando a segurança de autenticação para o Cognos TM1Application WebPara os servidores IBM Cognos TM1 usados com o Cognos TM1 Application Web,use a autenticação de segurança padrão do TM1 ou a segurança do IBM Cognos.


Sobre Esta Tarefa





Para obter mais detalhes sobre autenticação de segurança e o parâmetroIntegratedSecurityMode, consulte:v “Segurança da Autenticação” na página 193v “IntegratedSecurityMode” na página 293









Configurando o ambiente do servidor e do cliente para o CognosTM1 Application WebAntes de usar o IBM Cognos TM1 Application Web, é necessário especificar oCognos TM1 Admin Host, o Cognos TM1 Server e as interfaces com o usuário docliente que você deseja usar. Na primeira vez em que o Cognos TM1 ApplicationWeb é iniciado, o programa solicita que você configure estas opções.

Antes de Iniciar









desde a instalação, a página Configuração será aberta.v Se o Cognos TM1 Application Web já tiver sido configurado, serão

solicitados um nome de usuário e senha e, em seguida, será possível abrir apágina de configuração clicando no botão Administrar IBM Cognos TM1








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.


Essa URL aponta para o arquivo Contributor.jsp no servidor da web que estáhospedando o Cognos TM1 Web.Por exemplo:http://WebServer:9510/tm1web/Contributor.jsp



Login.


Resultados




Instale o Cognos TM1 Application Server com sua própriainstalação do IBM Websphere

Esta seção descreve como instalar o Cognos TM1 Application Server em umcomputador separado e implementá-lo com sua própria instalação do IBMWebSphere.

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.

Para implementar o TM1 Application Server para o WebSphere, conclua estastarefas:v Construa os arquivos de aplicativo usando o Cognos Configuration. Consulte o

“Construindo arquivos de aplicativo para um servidor IBM WebSphere”. Umarquivo pmpsvc.war foi criado. O local padrão é <your installationlocation>\ibm\cognos\TM1\.

Nota: É possível utilizar o formato de arquivo EAR em vez de WAR.v Implemente o arquivo pmsvc.war ao WebSphere Application Server

Construindo arquivos de aplicativo para um servidor IBMWebSphereUse o IBM Cognos Configuration para construir arquivos de aplicativo paraimplementar em um servidor IBM WebSphere.


Sobre Esta Tarefa

É possível criar um arquivo web archive (WAR) ou arquivo archive corporativo(EAR) para os seguintes aplicativos do TM1:v TM1 Planning Services: pmpsvc.war/earv TM1 Web e TM1 Applications Web tm1web.war/ear

v IBM Performance Management Hub e TM1 Operations Console: pmhub.war/ear

É possível, então, implementar os arquivos WAR ou EAR para o WebSphere.


Configuration.2. Clique em Ações > Construir Arquivos de Aplicativo.3. Em Aplicativos, selecione TM1 Application Server.4. Em Tipo de Servidor de Aplicativos, selecione IBM Websphere. Clique em

Avançar.5. Selecione o tipo de arquivo.6. Especifique onde salvar os arquivos de aplicativo. O local padrão é <your

installation location>\ibm\cognos\TM1\.Clique em Avançar.7. Aguarde o Assistente para Construção de Aplicativo concluir o processo.

Clique em Concluir.

O que Fazer Depois

É possível implementar os arquivos de aplicativo para o WebSphere ApplicationServer. Consulte “Implementando o TM1 Application Server em um IBMWebSphere Application Server”, “Instalando o TM1 Web com o IBM WebSphere”na página 118 e “Instalando o Cognos TM1 Operations Console no IBMWebSphere” na página 109.

Implementando o TM1 Application Server em um IBM WebSphereApplication ServerÉ possível implementar e executar o IBM Cognos TM1 Application Server em umIBM WebSphere Application Server.


No Microsoft Windows, clique em Iniciar > Todos os Programas > IBMWebSphere Application Server > Perfis > [Nome do Perfil] > Iniciar oservidor.Uma janela de comando será aberta e exibirá o progresso inicial. Depois que oprocesso inicial for concluído, a janela de comandos exibirá a mensagem,"Servidor iniciado." É possível minimizar esta janela de comando, mas nãofechá-la. Esta janela deve permanecer aberta enquanto o WebSphere está emexecução.

v Desenvolva os arquivos de aplicativo usando o Cognos Configuration. Consulteo “Construindo arquivos de aplicativo para um servidor IBM WebSphere” napágina 153.



Sobre Esta Tarefa



Procedimento1. Verifique se você tem um espaço livre em disco mínimo de 6 GB no

computador em que o WebSphere está instalado.No UNIX, certifique-se de que o disco montado em /tmp possui pelo menos 6GB disponíveis. Use o df para verificar o total de espaço e de porcentagemutilizada para tmpfs.

Nota: Não implemente o TM1 Application Server até ter verificado se oespaço em disco suficiente está disponível.

2. Abra o console administrativo do WebSphere.v No Windows, clique em Iniciar > Todos os Programas > IBM WebSphere

Application Server > Perfis > [Nome do Perfil] > Console administrativo.Ou acesse https://localhost:9043/ibm/console/.



4. Configure o tamanho da memória da pilha da JVM.a. Clique em Servidores > Tipos de Servidor > WebSphere application

Servers.b. Clique no servidor em que você está implementando o TM1 Application

Server.c. Na Infraestrutura do Servidor, clique em Java e Gerenciamento de

Processo > Definição de Processo.d. Em Propriedades Adicionais, clique em Java Virtual Machine.e. No campo Argumentos Genéricos da JVM, inclua -Xmso512k.

PERIGO

Não implemente o TM1 Application Server até ter configurado amemória da pilha.

Não use o arquivo startServer.sh para configurar o tamanho da memóriada pilha. O WebSphere remove a configuração do -Xmso do arquivoquando o servidor inicia e o substitui com o valor padrão, que é muitopequeno.

f. Clique em Aplicar e, em seguida, clique em OK . Clique em Salvar.5. Clique em Aplicativos > Novo Aplicativo e, em seguida, clique em Novo

Aplicativo Corporativo.


6. Clique em Navegar para localizar e selecionar o arquivo pmpsvc.war que vocêgerou utilizando o comando Build Application File no Cognos Configuration.Clique em Abrir.

7. Clique em Avançar.8. Clique em Fast Path e, em seguida, clique em Avançar.9. Clique em Etapa 4: Mapear raízes de contexto para módulos da web.

10. Na caixa Raiz de Contexto, insira /pmpsvc. Clique em Avançar.11. Clique em Concluir. O WebSphere instala o aplicativo. Esse processo pode

demorar alguns minutos para ser concluído.Quando a instalação for concluída, o WebSphere exibirá "Applicationpmpsvc_war instalado com sucesso."

12. Clique em Salvar.13. Clique em Aplicativos > Tipos de Aplicativo > Aplicativos Corporativos

WebSphere.14. Marque a caixa de seleção próxima a pmpsvc_war e, em seguida, clique em

Iniciar. O WebSphere exibe "Aplicativo pmpsvc_war no servidor server_name enó nó iniciado com sucesso. A coleta pode precisar ser atualizada para mostraro status atual."

Resolução de problemas da implementação do TM1 Application Server no IBMWebSphere:

Se a implementação do TM1 Application Server (pmpsvc.war) falhar com umamensagem de erro de espaço de heap Java, tente ajustar os parâmetros Java noconsole administrativo do WebSphere.

Nota: Pode ser necessário reaplicar esta mudança se você fizer upgrade oumodificar sua instalação do WebSphere em uma data posterior.

Procedimento

1. Abra o console administrativo do WebSphere.v No Windows, clique em Iniciar > Todos os Programas > IBM WebSphere

Application Server > Perfis > [Nome do Perfil] > Console administrativo.Ou acesse https://localhost:9043/ibm/console/.


2. Efetue login usando o perfil do WebSphere usado para implementar o TM1Application Server. O console administrativo é aberto.

3. Clique em Servidores > Tipos de Servidor > WebSphere application Servers.4. Clique no servidor em que você implementou o TM1 Application Server.5. Na Infraestrutura do Servidor, clique em Java e Gerenciamento de Processo >

Definição de Processo.6. Em Propriedades Adicionais, clique em Java Virtual Machine.7. No campo tamanho inicial de heap, digite 1024.8. No campo Tamanho máximo de heap, digite 2048.9. Clique em Aplicar e, em seguida, clique em OK . Clique em Salvar.

10. Reinicie o WebSphere.


Configurando a segurança de autenticação para o Cognos TM1Application WebPara os servidores IBM Cognos TM1 usados com o Cognos TM1 Application Web,use a autenticação de segurança padrão do TM1 ou a segurança do IBM Cognos.

Sobre Esta Tarefa





Para obter mais detalhes sobre autenticação de segurança e o parâmetroIntegratedSecurityMode, consulte:v “Segurança da Autenticação” na página 193v “IntegratedSecurityMode” na página 293









Configurando o ambiente do servidor e do cliente para o CognosTM1 Application WebAntes de usar o IBM Cognos TM1 Application Web, é necessário especificar oCognos TM1 Admin Host, o Cognos TM1 Server e as interfaces com o usuário docliente que você deseja usar. Na primeira vez em que o Cognos TM1 ApplicationWeb é iniciado, o programa solicita que você configure estas opções.


Antes de Iniciar








desde a instalação, a página Configuração será aberta.v Se o Cognos TM1 Application Web já tiver sido configurado, serão

solicitados um nome de usuário e senha e, em seguida, será possível abrir apágina de configuração clicando no botão Administrar IBM Cognos TM1








v Incluir TM1 Application Web - Cliente Padrão. O processamento é emtempo real com o servidor. Esta opção usa a grade de dados e a


infraestrutura 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.Essa URL aponta para o arquivo Contributor.jsp no servidor da web que estáhospedando o Cognos TM1 Web.Por exemplo:http://WebServer:9510/tm1web/Contributor.jsp



Login.


Resultados




Configurando o Cognos TM1 Application Web para usarvários servidores Cognos TM1

Ao iniciar o IBM Cognos TM1 Application Web pela primeira vez, será possívelinserir somente um servidor Cognos TM1 com o qual deseja trabalhar.

Para inserir servidores adicionais, use a página Configuração no Cognos TM1Application Web.

Importante: Para usar vários servidores Cognos TM1 no Cognos TM1 ApplicationWeb, todos os servidores deverão 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 de usuário administrador e senha. Para obter detalhes, consulte“Considerações de Segurança ao Usar o Cognos TM1 Applications” na página 40.

Depois de incluir vários servidores Cognos TM1, eles estarão disponíveis ao usar oIBM 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 Application Web.2. Na barra de ferramentas, 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 Admin - Especifique o nome do computador ou endereço IP do Host

Admin no qual o Cognos TM1 Admin Server está executando.Clique no botão Atualizar para atualizar a lista Nome do Servidor com osservidores disponíveis para o Host Admin inserido.

v Nome do Servidor - Selecione um servidor Cognos TM1 para usar com oCognos TM1 Application Web. Por exemplo: Amostra de planejamento.

5. Clique em OK.Se você receber uma mensagem de aviso sobre a configuração do TM1 Server,tome nota das advertências e, em seguida, clique em Fechar para continuar.Para obter informações sobre as configurações necessárias, consulte“Configurando um Cognos TM1 Server para trabalhar com o Cognos TM1Application Web” na página 146. O Host Administrativo e o nome do servidorCognos TM1 inseridos são incluí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.

Usando um proxyÉ possível configurar um servidor proxy que redireciona as solicitações a partir dosaplicativos cliente do IBM Cognos TM1 para o TM1 Application Server.

Um servidor proxy (às vezes chamado de um proxy reverso) pode fornecerbenefícios como os seguintes:v Ocultar a existência e as características do servidor de aplicativosv Otimizar o processamento de solicitaçãov Distribuir o carregamentov Executar auditoria front-endv Executar segurança adicional

Além disso, um proxy é necessário quando os domínios internos e as portas doTM1 Application Server não estão disponíveis para acesso direto da Internet, emque os aplicativos cliente do TM1 são utilizados.

Um ambiente de proxy consiste dos componentes a seguir:


v O aplicativo cliente do TM1, como o IBM Cognos Analysis for Microsoft Excel,na Internet

v Servidor proxy, TM1 Application Server e TM1 Server na rede internav Se você estiver usando a segurança do Cognos com o TM1, o servidor Cognos

Business Intelligence na rede interna

Para obter mais detalhes, consulte "Executando o IBM Cognos Analysis forMicrosoft Excel (CAFE) atrás de um servidor proxy" http://www-01.ibm.com/support/docview.wss?uid=swg27045323

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


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


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 dafunção igual a 0. Por exemplo, ExecuteCommand=0 ou ServerShutdown=0.

3. Para permitir que uma função seja executada no modo restrito, configure onome 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 12. Instalação da Camada de Desenvolvedor e deCliente do Cognos TM1

É possível instalar os componentes da camada de desenvolvedor e de cliente doIBM Cognos TM1 usando o programa de instalação do servidor Cognos TM1 ou oprograma de instalação do cliente Cognos TM1.

É possível instalar os seguintes componentes do cliente e do desenvolvedor:v Cognos TM1 Perspectivesv Cognos TM1 Architectv Cognos TM1 Performance Modelerv Cognos Insightv Cognos TM1 APIs

Para obter informações sobre o uso das APIs do TM1 para ativar o relatório doCognos BI com relação a origens de dados do Cognos TM1, consulte o “CognosTM1 como uma Origem de Dados com o Cognos BI” na página 71 e “Ativando oRelatório do Cognos BI nas Origens de Dados do Cognos TM1” na página 71.Conceitos relacionados:“Atualizando os Clientes Cognos TM1 Architect e Perspectives” na página 57É 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 Perspectives, conclua as tarefas a seguir:1. Instale o software que é necessário para a execução do Cognos TM1

Perspectives. Para obter mais informações, consulte “Instalar o SoftwareObrigatório” na página 77.

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 8, “Instalação do Cognos TM1Server”, na página 87.

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 SSL padrão, altere manualmente o valorpara este 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 no arquivoissetup.exe e clique em Executar como Administrador. Para outrossistemas operacionais, dê um clique duplo no arquivo issetup.exe no discode instalação do cliente IBM Cognos TM1 ou a partir do local onde osarquivos de instalação do cliente Cognos TM1 foram transferidos pordownload e extraídos.

b. Na página Seleção de Componente, expanda TM1 Client Tier e marque acaixa de seleção TM1 Perspectives.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. Ative o Server Explorer.5. 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.


6. 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 C, “Configurando Instalações e ConfiguraçõesNão Assistidas”, na página 341.

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 mais informações, consulte “Instalar o Software Obrigatório” na página 77.v Assegure-se de que o Cognos TM1 Admin Server e o Cognos TM1 Server aos

quais deseja se conectar estejam em execução em um computador acessível emsua rede. Para obter detalhes, consulte Capítulo 8, “Instalação do Cognos TM1Server”, na página 87.

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 SSL padrão, altere manualmente o valorpara este 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 do sistema operacional Microsoft Windows Vista, Windows 7ou Windows Server 2008, clique com o botão direito no arquivoissetup.exe e clique em Executar como Administrador. Para outrossistemas operacionais, dê um clique duplo no arquivo issetup.exe no discode instalação do cliente IBM Cognos TM1 ou a partir do local onde osarquivos de instalação do cliente IBM Cognos TM1 foram transferidos pordownload e extraídos.

b. Na página Seleção de Componente, expanda a Camada do Desenvolvedore marque a caixa de seleção TM1 Architect. Deixe todas as outras caixas deseleçã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.

Capítulo 12. Instalação da Camada de Desenvolvedor e de Cliente do Cognos TM1 167

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.d. No campo Host Administrativo, especifique o nome do computador no

qual 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 C, “Configurando Instalações e Configurações NãoAssistidas”, na página 341.

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

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.


Tabela 20. Opções de Instalação de Diversos Computadores para o Cognos TM1Performance Modeler (continuação)


“Instalando o Cognos TM1Performance Modeler do portaldo Cognos TM1 Applications”na página 170

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.

“Instalando Remotamente oCognos TM1 PerformanceModeler em diversosComputadores” na página 170

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. Execute o programa de instalação:


v Para outros sistemas operacionais, dê um clique duplo no arquivoissetup.exe no disco de instalação do cliente IBM Cognos TM1 ou a partirdo local onde os arquivos de instalação do cliente IBM Cognos TM1 foramtransferidos por download e extraídos.

2. Na página Seleção de Componente, expanda a Camada do Desenvolvedor emarque a caixa de seleção Modelador de Desempenho. Deixe todas as outrascaixas 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 da

barra de ferramentas da página do portal Cognos TM1 Applications.a. Em um navegador da web, digite a URI do Cognos TM1 Applications:

Por exemplo, http://localhost:9510/pmpsvcv Substitua o host local pelo nome do computador no qual o Cognos TM1

Application Server está instalado.v Se necessário, altere o número da porta se você usou um valor diferente

no IBM Cognos Configuration para a propriedade TM1 ApplicationServer Gateway URI.

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

Modeler .


5. Se desejar instalar o programa em diversos computadores, use as etapasanteriores para criar uma instalação não assistida. Para obter detalhes, consulteApêndice C, “Configurando Instalações e Configurações Não Assistidas”, napágina 341.

Instalando o Cognos TM1 Performance Modeler do portal doCognos TM1 Applications

É possível instalar o IBM Cognos TM1 Performance Modeler na primeira vez quevocê executa o componente a partir do portal do IBM Cognos TM1 Applications.

Antes de Iniciar

Antes de instalar o Cognos TM1 Performance Modeler a partir do portal CognosTM1 Applications, o administrador deve instalar o Cognos TM1 Applications.

Procedimento1. Em um navegador da web, digite a URI do portal do Cognos TM1

Applications:Por exemplo, http://localhost:9510/pmpsvca. Substitua hostlocal pelo nome do computador em que o Cognos TM1

Application Server 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 TM1 Application ServerGateway URI.

2. No portal do Cognos TM1 Applications, clique no ícone Abrir o 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.

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 website do desenvolvedor do Microsoft para obter adocumentação sobre o “Windows Installer Guide” e o “Windows Installer PropertyReference”.

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


Tabela 21. Valores de Propriedade para o Cognos TM1 PerformanceModeler (continuação)


TARGETDIR=

(valor padrão)

Quando usado com o ALLUSERS=""

No Windows XP, o local de instalaçãoé

C:\Documents andSettings\username\ApplicationData\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

No Windows XP, o local de instalaçãoé

C:\Documents and Settings\AllUsers\Application Data\IBM\CognosTM1 Performance Modeler

No Windows 7, o local de instalação é

C:\Program Data\IBM\Cognos TM1Performance Modeler

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.

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


Configurando a Criação de Log para o Cognos TM1Performance Modeler

É possível ativar a criação de log para o IBM Cognos TM1 Performance Modelerusando a mesma estrutura de criação de log de outros componentes no IBMCognos TM1.

Procedimento1. Localize o provagent_NOT.ini e renomeie o arquivo como provagent.ini.

Esse arquivo está localizado em:C:\Users\<user_name>\AppData\Roaming\IBM\Cognos Performance Modeler

2. Edite o provagent.ini para remover o comentário da linha a seguir.Altere #app-debug=true para app-debug=true.

3. Nesse mesmo local de diretório, abra e edite o arquivo defaultLog.propertiespara configurar a criação de log.

Nota: Por padrão, a criação de log é configurada para registrar mensagens donível ERROR para propósitos do dia-a-dia e, geralmente, não precisa ser ajustado.É possível alterar para as mensagens do nível WARNING, INFO ou DEBUG paraobter níveis variados de informação de log. Trabalhe com o Suporte ao ClienteIBM para alterar a configuração de criação de log para registrar mensagensmais específicas.

Resultados

Geralmente, os arquivos de log são registrados no seguinte local:

%appdata%/IBM/application_name/logs

Evitar exceções OutOfMemory lançadas pelo TM1Performance Modeler

Ao usar o IBM Cognos TM1 Performance Modeler com memória limitadainstalada, é possível encontrar uma exceção OutOfMemory.

Embora não seja possível evitar exceções completamente sem instalar memóriaadicional, é possível minimizar o risco de obter os erros, configurando o parâmetrofree.memory.error.threshold.percent no arquivo PerformanceModeler.ini.

Ao configurar o parâmetro free.memory.error.threshold.percent, uma mensagem deaviso será exibida, que solicita que você salve seu trabalho e efetue logoff quandoa quantidade de espaço livre estiver abaixo do limite configurável. Em sefuida,deve-se reiniciar o TM1 Performance Modeler e continuar trabalhando.

A mensagem de aviso será exibida na tela e também é incluída nos arquivos delog. Nenhuma verificação será feita se o parâmetro não estiver configurado. Umaverificação de memória é realizada sempre que o modelo for alterado. Exemplos demudanças de modelo incluem a inclusão de um novo membro em uma dimensão,ou criar um novo objeto modelo.

Para criar um limite, siga este procedimento:

Procedimento1. Feche o TM1 Performance Modeler.


2. Localize o arquivo PerformanceModeler.ini, que está no mesmo diretório que oPerformanceModeler.exe.

3. Configure o limite, incluindo a seguinte linha:"-free.memory.error.threshold.percent 10.0"

Nota: Isso define o limite como 10%.4. Salve o arquivo, feche-o e ative o TM1 Performance Modeler.

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 22. Opções de Instalação de diversos Computadores para Cognos Insight


“Instalando o Cognos InsightUsando o Programa de Instalação”

Os administradores ou usuários finais podem instalaro Cognos Insight em um único computador usandosomente o programa de instalação do IBM CognosTM1 Client.

Opcionalmente, use estas etapas para criar umainstalação não assistida para instalar o Cognos Insightem diversos computadores.

“Instalando o Cognos Insight apartir do portal do Cognos TM1Applications” na página 175

Como um pré-requisito, um administrador deveinstalar o Cognos TM1 Applications.

Isso permite que os usuários do Cognos TM1 instalemo Cognos Insight em seus computadores na primeiravez que eles os ativarem no Portal do IBM CognosTM1 Applications. Isto é chamado de instalaçãofornecida.

“Instalando Remotamente oCognos Insight em diversosComputadores” na página 176

Um administrador pode usar ferramentas deinstalação de rede de terceiros para propagar oCognos Insight para diversos sistemas do clienteremoto.

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 do sistema operacional Microsoft Windows Vista, Windows 7 ou

Windows Server 2008, clique com o botão direito no arquivo issetup.exe eclique em Executar como Administrador. Para outros sistemas operacionais, dêum clique duplo no arquivo issetup.exe no disco de instalação do cliente IBM


Cognos TM1 ou a partir do local onde os arquivos de instalação do cliente IBMCognos TM1 foram transferidos por download e extraí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 C, “Configurando Instalações e Configurações Não Assistidas”, napágina 341.

Instalando o Cognos Insight a partir do portal do Cognos TM1Applications

É possível instalar o IBM Cognos Insight na primeira vez que você executar ocomponente na barra de ferramentas do portal do IBM Cognos TM1 Applications.

Antes de Iniciar

Antes de instalar o Cognos Insight a partir do Cognos TM1 Applications, oadministrador deverá instalar o Cognos TM1 Applications.

Procedimento1. Em um navegador da web, digite o URI do portal do Cognos TM1

Applications:Por exemplo, http://localhost:9510/pmpsvca. Substitua o host local pelo nome do computador no qual o Cognos TM1

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 TM1 Applications, clique no ícone Abrir IBM Cognos

Insight .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 É possível ativar o Cognos Insight usando o ícone Abrir Cognos Insight noCognos TM1 Applications.

v Será possível ativar o cliente Cognos Insight clicando com o botão direito domouse em um nó de um aplicativo que foi configurado para usar o CognosInsight.


O Cognos Insight está disponível como um cliente de um aplicativo somente sevocê configurou o ambiente do cliente para o Cognos TM1 Applications parausar o cliente Cognos Insight Distribuído ou Conectado. Para obter maisinformações, consulte “Configurando o ambiente do servidor e do cliente para oCognos TM1 Application Web” na página 142.

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.

O arquivo CognosInsight.msi é um arquivo padrão do Microsoft WindowsInstaller. É possível usar o arquivo CognosInsight.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.

A tabela a seguir lista alguns valores da propriedade que os administradorespodem usar para instalar o arquivo CognosInsight.msi. Para obter detalhescompletos, consulte o website do desenvolvedor do Microsoft para obter adocumentação sobre o “Windows Installer Guide” e o “Windows Installer PropertyReference”.

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


Tabela 23. Valores de Propriedade para Cognos Insight (continuação)


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

No Windows XP, o local deinstalação é

C:\Documents andSettings\username\ApplicationData\IBM\Cognos Insight

No Windows 7, o local deinstalação é

C:\Users\username\AppData\Roaming\IBM\Cognos Insight

Quando usado com ALLUSERS=1

No Windows XP, o local deinstalação é

C:\Documents and Settings\AllUsers\ApplicationData\IBM\Cognos Insight

No Windows 7, o local deinstalação é

C:\Program Data\IBM\CognosInsight

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 seguintecomandoCognosInsight.msi TARGETDIR="install_location" ALLUSERS=1

Configurando a Criação de Log para o Cognos InsightÉ possível ativar a criação de log para o IBM Cognos Insight usando a mesmaestrutura de criação de log que outros componentes no IBMCognos TM1.

Procedimento1. Localize o provagent_NOT.ini e renomeie o arquivo como provagent.ini.

Esse arquivo está localizado em:C:\Users\<user_name>\AppData\Local\Programs\IBM\Cognos Insight

2. Edite o provagent.ini para remover o comentário da linha a seguir:Altere #app-debug=true para app-debug=true.

3. Nesse mesmo local de diretório, abra e edite o arquivo defaultLog.propertiespara configurar a criação de log.

Nota: Por padrão, a criação de log é configurada para registrar mensagens donível ERROR para propósitos do dia-a-dia e, geralmente, não precisa ser ajustado.É possível alterar para as mensagens do nível WARNING, INFO ou DEBUG paraobter níveis variados de informação de log. Trabalhe com o Suporte ao ClienteIBM para alterar a configuração de criação de log para registrar mensagensmais específicas.

Resultados

Geralmente, os arquivos de log são registrados no seguinte local:

%appdata%/IBM/application_name/logs

Instalando APIs do Cognos TM1Use a opção de instalação de API do TM1 para instalar os arquivos necessáriospara permitir que os programadores trabalhem com as interfaces de programaçãode aplicativos (APIs) do Cognos TM1. Essa opção de instalação também pode serinstalada nos servidores Cognos Business Intelligence (BI) para ativar o relatóriodo Cognos BI com relação a origens de dados do Cognos TM1.

Sobre Esta Tarefa

Essa opção instala arquivos para as seguintes APIs do Cognos TM1:

API do TM1Permite que os desenvolvedores criem aplicativos C, C++ e VBcustomizados que interagem com o TM1.

Java API do TM1Permite que os desenvolvedores criem aplicativos Java customizados queinteragem com o TM1.

API .NET do TM1Permite que os desenvolvedores criem aplicativos Microsoft .NETcustomizados que interagem com o TM1.


Atenção: Para obter mais informações sobre o uso das APIs do TM1 para ativar orelatório do Cognos BI com relação a origens de dados do Cognos TM1, consulte“Cognos TM1 como uma Origem de Dados com o Cognos BI” na página 71.

Procedimento1. Execute o programa de instalação completa do IBM Cognos TM1 ou o

programa de instalação apenas do cliente:v No software de sistema operacional Microsoft Windows Vista, Windows 7 ou

Windows Server 2008, clique com o botão direito do mouse no arquivoissetup.exe e clique em Executar como Administrador.

v Para outros sistemas operacionais Windows, dê um clique duplo no arquivoissetup.exe.

2. Selecione o local de instalação na página Local de Instalação:v Se você estiver planejando usar as APIs do TM1 para programação, aceite a

instalação padrão.v Se você estiver usando as APIs do TM1 para ativar o relatório do Cognos BI

com relação a origens de dados do Cognos TM1, selecione um diretórioadjacente no servidor Cognos BI que esteja executando serviços de relatóriono Microsoft Windows.

3. Na página Seleção de Componente:a. Expanda Camada de Cliente do TM1 e selecione a opção APIs do TM1.b. Desmarque as caixas de opções para todos os outros componentes.

4. Siga os prompts e clique em Concluir para concluir a instalação.

Configurando Computadores Clientes para Exportar Dados do CognosTM1 em Formato PDF

Para exportar dados do IBM Cognos TM1 para o formato Adobe PDF a partir dosaplicativos clientes IBM Cognos TM1 em execução no Microsoft Windows,configure PDFCamp como sua impressora padrão. Essas etapas se aplicam ao IBMCognos TM1 Perspectives, 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. No Windows, abra a janela de configuração Impressoras e Faxes.2. Clique com o botão direito do mouse em Driver da Impressora PDFCamp e

selecione Configurar como Impressora Padrão.


Capítulo 13. 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, Planning Sample, GO_New_Stores, GO_Scorecards e Proven_Techniques

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 e Proven_Techniques são projetados para destacar osrecursos do Cognos TM1 Performance Modeler, TM1 Applications eCognos Insight.

A amostra Proven_Techniques destaca os cálculos do cubo e as funções.Também é possível importar vários aplicativos no portal e visualizá-losusando o modo Conectado do Cognos Insight.

A amostra GO_Scorecards inclui dados otimizados para serem usados comos recursos do Marcador de Desempenho do IBM Cognos localizados noCognos TM1 Performance Modeler.

Consulte “Usando os Bancos de Dados de Amostra Instalados por Padrão”na página 182 para obter mais informações.

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, sample_outdoiors.zip, advanced_techniques.zip,greatoutdoors.zip, e GreatOutdoorsSales.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 de


dados 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. Consulte “Usando oGO_Contributor e os bancos de dados de amostra da Companhia dasAventuras” na página 183 para obter mais informações.

HumanResources.cdd, Orders.cdd e Training.cdd.Um conjunto de amostras de dados e .cdd foi projetado especificamentepara uso com o construtor de área de trabalho do Cognos Insight. Essasamostras com versões localizadas estão disponíveis em TM1 installationlocation\webcontent\samples\datasources\cubes\amdtool\Source_files\desktop.

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 os Bancos de Dados de Amostra Instalados por PadrãoOs bancos de dados de dados de amostras a seguir são instalados por padrão epodem ser todos iniciados a partir do Cognos Configuration

Sobre Esta Tarefa

Por padrão, esses bancos de dados são instalados no local do banco de dados deamostra.

Por exemplo, C:/Program Files/IBM/cognos/tm1/samples/tm1/SData

SData Dados designados para o uso com o TM1.

Amostra de PlanejamentoDados designados para uso com os clientes de Planejamento.

GO_New_StoresDados designados para o uso com o TM1 Applications, Cognos Insight eCognos TM1 Performance Modeler.

GO_ScorecardsDados designados para o uso com o TM1 Scorecarding no TM1Performance Modeler.

Proven_TechniquesEsse banco de dados de amostra usa cálculos do cubo e recursos deliberações mais recentes. Esse banco de dados também foi projetado paraser usado com os recursos do TM1 Scorecard no Cognos TM1 PerformanceModeler.

Procedimento1. No Cognos Configuration, clique com o botão direito no banco de dados que

deseja iniciar e selecione Iniciar.2. Para abrir os bancos de dados, no TM1 Architect ou TM1 Performance Modeler,

dê um clique duplo no banco de dados e use o nome de usuário padrão admine senha apple.


Usando o GO_Contributor e os bancos de dados de amostra daCompanhia das Aventuras

O GO_Contributor e as amostras da Companhia das Aventuras a seguir sãoinstalados como arquivos .zip que você deve descompactar a fim de usá-los.

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 ou Outdoors_Company.zip .

Certifique-se de fazer o encerramento da extração para o local raiz, como c:para que o caminho do arquivo não seja muito longo.

3. Na pasta na qual você extraiu o arquivo, acesse a pasta Data Files e abra oarquivo tm1s.cfg em um editor de texto.a. Assegure-se de que o local DatabaseDirectory, o local LoggingDirectory e o

DistributedPlanningOutputDir usem o caminho correto para o local dapasta Data Files na qual você extraiu os arquivos Go_Contributor.zip eOutdoors_Company.zip.

b. Salve e feche os arquivos.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 ou Outdoor Company.b. Para o valor do caminho da configuração do TM1 Server, insira o caminho

para a pasta Data Files no qual você extraiu os arquivos.Por exemplo, tm1_location\samples\GO_Contributor

c. No painel Explorer, clique com o botão direito em GO Contributor ouOutdoor Company e clique em Iniciar.

6. Teste se os novos servidores estão disponíveis no Architect.a. Abra o Architect.b. Dê um clique duplo no servidor.c. Na caixa Login do Servidor, insira admin na caixa Nome de Usuário e

apple na caixa Senha.7. Para testar se os novos servidores estão disponíveis 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 TM1 Application.c. 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 que você acabou de incluir e clique em OK.

Usando as amostras do servidor de vendas de grandesaventuras com base no banco de dados de amostras

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.

Capítulo 13. Instalação de Bancos de Dados de Amostras do Cognos TM1 183

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


Tabela 24. Definições de Configuração Padrão para Dados GOSALES (continuação)


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.

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.


Opção Descrição

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


Tabela 25. Definições de Configuração Padrão para Dados GOSALES (continuação)


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.

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.

-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 SQL ServerUse 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 mais informações, consulte a documentação do Microsoft SQL Serverou a Base de Conhecimento do IBM Cognos na Central do Cliente do IBMCognos.

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.


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

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.

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. Certifique-se de fazer oencerramento da extração para o local raiz, como c: para que o caminho doarquivo não seja muito longo.

4. Na pasta na qual você extraiu o arquivo GreatOutdoorsSales.zip, acesse apasta 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.

b. Salve e feche o arquivo.5. Abra o IBM Cognos Configuration.6. 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 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

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 GreatOutdoorsSales que acabou de incluir e clique em

OK.


Capítulo 14. 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 IBM Cognos TM1TurboIntegrator Guide.

v tm1xferO 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 TopO 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_testA 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 15. 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.

Essa seção descreve a autenticação e a segurança de transmissão de dados que sãoconsideradas parte do processo geral de instalação e configuração. As etapas para asegurança de usuário, grupo e objeto geralmente são feitas após o processo inicialde instalação e configuração e são descritas na documentação separada.


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 de Usuário e Grupo

O Cognos TM1 gerencia a segurança organiza os usuários do TM1 em grupos. OTM1 inclui um conjunto de três grupos administrativos predefinidos e tambémpermite criar os próprios grupos customizados. Os usuários podem pertencer a umou vários grupos.

Para obter informações sobre como configurar a segurança de usuário e grupo,consulte o Guia de Operações do IBM Cognos TM1.

Segurança de Objeto

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 26. Métodos de Autenticação do Cognos TM1 Server

Métodos de Autenticação Descrição

Autenticação 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.

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 do Cognos TM1 que esteja emexecução em um sistema operacional UNIX.

Segurança do TM1 Padrão

Clientes TM1 Server

Tentativa de Estabelecer uma Conexão

Solicitar um Nome de Usuário e Senha

Fornecer um Nome de Usuário e Senha

Estabelecer Conexão

TM1 ArchitectTM1 PerspectivesTM1 Web Client

Nome de Verificaçãoe Senha

TM1 Contributor

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

Login Integrado

Clientes TM1 Server

(2) Tentativa de Estabelecer uma Conexão do TM1

(3) Retornar Windows Network Identity

(4) Fornecer Identidade do Windows como uma Solicitação de Login

(5) Estabelecer Conexão

TM1 ArchitectTM1 PerspectivesTM1 Web Client

Nome de Verificação

Autenticação do

O usuário fornece umnome de usuário,uma senha e

Windows

nome de domínio do Windowsenquanto

efetua login em umaestação de trabalho do

Windows

(1) Login do Windows Concluído

Controlador deDomínio do

Windows

TM1 Contributor

Figura 9. Processo de Autenticação Usando Login Integrado

Autenticação Usando LDAP

TM1

(2) TM1 efetua login no LDAP com

Interface com o Usuário

(1) Usuário fornece nome e senha

(8) TM1 efetua login do usuárioe fornece o acesso de usuárioaos objetos no servidor.

Server

nome e senha bem conhecidos.

(3) LDAP reconhece umlogin bem-sucedido usando

(4) Consulta - TM1 transmite onome para LDAP

(5) O LDAP retorna um nomedistinto a partir de seu banco de dados que

(6) O TM1 transmite o nomedistinto e senha do usuário

(7) LDAP reconhece umlogin bem-sucedido usando

LDAPServer(ActiveDirectory,Netscape,etc.)

nome e senha bem conhecidos.

corresponde aonome solicitado do usuário.

para LDAP.

o nome e a senha fornecidos pelo usuário.

Figura 10. Processo de Autenticação Usando LDAP

Capítulo 15. Configuração de Segurança 195

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 ao Usar o Cognos TM1ApplicationsÉ 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” na página 228.

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.

Se IntegratedSecurityMode=5 for usada para o IBM Cognos TM1 Server e o IBMCognos TM1 Applications, não será possível designar direitos para os grupos deTM1 nativos no diálogo Gerenciar direitos. Somente os Grupos do Cognosimportados para o TM1 Server, estarão disponíveis. Isso significa que não épossível usar os grupos de TM1 nativos e grupos do Cognos em paralelo, porque oSecMode está limitando quais grupos podem ser usados


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 ApplicationWeb para usar vários servidores Cognos TM1” na página 159.

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 Grupo do Cognos TM1 . Se o valor for R&D, Controle de Qualidade ouDocumentação, ele retornará Engenharia. Os usuários de um dos 3 grupos LDAPserão incluídos em um único grupo Engenharia do Cognos TM1 . Qualquer outrovalor 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 27. 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 28. 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 doHost

HostInsira o nome do host ou endereço IP damáquina na qual o servidor LDAP está emexecução.


Painel Campo Descrição

PortaA porta na qual o servidor LDAP está emexecução. Se uma porta não for especificada, a636 será usada. O Cognos TM1 tenta ligar umservidor LDAP na porta segura especificada.Se você não inserir um valor de LDAPPort, oCognos TM1 usará o valor padrão da porta636.

VersãoMuito provavelmente, o ETLDAP ignorará onúmero da versão. A maioria dos servidoresLDAP suportam conexões tipo versão 2 ouversão 3, o ETLDAP não usa qualquerfuncionalidade específica de qualquer umadas versões.

Opção SSLDetermina se a comunicação entre o servidorLDAP e o ETLDAP ocorre em um canalcriptografado seguro. A menos que você estejavisualizando informações seguras em umarede não segura, deixe esta opção desativada.

Opção AnômimaA maioria dos servidores LDAP possuemalguma camada de configuração de segurançaque requer que você seja autenticado comoum usuário conhecido. Em alguns sistemas, osusuários anônimos podem navegar nodiretório, mas não recuperar o esquema. Emoutros sistemas, um usuário anônimo pode teracesso a algumas áreas não seguras dodiretório, mas não a outras.

Informações doUsuário

DSN do UsuárioEm muitos casos, seu diretório LDAP impedeque usuários Anônimos acessem oumodifiquem dados. Neste caso, podem sernecessários um Nome Distinto (DN) e senhapara concluir a extração de informações desegurança LDAP.

Por exemplo, o nome Norm Lodin podereferir-se a uma pessoa que trabalha naBlodget, Inc. No LDAP, ele possui um NomeDistinto que distingue-o exclusivamente dasdemais entidades na rede.

Norm pode inserir as seguintes informaçõesno campo Informações sobre o Usuário.

uid=nlodin, ou=People, o=Blodget.com

SenhaInsira uma senha que corresponda 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:

Base de procura: o=Applix.com

o: Applix.com

cn: Rob Smithuid: rsmith cn: Jill Benson

uid: jbenson

Escopo: Um

Escopo: SubFigura 11. Efeito da Configuração de Escopo em uma Procura


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.

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.


Campo Descriçã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 registros 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 o ETLDAPexportou e criou no Cognos TM1. O ETLDAP gera as senhas de usuário doCognos TM1 aleatoriamente e inclui-as no banco de dados Cognos TM1.

Nota: Se você usar o Login Integrado, os usuários do Cognos TM1 não usarãoas senhas do Cognos TM1 e não será necessário coordenar as senhas entre oCognos TM1 e o Microsoft Windows. Se você não usar Login Integrado, osusuários do Cognos TM1 deverão alterar suas senhas durante a primeira sessãode login. Para obter detalhes, consulte “Login Integrado” na página 206.

Executando ETLDAP no Modo de Atualização para Incluir NovosUsuários LDAPÉ possível executar o ETLDAP no modo de Atualização para atualizar o IBMCognos TM1 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, você deve 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 o ETLDAP para carregar inicialmente os usuários LDAP no CognoslTM1, apenas será possível usar a ferramenta para recuperar e incluir novosusuários LDAP que ainda não existam no Cognos TM1. Não será possível usar outilitário ETLDAP para atualizar ou excluir os usuários existentes no Cognos TM1com base nas mudanças no diretório LDAP.

Conforme novos usuários forem incluídos no servidor LDAP, será possívelincluí-los no Cognos TM1 especificando uma data na seção de filtro da consultaLDAP. O uso de uma data na seção Filtro executa o ETLDAP no modo deAtualização. É possível editar o Filtro LDAP para selecionar apenas novos registrosdo usuário que atendem seus requisitos de procura originais, desde a última vezque o ETLDAP foi executado.

Nota: A execução do ETLDAP no modo de Atualização apenas inclui novosusuários LDAP que ainda não existem no Cognos TM1. O ETLDAP não atualiza osatributos de usuário ou exclui usuários existentes do Cognos TM1.


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.

Nota: Assegure-se de aderir à sintaxe suportada pelos Filtros LDAP. Para obtermais informações, consulte o documento de protocolo de normas da Internet,RFC 2254, “The String Representation of LDAP Search 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 clientes


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

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

3. Configure o servidor Cognos TM1 e os componentes do cliente para usar oLogin Integrado.

Tabela 29. 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 209


Tabela 29. Resumo da Configuração de Login Integrado para Componentes CognosTM1 (continuação)

Componente Configuração Necessária

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 212 e “Configurando oCognos TM1 Architect para Usar o LoginIntegrado” na página 211

Cognos TM1 Web Defina as configurações a seguir para Cognos TM1Web:

arquivo: tm1web_config.xml Configure parâmetrosno arquivo tm1web_config.xml que ativem o LoginIntegrado para o Cognos TM1 Server Web.Nota: Também poderá ser necessário verificar e/oudefinir as configurações da segurança Kerberos.

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 o 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 199.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 Configure o parâmetro SecurityPackageName para o protocolo de segurança

usado para o Login Integrado, como o Kerberos (padrão).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 211.v “Configurando o Cognos TM1 Perspectives para Usar Login Integrado” na

página 212.

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 o Cognos TM1 Web Usandoo Kerberos”.

Configurando o Login Integrado para o Cognos TM1 WebUsando o KerberosÉ possível configurar o IBM Cognos TM1 Web para usar o Login Integrado com oprotocolo de segurança Kerberos. Esse é o tipo de autenticação que funciona com oTM1 IntegratedSecurityMode=3.

Sobre Esta Tarefa

No Cognos TM1 Web versão 10.2, você deve inserir a autenticação do MicrosoftWindows na caixa de diálogo de login do Cognos TM1 Web. A caixa de diálogo delogin permite escolher o login do TM1 ou do Microsoft Windows nativo.


Para executar o Cognos TM1 Web em um ambiente Kerberos, você deveráconfigurar adequadamente o ambiente do Kerberos para trabalhar com o JavaRuntime que estiver executando o serviço do Cognos TM1 Web.

O Cognos TM1 Web versão 10.2 usa o Java Generic Security Service (JGSS) parasuportar a Autenticação do Kerberos Windows. Esse é tipo de autenticação obtidoao usar o TM1 IntegratedSecurityMode=3. Informações adicionais sobre comoconfigurar uma Autenticação do Kerberos Windows para trabalhar em umambiente Java está disponível no link a seguir:

Informações do IBM Security para o Java V6 > Java Generic Security Service (JGSS)> Java Generic Security Service (JGSS) User's Guide Arquivos de configurações epolíticas (http://publib.boulder.ibm.com/infocenter/javasdk/v6r0/index.jsp?topic=%2Fcom.ibm.java.security.component.60.doc%2Fsecurity-component%2FjgssDocs%2Fconfig_files.html)

A documentação sobre como configurar o LoginModule para adquirir asCredenciais do Kerberos para o IBM Java está descrita neste link:

com.ibm.security.auth.module Class Krb5LoginModule (http://pic.dhe.ibm.com/infocenter/java7sdk/v7r0/index.jsp?topic=%2Fcom.ibm.java.security.component.70.doc%2Fsecurity-component%2FjgssDocs%2Fconfig_files.html)

Procedimento1. Especifique um Arquivo de Configuração do Kerberos.

Em um sistema Windows, o Arquivo de Configuração do Kerberos é krb5.ini.No Linux, o arquivo é krb5.conf.Um exemplo do Arquivo de Configuração do Kerberos do Windows (krb5.ini):[libdefaults]default_realm = <REALM_NAME>default_tkt_enctypes = rc4-hmac des-cbc-crcdefault_tgs_enctypes = rc4-hmac des-cbc-crcticket_lifetime = 1200[realms]<REALM_NAME> = {kdc = 9.24.213.202admin_server = <server_name.domain_name>default_domain = <DOMAIN_NAME>}[domain_realm].<domain_realm_name> = <DOMAIN_REALM_NAME>

[appdefaults]autologin=trueforward=trueforwardable=trueencrypt=true

2. Especifique o recurso de login JAAS no arquivo java.security.Exemplo de especificação do recurso de login do JAAS no arquivojava.security:# Default login configuration file#login.config.url.1=file:${user.home}/.java.login.configlogin.config.url.1=file:${java.home}/lib/security/login.config

Exemplo de conteúdo do arquivo de configuração de login para o IBM JavaRuntime:


http://pic.dhe.ibm.com/infocenter/java7sdk/v7r0/index.jsp?topic=%2Fcom.ibm.java.security.component.70.doc%2Fsecurity-component%2FjgssDocs%2Fconfig_files.htmlhttp://publib.boulder.ibm.com/infocenter/javasdk/v6r0/index.jsp?topic=%2Fcom.ibm.java.security.component.60.doc%2Fsecurity-component%2FjgssDocs%2Fconfig_files.html

http://pic.dhe.ibm.com/infocenter/java7sdk/v7r0/index.jsp?topic=%2Fcom.ibm.java.security.component.70.doc%2Fsecurity-component%2FjgssDocs%2Fconfig_files.htmlhttp://publib.boulder.ibm.com/infocenter/javasdk/v6r0/index.jsp?topic=%2Fcom.ibm.java.security.component.60.doc%2Fsecurity-component%2FjgssDocs%2Fconfig_files.html

http://pic.dhe.ibm.com/infocenter/java7sdk/v7r0/index.jsp?topic=%2Fcom.ibm.java.security.component.70.doc%2Fsecurity-component%2FjgssDocs%2Fconfig_files.html

TM1SignedOnUserLoginContext {com.ibm.security.auth.module.Krb5LoginModule requireduseDefaultCcache=falsecredsType=initiator;

};

Exemplo de conteúdo do arquivo de configuração de login para o SUN JavaRuntime:TM1SignedOnUserLoginContext {

com.sun.security.auth.module.Krb5LoginModule requireduseTicketCache="true"useKeyTab="true" keyTab="krb5.keytab" ;

};

3. Especifique o arquivo de configuração de login.4. Configure o parâmetro IntegratedSecurityModuleName no arquivo

tm1web_config.xml.Assegure-se de que o valor associado ao parâmetroIntegratedSecurityModuleName esteja configurado com o nome doLoginModule que está associado ao ambiente do Kerberos.<add key=“IntegratedSecurityModuleName” value=“name of theLoginModule”/>

5. Assegure-se de que o serviço do Windows para o Cognos TM1 Server pertençaa uma conta de domínio autorizada.

6. Assegure-se de que o usuário que estiver efetuando login possua o chamadoadequado configurado pelo procedimento kinit.

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 mais informações, consulte a documentação do Microsoft InternetExplorer.

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 mais informações, consulte sua documentação do Mozilla Firefox.

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. Observe que a partir do TM110.2, o TM1 Web não suporta a conexão única; deve-se fornecer uma combinaçãode nome de usuário/senha para efetuar logon no TM1 Web.

Procedimento1. Execute o Microsoft Internet Explorer.2. Insira o seguinte Localizador Uniforme de Recursos na caixa Endereço do

navegador:http://web_server_name:port_number /tm1web/

Por exemplo: http://localhost:9510/tm1web/3. Insira o nome do host do Cognos TM1 Server Admin Server no campo Host

Administrativo.4. Clique na seta Servidor.5. Clique em Efetuar Login.6. Insira o nome do usuário e a senha.


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, você deve 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.

LDAPHost:

Especifica o nome de domínio ou representação em sequência pontilhada doendereço IP do host do servidor LDAP.


Se você não inserir um valor para LDAPHost, o IBM Cognos TM1 usará o valorpadrão, host local.

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” na página215=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.


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

LDAPPort:

Especifica a porta que o IBM Cognos TM1 usa para ligar-se a um servidor LDAP.


Especifique uma porta segura (SSL), por exemplo, 636.

Valor padrão: 389 (uma porta não segura)

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

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.

LDAPSkipSSLCertVerification:

Ignora a etapa de verificação de confiança do certificado para o certificado SSLusado para autenticar um servidor LDAP. Este parâmetro é aplicável apenasquando LDAPVerifyServerSSLCert=T.



Se a verificação de confiança não funcionar, será possível ignorar a etapa deverificação de confiança, especificando LDAPSkipSSLCertVerification=T. Nestecaso, o TM1 não verifica o certificado do servidor em todos, mas simplesmenteaceita.

Nota: Antes de trabalhar com este parâmetro, deve-se estar familiarizado com SSLe LDAP.

Valor padrão: F

LDAPSkipSSLCRLVerification:

Ignora a verificação de CRL para o certificado SSL usado para autenticar umservidor LDAP. Este parâmetro é aplicável apenas quandoLDAPVerifyServerSSLCert=T.


Este parâmetro não é requerido se LDAPVerifyServerSSLCert=F. A API doMicrosoft Windows pode tolerar um certificado CRL vazio ou não existente.


Valor padrão: F

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” na página 213 e “LDAPPasswordKeyFile” napágina 214 para conectar-se com êxito ao servidor LDAP usando SSL.

LDAPVerifyCertServerName:

Especifica um servidor a ser utilizado durante o processo de verificação decertificado SSL para autenticação do servidor LDAP. Este parâmetro é aplicávelapenas quando LDAPVerifyServerSSLCert=T.



Utilize este parâmetro para especificar que os servidores TM1 devem ser utilizadospara verificar o certificado SSL recebido.


Todos os nomes dos servidores que você deseja usar para verificação de certificadodevem ser listados em entradas LDAPVerifyCertServerName separadas. Asentradas devem corresponder exatamente ao nome (assunto) do certificadoapresentado ao TM1 no handshake SSL pelo servidor na outra extremidade.

Especifique LDAPVerifyCertServerName no arquivo tm1s.cfg de cada TM1 Serverque está usando LDAP.LDAPVerifyCertServerName=<server_cert_subject>

Substitua server_cert_subject por um nome do servidor ou endereços IP. Crieuma entrada para cada servidor que você deseja utilizar, por exemplo:LDAPVerifyCertServerName=abc99.mydomain.comLDAPVerifyCertServerName=xyz99.mydomain.com

Valor padrão: F

LDAPVerifyServerSSLCert:

Delega a verificação do certificado SSL para o TM1. Este parâmetro é útil, porexemplo, quando você está usando a LDAP com um servidor proxy.



Geralmente, o, TM1 aproveita a API do Microsoft Windows para verificarcertificados SSL. Para este processo ser bem-sucedido, o nome do certificado e onome do host do servidor LDAP devem corresponder. Se você estiver utilizandoum proxy, no entanto, esses nomes podem não corresponder, causando a falha deverificação. Neste caso, é possível configurar o LDAPVerifyServerSSLCert=T para tero TM1 executando a verificação de certificado.

Quando o LDAPVerifyServerSSLCert=T, TM1 executa duas etapas de verificação(verificando o relacionamento confiável para o certificado e verificação do CRL)como a API do Windows teria feito, mas com uma abordagem um pouco diferente.1. Em vez de verificar o certificado recebido em relação ao nome do host

configurado, o TM1 procura na lista de nomes dos servidores especificados porLDAPVerifyCertServerName.

2. Se o nome do certificado corresponder a um dos servidores especificados porLDAPVerifyCertServerName, o TM1 chama a API do Microsoft Windows esolicita que ela verifique somente este certificado único.

Nota: A autoridade do certificado de raiz confiável (CA) correta já deve tersido importada para o armazenamento de certificados do Microsoft Windows.

É possível ignorar a etapa de verificação de confiança especificandoLDAPSkipSSLCertVerification=T. Neste caso, o TM1 não verifica o certificadodo servidor em todos, mas simplesmente o aceita.

3. Depois que a verificação de confiança for confirmada (ou ignorada), o TM1chamará a API do Microsoft Windows para verificar a CRL.

Nota: O certificado CRL para a raiz confiável já deve ter sido importada para oarmazenamento de certificados do Microsoft Windows.


Se o certificado CRL não existir no armazenamento de certificados do MicrosoftWindows, o processo falhará. É possível ignorar a etapa de CRL especificandoLDAPSkipSSLCRLVerification=T.

4. Se todas as etapas anteriores foram concluídas com sucesso, o handshake SSLserá concluído. O TM1 agora tenta autenticar para o servidor LDAP.

Para obter informações de resolução de problemas, consulte “Resolvendoproblemas de autenticação LDAP” na página 218.

LDAPWellKnownUserName:

Especifica o nome de usuário usado pelo servidor IBM Cognos TM1 para efetuarlogin no LDAP e consultar o nome enviado pelo usuário.

Tipo de parâmetro: opcional, a menos que “LDAPUseServerAccount” na página215=F,, estático

O valor desse parâmetro pode ser qualquer nome distinto LDAP.

Por exemplo:uid=bjensen,ou=people,o=company.com

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 197.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 membro dogrupo gymnasts no diretório LDAP, o ETLDAP criará o usuário Nadiac ecriará o grupo gymnasts no Cognos TM1. Nadiac é exibido na caixa dediá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= file

LDAPPasswordKey= key

d. Salve e saia do arquivo TM1s.cfg.e. Recicle seu servidor Cognos TM1 .

Agora, é possível efetuar login no Cognos TM1 com um nome incluído apartir do diretório LDAP.

Resolvendo problemas de autenticação LDAPEste tópico descreve mensagens de log de erros que podem surgir quando oLDAPVerifyServerSSLCert=T estiver no arquivo tm1s.cfg.

A mensagem a seguir indica que o certificado não corresponde a nenhum dosnomes que são listados no LDAPVerifyCertServerName. Verifique o nome docertificado e assegure-se de que ele tenha uma entradaLDAPVerifyCertServerName no arquivo tm1s.cfg.LDAP ERROR: 0x800b0109 - Error verifying server certificate chain validityLDAP ERROR: Error verifying server certificate no match for <server>LDAP ERROR: 0x51 - ldap_connect failed.

A mensagem a seguir indica um problema com a confiança do certificado doservidor LDAP pelo Microsoft Windows. Assegure-se de que o certificado foiimportado para o armazenamento de certificados do Microsoft Windows.LDAP ERROR: 0x800b010f - Error verifying server certificate chain validityLDAP ERROR: Error verifying server certificate no match for <server>LDAP ERROR: 0x51 - ldap_connect failed.

A mensagem a seguir indica que o certificado está revogado ou o TM1 estáprocurando o certificado CRL, mas não pode localizá-lo no armazenamento decertificados do Microsoft Windows. Para corrigir o erro, ignore a verificação deCRL (configurada como LDAPSkipSSLCRLVerification=T) ou importe o certificadoda CRL da CA no armazenamento de certificados do Microsoft Windows.LDAP ERROR: 0x80092012 - Error verifying server certificate chain validityLDAP ERROR: Error verifying server certificate no match for <server>LDAP ERROR: 0x51 - ldap_connect failed.


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. Em seguida, essepassaporte é usado pelos aplicativos Cognos TM1 para determinar as permissõesdo usuário (função e associação ao grupo) e identidade.

Quando a segurança do Cognos é usada, um passaporte do Cognos é necessáriopara conectar ao Cognos TM1. Uma tela de logon é apresentada ao usuáriosolicitando um namespace, um nome de usuário e uma senha no primeiro login noCognos TM1 ou em quaisquer outros componentes ativados para a segurança doCognos. Uma vez autenticado por segurança do Cognos, um passaporte é emitidoao usuário. Esse passaporte fornece automaticamente as credenciais do usuárioquando é acessado qualquer outro aplicativo ativado para a segurança do Cognos(incluindo o Cognos TM1). Quando um usuário se conectar ao servidor CognosTM1 por um servidor Cognos específico configurado para logon comum, nenhumaentrada direta do usuário será necessária para acessar servidores Cognos TM1adicionais (ou outros aplicativos Cognos) configurados para fazer referência aomesmo servidor Cognos.

Quando um usuário tentar acessar o servidor Cognos TM1 , o servidor validará 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.

Se um usuário executa o programa cliente como um administrador (clicando com obotão direito do mouse no nome do arquivo do programa e selecionando Executarcomo Administrador), duas novas pastas são criadas depois que o cliente seconecta ao CAM:v installation_location\configuration

Esta pasta contém o arquivo C8ITK.ini.v installation_location\logs

Esta pasta contém o arquivo C8ITK.log, se aplicável.

Por padrão, o arquivo C8ITK.ini especifica que nenhum arquivo de log será criadona pasta logs, a menos que ocorra um erro. É possível editar o arquivo C8ITK.inise desejar ter arquivos de log. Também é possível alterar o nome do arquivo de logeditando a seção LogFilePath. Antes que as mudanças possam entrar em vigor,deve-se reiniciar os serviços Cognos.


Configurando o TM1 Server para Usar a Segurança do CognosÉ possível configurar o servidor IBM Cognos TM1 para usar a segurança do IBMCognos para autenticação em vez da autenticação padrão do TM1.

Antes de Iniciar

Para concluir esses procedimentos com sucesso, o servidor IBM Cognos não deveráser configurado para permitir acesso anônimo. Se o acesso anônimo for ativado noservidor IBM Cognos, não será possível efetuar logon em um namespace a partirdo TM1 ao importar grupos do Cognos no TM1.

Sobre Esta Tarefa

Para ativar a autenticação de segurança do IBM Cognos no servidor IBM CognosTM1, você deverá incluir ou modificar vários parâmetros de configuração noarquivo de configuração Tm1s.cfg.

Nota: Se você desejar reconfigurar um servidor TM1 que já esteja usando asegurança do Cognos para usar uma instância diferente do Cognos, você deveráremover os usuários e grupos existentes do Cognos que foram importados a partirda primeira instância do Cognos e, em seguida, importar os usuários e grupos danova instância do Cognos.

Procedimento1. Abra o arquivo de configuração Tm1s.cfg em um editor de texto.

O Tm1s.cfg arquivo é localizado no diretório de dados do servidor TM1. Paraobter mais informações, consulte Apêndice A, “O arquivo de configuração doservidor tm1s.cfg”, na página 271.

2. Edite ou inclua os parâmetros a seguir no arquivo de configuração.

Tabela 30. Parâmetros de Configuração do Servidor TM1 para a Segurança do Cognos

Nome do Parâmetro Descrição

ServerCAMURI O URI do dispatcher interno que o servidor TM1 deve usar parase conectar à segurança do IBM Cognos. O URI é especificadono formulário

http[s]://host IP address:port/p2pd/servlet/dispatch

Exemplos

http://10.121.25.121:9300/p2pd/servlet/dispatch

https://10.121.25.121:9300/p2pd/servlet/dispatch

Nota: Para localizar o URI, solicite que o administrador do IBMCognos execute as seguintes etapas:

1. No sistema que hospeda o IBM Cognos, abra o IBM CognosConfiguration.

2. Clique para expandir o nó Ambiente.

3. Na área de janela Propriedades, localize a seçãoConfigurações de Dispatcher e use o valor da propriedadeURI do dispatcher externo ou URI do dispatcher interno.


Tabela 30. Parâmetros de Configuração do Servidor TM1 para a Segurança doCognos (continuação)


ClientCAMURI O URI do IBM Cognos Server IBM Cognos Connection usadopara autenticar os clientes TM1. O URI é especificado noformulário:

http[s]://host/ibmcognos/cgi-bin/cognos.cgi

Nota: Os valores para host, ibmcognos e cognos.cgi são variáveis edependem das configurações exatas que foram usadas. Entre emcontato com o administrador do IBM Cognos para obter maisinformações sobre essas configurações.

Por exemplo: http://10.121.25.121/ibmcognos/cgi-bin/cognos.cgi

Se o sistema Cognos estiver usando Microsoft InternetInformation Services (IIS):

http://10.121.25.121/ibmcognos/cgi-bin/cognosisapi.dll

CAMSSLCertificate O caminho completo e nome do certificado SSL a ser usandodurante a conexão com o dispatcher interno.

Por exemplo: C:\AxTM1\Install_Dir\ssl\CognosCert.cer

Esse parâmetro apenas será necessário se o servidor IBM Cognosestiver configurado para SSL.

SkipSSLCAMHostCheck Indica se o processo de confirmação de ID do certificado SSLpode ser ignorado. O padrão é FALSE.

Importante: Esse parâmetro apenas deverá ser configuradocomo TRUE se estiver usando um certificado genérico parapropósitos de demonstração.

ClientPingCAMPassport Indica o intervalo, em segundos, que um cliente deve executarping no servidor IBM Cognos para manter seu passaporte ativo.

Caso ocorra algum erro ou o passaporte expire, o usuário serádesconectado do servidor TM1.

Exemplo: ClientPingCAMPassport=900

CAMPortalVariableFile O caminho para o arquivo variables_TM1.xml na instalação doCognos. Na maioria dos casos, o caminho será:

CAMPortalVariableFile = portal\variables_TM1.xml

O arquivo variables_TM1.xml é incluído para o TM1 iWidgets.Para obter detalhes sobre como instalar e configurar o Widgets,consulte “Cognos TM1 iWidgets e Cognos Workspace” napágina 72.

O parâmetro CAMPortalVariableFile apenas será necessário aoexecutar o TM1 Web.

O arquivo Tm1s.cfg deve conter parâmetros semelhantes ao seguinte:ServerCAMURI=http://10.111.25.121:9300/p2pd/servlet/dispatchClientCAMURI=http://10.111.25.121/cognos_location/cgi-bin/cognos.cgiClientPingCAMPassport=900CAMPortalVariableFile=templates\ps\portal\variables_TM1.xml

3. Configure o parâmetro IntegratedSecurityMode para o modo padrão 1.



Nota: A configuração do parâmetro IntegratedSecurityMode como 1 permiteconcluir etapas de configuração adicionais no TM1 usando a segurança padrãodo TM1 antes de alternar para a segurança do Cognos. Após concluir essasetapas adicionais, será possível alterar esse parâmetro para 4 ou 5 para usar asegurança do Cognos.

4. Salve e feche o arquivo Tm1s.cfg.5. Reinicie o servidor Cognos TM1.6. Execute as etapas necessárias para a instalação do Cognos BI.

v Defina um usuário do Cognos para funcionar como um administrador doCognos TM1.

v Importe os grupos do Cognos no Cognos TM1.Para obter detalhes, consulte “Gerenciando Usuários, Grupos e Objetos do TM1ao Usar a Segurança do Cognos” na página 223.

7. Configure o servidor do Cognos TM1 para iniciar o uso da autenticação doCognos.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 para indicar que o servidor

deverá usar a autenticação do Cognos.O valor de parâmetro exato depende dos componentes específicos doCognos TM1 que estão sendo usados:v Se você não estiver usando o componente do Cognos TM1 Applications,

configure o parâmetro como 4.IntegratedSecurityMode=4

v Se você estiver usando o Cognos TM1 Applications com a segurança doCognos, configure o parâmetro como 5 para suportar os grupos deusuários do Cognos TM1 e do Cognos.IntegratedSecurityMode=5

d. Salve e feche o arquivo Tm1s.cfg.e. Reinicie o servidor Cognos TM1.

O que Fazer Depois

Consulte os seguintes tópicos de configuração para concluir a configuração:v “Configurando os Clientes Cognos TM1 para Usarem a Segurança do Cognos”

na página 225v “Configurando o Cognos TM1 Web para usar a Segurança do Cognos” na

página 225v “Usando o Cognos TM1 Applications com a Segurança do Cognos” na página

228

Acesso Anônimo com o Servidor Cognos TM1 e a Segurança do Cognos:

Para definir com sucesso as configurações e os procedimentos para ativar aautenticação de segurança do IBM Cognos no servidor IBM Cognos TM1, oservidor Cognos não deverá ser configurado para permitir acesso anônimo.


Se o acesso anônimo for 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.

Gerenciando Usuários, Grupos e Objetos do TM1 ao Usar aSegurança do Cognos

Definindo um Usuário do Cognos para Atuar como um Administrador doCognos TM1 :

Para administrar o IBM Cognos TM1 com sucesso ao usar a segurança do IBMCognos Business Intelligence (BI) para autenticação, um usuário existente doCognos deverá ser incluído no grupo ADMIN do Cognos TM1 .

Este usuário do Cognos será usado para importar os grupos do Cognos no CognosTM1 .

Importante: As etapas iniciais dessa configuração deverão ser executadas com oparâmetro IntegratedSecurityMode do Cognos TM1 configurado como 1. Emseguida, você alterará esse parâmetro para usar a segurança do Cognos BI em umponto posterior nas etapas.

Procedimento

1. 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 servidordeve 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 TM1 :

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

Procedimento

1. 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 administradordo Cognos TM1 .

3. No Server Explorer, clique em Servidor, em seguida, em Segurança, emseguida, 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ários do TM1 ao Usar a Segurança do Cognos:

Quando 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 TM1 ao Usar a Segurança deAutenticação do Cognos:

Embora 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 os Clientes Cognos TM1 para Usarem a Segurançado CognosVocê deve incluir dois parâmetros no arquivo Tm1p.ini para permitir a execuçãodas tarefas administrativas relacionadas à segurança do IBM Cognos a partir docliente Cognos TM1.

Procedimento1. Abra o arquivo de configuração Tm1p.ini em um editor de texto.

Para obter informações sobre o local do arquivo Tm1p.ini, consulte “Local doArquivo Tm1p.ini” na página 329.

2. Inclua os seguintes parâmetros no arquivo Tm1p.ini.

Tabela 31. Parâmetros para o Arquivo Tm1p.ini


CognosGatewayURI O URI para o Cognos Business Intelligence (BI) Gateway. OURI é especificado no formulário

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 Cognos poderão ser importados noCognos TM1. Este parâmetro deve ser configurado como T aoconfigurar a segurança do Cognos no Cognos TM1 .

O arquivo Tm1p.ini deve incluir parâmetros semelhantes ao seguinte:AllowImportCAMClients = T

CognosGatewayURI = http://10.111.25.121/cognos_location/cgi-bin/cognos.cgi

3. Salve e feche o Tm1p.ini.4. Reinicie o cliente Cognos TM1.

Configurando o Cognos TM1 Web para usar a Segurança doCognosSiga estas etapas para configurar o IBM Cognos TM1 Web para usar a segurançade autenticação do IBM Cognos.

Antes de Iniciar

Nota: Se você aplicou um kit atualizador do Cognos Business Intelligence (BI) àinstalação do BI, poderá ser necessário fazer atualizações específicas no arquivotm1web.html.

O arquivo tm1web.html suporta o Cognos TM1 Web para usar a segurança deautenticação do IBM Cognos. No entanto, ele não será atualizado ao aplicar um kit


atualizador do Cognos BI. Em vez disso, um arquivo atualizado chamadotm1web.html.new será colocado no mesmo diretório do Cognos BI...\webcontent\tm1\web como o arquivo original. Use a versão mais recente dotm1web.html e atualize-o com todas as alterações feitas no arquivo originaltm1web.html.

Sobre Esta Tarefa

Estas etapas incluem editar os arquivos de configuração no sistema Cognos TM1Web e copiá-los para o sistema Cognos Business Intelligence (BI).

Procedimento1. Localize e extraia os arquivos a seguir no diretório de instalação do Cognos

TM1 Web.

variables_TM1.xml.sampleEsse arquivo está contido no arquivo compactado tm1web_app.zip.

tm1web.html.newEsse arquivo está contido no arquivo compactado tm1web_gateway.zip.

Os arquivos compactados são localizados no local a seguir:<TM1 installation location>\webapps\tm1web\bi_files

Por exemplo:C:\Program Files\IBM\cognos\tm1_64\webapps\tm1web\bi_files

2. Renomeie o arquivo variables_TM1.xml.sample para variables_TM1.xml.3. Renomeie o arquivo tm1web.html.new para tm1web.html.4. Copie os arquivos para a instalação do Cognos BI.

variables_TM1.xmlCopie esse arquivo para <Cognos location>\templates\ps\portal nosistema Cognos BI.

tm1web.htmlCopie esse arquivo para <Cognos location>\webcontent\tm1\web nosistema Cognos BI.

5. Edite o arquivo tm1web.html para apontar para onde o Cognos TM1 Web estáem execução.var tm1webServices = ["http://SystemName:PortNumber"];

Por exemplo:var tm1webServices = ["http://mysystem:9510"];

Configurando o Cognos TM1 Operations Console para usar asegurança do CognosÉ posível configurar o IBM Cognos TM1 Operations Console para usar a segurançado IBM Cognos Business Intelligence (BI), também chamada autenticação doCognos Access Manager (CAM).

Antes de Iniciar

Pelo menos um TM1 Server deve ser configurado para a segurança do IBM CognosBI. Isto é necessário a fim de armazenar as informações do grupo de usuários doOperations Console. Deve-se saber o nome deste TM1 Server para concluir asetapas neste tópico. Para concluir detalhes e etapas de configuração, consulte“Usando a Segurança do Cognos com o Cognos TM1” na página 219 e“Configurando o TM1 Server para Usar a Segurança do Cognos” na página 220


Sobre Esta Tarefa

Para configurar o Operations Console para usar a segurança do IBM Cognos BI,trabalhe com os arquivos nos computadores que hospedam estes doiscomponentes.

Procedimento1. Abra o hub do Performance Management indo para http://<host>:9510/

pmhub/pm/admin

2. Expanda Configurações >com.ibm.ba.pm.opsconsole.monitor.tm1.TM1OpsConsoleMonitor.

3. Clique emcom.ibm.ba.pm.opsconsole.monitor.tm1.TM1OpsConsoleMonitor.dictonary.

4. Verifique os valores nos campos DefaultAdminHost, DefaultGroup eDefaultServer. Consulte o “Configurando o Cognos TM1 Operations Console”na página 112.

5. Expanda com.ibm.ba.pm.resource.security.6. Clique em com.ibm.ba.pm.resource.security.dictonary.7. Configure o CAMGatewayURL para o gateway do Cognos BI Server. É

possível localizar este valor no Cognos Configuration no Ambiente > URI deGateway. O valor no parâmetro ClientCAMURI do arquivo tm1s.cfg deve sersemelhante. Por exemplo: http://host.domain.com/ibmcognos/cgi-bin/cognos.cgi

8. Configure CAMBIURL para a URL do dispatcher do Cognos BI Server. Épossível localizar este valor no Cognos Configuration em Ambiente > URI dedispatcher externo. O valor no parâmetro ServerCAMURI do arquivo tm1s.cfgdeve ser semelhante. Por exemplo: http://host.domain.com:9300/p2pd/servlet/dispatch

9. Copie o arquivo ..\tm1_64\bi_interop\bi_interop.zip do local de instalaçãodo TM1 para a raiz do diretório de instalação do Cognos BI Server (o diretório..\c10_64). Se estiver usando um ambiente do servidor Cognos BI distribuído,copie o arquivo para o computador que está executando a camada do IBMCognos BI Application ou a camada do Gateway.

10. Extraia o bi_interop.zip para que a estrutura de diretório seja mantida. Oarquivo pmhub.html deve estar no diretório ..\c10_64\webcontent.

11. Editar linha 51 no arquivo pmhub.html para incluir o nome de domíniocompleto e o número da porta do IBM Cognos TM1 Applications Service queexecuta o TM1 Operations Console.v Se você estiver utilizando o servidor da web Apache Tomcat fornecido com

o TM1, esse é o servidor no qual o TM1 Application Server está emexecução.

v Se estiver utilizando seu próprio servidor da Web, esse é o servidor no qualvocê implementou o pmhub.war.

Por exemplo:var pmhubURLs = ["http://tm1appshost.domain.com:9510"];

Também é possível incluir várias URLs se o TM1 Operations Console forutilizado em vários sistemas. Por exemplo:var pmhubURLs = ["http://tm1appshost1.domain.com:9510","http://tm1appshost2.domain.com:9510"];


Usando o Cognos TM1 Applications com a Segurança doCognosÉ 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. Essa configuração também integra o Cognos TM1 Applicationscom o Cognos BI exibindo os links para o Cognos TM1 Applications no portal doIBM Cognos Connection.

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 fornecido com a instalação

do Cognos TM1v Em um computador diferente com sua própria instalação do Apache Tomcat ou

o 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, deve-se editar o arquivo planning.html e copiar esse arquivopara o servidor do Cognos BI, para que o servidor do Cognos BI conheça o localdo Cognos TM1 Application Server.

Nota: Você deve ter a variável de ambiente TM1_PATH especificada antes deconectar ao Cognos TM1 em um ambienteUNIX.

Configurando Cognos TM1 Applications para Usar Segurança do CognosBusiness Intelligence:

Para configurar o IBM Cognos TM1 Applications para usar a segurança do IBMCognos Business Intelligence (BI), trabalhe com os arquivos nos computadores quehospedam esses dois componentes, mais o computador no qual o Cognos TM1Server está sendo executado. Essa configuração também permite que o portal doIBM Cognos Connection mostre os links do Cognos TM1 Applications para que osusuários possam abrir os aplicativos que eles têm o direito de dentro do portal doCognos Connection.

Antes de Iniciar

O servidor do Cognos TM1 deve ser configurado para usar a segurança do CognosBI.

Para usar o Cognos TM1 Applications com a segurança do Cognos BI, o parâmetroIntegratedSecurityMode no arquivo de configuração do Cognos TM1 Tm1s.cfgdeve ser configurado como 5 para suportar grupos de usuários do Cognos TM1 edo Cognos BI.

Para obter detalhes e etapas de configuração completos, consulte “Usando aSegurança do Cognos com o Cognos TM1” na página 219 e “Configurando o TM1Server para Usar a Segurança do Cognos” na página 220.

Nota: Será necessário configurar a variável de ambiente TM1_PATH antes de serpossível se conectar ao Cognos TM1 em um ambiente do UNIX.


Procedimento

1. Extraia o conteúdo do arquivo bi_interop.zip em sua instalação existente doCognos BI.

Nota: A partir do Cognos TM1 versão 10.2.2, o bi_interop.zip substitui oarquivo planning_gateway.zip fornecido com as versões anteriores do CognosTM1.a. Localize o arquivo bi_interop.zip fornecido com a instalação do Cognos

TM1 no local a seguir.Cognos TM1 location\bi_interop\

b. Extraia e mescle o conteúdo do arquivo bi_interop.zip no diretório raiz desua instalação existente do Cognos BI.Por exemplo: C:\Program Files\IBM\cognos\c10_64\

Nota: O arquivo bi_interop.zip contém uma estrutura de diretório quemescla os arquivos nos subdiretórios \templates e \webcontent.

c. Para extrair manualmente e copiar os arquivos para a instalação do CognosBI, copie os arquivos como a seguir:Se você estiver usando um ambiente do servidor Cognos BI distribuído,copie esses arquivos para o computador que está executando a camada doCognos BI Application ou a camada do Gateway da seguinte maneira.

planning.htmlCopie o planning.html para C10 Install Dir\webcontent em que oCognos BI Gateway está instalado.

icon_active_application.gifCopie o icon_active_application.gif para C10 InstallDir\webcontent\ps\portal\images em que o Cognos BI Gatewayestá instalado.

variables_plan.xmlCopie o variables_plan.xml para C10 Install Dir\templates\ps\portal sempre que o serviço de apresentação (camada doAplicativo) estiver em execução em um servidor Cognos BI.

Nota: Esses arquivos também são instalados com as mais novas instalaçõesdo Cognos BI. Se os arquivos existirem no servidor do Cognos BI, somenteserá necessário editá-los conforme explicado nessas etapas.

2. Edite o arquivo planning.html.

Importante: Os valores para o parâmetro planningServices nesse arquivo sãonecessários para assegurar-se de que o servidor do Cognos BI redireciona osusuários somente para locais aprovados. O local do Cognos TM1 ApplicationServer de onde o usuário efetua o login deve ser validado para ser um doslocais aprovados nesse arquivo. Caso contrário, o servidor do Cognos BI nãoredirecionará o usuário.a. Abra o arquivo planning.html e localize as linhas a seguir:

// Update the following to point to the location of the planningservice(s)

var planningServices = ["http://machine.company.com:9510"];

b. Configure o parâmetro planningServices para o local e o número de portapara o Cognos TM1 Application Server.var planningServices = ["http://web_server_address:port_number"];


Substitua web_server_address pelo nome completo do domínio (FQDN) parao computador no qual o Cognos TM1 Application Server está sendoexecutado. Por exemplo, myhost.example.comv 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 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 do Cognos BI paraautenticar diferentes instâncias do Cognos TM1 Applications que estão emexecução em diversos computadores, use uma lista separada por vírgulacom o nome completo do domínio (FQDN) para cada computador. Porexemplo:

var planningServices = ["http://machine1.example.com:port_number","http://machine2.example.com:port_number"];

Dica: Se o Cognos TM1 Application Server estiver em execução em umservidor da web que pertença a diversos domínios, use uma lista separadapor vírgulas para inserir o nome completo do domínio para cada domínio.Por exemplo:

var planningServices = ["http://computer_A.domain_1:port_number","http://computer_A.domain_2:port_number","http://computer_A.domain_3:port_number"];

c. Salve e feche o arquivo planning.html.3. 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” na página231.

4. Reinicie o servidor Cognos BI.5. 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 econfigure as opções para os clientes de contribuição de dados que desejausar. Para obter detalhes, consulte “Configurando o ambiente do servidore do cliente para o Cognos TM1 Application Web” na página 142.

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.

6. 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 suas configurações para o parâmetroplanningServices no arquivo planning.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 o Cognos TM1Applications e Segurança do Cognos BI:

Ao 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 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 minutos de inatividade após os

quais o Cognos TM1 Applications finaliza uma sessão do usuário. O valorpadrão é 60 minutos (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).

Procedimento

1. Configure o parâmetro de tempo limite da sessão pmpsvc.a. Localize o arquivo fpmsvc_config.xml no diretório WEB-INF/configuration.

v Quando o Cognos TM1 Applications é implementado com o ApacheTomcat que é fornecido com a instalação do Cognos TM1, o arquivofpmsvc_config.xml fica 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\Tomcatversion_number\webapps\pmpsvc\WEB-INF\configuration

b. Insira um valor para o atributo timeout do elemento service / session.


Use o formato para o atributo service / session / timeout, conformedefinido no arquivo de definição do esquema XML fpmsvc_config.xsdlocalizado no mesmo diretório.Por exemplo:<session timeout=“60”/>

2. No sistema Cognos BI, configure o tempo limite da sessão do CAM usando oIBM Cognos Configuration.Insira um valor no campo Tempo Limite de Inatividade em Segundos naseção Segurança/Autenticação do Cognos Configuration.

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 o

parâ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 a segurançado IBM Cognos (incluindo o Cognos TM1) que sejam configurados para referenciaro mesmo servidor IBM Cognos ocorrerão automaticamente, desde que o passaportede 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, após se conectar aoprimeiro servidor como 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 porta


segura, 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 o IBM Cognos TM1 é instalado, todos os certificados e outros arquivosnecessários 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 o Cognos TM1 , o Admin Server, o servidor Cognos TM1 e o clienteCognos TM1 são instalados, todos eles são configurados para usar SSL, com basenos 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 de

TM1 Client Mais Antigo (Pré-9.1)Não configurado para usar SSL

Este cliente contatará o Servidor Administrativo na porta não segura e receberá uma lista apenas dos TM1 Servers que não estão configurados para usar SSL. Estes são os únicos servidores comos quais o cliente poderá estabelecer conexões inseguras; quaisquer servidores TM1 configurados para usar SSL não ficarão visíveispara este cliente.

Este cliente contatará o Servidor Administrativo na porta segura e receberá uma lista de todos os servidores TM1 disponíveis na rede.

O cliente estabelecerá conexões seguras com servidores TM1 configurados para usar SSL e estabelecerão conexões inseguras com servidores TM1 quenão estão configurados para usar SSL.

Cliente do TM1 (9.1 ou posterior)Configurado para usar SSL

TM1 Admin Server Configurado para atender conexões do clienteem portas seguras e não seguras

Configurado para SSLServidores do TM1

Não configurado para SSLServidores do TM1

Figura 12. Usando SSL para Segurança de Transmissão de Dados


revogaçã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úblicav 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 dh2048.pem - o arquivo que contém a chave de 2048 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.


Suporte para clientes nãoSSL?

Este parâmetro determina se o Servidor Administrativosuporta clientes Cognos TM1 não SSL.

Configure esse parâmetro como True para configurar oServidor Administrativo para suportar clientes não SSL epara receber conexões do cliente em portas seguras (SSL) enão seguras.

Configure esse parâmetro como False para configurar oServidor Administrativo para suportar apenas conexões declientes SSL em uma única porta segura.



Local do arquivo deautoridade de certificação doTM1 Admin Server

O caminho completo e nome do arquivo de autoridade decertificação do Cognos TM1 Admin Server.

Local do arquivo decertificação

O caminho completo do arquivo de certificado do CognosTM1 Admin Server, que contém o par de chavespública/privada.

Local do arquivo-chaveDiffie-Hellman de 512 bits

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.

Local do arquivo-chaveDiffie-Hellman de 1024 bits

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.

Local do arquivo de senha dachave privada do TM1Admin Server

O caminho completo do arquivo que contém a senhacriptografada para a chave privada do Cognos TM1 AdminServer.

Local do arquivo de chave desenha do TM1 Admin Server

O caminho completo do arquivo que contém a chave usadapara criptografar e decriptografar a senha para a chaveprivada.

Exportar certificado do TM1Admin Server?

Especifica se o certificado do Cognos TM1 Admin Serverdeve ser exportado a partir do armazenamento decertificados do Windows.

Se este parâmetro for configurado como True, o certificadodo servidor administrativo será exportado doarmazenamento de certificados do Windows quando ocertificado for solicitado pelo Servidor Administrativo.

Para obter detalhes sobre como usar seus próprioscertificados de segurança e como exportar certificados doarmazenamento de certificados do Windows, consulte“Usando bCertificados Independentes com SSL e CognosTM1” na página 250.

ID do certificado do TM1Admin Server

Especifica o nome do principal para quem o certificado doCognos TM1 Admin Server é emitido.



Local do arquivo derevogação de certificado

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 um certificado ser revogado.

ID da chave de exportaçãodo TM1 Admin Server

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.

Versão do Certificado doTM1 Admin Server

Especifica qual versão dos certificados SSL gerados peloTM1 deve ser usada.

Por padrão, a versão de criptografia de 1024 bits doscertificados gerados pelo TM1 é usada.

Apenas altere esse parâmetro se você desejar usar a novaversão de criptografia de 2048 bits dos certificados padrão.É possível usar a nova versão com os clientes TM1 novos eantigos, mas você deverá configurar os clientes para usaremo novo arquivo de autoridade de certificação.

Nota: Esse parâmetro não se aplicará se você estiverusando seus próprios certificados SSL.

Os valores válidos são:

v 1 - Ativa a autoridade de certificação para a criptografiade 1024 bits com o sha-1 (valor padrão)

v 2 - Ativa a autoridade de certificação para a criptografiade 2048 bits com o sha-256

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

A tabela a seguir descreve os parâmetros relacionados a SSL que podem serdefinidos no arquivo de configuração Tm1s.cfg. Observe que esta tabela descreveapenas os parâmetros Tm1s.cfg que estão relacionados a SSL;todos os outrosparâmetros Tm1s.cfg são descritos em “Parâmetros no arquivo tm1s.cfg” na página272.


UseSSL Ativa ou desativa o SSL no servidor CognosTM1 .

Este parâmetro é ativado por padrão.

Configure o UseSSL=F para desativar o SSL.Com esta configuração, os clientes poderãose conectar ao servidor no modo inseguro.



AdminSvrSSLCertID Especifica o nome do principal para quem ocertificado do Cognos TM1 Admin Server éemitido.

O valor deste parâmetro deve ser idêntico aoparâmetro TM1 Admin Server CertificateID definido no IBM Cognos Configuration.

Se o AdminSvrSSLCertID estiverconfigurado incorretamente, o menususpenso do servidor no Cognos TM1 Webserá exibido como vazio e um erro seráregistrado no 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 servidoradministrativo do Cognos TM1 . Umarquivo de revogação de certificado existiráapenas no caso de um certificado ter sidorevogado

ExportAdminSvrSSLCert Especifica se o certificado do Cognos TM1Admin Server deve ser exportado a partirdo armazenamento de certificadosdoWindows.

Se ExportAdminSvrSSLCert=T, O certificadodo Servidor Administrativo será exportado apartir do armazenamento de certificadoMicrosoft Windows quando o certificado forsolicitado pelo servidor do Cognos TM1 .

Se ExportAdminSvrSSLCert=T, deve-setambém configurar os parâmetros tm1s.cfg aseguir:

v AdminSvrSSLCertID

v AdminSvrSSLExportKey

v SvrSSLExportKeyID

v SSLCertificateID

v SSLPwdKeyFile

v SSLPrivateKeyPwdFile

v SSLCertAuthority

v ClientExportSSLSvrCert



AdminSvrSSLExportKeyID Especifica a chave de identidade usada paraexportar o certificado do ServidorAdministrativo a partir do armazenamentode certificados do Microsoft Windows.

Este parâmetro é necessário apenas se vocêescolher usar o armazenamento decertificados configurandoExportAdminSvrSSLCert=T.

SSLCertificate O caminho completo do arquivo decertificado que contém o par de chavespública/privada.

SSLCertAuthority O nome do arquivo de autoridade CognosTM1 ICAS. Este arquivo deve residir nocomputador no qual o servidor Cognos TM1está instalado.

SSLCertRevocationFile O nome do arquivo de do certificadoCognos TM1 ICAS. Um arquivo derevogação de certificado existirá apenas nocaso de um certificado ter sido revogado.Este arquivo deve residir no computador emque o servidor Cognos TM1 está instalado.

SSLCertificateID O nome principal para quem o certificadodo ICAS é emitido.

CertificateVersion Especifica qual versão dos certificados SSLgerados pelo TM1 deve ser usada.

Apenas altere esse parâmetro se você desejarusar a nova versão de criptografia de 2048bits dos certificados padrão.

É possível usar a nova versão com osclientes TM1 novos e antigos, mas vocêdeverá configurar os clientes para usarem onovo arquivo de autoridade de certificação.

Os valores válidos incluem

v 1 - Ativa a autoridade de certificação paraa criptografia de 1024 bits com o sha-1(valor padrão)

v 2 - Ativa a autoridade de certificação paraa criptografia de 2048 bits com o sha-256

:



ExportSvrSSLCert Especifica se o certificado do administrativoCognos TM1 ICAS deve ser exportado doarmazenamento de certificados MicrosoftWindows.

Se ExportSvrSSLCert=T, o certificado TM1será exportado a partir do armazenamentode certificado Microsoft Windows quando ocertificado for solicitado pelo servidor doCognos TM1 server.

Se ExportSvrSSLCert=T, deve-se tambémconfigurar os parâmetros tm1s.cfg a seguir:

v AdminSvrSSLCertID

v AdminSvrSSLExportKey

v SvrSSLExportKeyID

v SSLCertificateID

v SSLPwdKeyFile

v SSLPrivateKeyPwdFile

v SSLCertAuthority

v ClientExportSSLSvrCert

Para obter detalhes sobre como usar seuspróprios certificados de segurança e comoexportar certificados do armazenamento decertificados do Microsoft Windows, consulte“Usando bCertificados Independentes comSSL e Cognos TM1” na página 250.

SvrSSLExportKeyID Especifica a chave de identidade usada paraexportar o certificado do TM1 Admin Servera partir do armazenamento de certificadosdo Microsoft Windows.

Este parâmetro será necessário apenas sevocê escolher usar o armazenamento decertificados definindo ExportSvrSSLCert=T.

SSLPrivateKeyPwdFile O caminho completo do arquivo .dat quecontém a senha criptografada para a chaveprivada.

SSLPwdKeyFile O caminho completo do arquivo .dat quecontém a 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 cliente dopara exportar o certificado de autoridade, docertificado que foi originalmente usado paraemitir o certificado do servidor Cognos TM1ICAS a partir do armazenamento decertificado 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.

DHFile-2048 O nome do caminho completo do arquivoque contém a chave de 2048 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 2048 bits pode sergerada previamente e armazenada em umarquivo que é chamado quando o servidorCognos TM1 é iniciado.


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 Cognos TM1 AdminServer seja exportado a partir doarmazenamento 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 Cognos TM1 AdminServer, a partir do armazenamento decertificados.

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ê deverá incluir um certificado nokeystore do Java Runtime Environment (JRE).

Antes de Iniciar

Por padrão, o Cognos TM1 Web usa os certificados SSL padrão incluídos comoparte da instalação do Cognos TM1. Para usar seus próprios certificados SSLcustomizados, inclua o certificado no keystore do Java Runtime Environment (JRE).

Procedimento1. Abra o IBM Cognos Configuration e insira a URL de HTTPS segura para os

seguintes parâmetros:v URI do TM1 Application Server Gateway - Por exemplo,

http://system_name:9514/pmpsvc

v URI do servidor externo - Por exemplo, http://system_name:9514Insira o nome do sistema e os números da porta para a configuração específica.

2. Para instalações de 32 bits:


a. Abra um prompt de comandos e altere o diretório para o local do JRE quefoi fornecido com a instalação do Cognos TM1.tm1_location\bin\jre\7.0\bin

Por exemplo:C:\Program Files\IBM\cognos\tm1\bin\jre\7.0\bin>

b. Execute o comando keytool do Java para importar o certificado no keystore.

Nota: Para propósitos de formatação, o comando é mostrado aqui comquebras de linha, mas você deve inserir o comando todo em uma linha.keytool.exe -import -trustcacerts -file“c:\Program Files\ibm\cognos\tm1\bin\ssl\your_certificate.pem”-alias your_certificate -keystore"c:\Program Files\ibm\cognos\tm1\bin\jre\7.0\lib\security\cacerts"

Substitua your_certificate.pem e your_certificate pelo nome do arquivo e onome do seu próprio certificado.

c. Insira yes quando solicitada a confiança ou inclua o certificado.

A seguinte mensagem será exibida: O certificado foi incluído no keystore.3. Para instalações de 64 bits:

Atenção: Em computadores de 64 bits, certifique-se de incluir os certificados napasta bin64.a. Abra um prompt de comandos e altere o diretório para o local do JRE que

foi fornecido com a instalação do Cognos TM1.C:\Program Files\ibm\cognos\TM1_64\bin64\jre\7.0\bin

b. Execute o comando keytool do Java para importar o certificado no keystore.Para instalações de 64 bits, destine a pasta de 64 bits ao tratar com oscertificados. Se você não destinar corretamente os locais de certificados de64 bits ao executar uma instalação de 64 bits, receberá uma mensagem deaviso indicando que não é possível contatar os servidores.

Nota: Para propósitos de formatação, este comando é mostrado comquebras de linha, mas você deve inserir o comando todo em uma linha.keytool.exe -import -trustcacerts -file"c:\Program Files\ibm\cognos\TM1_64\bin64\ssl\your_certificate.pem"-alias your_certificate -keystore"c:\Program Files\ibm\cognos\TM1_64\bin64\jre\7.0\lib\security\cacerts"

Substitua your_certificate.pem e your_certificate pelo nome do arquivo e onome do seu próprio certificado.

c. Insira yes quando solicitada a confiança ou inclua o certificado.

A seguinte mensagem será exibida: O certificado foi incluído no keystore.4. Use o IBM Cognos Configuration para reiniciar o TM1 Application Server e

fazer com que as mudanças entrem em vigor.a. No Cognos Configuration, expanda o nó Ambiente, clique com o botão

direito do mouse em TM1 Application Server e selecione Parar.b. Clique com o botão direito do mouse em TM1 Application Server e

selecione Iniciar.

Lembre-se: Inclua os certificados novamente sempre que reinstalar o CognosTM1.


Resultados

Efetue login no Cognos TM1 Web usando a URL de HTTPS segura para confirmarque é possível se conectar ao Cognos TM1 usando essa configuração.

Para esse exemplo, efetue login usando https://system_name:9514/tm1web.

Configurando o Cognos TM1 Applications para Usar SSLPara configurar o IBM Cognos TM1 Applications para usar o SSL, configure o SSLpara outros componentes do Cognos TM1 que interagem com o Cognos TM1Applications, configure os servidores da web que suportam o Cognos TM1Applications e edite a configuração do Cognos TM1 Applications.

Antes de Iniciar

Instale e configure Cognos TM1 Applications sem SSL e assegure-se de poderexecutar e efetuar login no programa.

Sobre Esta Tarefa

Algumas das tarefas para usar um certificado de outra autoridade de certificaçãousam uma ferramenta de linha de comandos chamada ThirdPartyCertificateTool.Essa ferramenta está localizada em C:\Program Files\ibm\cognos\tm1_64\bin. Paraobter mais informações sobre essa ferramenta, consulte “Referência de linha decomandos ThirdPartyCertificateTool” na página 255.

Procedimento1. Configure TM1 Admin Server para usar SSL.

Consulte o “Configurando o Cognos TM1 Admin Server para Usar SSL” napágina 235.

2. Configure TM1 Server para usar SSL.Consulte o “Configurando o Servidor Cognos TM1 para Usar SSL” na página237.

3. Configure TM1 Web para usar SSL.Consulte o “Configurando o Cognos TM1 Web para Usar SSL” na página 243.

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 AdminServer.Consulte o “Editando Parâmetros SSL no Cognos Configuration para UsarCertificados Independentes” na página 252.

b. No computador executando Cognos TM1 Server, execute a ferramentatm1crypt.exe

Consulte o “Executando o Utilitário TM1Crypt” na página 251.c. Para o Cognos TM1 Applications, consulte “Importando certificados SSL

CA de terceiros no TM1 Application Server” na página 246.6. Na ferramenta Cognos Configuration, altere o URI do TM1 Application

Server Gateway e o URI de Servidor Externo para usar o prefixo https.7. Salve a configuração e reinicie o TM1 Applications Server.


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 éo nome 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 mesmonome deverá 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:9510/tm1web/Contributor.jsp

e. Clique em OK.10. Importe o certificado SSL do TM1 Applications para o keystore do cliente

Java.a. Exporte o certificado SSL raiz do TM1 Applications:

Quebras de linha mostradas somente para fins de publicação.cd <install>\tm1_64\binThirdPartyCertificateTool.bat -E -T -rc:\tmp\cacert.cer -k"<install>/tm1_64/configuration/signkeypair/jCAKeystore"-p NoPassWordSet

b. Importe o certificado ssl para o keystore do Java.cd <install>\tm1_64\bin64\jre\7.0\binkeytool -import -file c:\tmp\cacert.cer -keystore "<install>\tm1_64\bin64\jre\7.0\lib\security\cacerts"-storepass changeit -alias TM1ApplicationsSSL

Importando certificados SSL CA de terceiros no TM1 ApplicationServerUse estas instruções gerais como um exemplo para importar e usar os certificadosSSL de autoridade de certificação (CA) de terceiros com o TM1 Application Server.


Sobre Esta Tarefa

As etapas exatas dependem de quais ferramentas de terceiros serão usadas.

Algumas das tarefas para usar um certificado de outra autoridade de certificaçãousam uma ferramenta de linha de comandos chamada ThirdPartyCertificateTool.Essa ferramenta está localizada em C:\Program Files\ibm\cognos\tm1_64\bin. Paraobter mais informações sobre essa ferramenta, consulte “Referência de linha decomandos ThirdPartyCertificateTool” na página 255.

Procedimento1. Crie um certificado de CA autoassinado.

Por exemplo, a amostra a seguir usa o OpenSSL para criar um certificado deCA autoassinado chamado app_ca.pem.openssl req -new -x509 -extensions v3_ca -keyout app_ca/private/app_cakey.pem -out app_ca/app_ca.pem -days 3650 -config./bi_ca_openssl.cnf

2. Crie a solicitação de assinatura de certificado para a chave de assinatura.Por exemplo, use a linha a seguir como um modelo.ThirdPartyCertificateTool.bat -java:local -c -s -d"CN=TM1_Signer,O=IBM_TM1,ST=MA,C=US" -r signRequest.csr -D "c:\ProgramFiles\ibm\cognos\tm1_64\configuration\signkeypair" -p password..\bin\jre\7.0\bin\java.execom.cognos.accman.jcam.utilities.ThirdPartyCertateTool -c -s -d"CN=TM1_Signer,O=IBM_TM1,ST=MA,C=US" -r signRequest.csr -D ProgramFiles\ibm\cognos\tm1_64\configuration\signkeypair" -p password

3. Crie a solicitação de assinatura de certificado para a chave de criptografia.ThirdPartyCertificateTool.bat -java:l -c -e -d"CN=aplxprince.swg.usma.ibm.com,O=IBM_TM1,ST=MA,C=US" -rencryptRet.csr -D "c:\Program Files\ibm\cognos\tm1_64\configuration\encryptkeypair" -p password

4. Copie os arquivos signRequest.csr e encryptRequest.csr em um diretórioacessível à autoridade de certificação.

5. Insira os arquivos signRequest.csr e encryptRequest.csr na autoridade decertificação e gere os certificados.Por exemplo, a amostra a seguir usa o OpenSSL para essa etapa.C:\openssl.exe ca -out signRequest.pem -config ./bi_ca_openssl.cnf-infiles signRequest.csr

C:\openssl.exe ca -out encryptRequest.pem -config ./bi_ca_openssl.cnf-infiles encryptRequest.csr

6. Renomeie signRequest.pem, encrpytRequest.pem e app_ca.pem.Para esse exemplo, os arquivos são renomeados para signCertificate.cer,encryptRequest.cer e ca.cer.

7. Insira os três certificados de CA no armazenamento de certificados do IBMCognos.ThirdPartyCertificateTool.bat -java:local -i -s -r signCertificate.cer-D "c:\Program Files\ibm\cognos\tm1_64\configuration\signkeypair" -ppassword -t ca.cer

ThirdPartyCertificateTool.bat -java:local -i -e -r signCertificate.cer-D "c:\Program Files\ibm\cognos\tm1_64\configuration\encryptkeypair" -ppassword -t ca.cer


ThirdPartyCertificateTool.bat -java:local -i -T -r ca.cer -D"c:\Program Files\ibm\cognos\tm1_64\configuration\signkeypair" -ppassword

8. Abra a Configuração do Cognos e configure a propriedade avançadaStandaloneCertificateAuthority para true.a. Selecione Configuração local, clique em Clicar para editar o Botão e, em

seguida, clique em Incluir.b. Digite StandaloneCertificateAuthority na caixa Nome.c. Digite True na caixa Valor.d. Clique em OK.

Atenção: Se você não configurar a propriedade avançadaStandaloneCertificateAuthority como true, quando tentar salvar aconfiguração no Cognos Configuration, a mensagem a seguir aparecerá:

[Cryptography] [ ERRO ] CAM-CRP-1132 Ocorreu um erro durante a tentativade solicitar um certificado do serviço de Autoridade de Certificação. O serviçode Autoridade de Certificação retornou o seguinte erro: CAM-CRP-1039Impossível gerar um novo certificado. Ocorreu um erro ao atualizar o númerode série da autoridade de certificação. Motivo: java.io.FileNotFoundException

9. Em Configuração do Cognos, certifique-se de que o URI do TM1 ApplicationServer Gateway está configurado como host local.a. Expanda o nó Ambiente > TM1 Application Server.b. Verifique o valor da propriedade URI do TM1 Application Server

Gateway.http://localhost:9510/pmpsvc

10. Em Configuração do Cognos, insira a mesma senha que você usou em outrasetapas nos locais a seguir:v Segurança > Criptografia > Cognos > Configurações de chave de

assinatura > Senha de armazenamento de chaves de assinatura

v Segurança > Criptografia > Cognos > Configurações de chave decriptografia > Senha de armazenamento de chaves de criptografia

11. Reinicie o TM1 Application Server.a. Em Configuração do Cognos, expanda o nó Ambiente > TM1 Application

Server.b. Clique com o botão direito em TM1 Application Server e selecione Parar

e, em seguida, Iniciar.

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 do TM1 C para UsarSSL” no IBM Cognos TM1 API Guide.

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, você devefornecer 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 bCertificados Independentes com SSL e Cognos TM1Embora 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 32. Opções para o Utilitário TM1Crypt

Opção Descrição

-pwd A senha para a chave privada. Deveria ser a mesma senha usada paracriptografar seu certificado.

-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, o TM1Crypt gerará um arquivochamado tm1key.dat.

Nota: O nome do arquivo para a opção -keyfile também é usado com oparâmetro SSLPwdKeyFile no Cognos Configuration e no arquivotm1s.cfg.

-outfile O nome do arquivo .dat que será gerado para conter a senhacriptografada para a chave privada.

Se esse parâmetro não for especificado, o TM1Crypt gerará um arquivochamado tm1cipher.dat.

Nota: O nome do arquivo para a opção -outfile também é usado com oparâmetro SSLPrivateKeyPwdFile no Cognos Configuration e no arquivotm1s.cfg.

-validate Se você incluir o parâmetro -validate, o utilitário decriptografará a senhacriptografada e exibirá os resultados 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 33. Parâmetros SSL no Cognos Configuration que Suportam CertificadosIndependentes


Exportar certificado doTM1 Admin Server?

Este parâmetro deve ser configurado como True para permitirque o Servidor Administrativo recupere o certificado doArmazenamento de Certificados.

Local do arquivo deautoridade decertificação do TM1Admin Server

O caminho completo e o nome do arquivo da autoridade decertificação que emitiu o certificado do TM1 Admin Server.

É possível determinar esse valor consultando MicrosoftManagement Console e clicando em Certificados > Pessoais >Certificados. O nome da autoridade é exibido na coluna Emitidopor da área de janela de Propriedades.

ID do certificado doTM1 Admin Server

O nome do principal para quem o certificado do IBM CognosTM1 Admin Server é emitido.

É possível determinar esse valor consultando MicrosoftManagement Console e clicando em Certificados > Pessoais >Certificados. O nome do principal é exibido na coluna Emitidopara da área de janela de Propriedades.


Tabela 33. Parâmetros SSL no Cognos Configuration que Suportam CertificadosIndependentes (continuação)


Local do arquivo desenha da chave privadado TM1 Admin Server

O caminho completo para o arquivo .dat que contém a senhacriptografada para a chave privada.

Nota: 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 a partir doseguinte comando:

tm1crypt.exe -pwd abc123 -keyfile btkey.dat -outfilebtprk.dat -validate

o valor de parâmetro correto é:

C:\Program Files\Cognos\TM1\bin\btprk.dat

Local do arquivo dechave de senha do TM1Admin Server

O caminho completo para o arquivo .dat que contém a chaveusada para criptografar e decriptografar a senha para a chaveprivada.

Nota: 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 a partir doseguinte comando:


o valor de parâmetro correto é:

C:\Program Files\Cognos\TM1\bin\btkey.dat

ID da chave deexportação do TM1Admin Server

Especifica a chave de identidade usada para exportar ocertificado do Servidor Administrativo do armazenamento decertificados do Windows.

Na maioria dos casos, o valor para ID da chave de exportaçãodo TM1 Admin Server será idêntico ao valor de ID decertificado do TM1 Admin Server.

Editando os Parâmetros SSL no Arquivo Tm1s.cfg para UsarCertificados IndependentesDepois de incluir seu certificado do Microsoft Windows Certificate Store, inclua osparâmetros SSL exigidos no arquivo Tm1s.cfg.

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


Tabela 34. Parâmetros SSL para o Arquivo Tm1s.cfg (continuação)

Parâmetro Valor

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 certificados doMicrosoft Windows.

ExportAdminSvrSSLCert Especifica se o certificado do servidor administrativoCognos TM1 deve ser exportado do armazenamento decertificados 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 permtirque o servidor Cognos TM1 recupere o certificado a partirdo armazenamento de certificados do Microsoft Windows.

ExportSvrSSLCert=T

SSLCertAuthority O nome da autoridade que emitiu seu certificado.

É possível determinar esse valor consultando o MicrosoftManagement Console e clicando em Certificados > Pessoal> 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 servidorCognos TM1 é emitido.

É possível determinar esse valor consultando o MicrosoftManagement Console e clicando em Certificados > Pessoal> Certificados. O nome do principal é exibido na colunaEmitido por da área de janela de Propriedades.

SSLPrivateKeyPwdFile O caminho completo para o arquivo .dat que contém asenha criptografada para a chave privada.

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


o valor de parâmetro correto é SSLPrivateKeyPwdFile=C:\Program Files\Cognos\TM1\bin\btprk.dat


Tabela 34. Parâmetros SSL para o Arquivo Tm1s.cfg (continuação)

Parâmetro Valor

SSLPwdKeyFile O caminho completo para o arquivo .dat que contém achave usada para criptografar e decriptografar a senha paraa chave privada.

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


o valor de parâmetro correto é SSLPwdKeyFile=C:\ProgramFiles\Cognos\TM1\bin\btkey.dat

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çãoIBM Cognos TM1 apropriados para apontar para seus arquivos independentes.

Referência de linha de comandos ThirdPartyCertificateToolAlgumas das tarefas para usar um certificado de outra autoridade de certificaçãousam uma ferramenta de linha de comandos chamada ThirdPartyCertificateTool.

Essa ferramenta está localizada no local de instalação do Cognos TM1 a seguir\bin.

Por exemplo: C:\Program Files\IBM\cognos\tm1_64\bin

Nos sistemas operacionais UNIX ou Linux, use o formato a seguir:

ThirdPartyCertificateTool.sh parameters

Em sistemas operacionais Microsoft Windows, use o formato a seguir:

ThirdPartyCertificateTool.bat parameters

As tabelas a seguir listam as opções para essa ferramenta de linha de comandos.

Tabela 35. Modo de operação principal

Comando Descrição

-c Crie um novo CSR

-i Importe um certificado


Tabela 36. Modificadores de operação

Comando Descrição

-s Trabalhe com a identidade de assinatura

-e Trabalhe com a identidade de criptografia

-T Trabalhe com armazenamento confiável (somente com -i)

Tabela 37. Sinalizadores de informações

Comando Descrição

-d DN para usar para o certificado

-r CSR ou local de arquivo de certificado (depende do modo)

-t Arquivo de certificado de autoridade de certificação (somente com -i)

-p Senha do armazenamento de chaves

-a Algoritmo de par de chaves: RSA ou DSA. RSA é o valor padrão.

-D Local do diretório

Os valores de amostra da tabela a seguir são usados:

Tabela 38. Valores de amostra

Propriedade Valor

Nome distinto (DN) docertificado de assinatura

Um valor exclusivo, formatado como a seguir:

CN=SignCert,O=MyCompany,C=CA

DN de certificado decriptografia

Um valor exclusivo, formatado como a seguir:

CN=EncryptCert,O=MyCompany,C=CA

Senha do armazenamento dechaves

senha


Capítulo 16. Manutenção de sua Instalação do Cognos TM1

Depois de instalar com êxito o IBM Cognos TM1, você pode executar tarefas demanutenção como instalar componentes adicionais, fazendo backup e restaurarseus dados e arquivos de configuração e desinstalar 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.

Fazendo Backup de Dados e Arquivos de ConfiguraçãoVocê deve fazer backup regularmente de seus dados e arquivos deconfiguração, especialmente antes de atualizar para uma nova versão doCognos TM1.

Desinstalando a versão atualDependendo de quais componentes do Cognos TM1 você instalou, vocêpoderá ter que executar etapas separadas para removê-los. Por exemplo, oIBM Cognos Insight e o IBM Cognos TM1 Performance Modeler sãodesinstalados de forma diferente do que os outros componentes do IBMCognos TM1.

Fazendo Backup de Dados e Arquivos de Configuração para CognosTM1

Este tópico descreve como fazer o backup dos dados e arquivos de configuraçãopara os componentes do IBM Cognos TM1 versão 10.2.

Sobre Esta Tarefa

Cada componente do Cognos TM1 tem seu próprio conjunto de dados relacionadase arquivos de configuração. Reveja e siga as etapas abaixo para fazer backup dedados e informações de configuração para os componentes que você está usando.

Por exemplo:v Para cada servidor IBM Cognos TM1 que você está executando, faça backup de

seus arquivos de configuração e diretório de dados do Cognos TM1.v Se você estiver usando o Cognos TM1 Web, você deve fazer backup dos dados

relacionados e arquivos de configuração para esse componente.v Se você estiver usando os Cognos TM1 Applications, você deve exportar seus

aplicativos e fazer backup de quaisquer outros arquivos relacionados.

Procedimento1. Exporte as definições de configuração a partir do IBM Cognos Configuration:

Se você tiver usado o utilitário Cognos Configuration para executar e gerenciaros componentes do Cognos TM1, como o Cognos TM1 Admin Server, osservidores Cognos TM1, ou o Cognos TM1 Application Server, será possívelsalvar um arquivo XML com suas informações de configuração.a. Abra o Cognos Configuration.b. Clique em Arquivo > Exportar Como.c. Selecione um local e insira um nome do arquivo para o arquivo XML.d. Clique em Salvar.


2. Faça backup dos bancos de dados Cognos TM1 Server:Salve uma cópia do conteúdo dos diretórios de dados do banco de dados IBMCognos TM1 e subdiretórios para um local seguro. Esses diretórios contêm osarquivos de configuração e dados. Por exemplo, os diretórios e subdiretórios debanco de dados de amostras Cognos TM1 estão localizados aqui:<TM1_Install>\samples\tm1

3. Faça backup dos arquivos de configuração adicionais do Cognos TM1:Salve uma cópia de quaisquer arquivos de configuração do Cognos TM1 quevocê talvez queira reter, como o arquivo de propriedade de criação de log doCognos TM1 Admin Server, tm1admsrv-log.properties, localizado no diretório<TM1_Install>\bin\.

4. Faça backup do Cognos TM1 Web:Se você usar o Cognos TM1 Web, faça o backup do arquivo tm1web_config.xmle de quaisquer páginas customizadas do servidor Cognos TM1 Web para umlocal seguro. A localização padrão para esses arquivos é:<TM1_Install>\webapps\tm1web\

<TM1_Install>\webapps\tm1web\web-inf\configuration\

5. Faça backup do Cognos TM1 Architect e Cognos TM1 Perspectives:Se você estiver usando o Cognos TM1 Architect ou Cognos TM1 Perspectives,salve o arquivo de configuração do cliente Tm1p.ini a partir de:v %ALLUSERSPROFILE%\Application Data\Applix\TM1\

v %USERPROFILE%\Application Data\Applix\TM1\

Na maioria dos casos, os caminhos completos para esses arquivos são:v C:\Documents and Settings\All Users\Application Data\Applix\TM1\

Tm1p.ini

v C:\Documents and Settings\<username>\Application Data\Applix\TM1\Tm1p.ini

6. Faça backup do Cognos TM1 Applications:Se você usar o Cognos TM1 Applications, consulte as etapas a seguir para fazerbackup dos arquivos de configuração e dados relacionados.v “Fazendo Backup de seus dados do Cognos TM1 Applications” na página

261v “Exportando os Aplicativos do Cognos TM1 Applications” na página 261

Modificando Componentes Instalados do Cognos TM1Você pode modificar sua instalação atual, reinstalando os componentes ouadicionando os componentes que ainda não estão instalados.

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.

Nota: A manutenção do programa não inclui alterar o local do diretório deinstalação do Cognos TM1. Para alterar o local do diretório de instalação, removatodos os arquivos do Cognos TM1 e reinstale o Cognos TM1 em um outro local.

Procedimento1. Para iniciar a instalação:

v Vá para o local de download para o programa de instalação do Cognos TM1.


v Ou insira o disco do produto IBM Cognos TM1.Se o assistente de instalação não abrir automaticamente, vá para o diretóriodo sistema operacional para localizar o arquivo issetup.exe.

2. Dependendo do software do sistema operacional, clique com o botão direito domouse ou dê um clique duplo no arquivo issetup.exe:v 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.

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

3. Clique em Avançar para avançar para a tela Seleção de Componentes.Se for solicitado, responda as perguntas a seguir:v Confirme se você deseja instalar no mesmo local da instalação anterior.v Confirme se você deseja ou não criar um backup de todos os arquivos a

partir da instalação existente.4. Na tela Seleção de Componentes, selecione os componentes do Cognos TM1

que você deseja instalar e clique em Avançar.A tela Seleção de Componentes mostra o estado atual de sua instalação doCognos TM1.v Os itens que estão instalados no momento são exibidos com um ícone de X

vermelho próximo ao nome do componente.v Os itens que não estão instalados no momento são exibidos com uma marca

de seleção verde próximo ao nome. Esses itens são automaticamenteselecionados para a instalação.

5. Clique em Avançar para iniciar as modificações.6. Clique em Concluir quando as modificações forem concluídas.

Desinstalando o Cognos TM1Para remover e desinstalar todos os componentes do IBM Cognos TM1 versão 10.x,siga estas etapas.

Nota: Se você estiver desinstalando Cognos TM1 Applications, consulte a seção“Desinstalando e Implementando o Cognos TM1 Applications” na página 260 paraobter etapas exigidas adicionais.

Antes de Iniciar

Antes de começar a desinstalar o Cognos TM1 10.1, você deverá concluir o backupde todos os dados do Cognos TM1.

Para obter detalhes, consulte:v “Fazendo Backup de Dados e Arquivos de Configuração para Cognos TM1” na

página 257.v “Fazendo Backup de seus dados do Cognos TM1 Applications” na página 261.

Sobre Esta Tarefa

Dependendo de quais componentes você instalou, você poderá ter que executaretapas separadas para removê-los. Por exemplo, o IBM Cognos Insight e o IBMCognos TM1 Performance Modeler são desinstalados de forma diferente do que osoutros componentes do IBM Cognos TM1.

Capítulo 16. Manutenção de sua Instalação do Cognos TM1 259

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:

Essas etapas desinstalam todos os componentes a seguir em um únicoprocedimento:v Cognos TM1 Admin Serverv Cognos TM1 Serverv Cognos Configurationv Cognos TM1 Webv Cognos TM1 Architectv Cognos TM1 Perspectivesv Cognos TM1 Applicationsv Cognos TM1 Operations Consolea. No menu Iniciar do Microsoft Windows, clique em Programas > IBM

Cognos 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 para a opção IBM Cognos TM1 e, em seguida, selecione Avançar.O programa de desinstalação remove os componentes, mas pode levaralgum tempo. Quando isso for concluído, será solicitado que você reinicieseu computador.

d. Escolha a opção para reiniciar agora ou mais tarde e clique em Concluir.e. Verifique no diretório de instalação Cognos TM1 se algum arquivo ou

subdiretório permanece. Em caso afirmativo, exclua-os manualmente.Por exemplo, verifique C:\Program Files\IBM\cognos\tm1.

Desinstalando e Implementando o 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.

Fazendo Backup de seus dados do Cognos TM1 ApplicationsEste tópico descreve como fazer o backup manual dos arquivos de configuraçãopara o Cognos TM1 Applications.

Sobre Esta Tarefa

O backup manual dos arquivos do aplicativo permite preservar dados de estadosobre os aplicativos como a propriedade do nó atual e o status enviado.

Nota: Se você apenas desejar salvar uma definição da estrutura do aplicativo semnenhum dado de estado, use o recurso de exportação. Consulte o “Exportando osAplicativos do Cognos TM1 Applications”.

Procedimento1. Faça o backup dos bancos de dados do Cognos TM1 Server usados pelos seus

aplicativos.Salve uma cópia do conteúdo dos diretórios de dados do banco de dados IBMCognos TM1 e subdiretórios para um local seguro. Esses diretórios contêm osarquivos de configuração e dados. Por exemplo, os diretórios e subdiretórios debanco de dados de amostras Cognos TM1 estão localizados aqui:<TM1_Install>\samples\tm1

2. Salve uma cópia de backup da pasta applications do Cognos TM1Applications e dos arquivos de configuração pmpsvc_config.xml efpmsvc_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 TM1Applications, estes itens estarão localizados no seguinte local: <Your ProgramFiles>\cognos\cx\webapps\pmpsvc

em que x é a versão do Cognos BI que está sendo usado.

Exportando os Aplicativos do Cognos TM1 ApplicationsÉ possível exportar a configuração básica de um aplicativo a partir do IBM CognosTM1 Applications 10.x para salvar uma cópia de backup ou para mover oaplicativo para outra instância do Cognos TM1 Applications. A exportação permitesalvar um modelo de um aplicativo sem nenhum dos dados de estado ou deatividade do usuário atual. Somente a definição de segurança e estrutura doaplicativo é exportada. Após a exportação, será possível importar e reutilizar oaplicativo posteriormente para algo como um novo período de planejamento deorçamento.


Sobre Esta Tarefa

Um archive é criado contendo os arquivos XML que descrevem a estrutura e asegurança do aplicativo.

Importante: O processo de exportação não preserva os dados de estado sobre oaplicativo como a propriedade do nó atual e o status enviado. Se você usar oprocesso de exportação/importação, essas informações não serão preservadas.

Se você desejar preservar dados de estado sobre os aplicativos, faça o backupmanual dos arquivos da maneira descrita em “Fazendo Backup de seus dados doCognos TM1 Applications” na página 261.

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 TM1Esse tópico descreve como parar os serviços relacionados na versão 10.2 do IBMCognos TM1.

Procedimento1. Abra o Cognos Configuration.2. Pare todos os serviços a seguir:

v TM1 Admin Serverv todas as instâncias do serviço do TM1 Serverv TM1 Application Server

Nota: Quando o TM1 Application Server é parado, outros componentes doTM1 também são parados, caso estejam instalados no mesmo computador.Essa etapa interrompe todos os componentes de aplicativo da webrelacionados, o Cognos TM1 Applications, o Cognos TM1 Web e o CognosTM1 Operations Console. Essa etapa também interrompe os serviços desuporte que permitem que o Cognos TM1 se comunique com o Cognos TM1Mobile Contributor e o IBM Cognos Analysis for Microsoft Excel.

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 Cognos TM1 ApplicationsSe você instalou e implementou o IBM Cognos TM1 Applications com o ApacheTomcat padrão que foi fornecido com a instalação do Cognos TM1, use as etapas aseguir para desinstalar o Cognos TM1 Applications.


Antes de Iniciar

Assegure-se de ter feito backup dos seus dados do Cognos TM1 Applications eparado os serviços relacionados no IBM Cognos Configuration.

Sobre Esta Tarefa

Essas etapas se aplicam apenas se você estiver usando o IBM Cognos TM1Applications com a versão padrão do servidor de aplicativos da web ApacheTomcat que foi fornecida com a instalação do Cognos TM1.

Se você instalou e implementou o Cognos TM1 Applications para um servidor deaplicativos da web que não seja o padrão fornecido, use essas ferramentas pararemover a implementação. Para obter detalhes, consulte os seguintes tópicos:v “Removendo Implementação do Cognos TM1 Applications no Apache Tomcat”v “Removendo a Implementação do Cognos TM1 Applications no WebSphere” na

página 264

Atenção: Essas etapas também removerão os componentes Cognos TM1 a seguirse forem instalados no mesmo computador:v Cognos TM1 Admin Serverv Cognos TM1 Serverv Cognos Configurationv Cognos TM1 Webv Cognos TM1 Architectv Cognos TM1 Perspectivesv Cognos TM1 Operations Console

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

TM1 > Desinstalar IBM Cognos TM1 > Desinstalar IBM Cognos TM1.2. Selecione o idioma para o assistente de desinstalação e clique em Avançar.3. Na tela Selecionar os Pacotes que Deseja Desinstalar, clique na caixa de

seleção para a opção IBM Cognos TM1 e, em seguida, selecione Avançar.O programa de desinstalação remove os componentes, mas pode levar algumtempo. Quando isso for concluído, será solicitado que você reinicie seucomputador.

4. Escolha a opção para reiniciar agora ou mais tarde e clique em Concluir.5. Verifique no diretório de instalação Cognos TM1 se algum arquivo ou

subdiretório permanece. Em caso afirmativo, exclua-os manualmente.Por exemplo, verifique C:\Program Files\IBM\cognos\tm1\webapps\pmpsvc.

Removendo Implementação do Cognos TM1 Applications noApache Tomcat

Use estas etapas para remover a implementação do IBM Cognos TM1 Applicationsse você usou uma versão separada do Apache Tomcat e não usou a fornecida coma instalação do Cognos TM1.

Procedimento1. Abra o Tomcat Manager.


2. Clique em Remover Implementação para a entrada /pmpsvc na listaAplicativos.

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\Tomcat6.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 Intelligencecom o Cognos TM1 Applications, estes itens estarão localizados nosseguintes 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.

Removendo a Implementação do Cognos TM1 Applications noWebSphere

Use estas etapas para remover a implementação do IBM Cognos TM1 Applications,se usou o IBM WebSphere e não usou o Apache Tomcat padrão que foi fornecidocom a instalação do Cognos TM1.

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


Restaurando os dados e arquivos de configuração no Cognos TM1versão 10.2.2

Após instalar a versão mais recente do IBM Cognos TM1, conclua essas etapaspara restaurar os arquivos de configuração e de dados anteriores do Cognos TM110.2.x.

Antes de Iniciar


Sobre Esta Tarefa

Essas etapas se aplicarão somente ao restaurar os arquivos de configuração e dadospara o Cognos TM1 versão 10.2.2.

Se precisar restaurar as informações da versão 9.x na versão 10.2.2, consulte“Restaurando os Dados e Arquivos de Configuração a partir do Cognos TM1Versão 9.x na Versao Atual” na página 61.

Procedimento1. Restaure os dados do Cognos TM1 Server:

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.

2. Restaure as informações de configuração no IBM Cognos Configuration:Isso inclui informações de configuração para Cognos TM1 Admin Server,Cognos TM1 Application Server e cada servidor Cognos TM1 que desejaexecutar.a. Abra o IBM Cognos Configuration.b. Na área de janela Explorer do Cognos Configuration, expanda

Configuração Local > Ambiente.c. Clique em TM1 Admin Server e atualize os parâmetros na área de janela

Propriedades.d. Clique em TM1 Application Server e atualize os parâmetros na área de

janela Propriedades.e. Clique em Acesso a Dados > TM1 Server e inclua uma entrada para cada

servidor CognosTM1 que deseja usar.Para obter detalhes, consulte “Incluindo um Servidor Cognos TM1 Existenteno Cognos Configuration” na página 100.

f. Clique em Arquivo > Salvar.3. Restaure os arquivos de configuração do Cognos TM1 Architect e Cognos TM1

Perspectives:Se desejar restaurar alguma configuração da sua instalação anterior do CognosTM1 Architect ou Cognos TM1 Perspectives, copie os valores do antigo arquivoTm1p.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 SSL padrão, altere manualmente o valor para esteparâmetro para o 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:




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


4. Restaure os arquivos do Cognos TM1 Web:

Nota: A partir do IBM Cognos TM1 versão 10.2.0, o diretório de instalaçãopadrão para o Cognos TM1 Web será <TM1_Install>\webapps\tm1web\.v Restaurando arquivos do Cognos TM1 Web versão 10.2.0 ou mais recente:

Abra o arquivo antigo tm1web_config.xml e mescle seletivamente as linhas eos parâmetros que você deseja usar no arquivo tm1web_config.xml localizadoem <TM1_Install>\webapps\tm1web\web-inf\configuration.

v Restaurando arquivos de uma versão pré-10.2.0 do Cognos TM1 Web:

Nota: O Cognos TM1 Web versão 10.2.0 usa um novo arquivo deconfiguração chamado tm1web_config.xml. Esse arquivo substitui o arquivoweb.config das versões anteriores do Cognos TM1 Web. Para obter maisinformações, consulte “Modificando os Parâmetros de Configuração doCognos TM1 Web” na página 121.Abra o arquivo Web.config antigo e mescle seletivamente as linhas e osparâmetros que deseja usar no novo arquivo tm1web_config.xml localizadoem <TM1_install>\webapps\tm1web\web-inf\configuration.

5. Restaure os arquivos de configuração e aplicativo no Cognos TM1 Applications:Para obter detalhes, consulte:v “Restaurando Arquivos de Aplicativo e Configuração no Cognos TM1

Applications”v “Importando uma Definição de Aplicativo no Cognos TM1 Applications” na

página 267

Restaurando Arquivos de Aplicativo e Configuração no Cognos TM1Applications

É possível restaurar manualmente cópias de backup de arquivos de aplicativo econfiguração em uma versão existente do IBM Cognos TM1 Applications.

Antes de Iniciar

O servidor Cognos TM1 do qual o aplicativo depende deve ser restaurado e estarem execução antes da restauração dos arquivos de aplicativo para o Cognos TM1Applications.

Procedimento1. Restaure os aplicativos para o Cognos TM1 Applications:

Copie os arquivos de aplicativo aqui:<TM1_Install>\webapps\pmpsvc\WEB-INF\applications

2. Restaure os arquivos de configuração para o Cognos TM1 Applications:Copie as cópias de backup dos arquivos de configuração pmpsvc_config.xml efpmsvc_config.xml para:


v <TM1_Install>\webapps\pmpsvc\WEB-INF\configuration\pmpsvc_config.xml

v <TM1_Install>\webapps\pmpsvc\WEB-INF\configuration\fpmsvc_config.xml

3. No Cognos Configuration:a. Inicie o servidor TM1 Application.b. Inicie os servidores TM1 relacionados ao aplicativo.

4. Efetue login no portal Cognos TM1 Applications e inclua o servidor TM1relacionado na página Configuração, se ainda não estiver listado.

a. Clique no ícone Administrar o IBM Cognos TM1 Applications nabarra de ferramentas da página principal do Cognos TM1 Applications.

b. Na seção Nomes do Servidor, clique em Incluir e insira as informaçõespara o TM1 Server relacionado.

c. Clique em OK.Os aplicativos na pasta webapps/pmpsvc/WEB-INF/application serãoatualizados e incluídos no Cognos TM1 Applications.

Nota: O processo de upgrade poderá levar algum tempo, dependendo daquantia de direitos que precisarem ser aplicados no aplicativo. Para obtermais informações, consulte “Salvando Direitos de Segurança ao Importar ouRestaurar um Cognos TM1 Application” na página 63.

Importando uma Definição de Aplicativo no Cognos TM1 ApplicationsÉ possível importar uma definição do aplicativo que foi exportada a partir do IBMCognos TM1 Applications de volta 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.

Nota: Se você importar as configurações de segurança, a operação desalvamento de direitos poderá demorar mais para ser processada, dependendoda quantia de detalhes a serem aplicados no aplicativo. Para obter maisinformações, consulte “Salvando Direitos de Segurança ao Importar ouRestaurar um Cognos TM1 Application” na página 63.

7. Selecione a opção Importar Propriedades do Aplicativo se quiser importarconfigurações de propriedades com o aplicativo.

8. Clique em Importar.


Capítulo 17. 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 A. O arquivo de configuração do servidor tm1s.cfg

O arquivo tm1s.cfg é um arquivo ASCII que especifica as informações do ambientepara um servidor IBM Cognos TM1 .

Um arquivo tm1s.cfg padrão é criado no diretório de dados do servidor CognosTM1 ao instalar uma cópia do servidor Cognos TM1 . A maioria dos parâmetrosdisponíveis é documentada no arquivo de configuração. Se um parâmetro não éinstalado por padrão, ele tem a linha comentada no arquivo de configuração. Épossível editar o arquivo tm1s.cfg para refletir o ambiente do servidor remotoassociado removendo o comentário do parâmetro que deseja usar e configurando ovalor 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ágina272.

Local do arquivo tm1s.cfgO local do arquivo tm1s.cfg depende do tipo de servidor que você está usando.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 você estiver executando o servidor remoto Cognos TM1 como um serviço doMicrosoft Windows (Tm1sd.exe), e tiver usado 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 você estiver executando o servidor remoto Cognos TM1 como um aplicativodo Windows (Tm1s.exe), especifique o local do arquivo tm1s.cfg usando oparâmetro -z na linha de comandos ao iniciar o servidor, a partir de um atalhoou 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 tiver usado 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/ibmcognos/cgi-bin/cognos.cgi

#ClientPingCAMPassport=900

#Optional CAM parameters

#CAMSSLCertificate=

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

AdminSvrSSLCertAuthorityEspecifica o caminho completo e o nome do arquivo de autoridade de certificaçãoque emitiu o certificado do IBM Cognos TM1 Admin Server.

Tipo de parâmetro: opcional (requerido para SSL), estático

Exemplo:AdminSvrSSLCertAuthority = C:\Program Files\Cognos\TM1\bin64\ssl\applixca.pem

AdminSvrSSLCertIDEspecifica o nome do principal para quem o certificado do IBM Cognos TM1Admin Server é emitido.


O valor deste parâmetro deve ser idêntico ao parâmetro TM1 Admin ServerCertificate ID, conforme definido no IBM Cognos Configuration.

Se o parâmetro AdminSvrSSLCertID estiver configurado incorretamente, o menususpenso do TM1 Server Web será exibido como vazio e um erro será registradono arquivo TM1web.log.

Exemplo:AdminSvrSSLCertID = tm1adminserver

Apêndice A. O arquivo de configuração do servidor tm1s.cfg 273

AdminSvrSSLCertRevListEspecifica o caminho completo do arquivo de revogação de certificado emitidopela autoridade de certificação que emitiu originalmente o certificado do IBMCognos TM1 Admin Server.


Um arquivo de revogação de certificado existirá apenas no caso de um certificadoter sido revogado.

AdminSvrSSLExportKeyIDEspecifica a chave de identidade usada para exportar o certificado do IBM CognosTM1 Admin Server a partir do armazenamento de certificados do MicrosoftWindows.

Tipo de parâmetro: opcional (obrigatório se ExportAdminSvrSSLCert estiverativado), estático

Este parâmetro será necessário apenas se você escolher usar o armazenamento decertificados definindo ExportAdminSvrSSLCert=T.

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.


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

ApplyMaximumViewSizeToEntireTransactionAplica o MaximumViewSize para toda a transação em vez de para cálculosindividuais.

Tipo de parâmetro: opcional dinâmico

Por padrão, MaximumViewSize verifica o processamento de visualizaçãoindividual. Por exemplo, se 10 visualizações forem processadas em uma únicatransação, o limite será ultrapassado apenas se o processamento de qualquervisualização única ultrapassar o limite. Consulte o “MaximumViewSize” na página307.

Com este parâmetro configurado como True, o uso de memória acumulativa detodas as visualizações processadas em uma única transação é comparado com ovalor do limite. Isso permite que o limite de tamanho de memória capture maistransações que consomem grandes quantidades de memória.

Nota: A execução do processo de TI conta como uma única transação, incluindotodos os processos de TI filho.ApplyMaximumViewSizeToEntireTransaction=T

O valor padrão é 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.


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

O intervalo de valores inclui:v Valor-padrão: 100 MBv Valor mínimo: 1 KBv Valor máximo: 2 GB

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 .

AutomaticallyAddCubeDependenciesDetermina se as dependências do cubo são configuradas automaticamente ou sevocê deve identificar manualmente as dependências de cubo para cada cubo.


O IBM Cognos TM1 Server estabelece dependências para que ele possa invalidarcorretamente os caches de cálculo de cubo quando os dados em cubos sãoalterados. Para obter mais detalhes, consulte "Entendendo a Dependência do Cubo"no Guia de Operações do TM1.


Quando configuradas como true (o padrão), dependências inter-cubo DB(...)baseadas em regra são detectadas e configuradas automaticamente no tempo deinicialização do servidor. Além disso, após uma edição de regras, salvar ourecompilar, as dependências expressas nessa regra, seja a partir das funções BD(),ATTRS() ou ATTRN(), são automaticamente restabelecidas.

Quando configurado como false, dependências inter-cubo DB(...) baseadas em regranão são detectadas e são configuradas no tempo de inicialização do servidor. Asdependências são estabelecidas quando uma consulta é executada. Isso pode fazercom que uma consulta bloqueie outras devido a uma nova dependência.AutomaticallyAddCubeDependencies=F

Valor padrão: T

CacheFriendlyMallocPermite o alinhamento de memória que é específico para o IBM Power Platform.


Testes mostraram que ativar este parâmetro fornece o maior benefício para cenáriosde alto uso de contagem do usuário. Os cenários de uso de contagem de usuárioúnicos ou baixos podem ver pouco ou nenhum benefício. Por padrão,CacheFriendlyMalloc=F.

Para ativar a opção, inclua a seguinte linha no arquivo tm1s.cfg:CacheFriendlyMalloc=T

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.

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

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.

CertificateVersionEspecifica qual versão dos certificados SSL instalada com o IBM Cognos TM1 usar.


Nota: Esse parâmetro não se aplicará se você estiver usando seus próprioscertificados SSL. Este parâmetro só se aplica aos certificados instalados com o TM1.

Por padrão, a versão de criptografia de 1024 bits dos certificados é usada. Altereesse parâmetro somente se desejar usar a nova versão de criptografia de 2048 bitsdos certificados.

É possível usar a nova versão com os clientes TM1 novos e antigos, mas vocêdeverá configurar os clientes para usarem o novo arquivo de autoridade decertificação. Consulte “Configurando o Cognos TM1 Web para Usar SSL” napágina 243 e “Configurando os Clientes Cognos TM1 para Usar SSL” na página242.

Os valores válidos são:v 1 - Ativa a autoridade de certificação para a criptografia de 1024 bits com o

sha-1 (valor padrão)v 2 - Ativa a autoridade de certificação para a criptografia de 2048 bits com o

sha-256

Valor padrão: 1

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 formulário http[s]://<host>/<cognos_location>/cgi-bin/cognos.cgi.

Por exemplo, http://10.121.25.121/ibmcognos/cgi-bin/cognos.cgi

ClientExportSSLSvrCertEspecifica se um cliente IBM Cognos TM1 deve recuperar o certificado deautoridade de certificação que foi usado originalmente para emitir o certificado doTM1 Server, a partir do armazenamento de certificados do Microsoft Windows.


Se ClientExportSSLSvrCert=T, o certificado de autoridade de certificação seráexportado do armazenamento de certificados no computador cliente quandosolicitado pelo cliente TM1.

Valor padrão: F

ClientExportSSLSvrKeyIDEspecifica a chave de identidade usada por um cliente IBM Cognos TM1 paraexportar o certificado de autoridade de certificação que foi usado originalmentepara emitir o certificado do TM1 Server a partir do armazenamento de certificadosdo Microsoft Windows.


ClientPingCAMPassportIndica o intervalo, em segundos, que um cliente deve executar ping no servidorCognos Authentication Management para manter seu passaporte ativo.



Se ocorrer um erro ou o passaporte expirar, o usuário será desconectado doservidor Cognos TM1 .

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

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 Cognos TM1 Server 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:Se você optar por definir um valor específico para o parâmetroClientMessagePortNumber, em vez de tê-lo atribuído dinamicamente,certifique-se de atribuir números de portas exclusivos para todos os servidoresCognos TM1 e portas de mensagens de clientes que você está usando. Se vocêtiver dois servidores em execução na mesma máquina com o mesmo número daporta, a atividade de mensagem poderá causar um conflito ou interrupção dosistema.

Consulte também “PortNumber” na página 312 e “ProgressMessage” na página313.

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 máxima do cliente que pode se conectar ao servidor IBMCognos 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álido recaem na faixa x00 até a versão do servidorinstalada no momento, sendo que x é o número de liberação principal do servidorTM1 instalado no momento. Por exemplo, os valores de parâmetro válidos para oservidor TM1 9.0 SP3 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 definir ClientVersionMinimum para um valor inferior ao número deversão superior do servidor Cognos TM1 atualmente instalado. Não há um limitesuperior para ClientVersionMinimum. No entanto, se ClientVersionMinimum formaior que ClientVersionMaximum, apenas os clientes com um número da versãoigual a ClientVersionMaximum 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.

CognosMDX.AggregateByAncestorRefQuando possível, substitui a agregação sobre um conjunto de membros com umareferência a um antecessor se o conjunto de membros agregados consistir em umconjunto completo de descendentes e todos os membros possuírem o peso 1.

Por exemplo, a agregação aggregate(children(<Member>)) pode ser substituída poruma referência a <Member>.


Este parâmetro é aplicável apenas ao usar o TM1 com o IBM Cognos BusinessIntelligence.

Para ativar o CognosMDX.AggregateByAncestorRef, inclua a linha a seguir noarquivo tm1s.cfg:CognosMDX.AggregateByAncestorRef=true

Valor padrão: false

CognosMDX.CellCacheEnablePermite que o mecanismo do IBM Cognos MDX modifique as estretégias de cachede consolidação e cálculo de célula do TM1.


Este parâmetro é aplicável apenas ao usar o TM1 com o Cognos BI.

Valor padrão: true

CognosMDX.PrefilterWithPXJExpande a abordagem de junção cruzada do provedor de origem de dados paraconjuntos filtrados aninhados.


Este parâmetro é aplicável apenas ao usar o TM1 com o IBM Cognos BI.

Esse parâmetro é ativo somente nos seguintes casos:v CognosMDX.UseProviderCrossJoinThreshold possui um valor maior que 0 no

arquivo tm1s.cfg


v UseProviderCrossJoinThreshold possui um valor maior que 0 no arquivo deconfiguração qfs_config.xml do Cognos BI.

Para ativar o CognosMDX.PrefilterWithPXJ, inclua a linha a seguir no arquivotm1s.cfg:CognosMDX.PrefilterWithPXJ=true


CognosMDX.SimpleCellsUseOPTSDKAplica as estratégias de cache de consolidação de mecanismo do IBM Cognos MDXe cálculo de célula para todas as células em resultados da consulta.



Quando CognosMDX.SimpleCellsUseOPTSDK não estiver ativado, as estratégiasde consolidação e cálculo de célula em cache são aplicadas apenas em células deresultado da consulta associadas a membros calculados.

Valor padrão: true

CognosMDX.UseProviderCrossJoinThresholdAplica a estratégia de junção cruzada do provedor de origem de dados, mesmo seela não estiver explicitamente ativada no IBM Cognos BI.



Ao ativar o CognosMDX.UseProviderCrossJoinThreshold, isto terá o mesmo efeitoque a ativação do parâmetro UseProviderCrossJoinThreshold no arquivoqfs_config.xml do Cognos BI.

UseProviderCrossJoinThreshold controla se as combinações de membros em umaborda, que não possuem valores de medida, são recuperadas do TM1 Server.UseProviderCrossJoinThreshold é ativado quando ele possui um valor maior que0.

Nota: Se UseProviderCrossJoinThreshold for ativado no Cognos BIqfs_config.xml,ele terá precedência sobre o parâmetro CognosMDX.UseProviderCrossJoinThresholdno arquivo tm1s.cfg.

Para ativar o CognosMDX.UseProviderCrossJoinThreshold, inclua-o no arquivotm1s.cfg e especifique um valor maior que 0, por exemplo:CognosMDX.UseProviderCrossJoinThreshold=1000

Valor padrão: 0

CognosTM1InterfacePathEspecifica 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 mais informações.

Tipo de parâmetro: opcional, exceto ao usar o Cognos TM1 Package Connector,estático

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

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 mais informações, 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.

DHFile-512Especifica o nome do caminho completo do arquivo que contém a chave de 512bits Diffie-Hellman pré-gerada.


A geração de parâmetros Diffie-Hellman pode ser muito dispendiosa em termoscomputacionais. Para minimizar este custo, a chave Diffie-Hellman de 512 bitspode ser gerada previamente e armazenada em um arquivo que é chamadoquando o servidor IBM Cognos TM1 é iniciado.








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.

Importante: Não use DisableSandboxing=T no arquivo de configuração do TM1Server para qualquer TM1 Server que implemente e suporte o TM1 Applications.


Os TM1 Servers que implementam e suportam os TM1 Applications requerem queo recurso de ambiente de simulação esteja ativado no arquivo de configuração doTM1 Server.

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 Cognos TM1 system.

Por padrão, o Cognos TM1 armazena DISPLAY_INFO como DBTYPE_UI4. Quandoo provedor OLE DB do Cognos TM1 processa uma solicitação a partir do ADO 2.7para os dados da coluna DISPLAY_INFO, o provedor tem que converter os dadosda coluna do Cognos TM1 a partir do DBTYPE_UI4 para um DBTYPE_R8. Oprovedor OLE DB do Cognos TM1 retorna os dados da coluna convertidos para ocliente 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 edefine o parâmetro como T, o servidor Cognos TM1 armazena os dados da colunaDISPLAY_INFO como DBTYPE_R8 com os 4 bytes de informações relevantes nosprimeiros 4 bytes. O parâmetro Display_Info_DBType_R8 assegura que asinformações não serão perdidas quando o ADO converter os dados de volta paraum número inteiro de 4 bytes. O parâmetro também assegura que o ADO 2.7retornará 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:

Tabela 39. Nome do Caminho do Diretório para o Parâmetro DistributedPlanningOutputDir

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.

EnableODBCproxyEnableODBCProxy torna os nomes de origens de dados de 32 bits disponíveis paraprocessos do TurboIntegrator em máquinas de 64 bits.


EnableODBCProxy será útil se um driver de 64 bits não estiver disponível. Cadaconexão proxy cria um processo tm1odbcproxy.exe de 32 bits durante a conexão.

EnableODBCProxy é verdadeiro por padrão mas é possível desativar o recursoincluindo EnableODBCProxy=false no tm1s.cfg.

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.



SeExcelWebPublishEnabled=T, os arquivos Excel no Cognos TM1 Applicationspoderão ser publicados para o Cognos TM1 Web sem usar o Excel no servidor daweb. De modo semelhante, planilhas e cubeviewers podem ser exportados doCognos TM1 Web sem usar o Excel no servidor da web.

Quando o Excel não estiver disponível no servidor da web, os arquivos Excel noCognos TM1 Applications deverão ser explicitamente publicados para o CognosTM1 Web.

Para obter detalhes sobre o procedimento necessário para publicar arquivos Excel,consulte o IBM Cognos TM1 Developer Guide.

Para obter detalhes sobre as limitações ao exportar do Cognos TM1 Web sem usaro Excel no servidor da web, consulte o Guia do Usuário do IBM Cognos TM1.

Restrição: Não é possível publicar arquivos do Excel 2007 .xlsx para o CognosTM1 Web quando o Excel não estiver disponível no servidor da web. Estesarquivos devem ser salvos no formato Excel 2003 .xls se você desejar publicá-lospara o Cognos TM1 Web.

Valor padrão: F

ExportAdminSvrSSLCertEspecifica se o certificado do IBM Cognos TM1 Admin Server deve ser exportadoou não do armazenamento de certificados do Microsoft Windows.


Se ExportAdminSvrSSLCert=T, o certificado do servidor administrativo TM1 éexportado do armazenamento de certificados do Microsoft Windows quando ocertificado é solicitado por um TM1 Server.

Se ExportAdminSvrSSLCert=T, deve-se também configurar os parâmetros tm1s.cfg aseguir:v AdminSvrSSLCertIDv AdminSvrSSLExportKeyv SvrSSLExportKeyIDv SSLCertificateIDv SSLPwdKeyFilev SSLPrivateKeyPwdFilev SSLCertAuthorityv ClientExportSSLSvrCert

ExportSvrSSLCertEspecifica se o certificado do servidor IBM Cognos TM1 deve ser exportado apartir do armazenamento de certificados do Microsoft Windows.


Se ExportSvrSSLCert=T, o certificado do TM1 Server será exportado doarmazenamento de certificados do Microsoft Windows quando o certificado forsolicitado pelo TM1 Server.


Se ExportSvrSSLCert=T, deve-se também configurar os parâmetros tm1s.cfg aseguir:v AdminSvrSSLCertIDv AdminSvrSSLExportKeyv SvrSSLExportKeyIDv SSLCertificateIDv SSLPwdKeyFilev SSLPrivateKeyPwdFilev SSLCertAuthorityv ClientExportSSLSvrCert

ForceReevaluationOfFeedersForFedCellsOnDataChangeQuando este parâmetro é configurado, uma instrução do alimentador é forçada aser reavaliada quando os dados mudam.


Quando o servidor IBM Cognos TM1 calcula os 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 é executada e alimentaa célula C, etc. Alimentadores de células numéricas são avaliados apenas quandouma célula vai de vazia para algum valor diferente de zero, já que qualquer valordiferente de zero na célula já teria configurado quaisquer alimentadores.

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 ForceReevaluationOfFeedersForFedCellsOnDataChangeestiver configurado, a presença de um alimentador na célula B não finalizará oprocessamento do alimentador. Em vez disso, a regra do alimentador para B seráexecutada. Como a regra do alimentador para B é dependente de dados, o destinopara o alimentador pode 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á maisavaliações do alimentador, que podem ter um impacto no desempenho.

Para ativar esse parâmetro, configureForceReevaluationOfFeedersForFedCellsOnDataChange=T.

HTTPPortNumberConfigura o número da porta na qual o TM1 Server atende para solicitaçõesHTTP(S) recebidas.


Os serviços do servidor IBMCognos TM1 que a API REST utiliza esse canalHTTP(S). O servidor aceita conexões HTTPS seguras de SSL ou HTTP padrão,dependendo do parâmetro UseSSL (consulte “UseSSL” na página 326). Se UseSSLfor configurado como T, alternando o uso de SSL, o servidor aceitará apenasconexões de HTTPS. Se UseSSL for configurado como F, o servidor aceitaráconexões HTTP não seguras.

Ao instalar um TM1 Server, a porta HTTP não será configurada por padrão. Noarquivo tm1s.cfg, inclua a seguinte linha:HTTPPortNumber = XXXX

Substitua XXXX por um número de porta válido.

Nota: Os números de porta devem ser exclusivos em todos os serviços emexecução em um computador, não apenas através de servidores TM1 e não apenasentre as portas HTTP de servidores TM1.

HTTPSessionTimeoutMinutesConfigura o valor de tempo limite para sessões de autenticação para a API RESTdo IBM Cognos TM1.

Tipo de parâmetro: opcional, dinâmico

Ao usar a API REST do TM1, seu aplicativo precisará ser autenticado com o TM1Server. Este parâmetro configura o tempo limite, em minutos, para essaautenticação. Se uma sessão atingir o tempo limite, as solicitações feitas com o IDde sessão antiga retornarão 401 Unauthorized.

O valor padrão é 20.

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.

Nota: Se o modo de segurança for alterado sem reiniciar o servidor IBM CognosTM1, a mudança se aplicará apenas às novas conexões do cliente. Se quisergarantir que todos os clientes sejam autenticados com o novo modo de segurança,o administrador deverá efetuar logoff de todos os clientes.

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

Para obter detalhes adicionais, consulte “Login Integrado” na página206.


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.

v Se o IntegratedSecurityMode=5 for usado com o servidor IBMCognos TM1 e o IBM Cognos TM1 Applications, não será possíveldesignar os direitos para grupos de TM1 nativo no diálogoGerenciar direitos. Somente os Grupos do Cognos, importadospara o TM1 Server, estão disponíveis.

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 esseparâmetro for usado no arquivo Tm1s.cfg, mas o Cognos TM1 Server e o AdminServer residirem em computadores diferentes, os clientes Cognos TM1 receberãoum erro ao tentarem efetuar login no Cognos TM1 Server.


A sintaxe para o Microsoft Windows usa um ponto e vírgula como o separador deelemento, 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 o UNIX usa uma vírgula como o separador de elemento. Porexemplo, 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 103.


JavaClassPathUtilize esse parâmetro para tornar bibliotecas Java de terceiros disponíveis para oIBM Cognos TM1 Server.


Por exemplo, para permitir que uma extensão Java use classes dentro de umarquivo chamado arquivo db2cc4.jar (um driver DB2 JDBC), utilize o seguinte:JavaClassPath=C:\Development\Java\DB2JDBC\db2jcc4.jar

É possível especificar várias referências separando-as com ponto-e-vírgula.

JavaJVMArgsEspecifica uma lista separada por vírgula de argumentos a serem transmitidos paraa Java Virtual Machine (JVM).


Por exemplo, se você quiser depurar um processo, poderá especificar estesargumentos:JavaJVMArgs=-Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=1044

Os argumentos que podem ser usados dependem da JVM específica que você estáutilizando.

JavaJVMPathEste parâmetro configura o caminho para o arquivo .dll do Java Virtual Machine(jvm.dll), que é necessário para executar o Java do IBM Cognos TM1TurboIntegrator.


Por padrão, esse parâmetro não está presente no arquivo tm1s.cfg.

Para ativar a integração do Java com o TurboIntegrator, inclua a linha a seguir noarquivo tm1s.cfg:

JavaJVMPath=<full_path_to_jvm.dll>

Nota: Se você estiver usando uma versão de 64 bits do tm1s.exe, será necessáriousar uma versão de 64 bits do jvm.dll. Uma versão de 32 bits do tm1s.exe requeruma versão de 32 bits do jvm.dll.

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 Ambiente de Simulação e ocapítulo Writeback do Guia do Usuário do IBM Cognos TM1 para obter detalhes.

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 tempoconfigurada no parâmetro JobQueueMaxWaitTime.


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.

Valor padrão: 100ms

JobQueueThreadPoolSizeO parâmetro JobQueueThreadPoolSize permite que o IBM Cognos TM1 use váriosencadeamentos para processar a Fila de Tarefas do Cognos TM1, fornecendo maiorthru-put e processamento de solicitações do ambiente de simulação.


Por padrão, se este parâmetro não estiver configurado, o Cognos TM1 usará umvalor igual a 1 e o servidor Cognos TM1 usará somente um encadeamento únicopara processar as 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

Valor padrão: 1


JobQueueThreadSleepTimeDetermina a frequência com a qual o encadeamento que processa a fila é executadoquando há tarefas enfileiradas.


Valor padrão: 10 segundos

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

Idioma Código


Croata hrv

Tcheco csy



Dinamarquês dan

Belga nld

Alemão deu

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

Espanhol esp

NLB slv

Sueco sve

Tailandês tha

Turco trk


LDAPHostEspecifica o nome de domínio ou representação em sequência pontilhada doendereço IP do host do servidor LDAP.


Se você não inserir um valor para LDAPHost, o IBM Cognos TM1 usará o valorpadrão, host local.

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.


Esse parâmetro usa o caminho completo para um arquivo .dat.

LDAPPasswordKeyFileDefine a chave de senha usada quando LDAPUseServerAccount não for usado.


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

LDAPPortEspecifica a porta que o IBM Cognos TM1 usa para ligar-se a um servidor LDAP.


Especifique uma porta segura (SSL), por exemplo, 636.

Valor padrão: 389 (uma porta não segura)

LDAPSearchBaseEspecifica 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

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

LDAPSkipSSLCertVerificationIgnora a etapa de verificação de confiança do certificado para o certificado SSLusado para autenticar um servidor LDAP. Este parâmetro é aplicável apenasquando LDAPVerifyServerSSLCert=T.


Se a verificação de confiança não funcionar, será possível ignorar a etapa deverificação de confiança, especificando LDAPSkipSSLCertVerification=T. Nestecaso, o TM1 não verifica o certificado do servidor em todos, mas simplesmenteaceita.


Valor padrão: F

LDAPSkipSSLCRLVerificationIgnora a verificação de CRL para o certificado SSL usado para autenticar umservidor LDAP. Este parâmetro é aplicável apenas quandoLDAPVerifyServerSSLCert=T.


Este parâmetro não é requerido se LDAPVerifyServerSSLCert=F. A API doMicrosoft Windows pode tolerar um certificado CRL vazio ou não existente.


Valor padrão: F

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


definir “LDAPPasswordFile” na página 213 e “LDAPPasswordKeyFile” napágina 214 para conectar-se com êxito ao servidor LDAP usando SSL.

LDAPVerifyCertServerNameEspecifica um servidor a ser utilizado durante o processo de verificação decertificado SSL para autenticação do servidor LDAP. Este parâmetro é aplicávelapenas quando LDAPVerifyServerSSLCert=T.



Utilize este parâmetro para especificar que os servidores TM1 devem ser utilizadospara verificar o certificado SSL recebido.

Todos os nomes dos servidores que você deseja usar para verificação de certificadodevem ser listados em entradas LDAPVerifyCertServerName separadas. Asentradas devem corresponder exatamente ao nome (assunto) do certificadoapresentado ao TM1 no handshake SSL pelo servidor na outra extremidade.

Especifique LDAPVerifyCertServerName no arquivo tm1s.cfg de cada TM1 Serverque está usando LDAP.LDAPVerifyCertServerName=<server_cert_subject>

Substitua server_cert_subject por um nome do servidor ou endereços IP. Crieuma entrada para cada servidor que você deseja utilizar, por exemplo:LDAPVerifyCertServerName=abc99.mydomain.comLDAPVerifyCertServerName=xyz99.mydomain.com

Valor padrão: F

LDAPVerifyServerSSLCertDelega a verificação do certificado SSL para o TM1. Este parâmetro é útil, porexemplo, quando você está usando a LDAP com um servidor proxy.



Geralmente, o, TM1 aproveita a API do Microsoft Windows para verificarcertificados SSL. Para este processo ser bem-sucedido, o nome do certificado e onome do host do servidor LDAP devem corresponder. Se você estiver utilizandoum proxy, no entanto, esses nomes podem não corresponder, causando a falha deverificação. Neste caso, é possível configurar o LDAPVerifyServerSSLCert=T para tero TM1 executando a verificação de certificado.

Quando o LDAPVerifyServerSSLCert=T, TM1 executa duas etapas de verificação(verificando o relacionamento confiável para o certificado e verificação do CRL)como a API do Windows teria feito, mas com uma abordagem um pouco diferente.1. Em vez de verificar o certificado recebido em relação ao nome do host

configurado, o TM1 procura na lista de nomes dos servidores especificados porLDAPVerifyCertServerName.


2. Se o nome do certificado corresponder a um dos servidores especificados porLDAPVerifyCertServerName, o TM1 chama a API do Microsoft Windows esolicita que ela verifique somente este certificado único.

Nota: A autoridade do certificado de raiz confiável (CA) correta já deve tersido importada para o armazenamento de certificados do Microsoft Windows.

É possível ignorar a etapa de verificação de confiança especificandoLDAPSkipSSLCertVerification=T. Neste caso, o TM1 não verifica o certificadodo servidor em todos, mas simplesmente o aceita.

3. Depois que a verificação de confiança for confirmada (ou ignorada), o TM1chamará a API do Microsoft Windows para verificar a CRL.

Nota: O certificado CRL para a raiz confiável já deve ter sido importada para oarmazenamento de certificados do Microsoft Windows.

Se o certificado CRL não existir no armazenamento de certificados do MicrosoftWindows, o processo falhará. É possível ignorar a etapa de CRL especificandoLDAPSkipSSLCRLVerification=T.

4. Se todas as etapas anteriores foram concluídas com sucesso, o handshake SSLserá concluído. O TM1 agora tenta autenticar para o servidor LDAP.

Para obter informações de resolução de problemas, consulte “Resolvendoproblemas de autenticação LDAP” na página 218.

LDAPWellKnownUserNameEspecifica o nome de usuário usado pelo servidor IBM Cognos TM1 para efetuarlogin no LDAP e consultar o nome enviado pelo usuário.

Tipo de parâmetro: opcional, a menos que “LDAPUseServerAccount” na página215=F,, estático

O valor desse parâmetro pode ser qualquer nome distinto LDAP.

Por exemplo:uid=bjensen,ou=people,o=company.com

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 em um sistema operacional Windows de64 bits ficar inativo durante um longo período, a memória física utilizada peloservidor Cognos TM1 será gravada no 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.

Tipo de parâmetro: opcional,static

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.


Valor padrão: 5000 linhas

MagnitudeDifferenceToBeZeroConfigura a ordem de magnitude do numerador relativo ao denominador, acimada qual o denominador será igual a zero ao usar um operador de divisão seguro.


Em regras e no TurboIntegrator, há um operador de divisão seguro (a barrainvertida). Com isso, se você tentar dividir por zero, o resultado será zero, nãoindefinido. Se o denominador para a divisão for uma quantidade calculada, oresultado poderá ser muito próximo de zero, mas não exatamente zero, porexemplo, .0000000000000004. Ao configurar o parâmetroMagnitudeDifferenceToBeZero, será possível especificar quão próximo um númeropode estar de zero, relativo à magnitude do numerador, a ser considerado comozero para o operador de divisão segura.

Considere este exemplo:v No arquivo Tm1s.cfg, configure MagnitudeDifferenceToBeZero=14v A operação é A\B

Nota: A barra invertida (\) é o operador de divisão seguro no TurboIntegrator.v A = 1000 B = 1.5e-15v B é 18 ordens de magnitude menos do que Av 18 > 14, portanto o operador de divisão seguro retorna B=0


MaskUserNameInServerToolsDetermina se os nomes de usuário nas ferramentas de administração do servidor(Operations Console) serão mascaradas ou não até um usuário ser verificadoexplicitamente como tendo acesso de administrador.


Quando MaskUserNameInServerTools estiver configurado como TRUE, os nomes deusuário serão mascarados nas ferramentas de administração do servidor até que ousuário que está trabalhando na ferramenta de administração seja verificadoexplicitamente como um administrador. Consulte o Guia do IBM Cognos TM1Operations Console para obter detalhes sobre a verificação de acesso doadministrador ao Operations Console..

Quando o MaskUserNameInServerTools for configurado como FALSE, os nomes deusuário serão exibidos nas ferramentas de administração do servidor para todos osusuários, independentemente do status do administrador.


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 do processador esteja disponível para executaroutros aplicativos enquanto o servidor Cognos TM1 estiver carregando.

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 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 mais informações, consulte “SyncUnitSize” na página 323.

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 mais detalhes, consulte o tópico “Serializando processos doTurboIntegrator usando synchronized()” no IBM Cognos TM1 TurboIntegrator 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 linha a seguir no tm1s.cfg:MaximumViewSize=n

em que n representa a quantidade de memória em MB a ser alocada.

Consulte também “ApplyMaximumViewSizeToEntireTransaction” na página 276.

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

MTQConfigura o número máximo de encadeamentos por consulta do TM1.


Para especificar um número máximo de encadeamentos a serem usados aoprocessar consultas, inclua a linha a seguir em Tm1s.cfg:


MTQ=n

em que n representa o número de encadeamentos a serem usados para uma únicaconsulta.

Como alternativa, use MTQ=ALL (sem distinção entre maiúsculas e minúsculas), quedefine o valor para o número máximo de cores disponíveis em um servidor. Oresultado é uma configuração do sistema dinâmico que consome todos os núcleos.

Se você configurar o MTQ igual a um número negativo, ou seja, MTQ=-N, o númerode encadeamentos que será utilizado será definido pela seguinte equação: T=M-N+1,em que T= a quantidade de encadeamentos a serem utilizados pelo sistema e M= onúmero de encadeamentos no servidor.

Por exemplo, se seu servidor tiver 64 núcleos e você configurar MTQ=-10, osistema utilizará 55 núcleos.T=64-(10)+1

Se você configurar o MTQ=1 ou MTQ=0, a execução multiencadeada de consulta serádesativada.

Para obter mais informações, consulte "Consultas Multiencadeadas" no Guia deOperações do IBM Cognos TM1.

MTQ é desativado por padrão.

Nota: Várias consultas multiencadeadas podem melhorar o desempenho em cubosnuméricos, onde a consolidação é otimizada. Como TM1 não consolida os valoresde sequência, o parâmetro MTQ não tem impacto sobre o desempenho de cubos desequência.

MTQ.OperationProgressCheckSkipLoopSizeUse este parâmetro para ajustar o processamento multiencadeado de consulta.


Este parâmetro especifica o número de células a serem processadas antes deverificar se divisões multiencadeadas são necessárias.

O valor padrão é 10.000.

MTQ.SingleCellConsolidationUse este parâmetro para ajustar o processamento multiencadeado de consulta.


Configure este parâmetro como FALSE para desaprovar o processamentomultiencadeado de consulta para consolidações de célula única. Isso é aplicável,por exemplo, se o seu modelo contiver regras complexas (regras que têmreferências cruzadas de cubo com uma profundidade recursiva maior que dois).

A consolidação de célula única geralmente é chamada para o cálculo de regras quefazem referência a valores consolidados como argumentos. A consolidação decélula única também é usada para calcular somente visualizações de títulos.


O valor padrão é TRUE.

NetRecvBlockingWaitLimitSecondsUse este parâmetro para que o servidor execute o período de espera para que umcliente envie a próxima solicitação como uma série de períodos de espera maiscurtos. Este parâmetro altera a espera de um período de espera longo paraperíodos de espera mais curtos, para que um encadeamento possa ser cancelado senecessário.


O parâmetro é ativado por padrão.

Por padrão, o servidor pode esperar por uma entrada durante um longo períodode tempo, o que pode resultar em encadeamentos mantidos por um longo períodoe outros problemas.

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.

Valor padrão: 0

NetRecvMaxClientIOWaitWithinAPIsSecondsEspecifica o tempo máximo para um cliente executar E/S no intervalo de tempoentre a chegada do primeiro pacote de dados para um conjunto de APIs por meiode processamento até uma resposta ter sido enviada.


Este parâmetro requer que o cliente manipule a E/S de modo adequado apósiniciar as solicitações da API. Esse parâmetro foi projetado para se proteger deconexões que ficam vazias, mas não para criar um erro de soquete ou criar outraspossibilidades como a interrupção de um cliente.

O valor padrão é 0, o que significa que não há limite de tempo.

ODBCLibraryPathEspecifica o nome e local da biblioteca de interface ODBC (arquivo .so) no UNIX.

Tipo de parâmetro: opcional (necessário para suportar o ODBC no UNIX), estático

Este parâmetro é aplicável somente no TM1 em execução no UNIX, Linux ou AIX.

No arquivo tm1s.cfg, inclua a seguinte linha:ODBCLibraryPath= location/file

Substituir local/arquivo com o caminho absoluto e o nome do arquivo dabiblioteca.

Por exemplo:ODBCLibraryPath=/usr/local/lib/unixODBC/lib/libodbc.so


OracleErrorForceRowStatusUtilize este parâmetro para garantir a interação correta entre os processos do IBMCognos TM1 TurboIntegrator e as origens de dados ODBC do Oracle.


O formato do parâmetro é o seguinte:OracleErrorForceRowStatus=x

Substitua x com um dos seguintes valores:

0 O Cognos TM1 detecta automaticamente a versão do Oracle a qual vocêestá se conectando.

1 O Cognos TM1 manipula a conexão com o Oracle da mesma maneira queoutros drivers.

2 O Cognos TM1 conecta-se ao Oracle e usa SQLULEN em vez deSQLUSMALLINT.

O padrão é 0.

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 detalhe, consulte “Usando a 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.

PerfMonIsActiveUse este parâmetro para ativar ou desativar as atualizações para os contadores dedesempenho do TM1.


É possível visualizar os contadores de desempenho usando o utilitário TM1PerfMon ou o monitor de desempenho da Microsoft Windows. Para obter maisdetalhes, consulte "Usando o TM1 Performance Counters" no Guia de Operações doTM1.

Capturar contadores de desempenho no TM1 pode causar impacto no desempenhosob uma carga de trabalho multiusuário pesada (com 100 ou mais usuários ativos).Use este parâmetro para desativar as atualizações para os contadores dedesempenho se o desempenho for um problema.PerfMonIsActive=F

O valor padrão é T.

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 mais informações, consulte “Usando Alimentadores Persistentes” noGuia 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. Umexemplo 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 que


preenchem 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 leva uma quantidade significativade tempo para calcular (geralmente uma visualização com níveis altos deconsolidação ou regras complexas), o IBM Cognos TM1 monitora o andamento 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çãodo 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.


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


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 276, “AuditLogMaxQueryMemory” napágina 276, “AuditLogOn” na página 277, and “AuditLogUpdateInterval” napágina 277.


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.

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

RunningInBackgroundAo incluir a linha RunningInBackground=T para tm1s.cfg, o servidor UNIX IBMCognos TM1 é executado no modo segundo plano.


Se você usar os scripts startup_tm1s.sh e shutdown_tm1s.sh para iniciar e pararservidores TM1, configure RunningInBackground=T.

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

ServerCAMURIEspecifica o URI para o dispatcher interno que o servidor IBM Cognos TM1 devemusar para se conectar ao Cognos Authentication Manager (CAM).

O URI é especificado no formuláriohttp[s]://fully-qualified host IP address:port/p2pd/servlet/dispatch


Por exemplo,https://vottbies005.ent.ad.cognos.com:9443/p2pd/servlet/dispatch

Para a autenticação do CAM, essa configuração deverá incluir o nome completo doservidor para o qual o certificado do Cognos Business Intelligence (BI) foi criado.

Para determinar o servidor para o qual o certificado foi emitido:1. Insira o URI de SSL no dispatcher do Cognos BI em um navegador.2. Atualize a configuração ServerCAMURI no tm1s.cfg com o nome completo desse

servidor.Por exemplo:ServerCAMURI=https://vottbies005.ent.ad.cognos.com:9443/p2pd/servlet/dispatch.

Para configurar o Cognos TM1 Applications Server para trabalhar com o CAMSSL,1. Assegure-se de que as configurações a seguir sejam feitas no Cognos

Configuration:v Forçar Caminhos Qualificados configurado como False.v Usar Autenticação Mútua configurado como True

2. Aceite o certificado ao salvar.

ServerCAMURIRetryAttemptsEspecifica o número de tentativas feitas antes de mover para a próxima entradaServerCAMURI no arquivo tm1s.cfg.


Este parâmetro é aplicável se você estiver usando o barramento do IBM CognosTM1 com o Cognos BI e tiver definido vários dispatchers no arquivo tm1s.cfg. Osdispatchers são definidos utilizando o parâmetro ServerCAMURI.

Por exemplo, suponha-se que você tenha três parâmetros ServerCAMURIespecificados no arquivo tm1s.cfg e ServerCAMURIRetryAttempts=7.


ServerCAMURI=http://server1:9300/p2pd/servlet/dispatchServerCAMURI=http://server2:9300/p2pd/servlet/dispatchServerCAMURI=http://server3:9300/p2pd/servlet/dispatchServerCAMURIRetryAttempts=7

O primeiro dispatcher (http://server1:9300/p2pd/servlet/dispatch) é usado etentado sete vezes. Se ele não responder, então o segundo é utilizado e tentado setevezes. Se ele não responder, o terceiro dispatcher é, então, tentado sete vezes. Se oterceiro não responder, o login falhará.

Valor padrão: 1

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 logtm1server.log da mensagem do servidor Cognos TM1 , editando o parâmetrocorrespondente no arquivo de configuração tm1s-log.properties do criador de logs.

Nota: Se você alterar esse parâmetro dinamicamente (sem reiniciar o servidor TM1), ocorrerá a criação de log apenas para as novas sessões do cliente.

ServerNameDefine o nome do servidor IBM Cognos TM1 . Se você não fornecer esteparâmetro, o Cognos TM1 nomeará o Local do servidor e o tratará como umservidor local.


ServicePrincipalNameEspecifica o nome do principal de serviço (SPN) ao usar Login Integrado com TM1Web e delegação restrita.


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 mais informações sobre delegação restrita e configuração de SPN,procure no website da Microsoft o tópico “Complemento Técnico Kerberos para oWindows”.

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 Cognos TM1 system.

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


o 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



Dispersão e suspensões de consolidadação

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 jan efev, 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.

SSLCertAuthorityEspecifica o nome do arquivo de autoridade do certificado do servidor IBMCognos TM1. Este arquivo deve residir no computador no qual o TM1 Server estáinstalado.



Se você estiver usando seus próprios certificados SSL com o TM1, será possíveldeterminar esse valor consultando o Microsoft Management Console. Clique emCertificados > Pessoal > Certificados. O nome do principal é exibido na colunaEmitido Por da área de janela de Propriedades.

SSLCertificateEspecifica o caminho completo do arquivo de certificado do servidor IBM CognosTM1 que contém o par de chaves pública/privada.


SSLCertificateIDEspecifica o nome do principal para quem o certificado do servidor IBM CognosTM1 é emitido.


Se você estiver usando seus próprios certificados SSL com o TM1, será possíveldeterminar esse valor consultando o Microsoft Management Console. Clique emCertificados > Pessoal > Certificados. O nome do principal é exibido na colunaEmitido Por da área de janela de Propriedades.

SSLCertRevocationFileEspecifica o nome do arquivo de revogação do certificado do servidor IBM CognosTM1. Este arquivo deve residir no computador no qual o TM1 Server estáinstalado.


Um arquivo de revogação de certificado existirá apenas no caso de um certificadoter sido revogado.

SSLPrivateKeyPwdFileEspecifica o caminho completo para o arquivo .dat que contém a senhacriptografada para a chave privada.


Se você estiver usando seus próprios certificados SSL, observe que o nome dessearquivo é especificado pelo parâmetro -outfile quando você executa o utilitárioTM1Crypt.

Por exemplo, se você executar o utilitário TM1Crypt a partir do comando a seguir:tm1crypt.exe -pwd abc123 -keyfile btkey.dat -outfile btprk.dat -validate

o valor de parâmetro correto é:SSLPrivateKeyPwdFile=C:\Program Files\Cognos\TM1\bin64\btprk.dat

SSLPwdKeyFileEspecifica o caminho completo para o arquivo .dat que contém a chave usada paracriptografar e decriptografar a senha para a chave privada.



Se você estiver usando seus próprios certificados SSL, observe que o nome dessearquivo é especificado pelo parâmetro -keyfile ao executar o utilitário TM1Crypt.

Por exemplo, se você executar o utilitário TM1Crypt a partir do seguinte 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

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.

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 o


desempenho quando vários usuários tentam acessar o mesmo subconjunto,principalmente quando o subconjunto contém mais de 100 elementos.

SvrSSLExportKeyIDEspecifica a chave de identidade usada para exportar o certificado do servidor IBMCognos TM1 a partir do armazenamento de certificados do Microsoft Windows.

Tipo de parâmetro: opcional (obrigatório se ExportSvrSSLCert estiver ativado),estático

Este parâmetro será necessário apenas se você escolher usar o armazenamento decertificados definindo ExportSvrSSLCert=T.

Na maioria dos casos, o valor para SvrSSLExportKeyID será idêntico ao valor deSSLCertificate.

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 mais informações, consulte“MaximumSynchAttempts” na página 305.

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.

TM1ConnectorforSAPConfigure este parâmetro como T para usar o software IBM Cognos TM1Connector for SAP.


Nota: Essa funcionalidade está disponível somente para clientes que adquiriram osoftware IBM Cognos TM1 Connector for SAP. Esse software foi anteriormentedisponibilizado separado do software IBM Cognos TM1. Este software não estámais disponível para venda.


Se você tiver adquirido anteriormente essa funcionalidade, deverá incluir oTM1ConnectorforSAP=T e o UseNewConnectorforSAP=T no arquivo tm1s.cfg paratornar o software disponível.


UnicodeUpperLowerCaseO parâmetro de configuração instrui o TM1 Server a identificar e manipular nomesde objeto Unicode, evitando a criação de nomes de objeto Unicode idênticos quevariam apenas quanto a maiúsculas e minúsculas.

Tipo de Parâmetro:v Opcionalv Estático

Se você alterar este valor de parâmetro, reinicie o TM1 Server para aplicar onovo valor.

Os nomes de objeto ASCII de encaminhamentos do TM1 não fazem distinção entremaiúsculas e minúsculas, o nome de elemento SALES é equivalente a sales. Umareferência a SALES, sales ou mesmo SaLeS é considerada uma referência a umúnico elemento. Da mesma forma, o nome do cubo Projections é equivalente aPROJECTIONS.

No entanto, os nomes de objeto Unicode não fazem distinção entre maiúsculas eminúsculas. Consequentemente, um servidor pode conter dois objetos com nomesiguais variando apenas quanto a maiúsculas e minúsculas. Por exemplo, oselementos NEMÈIJA e nemèija podem existir em uma única dimensão e cada umser considerado como um elemento único.

Inclua o parâmetro UnicodeUpperLowerCase=T no arquivo TM1s.cfg para evitar acriação de nomes de objeto Unicode idênticos que variem apenas quanto amaiúsculas e minúsculas. Quando UnicodeUpperLowerCase=T, os nomes de objetoUnicode são manipulados apenas como nomes de objeto ASCII e não fazemdistinção entre maiúsculas e minúsculas.

Se você tiver desenvolvido aplicativos baseados em nomes de objeto Unicode quevariam apenas quanto a maiúsculas e minúsculas e desejar manter essafuncionalidade, você não deverá incluir o parâmetro de configuraçãoUnicodeUpperLowerCase no arquivo Tm1s.cfg. Se esse parâmetro não estiverpresente no Tm1s.cfg (ou estiver configurado como F) o TM1 continuará a tratar osnomes de objeto Unicode com distinção entre maiúsculas e minúsculas.

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.


UseNewConnectorforSAPConfigure este parâmetro como T para usar o software IBM Cognos TM1Connector for SAP.


Nota: Essa funcionalidade está disponível somente para clientes que adquiriram osoftware IBM Cognos TM1 Connector for SAP. Esse software foi anteriormentedisponibilizado separado do software IBM Cognos TM1. Este software não estámais disponível para venda.

Se você tiver adquirido anteriormente essa funcionalidade, deverá incluirUseNewConnectorforSAP=T e TM1ConnectorforSAP=T no arquivo tm1s.cfg paratornar o software disponível.


UserDefinedCalculationsAtiva as opções Rolagem e Inserir Subconjunto para criar consolidações definidaspelo usuário no Editor de Subconjunto no IBM Cognos TM1(r) Perspectives andArchitect, e ativa o botão Criar Consolidação Customizada nos clientesTM1(r)Web.


Por padrão, UserDefinedCalculations é ativado.

Para desativar as consolidações definidas pelo usuário do TM1 Perspectives,Architect e clientes TM1 Web, inclua a seguinte linha no tm1s.cfg:UserDefinedCalculations=F

Nota: Quando configurado como F, os usuários verão o seguinte:v No Architect e Perspectives, quando os usuários clicam na opção Rolagem ou

Inserir Subconjunto, uma mensagem de erro indicando que os cálculosdefinidos pelo usuário não estão ativados será exibida.

v No TM1 Web, o botão Criar Consolidação Customizada será esmaecido.

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

SQLExtendedFetch(), uma função ODBC 2

SQLFetchScroll(), 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 o SSL no servidor IBM Cognos TM1 .


Este parâmetro é ativado por padrão.

Para desativar o SSL, configure UseSSL=F.

Quando UseSSL=T, você deverá definir vários outros parâmetros tm1s.cfg quegerenciam a implementação de SSL. Para obter detalhes sobre esses parâmetros,consulte “Usando SSL para Segurança de Transmissão de Dados” na página 233.

Valor padrão: T

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 do


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

Em raras ocorrências, usar o método TREE pode resultar em uma degradação dodesempenho. Em ocorrências como essa, tente definir o parâmetro como ARRAY.Por exemplo, no caso incomum quando as dimensões tiverem apenas algunselementos folha 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

ouViewConsolidationOptimizationMethod=ARRAY

Se ViewConsolidationOptimizationMethod não for explicitamente definido noarquivo Tm1s.cfg, o método ARRAY será usado por padrão, pois isso mantém aconsistência com a versão anterior do TM1 antes do parâmetroViewConsolidationOptimizationMethod ser introduzido.

ZeroWeightOptimizationDetermina se os membros consolidados com um peso de 0 são fatorados no cálculode valores de célula consolidada ou funções de consolidação. As funções deconsolidação incluem ConsolidatedCount, ConsolidatedMax, ConsolidatedMin,ConsolidatedAvg, ConsolidatedCount, e ConsolidatedCountUnique.


Quando configurados como true, os membros para os quais o peso for zero serãoeliminados da lista de consolidação e, portanto, não serão processados ao calcularos valores para células consolidadas ou funções de consolidação. Esse é ocomportamento padrão.

Quando configurados como false, os membros para os quais o peso for zero sãoincluídos na lista de consolidação e, portanto, são fatorados nos cálculos.

Valor padrão: true


Apêndice B. 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 do arquivo específica do usuário.

As duas versões do arquivo Tm1p.ini são armazenadas em diferentes locais.

Arquivo Tm1p.ini Padrão do Sistema

A versão padrão do sistema do Tm1p.ini permite que vários usuários usem oCognos TM1 em um determinado computador. O arquivo Tm1p.ini deverá estarpresente na primeira vez em que um usuário iniciar o Cognos TM1 nocomputador, pois os parâmetros na versão padrão do sistema controlam ocomportamento da primeira inicialização do cliente Cognos TM1 para cadausuário.

O local de instalação da versão padrão do sistema do arquivo Tm1p.ini dependede qual versão do Microsoft Windows está sendo usada.

Para o Microsoft Windows XP ou o Windows Server 2003:

O local da versão padrão do sistema do arquivo Tm1p.ini é:

%ALLUSERSPROFILE%\Application Data\Applix\TM1\

Por exemplo:

C:\Documents and Settings\All Users\Application Data\Applix\TM1\Tm1p.ini

Dica: Para determinar o valor da variável de ambiente %ALLUSERSPROFILE%,execute echo %ALLUSERSPROFILE% a partir de uma linha de comandos.

Para o Microsoft Windows 7 e o Windows Server 2008:

Para as versões mais recentes do Microsoft Windows, o local do arquivoTm1p.ini padrão do sistema é determinado pela configuração%ProgramData%.

%ProgramData%\Applix\TM1\

Por exemplo:

C:\ProgramData\Applix\TM1\Tm1p.ini

Dica: Execute echo %ProgramData% a partir de uma linha de comandospara consultar o local exato.

Arquivo Tm1p.ini Específico do Usuário

Depois que um usuário iniciar o Cognos TM1 no computador, uma cópia específicado usuário do arquivo Tm1p.ini será criada no local %USERPROFILE%.


A cópia específica do usuário do Tm1p.ini aceita todas as configurações deparâmetros e mudanças para o usuário e controla o comportamento do clienteCognos TM1 para todas as sessões subsequentes do usuário do cliente CognosTM1.

A caixa de diálogo Opções do Cognos TM1 também armazena muitas dessasconfigurações. É possível alterar essas configurações usando a caixa de diálogoOpções do TM1 ou editando o arquivo Tm1p.ini. Os parâmetros Tm1p.ini e asOpções do TM1 são descritos aqui.

O local exato para o %USERPROFILE% depende de qual versão do Microsoft Windowsvocê está usando.

Dica: Execute o echo %USERPROFILE% a partir de uma linha de comandos para vero local exato.

Para o Microsoft Windows XP ou o Windows Server 2003:

O local da versão específica do usuário do arquivo Tm1p.ini é:

%USERPROFILE%\user name\Application Data\Applix\TM1\

Por exemplo:

C:\Documents and Settings\user name\Application Data\Applix\TM1\Tm1p.ini

Para o Microsoft Windows 7 e o Windows Server 2008:

Para as novas versões do Microsoft Windows, a cópia específica do usuáriodo arquivo Tm1p.ini é localizada aqui:

%USERPROFILE%\user name\AppData\Roaming\Applix\TM1\

Por exemplo:

C:\Users\ADMIN\AppData\Roaming\Applix\TM1\Tm1p.ini

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 deste parâmetro deve ser idêntico ao SSLCertificateIDparameter forthe Cognos TM1 Admin Server conforme definido no IBM Cognos Configuration.


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 “Configurando o TM1 Server para Usar a Segurançado Cognos” na página 220.

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.

Apêndice B. O Arquivo de Configuração do Cliente Tm1p.ini 331

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 formulário 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 “Configurando o TM1 Server para Usar a Segurançado Cognos” na página 220.

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.

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.


DisableWritebackOnDisconnectQuando DisableWritebackOnDisconnect é ativado no arquivo Tm1p.ini as célulasda planilha contendo fórmulas do TM1 que gravam para o TM1 Serverpermanecerão ativas e gravarão no servidor,contanto que uma conexão do servidorativo esteja disponível.

No entanto, quando este parâmetro estiver ativado e o cliente TM1 Perspectivesnão estiver conectado a um TM1 Server, as células contendo fórmulas do TM1 quegravam para o servidor não estarão mais protegidas. Neste caso, a inserção de umvalor em qualquer célula de planilha que contenha uma fórmula do TM1 quegrave para o servidor TM1 resultará na substituição da fórmula do do TM1.

As fórmulas do TM1 que gravam para o servidor incluem DBR, DBRW, DBRA, DBS,DBSA, DBSS, e DBSW.

Configurar o DisableWritebackOnDisconnect=T também restaura várias operaçõesdesfazer/refazer de nível e várias operações copiar/colar em uma planilha quecontém fórmulas do TM1 quando não há nenhuma conexão de servidor ativo.

DisableWritebackOnDisconnect tem um efeito semelhante, comoDisableWritebackOnTM1Formulas. A distinção importante entre esses doisparâmetros é que o DisableWritebackOnDisconnect se aplica apenas quando não hánenhuma conexão do servidor ativo,enquanto DisableWritebackOnTM1Formulas seaplica em todos os momentos.

DisableWritebackOnTM1FormulasQuando ativado no arquivo Tm1p.ini, o parâmetro DisableWritebackOnTM1Formulaimpede o writeback para o servidor TM1 quando um valor é inserido em umacélula contendo uma fórmula de planilha do TM1.

Neste caso, DisableWritebackOnTM1Formula=T a inserção de um valor em qualquercélula de planilha que contenha a fórmula do TM1 que grave para o servidor TM1resultará na substituição da fórmula do TM1.

As fórmulas do TM1 que gravam para o servidor incluem DBR, DBRW, DBRA, DBS,DBSA, DBSS e DBSW.

Configurar o DisableWritebackOnTM1Formula=T também restaura várias operaçõesdesfazer/refazer de nível e várias operações copiar/colar em uma planilha quecontém fórmulas do TM1 quando não há nenhuma conexão de servidor ativo.

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 o seu cliente IBM Cognos TM1 usa o Login Integrado ou a segurançaCognos TM1 padrão para efetuar login no servidor Cognos TM1 e outroscomponentes do Cognos TM1 .v T - O cliente usa Login Integrado, no qual seu nome de usuário e senha de login

Microsoft Windows são usados para acessar o servidor Cognos TM1 e outroscomponentes.

v F (Padrão) - O cliente usa a segurança Cognos TM1 padrão, em que um nomedo usuário e senha devem ser explicitamente fornecidos, ao efetuar login noservidor Cognos TM1 e outros componentes.

Antes de ativar esse parâmetro, consulte seu administrador Cognos TM1 paradeterminar se o Login Integrado é implementado em seu servidor Cognos TM1 .

Nas Opções do Cognos TM1 , use o Login Integrado.

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

Idioma Código


Croata hrv

Tcheco csy



Dinamarquês dan

Belga nld

Alemão deu

Finlandês fin

Francês fra

Húngaro hun

Italiano ita

Japonês jpn

Cazaque kaz


Idioma Código

Coreano kor

Norueguês nor

Polonês pol

Romeno rom

Russo rus

Espanhol esp

NLB slv

Sueco sve

Tailandês tha

Turco trk

LocalServerNetworkProtocolDetermina o protocolo que o servidor local IBM Cognos TM1 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 umamensagem de aviso.

v F - Nenhuma mensagem será exibida quando um Subconjunto Dinâmico foralterado.

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 for

processada.

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 do IBMCognos TM1, a planilha contém uma variável nomeada pelo nível de pasta detrabalho, TM1RebuildOption, que é definido em 1 por padrão. Isto faz com que asplanilhas no catálogo sejam reconstruídas na abertura (forçando que um recálculoocorra em cada folha no catálogo). Esta ação é necessária se as folhas contêm


Formulários Ativos. Se não estiver trabalhando com Formulários Ativos, você nãopoderá desejar que todas as pastas de trabalho usem este comportamento padrão.

Todas as planilhas são recalculadas quando uma pasta de trabalho do Cognos TM1é aberta. A pasta de trabalho foi criada cotando 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. Isso faz a pasta de trabalho ser reconstruída naabertura, causando um recálculo de todas as folhas que são importantes paraFormulários Ativos, mas podem não ter o comportamento desejado se você estátrabalhando principalmente 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 essa opção for definida como T ou não existir, cortar a partir de umavisualização no Cognos TM1 Perspectives define a variável nomeada no nível dapasta de trabalho TM1RebuildOption como 1 que força a reconstrução na abertura.Se esta opção for F, a variável de nome TM1RebuildOption será configurada como0, o que não reconstrói. Para um relatório específico, por exemplo, um FormulárioAtivo, é possível configurar a variável de nome como 1 em 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 C. 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. Você deve 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 40. Códigos de Produto do TM1 para uma Instalação Não Assistida

Código do Produto Produto

TM1APPTIER_APP=1 Camada do TM1 Applications

TM1SERVER_APP=1 TM1 Server

TM1ADMINSERVER_APP=1 Servidor Admin de TM1

TM1TOOLS_APP=1 TM1 Tools

TM1WEBAPPTIER_APP=1 Camada do TM1 Web Applications

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 Camada de Cliente do TM1

TM1PERSPECTIVES_APP=1 TM1 Perspectives

TM1COGNOSINSIGHT_APP=1 Cognos Insight

TM1APIS_APP=1 API do TM1

TM1DEVTIER_APP=1 Camada do Desenvolvedor do TM1

TM1ARCHITECT_APP=1 TM1 Architect

TM1PERFMOD_APP=1 TM1 Performance Modeler

TM1SAMPLETIER_APP=1 Camada de Amostra do TM1

É 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 341 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 C. Configurando Instalações e Configurações Não Assistidas 343

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

Para localizar a documentação na web, incluindo toda a documentação traduzida,acesse IBM Knowledge Center (http://www.ibm.com/support/knowledgecenter).

Para localizar os links dos problemas conhecidos e authorized program analysisreports (APARs) mais recentes, acesse as notas sobre a liberação.


http://www.ibm.com/support/knowledgecenter/

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.

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 D. Resolvendo um Problema 347

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

Este material pode estar disponível na IBM em outros idiomas. No entanto, podeser necessário possuir uma cópia do produto ou da versão do produto nesseidioma para acessá-lo.

É possível que a IBM não ofereça os produtos, serviços ou recursos discutidosnesta publicação em outros países. Consulte um representante IBM local para obterinformações sobre 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 autorização de licença adquiridopelo Cliente.

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. Consultas sobre licença devem ser enviadas, por escrito,para:

Gerência de Relações Comerciais e Industriais da IBM BrasilAv. Pasteur, 138-146BotafogoRio de Janeiro, RJCEP 22290-240

Para consultas sobre licença relacionadas a informações de DBCS (Conjunto deCaracteres de Byte Duplo), entre em contato com o Departamento de PropriedadeIntelectual da IBM em seu país ou envie pedidos de licença, por escrito, para:

IBM World Trade Asia CorporationLicensing2-31 Roppongi 3-chome, Minato-ku19-21, Nihonbashi-Hakozakicho, Chuo-kuTokyo 103-8510, Japan

O parágrafo a seguir não se aplica ao Reino Unido e a nenhum país em que taisdisposições não estejam de acordo com a legislação local: A INTERNATIONALBUSINESS MACHINES CORPORATION FORNECE ESTA PUBLICAÇÃO "NOESTADO EM QUE SE ENCONTRA", SEM GARANTIA DE NENHUM TIPO, SEJAEXPRESSA OU IMPLÍCITA, INCLUINDO, MAS A ELAS NÃO SE LIMITANDO,AS GARANTIAS 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 incluir imprecisões técnicas ou erros tipográficos. Sãofeitas alterações periódicas nas informações aqui contidas; tais alterações serãoincorporadas em futuras edições desta publicação. A IBM pode, a qualquermomento, aperfeiçoar e/ou alterar os produtos e/ou programas descritos nestapublicação, sem aviso prévio.

Quaisquer referências nestas informações a Web sites não IBM são fornecidasapenas para conveniência e não funcionam, de maneira nenhuma, como umendosso desses Web sites. Os materiais nesses Web sites não fazem parte dosmateriais para este produto IBM e o uso desses Web sites é de inteiraresponsabilidade do Cliente.

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 aos termos e condiçõesapropriados, incluindo, em alguns casos, o pagamento de uma taxa.

O programa licenciado descrito nesta publicação e todo o material licenciadodisponível a ele são fornecidos pela IBM sob os termos do IBM CustomerAgreement, do Contrato de Licença do Programa Internacional da IBM ou dequalquer contrato equivalente entre as partes.

Os dados de desempenho aqui contidos foram determinados em um ambientecontrolado. Portanto, os resultados obtidos em outros ambientes operacionaispodem variar significativamente. Foram tomadas algumas medidas nos sistemas denível de desenvolvimento e não há nenhuma garantia de que estas medidas sejamas mesmas nos sistemas geralmente disponíveis. Além disso, algumas medidaspodem ter sido estimadas por meio de extrapolação. Os resultados reais podemvariar. Os usuários desta publicação devem verificar os dados aplicáveis ao seuambiente específico.

As informações relativas a produtos não IBM foram obtidas dos fornecedoresdesses produtos, dos anúncios publicados ou de outras fontes publicamentedisponíveis. A IBM não testou esses produtos e não pode confirmar a exatidão dodesempenho, da compatibilidade ou de outras solicitações relacionadas a produtosnão IBM. Questões sobre os recursos de produtos não IBM devem ser endereçadasaos fornecedores desses produtos.

Todas as instruções relativas a futuras orientações ou intenções da IBM estãosujeitas a alteração ou retirada sem aviso prévio e apenas representam metas eobjetivos.

Estas informações contêm exemplos de dados e relatórios usados em operações denegócios diárias. Para ilustrá-las da maneira mais completa possível, os exemplos


incluem os nomes de indivíduos, empresas, marcas e produtos. Todos esses nomessão fictícios e qualquer semelhança com nomes e endereços usados por umaempresa real é totalmente coincidência.

Se estiver visualizando estas informações em formato eletrônico, as fotografias eilustrações coloridas poderão não aparecer.

Esta Oferta de Software não usa cookies ou outras tecnologias para coletarinformações pessoais identificáveis.

Marcas Registradas

IBM, o logotipo IBM e ibm.com são marcas ou marcas registradas da InternationalBusiness Machines Corp., registradas em vários países no mundo todo. Outrosnomes de produtos e serviços podem ser marcas registradas da IBM ou de outrasempresas. Uma lista atual de marcas registradas da IBM está disponível na Webem “ Copyright and trademark information ” em www.ibm.com/legal/copytrade.shtml.

Os termos a seguir são marcas ou marcas registradas de outras empresas:v Adobe, o logotipo Adobe, PostScript e o logotipo PostScript são marcas ou

marcas registradas da Adobe Systems Incorporated nos Estados Unidos e/ou emoutros países.

v Microsoft, Windows, Windows NT e o logotipo Windows são marcas registradasda Microsoft Corporation nos Estados Unidos e/ou em outros países.

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

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

Avisos 351

http://www.ibm.com/legal/copytrade.shtml

Índice Remissivo

Caracteres Especiais.NET Framework 17

Numéricos32 bits 3764 bits 37

Aacesso

privilégios, diretório de dados 30AdminHost 273, 330administração

tm1web_config.xml 121AdminSvrSSLCertAuthority 237, 273, 330AdminSvrSSLCertID 237, 273, 330AdminSvrSSLCertRevList 237, 274, 331AdminSvrSSLExportKeyID 237, 274, 331AdvancedRulesEditor 331agrupamento em células 135ajuste de desempenho 93AllowImportCamClients 331AllowImportCAMClients 225AllowReadOnlyChore Reschedule 274AllowSeparateNandCRules 81, 274AllRuleCalcStargateOptimization 275Amostra de Planejamento

Iniciar 79, 88amostras 181Apache tomcat

remover implementação 263APIs do TM1

instalando 178aplicativo da web 35Aplicativos de TM1 260

camada de dados 36certificados SSL de terceiros 247com a segurança do IBM Cognos BI 228com tempo limite da sessão de segurança do IBM

Cognos 231desinstalando o Applications 263instalando em um único computador 41modo de autenticação de segurança 40, 196opções de implementação 40Portal do cognos connection 75restaurando arquivos de aplicativo 266restaurando arquivos de configuração 266salvando direitos de segurança 63usando com a segurança do Cognos BI 228

ApplyMaximumViewSizeToEntireTransaction 276Architect 29Armazenamento CalculationThresholdFor 278arquitetura 25arquitetura da Web 31arquivo .cfg 30, 271arquivo .ini 30, 329arquivo .rej 27arquivo de inicialização 30, 329arquivo de log de transações 27

arquivo response.ats 341Arquivo Tm1p.ini 30, 329Arquivo Tm1s.cfg 30, 271

amostra 272local 271parâmetros 272

arquivos de configuração 21árvore de navegação

nó de visualizações 134aspas 272atalhos de teclado 269

Cognos Configuration 270Ativar Macros 80Ativar ponto de visualização de negócios 144Ativar publicação a partir do Cognos Insight 144atualizando para o Cognos TM1 Applications 58AuditLogMaxFileSize 276AuditLogMaxQueryMemory 276AuditLogOn 277AuditLogUpdateInterval 277autenticação 194, 196, 219

diagrama de login integrado 194importando grupos no TM1 224login integrado 194

autenticação, diagrama LDAP 195autenticação, LDAP 194autenticação do Cognos 196, 219

definindo um administrador 223Autenticação LDAP 213, 218

configurando a validação 217ETLDAP 217modificando as designações do grupo 217parâmetros 213TM1S.cfg 217validando usuários 213

AutomaticallyAddCubeDependencies 277

Bbackup

Aplicativos de TM1 257, 261Backup de dados 55Backup de versão anterior 55banco de dados de amostra instalado 182banco de dados de amostras GOSALES 184BD OLE 37BrowseDisplayReadsRightToLeft 331

CCacheFriendlyMalloc 278caixa de diálogo Ferramenta de Carregamento LDAP 199camada 2 35camada 3 36Camada do cliente 11Camada do desenvolvedor 12CAMID 196, 219caminho de classe 107CAMPortalVariableFile 278CAMSSLCertificate 279


caracteres ASCII em nomes de diretório 78caracteres não ascii e movimentação 95cenário de instalação 77certificado 249

armazenamento 235autoridade 235revogação 235

certificados 234, 250CertificateVersion 237, 279chave de identidade 235chave privada 235CheckFeedersMaximumCells 279ClassicSliceMode 332ClientCAMURI 280clientes não SSL 235ClientExportSSLSvrCert 237, 280ClientExportSSLSvrKeyID 237, 280ClientMessagePortNumber 281ClientPingCAMPassport 280ClientPropertiesSyncInterval 281ClientVersionMaximum 281ClientVersionMinimum 282ClientVersionPrecision 283codificação de caracteres 95códigos de idioma 96, 97códigos do produto 341Cognos Analysis para Microsoft Excel 73, 74

proxy 160Cognos Configuration 78, 88, 144Cognos Connection 79Cognos Insight 78

criação de log 178em execução 83instalando 83, 175

Cognos Query Studio 71Cognos Report Studio 71Cognos TM1 application server

Iniciar 141Cognos TM1 Applications

visão geral da arquitetura 33Cognos TM1 Operations Console 107Cognos TM1 Performance Modeler

criação de log 173instalando 170

Cognos Workspace 72CognosGatewayURI 225, 332CognosMDX.AggregateByAncestorRef 284CognosMDX.CellCacheEnable 284CognosMDX.PrefilterWithPXJ 284CognosMDX.SimpleCellsUseOPTSDK 285CognosMDX.UseProviderCrossJoinThreshold 285CognosTM1InterfacePath 286comandos do sistema de 64 bits 107Companhia das aventuras 183componente Camada do Aplicativo da Web 10Componente de amostras 13Componente de camada do aplicativo 9componentes 77componentes adicionais 257componentes do cliente 8componentes do servidor 8componentes do TM1 8conectando-se a um servidor 203conectividade SAP 68conexão de replicação 233configuração 20configuração da página de login 125

configuração do código de idioma 39configuração do idioma 96, 98configuração regional 39configurações padrão 18configurando a validação 217configurando componentes 92configurar 79, 88configurar a página de login 125configuration parameters

TM1 Web 121ConnectLocalAtStartup 332Conta de Serviço do TM1 21convertendo .xls 62credenciais de login 81criptografar 235Cube Viewer

tamanho da página 134Cube Viewer, exportar planilhas 134CubeviewerStringWrap 135

DDataBaseDirectory 286, 332DB OLE do TM1 14decriptografar 235DefaultMeasuresDimension 286designações de grupo 217desinstalação 259, 260, 343DHFile-1024 237, 286DHFile-2048 237, 287DHFile-512 237, 286Diffie-Hellman 235DimensionDownloadMaxSize 332diretório de dados

acesso à rede necessário 30caminho 29definição 29diversos 30privilégio de acesso 30segurança 30servidor local 30servidor remoto 30

diretório de dados do caminho 29DisableMemoryCache 287DisableSandboxing 287Display_Info_DBType_R8 288DisplayApplications 332DisplayChores 333DisplayControlCubes 333DisplayCubes 334DisplayDimensions 334DisplayExplorerPropertiesWindow 334DisplayProcesses 334DisplayReplications 334DistributedPlanningOutputDir 81, 288diversos Hosts Administrativos 26diversos servidores 32do Express 26, 29documentação traduzida 13domínios

conta 39instalando sem 22

DownTime 289


Eeditando tm1web_config.xml 121Efetuando login 113Efetuar Logon Como 233elementos de consulta

LDAP 202EnableODBCproxy 289Endereço IP 295Enfileiramento 296ETLDAP

atributo de registro modificado LDAP 205atributos de mapeamento LDAP para campos TM1 204atualizando o TM1 com novos usuários LDAP 205Botão Exportar 199botão Procurar 199campo Atributos 199Campo DN de Procura 199campo Filtro 199conectando-se a um servidor 203configurando parâmetros de login de LDAP 200construindo a consulta LDAP 202elementos de consulta LDAP 202executando a partir do DOS 199executando no modo de atualização 205exportando os usuários LDAP para TM1 205modificando atributos LDAP 197opção Escopo da Procura 199opções de exportação 204Tabela de Resultados 199

ETLDAP, autenticação LDAP 217ExcelWebPublishEnabled 289Executar como Administrador 78ExpandRowHeaderWidth 334ExportAdminSvrSSLCert 237, 290, 334exportando dados PDF 85, 179exportar

máximo de planilhas 134ExportSvrSSLCert 237, 290extensão do arquivo .blb 28extensão do arquivo .cho 28extensão do arquivo .cub 28extensão do arquivo .dim 28extensão do arquivo .dit 28extensão do arquivo .pro 28extensão do arquivo .rux 28extensão do arquivo .sub 28extensão do arquivo .tbu 28extensão do arquivo .tqu 28extensão do arquivo .tru 28extensão do arquivo .vue 28extensão do arquivo .xdi 28extensão do arquivo .xru 28extensões do arquivo 28

Ffazendo backup dos dados 257fazendo upgrade 105Ferramentas 191Fila de Tarefas 296Firefox 211Forçar caminhos qualificados 144Frequência de ping do Cognos Insight (segundos) 144funções do TurboIntegrator 161

restringindo a execução do 162

GGO_Contributor 183GO_New_Stores

Iniciar 79, 88

HHTTPPortNumber 292HTTPSessionTimeoutMinutes 292

IIBM AIX

ajuste de desempenho 93comandos não suportados com TM1 94executando o TM1 com 93limites de recurso de memória 93

ID do usuário e senha 144idioma 39Idioma 298idioma para clientes 335IdleConnectionTimeOutSeconds 292implementação 35implementando

TM1 Application Server 153TM1 Applications Web 119TM1 Operations Console 106, 108, 109, 111, 112TM1 Web 118, 119

impressora padrão 85, 179incluindo um servidor 99incluir e remover programas 56Iniciar

Cognos TM1 application server 141serviços 79, 88

iniciar IBM Cognos Configuration 92Insight

restrições da função do TurboIntegrator 161InSpreadsheetBrowser 335instalação 18instalação da web de diversos computadores 116instalação de diversos computadores 87instalação distribuída 38instalação do cliente 7, 165instalação do Linux 7instalação do TM1 Applications 35instalação do TM1 Server no Linux 90instalação do TM1 Server no Unix 90instalação do TM1 Server no Windows 87instalação do UNIX 7instalação do Windows de 32 bits 7instalação do Windows de 64 bits 7instalação não assistida 341, 343instalação silenciosa 341instalando 191

IBM Cognos BI 341instalação não assistida 341usando arquivo de especificação de transferência

(.ats) 341instalando clientes TM1 165instalar o TM1 Operations Console em máquina

separada 106integração do TM1 65IntegratedLogin 335IntegratedSecurityMode 293Interação Paralela

parâmetro JobQueueThreadPoolSize 297

Índice Remissivo 355

Interação Paralela (continuação)parâmetro ParallelInteractiong 310

Internet Explorer 211interoperabilidade 278interoperabilidade do TM1 65intervalo de pulsação 26introdução xiIPAddress 294iWidgets 72, 278

Jjanela de comando DOS 199Java 42

SSL 249JavaClassPath 296JavaJVMArgs 296JavaJVMPath 296JobQueueMaxWaitTime 297JobQueueThreadPoolSize 297JobQueueThreadSleepTime 298

LLDAP

atributo de registro modificado 205atributos de mapeamento para campos TM1 204atualizando o TM1 com novos usuários 205autenticação 194, 195configurando os parâmetros de login 200construindo uma consulta 202executando ETLDAP no modo de atualização 205exportando os usuários para TM1 205modificando atributos 197

LDAPHost 213, 299LDAPPasswordFile 213, 299LDAPPasswordKeyFile 213, 214, 299LDAPPort 213, 214, 299LDAPSearchBase 213, 214, 299LDAPSearchField 213, 214, 300LDAPSkipSSLCertVerification 213, 215, 300LDAPSkipSSLCRLVerification 213, 215, 218, 300LDAPUseServerAccount 213, 215, 300LDAPVerifyCertServerName 213, 215, 218, 301LDAPVerifyServerSSLCert 213, 216, 218, 301LDAPWellKnownUserName 213, 217, 302limitando 33Linux

iniciar o TM1 Server 92instalação 91instalação do TM1 Server 90

locais 18localizando informações xiLocalServerNetworkProtocol 336LockPagesInMemory 302log

arquivo 27LoggingDirectory 303login, integrado 206login integrado 194, 211

Architect 212campo UniqueID 206configurando 207configurando manualmente 209cubo }ClientProperties 206direitos de acesso 208

login integrado (continuação)TM1 Perspectives 212TM1 Web 212visão geral 206

LogReleaseLineCount 303

MMagnitudeDifferenceToBeZero 303MainWindowLayoutInfo 336manter instalação 257MaskUserNameInServerTools 304MaximumCubeLoadThreads 304MaximumLoginAttempts 305MaximumMemoryForSubsetUndo 305MaximumTILockObject 306MaximumUserSandboxSize 307MaximumViewSize 307MessageCompression 307metadados 27Microsoft .NET 78Microsoft Internet Explorer 211Microsoft Visual C++ 78modificação de componentes 258modificando

designações de grupo 217modificar instalação 258modo de autenticação de segurança

Aplicativos de TM1 40, 196TM1 Application Web 141, 151, 157

monitorando servidores 9.5.2 105Mozilla 211MTQ 307MTQ.OperationProgressCheckSkipLoopSize 308MTQ.SingleCellConsolidation 308

NNetRecvBlockingWaitLimitSeconds 309NetRecvMaxClientIOWaitWithinAPIsSeconds 309Nome da pasta do Cognos Connection 144nome de usuário 23

padrão para amostras 18nomes de objetos do TM1 95nomes e códigos de idioma não ascii 95novos clientes 224números de porta 18

OODBCLibraryPath 309opções de implementação 37Operations Console 109, 111, 112

segurança do Cognos 226OracleErrorForceRowStatus 310

PPackage Connector Windows 7 68Pacote Redistribuível do Visual C++ 2010 17Parâmetro AdminHost 242

SSL 237parâmetro de configuração CognosTM1InterfacePath 70Parâmetro DisableWritebackOnDisconnect 333parâmetro DisableWritebackOnTM1Formulas 333


parâmetro Language para clientes 98parâmetro Language para o servidor 98parâmetro MaximumSynchAttempts 305Parâmetro SyncUnitSize 323Parâmetro Tm1s.cfg necessário

AdminHost 273CAMPortalVariableFile 278CAMSSLCertificate (depende do CAM) 279DataBaseDirectory 286

Parâmetro Tm1s.cfg Opcional 213, 299AdminSvrSSLCertAuthority 273AdminSvrSSLCertID 273AdminSvrSSLCertRevList 274AdminSvrSSLExportKeyID 274AllowReadOnlyChore Reschedule 274AllowSeparateNandCRules 274AllRuleCalcStargateOptimization 275ApplyMaximumViewSizeToEntireTransaction 276AuditLogMaxFileSize 276AuditLogMaxQueryMemory 276AuditLogOn 277AuditLogUpdateInterval 277AutomaticallyAddCubeDependencies 277CacheFriendlyMalloc 278CalculationThresholdForStorage 278CAMSSLCertificate 279CertificateVersion 279CheckFeedersMaximumCells 279ClientCAMURI 280ClientExportSSLSvrCert 280ClientExportSSLSvrKeyID 280ClientMessagePortNumber 281ClientPingCAMPassport 280ClientPropertiesSyncInterval 281ClientVersionMaximum 281ClientVersionMinimum 282ClientVersionPrecision 283CognosMDX.AggregateByAncestorRef 284CognosMDX.CellCacheEnable 284CognosMDX.PrefilterWithPXJ 284CognosMDX.SimpleCellsUseOPTSDK 285CognosMDX.UseProviderCrossJoinThreshold 285CognosTM1InterfacePath 286DefaultMeasuresDimension (pode ser necessário

OLAP) 286DHFile-1024 286DHFile-2048 287DHFile-512 286DisableMemoryCache 287DisableSandboxing 287Display_Info_DBType_R8 288DistributedPlanningOutputDir 288DownTime 289EnableODBCproxy 289ExcelWebPublishEnabled 289ExportAdminSvrSSLCert 290ExportSvrSSLCert 290ForceReevaluationOfFeedersForFedCellsOnDataChange 291HTTPPortNumber 292HTTPSessionTimeoutMinutes 292Idioma 298IdleConnectionTimeOutSeconds 292IntegratedSecurityMode 293IPAddress 294IPV6 295JavaClassPath 296JavaJVMArgs 296

Parâmetro Tm1s.cfg Opcional (continuação)JavaJVMPath 296JobQueueMaxWaitTime 297JobQueueThreadPoolSize 297JobQueueThreadSleepTime 298JobQueuing 296LDAPHost 213, 299LDAPPasswordKeyFile 214, 299LDAPPort 214, 299LDAPSearchBase 214, 299LDAPSearchField 214, 300LDAPSkipSSLCertVerification 215, 300LDAPSkipSSLCRLVerification 215, 300LDAPUseServerAccount 215, 300LDAPVerifyCertServerName 215, 301LDAPVerifyServerSSLCert 216, 301LDAPWellKnownUserName 217, 302LockPagesInMemory 302LoggingDirectory 303LogReleaseLineCount 303MagnitudeDifferenceToBeZero 303MaskUserNameInServerTools 304MaximumCubeLoadThreads 304MaximumLoginAttempts 305MaximumMemoryForSubsetUndo 305MaximumSynchAttempts 305MaximumTILockObject 306MaximumUserSandboxSize 307MaximumViewSize 307MessageCompression 307MTQ 307MTQ.OperationProgressCheckSkipLoopSize 308MTQ.SingleCellConsolidation 308NetRecvBlockingWaitLimitSeconds 309NetRecvMaxClientIOWaitWithinAPIsSeconds 309ODBCLibraryPath 309OracleErrorForceRowStatus 310PasswordMinimumLength 310PasswordSource 213, 310PerfMonIsActive 311PerformanceMonitorOn 311PersistentFeeders 311PortNumber 312PrivilegeGenerationOptimization 312ProgressMessage 313ProportionSpreadToZeroCells 313RawStoreDirectory 314ReceiveProgressResponseTimeoutSecs 315RulesOverwriteCellsOnLoad 315RunningInBackground 316SaveTime 316SecurityPackageName 316ServerCAMURI 317ServerCAMURIRetryAttempts 317ServerLogging 318ServerName 318ServicePrincipalName 318SkipLoadingAliases 319SkipSSLCAMHostCheck 319SpreadingPrecision 319SSLCertAuthority 320SSLCertificate 321SSLCertificateID 321SSLCertRevocationFile 321SSLPrivateKeyPwdFile 321SSLPwdKeyFile 321StartupChores 322


Parâmetro Tm1s.cfg Opcional (continuação)SubsetElementBreatherCount 322SvrSSLExportKeyID 323SyncUnitSize 323TM1ConnectorforSAP 323UnicodeUpperLowerCase 324UseExtendedFetch 325UseLocalCopiesforPublicDynamicSubsets 324UseNewConnectorforSAP 325UserDefinedCalculations 325UseSQLFetch 325UseSQLFetchScroll 325UseSSL 326UseStargateForRules 326ViewConsolidationOptimization 327ViewConsolidationOptimizationMethod 327ZeroWeightOptimization 328

Parâmetro Tm1s.cfg relacionado ao UNIXODBCLibraryPath 309RunningInBackground 316

parâmetros, tm1web_config.xml 121parâmetros SSL

AdminSvrSSLCertAuthority 273AdminSvrSSLCertID 273AdminSvrSSLCertRevList 274AdminSvrSSLExportKeyID 274CertificateVersion 279ClientExportSSLSvrCert 280ClientExportSSLSvrKeyID 280DHFile-1024 286DHFile-2048 287DHFile-512 286ExportAdminSvrSSLCert 290ExportSvrSSLCert 290SSLCertAuthority 320SSLCertificate 321SSLCertificateID 321SSLCertRevocationFile 321SSLPrivateKeyPwdFile 321SSLPwdKeyFile 321SvrSSLExportKeyID 323UseSSL 326

parar o TM1 Contributor 54parar serviços 54, 262passaporte 196, 219passaporte de segurança Cognos 196, 219PasswordMinimumLength 310PasswordSource 213, 310pdata 29PerfMonIsActive 311Performance Modeler 78

instalando 82PerformanceMonitorOn 311Permitir atualizações provisionadas 144Permitir instalações provisionadas 144PersistentFeeders 311Planejamento 7planejamento do upgrade 50planilha .xlsx 62planilhas da web 83pmhub.war 109pmpsvc.war 153, 154ponto como domínio local 23porta SSL 18Portal do cognos connection 75PortNumber 312PreviousAdminHosts 336

PreviousDataDirectories 336PrivilegeGenerationOptimization 312privilégios de administrador 78privilégios na Conta do Serviço 21ProgressMessage 313ProportionSpreadToZeroCells 313Provedor de notificações 144proxy 160

RRawStoreDirectory 314ReceiveProgressResponseTimeoutSecs 315recursos de acessibilidade 269regras de logon 232Remover versão anterior 56requisitos 17Requisitos do TM1 Package Connector 67Resolução de problemas 345restaurando arquivos de amostra de backup para Microsoft

SQL 189restaurando dados após o upgrade 61, 265restaurar arquivos de backup para Oracle 186restaurar banco de dados de amostras no DB2 184revogação 235RulesOverwriteCellsOnLoad 315RunningInBackground 316

Ssalvando dados 27SAP 323SaveTime 316sdata 29SData

Iniciar 79, 88SecurityAssignmentWindowLayoutInfo 336SecurityPackageName 316segurança 194segurança do Cognos 219, 226

acesso anônimo 223com tempo limite de sessão do TM1 Applications 231considerações do administrador 232considerações do usuário 232

segurança do Cognos BIcom o TM1 Applications 228

senhapadrão para amostras 18

SentMsgsToServerCountWarning 337ServerCAMURI 317ServerCAMURIRetryAttempts 317ServerLogging 318ServerName 318ServicePrincipalName 318serviço do Admin Server 54serviço do BI 54serviço do Excel 54serviço do TM1 Server 54serviços 20servidor 27, 38

diversos 32Servidor Admin de TM1

Iniciar 79, 88Servidor Administrativo 26, 27, 38servidor da Web 33servidor local 30


servidor remoto 271diretório de dados 30operações 27

servidoresincluindo 99

ShowAdminHostChangeWarning 337ShowAliasAttributeWarning 337ShowChoresSchedulingWarning 337ShowCubeReplicationWarning 337ShowDimDeleteElementWarning 337ShowDimensionAccessWarning 337ShowDynamicSubsetWarning 338ShowPickOperationWarning 338ShowProcessUNASCIIWarning 338ShowProcessUNODBCWarning 338sintaxe da máquina local 23Sintetização 325SkipLoadingAliases 319SkipSSLCAMHostCheck 319SliceNewWorkbook 338software e hardware 17software obrigatório 78Solaris 21SpreadingPrecision 319SSL 233, 235, 252

TM1 Web 243SSLCertAuthority 237, 320SSLCertificate 237, 321SSLCertificateID 237, 321SSLCertRevocationFile 237, 321SSLPrivateKeyPwdFile 237, 321SSLPwdKeyFile 237, 321StartupChores 322SubsetElementBreatherCount 322SubsetWindowLayoutInfo 338SvrSSLExportKeyID 237, 323

Tteclas de atalho 269

IBM Cognos Configuration 270Tempo limite de sessão (min) 144ThirdPartyCertificateTool 255tipos de instalação 7TM1

segurança do Cognos 66TM1 Application

instalando em computadores separados 42TM1 Application Server 41, 42

criação de log 148implementando no IBM WebSphere 154opções de implementação 40

TM1 Application Web 147configuração do servidor 142, 151, 158em execução 81, 83modo de autenticação de segurança 141, 151, 157URL 145usando com diversos servidores TM1 160

TM1 Applications Web 118, 119TM1 Architect

em execução 81TM1 da Conta do Serviço 21TM1 iWidgets 278TM1 Mobile Contributor

com servidores TM1 45cubos de marcação de desempenho 46diagramas de impacto 46

TM1 Mobile Contributor (continuação)exibindo os cubos do TM1 45implementando 43lista de observação 48lista de observação do marcação de desempenho 48visão geral 43

TM1 Operations Console 84, 113incluindo certificados 107Iniciar 106instalando 105

TM1 Package Connector 66, 84TM1 Perspectives

em execução 80TM1 Server

com a segurança do Cognos e acesso anônimo 223iniciando no Linux 92iniciando no UNIX 92Iniciar 79, 88segurança do Cognos 220

TM1 Web 118, 119configuração do navegador da web 135configuration parameters 121em execução 81Kerberos 209Login Integrado 209página inicial 127parâmetros de inicialização 131segurança do Cognos 225SSL 243UNIX 117

TM1ConnectorforSAP 323TM1Crypt 251TM1Functions.cfg 162tm1p.ini

local 329parâmetros 329

TM1RebuildDefault 338TM1S.cfg 217tm1web_config.xml

definidos 121edição 125parâmetros de inicialização 131

tm1web.html 225tm1web.war 119tm1xfer 95Turbo Integrator

restringindo execução de função 161

UUnicodeUpperLowerCase 324UNIX

iniciar o TM1 Server 92instalação 91instalação do TM1 Server 90servidor 271

upgrade de computador único 56upgrade do Architect 57upgrade do Contributor para o TM1 Applications 58upgrade do Perspectives 57upgrade do servidor Linux 57upgrade do servidor Unix 57upgrade do servidor Windows 57upgrade do Web 58URI de fornecimento 144URI do despachante do TM1 Application Service 144URI do dispatch 68


URI do gateway 68usando a segurança do Cognos 224UseNewConnectorforSAP 325UserDefinedCalculations 325UseSQLExtendedFetch 325UseSQLFetch 325UseSQLFetchScroll 325UseSSL 237, 326UseStargateForRules 326usuários

incluindo com ETLDAP 197utilitário ETLDAP 197

Vvalidação 217variables_TM1.xml 225variável de ambiente TM1_Package_Connector 69variável do sistema TEMP 78Versão do Certificado do TM1 Admin Server 235ViewConsolidationOptimization 327ViewConsolidationOptimizationMethod 327

visão geral do upgrade 49Vista

Package Connector 68

WWeb client 34web.config 125WebSphere 109, 111, 112, 118, 119, 153, 154

desinstalação 264Windows

instalação 87Windows 7 78Windows 7 Package Connector 68Windows Server 2008 78Windows Vista 78

ZZeroWeightOptimization 328
