118
IBM Cognos Real-time Monitoring Versão 10.2.2 Guia de Instalação e Configuração

IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

  • Upload
    others

  • View
    7

  • Download
    0

Embed Size (px)

Citation preview

Page 1: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

IBM Cognos Real-time MonitoringVersão 10.2.2

Guia de Instalação e Configuração

���

Page 2: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

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

Informações do Produto

Este documento se aplica ao IBM Cognos Business Intelligence Versão 10.2.2 e poderá também se aplicar àsliberações subsequentes.

Licensed Materials - Property of IBM

© Copyright IBM Corporation 2003, 2014.

Page 3: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Índice

Introdução . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii

Capítulo 1. Como Instalar e Configurar o Aplicativo Real-time Monitoring? . . . . . . . 1Revisando as Notas sobre o Release . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Capítulo 2. Planejamento para Instalar o Real-time Monitoring . . . . . . . . . . . . 3Componentes Usados pelo Real-time Monitoring . . . . . . . . . . . . . . . . . . . . . . . 3

Componentes do Servidor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3Gerenciando Dados do Aplicativo - Componentes do Banco de Dados . . . . . . . . . . . . . . . 4Componentes Opcionais do Servidor . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Arquitetura do Real-time Monitoring . . . . . . . . . . . . . . . . . . . . . . . . . . . 5Requisitos de Memória . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Custos de Memória . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7Considerações sobre Memória Adicionais para Real-time Monitoring . . . . . . . . . . . . . . . 9

Configurando Navegadores da Web . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Capítulo 3. Preparando para Instalar o Real-time Monitoring. . . . . . . . . . . . . 11Revisando Ambientes Suportados . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11Verificando Requisitos do Sistema . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11Preparando os Bancos de Dados . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12Configurando o Failover Ativo-Passivo . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Capítulo 4. Instalando e Configurando Servidores de Aplicativos . . . . . . . . . . 15Instalando os Componentes do Real-time Monitoring Application Server . . . . . . . . . . . . . . . 15Configurando os Parâmetros Iniciais de Inicialização . . . . . . . . . . . . . . . . . . . . . 16Configurando Propriedades de Sistema Durante a Inicialização . . . . . . . . . . . . . . . . . . 18Instalar fix packs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Instalando Fix Packs do Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . 21Instalando os Fix Packs do UNIX e Linux . . . . . . . . . . . . . . . . . . . . . . . . 22

Capítulo 5. Fazendo Atualização de uma Versão Anterior ou Reinstalando o Real-timeMonitoring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

Capítulo 6. Instalando o Real-time Monitoring em um IBM WebSphere ApplicationServer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27Instalando e Implementando o Real-time Monitoring em um IBM WebSphere Application Server. . . . . . . 27

Revisando e Verificando os Requisitos para o IBM WebSphere . . . . . . . . . . . . . . . . . 27Configuração preliminar do Monitoramento em Tempo Real no WebSphere . . . . . . . . . . . . . 28Modificando as configurações da Java virtual machine no WebSphere . . . . . . . . . . . . . . . 29Criando e Configurando a Conexão de Metadados no WebSphere . . . . . . . . . . . . . . . . 33Definindo Origens de Dados no WebSphere . . . . . . . . . . . . . . . . . . . . . . . 36Implementando o Real-time Monitoring em um IBM WebSphere Application Server . . . . . . . . . . 37Configurando o Servidor de Aplicativos para Tratar Conteúdo Dinâmico . . . . . . . . . . . . . . 38

Testando o Real-time Monitoring após a instalação no IBM WebSphere Application Server . . . . . . . . . 39Carregando Amostras do Real-time Monitoring no IBM WebSphere Application Server . . . . . . . . . 39Importando Metadados de Amostra no Real-time Monitoring . . . . . . . . . . . . . . . . . 40

Desinstalando o Real-time Monitoring do IBM WebSphere Application Server . . . . . . . . . . . . . 40Fazendo Backup dos Metadados do Real-time Monitoring . . . . . . . . . . . . . . . . . . . 41Desinstalando do IBM WebSphere Application Server . . . . . . . . . . . . . . . . . . . . 41Executando o Programa de Desinstalação do Real-time Monitoring . . . . . . . . . . . . . . . . 41Desinstalando o Banco de Dados . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

© Copyright IBM Corp. 2003, 2014 iii

Page 4: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Capítulo 7. Instalando o Real-time Monitoring em um Oracle WebLogic ApplicationServer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43Instalando e Implementando o Real-time Monitoring em um Oracle WebLogic Application Server . . . . . . 43

Revisando e Verificando Requisitos para o Oracle WebLogic . . . . . . . . . . . . . . . . . . 43Modificando as Configurações da Java Virtual Machine . . . . . . . . . . . . . . . . . . . 44Criando e Configurando a Conexão de Metadados . . . . . . . . . . . . . . . . . . . . . 49Definindo Origens de Dados no WebLogic . . . . . . . . . . . . . . . . . . . . . . . . 51Implementando o Real-time Monitoring em um Oracle WebLogic Application Server . . . . . . . . . . 52

Testando o Real-time Monitoring Após a Instalação no Oracle WebLogic Application Server . . . . . . . . 53Carregando Amostras do Real-time Monitoring no Oracle WebLogic Application Server . . . . . . . . . 53Importando Metadados de Amostra no Real-time Monitoring . . . . . . . . . . . . . . . . . 54

Desinstalando o Real-time Monitoring do Oracle WebLogic Application Server . . . . . . . . . . . . . 54Fazendo Backup dos Metadados do Real-time Monitoring . . . . . . . . . . . . . . . . . . . 54Desinstalando do Oracle WebLogic Application Server . . . . . . . . . . . . . . . . . . . . 55Executando o Programa de Desinstalação do Real-time Monitoring . . . . . . . . . . . . . . . . 55Desinstalando o Banco de Dados . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

Capítulo 8. Instalando o Real-time Monitoring em um JBoss Application Server . . . . 57Instalando e Implementando o Real-time Monitoring em um JBoss Application Server . . . . . . . . . . 57

Revisando e Verificando os Requisitos para Real-time Monitoring em um JBoss Application Server . . . . . 57Modificando as Configurações da Java Virtual Machine . . . . . . . . . . . . . . . . . . . 58Criando e Configurando a Conexão de Metadados . . . . . . . . . . . . . . . . . . . . . 64Definindo Origens de Dados no JBoss . . . . . . . . . . . . . . . . . . . . . . . . . 66Implementando o Real-time Monitoring em um JBoss Application Server. . . . . . . . . . . . . . 67Considerações ao Implementar o Real-time Monitoring em um JBoss Application Server . . . . . . . . 68

Testando o Real-time Monitoring Após a Instalação no JBoss Application Server . . . . . . . . . . . . 69Carregando Amostras do Real-time Monitoring no JBoss Application Server . . . . . . . . . . . . . 69Importando Metadados de Amostra no Real-time Monitoring . . . . . . . . . . . . . . . . . 70

Desinstalando o Real-time Monitoring do JBoss Application Server . . . . . . . . . . . . . . . . . 70Fazendo Backup dos Metadados do Real-time Monitoring . . . . . . . . . . . . . . . . . . . 70Desinstalando do JBoss Application Server . . . . . . . . . . . . . . . . . . . . . . . . 71Executando o Programa de Desinstalação do Real-time Monitoring . . . . . . . . . . . . . . . . 71Desinstalando o Banco de Dados . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

Capítulo 9. Instalando, Configurando e Desinstalando Arquivos do Servidor da WebReal-time Monitoring. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73Instalando Arquivos do Servidor da Web Real-time Monitoring . . . . . . . . . . . . . . . . . . 73Configurando um Apache ou IBM HTTP Server para tratar o conteúdo estático . . . . . . . . . . . . 74Configurando o Microsoft Internet Information Server para trabalhar com o Real-time Monitoring instalado emum WebSphere Application Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . 76Configurando o Microsoft Internet Information Server para trabalhar com o Real-time Monitoring instalado emum WebLogic Application Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77Configurando o Microsoft Internet Information Server para trabalhar com o Real-time Monitoring instalado emum JBoss Application Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79Verificando a Configuração para o Conteúdo Estático e Dinâmico . . . . . . . . . . . . . . . . . 80Configurando a Conexão Única para o eTrust SiteMinder . . . . . . . . . . . . . . . . . . . . 80Desinstalando o Real-time Monitoring do Servidor da Web . . . . . . . . . . . . . . . . . . . 81

Capítulo 10. Configurando o Real-time Monitoring Após a Instalação . . . . . . . . . 83Configurando o Real-time Monitoring no IBM Cognos Real-time Monitoring Workbench . . . . . . . . . 83Definindo as Configurações do protocolo LDAP . . . . . . . . . . . . . . . . . . . . . . . 84

Considerações na Conectividade do protocolo LDAP . . . . . . . . . . . . . . . . . . . . 85

Capítulo 11. Solucionando Problemas de sua Instalação . . . . . . . . . . . . . . 87Resolvendo um Problema. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

Procurando em Bases de Conhecimento . . . . . . . . . . . . . . . . . . . . . . . . . 89Obtendo Correções . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89Entrando em Contato com o Suporte IBM . . . . . . . . . . . . . . . . . . . . . . . . 90Trocando Informações com a IBM . . . . . . . . . . . . . . . . . . . . . . . . . . . 91

iv IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 5: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Subscrevendo para Atualizações de Suporte . . . . . . . . . . . . . . . . . . . . . . . 92Iniciando no Modo de Segurança . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93Mensagem de Erro Keystore Não Localizado Aparece . . . . . . . . . . . . . . . . . . . . . 94Mensagem de Erro Não é Possível Conectar-se ao Banco de Dados Aparece no Console do Servidor de Aplicativos 94Os menus e controles do IBM Cognos Real-time Monitoring Dashboard aparecem truncados ou não funcionamcorretamente . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94Domínio de Rede Ausente na Imagem da Máquina Virtual do Real-time Monitoring . . . . . . . . . . . 94Comando Inválido: WebSpherePluginConfig . . . . . . . . . . . . . . . . . . . . . . . . 95Erro do Servidor de Aplicativos: Propriedade Não Disponível . . . . . . . . . . . . . . . . . . 95Mensagem de Erro de Processamento Aparece. . . . . . . . . . . . . . . . . . . . . . . . 95Mensagem de Erro de Segurança Aparece . . . . . . . . . . . . . . . . . . . . . . . . . 95

Capítulo 12. Configurando o Sistema de Mensagens Java. . . . . . . . . . . . . . 97

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

Apêndice B. Ajuste de Mapas Geográficos . . . . . . . . . . . . . . . . . . . . 101Melhorando a Exatidão do Geocodificador . . . . . . . . . . . . . . . . . . . . . . . . 101Estendendo o Suporte ao Mapa Geográfico . . . . . . . . . . . . . . . . . . . . . . . . 102

Interface IGeocoder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102Classe GeoPoint . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104

Avisos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107

Índice v

Page 6: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

vi IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 7: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Introdução

Este documento deve ser usado com o IBM® Cognos Real-time Monitoring, umasolução de inteligência de negócios operacional que entrega autoatendimento,painéis interativos; consulta ad hoc, relatório e análise; gerenciamento integrado detarefa e exceção para suportar a agenda de monitoramento contínua de suaorganização.

Este guia contém instruções para instalar, fazer atualização e configurar oReal-time Monitoring.

Público

Para usar este guia, você deve estar familiarizado comv conceitos de relatóriov conceitos de scorecardv conceitos de banco de dadosv problemas de segurançav conceitos básicos de administração do sistema operacional do Microsoft

Windows e do UNIXv o ambiente do servidor e a infraestrutura de segurança existentes em sua

organizaçãov conhecimento do trabalho dos servidores de aplicativos, servidores da Web e

provedores de diretório

Localizando Informações

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

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

Recursos de Acessibilidade

Os recursos de acessibilidade ajudam os usuários que possuem uma deficiênciafísica, como mobilidade reduzida ou visão limitada, a usarem os produtos detecnologia da informação. Esse produto possui recursos de acessibilidade quandoestá integrado com o IBM Cognos Workspace. Esse produto suporta navegação porteclado e suporte de leitor de tela quando as métricas são visualizadas no CognosWorkspace. Para obter informações sobre os recursos de acessibilidade quando oproduto é usado com o IBM Cognos Workspace, consulte a seção de acessibilidadeno Guia do Usuário do IBM Cognos Real-time Monitoring Dashboard. Se não estiverintegrado com o IBM Cognos Workspace, somente o programa de instalação

© Copyright IBM Corp. 2003, 2014 vii

Page 8: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

possuirá recursos de acessibilidade. Para obter informações sobre os recursos deacessibilidade do programa de instalação, consulte Apêndice A, “Recursos deAcessibilidade”, na página 99.

A documentação HTML do IBM Cognos possui recursos de acessibilidade.Documentos PDF são complementares e, dessa forma, não incluem recursos deacessibilidade.

Instruções para Procura de Versões Futuras

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

Renúncia de Responsabilidade de Amostras

Os arquivos de amostras podem conter dados fictícios gerados manualmente oupor máquina, dados reais compilados de origens públicas ou acadêmicas, ou dadosusados com permissão do portador do copyright, para serem usados como dadosde amostra para desenvolver aplicativos de amostra. Os nomes de produtosreferidos podem ser marcas registradas de seus respectivos proprietários. A cópianão autorizada é proibida.

viii IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 9: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Capítulo 1. Como Instalar e Configurar o Aplicativo Real-timeMonitoring?

Este guia fornece instrução de como instalar e configurar o IBM Cognos Real-timeMonitoring.

É possível instalar o Real-time Monitoring em um IBM WebSphere ApplicationServer, em um Oracle WebLogic Application Server ou em um JBoss ApplicationServer, com um IBM HTTP Server, Apache HTTP Server ou Microsoft InternetInformation Server (IIS) configurado para entregar conteúdo da Web estático.

Se você já estiver usando o IBM Cognos Real-time Monitoring e desejar atualizarseu ambiente com uma versão mais recente, revise as informações no Capítulo 5,“Fazendo Atualização de uma Versão Anterior ou Reinstalando o Real-timeMonitoring”, na página 25 ao invés desta lista de verificação.1. “Revisando as Notas sobre o Release”.2. Capítulo 2, “Planejamento para Instalar o Real-time Monitoring”, na página 3.

v “Componentes Usados pelo Real-time Monitoring” na página 3.v “Arquitetura do Real-time Monitoring” na página 5.v “Requisitos de Memória” na página 6.v “Configurando Navegadores da Web” na página 9.

3. Capítulo 3, “Preparando para Instalar o Real-time Monitoring”, na página 11.v “Revisando Ambientes Suportados” na página 11.v “Verificando Requisitos do Sistema” na página 11.v “Preparando os Bancos de Dados” na página 12.v “Configurando o Failover Ativo-Passivo” na página 13.

4. Capítulo 4, “Instalando e Configurando Servidores de Aplicativos”, na página15.v Capítulo 6, “Instalando o Real-time Monitoring em um IBM WebSphere

Application Server”, na página 27.v Capítulo 7, “Instalando o Real-time Monitoring em um Oracle WebLogic

Application Server”, na página 43.v Capítulo 8, “Instalando o Real-time Monitoring em um JBoss Application

Server”, na página 57.5. Capítulo 9, “Instalando, Configurando e Desinstalando Arquivos do Servidor

da Web Real-time Monitoring”, na página 73.6. Capítulo 10, “Configurando o Real-time Monitoring Após a Instalação”, na

página 83.7. Capítulo 11, “Solucionando Problemas de sua Instalação”, na página 87.

Revisando as Notas sobre o ReleaseAntes de determinar seus requisitos e de planejar a instalação do IBM CognosReal-time Monitoring, você deve revisar as notas sobre o release.

As notas sobre o release fornecem informações sobre quais problemas foramresolvidos no release atual. Também é necessário revisar as notas sobre o releasepara problemas conhecidos e abertos e soluções alternativas associadas. Para obter

© Copyright IBM Corp. 2003, 2014 1

Page 10: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

a versão mais atual das notas sobre a liberação, acesse a Central do Cliente IBMCognos (http://www.ibm.com/software/data/cognos/customercenter).

2 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 11: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Capítulo 2. Planejamento para Instalar o Real-time Monitoring

Antes de instalar o IBM Cognos Real-time Monitoring e configurar seu servidor deaplicativos, você deve entender os requisitos básicos mínimos para software ehardware. Você deve também considerar o dimensionamento da memória.

Componentes Usados pelo Real-time MonitoringEsta seção descreve os componentes de banco de dados e servidor usados peloIBM Cognos Real-time Monitoring.

O IBM Cognos Real-time Monitoring é um aplicativo baseado na Web paramodelagem e exibição de indicadores chave de desempenho (KPIs) em tempo real.Ele fornece a funcionalidade do servidor para processar fluxos de fluxo e executara agregação e o alerta em tempo real.

O Real-time Monitoring inclui um servidor e uma ferramenta de modelagem, queé chamada de Real-time Monitoring Workbench.

O Real-time Monitoring integra-se facilmente em sua infraestrutura existenteusando recursos que estão em seu ambiente. Alguns desses recursos existentes sãonecessários, como:v Um esquema de banco de dados para os metadados, dados operacionais e dados

de codificação geográfica.v Um servidor de aplicativos.v Um servidor da Web.

Outros recursos são opcionais, tal como um provedor de segurança paraautenticação.

Componentes do ServidorO IBM Cognos Real-time Monitoring possui componentes de camada da Web ecomponentes de camada do aplicativo.

Componentes de Camada da Web

As comunicações na Web no Real-time Monitoring são através do servidor da Web.O conteúdo estático, como bibliotecas JavaTMScript, arquivo HTML e imagens, poderesidir em um servidor da web instalado no mesmo computador no qual oservidor da web reside ou em um servidor da web instalado em um computadorseparado. Para acessar o conteúdo estático, você deve configurar um servidor daWeb. Para a integração do Real-time Monitoring com o IBM Cognos Workspace, oconteúdo estático do Real-time Monitoring deverá residir no mesmo servidor daweb que hospeda o IBM Cognos Business Intelligence.

Componentes de Camada do Aplicativo

A camada de aplicativos do Real-time Monitoring contém os servidores doReal-time Monitoring. É necessário um servidor de aplicativos para instalar oReal-time Monitoring Server. O Real-time Monitoring Server executa os pedidos

© Copyright IBM Corp. 2003, 2014 3

Page 12: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

vindos da máquina do cliente encaminhados pelo servidor da Web. A camada doaplicativo é dividida logicamente nos seguintes componentes.v IBM Cognos Real-time Monitoring Workbench

O Real-time Monitoring Workbench é a ferramenta de modelagem para criar egerenciar metadados relacionados aos negócios para usar na análise e nosindicadores-chave de desempenho do Real-time Monitoring (KPIs). Osmetadados são armazenados em um armazenamento persistente do banco dedados e acessados pelo Real-time Monitoring Query Engine para análise e peloReal-time Monitoring Dashboard para visualização.

v IBM Cognos Real-time Monitoring DashboardO Real-time Monitoring Dashboard é uma ferramenta de visualização quefornece uma visualização unificada dos KPIs em tempo real e do visualizador dealerta.Os objetos de painel, que são montados em um painel, sondam as visualizaçõese os cubos em intervalos planejados para se atualizarem.

v IBM Cognos Real-time Monitoring Query EngineO Real-time Monitoring Query Engine é um armazenamento de dados detecnologia de fluxo que é instrumental na execução e no cálculo das consultasem tempo real conforme novos dados são adquiridos pela estrutura do agentedo Real-time Monitoring. Os dados são calculados incrementalmente conformeos dados fluem através do mecanismo. Isto é diferente de um banco de dadostradicional no qual os cálculos são executados on-demand. O modelo doReal-time Monitoring é inscrito da seguinte maneira:fluxos de dados > visualizaçõesvisualizações > visualizaçõesvisualizações + tabelas de consulta > visualizaçõestabelas de consulta > dimensõesvisualizações + dimensões > cubosOs dados são armazenados na memória e atualizados incrementalmente àmedida que mais dados são adquiridos da estrutura do agente e enviados emfluxo para os objetos do Real-time Monitoring.

Gerenciando Dados do Aplicativo - Componentes do Bancode Dados

O aplicativo IBM Cognos Real-time Monitoring usa dados armazenados emdiversos bancos de dados.

Eles incluem o seguinte:v Esquema de metadados (necessário)

Definições do Real-time Monitoring Model, tais como definições de agentes,fluxos de dados, tabelas de consulta, visualizações, cubos, objetos de painel,painéis e alertas são armazenados neste esquema.

v Esquema operacional (necessário)A funcionalidade de busca e armazenamento do Real-time Monitoring usa esteesquema para armazenar os dados buscados a partir das tabelas de consulta.

v Esquema Geográfico (necessário)O Real-time Monitoring usa este esquema para armazenar em cache ascoordenadas de codificação geográfica, como as coordenadas de latitude e

4 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 13: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

longitude para regiões e para fornecer sugestões e modificações para resolverabreviações de locais geográficos, como AZ, que pode ser interpretado comoArizona ou Azerbaijão.

v Esquema de Dados (opcional)Os dados usados para preencher os indicadores-chave de desempenho (KPIs)são geralmente armazenados em um ou mais desses bancos de dados existentes.

Componentes Opcionais do ServidorO IBM Cognos Real-time Monitoring também pode ser configurado com oscomponentes do servidor opcionais, incluindo um provedor de segurança que vocêpode usar para autenticação do usuário.

Provedor de Segurança para Autenticação

Por padrão, o Real-time Monitoring suporta autenticação de banco de dadosinterna, na qual as informações sobre usuários, funções e mapeamento dafunção-usuário são armazenadas no esquema de metadados. Opcionalmente, elepode ser configurado para conectar-se aos provedores de diretório como protocoloLDAP, Active Directory Service (ADS) e IBM Tivoli Directory Services. O Real-timeMonitoring também pode ser configurado para conectar-se a um servidor do IBMCognos Business Intelligence 10.1 ou 8.4.

Arquitetura do Real-time MonitoringAntes de instalar o IBM Cognos Real-time Monitoring, familiarize-se com aarquitetura do sistema.

É necessário configurar os navegadores da Web para trabalharem com o Real-timeMonitoring. Você deve executar o instalador no servidor de aplicativos e, se esteestiver instalado em um computador separado, no servidor da Web para ativá-lopara funcionar com o servidor de aplicativos. O Real-time Monitoring acessa dadosatravés de um servidor de banco de dados, como DB2, SQL Server, Oracle, MySQLou Postgres. Opcionalmente, você pode configurar o Real-time Monitoring paratrabalhar com um provedor de diretório de autenticação. O diagrama a seguirmostra a arquitetura do Real-time Monitoring:

Capítulo 2. Planejamento para Instalar o Real-time Monitoring 5

Page 14: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Requisitos de MemóriaÉ possível estimar o custo básico do dimensionamento da memória consultando asorigens de dados e o tipo de análise que você está planejando.

O dimensionamento da memória pode ser um processo complexo porque hámúltiplas variáveis a considerar que levam a correlações mais complexas. Osprincipais fatores que contribuem com o uso da memória são os seguintes:v Frequência de pedidov Tamanho de dadosv Complexidade dos dadosv Estruturas usadas

A análise no IBM Cognos Real-time Monitoring depende do uso de visualizações ecubos que você constrói para armazenar e analisar dados e dos objetos do painelque você cria para monitorar dados.

Navegadores da Web

Servidor de aplicativos

Servidor web

IBM Cognos Real-time Monitoringconteúdo estático (JS, imagens, HTML)

Diretório de autenticaçãoprovedor

IBM Cognos Real-timeUsuário de monitoramento,função e mapeamento de

função do usuário

IBM Cognos Real-time Monitoringrecurso de aplicativo corporativo

Servidor de banco de dados

IBM Cognos Real-time Monitoring esquemas do banco de dados para

metadados,dado operacional e geo-dados

Figura 1. Arquitetura do Real-time Monitoring

6 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 15: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Custos de MemóriaHá duas maneiras de trazer dados de origens de dados externas para o IBMCognos Real-time Monitoring: definindo fluxos de dados e criando tabelas deconsulta.

As seções a seguir descrevem os objetos e os custos de memória associados aosvários objetos no Real-time Monitoring.

Fluxo de dadosPara processar os fluxos de dados, a memória é alocada quando liberada após osdados serem processados.

Como eles usam memória conforme os dados são processados, os fluxos de dadosnão possuem um requisito de memória fixa. O consumo de memória flutua combase na quantidade de dados e na frequência de atualização dos dados.

Custo

O custo da memória para os fluxos de dados é igual ao tamanho dos dados brutosvindos para o sistema como resultado dos dados serem carregados durante umdeterminado intervalo de tempo. A memória, que é necessária para processar ofluxo de dados em tempo real ou próximo do real, é alocada e, em seguida,liberada.

Tabelas de consultaAs tabelas de consulta aumentam o requisito de memória se a pré-busca é usada.A pré-busca aumenta o desempenho, pois os dados da tabela de consulta sãoarmazenados em cache na memória, entretanto, o desempenho ocorre às custas damemória.

Embora outros modos de consulta que resultam em requisitos de memóriamenores estejam disponíveis, você deve considerar o custo dos requisitos dememória menores versus o desempenho.

Custo

O custo da memória para as tabelas de consulta é igual ao custo do tamanho dosdados brutos trazidos para o sistema como dado da tabela de consulta. A memóriapara os cubos e as visualizações para análise é incluída no custo total após você teracesso aos dados (que poderiam estar sendo transmitidos no caso dos fluxos dedados ou ser mantidos na memória no caso dos dados pré-busca).

VisualizaçõesAs visualizações podem consumir pequenas ou grandes quantidades de memória,dependendo de quantas linhas de dados devem ser mantidas.

O Real-time Monitoring possui a seguinte classificação de visualizações:v Visualizações stateless, que não mantêm dados agregados.

As visualizações stateless apenas mantêm o conjunto de linhas mais recente namemória, a menos que “Manter na visualização” esteja configurado, o que podeaumentar o número de conjuntos de linhas armazenados. Um conjunto de linhaspode conter mais de uma linha de dados.

v As visualizações stateful, armazenam dados agregados e, frequentemente, dadosarmazenados em um horário ou uma janela enquadrada no evento.

Capítulo 2. Planejamento para Instalar o Real-time Monitoring 7

Page 16: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

As visualizações stateful armazenam as informações agregadas e algumas linhasde histórico que podem ser necessárias para recalcular agregações. Ao reduzir onúmero de grupos exclusivos e espaços de tempo, é possível reduzir aquantidade de memória necessária para armazenar os dados.

Custo

A análise de custo para as visualizações pode ser de alguma forma difícil deexecutar diretamente se você não conhecer as visualizações que precisarão sercriadas. A área de cobertura final na memória depende de como os dados sãoagrupados e de quais atributos são usados. Quando mais granulares seus atributossão, mais dados são necessários (que ainda são menores do que os dados brutos,pois são agregados com base no agrupamento definido) e, portanto, mais memóriaé necessária. Você precisará analisar os dados brutos, suas características e comoeles serão usados para obter uma estimativa.

CubosDependendo da granularidade de suas dimensões, os cubos podem requerer umagrande quantidade de memória.

Por exemplo, um cubo com uma dimensão de tempo ou um espaço de tempo quepossui granularidade de segundos requer mais memória que um comgranularidade de minutos. Para reduzir a área de cobertura da memória, você devereduzir a quantidade de dados ou a granularidade. A redução na memória quepode ser atingida variará com base nas necessidades atuais específicas, entretanto,você também deve considerar as necessidades futuras quando configurar amemória para os cubos.

Custo

A análise de custo da memória para cubos é semelhante às visualizações stateful. Avisualização de treliça base que contém todos os dados para um determinado cubopode se tornar muito grande, dependendo da granularidade dos atributosdimensionais. Execute alguma amostragem, se possível, dos dados de fato(transacionais) para ver quais combinações de agrupamento exclusivas estãopresentes nos dados.

Janelas (frequência)O IBM Cognos Real-time Monitoring incorpora o conceito de janelas ao referir-seaos dados de fluxo.

As janelas podem ser definidas nos termos do número de eventos no tempo (porexemplo, uma janela de sete dias ou uma janela de uma hora). Para executar aanálise operacional ou o monitoramento, você deve saber o intervalo de tempo desua análise.

O uso das janelas de tempo aumenta a memória necessária, pois linhas individuaissão mantidas pelo IBM Cognos Real-time Monitoring. A área de cobertura damemória aumenta com base no tamanho e na granularidade da janela. (Agranularidade se aplica apenas aos espaços de tempo.) As janelas são criadas comoparte do processo de criação para visualizações ou cubos. Ao reduzir o número degrupos de janela exclusivos, por exemplo, ao truncar o registro de data e hora parao minuto, é possível reduzir o número de grupos que precisam ser armazenadosna memória. Um algoritmo de otimização foi implementado para que a agregaçãoocorra dentro de um grupo de tempo, em vez de armazenar "linhas individuais"como descrito nessa seção.

8 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 17: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Custo

É possível aproximar o custo da memória para janelas consultando o tamanho e agranularidade da janela. O custo da memória para as janelas baseadas em eventosé mais fácil de calcular porque você saberá exatamente quantos eventos serãomantidos na memória e o número de grupos calculados a partir de visualizações ecubos. As janelas baseadas em tempo são calculadas com base no número degrupos exclusivos nessa janela e no tamanho da janela. Outro fator é o tipo dejanela: deslizante ou roláveis. Uma janela deslizante pode ter um custo fixoaproximado após ela estar cheia. O custo da memória para as janelas roláveiscresce e reduz conforme a janela rola e é preenchida novamente.

Considerações sobre Memória Adicionais para Real-timeMonitoring

Os custos com memória precisam ser ajustados para considerar o trabalhoexecutado pelos usuários do Real-time Monitoring.

A maioria dos custos com memória do Real-time Monitoring são custos fixos,porque os conjuntos de resultados e os dados são mantidos na memória. Emboraisto possa ser reduzido, ainda é necessário manter alguns dados na memória.Alguns custos da memória são temporários, porque o uso da memória podeaumentar ou diminuir conforme necessário para processar dados com base nacarga de trabalho.

Por exemplo, os usuários podem criar painéis ou executar a análise ad hoc queresulta em consultas que são executadas no servidor. A estratégia do servidor éarmazenar em cache estas consultas, mantendo-as na memória ou fazendo com queelas expirem após um determinado período de tempo.

Uma boa maneira de estimar o dimensionamento é estimar inicialmente seuscustos para a memória fixa. Em seguida, inclua os custos relacionados aos painéise a análise ad hoc nos cubos subjacentes. Este custo de memória varia com base nonúmero de usuários simultâneos e suas atividades. Além disso, o Real-timeMonitoring faz uso da coleção de lixo da memória, que requer memória adicionalpara trabalhar adequadamente. A memória ideal necessária para o processo JavaTM

para uso ideal é aproximadamente duas vezes a memória necessária paraarmazenar os dados.

Configurando Navegadores da WebO IBM Cognos Real-time Monitoring Workbench e o IBM Cognos Real-timeMonitoring Dashboard podem ser usados nos navegadores da Web InternetExplorer. Além disso, o Firefox é suportado quando os objetos do Real-timeMonitoring são exibidos no IBM Cognos Workspace. Ambos o Cognos Real-timeMonitoring Workbench e o Real-time Monitoring Dashboard usam configuraçõesde navegador semelhantes.

A tabela a seguir mostra as configurações do navegador que devem ser ativadas.

Capítulo 2. Planejamento para Instalar o Real-time Monitoring 9

Page 18: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Tabela 1. Configurações do Navegador para o IBM Cognos Real-time MonitoringNavegador Configurando

Internet Explorerv Permitir Cookies

v Permitir Pop-ups

v Ativar Script

v Permitir META REFRESH

v Executar Controles e Plug-ins ActiveX

v Fazer Script dos Controladores ActiveX marcados como seguros para script

v Comportamentos Binários e de Script

v Permitir acesso à área de transferência programática

v Permitir janelas iniciadas pelo script sem restrições de tamanho ou posição

O desempenho é otimizado quando o Real-time Monitoring Server está na zona da"Intranet Local" nas configurações de segurança.

Firefox (suportado quando os objetos doReal-time Monitoring são exibidos no IBMCognos Workspace)

v Permitir Cookies

v Ativar Java™

v Ativar JavaScript

v Carregar Imagens

O Real-time Monitoring requer o plug-in do navegador Adobe Flash Player paraexibir as interfaces com o usuário do aplicativo Real-time Monitoring.

O Real-time Monitoring usa os seguintes cookies para armazenar informaçõessobre o usuário.

Tabela 2. Cookies Usados pelo IBM Cognos Real-time Monitoring

Cookie Tipo Propósito

cam_passport

sessionid

Sessão Temporária Contém um identificador de sessão do usuário exclusivo que éválido pela duração da sessão do navegador. Dependendo daconfiguração, pode haver mais de um cookie cam_passport ousessionid. Cada cookie está localizado em um diretório diferente.

ObiOpenURL Sessão Temporária Contém o caminho das caixas de diálogo necessárias para váriasações do usuário.

dbUser Persistente Contém o nome do usuário no painel nas sessões do navegador,quando a caixa de seleção Lembrar meu nome de usuário nestecomputador é configurada na página de login do painel.

wbUser Persistente Contém o nome do usuário em um ambiente de trabalho nassessões do navegador, quando a caixa de seleção Lembrar meunome de usuário neste computador é configurada na página delogin do ambiente de trabalho.

cognos_sso Sessão Temporária Contém um identificador de sessão do usuário exclusivo paraconexão única com BI, válido pela duração da sessão do navegador.

loginErrorKey Sessão Temporária Contém uma chave de mensagem para qualquer erro relacionado aologin.

Após fazer atualização ou instalar o novo software, reinicie o navegador da Web eavise aos usuários para limparem seus caches do navegador. Por exemplo, paralimpar o cache do navegador no Internet Explorer, no menu Ferramentas, cliqueem Opções de Internet e, em seguida, clique em Excluir.

10 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 19: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Capítulo 3. Preparando para Instalar o Real-time Monitoring

Antes de instalar o IBM Cognos Real-time Monitoring em um servidor deaplicativos, tal como o IBM WebSphere, Oracle WebLogic, ou JBoss, existe umtrabalho de preparação a ser concluído.

Você deve executar as seguintes tarefas:1. Revise os ambientes suportados .2. Verifique os requisitos do sistema .3. Prepare os bancos de dados .4. Considere os clusters do servidor de aplicativos e o failover ativo-passivo .

Revisando Ambientes SuportadosPara garantir que o IBM Cognos Real-time Monitoring funcione corretamente,aplique todas as correções mínimas requeridas do sistema operacional e use apenasversões de outro software que sejam suportadas para o Real-time Monitoring.

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

Verificando Requisitos do SistemaVerifique se possui os requisitos do sistema para instalar e executar oscomponentes do IBM Cognos Real-time Monitoring em um computador.

Use as seguintes tabelas para verificar os requisitos mínimos de hardware esoftware. Recursos adicionais podem ser necessários para ambientes distribuídosou de produção. O Real-time Monitoring é um aplicativo com uso intensivo derede com dados que atualizam rapidamente que requer uma boa conexão de rede eCPU para executar de maneira eficiente no cliente.

Requisitos de Hardware

Tabela 3. Requisitos de Hardware do Real-time Monitoring

Requisito Especificação

Sistema Operacional Microsoft Windows Server de 64 bits

UNIX Server de 64 bits

Linux Server de 64 bits

Linux no IBM System z Server de 64 bits

RAM Mínimo: 16 GB

Especificações do Sistema Operacional Limite do descritor de arquivo configurado para 2048 nos sistemasoperacionais UNIX e Linux.

© Copyright IBM Corp. 2003, 2014 11

Page 20: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Tabela 3. Requisitos de Hardware do Real-time Monitoring (continuação)

Requisito Especificação

Espaço em Disco Um mínimo de 20 GB de espaço livre é necessário após ainstalação do software. Preferivelmente, isto deve estar em umaconfiguração RAID 5.

Para todos os bancos de dados, o tamanho aumentará no decorrerdo tempo. Assegure que você possua espaço em disco suficientepara requisitos futuros.

Requisitos de Software

Tabela 4. Requisitos de Software do Real-time Monitoring

Requisito Especificação

Servidor da Web Um servidor da Web deve ser instalado e iniciado. As opçõesincluem o Apache HTTP Server, IBM HTTP Server ou Microsoft IISServer.

Java Runtime Environment (JRE) Uma versão IBM do JRE é instalada com o IBM WebSphereApplication Server.

Para WebLogic e JBoss, o JRE Java SE HotSpot é recomendado. OReal-time Monitoring requer o Java 5 ou JRE e JDK posteriores.

Use o JRE que é instalado com o servidor de aplicativos que estáem uso, se essa versão do JRE for suportada no Real-timeMonitoring.

Banco de Dados Você deve ter um dos seguintes bancos de dados disponíveis paraarmazenar dados do IBM Cognos em um ambiente de produção:

v IBM DB2

v Oracle

v Microsoft SQL Server

v MySQL

v PostgreSQL

A conectividade TCP/IP é necessária para todos os tipos de bancode dados.

Servidor de Aplicativos IBM WebSphere, Oracle WebLogic, ou JBoss

Preparando os Bancos de DadosO IBM Cognos Real-time Monitoring usa vários bancos de dados para armazenarinformações, tais como metadados sobre objetos que foram criados no sistema. Osbancos de dados também podem ser usados como origens de dados.

Obtenha drivers Java Database Connectivity (JDBC) antes de configurar novosbancos de dados para uso com o Real-time Monitoring. É recomendável o uso dosdrivers JDBC adequados fornecidos pelo fornecedor do servidor de aplicativos ouo fornecedor de banco de dados.

Crie bancos de dados dedicados para metadados, dados operacionais e dadosgeográficos. Além disso, crie uma conta do usuário dedicada para estes bancos dedados, na qual o usuário tem a capacidade de criar tabelas e tabelas de consultas.

12 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 21: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Configurando o Failover Ativo-PassivoO IBM Cognos Real-time Monitoring pode ser configurado para executar com ofailover ativo-passivo para que apenas uma instância do Real-time Monitoringesteja em execução por vez. Se a instância principal falhar, a instância secundáriapoderá ser iniciada.

Esta configuração envolve a configuração de dois nós, de maneira idêntica, masapenas iniciando um deles. Os dois nós devem ter a mesma configuração para obanco de dados de metadados e todos os outros bancos de dados usando JavaNaming and Directory Interface (JNDI). O ponto de verificação e o diretório do logde recuperação devem estar em um local que ambos os nós do servidor deaplicativos possam atingir da mesma maneira. Quando o servidor principal ficaoff-line, o servidor secundário é colocado novamente on-line usando o mesmobanco de dados de metadados e recuperando a partir do mesmo ponto deverificação e dos mesmos arquivos de log de recuperação.

O failover do Real-time Monitoring é implementado no nível do banco de dados eno nível do compartilhamento de arquivo e não é dependente de nenhumasemântica de cluster.

O failover ativo-passivo pode ser realizado seguindo as etapas fornecidas abaixodurante a implementação.

Procedimento1. Configure uma segunda instância do Real-time Monitoring em um computador

secundário. Esta é a instância passiva.2. Configure os metadados do Real-time Monitoring para que eles estejam

acessíveis a partir das instâncias ativas e passivas do Real-time Monitoring.3. Configure um servidor de arquivos compartilhados para pontos de verificação

e logs de recuperação.4. Configure o acesso da URL para usuários do Real-time Monitoring através de

um balanceador de carga ou proxy que possa detectar o estado do servidor deaplicativos em uma base contínua.Se a instância ativa do Real-time Monitoring falhar, a instância passiva poderáser ativada para atender as solicitações do Real-time Monitoring. O balanceadorde carga configurado direcionará o tráfego para a instância atualmente emexecução. No caso de um failover, os usuários deverão efetuar login no sistemanovamente.

Capítulo 3. Preparando para Instalar o Real-time Monitoring 13

Page 22: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

14 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 23: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Capítulo 4. Instalando e Configurando Servidores deAplicativos

É necessário executar o instalador no servidor usado para o ambiente do servidorde aplicativos e, então, preparar configurações de log e configurar as propriedadesde sistema.

Se seu ambiente do servidor da Web também está localizado no mesmocomputador que o servidor de aplicativos, instale os arquivos do servidor da Web.Se o servidor da Web está localizado em um computador diferente, cancele aseleção dos arquivos do servidor da Web e execute o instalador separadamente noservidor da Web.

Esta seção supõe que você adquiriu o CD do produto ou que você transferiu pordownload o pacote de instalação adequado e que possui direitos administrativosno servidor no qual está instalando o IBM Cognos Real-time Monitoring.

Instalando os Componentes do Real-time Monitoring ApplicationServer

Para instalar os componentes do servidor do IBM Cognos Real-time Monitoring,execute o assistente de instalação a partir do pacote de instalação ou do CD doproduto.

Para uma instalação completa, você deverá instalar os componentes em seuservidor e, em seguida, configurá-los para trabalharem em seu ambiente.Geralmente, o instalador do IBM Cognos Real-time Monitoring é executado nomodo interativo. Isso significa que em uma interface gráfica com o usuário (GUI) oinstalador o avisa para fornecer informações e deverá ser executado a partir deuma estação de trabalho X Window System, um terminal X ou um PC ou outrosistema com o software do servidor X instalado. Para executar uma instalação emmodo interativo, o console conectado ao seu computador deve suportar umainterface gráfica com o usuário baseada em Java.

Para sistemas em execução em um ambiente Linux no IBM System z é umrequisito (requisito de software opcional) que você possua um software WindowsX capaz de renderizar uma interface gráfica com o usuário (dessa forma, vocêobtém as bibliotecas Motif necessárias). Você deve ativar o host remoto paradirecionar a saída para a exibição local. Também é necessário configurar a variávelde ambiente DISPLAY. Por exemplo, digite exportarDISPLAY=host_name:display_number.

Procedimento1. Faça um dos seguintes com base em seu ambiente:

v No sistema operacional Microsoft Windows, no diretório win64 do pacotetransferido por download, dê um clique duplo no arquivo issetup.exe e sigaas instruções do assistente de instalação.

v No sistema operacional UNIX ou Linux, no diretório adequado ao seusistema operacional, digite ./issetup e siga as instruções do assistente deinstalação.

© Copyright IBM Corp. 2003, 2014 15

Page 24: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

2. Na página Local da Instalação, especifique o local do IBM Cognos e clique emAvançar.Por exemplo, o padrão em um servidor que está executando o sistemaoperacional Microsoft Windows é C:\Program Files\ibm\cognos\c10_64.Se você não usar o diretório de instalação padrão, use um nome de diretórioque contenha apenas caracteres ASCII. Alguns servidores da Web não suportamcaracteres não ASCII nos nomes de diretório.

3. Na página Seleção de Componente, escolha entre instalar o aplicativo e osarquivos do servidor da Web, ou apenas os arquivos do servidor de aplicativos.O padrão é instalar ambos os conjuntos de arquivos no servidor de aplicativos.v Seo servidor de aplicativos e o servidor da Web estiverem fisicamente no

mesmo computador, clique em Avançar.v Se o servidor da Web residir em um computador diferente do servidor de

aplicativos, expanda o IBM Cognos Real-time Monitoring, cancele a seleçãodos Arquivos do Real-time Monitoring Web Server e clique em Avançar.

4. Conclua as etapas no assistente de instalação e clique em Concluir.

Resultados

Agora você está pronto para configurar os parâmetros iniciais de inicialização. Paraobter mais informações, consulte “Configurando os Parâmetros Iniciais deInicialização”.

Configurando os Parâmetros Iniciais de InicializaçãoConfigure o nível de criação de log para ativar a depuração.

A configuração preferencial é ativar a criação de log de nível inferior que registrainformações sobre depuração básica para o Despacho DDL, que registrainformações quando solicitações são feitas para salvar objetos. Quando estaconfiguração é ativada, se uma anomalia ocorrer, tal como um travamento dosistema, o arquivo de log conterá as definições que foram salvas. Isto permiterecriar os metadados mesmo no caso de um problema.

A criação de log das informações sobre depuração também pode ajudar a equipede suporte do IBM Cognos a depurar seu sistema no caso em que ela é chamadapara suportar sua instalação do IBM Cognos Real-time Monitoring. Por padrão, acriação de log é ativada.

Nota: Todos os espaços nos nomes da propriedade devem incluir um caractere debarra invertida (\) como escape. Para todos os sistemas operacionais, incluindo osistema operacional Microsoft Windows, use barras nos nomes do caminho em vezde barras invertidas, para eliminar a necessidade em potencial de incluir escape.Por exemplo: Additional\ Log4j\ Properties=C:/Program Files/ibm/cognos/c10_64/realtime/configuration/log4j.properties.

Procedimento1. Para assegurar que a criação de log esteja ativada, abra o arquivo

log4j.properties, que está localizado no diretório c10_location/realtime/configuration, e assegure que a seguinte entrada seja feita:com.cognos.obi.metadata.DDLDispatch=com.cognos.obi.settings.DbgLow

16 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 25: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

2. Após visualizar o arquivo log4j.properties, edite o arquivo realtime.properties,também localizado no diretório c10_location/realtime/configuration, paraassegurar que o local do arquivo log4j.properties seja registrado precisamentelá.Localize a entrada a seguir e assegure que ela não tenha a linha comentada:Additional\ Log4j\ Properties=<path>

em que <path> é o caminho absoluto do arquivo log4j.properties que controlaos anexadores, a formatação e os níveis para o IBM Cognos Real-timeMonitoring.Por exemplo, em um servidor que está executando o sistema operacionalMicrosoft Windows, insira Additional\ Log4j\ Properties=c:/ProgramFiles/ibm/cognos/c10_64/realtime/configuration/log4j.properties

Por exemplo, em um servidor que está executando o sistema operacional Linux,insira Additional\ Log4j\ Properties=/opt/ibm/cognos/c10_64/realtime/configuration/log4j.properties

Para obter instruções detalhadas sobre como editar o arquivorealtime.properties e configurar os níveis de criação de log bem como outraspropriedades de inicialização, consulte “Configurando Propriedades de SistemaDurante a Inicialização” na página 18.

3. Para configurar o caminho para onde o arquivo de log deve ser gravado,assegure que a seguinte entrada não tenha a linha comentada e tenha umcaminho válido.Logging\ Directory=<path>

Em que <path> é o caminho absoluto do diretório no qual você deseja que osarquivos de log sejam gravados.Por exemplo, em um servidor que está executando o sistema operacionalMicrosoft Windows, insira Logging\ Directory=c:/ProgramFiles/ibm/cognos/c10_64/realtime/logs

Por exemplo, em um servidor que está executando o sistema operacional Linux,insira Logging\ Directory=/opt/ibm/cognos/c10_64/realtime/logs

4. Para configurar o caminho para onde o arquivo de log de recuperação deve sergravado, assegure que a seguinte entrada não tenha a linha comentada e tenhaum caminho válido.Recovery\ Log\ Directory=<path>

Em que <path> é o caminho absoluto do diretório em que você deseja que oslogs de recuperação sejam gravados.Por exemplo, em um servidor que está executando o sistema operacionalMicrosoft Windows Recovery\ Log\ Directory=c:/ProgramFiles/ibm/cognos/c10_64/realtime/checkpoints

Por exemplo em um servidor que está executando o sistema operacional LinuxInsira Recovery\ Log\ Directory=/opt/ibm/cognos/c10_64/realtime/checkpoints

5. Para usar um prefixo para os nomes dos arquivos de log, certifique-se de que aseguinte entrada não tenha a linha comentada e tenha um prefixo.Log\ File\ Prefix=<prefix>

Em que <prefix> é o prefixo que deseja prefixar nos arquivos de log. Porexemplo:Log\ File\ Prefix=rtm

Isto produzirá os logs como rtm_detailed.log, rtm.log e assim por diante.

Capítulo 4. Instalando e Configurando Servidores de Aplicativos 17

Page 26: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Resultados

O nível de criação de log e outros parâmetros de log são configurados. O nível decriação de log está em efeito até a mudança do arquivo, seja editando-omanualmente ou usando os controles da interface com o usuário para reconfiguraro nível de criação de log. Para desativar a criação de log editando o arquivo,substitua o nível de depuração com a seguinte entrada:

com.cognos.obi.metadata.DDLDispatch=com.cognos.obi.settings.Inherit

O arquivo só é lido quando o servidor é iniciado pela primeira vez. Quaisquermodificações feitas no arquivo requerem que o aplicativo seja reiniciado noservidor de aplicativos.

Configurando Propriedades de Sistema Durante a InicializaçãoAntes de instalar e implementar o IBM Cognos Real-time Monitoring em umservidor de aplicativos, você deve editar o arquivo realtime.properties queespecifica propriedades de sistema.

O arquivo está localizado no diretório c10_location/realtime/configuration. Estaspropriedades são necessárias para o Real-time Monitoring ser executadocorretamente. Apenas uma entrada de propriedade é obrigatória para a primeirainicialização do Real-time Monitoring. Todas as outras entradas de propriedade sãoopcionais. Entretanto, sem as entradas de propriedade opcionais, o Real-timeMonitoring Workbench exibe o diálogo da página da Web Primeira Configuraçãopara configurar propriedades de sistema adicionais.

O caminho para os arquivos de propriedades pode ser relativo ou absoluto. Comoele é mais preciso, o caminho absoluto é preferencial e é usado nas etapas por todoeste tópico. Entretanto, as propriedades de configuração podem funcionar bem comcaminhos relativos. Para usar caminhos relativos, você deve determinar o diretóriobase para os caminhos relativos. Usar o caminho relativo torna o aplicativo maisportável entre sistemas operacionais. Forneça um caminho, tal como/opt/ibm/cognos/c10_64/configuration/keystores/ que pode ser criado nossistemas operacionais Microsoft Windows e Linux.

As propriedades definidas no arquivo de texto substituirão as propriedades queforam configuradas usando as configurações do sistema do Real-time MonitoringWorkbench. Quando o servidor for reiniciado, as propriedades definidas noarquivo de texto substituirão as propriedades que foram definidas usando asconfigurações do sistema do Real-time Monitoring Workbench. Configure apenasaquelas propriedades no arquivo de texto que você não desejará alterarposteriormente no Real-time Monitoring Workbench.

Para obter uma descrição completa de todas as propriedades de sistema, consulte aseção Gerenciando a Administração do Sistema do Guia do Usuário do IBM CognosReal-time Monitoring Workbench.

Nota: Todos os espaços nos nomes da propriedade devem incluir um caractere debarra invertida (\) como escape. Para todos os sistemas operacionais, incluindo osistema operacional Microsoft Windows, use barras nos nomes do caminho em vezde barras invertidas, para eliminar a necessidade em potencial de incluir escape.Por exemplo: Admin\ Keystore\ Location=c:/Program Files/ibm/cognos/c10_64/realtime/configuration/keystore/admin.jks.

18 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 27: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Procedimento1. Edite o arquivo realtime.properties, que está localizado no diretório

c10_location/realtime/configuration.Este arquivo configura as propriedades de sistema durante o processo deinicialização do servidor. Para JBoss e Oracle WebLogic, você deve especificar olocal de seu arquivo de propriedades (realtime.properties) no script usado paraexecutar o servidor de aplicativos. (Para JBoss você deve editar run.bat nosistema operacional Microsoft Windows ou run.sh no sistema operacionalUNIX. Para WebLogic você deve editar startWebLogic.cmd no sistemaoperacional Microsoft Windows ou startWebLogic.sh no sistema operacionalUNIX.) Para IBM WebSphere, você deve especificar o local do arquivo depropriedades usando o Console Administrativo do IBM WebSphere.

2. Configure a propriedade obrigatória a seguir.Admin\ Keystore\ Location=<path>

Em que <path> é o caminho absoluto de admin.jks no sistema de arquivos doservidor. Este é o keystore usado para criptografar a senha do usuárioadministrador.Por exemplo, em um servidor que está executando o sistema operacionalMicrosoft Windows Admin\ Keystore\ Location=c:/ProgramFiles/ibm/cognos/c10_64/realtime/configuration/keystore/admin.jks

Por exemplo em um servidor que está executando o sistema operacional LinuxAdmin\ Keystore\ Location=(/opt/ibm/cognos/c10_64/realtime/configuration/keystore/admin.jks

3. Opcionalmente, configure as seguintes propriedades necessárias. Se elas nãoforem configuradas agora, será possível configurá-las a partir do Real-timeMonitoring Workbench após o servidor ser iniciado.v SMTP\ Host=<host_ip>

em que <host_ip> é o IP do host ou nome do servidor SMTP usado paraenviar alertas através do IBM Cognos Real-time Monitoring. Por exemplo:SMTP\ Host=localhost

v SMTP\ From\ Address=<email_address>

em que <email_address> é o endereço de e-mail que será usado para asmensagens de alerta de e-mail do IBM Cognos Real-time Monitoring dousuário que enviará e-mails através do cliente SMTP. O endereço pode ser aconta de e-mail para um usuário administrador. Por exemplo:SMTP\ From\ Address=rtmadmin@localhost

v SMTP\ User=<smtp_user>

Em que <smtp_user> é um nome de usuário aceito pelo Servidor SMTPServer se for necessária autenticação. Se a autenticação SMTP não estiverativada, essa propriedade não será usada, mas ainda assim deve serconfigurada.SMTP\ Password=<smtp_password> O fornece a senha para este usuário.

v Keystore\ Location=<path>

Em que <path> é o caminho absoluto para user_sample.jks no sistema dearquivos do servidor.Por exemplo, em um servidor que está executando o sistema operacionalMicrosoft Windows Keystore\ Location=c:/Program Files/ibm/cognos/c10_64/realtime/configuration/keystore/user_sample.jks

Por exemplo, em um servidor que está executando o sistema operacionalLinux, insira Keystore\ Location=/opt/ibm/cognos/c10_64/realtime/configuration/keystore/user_sample.jks

Capítulo 4. Instalando e Configurando Servidores de Aplicativos 19

Page 28: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

O keystore user_sample.jks é usado para criptografar as senhas de todos osusuários, exceto o usuário rtmadmin.

Importante: Se você tiver usuários que foram criados quando um keystorediferente foi configurado, não remova o keystore do local antigo. O local dokeystore usado anteriormente deve estar localizado no mesmo caminho dearquivo quando esses usuários efetuarem login novamente. Durante opróximo login, após a autenticação com o keystore antigo, a senha seráarmazenada no arquivo keystore atual.

v Keystore\ Password =<pwd>

Em que <pwd> é a senha para o keystore do usuário. Ela é 8deb5102f8. Porexemplo:Keystore\ Password=8deb5102f8

v User\ PrivateKey\ Password=<pwd>

Em que <pwd> é a senha da chave privada para a criptografia do usuário.Ela é 8deb5102f8. Por exemplo:User\ PrivateKey\ Password=8deb5102f8

Resultados

Após ter concluído a configuração das propriedades de sistema, você deveespecificar o local de suas propriedades como um argumento da JVM em cadaservidor de aplicativos. Para obter informações detalhadas sobre como referenciar oarquivo realtime.properties para seu servidor de aplicativos específico, consulte oseguinte:v “Modificando as configurações da Java virtual machine no WebSphere” na

página 29 para o IBM WebSphere Application Server.v “Modificando as Configurações da Java Virtual Machine” na página 44 para o

Oracle WebLogic Application Server.v “Modificando as Configurações da Java Virtual Machine” na página 58 para o

JBoss Application Server.

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

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

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

Nota: Fix packs não são instalações independentes. É necessário instalá-los noscomputadores que possuem componentes do IBM Cognos instalados. Instale os fixpacks que são apropriados para sua versão do produto.

20 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 29: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Nota: Fix packs não são instalações independentes. É necessário instalá-los noscomputadores que possuem componentes do IBM Cognos instalados. Instale os fixpacks que são apropriados para sua versão do produto.

Instalando Fix Packs do WindowsUse as seguintes etapas para instalar os fix packs do IBM Cognos Real-timeMonitoring nos sistemas operacionais Windows.

Antes de Iniciar

Antes de instalar o fix pack:1. Como uma etapa opcional, porém recomendada, faça backup dos seus

metadados e configuração do Real-time Monitoring:a. Inicie o IBM Cognos Real-time Monitoring Workbench usando um ID de

usuário com privilégios de administrador.b. Na guia Console Administrativo, clique no botão Configurações do

Sistema.c. No menu suspenso de configuração, selecione Configuração de Ponto de

Verificação.d. Clique no botão Executar Ponto de Verificação Agora.e. Acesse a guia Console Administrativo e clique no botão Importar/Exportar.f. Na Janela Importar/Exportar, selecione a operação Exportar Metadados para

um Arquivo JAR (Download).g. Configure as opções de exportação como Exportação Customizada e

selecione todas as opções disponíveis.h. Clique em OK. Você será solicitado a inserir um local para download do

arquivo em seu computador.

Nota: Certifique-se de que os pop-ups não estejam bloqueados.2. Pare o aplicativo Real-time Monitoring:

a. Pare e remova a implementação do Real-time Monitoring. As etapasvariarão dependendo do tipo de servidor de aplicativos:v Consulte o “Desinstalando do IBM WebSphere Application Server” na

página 41.v Consulte o “Desinstalando do Oracle WebLogic Application Server” na

página 55.v Consulte o “Desinstalando do JBoss Application Server” na página 71.

b. Pare o servidor de aplicativos. Para obter informações detalhadas, consultea documentação do servidor de aplicativos que estiver usando.

c. Pare o servidor da Web. Para obter informações detalhadas, consulte adocumentação do servidor da Web que estiver usando.

3. Como uma etapa opcional, porém recomendada, faça backup do conteúdo dodiretório de instalação do RTM original. Este diretório inclui o conteúdoestático.

4. Como uma etapa opcional, porém recomendada, faça backup dos bancos dedados operacionais, de geografia e de metadados. Para obter informaçõesdetalhadas, consulte a documentação do produto para o produto de banco dedados que está usando.

Capítulo 4. Instalando e Configurando Servidores de Aplicativos 21

Page 30: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

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

local no qual fez download e extraiu os arquivos.2. No disco ou no local de download, acesso o diretório win32 e clique duas

vezes no arquivo issetup.exe.3. Siga as instruções no assistente de instalação, instalando no mesmo local que o

seu produto Cognos Real-time Monitoring existente.O programa issetup solicita que você permita que o fix pack crie uma cópia debackup na pasta de instalação antes de copiar novos arquivos.

4. Implemente a nova versão do arquivo EAR do Real-time Monitoring(Realtime.ear, Realtime-weblogic.ear ou Realtime-jboss5.ear) de acordo comas instruções para seu servidor de aplicativos.v Consulte o “Implementando o Real-time Monitoring em um IBM WebSphere

Application Server” na página 37.v Consulte o “Implementando o Real-time Monitoring em um Oracle WebLogic

Application Server” na página 52.v Consulte o “Implementando o Real-time Monitoring em um JBoss

Application Server” na página 67.5. Certifique-se de que seu servidor da Web esteja apontando para o diretório

webcontent ou copie o diretório webcontent no local que é usado pelo servidorda Web.

O que Fazer Depois

Verifique se o fix pack foi instalado com sucesso:1. Reinicie o servidor da Web. Para obter informações detalhadas, consulte a

documentação do servidor da Web que estiver usando.2. Reinicie o servidor de aplicativos e o aplicativo Real-time Monitoring. Para

obter informações detalhadas, consulte a documentação do servidor deaplicativos que estiver usando.

3. Efetue login no Real-time Monitoring Workbench e verifique se todos os objetosanteriores ainda existem e estão ativados. Para obter mais informações, consulteCapítulo 11, “Solucionando Problemas de sua Instalação”, na página 87.

4. Efetue login no Real-time Monitoring Dashboard e verifique se todos os painéisestão disponíveis.

5. Se o Cognos Business Intelligence (BI) 10.1 foi integrado com o Real-timeMonitoring, confirme se é possível visualizar os objetos do painel de BI. Paraobter mais informações, consulte o tópico “Configurando o sistema paraintegração com o Cognos Workspace” no Guia do Usuário do Real-timeMonitoring Workbench.

Se o Cognos BI foi integrado com o Cognos Real-time Monitoring, atualize oCognos BI com o mesmo nível de fix pack.

Instalando os Fix Packs do UNIX e LinuxUse as etapas a seguir para instalar os fix packs do IBM Cognos Real-timeMonitoring em sistemas operacionais UNIX e Linux.

Antes de Iniciar

Antes de instalar o fix pack:

22 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 31: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

1. Como uma etapa opcional, porém recomendada, faça backup dos seusmetadados e configuração do Real-time Monitoring:a. Inicie o IBM Cognos Real-time Monitoring Workbench usando um ID de

usuário com privilégios de administrador.b. Na guia Console Administrativo, clique no botão Configurações do

Sistema.c. No menu suspenso de configuração, selecione Configuração de Ponto de

Verificação.d. Clique no botão Executar Ponto de Verificação Agora.e. Acesse a guia Console Administrativo e clique no botão Importar/Exportar.f. Na Janela Importar/Exportar, selecione a operação Exportar Metadados para

um Arquivo JAR (Download).g. Configure as opções de exportação como Exportação Customizada e

selecione todas as opções disponíveis.h. Clique em OK. Você será solicitado a inserir um local para download do

arquivo em seu computador.

Nota: Certifique-se de que os pop-ups não estejam bloqueados.2. Pare o aplicativo Real-time Monitoring:

a. Pare e remova a implementação do Real-time Monitoring. As etapasvariarão dependendo do tipo de servidor de aplicativos:v Consulte o “Desinstalando do IBM WebSphere Application Server” na

página 41.v Consulte o “Desinstalando do Oracle WebLogic Application Server” na

página 55.v Consulte o “Desinstalando do JBoss Application Server” na página 71.

b. Pare o servidor de aplicativos. Para obter informações detalhadas, consultea documentação do servidor de aplicativos que estiver usando.

c. Pare o servidor da Web. Para obter informações detalhadas, consulte adocumentação do servidor da Web que estiver usando.

3. Como uma etapa opcional, porém recomendada, faça backup do conteúdo dodiretório de instalação do RTM original. Este diretório inclui o conteúdoestático.

4. Como uma etapa opcional, porém recomendada, faça backup dos bancos dedados operacionais, de geografia e de metadados. Para obter informaçõesdetalhadas, consulte a documentação do produto para o produto de banco dedados que está usando.

Procedimento1. Se usando um disco, monte o disco do fix pack que é apropriado para seu

sistema operacional UNIX ou Linux, usando extensões do arquivo Rock Ridge.

Importante: Para montar o disco do IBM Cognos no HP-UX, faça o seguinte:v Inclua o diretório pfs_mount no seu caminho.

Por exemplo,PATH=/usr/sbin/:$PATHexport PATH

v Para iniciar os daemons NFS necessários e execute os daemons no segundoplano, digite bg pfs_mountd e, em seguida, digite bg pfsd.

v Para montar a unidade, digitepfs_mount -t rrip <device> <mount_dir> -o xlat=unix

Capítulo 4. Instalando e Configurando Servidores de Aplicativos 23

Page 32: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Por exemplo,pfs_mount -t rrip /dev/dsk/c0t2d0 /cdrom -o xlat=unix

?Agora é possível instalar ou copiar os arquivos como um usuário não rootusando um disco IBM Cognos a partir desta unidade.

v Quando a instalação estiver concluída, digite pfs_umount /cdrom e elimine osdaemons pfsd e pfs_mountd para desmontar o disco.

2. Se usando um download, acesse o local no qual fez o download e extraiu osarquivos do fix pack.

3. Para iniciar o assistente de instalação, digite./issetup

4. Siga as orientações no assistente de instalação para instalar no mesmo local queseu produto Cognos Real-time Monitoring existente.O programa issetup solicita que você permita que o fix pack crie uma cópia debackup na pasta de instalação antes de copiar novos arquivos.

5. Implemente a nova versão do arquivo EAR do Real-time Monitoring(Realtime.ear, Realtime-weblogic.ear ou Realtime-jboss5.ear) de acordo comas instruções para seu servidor de aplicativos.v Consulte o “Implementando o Real-time Monitoring em um IBM WebSphere

Application Server” na página 37.v Consulte o “Implementando o Real-time Monitoring em um Oracle WebLogic

Application Server” na página 52.v Consulte o “Implementando o Real-time Monitoring em um JBoss

Application Server” na página 67.

O que Fazer Depois

Verifique se o fix pack foi instalado com sucesso:1. Reinicie o servidor da Web. Para obter informações detalhadas, consulte a

documentação do servidor da Web que estiver usando.2. Reinicie o servidor de aplicativos e o aplicativo Real-time Monitoring. Para

obter informações detalhadas, consulte a documentação do servidor deaplicativos que estiver usando.

3. Efetue login no Real-time Monitoring Workbench e verifique se todos os objetosanteriores ainda existem e estão ativados. Para obter mais informações, consulteCapítulo 11, “Solucionando Problemas de sua Instalação”, na página 87.

4. Efetue login no Real-time Monitoring Dashboard e verifique se todos os painéisestão disponíveis.

5. Se o Cognos Business Intelligence (BI) 10.1 foi integrado com o Real-timeMonitoring, confirme se é possível visualizar os objetos do painel de BI. Paraobter mais informações, consulte o tópico “Configurando o sistema paraintegração com o Cognos Workspace” no Guia do Usuário do Real-timeMonitoring Workbench.

Se o Cognos BI foi integrado com o Cognos Real-time Monitoring, atualize oCognos BI com o mesmo nível de fix pack.

24 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 33: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Capítulo 5. Fazendo Atualização de uma Versão Anterior ouReinstalando o Real-time Monitoring

Esta seção descreve como fazer atualização para uma nova versão do IBM CognosReal-time Monitoring. Estas etapas também se aplicam à atualização do CognosNow! versão 4.5.2.2 para o Real-time Monitoring.

Nota: Para preparar-se para quaisquer problemas que possam ser encontradosdurante a atualização, leia as notas sobre o release antes de fazer a atualização.

Antes de Iniciar

Antes de iniciar a atualização, faça backup de todos os seus metadados e dosbancos de dados geográficos e operacionais. Também anote ou faça uma capturade tela das configurações da origem de dados e da configuração do provedor deautenticação.

Procedimento1. Efetue login no IBM Cognos Real-time Monitoring Workbench.2. Exporte os metadados do Real-time Monitoring usando o recurso de

Importação/Exportação conforme descrito no Guia do Usuário do IBMCognos Real-time Monitoring Workbench .

3. Registre as configurações do sistema existente que você gostaria de reutilizar.Para exibir as configurações do sistema, clique no botão Configurações doSistema.

4. Pare o Real-time Monitoring.5. Exclua as tabelas do banco de dados de metadados.

Os bancos de dados operacionais e geográficos das versões anteriores podemcontinuar a ser usados. Para manter seu banco de dados de metadadosanterior intacto, crie e especifique um esquema diferente de banco de dadosao configurar a nova versão, no entanto, não exclua o banco de dados decontexto ou qualquer outro banco de dados customizado.

6. Execute as etapas para desinstalar o IBM Cognos Real-time Monitoringconforme descrito para cada servidor de aplicativos. É necessário desinstalarapenas o arquivo EAR. Se não puder executar o desinstalador porque vocêestá desinstalando uma versão anterior do software, você poderá excluirmanualmente os arquivos de aplicativo.v Consulte o “Desinstalando do IBM WebSphere Application Server” na

página 41.v Consulte o “Desinstalando do Oracle WebLogic Application Server” na

página 55.v Consulte o “Desinstalando do JBoss Application Server” na página 71.

7. Execute o instalador do Real-time Monitoring.Para obter mais informações, consulte Capítulo 4, “Instalando e ConfigurandoServidores de Aplicativos”, na página 15.

8. Implemente a nova versão do arquivo EAR para IBM Cognos Real-timeMonitoring em seu servidor de aplicativos:v Consulte o “Implementando o Real-time Monitoring em um IBM

WebSphere Application Server” na página 37.

© Copyright IBM Corp. 2003, 2014 25

Page 34: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

v Consulte o “Implementando o Real-time Monitoring em um OracleWebLogic Application Server” na página 52.

v Consulte o “Implementando o Real-time Monitoring em um JBossApplication Server” na página 67.

Nota: Não é necessário configurar as conexões de origens de dados noservidor de aplicativos. É possível usar as conexões que foram configuradasantes da instalação. Se as tabelas de metadados existentes não foramexcluídas, altere a conexão da origem de dados para os metadados para umesquema diferente de banco de dados. Versões anteriores do esquema demetadados não são compatíveis com a nova versão.

9. Efetue login no IBM Cognos Real-time Monitoring Workbench.

Nota: Você pode precisar reconfigurar as configurações iniciais conformedescrito na seção “Configurando o Real-time Monitoring no IBM CognosReal-time Monitoring Workbench” na página 83.

10. Se os usuários existirem em um servidor de protocolo LDAP, em um servidorActive Directory Service (ADS) ou no IBM Tivoli Directory Server, você deveráusar esses sistemas para sincronizar todos os seus usuários, funções eassociações de função.

11. Importe os metadados que exportou na primeira etapa deste procedimento.Use o recurso Importar/Exportar no IBM Cognos Real-time MonitoringWorkbench conforme descrito no Guia do Usuário do IBM Cognos Real-timeMonitoring Workbench.

12. Para verificar a instalação, efetue login no Real-time Monitoring como ortmadmin.

26 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 35: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Capítulo 6. Instalando o Real-time Monitoring em um IBMWebSphere Application Server

Esta seção descreve como instalar, implementar e desinstalar o IBM CognosReal-time Monitoring em um IBM WebSphere Application Server.

Instalando e Implementando o Real-time Monitoring em um IBMWebSphere Application Server

O IBM Cognos Real-time Monitoring pode ser instalado e implementado em umIBM WebSphere Application Server.

Você deverá ter executado previamente o instalador do Real-time Monitoring noservidor de aplicativos. Para obter mais informações, consulte “Instalando osComponentes do Real-time Monitoring Application Server” na página 15.

Revisando e Verificando os Requisitos para o IBM WebSphereEsta seção descreve os requisitos para instalar e implementar o IBM CognosReal-time Monitoring em um IBM WebSphere Application Server.

Esta seção assume que você está familiarizado com o IBM WebSphere.Especificamente, é necessário saber como fazer o seguinte:v Use o Console Administrativo do IBM WebSphere.v Criar um escopo de servidor dedicado.v Configurar um caminho de classe.v Configurar um novo provedor JDBC.

Instalação do IBM WebSphere Application ServerInstale o IBM WebSphere Application Server suportado adequado conformeespecificado no IBM Cognos Customer Center.

Para obter mais informações, consulte “Revisando Ambientes Suportados” napágina 11.

Drivers Java Database ConnectivityInstale o driver Java Database Connectivity (JDBC) correto para seu banco dedados de metadados.

A seguir estão os diferentes bancos de dados que podem ser usados para tabelasde metadados.v IBM DB2v SQL Server 2000 com SP3 ou posteriorv SQL Server 2005v SQL Server 2008v MySQL 5.0 ou posteriorv PostgreSQLv Oracle 9.2 ou posterior

© Copyright IBM Corp. 2003, 2014 27

Page 36: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

É possível acessar outros bancos de dados além daqueles listados acima, contantoque um Driver Tipo 4 exista para o banco de dados que você pretende usar.Entretanto, apenas os bancos de dados listados acima são certificados.

Consulte os seguintes Web sites para determinar o driver de banco de dadosapropriado para seu banco de dados. Os Drivers Tipo 4 são preferenciais para oIBM Cognos Real-time Monitoring. Obtenha o driver JDBC do cliente a partir dainstalação ou do fornecedor do banco de dados que você planeja acessar:v Para o IBM WebSphere 6.0, consulte

http://www.ibm.com/support/docview.wss?&uid=swg27007298v Para o IBM WebSphere 6.1, consulte

http://www.ibm.com/support/docview.wss?&uid=swg27007642v Para o IBM WebSphere 7.1, consulte

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

Escolha o sistema operacional apropriado e consulte a seção dos drivers JDBC.

Configuração preliminar do Monitoramento em Tempo Real noWebSphere

Revise os seguintes requisitos, recomendações e limitações a considerar parainstalar e implementar com sucesso o IBM Cognos Real-time Monitoring no IBMWebSphere Application Server.

Crie uma instância do servidor dedicado no IBM WebSphere Application Serverpara a instalação do IBM Cognos Real-time Monitoring. Instruções detalhadas paracriar uma nova instância do servidor podem ser localizadas nos locais listados natabela a seguir.

Tabela 5. Informações Adicionais do IBM WebSphere Application ServerVersão Link para a Documentação On-Line

6.0 http://publib.boulder.ibm.com/infocenter/wasinfo/v6r0

Selecione WebSphere Application Server > Configurando o Ambiente de Serviço doAplicativo > Criando e Excluindo Perfis.

6.1 http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1

Selecione WebSphere Application Server > Configurando o Ambiente de Serviço doAplicativo > Criando e Excluindo Perfis.

7.0 http://publib.boulder.ibm.com/infocenter/wasinfo/v7r0

Selecione WebSphere Application Server > Configurando o Ambiente de Serviço doAplicativo > Gerenciando Perfis.

Se estiver usando as versões Network Deployment ou Extended Deployment doIBM WebSphere Application Server, você deverá criar um escopo do servidordedicado para implementar o Real-time Monitoring. Todas as atividades deinstalação do Real-time Monitoring devem ocorrer dentro do escopo deste servidor.

Você deve localizar o arquivo Realtime.ear, que está localizado no diretórioc10_location/realtime/bin64, para o servidor. Ele será usado durante aimplementação.

Nota: Se você estiver usando o IBM WebSphere Application Server versão 7 ousuperior, o arquivo log4j e o pacote JaxB que são fornecidos com o WebSphere nãosão compatíveis com o Real-time Monitoring. Para evitar problemas causados poresta incompatibilidade, você deve copiar os seguintes arquivos JAR, que estãolocalizados no diretório c10_location/realtime/bin64, no diretório endossado no

28 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 37: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

servidor de aplicativos: log4j-1.2.7.jar, jaxb-api.jar, jaxb-impl.jar, jaxb-xjc.jar ejaxb1-impl.jar. Se o diretório de endosso não existir no servidor de aplicativos, vocêdeverá criá-lo. O diretório de endosso pode ser localizado no local a seguir:v Nos sistemas operacionais Windows: C:\Program Files\ibm\WebSphere\

AppServer\java\jre\lib\endorsed

v Nos sistemas operacionais UNIX ou Linux: /opt/IBM/WebSphere/AppServer/java/jre/lib/endorsed

Modificando as configurações da Java virtual machine noWebSphere

Esta seção descreve como modificar as configurações da Java virtual machine(JVM) através do Console Administrativo do IBM WebSphere Application Server.

Usando o Console Administrativo do IBM WebSphere, na caixa Argumentos daJVM genéricos, você deve digitar cada um dos argumentos da JVM necessários,que devem ser separados por um espaço. Como o WebSphere possui configuraçõesespecíficas para Heap Inicial e Heap Máximo, você deve inserir os valores -Xms e-Xmx nesses campos específicos. As instruções detalhadas para configuração dosparâmetros da JVM podem ser localizadas no local na tabela a seguir.

Tabela 6. Link para obter Informações Adicionais para Configuração dos Parâmetros JVMVersão Link para a Documentação On-Line

6.0 http://publib.boulder.ibm.com/infocenter/wasinfo/v6r0

Selecione WebSphere Application Server > Configurando o Ambiente de Serviço do Aplicativo >Administrando Servidores de Aplicativos > Configurando a JVM.

6.1 http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1

Selecione WebSphere Application Server > Configurando o Ambiente de Serviço do Aplicativo >Administrando Servidores de Aplicativos > Configurando a JVM.

7.0 http://publib.boulder.ibm.com/infocenter/wasinfo/v7r0

Selecione WebSphere Application Server > Configurando o Ambiente de Serviço do Aplicativo >Administrando Servidores de Aplicativos > Configurando a JVM.

As configurações específicas pertencem à alocação da RAM. Para evitar tentativasde realocar memória, -Xms e -Xmx devem ser configurados com o mesmo valor: asquantidades mínima e máxima de memória para alocar no servidor Real-timeMonitoring. Para um servidor com 16 GB de RAM, a configuração preferencial éum mínimo de 12 GB. Geralmente, um número que é aproximadamente 3/4 dototal de RAM é preferível.

Configure -Xmxns e -Xmxnx com o mesmo valor. O número deve ser 1/4 dotamanho escolhido para -Xms.

A tabela a seguir fornece exemplos dos valores de parâmetros a usar com base emum tamanho de memória de 16 GB e 32 GB.

Tabela 7. Exemplos de Valores de Parâmetro da JVMMemória Valor de parâmetro

16 GB -Xms12288M

-Xmx12288M

-Xmns3072M

-Xmnx3072M

Capítulo 6. Instalando o Real-time Monitoring em um IBM WebSphere Application Server 29

Page 38: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Tabela 7. Exemplos de Valores de Parâmetro da JVM (continuação)Memória Valor de parâmetro

32 GB -Xms24576M

-Xmx24576M

-Xmns6144M

-Xmnx6144M

Você também deve especificar as configurações da Coleção de Lixo. A entrada-Xgcthreads8 deve ser igual ao número de núcleos de processador disponíveis. Porexemplo, se houver dois processadores dual-core, insira -Xgcthreads4. Se houver 4processadores dual-core, ou 2 processadores quad-core, insira -Xgcthreads8.

As configurações -verbose:sizes e -verbose:gc são úteis na determinação dosproblemas de coleção de lixo durante a execução. Todos devem ser configurados. Aúltima configuração deve apontar para o diretório de log, por exemplo:

-xverbosegclog:"c:/program files/ibm/cognos/c10_64/realtime/logs"

Se houver um espaço no caminho, será necessário colocar o parâmetro inteiro entreaspas. Use barras em vez de barras invertidas no nome do caminho.

Procedimento1. Inicie o IBM WebSphere Administrative Console.2. Inclua o obiProperties.jar localizado no diretório c10_location/realtime/bin64

no caminho de classe da Java virtual machine.v Por exemplo, em um servidor executando o sistema operacional Windows,

insira:c:/program files/ibm/cognos/c10_64/realtime/bin64/obiProperties.jar

v Em um servidor que está executando o sistema operacional AIX, Solaris ouLinux, insira:/opt/ibm/cognos/c10_64/realtime/bin64/obiProperties.jar

3. Se você estiver usando as versões Network Deployment ou ExtendedDeployment do IBM WebSphere Application Server, inclua os seguintesvalores no caminho de classe da Java virtual machine antes de criar os agentesde serviço da Web:v c10_location/realtime/bin64/wsdl4j.jar

v c10_location/realtime/bin64/wsif.jar

v WebSphere_install_location/optionalLibraries/Apache/Struts/1.2.9/commons-logging.jar

4. Configure os parâmetros da JVM para obter a memória e a coleção de lixo(GC) ideais. Parâmetros de amostra da JVM para a execução do Real-timeMonitoring no IBM Java para WebSphere são recomendados como a seguir:-Xms24576M

-Xmx24576M

-Xmns6144M

-Xmnx6144M

-verbose:sizes

-verbose:gc

-Xgcthreads8

-Xgcpolicy:gencon

-Xcompactgc

-Xalwaysclassgc

30 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 39: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

-Xverbosegclog:/var/log/realtime/realtime-gc.log

Nota: Digite a entrada -Xms na caixa Heap Inicial. Digite a entrada -Xmx nacaixa Heap Máximo. Não repita estas entradas na caixa Argumentos da JVMGenéricos.

5. Certifique-se de que a propriedade com.cognos.obi.bootstrap.envpropnameesteja configurada como BOOTPROPS e que a propriedade JVM BOOTPROPSaponte para o arquivo realtime.properties que foi editado durante suapreparação para instalação.-DBOOTPROPS=<c10_location>/realtime/configuration/realtime.properties

-Dcom.cognos.obi.bootstrap.envpropname=BOOTPROPS

Em que <c10_location> especifica o local do arquivo realtime.properties quecontém as propriedades de autoinicialização.

6. Configure o tipo de codificação de arquivo como UTF8.-Dfile.encoding=utf8

7. Opcionalmente, configure a propriedade anonymousaccessenabled como truepara ativar o login anônimo. Configure esta propriedade como false paradesativar o login anônimo. Quando esta propriedade é ativada, a tela de loginmostra o link Efetuar Login como Usuário Anônimo.-Danonymousaccessenabled=true

Com um login anônimo ativado, é possível efetuar login automaticamente noIBM Cognos Real-time Monitoring Dashboard ou no IBM Cognos Real-timeMonitoring Workbench sem especificar um nome de usuário ou senha, usandoa seguinte URL:http://servername/cognos/realtime/landing/landingpage.htmIsso permite escolher o aplicativo. Se você configurou o servidor para usaruma porta diferente da padrão, poderá precisar especificar a porta.

8. Opcionalmente, se as conexões http de saída, tais como serviços da Web ouserviços de codificação geográfica, forem necessárias para percorrer umservidor proxy a partir de seus ambiente do servidor, inclua a seguintepropriedade JVM no script de inicialização para que a camada deconectividade Java use o servidor proxy para todas as chamadas de saída.-Dhttp.proxyHost=<fully qualified server name of http proxy>

-Dhttp.proxyPort=<http proxy port number>

-Dhttps.proxyHost=<fully qualified server name of https proxy>

-Dhttps.proxyPort=<https proxy server port>

Nota: Servidores proxy que requeiram autenticação não são suportados.9. Salve a nova configuração.

10. Opcionalmente, configure os parâmetros de idioma e código de idioma comodescrito em “Configurando os parâmetros de idioma e código do idioma parao Real-time Monitoring no WebSphere Application Server”.É necessário executar esta etapa apenas se desejar inicializar o metadados emum código do idioma diferente do código do idioma do servidor padrão.

11. Salve as alterações.12. Reinicie o IBM WebSphere Application Server.

Configurando os parâmetros de idioma e código do idioma parao Real-time Monitoring no WebSphere Application ServerÉ possível configurar parâmetros opcionais para o banco de dados de metadados,incluindo idioma, país ou região e força de ordenação.

Capítulo 6. Instalando o Real-time Monitoring em um IBM WebSphere Application Server 31

Page 40: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Os padrões são baseados nas configurações do código de idioma do servidor. Vocêdeve configurar estes padrões antes de iniciar o servidor de aplicativos pelaprimeira vez. Estes parâmetros são incluídos no script de início para o servidor deaplicativos e usam o seguinte formato básico:

-Dcom.cognos.obi.property.[PARAMETER]=[VALUE]

Cada parâmetro é descrito na tabela abaixo. Esta tabela é seguida porprocedimentos específicos para configurar os parâmetros na configuração doservidor de aplicativos.

Tabela 8. Configurações de Parâmetros Opcionais para o Banco de Dados de MetadadosWebSphere Application ServerParâmetro Descrição

LOCALE_LANGUAGE O código de idioma ISO de dois caracteres para o servidor.

Por exemplo, para configurar o parâmetro de idioma como Português, seria incluídoo seguinte comando:

-Dcom.cognos.obi.property.LOCALE_LANGUAGE=PTNota: Prefixe a configuração com o comando -D.

LOCALE_REGION O código do país ou da região ISO de dois caracteres para o servidor.

Por exemplo, para configurar o país ou a região como Brasil, seria incluído oseguinte comando:

-Dcom.cognos.obi.property.LOCALE_REGION=BR

LOCALE_COLLATION Configure como true ou false para indicar se deve executar comparações desequência sensíveis ao código do idioma. (O padrão é false.)

COLLATE_STRENGTH Especifica o nível de força de ordenação; ou seja, a extensão na qual os caracteresnão em inglês são comparados e ordenados: primário, secundário, terciário ouidêntico. Primário é o menos distintivo; idêntico é o mais distintivo. (O padrão éterciário.) Para obter mais informações sobre parâmetros de ordenação, consulte adocumentação do Java em:

http://download.oracle.com/javase/1.5.0/docs/api/java/util/Locale.htmlNota: Esta configuração é funcional apenas se LOCALE_COLLATION estiverconfigurado como true.

COLLATE_DECOMPOSITION Especifica um dos seguintes modos de decomposição de ordenação: nenhum,canônico ou integral. (O padrão é canônico.) Para obter mais informações sobreparâmetros de ordenação, consulte a documentação do Java em:

http://download.oracle.com/javase/1.5.0/docs/api/java/util/Locale.htmlNota: Esta configuração é funcional apenas se LOCALE_COLLATION estiverconfigurado como true.

Procedimento1. No Console Administrativo do IBM WebSphere, navegue para Argumentos

Genéricos da JVM.2. Inclua as configurações de parâmetro usando a seguinte sintaxe:

com.cognos.obi.property.[PARAMETER]=[VALUE]

Nota: Delimite configurações diversas com um espaço. Prefixe cadaconfiguração com o comando -D.

3. Salve as alterações.4. Reinicie o WebSphere Application Server.

Resultados

As alterações nas propriedades JVM são configuradas.

32 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 41: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Criando e Configurando a Conexão de Metadados noWebSphere

Esta seção cobre as seguintes tarefas que você precisará executar para configurar aconexão de metadados em um IBM WebSphere Application Server. Oarmazenamento de banco de dados já deve existir.

Criando um alias Java Authentication and Authorization Service(JAAS) para todos os bancos de dadosCriando um alias de autenticação que esteja em conformidade com a conta dousuário dedicado para o banco de dados, você pode eliminar qualquer necessidadede configurar propriedades customizadas para estes parâmetros posteriormente.

Este alias será referenciado na configuração.

Procedimento1. Inicie o IBM WebSphere Application Server e abra o Console Administrativo do

IBM WebSphere.2. Crie um novo alias do JAAS com os valores a seguir e, em seguida, clique em

OK.

Tabela 9. Valores de Alias JAASCampo Descrição

Alias Qualquer valor. Ele será usado para configurar um provedor JDBC.

ID do Usuário ID do usuário válido para o banco de dados selecionado.

Senha Senha válida para o ID do usuário.

Descrição Descrição do texto opcional.

Resultados

O novo alias agora é exibido na lista.

Configurando um Novo Provedor Java Database ConnectivityNo Console Administrativo do IBM WebSphere, você deve configurar um novoprovedor Java Database Connectivity (JDBC).

Instruções detalhadas para criar um e provedor JDBC podem ser localizadas noslocais na tabela a seguir.

Tabela 10. Links para Informações Adicionais sobre Provedores JDBCVersão Link para a Documentação On-Line

6.0 http://publib.boulder.ibm.com/infocenter/wasinfo/v6r0

Selecione o WebSphere Application Server e procure o tópico em Configurando um Provedor JDBC e umaOrigem de Dados.

6.1 http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1

Selecione o WebSphere Application Server e procure o tópico em Configurando um Provedor JDBC e umaOrigem de Dados.

7.0 http://publib.boulder.ibm.com/infocenter/wasinfo/v7r0

Selecione o WebSphere Application Server e procure o tópico em Configurando um Provedor JDBC e umaOrigem de Dados.

Procedimento1. Selecione um tipo de banco de dados suportado e o Provedor JDBC conforme

indicado na tabela a seguir:

Capítulo 6. Instalando o Real-time Monitoring em um IBM WebSphere Application Server 33

Page 42: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Tabela 11. Provedor JDBC SuportadoBanco de Dados Provedor JDBC

DB2 Provedor do Driver DB2 Universal JDBC

Microsoft SQL Server Driver JDBC Connect integrado do IBM WebSphere para o Microsoft SQL Server

Microsoft SQL Server(WAS 7) Driver JDBC do Microsoft SQL Server

MySQL Selecione Provedor JDBC definido pelo usuário, em seguida, especifique o nome da classe deimplementação para MySQL: com.mysql.jdbc.jdbc2.optional.MysqlConnectionPoolDataSource

PostgreSQL Selecione Provedor JDBC definido pelo usuário, em seguida, especifique o nome da classe deimplementação para PostgreSQL: org.postgresql.jdbc2.optional.ConnectionPool

Oracle Driver JDBC Oracle

2. A partir das opções de tipo de implementação, selecione Origem de Dados doConjunto de Conexões.

3. Ao definir a configuração de Caminho de Classe, use as seguintesconfigurações conforme apropriado, substituindo os valores reais para[FILE_PATH]:

Tabela 12. Configurações de Caminho da Classe para Bancos de Dados SuportadosBanco de Dados Incluir na Configuração do Caminho de Classe

DB2 [FILE_PATH]/db2jcc.jar

[FILE_PATH]/db2jcc_license_cu.jar

Para WebSphere Network Deployment Versão 7.0 e DB2 ESE 9.7, usardb2jcc4.jar.

Microsoft SQL Server 2005 e 2008 (IBM WebSphere 7)Defina a configuração de caminho de classe como sqljdbc4.jar. (Funcionaapenas com o JDK1.6)

Microsoft SQL Server 2005 (IBM WebSphere 6.1.x apenas) Para Microsoft SQL Server 2005, deixe os drivers nativos padrão intactos:sqlserver.jar, base.jar e util.jar.

Microsoft SQL Server 2000 local do arquivo/mssqlserver.jar

file location/msbase.jar

file location/msutil.jar

Certifique-se de que qualquer outra entrada para os mesmos JARs sejaexcluída.

MySQL 5.0 ou posterior file location/mysql-connector-java-[version]-bin.jar

PostgreSQL file location/postgresql-[version].jdbc3.jar

Oracle file location/ojdbc14.jar (Para Oracle 10g.)

file location/ojdbc6.jar (Para Oracle 11g. Funciona apenas com JDK1.6.)

4. Para clientes thick DB2 (Tipo 2) e Oracle (Tipo 2), configure o caminho dabiblioteca nativa para apontar para o cliente de instalação.

5. Salve a nova configuração do provedor.Agora é possível configurar a origem de dados, como descrito em “Definindo aOrigem de Dados do IBM WebSphere”.

Definindo a Origem de Dados do IBM WebSphereEsta seção descreve como definir a origem de dados para a nova configuração doprovedor Java Database Connectivity (JDBC).

Instruções detalhadas podem ser localizadas nos locais na seguinte tabela.

34 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 43: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Tabela 13. Links para Informações Adicionais sobre JDBCVersão Link para a Documentação On-line

6.0 http://publib.boulder.ibm.com/infocenter/wasinfo/v6r0

Selecione o WebSphere Application Server e procure o tópico em Configurando um Provedor JDBCe uma Origem de Dados.

6.1 http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1

Selecione o WebSphere Application Server e procure o tópico em Configurando um Provedor JDBCe uma Origem de Dados.

7.0 http://publib.boulder.ibm.com/infocenter/wasinfo/v7r0

Selecione o WebSphere Application Server e procure o tópico em Configurando um Provedor JDBCe uma Origem de Dados.

Procedimento1. Conclua as configurações especificadas conforme a seguir:

Tabela 14. Configurações de Origem de Dados JDBCConfigurando Valor

Nome com.cognos.obi.metadata.metaDatasource

Nome da JNDI com.cognos.obi.metadata.metaDatasource

Persistência gerenciada pelo contêiner Limpe a caixa de seleção

Apenas Oracle 10g Para Oracle, especifique o seguinte nome de Classe Auxiliar da Origem de Dados:

Escolha o auxiliar da armazenamento de dados Oracle10g

Oracle 11g Escolha o auxiliar de armazenamento de dados Oracle11g (suportado apenas no WAS7.x)

Microsoft SQL Server Para o servidor Microsoft SQL, use o valor-padrão selecionado:

Auxiliar de Armazenamento de Dados do Microsoft SQL Server

Alias de Autenticação Gerenciado peloComponente

Selecione o valor criado em “Criando um alias Java Authentication and AuthorizationService (JAAS) para todos os bancos de dados” na página 33.

2. Configure as propriedades para a origem de dados de metadadoscom.cognos.obi.metadata.metaDatasource conforme descrito na tabela a seguir.

Tabela 15. Configurações das Propriedades da Origem de Dados dos Metadados

Tipo de banco de dadosPropriedadePadrão/Customizada Valor

DB2 (Tipo 4) serverName Insira o nome do host ou o endereço IP do computador que estáexecutando o banco de dados.

portNumber Insira o número da porta na qual o DB2 está sendo executado.(Geralmente, 50000, embora sua configuração possa ser diferente).

databaseName Insira o nome do banco de dados.

Microsoft SQL Server (2000, 2005e 2008)

serverName Insira o nome do host ou o endereço IP do computador que estáexecutando o banco de dados.

portNumber Insira o número da porta a partir do qual o Microsoft SQL Server estáem execução. (Geralmente 1433, embora sua configuração possadiferir.)

databaseName Insira o nome do banco de dados.

selectMethod Opcionalmente, para o selectMethod, escolha "cursor".

MySQL 50 ou posterior URL jdbc:mysql://[hostname]:[port]/[schemaname]

PostgreSQL URL jdbc:postgresql://[dbhost]:[port]/[dbname]

Capítulo 6. Instalando o Real-time Monitoring em um IBM WebSphere Application Server 35

Page 44: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Tabela 15. Configurações das Propriedades da Origem de Dados dosMetadados (continuação)

Tipo de banco de dadosPropriedadePadrão/Customizada Valor

Oracle URL Driver Thin:

jdbc:oracle:thin:@[host name]:[port]:[SID]

Por exemplo: jdbc:oracle:thin:@orclhost:1521:orcl

Driver Thick (OCI):

jdbc:oracle:oci:@[tnsalias]

Por exemplo: jdbc:oracle:oci:@RTMtns

driverType Insira "thin" ou "oci" conforme apropriado.

3. Clique em OK para salvar a nova configuração do provedor.4. Teste a nova conexão.

Definindo Origens de Dados no WebSpherePara a instalação, você deve definir as duas origens de dados a seguir: uma origemde dados para mapas geográficos e uma origem de dados operacional.

Opcionalmente, é possível definir origens de dados para agentes Java DatabaseConnectivity (JDBC).

Definindo a Origem de Dados para Mapas GeográficosÉ necessário definir uma origem de dados geográfica para mapas geográficos.

Para configurar o suporte para mapas geográficos, siga as etapas para a criação deuma origem de dados com o IBM WebSphere Application Server conforme descritona seção “Criando e Configurando a Conexão de Metadados no WebSphere” napágina 33. Entretanto, você deve especificar o nome e o nome da Java Naming andDirectory Interface (JNDI) como com.cognos.obi.geo.geoDatasource.

Definindo uma Origem de Dados OperacionalUma origem de dados operacional é um repositório de banco de dados que vocêusa para armazenar e persistir os dados da consulta.

Para configurar sua origem de dados operacional, siga as mesmas etapas que aocriar uma origem de metadados. Entretanto, você deve especificar o nome e onome da Java Naming and Directory Interface (JNDI) comocom.cognos.obi.operational. Para criar uma origem de dados, siga o procedimentodescrito em “Criando e Configurando a Conexão de Metadados no WebSphere” napágina 33

Definindo Origens de Dados Opcionais AdicionaisPara cada agente Java Database Connectivity (JDBC) (por exemplo, para acessar ofluxo de dados ou os dados da tabela de consulta) que você cria no IBM CognosReal-time Monitoring Workbench, crie uma origem de dados na instalação do IBMWebSphere.

O uso da Java Naming and Directory Interface (JNDI) com Conjuntos de Conexõesé a maneira preferível para se conectar às origens de dados JDBC. O nome TheJNDI especificado aqui é usado no Real-time Monitoring Workbench naconfiguração de um Agente JDBC. Se um driver do Conjunto de Conexões nãoestiver disponível, uma alternativa seria especificar uma conexão baseada em URLno Real-time Monitoring Workbench. O nome da Java Naming and Directory

36 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 45: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Interface (JNDI) deve ser exclusivo para cada origem de dados. Para criar umaorigem de dados, siga o procedimento descrito em “Criando e Configurando aConexão de Metadados no WebSphere” na página 33

Implementando o Real-time Monitoring em um IBMWebSphere Application Server

Esta seção descreve o processo de implementação do IBM Cognos Real-timeMonitoring no servidor de aplicativos.

Para obter mais informações sobre implementação de aplicativos em um IBMWebSphere Application Server, consulte a tabela a seguir.

Tabela 16. Links para Informações Adicionais sobre Implementação de Aplicativos em umIBM WebSphere Application ServerVersão Link para a Documentação On-Line

6.0 http://publib.boulder.ibm.com/infocenter/wasinfo/v6r0/

Selecione o WebSphere Application Server e procure o tópico Instalando Arquivos deAplicativos J2EE.

6.1 http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/

Selecione o WebSphere Application Server e procure o tópico Instalando Arquivos deAplicativos J2EE.

7.0 http://publib.boulder.ibm.com/infocenter/wasinfo/v7r0/

Selecione o WebSphere Application Server e procure o tópico Instalando Arquivos deAplicativos Corporativos.

Procedimento1. Inicie o IBM WebSphere Application Server, se ele não estiver em execução

atualmente, e abra o Console Administrativo do IBM WebSphere.2. Expanda o nó Aplicativos e clique em Aplicativos Corporativos.

Esta ação exibe a página Aplicativos Corporativos.3. Clique no botão Instalar.4. Escolha c10_location/realtime/bin64/Realtime.ear na mídia ou no disco de

instalação.em que c10_location é o local em que o IBM Cognos Real-time Monitoring foiinstalado.

5. Clique em Avançar.6. Ao preparar a página de instalação do aplicativo para exibição, selecione a

opção Gerar Ligações Padrão e clique em Avançar.7. Para manter os valores padrão para todas as etapas restantes, é possível ir para

a etapa final e clicar em Concluir.O IBM WebSphere instala o IBM Cognos Real-time Monitoring.Após ter confirmado a implementação, configure seu servidor da Web paratratar o conteúdo estático. Para obter informações sobre como configurar oconteúdo estático, consulte Capítulo 9, “Instalando, Configurando eDesinstalando Arquivos do Servidor da Web Real-time Monitoring”, na página73

8. Inicie o IBM Cognos Real-time Monitoring no IBM WebSphere ApplicationServer.Após configurar o IBM WebSphere Application Server e implementar oReal-time Monitoring, você deve iniciar o Real-time Monitoring diretamente noservidor de aplicativos.

Capítulo 6. Instalando o Real-time Monitoring em um IBM WebSphere Application Server 37

Page 46: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Configurando o Servidor de Aplicativos para Tratar ConteúdoDinâmico

Esta seção descreve como configurar o servidor de aplicativos para tratar oconteúdo dinâmico.

Entretanto, antes de poder configurar o conteúdo dinâmico, você deve primeiroconfigurar o conteúdo estático conforme descrito no Capítulo 9, “Instalando,Configurando e Desinstalando Arquivos do Servidor da Web Real-timeMonitoring”, na página 73.

É necessário configurar o servidor de aplicativos para tratar o conteúdo dinâmico,pois o plug-in de servidor da Web é usado para encaminhar pedidos do servidorda Web para o IBM WebSphere Application Server. O plug-in de servidor da Web éinstalado no computador do servidor da Web. Entretanto, o arquivo deconfiguração (plugin-cfg.xml) para o plug-in é gerado por meio do WebSphereApplication Server, em seguida, movido para o local apropriado no servidor daWeb. Para obter mais informações sobre o arquivo plugin-cfg.xml file, consulte otópico a seguir: http://publib.boulder.ibm.com/infocenter/wasinfo/v6r0/topic/com.ibm.websphere.express.doc/info/exp/ae/rwsv_plugincfg.html.

Nota: Para manipular o conteúdo dinâmico, é necessário executar estas etapasadicionais apenas no IBM WebSphere Application Server. Estas etapas não sãonecessárias no JBoss Application Server e no Oracle WebLogic Application Server.

Procedimento1. Certifique-se de ter implementado o arquivo EAR no IBM WebSphere

Application Server.2. Acesse o console administrativo do IBM WebSphere Application Server e

selecione Ambiente. Clique em Atualizar configuração do Plug-in de servidorda web global.O IBM WebSphere Application Server atualiza o arquivo de plug-in para ativaro servidor da Web para entregar conteúdo estático. O servidor da Web agorapode passar URIs dinâmicos para servlets e JSPs de volta ao IBM WebSphere.

3. Copie o arquivo de configuração de plug-in no servidor da Web remoto. Oarquivo de configuração é <WAS_HOME>/profiles/<profileName>/config/cells/plugin-cfg.xml.

Nota: Se seu servidor da Web for instalado no mesmo computador que seuservidor de aplicativos, especifique o local do arquivo plugin-cfg.xml noarquivo realtime.conf. Consulte Capítulo 9, “Instalando, Configurando eDesinstalando Arquivos do Servidor da Web Real-time Monitoring”, na página73 para obter mais informações sobre o arquivo realtime.conf.

Resultados

Após ter confirmado a implementação, configure seu servidor da Web para tratar oconteúdo estático. Para obter informações sobre como configurar o conteúdoestático, consulte Capítulo 9, “Instalando, Configurando e Desinstalando Arquivosdo Servidor da Web Real-time Monitoring”, na página 73.

38 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 47: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Testando o Real-time Monitoring após a instalação no IBM WebSphereApplication Server

Após instalar o IBM Cognos Real-time Monitoring no servidor de aplicativos e noservidor da Web, você pode testar sua instalação instalando e usando as amostrasque são fornecidas com o produto.

Procedimento1. Valide se os conteúdos estático e dinâmico estão configurados corretamente .

Consulte o “Verificando a Configuração para o Conteúdo Estático e Dinâmico”na página 80.

2. Opcionalmente, carregue as amostras . Consulte o “Carregando Amostras doReal-time Monitoring no IBM WebSphere Application Server”.

3. Inicie o Real-time Monitoring Workbench e importe os metadados de amostra .Consulte o “Importando Metadados de Amostra no Real-time Monitoring” napágina 40.

Carregando Amostras do Real-time Monitoring no IBMWebSphere Application Server

Carregue dados no IBM WebSphere Application Server para verificar se oaplicativo está funcionando.

O diretório c10_location/realtime/webcontent/samples/sdk/callcenter/CallCenterDemo/data contém o esquema do banco de dados Derby que terá astabelas, os dados e os acionadores demo da central de atendimento. Esta demorequer o driver Apache Derby 10.5.3. Para obter informações sobre como fazerdownload de um driver Apache Derby atualizado consulte:

http://db.apache.org/derby/derby_downloads.html

O diretório c10_location/realtime/webcontent/samples/sdk/callcenter/CallCenterDemo/metadata contém uma exportação do modelo de objeto usadopara a demo da central de atendimento; ele é independente de banco de dados.

Procedimento1. Localize os arquivos de amostra no diretório c10_location/realtime/webcontent/

samples/sdk.2. Copie o banco de dados c10_location/realtime/webcontent/samples/sdk/

callcenter/CallCenterDemo/data/ccdemo no seguinte diretório no IBMWebSphere Application ServerWebSphere install location/AppServer/derby/databases

3. Copie o arquivo derby.jar atualizado transferido por download a partir do sitede suporte da Apache no diretório derby/lib, tal como o diretório WebSphereinstall location/AppServer/derby/lib.

4. Usando o Console Administrativo do IBM WebSphere, crie uma origem dedados com as seguintes propriedades gerais.

Tabela 17. Propriedades de Origem de Dados de Amostras do Real-time Monitoring no IBMWebSphere Application ServerPropriedade Geral Configurando

Escopo cells:machine nameNode01Cell:nodes:machine nameNode01:servers:server1

Nome com.cognos.obi.demo.ccdemo

Nome da JNDI com.cognos.obi.demo.ccdemo

Capítulo 6. Instalando o Real-time Monitoring em um IBM WebSphere Application Server 39

Page 48: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Tabela 17. Propriedades de Origem de Dados de Amostras do Real-time Monitoring no IBMWebSphere Application Server (continuação)Propriedade Geral Configurando

Provedor Provedor JDBC Derby

Nome do Banco de Dados WebSphere install location/AppServer/derby/databases/ccdemo

Assegure que você selecionou Auxiliar de Armazenamento de Dados Derbycomo a classe auxiliar de armazenamento de dados.

5. Teste a conexão e salve seu trabalho.6. Reinicie o IBM WebSphere Application Server.

Resultados

Após preparar as origens de dados de amostra, é possível importar os metadadosde amostra.

Importando Metadados de Amostra no Real-time MonitoringUsando o IBM Cognos Real-time Monitoring Workbench, importe os metadados deamostra.

Procedimento1. Inicie o Real-time Monitoring.2. Importe export.jar do diretório c10_location/realtime/webcontent/samples/

sdk/callcenter/CallCenterDemo/metadata usando o recurso de importação doReal-time Monitoring Workbench.Para obter mais informações sobre importação de metadados, consulte a seçãode importação de metadados no Guia do Usuário do IBM Cognos Real-timeMonitoring Workbench.

Desinstalando o Real-time Monitoring do IBM WebSphere ApplicationServer

Antes de desinstalar o IBM Cognos Real-time Monitoring, decida se é necessáriofazer backup de qualquer parte dos metadados ou bancos de dados do aplicativo.Isto é especialmente importante se você tiver arquivos keystore salvos com senhasde usuário.

Faça backup dos arquivos keystore para manter os IDs do usuário e as senhas.Execute o programa de desinstalação que foi instalado como parte do processo deinstalação. É necessário também excluir e remover a implementação manualmentedos componentes e arquivos do aplicativo Real-time Monitoring que residem emvários locais no servidor de aplicativos e no servidor da Web, como arquivos delog e diretórios.

Procedimento1. Opcionalmente, faça backup dos metadados associados ao IBM Cognos

Real-time Monitoring.2. Desinstale do IBM WebSphere Application Server.3. Execute o programa de desinstalação do IBM Cognos Real-time Monitoring.4. Desinstale o banco de dados .

40 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 49: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Fazendo Backup dos Metadados do Real-time MonitoringAntes de desinstalar, você pode desejar fazer backup dos metadados associados aoIBM Cognos Real-time Monitoring.

Para algumas atualizações, pode ser necessário restaurar um conjunto de arquivosde backup em vez de atualizar o software. Se estiver fazendo uma atualização, leiaas instruções de atualização antes de desligar e desinstalar a versão anterior. Paraobter mais informações, consulte Capítulo 5, “Fazendo Atualização de uma VersãoAnterior ou Reinstalando o Real-time Monitoring”, na página 25.

Procedimento1. Efetue login no IBM Cognos Real-time Monitoring Workbench.2. Use o recurso Exportar conforme descrito nos tópicos sobre exportação de

metadados no Guia do Usuário do IBM Cognos Real-time MonitoringWorkbench.

3. Efetue logout do IBM Cognos Real-time Monitoring Workbench.

Desinstalando do IBM WebSphere Application ServerEsta seção descreve como desinstalar o IBM Cognos Real-time Monitoring do IBMWebSphere Application Server.

Procedimento1. A partir do Console Administrativo do IBM WebSphere, desinstale o aplicativo

IBM Cognos Real-time Monitoring.2. A partir do Console Administrativo do IBM WebSphere, remova a instância do

servidor na qual o Real-time Monitoring estava sendo executado.

Executando o Programa de Desinstalação do Real-timeMonitoring

Execute o programa de desinstalação para remover o IBM Cognos Real-timeMonitoring do servidor de aplicativos ou servidor da Web, se o servidor da Webestiver instalado em um computador diferente.

Procedimento1. Inicie o desinstalador.2. Escolha o idioma para usar para o desinstalador e clique em Avançar.3. Selecione IBM Cognos Real-time Monitoring e clique em Avançar.4. Quando o desinstalador tiver concluído, clique em Concluir.

Resultados

Todos os arquivos de programas são excluídos. Os arquivos de log do Real-timeMonitoring que permanecem nos diretórios c10_location/instlog ec10_location/uninstall podem ser excluídos com segurança.

Desinstalando o Banco de DadosPara desinstalar os bancos de dados, você deve excluir as tabelas dearmazenamento de arquivos e de metadados.

Capítulo 6. Instalando o Real-time Monitoring em um IBM WebSphere Application Server 41

Page 50: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Procedimento1. Abra o diretório de log de recuperação e o diretório de ponto de verificação,

em seguida, exclua o armazenamento de arquivo *.dat andDEFAULTRECOVERYLOGGER_ *.

2. Exclua as tabelas para o banco de dados de metadados fazendo o seguinte:v Acesse o banco de dados ou o esquema do banco de dados usado para o

banco de dados de metadados do IBM Cognos Real-time Monitoring.v Exclua as tabelas para o banco de dados de metadados. As tabelas a excluir

são: METADATA_OBJECTS, ALLOCATED_UID e UNCOMMITTED_TID.3. Exclua os bancos de dados geográficos e operacionais.

42 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 51: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Capítulo 7. Instalando o Real-time Monitoring em um OracleWebLogic Application Server

Esta seção descreve como instalar e implementar o IBM Cognos Real-timeMonitoring em um Oracle WebLogic Application Server.

Instalando e Implementando o Real-time Monitoring em um OracleWebLogic Application Server

O IBM Cognos Real-time Monitoring pode ser instalado e implementado em umOracle WebLogic Application Server.

Você deverá ter executado previamente o instalador do Real-time Monitoring noservidor de aplicativos. Para obter mais informações, consulte “Instalando osComponentes do Real-time Monitoring Application Server” na página 15.

Revisando e Verificando Requisitos para o Oracle WebLogicEsta seção descreve os requisitos para implementar o IBM Cognos Real-timeMonitoring em um Oracle WebLogic Application Server.

Esta seção assume que você está familiarizado com o Oracle WebLogic. Você devesaber como fazer o seguinte:v Iniciar e parar o Oracle WebLogic Application Server.v Configurar as variáveis CLASSPATH e JAVA_HOME.v Criar uma conexão com o banco de dados Java Database Connectivity (JDBC).

Instalação do Oracle WebLogic Application ServerInstale o Oracle WebLogic Application Server suportado adequado conformeespecificado no IBM Cognos Customer Center.

Para obter mais informações, consulte “Revisando Ambientes Suportados” napágina 11.

Drivers Java Database ConnectivityInstale o driver Java Database Connectivity (JDBC) correto para seu banco dedados.

A seguir estão os diferentes bancos de dados que você pode usar para metadados,origens de dados ou tabelas de consulta.v IBM DB2v Microsoft SQL Server 2000 com SP3 ou posteriorv Microsoft SQL Server 2005v Microsoft SQL Server 2008v MySQL 5.0 ou posteriorv PostgreSQLv Oracle 9.2 ou posterior

© Copyright IBM Corp. 2003, 2014 43

Page 52: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

É possível acessar outros bancos de dados além daqueles listados acima, contantoque um Driver Tipo 4 exista para o banco de dados que você pretende usar.Entretanto, apenas os bancos de dados listados acima são certificados.

Consulte as seguintes URLs para determinar o driver de banco de dadosapropriado para seu banco de dados. Os Drivers Tipo 4 são preferenciais para oIBM Cognos Real-time Monitoring. Obtenha o driver JDBC do cliente a partir doservidor de banco de dados que você planeja acessar:v http://download-llnw.oracle.com/docs/cd//E13222_01/wls/docs91/

jdbc_drivers/index.htmlv http://download.oracle.com/docs/cd/E13222_01/wls/docs100/jdbc_drivers/

usedriver.htmv http://download.oracle.com/docs/cd//E13222_01/wls/docs103/jdbc_drivers/

index.html

Localizando Arquivos NecessáriosPara instalar e implementar com êxito o IBM Cognos Real-time Monitoring em umOracle WebLogic Application Server, você deve ter os arquivos requeridos.

É necessário o seguinte:v Um domínio disponível no Oracle WebLogic Application Server.

Este é o nome que você precisará no procedimento descrito na seção, “Criando oconjunto de conexões de metadados do Java Database Connectivity” na página49, ao identificar o Local de Domínio do BEA WebLogic.

v Realtime-weblogic.ear para Oracle WebLogic 9.x ou superior.O arquivo EAR é fornecido na mídia de instalação do IBM Cognos Real-timeMonitoring. O arquivo EAR está localizado no diretório c10_location/realtime/bin64.

Modificando as Configurações da Java Virtual MachineEsta seção descreve como modificar as configurações da Java virtual machine(JVM) editando os scripts de início. Ela supõe que você está usando um Java SEHotSpot JVM versão 1.5.

As configurações específicas pertencem à alocação da RAM. Para evitar tentativasde realocar memória, -Xms e -Xmx devem ser configurados com o mesmo valor: asquantidades mínima e máxima de memória para alocar no servidor Real-timeMonitoring. Para um servidor com 16 GB de RAM, a configuração preferencial éum mínimo de 12 GB. Geralmente, um número que é aproximadamente 3/4 dototal de RAM é preferível.

Configure -XX:NewSize e -XX:MaxNewSize com o mesmo valor. O número deve ser1/4 do tamanho escolhido para -Xms.

A tabela a seguir fornece exemplos dos valores de parâmetros a usar com base emum tamanho de memória de 16 GB e 32 GB.

Tabela 18. Exemplos de Valores de Parâmetro da JVMMemória Valor de parâmetro

16 GB -Xms12288M

-Xmx12288M

-XX:NewSize=3072M

-XX:MaxNewSize=3072M

44 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 53: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Tabela 18. Exemplos de Valores de Parâmetro da JVM (continuação)Memória Valor de parâmetro

32 GB -Xms24576M

-Xmx24576M

-XX:NewSize=6144M

-XX:MaxNewSize=6144M

Você também deve especificar as configurações da Coleção de Lixo. A entrada-XX:ParallelGCThreads deve ser igual ao número de núcleos de processadordisponíveis. Por exemplo, se houver dois processadores dual-core, insira:

-XX:ParallelGCThreads=4

Se houver 4 processadores dual-core ou 2 processadores quad-core, insira:

-XX:ParallelGCThreads=8

As configurações -verbose:gc e -Dsun.rmi.dgc.client.gcInterval são úteis nadeterminação dos problemas de coleção de lixo durante a execução. Todos devemser configurados. A última configuração deve apontar para o diretório de log, porexemplo:

-Xloggc:"c:/program files/ibm/cognos/c10_64/realtime/logs"

Se houver um espaço no caminho, será necessário colocar o parâmetro inteiro entreaspas. Use barras em vez de barras invertidas no nome do caminho.

Procedimento1. Se estiver em execução, encerre o Oracle WebLogic Application Server fazendo

o seguinte:v No Console do Oracle WebLogic Application Server, abra Servidores.v Selecione o servidor. Isto deve ser igual ao domínio do servidor criado para

esta instalação e implementação.v Na página resultante, selecione a guia Controle.v Clique em Encerramento deste Servidor.

2. Localize o script de início do Oracle WebLogic e abra-o em um editor de texto(startWebLogic.cmd no sistema operacional Microsoft Windows estartWebLogic.sh no sistema operacional UNIX).Para o Oracle WebLogic Server 9.x ou superior, o script inicial está nodiretório <domain_home>/bin.

3. Para incluir os arquivos obiProperties.jar e log4j-1.2.7.jar, que estão localizadosno diretório c10_location/realtime/bin64/, no arquivo startWebLogic.cmd ouno arquivo startWebLogic.sh, configure o seguinte nas configurações decaminho de classe.v Em um servidor que está executando o sistema operacional Microsoft

Windows:set CLASSPATH=c:/program files/ibm/cognos/c10_64/realtime/bin64/obiProperties.jar;c:/program files/ibm/cognos/c10_64/realtime/bin64/log4j-1.2.7.jar;%CLASSPATH%

v Em um servidor que está executando o sistema operacional AIX, Solaris ouLinux:

Capítulo 7. Instalando o Real-time Monitoring em um Oracle WebLogic Application Server 45

Page 54: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

CLASSPATH=/opt/ibm/cognos/c10_64/realtime/bin64/obiProperties.jar:/opt/ibm/cognos/c10_64/realtime/bin64/log4j-1.2.7.jar:$CLASSPATH

4. Localize e modifique a configuração JAVA_HOME para o diretório de seudiretório inicial JAVA JDK e certifique-se de que a versão modificadas apontepara o local atual do JDK do Java SE HotSpot.v A configuração padrão é JRockit.v A configuração recomendada é para o JDK do Java SE HotSpot.

5. Configure os parâmetros da JVM para obter a memória e a coleção de lixo(GC) ideais. Parâmetros da JVM de amostra para execução do Real-timeMonitoring são recomendados conforme a seguir (para o Java SE HotSpotJVM versão 1.5):-server

-Xms24576M

-Xmx24576M

-XX:NewSize=6144M

-XX:MaxNewSize=6144M

-XX:PermSize=256M

-XX:MaxPermSize=256M

-XX:ThreadStackSize=300

-XX:MaxTenuringThreshold=0

-XX:SurvivorRatio=128

-XX:+UseTLAB

-verbose:gc

-Dsun.rmi.dgc.client.gcInterval=600000

-Xloggc:<location of the GC logs>

-XX:-UsePerfData

-XX:+PrintVMOptions

-XX:+TraceClassUnloading

-XX:+DisableExplicitGC

-XX:+CMSParallelRemarkEnabled

-XX:+PrintGCDetails

-XX:+PrintGCTimeStamps

-XX:+UseParNewGC

-XX:+UseConcMarkSweepGC

-XX:ParallelGCThreads=<number of cpus>

-XX:CMSMarkStackSize=8M

-XX:CMSMarkStackSizeMax=32M

-XX:+UseCMSCompactAtFullCollection

-XX:CMSFullGCsBeforeCompaction=0

-XX:+ParallelRefProcEnabled

-XX:+CMSClassUnloadingEnabled

-XX:+CMSPermGenSweepingEnabled

-XX:+CMSIncrementalMode

-XX:+CMSIncrementalPacing

-XX:CMSIncrementalDutyCycleMin=0

-XX:CMSIncrementalDutyCycle=10

-XX:+UseCMSInitiatingOccupancyOnly

6. Certifique-se de que JAVA_OPTIONS para a propriedadecom.cognos.obi.bootstrap.envpropname esteja configurado como BOOTPROPSe a propriedade JVM BOOTPROPS aponte para o arquivo realtime.propertieseditado durante sua preparação para instalação, conforme descrito em“Configurando Propriedades de Sistema Durante a Inicialização” na página18.v Em um servidor que está executando o sistema operacional Microsoft

Windows:set JAVA_OPTIONS=%JAVA_OPTIONS% "-DBOOTPROPS=<bootstrap_file>"

set JAVA_OPTIONS=%JAVA_OPTIONS%"-Dcom.cognos.obi.bootstrap.envpropname=BOOTPROPS"

46 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 55: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Em que <bootstrap_file> especifica o local do arquivo realtime.propertiesque contém as propriedades de autoinicialização.

v Em um servidor que está executando o sistema operacional AIX, Solaris ouLinux:JAVA_OPTIONS="$JAVA_OPTIONS -DBOOTPROPS=<bootstrap_file>"

JAVA_OPTIONS="$JAVA_OPTIONS-Dcom.cognos.obi.bootstrap.envpropname=BOOTPROPS"

Em que <bootstrap_file> especifica o local do arquivo realtime.propertiesque contém as propriedades de autoinicialização.

7. Configure o tipo de codificação de arquivo como UTF8.v Em um servidor que está executando o sistema operacional Microsoft

Windows:set JAVA_OPTIONS=%JAVA_OPTIONS% "-Dfile.encoding=utf8"

v Em um servidor que está executando o sistema operacional AIX, Solaris ouLinux:JAVA_OPTIONS="$JAVA_OPTIONS -Dfile.encoding=utf8"

8. Opcionalmente, configure a propriedade anonymousaccessenabled como truepara ativar o login anônimo. Configure esta propriedade como false paradesativar o login anônimo. Quando esta propriedade é ativada, a tela de loginmostra o link Efetuar Login como Usuário Anônimo.v Em um servidor que está executando o sistema operacional Microsoft

Windows:set JAVA_OPTIONS=%JAVA_OPTIONS% "-Danonymousaccessenabled=true"

v Em um servidor que está executando o sistema operacional AIX, Solaris ouLinux:JAVA_OPTIONS="$JAVA_OPTIONS -Danonymousaccessenabled=true"

Com um login anônimo ativado, é possível efetuar login automaticamente noIBM Cognos Real-time Monitoring Dashboard ou no IBM Cognos Real-timeMonitoring Workbench sem especificar um nome de usuário ou senha, usandoa URL:http://servername/cognos/realtime/landing/landingpage.htmIsso permite escolher o aplicativo.

9. Opcionalmente, se as conexões http de saída, tais como serviços da Web ouserviços de codificação geográfica, forem necessárias para percorrer umservidor proxy a partir de seus ambiente do servidor, inclua a seguintepropriedade JVM no script de inicialização para que a camada deconectividade Java use o servidor proxy para todas as chamadas de saída.v Em um servidor que está executando o sistema operacional Microsoft

Windows:set JAVA_OPTIONS=%JAVA_OPTIONS% "-Dhttp.proxyHost=<fully qualifiedserver name of http proxy>"

set JAVA_OPTIONS=%JAVA_OPTIONS% "-Dhttp.proxyPort=<http proxy portnumber>"

set JAVA_OPTIONS=%JAVA_OPTIONS% "-Dhttps.proxyHost=<fully qualifiedserver name of https proxy>"

set JAVA_OPTIONS=%JAVA_OPTIONS% "-Dhttps.proxyPort=<https proxyserver port>"

v Em um servidor que está executando o sistema operacional AIX, Solaris ouLinux:

Capítulo 7. Instalando o Real-time Monitoring em um Oracle WebLogic Application Server 47

Page 56: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

JAVA_OPTIONS="$JAVA_OPTIONS -Dhttp.proxyHost=<fully qualified servername of http proxy>"

JAVA_OPTIONS="$JAVA_OPTIONS -Dhttp.proxyPort=<http proxy portnumber>"

JAVA_OPTIONS="$JAVA_OPTIONS -Dhttps.proxyHost=<fully qualified servername of https proxy>"

JAVA_OPTIONS="$JAVA_OPTIONS -Dhttps.proxyPort=<https proxy serverport>"

Nota: Servidores proxy que requeiram autenticação não são suportados.10. Opcionalmente, configure os parâmetros de idioma e código de idioma como

descrito em “Configurando os Parâmetros de Idioma e Código de Idioma emum Oracle WebLogic Application Server”.É necessário executar esta etapa apenas se desejar inicializar o metadados emum código do idioma diferente do código do idioma do servidor padrão.

11. Salve e feche o arquivo de script de início.

Configurando os Parâmetros de Idioma e Código de Idioma emum Oracle WebLogic Application ServerÉ possível configurar parâmetros opcionais para o banco de dados de metadados,incluindo idioma, país ou região e força de ordenação.

Os padrões são baseados nas configurações do código de idioma do servidor.Configure estes padrões antes de iniciar o servidor de aplicativos pela primeiravez. Estes parâmetros são incluídos no script de início para o servidor deaplicativos e usam o seguinte formato básico:

-Dcom.cognos.obi.property.[PARAMETER]=[VALUE]

Cada parâmetro é descrito na tabela abaixo. Esta tabela é seguida porprocedimentos específicos para configurar os parâmetros na configuração doservidor de aplicativos.

Tabela 19. Configurações de Parâmetros Opcionais para o Banco de Dados de MetadadosOracle WebLogic Application ServerParâmetro Descrição

LOCALE_LANGUAGE O código de idioma ISO de dois caracteres para o servidor.

Por exemplo, para configurar o parâmetro LANGUAGE como Português, vocêincluiria o seguinte comando:

Em um servidor que está executando o sistema operacional Microsoft Windows:

set JAVA_OPTIONS=%JAVA_OPTIONS%"-Dcom.cognos.obi.property.LOCALE_LANGUAGE=PT"

Em um servidor que está executando o sistema operacional AIX, Solaris ou Linux:

JAVA_OPTIONS="$JAVA_OPTIONS -Dcom.cognos.obi.property.LOCALE_LANGUAGE=PT"

LOCALE_REGION O código ISO de dois caracteres para país ou região para o servidor.

Por exemplo, para configurar o país ou a região como Brasil, seria incluído oseguinte comando:

Em um servidor que está executando o sistema operacional Microsoft Windows:

set JAVA_OPTIONS=%JAVA_OPTIONS% "-Dcom.cognos.obi.property.LOCALE_REGION=BR"

Em um servidor que está executando o sistema operacional AIX, Solaris ou Linux:

JAVA_OPTIONS="$JAVA_OPTIONS -Dcom.cognos.obi.property.LOCALE_REGION=BR"

48 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 57: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Tabela 19. Configurações de Parâmetros Opcionais para o Banco de Dados de MetadadosOracle WebLogic Application Server (continuação)Parâmetro Descrição

LOCALE_COLLATION Configure como true ou false para indicar se deve executar comparações desequência sensíveis ao código do idioma. (O padrão é false.)

COLLATE_STRENGTH Especifica o nível de força de ordenação; ou seja, a extensão na qual os caracteresnão em inglês são comparados e ordenados: primário, secundário, terciário ouidêntico. Primário é o menos distintivo; idêntico é o mais distintivo. (O padrão éterciário.) Para obter mais informações sobre parâmetros de ordenação, consulte adocumentação do Java em:

http://download.oracle.com/javase/1.5.0/docs/api/java/util/Locale.html.Nota: Esta configuração é funcional apenas se LOCALE_COLLATION estiverconfigurado como true.

COLLATE_DECOMPOSITION Especifica um dos seguintes modos de decomposição de ordenação: nenhum,canônico ou integral. (O padrão é canônico.) Para obter mais informações sobreparâmetros de ordenação, consulte a documentação do Java em:http://download.oracle.com/javase/1.5.0/docs/api/java/util/Locale.html.Nota: Esta configuração é funcional apenas se LOCALE_COLLATION estiverconfigurado como true.

Procedimento1. Localize a variável de ambiente JAVA_OPTIONS no arquivo startWebLogic.cmd

ou startWebLogic.sh.2. Inclua as configurações de parâmetro usando a seguinte sintaxe:

com.cognos.obi.property.[PARAMETER]=[VALUE]

Nota: Delimite configurações diversas com um espaço. Prefixe cadaconfiguração com o comando -D.

3. Salve e feche o script de execução.

Criando e Configurando a Conexão de MetadadosEsta seção descreve como criar o conjunto de conexões Java Database Connectivity(JDBC) e a origem de dados de metadados necessários no BEA WebLogic Console.

Configurando o Oracle WebLogic 9.x e PosteriorPara Oracle WebLogic 9.x ou posterior, há apenas uma etapa: criar a origem dedados juntamente com as configurações do conjunto de conexões.

Consulte as seguintes URLs para o procedimento Oracle WebLogic para configurara origem de dados de metadados com configurações do conjunto de conexões:v Para o Oracle WebLogic 9.2 acesse

http://download.oracle.com/docs/cd/E13222_01/wls/docs92/ConsoleHelp/taskhelp/jdbc/jdbc_datasources/CreateDataSources.html

v Para o Oracle WebLogic 10gR3 acessehttp://download.oracle.com/docs/cd/E12840_01/wls/docs103/ConsoleHelp/taskhelp/jdbc/jdbc_datasources/CreateDataSources.html

Criando o conjunto de conexões de metadados do Java Database Connectivity:

Esta seção descreve as configurações necessárias para criar o conjunto de conexõesde metadados do Java Database Connectivity (JDBC) necessário no BEA WebLogicConsole.

Consulte a seguinte URL para o procedimento do Oracle WebLogic para configuraro conjunto de conexões de metadados:

Capítulo 7. Instalando o Real-time Monitoring em um Oracle WebLogic Application Server 49

Page 58: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

http://download.oracle.com/docs/cd/E13222_01/wls/docs92/index.html

Procedimento

1. Selecione um dos bancos de dados suportados pelo IBM Cognos Real-timeMonitoring.v DB2v Microsoft SQL Serverv MySQLv PostgreSQLv OracleQuando você selecionar um tipo de banco de dados, o campo de driver debanco de dados exibe dinamicamente as opções de driver para o banco dedados selecionado.

2. Selecione o driver no campo do driver de banco de dados.v Para DB2, selecione Driver DB2 da IBM (Tipo 2) ou Driver DB2 da IBM (Tipo

4), conforme apropriado.v Para Microsoft SQL Server 2000 e 2005, selecione Driver Microsoft SQL

Server Driver do Oracle WebLogic (Tipo 4).v Para Microsoft SQL Server 2008, escolha o driver como Outros e especifique

o caminho de classe para sqljdbc4.jar e as credenciais para conectar-se aoSQL Server 2008.

v Para MySQL, selecione Versão do Driver do MySQL (Tipo 4); Usandocom.mysql.jdbc.Driver.

v Para PostgreSQL, selecione Versão do Driver PostgreSQL (Tipo 4).v Para o Oracle thin client, selecione Driver (Thin) Oracle versões 9.0.1, 9.2.0,

10, 11 (apenas Oracle WebLogic 10gR3).v Para cliente Oracle thick (OCI), selecione Driver do Oracle (OCI) versões

9.0.1, 9.2.0, 10, 11 (apenas Oracle WebLogic 10gR3).

Resultados

Após a implementação, você deve modificar a configuração de conexão, conformedescrito em “Aumentando a capacidade máxima do conjunto de conexões demetadados Java Database Connectivity” na página 51.

Criando a Conexão de Metadados:

Esta seção descreve as configurações necessárias para criar a origem de dados demetadados JDBC necessária no BEA WebLogic Console.

Consulte a seguinte URL para o procedimento do Oracle WebLogic para configurara origem de dados de metadados:

http://download.oracle.com/docs/cd/E13222_01/wls/docs92/index.html

Procedimento

1. Para o valor de Nome, insira com.cognos.obi.metadata.metaDatasource.2. Para o Nome da JNDI, insira com.cognos.obi.metadata.metaDatasource.3. Limpe a caixa de seleção Suportar Transações Globais.

50 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 59: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

4. Para Nome do Conjunto, selecione o nome do conjunto de conexões que vocêcriou no procedimento descrito em “Criando o conjunto de conexões demetadados do Java Database Connectivity” na página 49.

Aumentando a capacidade máxima do conjunto de conexões demetadados Java Database ConnectivityApós implementar o conjunto de conexões configurado, você deve modificar aconfiguração de conexão aumentando a capacidade máxima.

Procedimento1. Nas configurações do conjunto de conexões de metadados do Java Database

Connectivity (JDBC), altere a configuração de Capacidade Máxima para 20.

Nota: É possível aceitar os padrões para as configurações restantes.2. Na seção Opções Avançadas, clique em Mostrar.3. Marque Testar Conexões Reservadas.4. Salve suas configurações.5. Teste o conjunto de conexões e certifique-se de que o teste seja concluído com

êxito.O conjunto de conexões JDBC agora foi concluído com êxito.

Definindo Origens de Dados no WebLogicPara a instalação, você deve definir as duas origens de dados a seguir: uma origemde dados para mapas geográficos e uma origem de dados operacional.

Opcionalmente, é possível definir origens de dados para agentes Java DatabaseConnectivity (JDBC).

Definindo a Origem de Dados para Mapas Geográficos paraReal-time Monitoring em um Oracle WebLogic Application ServerÉ necessário definir uma origem de dados geográfica para mapas geográficos.

Para configurar o suporte para mapas geográficos, siga as etapas para a criação deuma origem de dados com o Oracle WebLogic Application Server Consoleconforme descrito na seção, “Criando e Configurando a Conexão de Metadados”na página 49. Entretanto, você deve especificar o nome e o nome da Java Namingand Directory Interface (JNDI) como com.cognos.obi.geo.geoDatasource.

Definindo uma Origem de Dados Operacional para Real-timeMonitoring em um Oracle WebLogic Application ServerUma origem de dados operacional é um repositório de banco de dados que vocêusa para armazenar e persistir os dados da consulta.

Para configurar sua origem de dados operacional, siga as mesmas etapas que paracriar uma origem de metadados. Entretanto, você deve especificar o nome e onome da Java Naming and Directory Interface (JNDI) comocom.cognos.obi.operational. Para criar uma origem de dados, siga o procedimentodescrito em “Criando e Configurando a Conexão de Metadados” na página 49

Capítulo 7. Instalando o Real-time Monitoring em um Oracle WebLogic Application Server 51

Page 60: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Definindo Origens de Dados Opcionais Adicionais para Real-timeMonitoring em um Oracle WebLogic Application ServerPara cada agente Java Database Connectivity (JDBC) (por exemplo, para acessar ofluxo de dados ou os dados da tabela de consulta) que você cria no IBM CognosReal-time Monitoring Workbench, você deve criar uma origem de dados nainstalação do Oracle WebLogic.

O uso da Java Naming and Directory Interface (JNDI) com Conjuntos de Conexõesé a maneira preferível para se conectar às origens de dados JDBC. O nome TheJNDI especificado aqui é usado no Real-time Monitoring Workbench naconfiguração de um Agente JDBC. Se um driver do Conjunto de Conexões nãoestiver disponível, uma alternativa seria especificar uma conexão baseada em URLno Real-time Monitoring Workbench. O nome da Java Naming and DirectoryInterface (JNDI) deve ser exclusivo para cada origem de dados. Para criar umaorigem de dados, siga o procedimento descrito em “Criando e Configurando aConexão de Metadados” na página 49.

Implementando o Real-time Monitoring em um OracleWebLogic Application Server

Esta seção descreve o processo de implementação do IBM Cognos Real-timeMonitoring em um Oracle WebLogic Application Server.

Procedimento1. Consulte a seguinte URL para obter instruções sobre como implementar o

arquivo EAR.Para o Oracle WebLogic 9.2, consultehttp://download.oracle.com/docs/cd/E13222_01/wls/docs92/ConsoleHelp/taskhelp/deployment/InstallApplicationsAndModules.html.Para Oracle WebLogic 10gR3, consulte http://download.oracle.com/docs/cd/E13222_01/wls/docs103/ConsoleHelp/taskhelp/deployment/InstallApplicationsAndModules.html

2. Durante a implementação, navegue para o Realtime-weblogic.ear na mídia deinstalação do IBM Cognos Real-time Monitoring. Este é o arquivo EAR que seráimplementado no Oracle WebLogic Application Server.Para confirmar a implementação, abra um navegador da Web e acesse oseguinte Web site:http://<host>:<port>/realtime/Controller/RequestInfoAction/ListInfoPor exemplo:http://localhost:7001/realtime/Controller/RequestInfoAction/ListInfo

Resultados

Após ter confirmado a implementação, configure seu servidor da Web para tratar oconteúdo estático. Para obter informações sobre como configurar conteúdosestáticos, consulte Capítulo 9, “Instalando, Configurando e Desinstalando Arquivosdo Servidor da Web Real-time Monitoring”, na página 73.

52 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 61: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Testando o Real-time Monitoring Após a Instalação no OracleWebLogic Application Server

Após instalar o IBM Cognos Real-time Monitoring no servidor de aplicativos e noservidor da Web, você pode testar sua instalação instalando e usando as amostrasque são fornecidas com o produto.

Procedimento1. Valide se os conteúdos estático e dinâmico estão configurados corretamente .

Consulte o “Verificando a Configuração para o Conteúdo Estático e Dinâmico”na página 80.

2. Opcionalmente, carregue as amostras . Consulte o “Carregando Amostras doReal-time Monitoring no Oracle WebLogic Application Server”.

3. Inicie o Real-time Monitoring Workbench e importe os metadados de amostra .Consulte o “Importando Metadados de Amostra no Real-time Monitoring” napágina 54.

Carregando Amostras do Real-time Monitoring no OracleWebLogic Application Server

Carregue os dados para verificar se o aplicativo está funcionando.

O diretório c10_location/realtime/webcontent/samples/sdk/callcenter/CallCenterDemo/data contém o esquema do banco de dados Derby que terá astabelas, os dados e os acionadores demo da central de atendimento. Esta demorequer o driver Apache Derby 10.5.3. Para obter informações sobre como fazer odownload do Apache Derby, consulte:

http://db.apache.org/derby/derby_downloads.html

O diretório c10_location/realtime/webcontent/samples/sdk/callcenter/CallCenterDemo/metadata contém uma exportação do modelo de objeto usadopara a demo da central de atendimento, ele é independente do banco de dados.

Procedimento1. Localize os arquivos de amostra no diretório c10_location/realtime/webcontent/

samples/sdk.2. Crie o diretório /derby/databases no diretório WebLogic install

location/wlserver_version number/.3. Copie o banco de dados c10_location/realtime/webcontent/samples/sdk/

callcenter/CallCenterDemo/data/ccdemo no seguinte diretório no OracleWebLogic Application ServerWebLogic install location/wlserver_version number/derby/databases

4. Copie o arquivo derby.jar transferido por download do site de suporte daApache para o diretório /derby/databases, assim como o diretório WebLogicinstall location/wlserver_version number/derby/databases.

5. Usando o BEA WebLogic Console, crie uma origem de dados com as seguintespropriedades gerais.

Tabela 20. Propriedades de Origem de Dados de Amostras do Real-time Monitoring noOracle WebLogic Application ServerPropriedade Geral Configurando

Nome com.cognos.obi.demo.ccdemo

Nome da JNDI com.cognos.obi.demo.ccdemo

Capítulo 7. Instalando o Real-time Monitoring em um Oracle WebLogic Application Server 53

Page 62: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Tabela 20. Propriedades de Origem de Dados de Amostras do Real-time Monitoring noOracle WebLogic Application Server (continuação)Propriedade Geral Configurando

Tipo de banco de dados Provedor JDBC Derby

Nome do Banco de Dados WebLogic install location/wlserver_version number/derby/databases/ccdemo

Assegure que você selecionou Auxiliar de Armazenamento de Dados Derbycomo a classe auxiliar de armazenamento de dados.

6. Teste a conexão e salve seu trabalho.

Resultados

Após preparar as origens de dados de amostra, é possível importar os metadadosde amostra.

Importando Metadados de Amostra no Real-time MonitoringUsando o IBM Cognos Real-time Monitoring Workbench, importe os metadados deamostra.

Procedimento1. Inicie o Real-time Monitoring.2. Importe export.jar do diretório c10_location/realtime/webcontent/samples/

sdk/callcenter/CallCenterDemo/metadata usando o recurso de importação doReal-time Monitoring Workbench.Para obter mais informações sobre importação de metadados, consulte a seçãode importação de metadados no Guia do Usuário do IBM Cognos Real-timeMonitoring Workbench.

Desinstalando o Real-time Monitoring do Oracle WebLogic ApplicationServer

Antes de desinstalar o IBM Cognos Real-time Monitoring, decida se é necessáriofazer backup de qualquer parte dos metadados ou bancos de dados do aplicativo.Isto é especialmente importante se você tiver arquivos keystore salvos com senhasde usuário.

Faça backup dos arquivos keystore para manter os IDs do usuário e as senhas.Execute o programa de desinstalação que foi instalado como parte do processo deinstalação. Também é necessário excluir e remover manualmente a implementaçãodos componentes e arquivos do aplicativo Real-time Monitoring que residem emvários locais no servidor de aplicativos e no servidor da Web, como arquivos delog e diretórios.

Procedimento1. Opcionalmente, faça backup dos metadados associados ao IBM Cognos

Real-time Monitoring.2. Desinstale do Oracle WebLogic Application Server .3. Execute o programa de desinstalação do IBM Cognos Real-time Monitoring.4. Desinstale o banco de dados .

Fazendo Backup dos Metadados do Real-time MonitoringAntes de desinstalar, você pode desejar fazer backup dos metadados associados aoIBM Cognos Real-time Monitoring.

54 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 63: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Para algumas atualizações, pode ser necessário restaurar um conjunto de arquivosde backup em vez de atualizar o software. Se estiver fazendo uma atualização, leiaas instruções de atualização antes de desligar e desinstalar a versão anterior. Paraobter mais informações, consulte Capítulo 5, “Fazendo Atualização de uma VersãoAnterior ou Reinstalando o Real-time Monitoring”, na página 25.

Procedimento1. Efetue login no IBM Cognos Real-time Monitoring Workbench.2. Use o recurso Exportar conforme descrito na seção sobre exportação de

metadados no Guia do Usuário do IBM Cognos Real-time MonitoringWorkbench.

3. Efetue logout do IBM Cognos Real-time Monitoring Workbench.

Desinstalando do Oracle WebLogic Application ServerEsta seção descreve como desinstalar o IBM Cognos Real-time Monitoring doOracle WebLogic Application Server.

Procedimento1. Inicie o Oracle WebLogic Application Server se ele ainda não estiver em

execução.2. A partir do Console Administrativo do Oracle WebLogic acesse Aplicativos e

remova a implementação do aplicativo IBM Cognos Real-time Monitoring.

Executando o Programa de Desinstalação do Real-timeMonitoring

Execute o programa de desinstalação para remover o IBM Cognos Real-timeMonitoring do servidor de aplicativos ou servidor da Web, se o servidor da Webestiver instalado em um computador diferente.

Procedimento1. Inicie o desinstalador.2. Escolha o idioma para usar para o desinstalador e clique em Avançar.3. Selecione IBM Cognos Real-time Monitoring e clique em Avançar.4. Quando o desinstalador tiver concluído, clique em Concluir.

Resultados

Todos os arquivos de programas são excluídos. Os arquivos de log do Real-timeMonitoring que permanecem nos diretórios c10_location/instlog ec10_location/uninstall podem ser excluídos com segurança.

Desinstalando o Banco de DadosPara desinstalar os bancos de dados, você deve excluir as tabelas dearmazenamento de arquivos e de metadados.

Procedimento1. Abra o diretório de log de recuperação e o diretório de ponto de verificação,

em seguida, exclua o armazenamento de arquivo *.dat andDEFAULTRECOVERYLOGGER_ *.

2. Exclua as tabelas para o banco de dados de metadados fazendo o seguinte:

Capítulo 7. Instalando o Real-time Monitoring em um Oracle WebLogic Application Server 55

Page 64: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

v Acesse o banco de dados ou o esquema do banco de dados usado para obanco de dados de metadados do IBM Cognos Real-time Monitoring.

v Exclua as tabelas para o banco de dados de metadados. As tabelas a excluirsão: METADATA_OBJECTS, ALLOCATED_UID e UNCOMMITTED_TID.

56 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 65: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Capítulo 8. Instalando o Real-time Monitoring em um JBossApplication Server

Esta seção descreve como instalar e implementar o IBM Cognos Real-timeMonitoring em um JBoss Application Server.

Instalando e Implementando o Real-time Monitoring em um JBossApplication Server

O IBM Cognos Real-time Monitoring pode ser instalado e implementado em umJBoss Application Server.

Antes de Iniciar

Você deverá ter executado previamente o instalador do Real-time Monitoring noservidor de aplicativos. Para obter mais informações, consulte “Instalando osComponentes do Real-time Monitoring Application Server” na página 15.

Procedimento1. Revise e verifique os requisitos .2. Modifique as configurações da Java virtual machine (JVM).3. Opcionalmente, configure parâmetros de metadados .4. Crie e configure a conexão de metadados .5. Defina outras origens de dados obrigatórias e opcionais .6. Implemente o Deploy Real-time Monitoring em um JBoss Application Server .7. Revise as considerações para a execução do Real-time Monitoring em uma

instância do JBoss Application Server .

Revisando e Verificando os Requisitos para Real-timeMonitoring em um JBoss Application Server

Esta seção descreve os requisitos para instalar e implementar o IBM CognosReal-time Monitoring em um JBoss Application Server.

Esta seção supõe que você esteja familiarizado com o JBoss Application Server.Especificamente, é necessário saber como fazer o seguinte:v Iniciar e parar o JBoss Application Server.v Configurar as variáveis CLASSPATH e JAVA_OPTS.v Criar e configurar a conexão de metadados.

Instalação do JBoss Application ServerVerifique a planilha de dados para o JBoss Enterprise Application Platform antesde instalar o servidor de aplicativos.

É possível obter a planilha de dados em

http://www.jboss.com/pdf/jb_ent_app_platform_04_07.pdf

© Copyright IBM Corp. 2003, 2014 57

Page 66: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Instale o JBoss Application Server adequado, suportado conforme especificado noIBM Cognos Customer Center. Para obter mais informações, consulte “RevisandoAmbientes Suportados” na página 11.

Drivers Java Database ConnectivityEsta seção descreve como instalar o driver Java Database Connectivity (JDBC)correto para seus metadados.

Para obter mais informações, consulte “Criando e Configurando a Conexão deMetadados” na página 64. A tabela a seguir lista os arquivos do driver JDBC paraos diferentes bancos de dados que você pode usar para tabelas de metadados. OIBM Cognos Real-time Monitoring funciona com qualquer banco de dados com umDriver Tipo 4, entretanto, apenas os bancos de dados listados abaixo sãosuportados.

Tabela 21. Arquivos de Driver JDBC Suportados para Bancos de Dados de MetadadosBancos de Dados de Metadados Driver JDBC

DB2 8.2 db2jcc.jar

db2jcc_license_cu.jar

Oracle 9.2 ou posterior Driver thin Oracle (ojdbc14.jar)

ojdbc6.jar (Para Oracle 11g. Funciona apenas com JDK1.6)

Driver thick Oracle (OCI)Nota: Você deve usar o driver JDBC Oracle 10G para ambas as configurações.

Microsoft SQL Server 2008 sqljdbc.jar (Funciona apenas com JDK 1.5.)

sqljdbc4.jar (Funciona apenas com JDK 1.6.)

Microsoft SQL Server 2005 sqljdbc.jarNota: Você deve certificar-se de que os drivers versão 2000 não estejam no caminhode classe.

Microsoft SQL Server 2000 sqljdbc.jar

Ou um dos seguintes drivers: mssqlserver.jar, msbase.jar ou msutil.jarNota: O driver sqljdbc.jar é compatível com versões anteriores às versões 2000.

MySQL 5.0 ou posterior mysql-connector-java-[version]-bin.jar

PostgreSQL postgresql-[version].jdbc3.jar

Há um problema existente no Microsoft com o driver sqljdbc.jar, que é endereçadono artigo 917054 da Base de Conhecimento da Microsoft.

O driver sqljdbc.jar é compatível com versões anteriores à versão 2000. Entretanto,se você usar o driver 2005 (sqljdbc.jar), deverá certificar-se de que os drivers versão2000 não estejam no caminho de classe.

Modificando as Configurações da Java Virtual MachineEsta seção descreve como modificar as configurações da Java virtual machine(JVM) editando os scripts de início. Ela supõe que você está usando um Java SEHotSpot JVM versão 1.5.

As configurações específicas pertencem à alocação da RAM. Para evitar tentativasde realocar memória, -Xms e -Xmx devem ser configurados com o mesmo valor: asquantidades mínima e máxima de memória para alocar no servidor Real-time

58 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 67: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Monitoring. Para um servidor com 16 GB de RAM, a configuração preferencial éum mínimo de 12 GB. Geralmente, um número que é aproximadamente 3/4 dototal de RAM é preferível.

Configure -XX:NewSize e -XX:MaxNewSize com o mesmo valor. O número deve ser1/4 do tamanho escolhido para -Xms.

A tabela a seguir fornece exemplos dos valores de parâmetros a usar com base emum tamanho de memória de 16 GB e 32 GB.

Tabela 22. Exemplos de Valores de Parâmetro da JVMMemória Valor de parâmetro

16 GB -Xms12288M

-Xmx12288M

-XX:NewSize=3072M

-XX:MaxNewSize=3072M

32 GB -Xms24576M

-Xmx24576M

-XX:NewSize=6144M

-XX:MaxNewSize=6144M

Você também deve especificar as configurações da Coleção de Lixo. A entrada-XX:ParallelGCThreads deve ser igual ao número de núcleos de processadordisponíveis. Por exemplo, se houver dois processadores dual-core, insira:

-XX:ParallelGCThreads=4

Se houver 4 processadores dual-core ou 2 processadores quad-core, insira:

-XX:ParallelGCThreads=8

As configurações -verbose:gc e -Dsun.rmi.dgc.client.gcInterval são úteis nadeterminação dos problemas de coleção de lixo durante a execução. Todos devemser configurados. A última configuração deve apontar para o diretório de log, porexemplo:

-Xloggc:"c:/program files/ibm/cognos/c10_64/realtime/logs"

Se houver um espaço no caminho, será necessário colocar o parâmetro inteiro entreaspas. Use barras em vez de barras invertidas no nome do caminho.

Procedimento1. Se o JBoss Application Server já estiver em execução, encerre o servidor.2. Localize e abra o script de execução que inicia o JBoss Application Server. Este

arquivo está localizado em:...\%JBOSS_HOME%\bin\run.bat (em um servidor executando o sistemaoperacional Microsoft Windows).../$JBOSS_HOME/bin/run.sh (em um servidor que está executando o sistemaoperacional UNIX)

Capítulo 8. Instalando o Real-time Monitoring em um JBoss Application Server 59

Page 68: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

3. Para incluir o arquivo obiProperties.jar, localizado no diretórioc10_location/realtime/bin64/, edite o arquivo run.bat ou run.sh para definir oseguinte nas configurações de caminho de classe.v Em um servidor que está executando o sistema operacional Microsoft

Windows:set JBOSS_CLASSPATH=%JBOSS_CLASSPATH%;C:/Progra~1/ibm/cognos/c10_64/realtime/bin64/obiProperties.jar

v Em um servidor que está executando o sistema operacional AIX, Solaris ouLinux:JBOSS_CLASSPATH=$JBOSS_CLASSPATH:/opt/ibm/cognos/c10_64/realtime/bin64/obiProperties.jar

4. Configure as variáveis de ambiente. (Para um servidor que está executando osistema operacional AIX, Linux, ou Solaris use o JDK. O JRE é insuficiente.)v Em um servidor que está executando o sistema operacional Microsoft

Windows:Crie uma variável de ambiente denominada JAVA_HOME, essa variávelaponta para o diretório de instalação do JDK. Por exemplo:C:\Program Files\Java\jdk1.5.0_14\Para executar Java a partir da linha de comandos, inclua o diretório jre\binem seu caminho. Por exemplo:C:\Program Files\Java\jdk1.5.0_14\jre\binPara criar a variável de ambiente, abra o Painel de Controle a partir domenu Iniciar (alterne para a Visualização Clássica, se necessário), emseguida, abra o applet do Sistema. Selecione a guia Avançado e clique nobotão Variáveis de Ambiente. Clique no Novo Botão em Variáveis doSistema para criar a variável JAVA_HOME.

v Em um servidor que está executando o sistema operacional AIX, Solaris ouLinux:Crie uma variável de ambiente denominada JAVA_HOME que aponte parao diretório de instalação de JDK. Inclua $JAVA_HOME/bin no caminho dosistema para poder executar Java a partir da linha de comandos. Porexemplo, no Linux com shell bash, é possível fazer isto incluindo asseguintes linhas no arquivo .bashrc em seu diretório inicial:export JAVA_HOME=<jdk_directory>

export PATH=$PATH:$JAVA_HOME/bin

Em que <jdk_directory> é o diretório de instalação de JDK (por exemplo,/usr/java/jdk1.6.0_07). Será necessário escolher o JDK adequado com baseem sua versão do JBoss Application Server.

Para obter informações adicionais sobre os pré-requisitos para o JBossApplication Server, consulte o seguinte:v http://www.jboss.org/file-access/default/members/jbossas/freezone/

docs/Installation_Guide/4/pdf/Installation_Guide.pdfv http://www.jboss.org/file-access/default/members/jbossas/freezone/

docs/Installation_Guide/beta500/html-single/index.html#Pre_Requisites-Configuring_Your_Java_Environment

5. Certifique-se de que JAVA_OPTS para a propriedadecom.cognos.obi.bootstrap.envpropname esteja configurado como BOOTPROPSe que a propriedade JVM BOOTPROPS aponte para o arquivorealtime.properties editado durante sua preparação para instalação, conformedescrito em “Configurando Propriedades de Sistema Durante a Inicialização”na página 18

60 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 69: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

v Em um servidor que está executando o sistema operacional MicrosoftWindows:set JAVA_OPTS=%JAVA_OPTS% "-DBOOTPROPS=<bootstrap_file>"

set JAVA_OPTS=%JAVA_OPTS%"-Dcom.cognos.obi.bootstrap.envpropname=BOOTPROPS"

Em que <bootstrap_file> especifica o local do arquivo realtime.propertiesque contém as propriedades de autoinicialização.

v Em um servidor que está executando o sistema operacional AIX, Solaris ouLinux:JAVA_OPTS="$JAVA_OPTS -DBOOTPROPS=<bootstrap_file>"

JAVA_OPTS="$JAVA_OPTS-Dcom.cognos.obi.bootstrap.envpropname=BOOTPROPS"

Em que <bootstrap_file> especifica o local do arquivo realtime.propertiesque contém as propriedades de autoinicialização.

6. Configure o tipo de codificação do arquivo como UTF8 conforme mostradonos exemplos a seguir:A seguir são mostrados exemplos para cada sistema operacional:v Em um servidor que está executando o sistema operacional Microsoft

Windows:set JAVA_OPTS=%JAVA_OPTS% "-Dfile.encoding=utf8"

v Em um servidor que está executando o sistema operacional AIX, Solaris ouLinux:JAVA_OPTS="$JAVA_OPTS -Dfile.encoding=utf8"

7. Opcionalmente, configure a propriedade anonymousaccessenabled, conformemostrado abaixo, como true para ativar o login anônimo. Configure estapropriedade como false para desativar o login anônimo. Quando estapropriedade é ativada, a tela de login mostra o link Efetuar Login comoUsuário Anônimo.v Em um servidor que está executando o sistema operacional Microsoft

Windows:set JAVA_OPTS=%JAVA_OPTS% "-Danonymousaccessenabled=true"

v Em um servidor que está executando o sistema operacional AIX, Solaris ouLinux:JAVA_OPTS="$JAVA_OPTS -Danonymousaccessenabled=true"

Com um login anônimo ativado, é possível efetuar login automaticamente noIBM Cognos Real-time Monitoring Dashboard ou no IBM Cognos Real-timeMonitoring Workbench sem especificar um nome de usuário ou senha, usandoa URL:http://servername/cognos/realtime/landing/landingpage.htmIsso permite escolher o aplicativo.

8. Opcionalmente, se as conexões http de saída, tais como serviços da Web ouserviços de codificação geográfica, forem necessárias para percorrer umservidor proxy a partir de seus ambiente do servidor, inclua a propriedadeJVM no script de inicialização para que a camada de conectividade Java use oservidor proxy para todas as chamadas de saída.A seguir são mostrados exemplos para cada sistema operacional.v Em um servidor que está executando o sistema operacional Microsoft

Windows:set JAVA_OPTS=%JAVA_OPTS% "-Dhttp.proxyHost=<fully qualified servername of http proxy>"

Capítulo 8. Instalando o Real-time Monitoring em um JBoss Application Server 61

Page 70: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

set JAVA_OPTS=%JAVA_OPTS% "-Dhttp.proxyPort=<http proxy port number>"

set JAVA_OPTS=%JAVA_OPTS% "-Dhttps.proxyHost=<fully qualified servername of https proxy>"

set JAVA_OPTS=%JAVA_OPTS% "-Dhttps.proxyPort=<https proxy serverport>"

v Em um servidor que está executando o sistema operacional AIX, Solaris ouLinux:JAVA_OPTS="$JAVA_OPTS -Dhttp.proxyHost=<fully qualified server nameof http proxy>"

JAVA_OPTS="$JAVA_OPTS -Dhttp.proxyPort=<http proxy port number>"

JAVA_OPTS="$JAVA_OPTS -Dhttps.proxyHost=<fully qualified server nameof https proxy>"

JAVA_OPTS="$JAVA_OPTS -Dhttps.proxyPort=<https proxy server port>"

Nota: Servidores proxy que requeiram autenticação não são suportados.9. Opcionalmente, inclua uma configuração JAVA_OPTS, conforme mostrado

abaixo, para desativar a criação de log dupla da saída do sistema.

Nota: Esta é uma solução alternativa para o erro 877974 do JBoss.v Em um servidor que está executando o sistema operacional Microsoft

Windows:set JAVA_OPTS=%JAVA_OPTS%

"-Dorg.jboss.logging.Log4jService.catchSystemOut=false"

"-Dorg.jboss.logging.Log4jService.catchSystemErr=false"

Nota: O item acima deve ser inserido em uma única linha.v Em um servidor que está executando o sistema operacional AIX, Solaris ou

Linux:JAVA_OPTS="$JAVA_OPTS

-Dorg.jboss.logging.Log4jService.catchSystemOut=false

-Dorg.jboss.logging.Log4jService.catchSystemErr=false"

Nota: O item acima deve ser inserido em uma única linha.10. Ative a JVM de 64 bits incluindo a seguinte linha na configuração

JAVA_OPTS, conforme mostrado abaixo:v Em um servidor que está executando o sistema operacional Microsoft

Windows:set JAVA_OPTS=%JAVA_OPTS% "-D64"

v Em um servidor que está executando o sistema operacional AIX, Solaris ouLinux:JAVA_OPTS="$JAVA_OPTS -D64"

11. Configure os parâmetros da JVM para obter a memória e a coleção de lixo(GC) ideais. Parâmetros da JVM de amostra para execução do Real-timeMonitoring são recomendados conforme a seguir (para o Java SE HotSpotJVM versão 1.5):-server

-Xms24576M

-Xmx24576M

-XX:NewSize=6144M

-XX:MaxNewSize=6144M

-XX:PermSize=256M

62 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 71: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

-XX:MaxPermSize=256M

-XX:ThreadStackSize=300

-XX:MaxTenuringThreshold=0

-XX:SurvivorRatio=128

-XX:+UseTLAB

-verbose:gc

-Dsun.rmi.dgc.client.gcInterval=600000

-Xloggc:<location of the GC logs>

-XX:-UsePerfData

-XX:+PrintVMOptions

-XX:+TraceClassUnloading

-XX:+DisableExplicitGC

-XX:+CMSParallelRemarkEnabled

-XX:+PrintGCDetails

-XX:+PrintGCTimeStamps

-XX:+UseParNewGC

-XX:+UseConcMarkSweepGC

-XX:ParallelGCThreads=<number of cpus>

-XX:CMSMarkStackSize=8M

-XX:CMSMarkStackSizeMax=32M

-XX:+UseCMSCompactAtFullCollection

-XX:CMSFullGCsBeforeCompaction=0

-XX:+ParallelRefProcEnabled

-XX:+CMSClassUnloadingEnabled

-XX:+CMSPermGenSweepingEnabled

-XX:+CMSIncrementalMode

-XX:+CMSIncrementalPacing

-XX:CMSIncrementalDutyCycleMin=0

-XX:CMSIncrementalDutyCycle=10

-XX:+UseCMSInitiatingOccupancyOnly

12. Opcionalmente, configure os parâmetros de idioma e código de idioma comodescrito em “Configurando os Parâmetros de Idioma e Código de Idioma”.É necessário executar esta etapa apenas se desejar inicializar o metadados emum código do idioma diferente do código do idioma do servidor padrão.

13. Salve e feche o arquivo de script de início.

Configurando os Parâmetros de Idioma e Código de IdiomaÉ possível configurar parâmetros opcionais para o banco de dados de metadados,incluindo idioma, país ou região e força de ordenação.

Os padrões são baseados nas configurações do código de idioma do servidor. Vocêdeve configurar estes padrões antes de iniciar o servidor de aplicativos pelaprimeira vez. Estes parâmetros são incluídos no script de início para o servidor deaplicativos e usam o seguinte formato básico:

-Dcom.cognos.obi.property.[PARAMETER]=[VALUE]

Cada parâmetro é descrito na tabela abaixo. Esta tabela é seguida porprocedimentos específicos para configurar os parâmetros na configuração doservidor de aplicativos.

Capítulo 8. Instalando o Real-time Monitoring em um JBoss Application Server 63

Page 72: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Tabela 23. Configurações de Parâmetros Opcionais para o Banco de Dados de MetadadosJBoss Application ServerParâmetro Descrição

LOCALE_LANGUAGE O código de idioma ISO de dois caracteres para o servidor.

Por exemplo, para configurar o parâmetro de idioma como Português, seria incluídoo seguinte comando:

Em um servidor que está executando o sistema operacional Microsoft Windows:

set JAVA_OPTS=%JAVA_OPTS% "-Dcom.cognos.obi.property.LOCALE_LANGUAGE=PT"

Em um servidor que está executando o sistema operacional AIX, Solaris ou Linux:

JAVA_OPTS="$JAVA_OPTS -Dcom.cognos.obi.property.LOCALE_LANGUAGE=PT"

LOCALE_REGION O código ISO de dois caracteres para país ou região para o servidor.

Por exemplo, para configurar o país ou a região como Brasil, as configurações seriamcomo as seguintes:

Em um servidor que está executando o sistema operacional Microsoft Windows:

set JAVA_OPTS=%JAVA_OPTS% "-Dcom.cognos.obi.property.LOCALE_REGION=BR"

Em um servidor que está executando o sistema operacional AIX, Solaris ou Linux:

JAVA_OPTS="$JAVA_OPTS -Dcom.cognos.obi.property.LOCALE_REGION=BR"

LOCALE_COLLATION Configure como true ou false para indicar se deve executar comparações de sequênciasensíveis ao código do idioma. (O padrão é false.)

COLLATE_STRENGTH Especifica o nível de força de ordenação; ou seja, a extensão na qual os caracteres nãoem inglês são comparados e ordenados: primário, secundário, terciário ou idêntico.Primário é o menos distintivo; idêntico é o mais. (O padrão é terciário.) Para obtermais informações sobre parâmetros de ordenação, consulte a documentação do Javaem:

http://download.oracle.com/javase/1.5.0/docs/api/java/util/Locale.html.Nota: Esta configuração é funcional apenas se LOCALE_COLLATION estiverconfigurado como true.

COLLATE_DECOMPOSITION Especifica um dos seguintes modos de decomposição de ordenação: nenhum,canônico ou integral. (O padrão é canônico.) Para obter mais informações sobreparâmetros de ordenação, consulte a documentação do Java em: http://download.oracle.com/javase/1.5.0/docs/api/java/util/Locale.html.Nota: Esta configuração é funcional apenas se LOCALE_COLLATION estiverconfigurado como true.

Procedimento1. Localize a variável de ambiente JAVA_OPTS no arquivo run.bat ou run.sh file.2. Inclua as configurações de parâmetro usando a seguinte sintaxe:

com.cognos.obi.property.[PARAMETER]=[VALUE]

Nota: Delimite configurações diversas com um espaço. Prefixe cadaconfiguração com o comando -D.

3. Salve e feche o script de execução. As alterações nas propriedades JVM terãoefeito na próxima vez em que o servidor for reiniciado.

Criando e Configurando a Conexão de MetadadosNeste procedimento, é necessário copiar o driver de banco de dados (ou drivers)no diretório JBoss, em seguida, criar e implementar um descritor de origem demetadados.

O descritor de origem de metadados define a configuração da conexão com obanco de dados, incluindo informações como a URL para a conexão com o bancode dados, o nome de usuário e a senha associada e assim por diante.

64 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 73: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Nota: Este descritor deve ser uma origem de dados <no-tx-datasource>. Você podelocalizar um modelo para o arquivo descritor (obi_metadata-ds.xml) no diretórioc10_location/realtime/configuration/jboss.

Procedimento1. Copie os arquivos do driver de banco de dados (por exemplo, ojdbc14.jar para

Oracle 10g) no diretório /server/default/lib.2. Configure a origem de dados de metadados:

a. Copie o arquivo obi_metadata-ds.xml, o qual está localizado no diretórioc10_location/realtime/configuration/jboss/, para o diretório/server/default/deploy na instalação do JBoss.

b. Abra o arquivo obi_metadata-ds.xml em um editor de texto.c. Inclua a tag <use-java-context> imediatamente após o elemento

<jndi-name> e configure-o conforme a seguir:v Para JBoss 4.2.3: configure-o como false, por exemplo,

<use-java-context>false</use-java-context>

v Para JBoss 5.1: configure-o como true, por exemplo, <use-java-context>true</use-java-context>

d. Configure os parâmetros connection-url e driver-class mostrados na tabelaabaixo, com base no tipo de banco de dados.

Tabela 24. Configuração dos Parâmetros connection-url e driver-classConfigurando Banco de Dados Formatação de Valor

<connection-url> DB2 jdbc:db2://[host]:[port]/[database name]

Microsoft SQL Server 2000 jdbc:microsoft:sqlserver://[host]:[port];selectMethod=cursor;databaseName=[dbname]

Microsoft SQL Server 2005 jdbc:sqlserver://[host]:[port];selectMethod=cursor;databaseName=[dbname]

Microsoft SQL Server 2008 jdbc:sqlserver://[host]:[port];selectMethod=cursor;

databaseName=[dbname]

MySQL jdbc:mysql://[dbhost]:[port]/[dbname]

PostgreSQL jdbc:postgresql://[dbhost]:[port]/[dbname]

Oracle Thin:

jdbc:oracle:thin:@[dbhost]: [dbport]:[dbSID]

Thick (OCI):

jdbc:oracle:oci:@[tnsalias]

<driver-class> DB2 com.ibm.db2.jcc.DB2Driver

Microsoft SQL Server 2000 Se estiver usando os drivers 2000 (msutil.jar, mssqlserver.jar, msbase.jar),especifique: com.microsoft.jdbc.sqlserver.SQLServerDriver

Se estiver usando o driver 2005 (sqljdbc.jar), especifique:com.microsoft.sqlserver.jdbc.SQLServerDriver

Microsoft SQL Server 2005 com.microsoft.sqlserver.jdbc.SQLServerDriver

Microsoft SQL Server 2008 com.microsoft.sqlserver.jdbc.SQLServerDriver

MySQL com.mysql.jdbc.Driver

PostgreSQL org.postgresql.Driver

Capítulo 8. Instalando o Real-time Monitoring em um JBoss Application Server 65

Page 74: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Tabela 24. Configuração dos Parâmetros connection-url e driver-class (continuação)Configurando Banco de Dados Formatação de Valor

Oracle oracle.jdbc.driver.OracleDriver

e. Modifique os parâmetros de nome do usuário e de senha. Eles devemcorresponder às configurações do banco de dados especificadas noparâmetro connection-url.

Nota: Para todos os bancos de dados, você também deve especificar umnome de usuário e uma senha nos elementos apropriados no arquivoobi_metadata-ds.xml.

f. Salve e feche o arquivo obi_metadata-ds.xml.3. Copie os arquivos do driver de banco de dados (sqljdbc.jar, msbase.jar,

mssqlserver.jar, msutil.jar) no diretório /server/default/lib.

Definindo Origens de Dados no JBossPara a instalação, você deve definir as duas origens de dados a seguir: uma origemde dados para mapas geográficos e uma origem de dados operacional.

Opcionalmente, é possível definir origens de dados para agentes Java DatabaseConnectivity (JDBC).

Definindo a Origem de Dados para Mapas GeográficosÉ necessário definir uma origem de dados geográfica para mapas geográficos.

Para configurar o suporte para mapas geográficos, siga as etapas para a criação deuma origem de dados com o JBoss Application Server como descrito na seção,“Criando e Configurando a Conexão de Metadados” na página 64. Entretanto, vocêdeve especificar o nome e o nome da Java Naming and Directory Interface (JNDI)como com.cognos.obi.geo.geoDatasource.

Procedimento1. Faça uma cópia do arquivo obi_metadata-ds.xml e renomeie-o como

obi_geo-ds.xml.2. Especifique o nome e o nome da JNDI como com.cognos.obi.geo.geoDatasource.

Definindo uma Origem de Dados OperacionalUma origem de dados operacional é um repositório de banco de dados que vocêusa para armazenar e persistir os dados da consulta.

Para configurar sua origem de dados operacional, siga as mesmas etapas que paracriar uma origem de metadados. Entretanto, você deve especificar o nome e onome da Java Naming and Directory Interface (JNDI) comocom.cognos.obi.operational. Para criar uma origem de dados, siga o procedimentodescrito em “Criando e Configurando a Conexão de Metadados” na página 64

Definindo Origens de Dados Opcionais GenéricasPara cada agente Java Database Connectivity (JDBC) (por exemplo, para acessar ofluxo de dados ou os dados da tabela de consulta) que você cria no IBM CognosReal-time Monitoring Workbench, você deve criar uma origem de dados nainstalação do JBoss.

O uso da Java Naming and Directory Interface (JNDI) com Conjuntos de Conexõesé a maneira preferível para se conectar às origens de dados JDBC. O nome The

66 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 75: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

JNDI especificado aqui é usado no Real-time Monitoring Workbench naconfiguração de um Agente JDBC. Se um driver do Conjunto de Conexões nãoestiver disponível, uma alternativa seria especificar uma conexão baseada em URLno Real-time Monitoring Workbench. O nome da Java Naming and DirectoryInterface (JNDI) deve ser exclusivo para cada origem de dados. Para criar umaorigem de dados, siga o procedimento descrito em “Criando e Configurando aConexão de Metadados” na página 64.

Implementando o Real-time Monitoring em um JBossApplication Server

Esta seção o guia pelo processo de instalação do JBoss específico para o IBMCognosReal-time Monitoring.

Antes de continuar, certifique-se de concluir as etapas de configuração listadas emCapítulo 3, “Preparando para Instalar o Real-time Monitoring”, na página 11.

criação de log do JBossNas instalações do JBoss, qualquer mensagem enviada a qualquer log do IBMCognos Real-time Monitoring também pode ser registrada no arquivo .log do JBossApplication Server.

Por padrão, o JBoss Application Server registra todas as mensagens publicadaspelos servidores Real-time Monitoring, além de suas próprias mensagens e aquelasde quaisquer outros aplicativos em execução nele. Você pode desativar a criação delog de arquivo das mensagens do Real-time Monitoring com o arquivo deconfiguração do JBoss log4j.xml.

Por padrão, os servidores Real-time Monitoring publicam mensagens deseveridade Informativa ou maior. É possível alterar quais mensagens eles publicamcom o Console Administrativo do IBM Cognos Real-time Monitoring Workbench.Para obter mais informações, consulte as informações sobre a criação de log noGuia do Usuário do IBM Cognos Real-time Monitoring Workbench.

Procedimento1. Dependendo de sua versão do JBoss, edite o arquivo de configuração

jboss-log4j.xml ou log4j.xml localizado no diretório server/default/conf/ doJBoss. Nesse arquivo, role para baixo até a seguinte seção:<root>

<appender-ref ref="CONSOLE"/>

<appender-ref ref="FILE"/>

</root>

2. Altere a definição de <root> e, na seção "Categorias", inclua uma novacategoria conforme a seguir:<root>

<appender-ref ref="CONSOLE"/>

</root>

...

<category name="org">

<appender-ref ref="FILE"/>

</category>

Isto informa ao JBoss Application Server para enviar todas as mensanges, taiscomo as mensagens publicadas pelo JBoss Application Server a partir dascategorias "org" ao console. As mensagens das categorias "com" (comocom.cognos) não são registradas no arquivo.

3. Salve o arquivo jboss-log4j.xml ou log4j.xml alterado.

Capítulo 8. Instalando o Real-time Monitoring em um JBoss Application Server 67

Page 76: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Importante: Não faça esta mudança na configuração de log enquanto oservidor de aplicativos estiver em execução porque ele duplicará as mensagensno console e no arquivo.

Instalando o JBoss Application ServerPara instalar e implementar com sucesso o IBM Cognos Real-time Monitoring, vocêdeverá usar o arquivo EAR para o JBoss Application Server que estiver usando.

Procedimento1. Acesse o diretório c10_location/realtime/bin64 para localizar o arquivo EAR

para a versão do servidor de aplicativos JBoss que estiver sendo usada:v Para JBoss 4.2.3: use Realtime.ear

v Para JBoss 5.1: use Realtime-jboss5.ear

2. Copie o arquivo EAR apropriado no diretório $JBOSS_HOME/server/default/deploy.

Considerações ao Implementar o Real-time Monitoring em umJBoss Application Server

Esta seção descreve algumas considerações ao implementar o IBM CognosReal-time Monitoring em um JBoss Application Server.

Criptografando a Senha do Banco de Dados JBossPor razões de segurança, talvez seja necessário criptografar as senhas usadas paraefetuar login no banco de dados.

Para obter informações sobre como criptografar a senha do banco de dados,consulte o Web site do JBoss:

http://www.jboss.org/community/docs/DOC-9703

Modificando o JBoss Application Server para DesempenhoAprimoradoO procedimento nesta seção pode aprimorar o desempenho de rede geral da rededo IBM Cognos Real-time Monitoring.

Nota: Este procedimento requer o reinício do JBoss Application Server.

Procedimento1. Localize e abra o arquivo server.xml. Par a versão 4.2.x, o arquivo está

localizado no diretório \server\default\deploy\jboss-web.deployer.2. Localize o bloco listado no título <!-- Um Conector HTTP/1.1 na Porta 8080 -->.

Nota: O número da porta específico e outras configurações podem variar.Este bloco deve ser semelhante a isto:<!-- A HTTP/1.1 Connector on port 8080 -->

<Connector port="8080" address="${jboss.bind.address}"

maxThreads="400" minSpareThreads="75" maxSpareThreads="100"

enableLookups="false" redirectPort="8443" acceptCount="100"

connectionTimeout="20000" disableUploadTimeout="true"/>

3. Inclua os seguintes parâmetros:compression="on"

socketBuffer="1045576"

4. Salve e feche o arquivo server.xml.5. Reinicie o JBoss Application Server.

68 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 77: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Resultados

Após ter confirmado a implementação, configure seu servidor da Web para tratar oconteúdo estático. Para obter informações sobre como configurar conteúdosestáticos, consulte Capítulo 9, “Instalando, Configurando e Desinstalando Arquivosdo Servidor da Web Real-time Monitoring”, na página 73.

Testando o Real-time Monitoring Após a Instalação no JBossApplication Server

Após instalar o IBM Cognos Real-time Monitoring no servidor de aplicativos e noservidor da Web, você pode testar sua instalação instalando e usando as amostrasque são fornecidas com o produto.

Procedimento1. Valide se os conteúdos estático e dinâmico estão configurados corretamente .

Consulte o “Verificando a Configuração para o Conteúdo Estático e Dinâmico”na página 80.

2. Opcionalmente, carregue as amostras . Consulte o “Carregando Amostras doReal-time Monitoring no JBoss Application Server”.

3. Inicie o Real-time Monitoring Workbench e importe os metadados de amostra .Consulte o “Importando Metadados de Amostra no Real-time Monitoring” napágina 70.

Carregando Amostras do Real-time Monitoring no JBossApplication Server

Carregue os dados para verificar se o aplicativo está funcionando.

O diretório c10_location/realtime/webcontent/samples/sdk/callcenter/CallCenterDemo/data contém o esquema do banco de dados Derby que terá astabelas, os dados e os acionadores demo da central de atendimento. Esta demorequer o driver Apache Derby 10.5.3. Para obter informações sobre como fazer odownload do Apache Derby, consulte:

http://db.apache.org/derby/derby_downloads.html

O diretório c10_location/realtime/webcontent/samples/sdk/callcenter/CallCenterDemo/metadata contém uma exportação do modelo de objeto usadopara a demo da central de atendimento; ele é independente de banco de dados.

O diretório c10_location/realtime/webcontent/samples/sdk/callcenter/CallCenterDemo/config contém arquivos de configuração da origem de dados paraconfigurar a origem de dados.

Procedimento1. Localize os arquivos de amostra no diretório c10_location/realtime/webcontent/

samples/sdk.2. Crie o diretório /derby/databases no diretório JBoss install location/server/ .3. Copie o banco de dados c10_location/realtime/webcontent/samples/sdk/

callcenter/CallCenterDemo/data/ccdemo no seguinte diretório no JBossApplication ServerJBoss install location/server/derby/databases

Capítulo 8. Instalando o Real-time Monitoring em um JBoss Application Server 69

Page 78: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

4. Copie o arquivo derby.jar transferido por download do site de suporte daApache no diretório JBoss install location/server/default/lib.

5. Copie obi_ccdemo-ds.xml, localizado no diretório c10_location/realtime/webcontent/samples/sdk/callcenter/CallCenterDemo/config para o diretórioJBoss install location/server/default/deploy na instalação do JBoss.

6. Reinicie o JBoss Application Server.

Resultados

Após preparar as origens de dados de amostra, é possível importar os metadadosde amostra.

Importando Metadados de Amostra no Real-time MonitoringUsando o IBM Cognos Real-time Monitoring Workbench, importe os metadados deamostra.

Procedimento1. Inicie o Real-time Monitoring.2. Importe export.jar do diretório c10_location/realtime/webcontent/samples/

sdk/callcenter/CallCenterDemo/metadata usando o recurso de importação doReal-time Monitoring Workbench.Para obter mais informações sobre importação de metadados, consulte a seçãode importação de metadados no Guia do Usuário do IBM Cognos Real-timeMonitoring Workbench.

Desinstalando o Real-time Monitoring do JBoss Application ServerAntes de desinstalar o IBM Cognos Real-time Monitoring, decida se é necessáriofazer backup de qualquer parte dos metadados ou bancos de dados do aplicativo.

Isto é especialmente importante se você tiver arquivos keystore salvos com senhasde usuário. Faça backup dos arquivos keystore para manter os IDs do usuário e assenhas. Execute o programa de desinstalação que foi instalado como parte doprocesso de instalação. É necessário também excluir e remover a implementaçãomanualmente dos componentes e arquivos do aplicativo Real-time Monitoring queresidem em vários locais no servidor de aplicativos e no servidor da Web, comoarquivos de log e diretórios.

Procedimento1. Opcionalmente, faça backup dos metadados associados ao IBM Cognos

Real-time Monitoring.2. Desinstale do JBoss Application Server .3. Execute o programa de desinstalação do IBM Cognos Real-time Monitoring.4. Desinstale o banco de dados .

Fazendo Backup dos Metadados do Real-time MonitoringAntes de desinstalar, você pode desejar fazer backup dos metadados associados aoIBM Cognos Real-time Monitoring.

Para algumas atualizações, pode ser necessário restaurar um conjunto de arquivosde backup em vez de atualizar o software. Se estiver fazendo uma atualização, leiaas instruções de atualização antes de desligar e desinstalar a versão anterior. Para

70 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 79: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

obter mais informações, consulte Capítulo 5, “Fazendo Atualização de uma VersãoAnterior ou Reinstalando o Real-time Monitoring”, na página 25.

Procedimento1. Efetue login no IBM Cognos Real-time Monitoring Workbench.2. Use o recurso Exportar conforme descrito na seção sobre exportação de

metadados no Guia do Usuário do IBM Cognos Real-time MonitoringWorkbench.

3. Efetue logout do IBM Cognos Real-time Monitoring Workbench.

Desinstalando do JBoss Application ServerEsta seção descreve como desinstalar o IBM Cognos Real-time Monitoring do JBossApplication Server.

Procedimento1. Pare o IBM Cognos Real-time Monitoring.

v ...\%JBOSS_HOME%\bin\shutdown.bat (o sistema operacional MicrosoftWindows)

v .../$JBOSS_HOME/bin/shutdown.sh (o sistema operacional UNIX)2. Remova o arquivo EAR do aplicativo do diretório de implementação do JBoss.

v Para JBoss 4.2.3: <JBOSS_HOME>/server/default/deploy/Realtime.earv Para JBoss 5.1: <JBOSS_HOME>/server/default/deploy/Realtime-jboss5.ear

3. Remova o conteúdo dos seguintes diretórios do JBoss:<JBOSS_HOME>/server/<config-type>/tmp

<JBOSS_HOME>/server/<config-type>/conf/jboss.web

Executando o Programa de Desinstalação do Real-timeMonitoring

Execute o programa de desinstalação para remover o IBM Cognos Real-timeMonitoring do servidor de aplicativos ou servidor da Web, se o servidor da Webestiver instalado em um computador diferente.

Procedimento1. Inicie o desinstalador.2. Escolha o idioma para usar para o desinstalador e clique em Avançar.3. Selecione IBM Cognos Real-time Monitoring e clique em Avançar.4. Quando o desinstalador tiver concluído, clique em Concluir.

Resultados

Todos os arquivos de programas são excluídos. Os arquivos de log do Real-timeMonitoring que permanecem nos diretórios c10_location/instlog ec10_location/uninstall podem ser excluídos com segurança.

Desinstalando o Banco de DadosPara desinstalar os bancos de dados, você deve excluir as tabelas dearmazenamento de arquivos e de metadados.

Capítulo 8. Instalando o Real-time Monitoring em um JBoss Application Server 71

Page 80: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Procedimento1. Abra o diretório de log de recuperação e o diretório de ponto de verificação,

em seguida, exclua o armazenamento de arquivo *.dat andDEFAULTRECOVERYLOGGER_ *.

2. Exclua as tabelas para o banco de dados de metadados fazendo o seguinte:v Acesse o banco de dados ou o esquema do banco de dados usado para o

banco de dados de metadados do IBM Cognos Real-time Monitoring.v Exclua as tabelas para o banco de dados de metadados. As tabelas a excluir

são: METADATA_OBJECTS, ALLOCATED_UID e UNCOMMITTED_TID.

72 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 81: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Capítulo 9. Instalando, Configurando e DesinstalandoArquivos do Servidor da Web Real-time Monitoring

Esta seção descreve como instalar, configurar e desinstalar os arquivos do servidordo IBM Cognos Real-time Monitoring.

Esta seção supõe que você adquiriu o CD do produto ou que você transferiu pordownload o pacote de instalação adequado e que possui direitos administrativosno servidor da Web no qual está instalando os arquivos que o IBM CognosReal-time Monitoring necessita para funcionar. Se o servidor da Web estiverfisicamente em um computador diferente do servidor de aplicativos, você deveráexecutar o instalador do Real-time Monitoring no servidor usado para o ambientedo servidor da Web e, em seguida, configurar esse servidor para conteúdo estático.

Seu servidor da Web trata conteúdo estático e redireciona pedidos para conteúdodinâmico. Para a integração do IBM Cognos Real-time Monitoring com o IBMCognos Workplace, o conteúdo estático do Real-time Monitoring deverá residir nomesmo servidor da web que hospeda o IBM Cognos Business Intelligence.

Instalando Arquivos do Servidor da Web Real-time MonitoringPara instalar os arquivos do servidor do IBM Cognos Real-time Monitoring,execute o assistente de instalação a partir do pacote de instalação ou do CD doproduto.

Se o servidor da Web estiver em um computador diferente do servidor deaplicativos, você deverá executar o instalador no servidor da Web. Se o servidor daWeb estiver no mesmo computador que o servidor de aplicativos e você já tiverexecutado o instalador e incluído os arquivos do servidor da Web, você deveráseguir as etapas para configuração do servidor da Web, para que este servidoraponte para o diretório webcontent, que é instalado seguindo esses procedimentos.

Para uma instalação completa, você deverá instalar os componentes em seuservidor e, em seguida, configurá-los para trabalharem em seu ambiente.Geralmente, o instalador do IBM Cognos Real-time Monitoring é executado nomodo interativo. Isso significa que em uma interface gráfica com o usuário (GUI) oinstalador o avisa para fornecer informações e deverá ser executado a partir deuma estação de trabalho X Window System, um terminal X ou um PC ou outrosistema com o software do servidor X instalado. Para executar uma instalação emmodo interativo, o console conectado ao seu computador deve suportar umainterface gráfica com o usuário baseada em Java.

Para sistemas em execução em um ambiente Linux no IBM System z é umrequisito (requisito de software opcional) que você possua um software WindowsX capaz de renderizar uma interface gráfica com o usuário (dessa forma, vocêobtém as bibliotecas Motif necessárias). Você deve ativar o host remoto paradirecionar a saída para a exibição local. Também é necessário configurar a variávelde ambiente DISPLAY. Por exemplo, digite exportarDISPLAY=host_name:display_number.

Procedimento1. Faça um dos seguintes com base em seu ambiente:

© Copyright IBM Corp. 2003, 2014 73

Page 82: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

v Em um servidor que está executando o sistema operacional MicrosoftWindows, no diretório win64 do pacote transferido por download, dê umclique duplo no arquivo issetup.exe e siga as instruções do assistente deinstalação.

v Em um servidor que está executando um sistema operacional UNIX ouLinux, no diretório adequado ao seu sistema operacional, digite ./issetup esiga as instruções do assistente de instalação.

2. Na página Local da Instalação, especifique o local do IBM Cognos e clique emAvançar.Por exemplo, o padrão em um servidor que está executando o sistemaoperacional Microsoft Windows é:C:\Program Files\ibm\cognos\c10_64Se estiver instalando em um computador que contém outros componentes doIBM Cognos, como o IBM Cognos Business Intelligence versão 10.1.0, instale nomesmo diretório.Se você não usar o diretório de instalação padrão, use um nome de diretórioque contenha apenas caracteres ASCII. Alguns servidores da Web não suportamcaracteres não ASCII nos nomes de diretório.

3. Se estiver instalando apenas no servidor da Web, na página Seleção deComponente, expanda IBM Cognos Real-time Monitoring, cancele a seleçãoArquivos do Real-time Monitoring Application Server e clique em Avançar.

4. Conclua as etapas no assistente de instalação e clique em Concluir.

Resultados

O diretório webcontent do Real-time Monitoring é instalado no servidor da Web.Agora você está pronto para configurar o servidor da Web. Para obter informaçõesadicionais, consultev “Configurando um Apache ou IBM HTTP Server para tratar o conteúdo

estático”v “Configurando o Microsoft Internet Information Server para trabalhar com o

Real-time Monitoring instalado em um WebSphere Application Server” napágina 76

v “Configurando o Microsoft Internet Information Server para trabalhar com oReal-time Monitoring instalado em um WebLogic Application Server” na página77

v “Configurando o Microsoft Internet Information Server para trabalhar com oReal-time Monitoring instalado em um JBoss Application Server” na página 79

Configurando um Apache ou IBM HTTP Server para tratar o conteúdoestático

Esta seção descreve como configurar o servidor Apache HTTP da Web ou o IBMHTTP Server (IHS) para tratar conteúdo estático para o IBM Cognos Real-timeMonitoring que foi instalado no IBM WebSphere Application Server, OracleWebLogic Application Server ou JBoss Application Server.

Essas etapas assumem que você já instalou o servidor Apache HTTP da Web ou oIBM HTTP Server (IHS).

74 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 83: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Como parte desta tarefa, você deve editar o arquivo realtime.conf para atualizarinformações específicas de sua configuração. Você também deve editar o arquivocom o caminho de URL para seu servidor de aplicativos em todas as linhasProxyPass e ProxyPassReverse.

Antes de Iniciar

Para concluir estas tarefas, você deve ter acesso ao diretório webcontent que foiinstalado pelo instalador do IBM Cognos Real-time Monitoring. O arquivorealtime.conf deve ser copiado na estrutura de diretório do servidor Apache HTTPda Web ou do IBM HTTP Server (IHS). Você deve ter direitos administrativos parao servidor de aplicativos e o servidor da Web. Você deve conhecer o caminho daURL e os nomes de porta para o servidor de aplicativos e deve conhecer o local doarquivo httpd.conf, que está localizado no diretório <apache_root>/conf.

Procedimento1. Reúna as informações a seguir para que seja possível configurar seu servidor

da Web para apontar para o diretório webcontent instalado e para o servidorde aplicativos.v o local do diretório webcontentv o caminho da URL do servidor de aplicativos, tal como http://

localhost:8001/realtime ou http://localhost:8080/realtime2. No servidor da Web, se o diretório conf.d ainda não existir, você deverá criar o

diretório conf.d no mesmo nível que o diretório conf.3. Copie o arquivo realtime.conf, que está localizado no diretório

c10_location/realtime/configuration, para o diretório conf.d.4. Edite a cópia do arquivo realtime.conf que você copiou no diretório conf.d com

as seguintes alterações:v Se estiver usando o IBM WebSphere Application Server, você deverá anexar a

seguinte entrada.WebSpherePluginConfig "<appserver_install_root>\profiles\<profile_name>\config\cells\plugin-cfg.xml"

v Altere a linha Alias para apontar para o local de seu diretório webapp.Por exemplo, no sistema operacional Microsoft Windows, digite:Alias /cognos/realtime "C:/Program Files/ibm/cognos/c10_64/realtime/webcontent"

v Altere as entradas ProxyPass e ProxyPassReverse para refletir seu local e suaporta do servidor de aplicativos.Altere a parte do endereço IP e da porta do URI para corresponder ao nomedo host e à porta nos quais o servidor de aplicativos está em execução.

5. Edite o arquivo httpd.conf.Se o arquivo httpd.conf ainda não contiver esta entrada, você deverá anexar aseguinte linha no arquivo httpd.conf:Include conf.d/*.conf

6. Salve suas alterações.7. Reinicie o servidor da Web.

Capítulo 9. Instalando, Configurando e Desinstalando Arquivos do Servidor da Web Real-time Monitoring 75

Page 84: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Configurando o Microsoft Internet Information Server para trabalharcom o Real-time Monitoring instalado em um WebSphere ApplicationServer

O IBM Cognos Real-time Monitoring instalado em um IBM WebSphere ApplicationServer pode ser configurado para usar o Microsoft Internet Information Server (IIS)como o componente do servidor da Web.

Para configurar o Microsoft Internet Information Server (IIS) com um IBMWebSphere Application Server, consulte o seguinte centro de informações, quefornece etapas detalhadas para executar estas tarefas:

Tabela 25. Links a Informações Adicionais sobre Configuração do IIS com o WebSphereApplication ServerVersão Link para a Documentação On-Line

6.0 http://publib.boulder.ibm.com/infocenter/wasinfo/v6r0/index.jsp?topic=/com.ibm.websphere.base.doc/info/aes/ae/tins_manualWebIIS.html

6.1 http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp?topic=/com.ibm.websphere.base.doc/info/aes/ae/tins_manualWebIIS.html

7.0 http://publib.boulder.ibm.com/infocenter/wasinfo/v7r0/index.jsp?topic=/com.ibm.websphere.base.doc/info/aes/ae/tins_manualWebIIS.html

O IBM WebSphere Application Server usa um plug-in binário exclusivo para cadaservidor da Web suportado. O plug-in fornece informações sobre o servidor deaplicativos para o servidor da Web, que usa as informações para se comunicar como servidor de aplicativos e executar aplicativos específicos no servidor deaplicativos.

Procedimento1. Instale o plug-in do WebSphere Application Server no servidor IIS.2. A partir do Console Administrativo do WebSphere Application Server, atualize

a configuração de plug-in de servidor da Web global.3. No servidor ISS, crie um diretório virtual, cujo alias seja realtime, com uma

instalação padrão.4. Assegure-se de que o diretório virtual possua privilégios de leitura e execução

e de que o index.htm na área de janela Ativar conteúdo padrão apareça noinício da lista.

5. Inclua o filtro Internet Services Application Programming Interface (ISAPI) naconfiguração do IIS.Insira iisWASPlugin para o nome do filtro e navegue para oiisWASPlugin_http.dll, que está localizado na pasta WebSphere installlocation/Plugins/bin/IIS_webserver1 para o executável.

6. Salve seu trabalho.7. Para configurar o servidor da Web para executar extensões do WebSphere

Application Server, inclua uma nova extensão de serviço da Web com o nomede WASPlugin.Para o caminho, navegue até o arquivo iisWASPlugin_http.dll.

8. Assegure que a caixa de seleção Configurar Status da Extensão paraPermitido esteja selecionada.

9. No IIS, pare e reinicie o Web site padrão.10. Se estiver usando a versão 7.5 do IIS ou posterior, será necessário fazer o

seguinte para se assegurar que os painéis sejam renderizados corretamente:a. Abra a janela Comando com privilégios elevados.

76 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 85: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

b. Acesse o diretório Windows/System32/inetsrv.c. Insira o comando a seguir:

appcmd.exe set config "Default Web Site/" -section:system.webServer/httpErrors -existingResponse:PassThrough

Caso não esteja usando o Website Padrão, assegure-se de alterar DefaultWeb Site no comando para o nome apropriado de seu website.

Resultados

O servidor da Web do Real-time Monitoring foi configurado e deve ser possívelefetuar login no Real-time Monitoring Workbench para concluir a configuração.

Configurando o Microsoft Internet Information Server para trabalharcom o Real-time Monitoring instalado em um WebLogic ApplicationServer

O IBM Cognos Real-time Monitoring instalado em um Oracle WebLogicApplication Server pode ser configurado para usar o Microsoft InternetInformation Server (IIS) como o componente do servidor da Web.

O Microsoft Internet Information Server (IIS) fornece conteúdo estático comopáginas da Web para usuários do Real-time Monitoring. Para tratar o conteúdodinâmico, o IIS usa um proxy para encaminhar pedidos para o WebLogicApplication Server. Um plug-in do IIS, que deve ser instalado no WebLogicApplication Server trata a coordenação entre o IIS e o WebLogic.

Para obter instruções detalhadas, acesse o seguinte site:

http://download.oracle.com/docs/cd/E12840_01/wls/docs103/plugins/isapi.html

Como parte do processo de instalação do Real-time Monitoring, os arquivos deamostra são instalados, os quais o ajudam a trabalhar com o IIS e o OracleWebLogic juntos. O arquivo a seguir está localizado no diretórioc10_location/configuration: iisproxy.ini.

Antes de Iniciar

Antes de iniciar esta tarefa, certifique-se de ter direitos administrativos para oservidor de aplicativos e o servidor da Web e que tenha localizado o arquivo deamostra.

Procedimento1. Crie um diretório virtual no IIS chamado cognos e aponte-o para o local

padrão do IIS, comoc:\inetput\wwwroot

2. Para redirecionar pedidos para a página inicial do Real-time Monitoring, editeas propriedades do Web Site Padrão e do diretório virtual cognos. Na seçãoDiretório Inicial ou Diretório Virtual, escolha Redirecionamento para umaURL, redirecione para /cognos/realtime/ e configure as caixas de opção Aexata URL inserida acima e Um diretório abaixo da URL inserida.

3. Crie um diretório virtual dentro do diretório cognos chamado realtime dentrodo Web Site Padrão. Seu Diretório de Conteúdo do Web Site deve serc10_location/realtime/webcontent

Capítulo 9. Instalando, Configurando e Desinstalando Arquivos do Servidor da Web Real-time Monitoring 77

Page 86: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

4. Edite as propriedades do diretório virtual realtime. Na guia Documentos,certifique-se de que a caixa de seleção Ativar página de conteúdo padrãoesteja marcada e que index.htm seja o primeiro item da lista.

5. Localize os arquivos iisproxy.dll e iisforward.dll, localizados no diretórioWebLogic install location/server/plugin/win/x64, diretório WebLogic installlocation/server/plugin/win/64, ou diretório WebLogic installlocation/server/plugin/win/32 e copie os arquivos para um diretório que sejaacessível ao IIS.Certifique-se de que as permissões para o arquivo iisproxy.dll incluam ousuário que executará o IIS, como IUSR_nome da máquina.

6. Configure o proxy:v Para configurar o proxy por extensão do arquivo, use o Internet Information

Service Manager para selecionar o Web site, configurar propriedades para oWeb site e definir as configurações de aplicativo.

v Para configurar o proxy por caminho, use o Internet Information ServiceManager para registrar .wlforward como um tipo especial de arquivo queserá tratado pelo iisproxy.dll no IIS. Este procedimento requer a definiçãode uma propriedade, WlForwardPath, no iisproxy.ini e a configuração doparâmetro PathTrim para cortar a extensão dos arquivos WlForwardPathquando necessário.O arquivo iisproxy.ini fornecido no diretório realtime/configuration possuias configurações corretas para WlForwardPath. Entretanto, se ele não estiverem execução no mesmo servidor que o IIS, este arquivo precisará sermodificado para apontar para o servidor WebLogic correto (consulte a etapa8).

7. Para definir os parâmetros de configuração, copie e edite o arquivoiisproxy.ini, localizado no diretório c10_location/realtime/configuration para omesmo local do iisproxy.dll.

8. Se o WebLogic não estiver sendo executado no mesmo servidor do IIS, ou nãoestiver sendo executado na porta padrão 7001, edite o arquivo para definir onúmero de host e de porta que os hosts do WebLogic Server utilizam paratratar pedidos de proxy do Plug-In do Microsoft Internet Information Server.

9. Utilizando o console do IIS Manager, ative o Plug-In permitindo todas asextensões ISAPI desconhecidas.

10. Utilizando o console IIS Manager, ative a compactação HTTP dos conteúdosestático e dinâmico.

11. Dependendo de duas necessidades de segurança e de outras considerações deconfiguração, pode ser necessário executar as seguintes tarefas.v Ativar a autorização básica.v Configurar a autenticação de perímetro.v Ativar a Secure Sockets Layer (SSL).

12. Após a conclusão, reinicie o IIS Admin Service.13. Se estiver usando a versão 7.5 do IIS ou posterior, será necessário fazer o

seguinte para se assegurar que os painéis sejam renderizados corretamente:a. Abra a janela Comando com privilégios elevados.b. Acesse o diretório Windows/System32/inetsrv.c. Insira o comando a seguir:

appcmd.exe set config "Default Web Site/" -section:system.webServer/httpErrors -existingResponse:PassThrough

Caso não esteja usando o Website Padrão, assegure-se de alterar DefaultWeb Site no comando para o nome apropriado de seu website.

78 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 87: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Configurando o Microsoft Internet Information Server para trabalharcom o Real-time Monitoring instalado em um JBoss Application Server

O IBM Cognos Real-time Monitoring instalado em um JBoss Application Serverpode ser configurado para usar o Microsoft Internet Information Server (IIS) comoo componente do servidor da Web.

Esses procedimentos requerem o download e a instalação do Conector ApacheTomcat (isapi_redirect.dll) a partir da Apache Software Foundation. Como parte doprocesso de instalação do Real-time Monitoring, os arquivos de amostra sãoinstalados, os quais o ajudam a ter o IIS e o JBoss trabalhando juntos. Os arquivosa seguir estão localizados no diretório c10_location/configuration:isapi_redirect.properties, rewrite.properties, uriworkermap.properties eworkers.properties.

Para configurar o Microsoft Internet Information Server (IIS) com um JBossApplication Server, consulte o seguinte site:

http://community.jboss.org/wiki/UsingModjk12WithJBossAndIIS

Antes de Iniciar

Antes de iniciar esta tarefa, assegure que você tenha direitos administrativos para oservidor de aplicativos e o servidor da Web e que você tenha localizado osarquivos de amostra.

Procedimento1. A partir do Web site da Apache Software Foundation, faça o download de

isapi_redirect-1.2.28-chunking.dll a partir da página de releases binários dosConectores Apache Tomcat. Salve no diretório c10_location/realtime/configuration e renomeie como isapi_redirect.dll. A partir do MicrosoftWindows Explorer, clique com o botão direito do mouse no arquivo e, emseguida, clique em Propriedades. Se o botão Desbloquear aparecer, cliquenele e, em seguida, em OK.

Nota: A versão 1.2.30 não funciona com o Real-time Monitoring.2. Edite o arquivo c10_location/realtime/configuration/isapi_redirect.properties.

Se o local dos arquivos de configuração e do arquivo de log, comorepresentado por c10_location, não for preciso, modifique os valores do localpara log_file, worker_file, rewrite_rule_file e worker_mount_file.

3. Edite o arquivo c10_location/realtime/configuration/worker.properties.4. Abra o aplicativo de administração do Internet Administration Services.5. Crie um diretório virtual no Web Site Padrão chamado jakarta, apenas com

permissões Executar. O Diretório Inicial deve ser c10_location/realtime/configuration/

6. Crie um diretório virtual no IIS chamado cognos. Aponte-o para o localpadrão do IIS, comoc:\inetput\wwwrootPara redirecionar pedidos para a página inicial do Real-time Monitoring, editeas propriedades do Web Site Padrão e do diretório virtual cognos. Na seçãoDiretório Inicial ou Diretório Virtual, escolha Redirecionamento para umaURL, redirecione para /cognos/realtime/ e configure as caixas de opção Aexata URL inserida acima e Um diretório abaixo da URL inserida.

Capítulo 9. Instalando, Configurando e Desinstalando Arquivos do Servidor da Web Real-time Monitoring 79

Page 88: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

7. Crie um diretório virtual dentro do diretório cognos chamado realtime dentrodo Web Site Padrão. Seu Diretório de Conteúdo do Web Site deve serc10_location/realtime/webcontentEdite as propriedades do diretório virtual realtime. Na guia Documentos,certifique-se de que a caixa de seleção Ativar página de conteúdo padrãoesteja marcada e que index.htm seja o primeiro item da lista.

8. Edite as propriedades do Web Site Padrão. Inclua um Filtro ISAPI chamadoRealtime JBoss, com o executável c10_location/realtime/configuration/isapi_redirect.dll

9. Ative a compactação HTTP para os conteúdos estático e dinâmico no IIS.10. Reinicie o serviço IIS Admin.11. Se estiver usando a versão 7.5 do IIS ou posterior, será necessário fazer o

seguinte para se assegurar que os painéis sejam renderizados corretamente:a. Abra a janela Comando com privilégios elevados.b. Acesse o diretório Windows/System32/inetsrv.c. Insira o comando a seguir:

appcmd.exe set config "Default Web Site/" -section:system.webServer/httpErrors -existingResponse:PassThrough

Caso não esteja usando o Website Padrão, assegure-se de alterar DefaultWeb Site no comando para o nome apropriado de seu website.

Verificando a Configuração para o Conteúdo Estático e DinâmicoApós ter configurado seus servidores para conteúdo estático e dinâmico, você deveverificar a configuração.

Execute o seguinte para verificar se seus servidores estão configuradoscorretamente.

Procedimento

Em seu navegador da Web, insira a seguinte URL:http://web server name:web server port

Resultados

O navegador deve redirecioná-lo para a página de entrada do IBM CognosReal-time Monitoring. Se clicar em Modelar Meus Dados em Tempo Real, deveráobter uma tela de login para o IBM Cognos Real-time Monitoring.

Configurando a Conexão Única para o eTrust SiteMinderEsta seção descreve como configurar a conexão única (SSO) para eTrust SiteMinder.

Procedimento1. Configure o SiteMinder para ter uma variável de cabeçalho, como SM_USER,

que contém o nome do usuário que está efetuando login.2. No IBM Cognos Real-time Monitoring sincronize todos os usuários a partir do

mesmo provedor de diretório que o SiteMinder está usando.Todos os nomes de usuários que estão sendo transmitidos através da variáveldo cabeçalho SM_USER precisam existir no Real-time Monitoring.

80 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 89: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

3. Efetue login no IBM Cognos Real-time Monitoring Workbench e acesseConfigurações do Sistema em Console Administrativo.

4. Em Configurações do Sistema, faça o seguinte:v Selecione Gerenciamento e Autenticação do Usuário

v Selecione a caixa de seleção Ativar Conexão Única.v Configure o Cabeçalho da Solicitação como SM_USER.

Nota: É necessário configurar a URL de desconexão como uma URLdiferente da usada para o IBM Cognos Real-time Monitoring Workbench ouDashboard.

Desinstalando o Real-time Monitoring do Servidor da WebExecute o programa de desinstalação para remover o IBM Cognos Real-timeMonitoring do servidor da Web, se o servidor da Web estiver instalado em umcomputador diferente.

Procedimento1. Inicie o desinstalador.2. Escolha o idioma para usar para o desinstalador e clique em Avançar.3. Selecione IBM Cognos Real-time Monitoring e clique em Avançar.4. Quando o desinstalador tiver concluído, clique em Concluir.5. Se for um servidor Apache HTTP da Web ou IBM HTTP Server (IHS), você

também deverá remover realtime.conf do diretório conf.d

Resultados

Todos os arquivos de programas são excluídos. Os arquivos de log do Real-timeMonitoring que permanecem nos diretórios c10_location/instlog ec10_location/uninstall podem ser excluídos com segurança.

Capítulo 9. Instalando, Configurando e Desinstalando Arquivos do Servidor da Web Real-time Monitoring 81

Page 90: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

82 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 91: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Capítulo 10. Configurando o Real-time Monitoring Após aInstalação

Esta seção descreve como configurar o IBM Cognos Real-time Monitoring apósinstalar o aplicativo no servidor de aplicativos e configurar o conteúdo estático noservidor da Web.

Para obter informações detalhadas sobre a configuração da interoperabilidade entreo Real-time Monitoring e o IBM Cognos Workspace, consulte a seção deconfiguração de interoperabilidade no Guia do Usuário do IBM Cognos Real-timeMonitoring Workbench.

Configurando o Real-time Monitoring no IBM Cognos Real-timeMonitoring Workbench

Esta seção descreve como definir configurações para o IBM Cognos Real-timeMonitoring.

A maioria das definições de configuração para o Real-time Monitoring é executadaa partir do Console Administrativo no Real-time Monitoring Workbench. Apósinstalar e implementar o Real-time Monitoring, é necessário definir algumasconfigurações antes que os usuários possam usar o produto:v Identifique um diretório para os arquivos de log (criador de logs de recuperação

e local do ponto de verificação).v Ative o e-mail configurando a conexão do SMTP (Protocolo Simples de

Transporte de Correio).v Especifique o local e a senha do keystore do usuário.

Todas as configurações são descritas nas etapas a seguir.

Há algumas configurações que são necessárias para configurar os cubos e asvisualizações do Real-time Monitoring como uma origem de dados no IBM CognosBusiness Intelligence. Ao publicar um pacote, certifique-se de limpar o Modo deConsulta Dinâmica para os cubos e as visualizações. No IBM Cognos FrameworkManager, esta opção é configurada por padrão.

Para visualizações, após você criar um assunto de consulta em uma visualização,na janela Definição do Assunto da Consulta, na guia Informações da Consulta,clique em Opções. Em seguida, na guia Configurações de SQL, no Tipo de SQL,selecione Cognos, que pode ser o padrão.

Procedimento1. Efetue login no IBM Cognos Real-time Monitoring Workbench.

Usando o Microsoft Internet Explorer 6.0 ou mais novo, conecte-se ao IBMCognos Real-time Monitoring Workbench a partir do servidor de aplicativosque está executando o IBM Cognos Real-time Monitoring:http://web server name:web server port/cognos/realtime/landing/landingpage.htm

2. Na página de login, insira o nome de usuário rtmadmin e a senha manager.

© Copyright IBM Corp. 2003, 2014 83

Page 92: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Na primeira vez em que você efetuar login após a instalação, uma caixa dediálogo solicitará que você conclua várias configurações do sistema necessáriasse elas não foram configuradas anteriormente. Se as propriedades deinicialização tiverem sido configuradas a partir de um arquivo de texto, a caixade diálogo não aparecerá.

3. Clique em Configurações do Sistema.4. Conclua as seguintes configurações em Configurações do Sistema:

Tabela 26. Configurações Obrigatórias do Sistema Real-time MonitoringConfigurando Local da Configuração em Configurações do Sistema

Diretório do log de recuperação Configuração de ponto de verificação

Diretório de criação de log Criação de Log

Host SMTP Configuração de SMTP. Este é o nome do host do e-mail que fornece o transporte. Um nometípico se pareceria com este: mail.mydomain.com.

Endereço SMTP de saída Configuração de SMTP. Este é o endereço que aparece no campo De para todos os e-mailsenviados pelo sistema.

Usuário SMTP Configuração de SMTP. Este é o nome de usuário que o sistema usa para acessar o transporte.

Local da keystore Configuração de Criptografia. Este é o local e o nome do keystore do usuário.

Senha da keystore Configuração de Criptografia. Esta é a senha do keystore do usuário. Esta senha é usada paraabrir o keystore. A senha do keystore para o keystore fornecido na mídia de instalação é8deb5102f8.

Senha PrivateKey de usuário Configuração de Criptografia. Esta é a senha de chave privada do usuário. Esta senha é usadacomo um valor inicial para criptografar o usuário. A senha do keystore fornecida na mídia deinstalação é 8deb5102f8.

A configuração do SMTP (protocolo simples de transporte de correio) especificacomo o Real-time Monitoring se conecta ao servidor de correio que entreganotificações por e-mail. O servidor é externo ao Real-time Monitoring e égerenciado por seu administrador do sistema de e-mail. Entre em contato comesse administrador para configurar uma conta para o Real-time Monitoring epara obter detalhes sobre estas definições de configuração.Você precisa de keystores de administrador e de usuário para criptografia edecriptografia de senha. É necessário especificar os locais destes keystores. Porpadrão, o arquivo keystore de Administrador, admin.jks, e o arquivo keystoredo usuário, user_sample.jks, estão localizados no diretório c10_location/realtime/configuration/keystore. A senha para Senha do Keystore doAdministrador e para Senha PrivateKey do Administrador para o arquivoadmin.jks file é 40fd2442fa. Estas senhas são usadas para criptografar o usuáriortmadmin. A senha para a Senha do Keystore e para Senha PrivateKey doUsuário para o arquivo user_sample.jks é 8deb5102f8. Estas senhas são usadaspara criptografar os usuários diferentes do usuário rtmadmin.

Nota: Os keystores de amostra estão localizados no diretório\c10_location\realtime\configuration\keystore, e você é avisado para criar seupróprio.

5. Clique em OK.

Nota: Você não poderá sair da caixa de diálogo Configurações do Sistema atéter concluído todas as configurações.

6. Para iniciar o trabalho, clique em Modelar Meus Dados em Tempo Real.

Definindo as Configurações do protocolo LDAPAlém de permitir criar manualmente usuários e permissões de usuário, o IBMCognos Real-time Monitoring permite importar informações sobre o usuário apartir de provedores de protocolo LDAP suportados.

84 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 93: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

O Real-time Monitoring pode ser integrado com qualquer provedor LDAP quesuporta o Protocolo LDAP Versão 3. Para obter a lista de provedores deautenticação suportados, consulte o Relatórios de Compatibilidade do Produto deSoftware IBM (www.ibm.com/support/docview.wss?uid=swg27042164).

O IBM Cognos Real-time Monitoring pode ser configurado para sincronizaçõesplanejadas com o servidor LDAP para atualizar os usuários e as funções existentes.A sincronização manual também é uma opção.

Nota: Uma "função" no Real-time Monitoring mapeia para um "grupo" no servidorLDAP. No processo de sincronização, o Real-time Monitoring inclui ou atualiza osusuários. Os grupos LDAP são convertidos para funções no Real-time Monitoring.Ao serem importadas, as funções retém suas designações de usuário LDAP.

Para obter informações sobre LDAP, consulte as seções “Considerações naConectividade do protocolo LDAP” e LDAP na publicação IBM Cognos Real-timeMonitoring Workbench User Guide.

Considerações na Conectividade do protocolo LDAPEsta seção identifica o que é necessário considerar ao usar conectividade doprotocolo LDAP.v Se um usuário ou uma função for criada localmente no servidor IBM Cognos

Realtime Monitoring, e o mesmo usuário estiver localizado na origem doprotocolo LDAP, o usuário LDAP será ignorado. Há uma exceção apenas para ousuário rtmadmin.

v Como as permissões nunca são armazenadas ao usar um protocolo LDAP(LDAP), quando as funções, os usuários e as associações de função sãoimportadas a partir de uma origem LDAP externa, nenhuma permissão éimportada. As permissões são designadas localmente no IBM Cognos Real-timeMonitoring Workbench. Para obter mais informações, consulte as seções quedescrevem permissões no Guia de Usuário do IBM Cognos Real-time MonitoringWorkbench e na Referência Técnica do IBM Cognos Real-time Monitoring.

v O Real-time Monitoring importa um usuário mas nenhum dos grupos enenhuma das funções às quais o usuário é designado. O usuário é criado epermanece não designado a nenhuma função no Real-time Monitoring.

v Se o Real-time Monitoring importar uma tabela mas não tiver usuáriosmembros, a função será criada, mas não terá nenhum membro.

v Os usuários que foram criados manualmente no Real-time Monitoring podemser designados apenas às funções criadas manualmente. Além disso, os usuáriossincronizados a partir do LDAP também podem ser designados às funçõescriadas manualmente. Entretanto, as funções sincronizadas a partir de LDAP nãopodem ser designadas a usuários criados manualmente. Apenas usuáriossincronizados podem ser designados às funções sincronizadas. Tais designaçõesdevem ser feitas no servidor LDAP ou no Microsoft Activity Directory Server.

Capítulo 10. Configurando o Real-time Monitoring Após a Instalação 85

Page 94: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

86 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 95: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Capítulo 11. Solucionando Problemas de sua Instalação

Esta seção descreve tarefas que podem ser executadas se você precisar solucionarproblemas em sua instalação.

Resolvendo um ProblemaResolução de Problemas é uma abordagem sistemática para solucionar um problema.O objetivo da resolução de problemas é determinar por que alguma coisa nãofunciona como esperado e como resolver o problema.

A primeira etapa no processo de resolução de problemas é descrever o problemacompletamente. As descrições do problema ajudam você e o representante dosuporte técnico da IBM a saber onde iniciar a localizar a causa do problema. Estaetapa inclui perguntar questões básicas:v Quais são os sintomas do problema?v Onde o problema ocorre?v Quando o problema ocorre?v Sob quais condições o problema ocorre?v O problema pode ser reproduzido?

As respostas para essas questões geralmente conduzem a uma boa descrição doproblema, o que pode, por sua vez, conduzir à resolução do problema.

Quais são os sintomas do problema?

Ao iniciar a descrever um problema, a questão mais óbvia é “Qual é o problema?”Essa questão pode parecer direta; entretanto, é possível quebrá-la em váriasquestões concentradas que criam uma imagem mais descritiva do problema. Essasquestões podem incluir:v Quem ou o que está relatando o problema?v Quais são os códigos de erro e mensagens?v Como o sistema falha? Por exemplo, é o problema um loop, interrupção,

paralisação, degradação de desempenho ou resultado incorreto?

Onde o problema ocorre?

Determinar onde o problema é originado nem sempre é fácil, mas é uma dasetapas mais importantes na resolução de um problema. Várias camadas detecnologia podem existir entre o relatório e os componentes com falha. Redes,discos e drivers são apenas alguns dos componentes a considerar durante ainvestigação de problemas.

As seguintes questões ajudam a isolar a camada do problema:v O problema é específico de uma plataforma ou sistema operacional, ou é comum

entre diversas plataformas ou sistemas operacionais?v O ambiente e configuração atuais são suportados?

Se uma camada relata o problema, o problema não é necessariamente originadonessa camada. Parte da identificação de onde um problema é originado é o

© Copyright IBM Corp. 2003, 2014 87

Page 96: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

entendimento do ambiente no qual ele existe. Leva algum tempo para descrevercompletamente o ambiente do problema, incluindo o sistema operacional e versão,todos os produtos de software correspondentes e versões e o hardware. Confirmeque a execução está dentro de um ambiente que é suportado; muitos problemaspodem ser rastreados para níveis incompatíveis de software que não sãodestinados a executar em conjunto ou não foram testados juntos integralmente.

Quando o problema ocorre?

Desenvolver uma linha de tempo detalhada de eventos conduzindo para umafalha, especialmente para casos que são de ocorrências únicas. É possíveldesenvolver mais facilmente uma linha de tempo trabalhando para trás: Inicie nomomento em que um erro foi relatado (tão precisamente quanto possível, mesmoque em milissegundos) e retroceda através dos logs e informações disponíveis.Geralmente, é necessário olhar apenas até o primeiro evento suspeito localizado emum log de diagnóstico.

Para desenvolver uma linha de tempo detalhada dos eventos, responda estasquestões:v O problema acontece apenas em um determinado período do dia ou noite?v Com que frequência o problema acontece?v Qual sequência de eventos conduz até o momento em que o problema é

relatado?v O problema aconteceu após uma mudança de ambiente, como uma atualização

ou uma instalação de software ou hardware?

Sob quais condições o problema ocorre?

Saber quais sistemas e aplicativos estão em execução no momento em que umproblema ocorre é uma parte importante da resolução de problemas. Estasquestões sobre o ambiente podem ajudar a identificar a causa do problema:v O problema sempre ocorre quando a mesma tarefa está sendo executada?v É necessário que uma determinada sequência de eventos ocorra para que o

problema ocorra?v Algum outro aplicativo falha no mesmo momento?

Responder esses tipos de questões pode ajudar a explicar o ambiente no qual oproblema ocorre e a correlacionar qualquer dependência. Lembre-se de que apenasporque diversos problemas podem ter ocorridos em torno do mesmo horário, osproblemas não estão necessariamente relacionados.

O problema pode ser reproduzido?

Problemas que podem ser reproduzidos são frequentemente mais fáceis deresolver. Entretanto, problemas que podem ser reproduzidos podem ter umadesvantagem. Se o problema produz um impacto significativo aos negócios, não édesejado que ele se repita. Se possível, recrie o problema em um ambiente dedesenvolvimento ou de teste, que geralmente oferece maior flexibilidade e controledurante a investigação. Responda as seguintes questões:v O problema pode ser recriado em um sistema de teste?v Diversos usuários ou aplicativos estão encontrando o mesmo tipo de problema?v O problema pode ser recriado executando um comando único, um conjunto de

comandos ou um aplicativo específico?

88 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 97: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Procurando em Bases de ConhecimentoÉ possível frequentemente localizar soluções para problemas procurando nas basesde conhecimento da IBM. É possível otimizar os resultados usando recursosdisponíveis, ferramentas de suporte e métodos de procura.

Sobre Esta Tarefa

É possível localizar informações úteis procurando no centro de informações doIBM Cognos, mas às vezes é necessário ver além do centro de informações pararesolver problemas.

Procedimento

Para procurar as informações de que precisa nas bases de conhecimento, use umaou mais das seguintes abordagens:v Localize o conteúdo necessário usando o Portal de Suporte IBM (Porta de

Suporte do IBM Cognos Business Intelligence).O IBM Support Portal é uma visualização unificada e centralizada de todas asferramentas de suporte técnico e informações para todos os sistemas, software eserviços IBM. O Porta de Suporte IBM deixa você acessar o portfólio de suporteeletrônico da IBM a partir de um local. É possível padronizar as páginas parafocalizar as informações e recursos necessários para prevenção de problema eresolução de problemas mais rápida. Familiarize-se com o Portal de Suporte IBMvisualizando os vídeos demo (https://www.ibm.com/blogs/SPNA/entry/the_ibm_support_portal_videos) sobre essa ferramenta. Esses vídeos apresentama você o IBM Support Portal, exploram outros a resolução de problemas e outrosrecursos e demonstram como é possível padronizar a página movendo,incluindo e excluindo portlets.

v Procure conteúdo sobre o IBM Cognos usando um dos seguintes recursostécnicos adicionais:– APARS do IBM Cognos BI (relatórios de problemas)– Web site de suporte do IBM Cognos BI.– Fóruns e comunidades do IBM Cognos.

v Procure conteúdo usando a procura de cabeçalho principal IBM. É possível usara procura de cabeçalho principal IBM digitando a sequência de procura nocampo Procurar na parte superior de qualquer página ibm.com.

v Procure conteúdo usando qualquer mecanismo de procura externo, comoGoogle, Yahoo ou Bing. Se usar um mecanismo de procura externo, é maisprovável que seus resultados incluam informações que estejam fora do domínioibm.com. Entretanto, às vezes, é possível localizar informações úteis de soluçãode problema sobre produtos IBM em newsgroups, fóruns e blogs que nãoestejam no ibm.com.

Dica: Inclua “IBM” e o nome do produto na procura se estiver procurandoinformações sobre um produto IBM.

Obtendo CorreçõesUma correção de produto pode estar disponível para resolver seu problema.

Procedimento

Para localizar e instalar correções:

Capítulo 11. Solucionando Problemas de sua Instalação 89

Page 98: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

1. Determine qual correção é necessária (Fix Central) (abre na nova janela)(http://www.ibm.com/support/fixcentral/)

2. Faça download da correção. Abra o documento de download e siga o link naseção “Pacote de Download”.

3. Aplique a correção seguindo as instruções na seção “Instruções de Instalação”do documento de download.

4. Assine para receber notificações por e-mail semanalmente sobre correções eoutras informações do Suporte IBM.

Entrando em Contato com o Suporte IBMO suporte IBM fornece acesso a uma variedade de recursos IBM para ajuda comquestões de software.

Antes de Iniciar

Após tentar localizar sua resposta ou solução usando outras opções de autoajudacomo notas técnicas, é possível entrar em contato com o Suporte IBM. Antes deentrar em contato com o Suporte IBM, sua empresa deve ter um contrato demanutenção ativo da IBM e você deve ser autorizado a enviar problemas à IBM.Você também deve ter as seguintes informações em mãos:v Seu número de identificação de cliente.v Seu número de solicitação de serviço, se for uma solicitação de serviço em

progresso.v O número de telefone onde você pode ser encontrado.v A versão do software utilizada.v A versão do ambiente operacional usada.v Uma descrição do que estava fazendo quando o problema ocorreu.v O que as mensagens de erro exibidas dizem, exatamente.v As ações tomadas para tentar resolver o problema.

Para obter informações sobre os tipos de suporte disponíveis, consulte o tópicoPortfólio de Suporte no Software Support Handbook (abre na nova janela).

Procedimento

Conclua as seguintes etapas para entrar em contato com o Suporte IBM com umproblema:1. Defina o problema, reúna informações complementares e determine a

gravidade do problema. Para obter informações adicionais, consulte o tópicoObtendo o Suporte IBM (abre na nova janela) no Software Support Handbook.

2. Reúna as informações de diagnóstico.3. Envie o problema para o Suporte IBM de uma das seguintes formas:

v Usando o IBM Support Assistant (ISA): Use este recurso para abrir, atualizare visualizar uma Solicitação de Serviço Eletrônica com a IBM. Quaisquerdados que tenham sido coletados podem ser conectados à solicitação deserviço. Isso agiliza a análise e reduz o tempo para resolução.

v Online através do IBM Support Portal (abre na nova janela): é possível abrir,atualizar e visualizar todas as Solicitações de Serviço a partir do portletSolicitação de Serviço na página Solicitação de Serviço.

v Por telefone: para obter o número do telefone a ser chamado, consulte apágina da web Diretório de Contatos no Mundo Todo (abre na nova página).

90 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 99: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Resultados

Se o problema que enviou for um defeito de software ou documentação ausente ouinexata, o Suporte IBM cria um Authorized Program Analysis Report (APAR). OAPAR descreve o problema em detalhes. Sempre que possível, o Suporte IBMfornece uma solução alternativa que é possível de ser implementada até que oAPAR seja resolvido e uma correção seja entregue. A IBM publica APARsresolvidos no Web site de suporte IBM diariamente, para que outros usuários quetêm o mesmo problema possam se beneficiar da mesma resolução.

Trocando Informações com a IBMPara diagnosticar ou identificar um problema, talvez seja necessário fornecer aoSuporte IBM dados e informações do seu sistema.

Em outros casos, o Suporte IBM pode fornecer ferramentas ou utilitários para usarpara determinação de problema.

Enviando Informações ao Suporte IBMPara reduzir o tempo que leva para resolver seu problema, é possível enviarinformações de rastreio e diagnóstico ao Suporte IBM.

Procedimento

Para enviar informações de diagnóstico ao Suporte IBM:1. Abra um problem management record (PMR). É possível usar o IBM Support

Assistant (abre na nova janela) ou a ferramenta IBM Service Request (abre nanova janela).

2. Colete os dados diagnósticos necessários. Os dados diagnósticos ajudam areduzir o tempo que leva para resolver seu PMR. É possível coletar os dadosdiagnósticos manual ou automaticamente.

3. Compacte os arquivos usando o programa TRSMAIN ou AMATERSE. Façadownload do utilitário gratuito da IBM para o sistema IBM Cognos BI e, emseguida, instale o utilitário usando o comando TSO RECEIVE.

4. Transfira os arquivos para a IBM. É possível usar um dos seguintes métodospara transferir os arquivos para a IBM:v A ferramenta Service Request (abre na nova janela)v Métodos de upload de dados padrão: FTP, HTTPv Métodos seguros de upload de dados: FTPS, SFTP, HTTPSv E-mailSe você estiver usando um produto IBM Cognos e usar ServiceLink / IBMLinkpara enviar PMRs, poderá enviar dados diagnósticos para o suporte IBM emum e-mail ou usando FTP.Todos esses métodos de troca de dados são explicados no site de Suporte IBM(abre na nova janela).

Recebendo Informações do Suporte IBMOcasionalmente, um representante de suporte técnico da IBM pode pedir que façadownload das ferramentas de diagnóstico ou de outros arquivos. É possível usarFTP para fazer download desses arquivos.

Capítulo 11. Solucionando Problemas de sua Instalação 91

Page 100: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Antes de Iniciar

Certifique-se de que seu representante de suporte técnico da IBM tenha fornecido oservidor preferencial para usar para o download dos arquivos e os nomes exatosdo diretório e do arquivo para acessar.

Procedimento

Para fazer download desses arquivos a partir do Suporte IBM:1. Use FTP para conectar ao site que seu representante de suporte técnico da IBM

forneceu e efetue login como anonymous. Use seu endereço de e-mail como asenha.

2. Altere para o diretório apropriado:a. Altere para o diretório /fromibm.

cd fromibm

b. Altere para o diretório que seu representante de suporte técnico da IBMforneceu.cd nameofdirectory

3. Ative o modo binário para sua sessão.binary

4. Use o comando get para fazer download do arquivo que seu representante desuporte técnico da IBM especificou.get filename.extension

5. Encerre a sessão FTP.quit

Subscrevendo para Atualizações de SuportePara manter-se informado com informações importantes sobre os produtos IBMusados, é possível subscrever para atualizações.

Sobre Esta Tarefa

Ao subscrever para receber atualizações, é possível receber informações técnicasimportantes e atualizações para recursos e ferramentas de suporte específicas. Épossível subscrever para atualizações usando uma das duas abordagens:

Alimentações RSS e assinaturas de mídia socialAs seguintes alimentações RSS e assinaturas de mídia social estãodisponíveis para o IBM Cognos BI:v Alimentação RSS para um fórum do developerWorks.v Assinatura para o blog de bloco de notas de Suporte do Cognosv Alimentação RSS para o site de Suporte do IBM Cognos Business

Intelligence

Para obter informações gerais sobre RSS, incluindo etapas para iniciar euma lista de páginas da Web IBM ativada para RSS, visite o site IBMSoftware Support RSS feeds.

Minhas NotificaçõesCom Minhas Notificações, é possível subscrever para atualizações deSuporte para qualquer produto IBM. É possível especificar se desejareceber avisos por e-mail diariamente ou semanalmente. É possívelespecificar que tipo de informações deseja receber, como publicações, dicase sugestões, flashes do produto (também conhecidos como alertas),downloads e drivers. Minhas Notificações permite customizar e categorizar

92 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 101: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

os produtos sobre os quais deseja ser informado e os métodos de entregamais adequados às suas necessidades.

Procedimento

Para subscrever para atualizações de Suporte:1. Subscreva para alimentações RSS do Produto.2. Para subscrever para Minhas Notificações, inicie indo até o Portal de Suporte

IBM e clicando em Minhas Notificações no portlet Notificações.3. Se já estiver registrado em Meu suporte, efetue sign in e ignore a próxima

etapa. Se não estiver registrado, clique em Registrar agora. Conclua oformulário de registro usando seu endereço de e-mail como o ID IBM e cliqueem Submeter.

4. Clique em Editar perfil.5. Clique em Incluir produtos e escolha uma categoria de produto; por exemplo,

Software.6. Na segunda lista, selecione um segmento de produto; por exemplo, Dados &

Information Management.7. Na terceira lista, selecione um subsegmento do produto, por exemplo, Bancos

de Dados.8. Selecione os produtos para os quais deseja receber atualizações.9. Clique em Incluir produtos.

10. Após selecionar todos os produtos que são de seu interesse, clique emSubscrever para e-mail na guia Editar perfil.

11. Selecione Envie estes documentos por e-mail semanalmente.12. Atualize o endereço de e-mail conforme necessário.13. Na Lista de documentos, selecione a categoria do produto; por exemplo,

Software.14. Selecione os tipos de documentos para os quais deseja receber informações.15. Clique em Atualizar.

Resultados

Até que as preferências de Alimentações RSS e de Minhas Notificações sejammodificadas, você recebe as notificações de atualizações que foram solicitadas. Épossível modificar as preferências quando necessário (por exemplo, se parar deusar um produto ou iniciar o uso de outro produto).

Iniciando no Modo de SegurançaSe o sistema do IBM Cognos Real-time Monitoring estiver em 100% de uso daCPU, a memória estiver baixa ou se o sistema não estiver respondendo, vocêpoderá desejar iniciar o aplicativo no modo de segurança.

Quando você inicia o Real-time Monitoring no modo de segurança, todos oseventos, tais como fluxos de dados e tabelas de consulta, são pausados. O IBMCognos Real-time Monitoring Dashboard e Workbench exibem um banner queindica que o sistema está atualmente no modo de segurança. O modo de segurançaestará em efeito até você configurar a propriedade safemode como false.

Capítulo 11. Solucionando Problemas de sua Instalação 93

Page 102: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Procedimento1. Pare o Real-time Monitoring.2. Edite o arquivo realtime.properties para incluir a seguinte linha:

Safe\ Mode=true3. No servidor de aplicativos, reinicie o Real-time Monitoring.

Resultados

O Real-time Monitoring inicia no modo de segurança.

Dica: Para desativar o modo de segurança, remova a entrada do modo desegurança do arquivo realtime.properties e reinicie o Real-time Monitoring.

Mensagem de Erro Keystore Não Localizado ApareceAo tentar iniciar o IBM Cognos Real-time Monitoring Dashboard ou o IBM CognosReal-time Monitoring Workbench, uma mensagem aparece indicando que okeystore não foi localizado.

Verifique o caminho do keystore para assegurar que ele seja exato.

Mensagem de Erro Não é Possível Conectar-se ao Banco de DadosAparece no Console do Servidor de Aplicativos

No console do servidor de aplicativos, aparece uma mensagem indicando que elenão pode se conectar ao banco de dados do IBM Cognos Real-time Monitoring.

Assegure o seguinte:v O banco de dados está em execução.v O banco de dados está acessível a partir do servidor de aplicativos no qual o

Real-time Monitoring está instalado.v A origem de dados possui os parâmetros de conexão apropriados.

Os menus e controles do IBM Cognos Real-time Monitoring Dashboardaparecem truncados ou não funcionam corretamente

À medida que você trabalha no IBM Cognos Real-time Monitoring Dashboard, oscontroles não aparecem corretamente.

Por exemplo, não é possível ver todos os itens da seleção se você clica no controleEscolher Pasta.

Assegure que suas configurações do navegador permitam janelas iniciadas peloscript sem restrições de tamanho ou de posição. Para obter instruções detalhadassobre a configuração de navegadores, consulte “Configurando Navegadores daWeb” na página 9.

Domínio de Rede Ausente na Imagem da Máquina Virtual do Real-timeMonitoring

O IBM Cognos Real-time Monitoring pode ser executado em uma máquina virtualquando for necessário testar sua configuração ou desenvolver um sistema detreinamento.

94 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 103: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Uma versão de máquina virtual do Real-time Monitoring pode não atender todosos requisitos, tal como ter um domínio de rede para cookies que ativam a conexãoúnica.

Você pode substituir um endereço de Protocolo da Internet (IP) para um domíniode rede ao configurar a conexão única em uma máquina virtual.

Comando Inválido: WebSpherePluginConfigVocê deve ter o WebSpherePluginConfig configurado no arquivo realtime.conf seestiver executando o Apache como o servidor da Web com o IBM CognosWebSphere Application Server.

Você pode receber uma mensagem de erro indicando que há um comando inválidose o WebSpherePluginConfig está escrito de maneira errada ou se ele é definidopor um módulo que não está incluído na configuração do servidor.

Para corrigir este problema, é necessário comentar a linha ou excluir a linha quetem relação com WebSpherePluginConfig.

Erro do Servidor de Aplicativos: Propriedade Não DisponívelO servidor de aplicativos indica que o servlet foi iniciado mas uma propriedadenão está disponível.

Isso indica que o arquivo obiProperties.jar não foi localizado no caminho de classeou não foi carregado. Se a configuração estiver definida corretamente, pode sernecessário reiniciar o servidor de aplicativos para que as alterações tenham efeito.

Mensagem de Erro de Processamento ApareceAs mensagens de erro de processamento podem incluir problemas com aconectividade de rede.

Verifique os problemas de rendimento.

Mensagem de Erro de Segurança ApareceOs problemas de segurança podem incluir problemas de autenticação.

Assegure que o provedor de autenticação esteja executando corretamente.

Capítulo 11. Solucionando Problemas de sua Instalação 95

Page 104: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

96 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 105: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Capítulo 12. Configurando o Sistema de Mensagens Java

Para usar o Sistema de Mensagens Java (JMS), você deve customizar o MessageDriven Bean (MDB) para seu servidor de aplicativos.

Para customizar o MDB, execute as etapas a seguir.

Procedimento1. Se não tiver o ANT em seu servidor, instale-o.2. Crie um diretório denominado mdb em seu servidor.3. Localize o diretório /samples/cqmdb em seu CD de instalação e copie o

conteúdo de /samples/cqmdb para o diretório mdb que acabou de criar.4. Configure as variáveis do sistema JAVA_HOME e ANT_HOME em seu

servidor. A variável JAVA_HOME configura o caminho para Java. ANT_HOMEconfigura o caminho para ANT. Por exemplo:v JAVA_HOME=/usr/java6_64v ANT_HOME=/opt/apache-ant-1.7.1

5. Em seu diretório mdb, localize e abra o arquivo env.properties.6. Configure as propriedades a seguir no arquivo env.properties:

v jms_jarConfigure esta propriedade para o caminho para os arquivos J2EE JAR deseu servidor de aplicativos. Por exemplo,jms_jar=/opt/WebSphere/lib/j2ee.jar

v JMS.TOPICNAMESe estiver implementando um Tópico JMS, configure esta propriedade com onome de seu Tópico JMS. Por exemplo, JMS.QUEUENAME=Topic111.Certifique-se de excluir JMS.QUEUENAME do arquivo se estiverespecificando JMS.TOPICNAME.

v JMS.QUEUENAMESe estiver implementando uma Fila JMS, configure esta propriedade com onome de sua Fila JMS. Por exemplo, JMS.QUEUENAME=Queue111.Certifique-se de excluir JMS.TOPICNAME do arquivo se estiverespecificando JMS.QUEUENAME.

v JMS.JNDINAMEConfigure JMS.JNDINAME igual ao nome da JNDI da fila ou do tópico noqual o MDB está atendendo. Por exemplo, JMS.JNDINAME=jms/com.cognos.obi.Queue111.

v JMS.EVENTNAMEConfigure JMS.EVENTNAME no nome do fluxo de dados que planejaconfigurar no IBM Cognos Real-time Monitoring Workbench. Por exemplo,JMS.EVENTNAME=event111.

v APP.INSTANCENAMEConfigure APP.INSTANCENAME como o nome para sua instância do IBMCognos Real-time Monitoring. Por exemplo,APP.INSTANCENAME=cognosrtm.

v APP.PORT

© Copyright IBM Corp. 2003, 2014 97

Page 106: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Configure APP.PORT para a porta em seu servidor da Web na qual o IBMCognos Real-time Monitoring está em execução. Por exemplo, APP.PORT=80.O padrão é 80.

v APP.HOSTConfigure APP.HOST como o nome do host para o IBM Cognos Real-timeMonitoring. Por exemplo, APP.HOST=localhost. O padrão é host local.

7. Execute ant em seu diretório mdb.Após ANT ser concluído, você deverá ver um arquivo EAR no diretóriomdb/deploy. O arquivo EAR é jmsmdb_topic_<topicname>.ear oujmsmdb_queue_<queuename>.ear, dependendo de se você especificou o nomede um Tópico JMS ou de uma Fila JMS em seu arquivo env.properties. Porexemplo, se você especificou JMS.TOPICNAME=Topic111, ANT criará o arquivojmsmdb_topic_Topic111.ear. Se você especificou JMS.QUEUE=Queue111, ANTcriará o arquivo jmsmdb_topic_Topic111.ear.

8. Implemente o MDB em seu servidor de aplicativos.

98 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 107: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Apêndice A. Recursos de Acessibilidade

Os recursos de acessibilidade ajudam usuários com alguma deficiência, comomobilidade reduzida ou visão limitada, a utilizar produtos de tecnologia dainformações.

Consulte o Centro de Acessibilidade IBM (http://www.ibm.com/able) para obterinformações adicionais sobre a confirmação que a IBM tem para acessibilidade.

Atalhos de teclado do assistente de instalaçãoOs atalhos de teclado, ou teclas de atalho, oferecem um método mais fácil enormalmente mais rápido para navegar e usar o software

O assistente de instalação usa as teclas de navegação padrão do sistemaoperacional Microsoft Windows juntamente com as teclas específicas do aplicativo.

Nota: Os atalhos de teclado a seguir são baseados nos teclados padrão dos EUA.

A tabela a seguir lista os atalhos de teclado que podem ser usados para executaralgumas das principais tarefas no assistente de instalação no sistema operacionalWindows.

Tabela 27. Lista de Atalhos de Teclado em um Sistema Operacional WindowsAções Pressione

Mover para o próximo campo em uma página Tab

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.

Tabela 28. Lista de Atalhos de Teclado em um Sistema Operacional UNIX ou LinuxAções Pressione

Mover para o próximo campo em uma página Tab

Mover para o campo anterior em uma pá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

A tabela a seguir lista os atalhos de teclado que podem ser usados para executaralgumas das principais tarefas na página do contrato de licença do assistente deinstalação.

Tabela 29. Lista de Atalhos de Teclado na Página Contrato de LicençaAções Pressione

Aceitar o contrato de licença Alt+A

Recusar o acordo de licença Alt+D

Encerrar o assistente de instalação Alt+x

© Copyright IBM Corp. 2003, 2014 99

Page 108: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

A tabela a seguir lista os atalhos de teclado que podem ser usados para executaralgumas das principais tarefas no IBM Cognos Configuration em um sistemaoperacional Windows.

Tabela 30. Lista de Atalhos de Teclado para IBM Cognos Configuration em um SistemaOperacional WindowsAções Pressione

Salvar a configuração atual Crtl+S

Fechar o IBM Cognos Configuration Alt+F4

Renomear o item selecionado F2

Exibir o menu Arquivo Alt+F

Exibir o menu Editar Alt+E

Exibir o menu Visualizar Alt+V

Exibir o menu Ações Alt+A

Exibir o menu Ajuda Alt+H

A tabela a seguir lista os atalhos de teclado que podem ser usados para executaralgumas das principais tarefas no IBM Cognos Configuration em um sistemaoperacional UNIX ou Linux.

Tabela 31. Lista de Atalhos de Teclado para o IBM Cognos Configuration em um SistemaOperacional UNIX ou LinuxAções Pressione

Salvar a configuração atual Crtl+S

Fechar o IBM Cognos Configuration Alt+F4

Renomear o item selecionado F2

100 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 109: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Apêndice B. Ajuste de Mapas Geográficos

Este apêndice explica o esquema do banco de dados geográfico e como é possívelmelhorar a precisão usando o banco de dados e o software de codificaçãogeográfica.

Melhorando a Exatidão do GeocodificadorPara melhorar a exatidão do geocodificador, é possível modificar as tabelasABBREVMAP e GEOCODECACHE na origem de dados geográficos para afetar osresultados.v ABBREVMAP

A tabela ABBREVMAP expande abreviações para que não sejam ambíguas parao codificador geográfico. A tabela ABBREVMAP é composta pelas colunasABBREV, EXPANSION e CATEGORY. O sistema usa a tabela para expandir asabreviações para o nome completo de um estado, província, país ou região.Atualmente, a tabela apresenta expansões para estados dos EUA e províncias doCanadá. Para cada linha da tabela, a coluna ABBREV armazena a abreviação, acoluna EXPANSION apresenta o nome completo correspondente à abreviação, ea coluna CATEGORY exibe a categoria em que a abreviação se encaixa. Osvalores possíveis para CATEGORY são city, stateprovince, country, region epostal code. Observe que é esperado que os valores das colunas ABBREV eEXPANSION estejam em maiúsculas, sem espaços extras iniciais ou finais, e comapenas um único espaço entre as palavras.

v GEOCODECACHEA tabela GEOCODECACHE armazena em cache os resultados dos codificadoresgeográficos. A tabela GEOCODECACHE mapeia o endereço lógico para ascoordenadas de latitude/longitude do GPS que são retornadas pelogeocodificador. É composta das colunas ADDRESS, LATITUDE, LONGITUDE,ACCURACY e LAST_ACCESS. A coluna ADDRESS armazena o endereço. Oconteúdo deve estar obrigatoriamente em caixa alta e qualquer espaço indevidodeve ser removido, inclusive espaços antes ou depois das vírgulas. LATITUDE eLONGITUDE são as coordenadas do GPS. ACCURACY pode ser qualquernúmero. Entretanto, se o valor for 6 ou maior, ele será tratado como um localexato. LAST_ACCESS é o tempo, em milissegundos, desde EPOCH. Quantomaior for esse valor, maior a probabilidade de ele se ocultar na memória (cache)durante a inicialização.Se o codificador geográfico que está sendo usado não puder localizar umendereço específico, ou se as coordenadas que receber estiverem incorretas, serápossível preencher previamente a tabela GEOCODECACHE na origem de dadosgeográficos. para preencher a tabela manualmente:– Coloque em maiúsculas todas as letras no endereço e remova todos os

espaços anteriores e posteriores (incluindo ao redor de vírgulas).– Inclua os valores necessários de Latitude/Longitude nas respectivas colunas e

use qualquer número nas colunas restantes.

Será possível melhorar a precisão ao incluir mais abreviações na tabelaABBREVMAP na origem de dados geográficos. Certifique-se de que todas asentradas estejam em maiúsculas e de que todos os espaços desnecessários sejameliminados.

© Copyright IBM Corp. 2003, 2014 101

Page 110: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Estendendo o Suporte ao Mapa GeográficoEsta seção descreve como criar um geocodificador.

É possível estender o suporte para os Mapas geográficos ao criar seu própriocodificador geográfico. Para criar um codificador geográfico, é necessárioimplementar a interface com.cognos.obi.maps.IGeocoder. Em Configurações dosistema > Mapas geográficos do IBM Cognos Real-time Monitoring Workbench, épossível digitar o nome de classe do geocodificador customizado e preencher oscampos Chave do geocodificador e URL com valores necessários ao geocodificador.O codificador geográfico pode acessar esses valores como parâmetros, por meio doretorno de chamada init(url,key) que precisa ser implementado.

Interface IGeocoderÉ possível criar seu próprio geocodificador implementando a interface IGeocoderJava (com.cognos.obi.maps.IGeocoder).

Essa interface requer que você implemente dois métodos: init e geocode.

void init(String url, String key)

O método de inicialização é um retorno de chamada de inicialização. O método deinicialização é acionado imediatamente após a montagem do codificador geográficoe assume-se que a classe do codificador tenha sido instalado sem argumentos. Osargumentos representam os parâmetros “URL Base para o geocodificador” e“"Chave do geocodificador"” nas Configurações do Sistema para MapasGeográficos. Os parâmetros dos métodos estão definidos da seguinte forma:v URL

A URL para a URL base do geocodificador inserida nas configurações do sistemade Mapas Geográficos no Console de Administrativo do Real-time MonitoringWorkbench.

v chaveA chave do geocodificador usada nas configurações do sistema de MapasGeográficos no Console Administrativo do Real-time Monitoring Workbench.GeoPoint geocode(String address) throws VCException

O método geocode obtém um endereço e retorna o objeto GeoPoint querepresenta a latitude e longitude do endereço fornecido. Se o endereço nãopuder ser processado pelo código geográfico, o método geocode deverá emitiruma VCException. Os codificadores geográficos devem também trabalhar emáreas poligonais, ou seja, não em linhas contínuas. Para obter mais informaçõessobre o objeto GeoPoint, consulte “Classe GeoPoint” na página 104.

É possível usar o método geocode da interface IGeocoder para retornar valores delatitude e longitude para valores de dimensão que os codificadores geográficospadrão não podem tratar. Por exemplo, você tem uma dimensão de Território deVendas com três níveis: Mundo, País ou Região e Local. Esses níveis têm osseguintes valores:v Mundo: “Ásia e Pacífico”, “Américas”, “Europa”v País ou Região: “USA e Canadá”, “México e América Central”v Local: “Nova Inglaterra”, “Costa Oeste”

Como o codificador geográfico do Google padrão não reconhece valores como“Costa Oeste” ou “EUA e Canadá” e não pode fornecer coordenadas de latitude e

102 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 111: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

longitude para eles, é necessário um codificador geográfico customizado que possafornecer a latitude e a longitude corretas para esses endereços.

Para certificar-se de que os endereços não sejam ambíguos, o Real-time Monitoringanexa todos os níveis de dimensão de uma granularidade mais alta ao endereço.Por exemplo, “Costa Oeste” pode se referir tanto à costa oeste dos “EUA eCanadá” ou do “México e da América Central”. Portanto, o endereço torna-se“Costa Oeste,EUA e Canadá,Américas” para especificar o endereço correto para acosta oeste dos “EUA e Canadá.” Além disso, o Real-time Monitoring coloca asequência em letra maiúscula e remove todos os espaços extras para armazenar osresultados em cache de forma eficiente. O seu codificador geográfico deve tomarendereços como “WEST COAST,USAANDCANADA,AMERICAS” ou“MEXICOANDCENTRAL AMERICA,AMERICAS” e retornar a latitude e alongitude corretas para esses endereços. Além disso, o Real-time Monitoringexpande todas as abreviações de acordo com a tabela ABBREVMAP. Por exemplo,as abreviações dos estados da Califórnia e do Oregon são expandidas de CA e ORpara CALIFÓRNIA e OREGON.

Os níveis de dimensão criam o endereço fornecido para o codificador geográfico. Épossível programar o codificador geográfico customizado de qualquer maneira quedeseje para fornecer as longitudes e latitudes corretas para os endereços que vocêespera que ele receba.

Os endereços podem ser armazenados em cache no cache de memória interna e natabela GEOCODECACHE do cache do banco de dados. Após o sistema concatenar,passar a usar maiúsculas e remover espaços extra (canonicalização) e expandirabreviações, as coordenadas geográficas serão retornadas. Se o endereço não estiverno cache da memória interna, o cache do banco de dados será verificado e ascoordenadas serão retornadas se o endereço existir no cache do banco de dados. Seo endereço não estiver no cache de memória interna ou no cache do banco dedados, o codificador geográfico processará o endereço e retornará as coordenadas.O cache de memória interna e a tabela GEOCODECACHE serão então atualizadoscom o novo endereço, se o tamanho do cache for não zero.

É possível fazer com que o sistema use sempre o codificador geográfico pararetornar as coordenadas configurando o tamanho do cache como zero. Configuraro tamanho do cache como zero faz com que todas as solicitações ignorem oscaches. Isso é útil para mapear coordenadas em movimento e ao depurar umcodificador geográfico customizado.

O cache do banco de dados armazena o endereço e as coordenadas noGEOCODECACHE. Entretanto, esses endereços podem apenas ser excluídosmanualmente. É possível preencher previamente a tabela com suas própriascoordenadas, se o endereço usado corresponder à saída do endereço após aconcatenação, canonicalização e expansão de abreviações.

O fluxo de trabalho para processamento de endereços e atualização dearmazenamento em cache é exibido no diagrama a seguir:

Apêndice B. Ajuste de Mapas Geográficos 103

Page 112: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Depois de criar seu geocodificador customizado, você deve colocá-lo em umarquivo JAR e garantir que ele faça parte do caminho de classe que o Real-timeMonitoring usa.

Classe GeoPointA classe GeoPoint contém informações de longitude e latitude. Um objeto GeoPointresulta do método geocode da interface IGeocoder.

O conceito de GeoPoint éGeoPoint(double latitude, double longitude, int accuracy)

A classe GeoPoint dispõe dos meios de se obter o resultado desejado.v getLatitude

v getLongitude

v getAccuracy

double getLatitude()

Retorna as coordenadas de latitude em graus como um duplo.

Concatenado

Canonicalizador

AbreviaçãoExpansão

Na MemóriaCache

Banco de DadosCache

Geocodificador

RetornoCoordenadas

Perda de Acerto no Cache

Perda de Acerto no Cache

Acertos do Cache

Acertos do Cache

Atualizarcaches

Figura 2. Passos para processamento de endereços e atualização de armazenamento emcache

104 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 113: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

double getLongitude()

Retorna as coordenadas de longitude em graus como um duplo.

int getAccuracy()

Indica a exatidão das coordenadas de latitude e longitude. Quanto maior for ovalor resultante, mais precisas serão as coordenadas. Se o valor for 6 ou maior, ascoordenadas serão tratadas como um local exato.

Apêndice B. Ajuste de Mapas Geográficos 105

Page 114: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

106 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 115: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Avisos

Estas informações foram desenvolvidas para produtos e serviços oferecidos nomundo inteiro.

Este material pode ser disponibilizado pela IBM em outros idiomas. No entanto,pode ser requerido possuir uma cópia do produto ou da versão do produto nesteidioma a fim de acessá-lo.

É possível que a IBM não ofereça os produtos, serviços ou recursos discutidosnesta publicação em outros países. Consulte um representante IBM local para obterinformações sobre os produtos e serviços disponíveis atualmente em sua área.Qualquer referência a produtos, programas ou serviços IBM não significa queapenas produtos, programas ou serviços IBM possam ser usados. Qualquerproduto, programa ou serviço funcionalmente equivalente, que não infrinjanenhum direito de propriedade intelectual da IBM poderá ser usado emsubstituição a este produto, programa ou serviço. Entretanto, a avaliação everificação da operação de qualquer produto, programa ou serviço não IBM são deresponsabilidade do Cliente. Este documento pode descrever produtos, serviços ourecursos que não estão incluídos no Programa ou autorização de licença que vocêcomprou.

A IBM pode ter patentes ou solicitações de patentes pendentes relativas a assuntostratados nesta publicação. O fornecimento desta publicação não lhe concede direitoalgum sobre tais patentes. Consultas sobre licença devem ser enviadas, por escrito,para:

Gerência de Relações Comerciais e Industriais da IBM BrasilAv. Pasteur, 138-146BotafogoRio de Janeiro, RJCEP 22290-240

Para consultas sobre licença relacionadas a informações de DBCS (Conjunto deCaracteres de Byte Duplo), entre em contato com o Departamento de PropriedadeIntelectual da IBM em seu país ou envie consultas, por escrito, para:

Licenciamento de Propriedade IntelectualLei de Propriedade Legal e IntelectualIBM World Trade Asia Corporation Licensing19-21, Nihonbashi-Hakozakicho, Chuo-kuTokyo 103-8510, Japan

O parágrafo a seguir não se aplica a nenhum país em que tais disposições nãoestejam de acordo com a legislação local: > A INTERNATIONAL BUSINESSMACHINES CORPORATION FORNECE ESTA PUBLICAÇÃO “NO ESTADO EMQUE SE ENCONTRA”, SEM GARANTIA DE NENHUM TIPO, SEJA EXPRESSAOU IMPLÍCITA, INCLUINDO, MAS A ELAS NÃO SE LIMITANDO, ASGARANTIAS IMPLÍCITAS DE NÃO INFRAÇÃO, COMERCIALIZAÇÃO OUADEQUAÇÃO A UM DETERMINADO PROPÓSITO. Alguns países não permitema renúncia de responsabilidade de garantias expressas ou implícitas em certastransações; portanto, essa disposição pode não se aplicar ao Cliente.

© Copyright IBM Corp. 2003, 2014 107

Page 116: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

Essas informações podem conter imprecisões técnicas ou erros tipográficos. Sãofeitas mudanças periódicas nas informações aqui contidas; tais mudanças serãoincorporadas em futuras edições desta publicação. A IBM pode, a qualquermomento, aperfeiçoar e/ou alterar os produtos e/ou programas descritos nestapublicação, sem aviso prévio.

Referências nestas informações a Web sites não IBM são fornecidas apenas porconveniência e não representam de forma alguma um endosso a esses Web sites.Os materiais contidos nesses Web sites não fazem parte dos materiais desteproduto IBM e o uso desses Web sites é de inteira responsabilidade do Cliente.

A IBM pode usar ou distribuir as informações fornecidas da forma que julgarapropriada sem incorrer em qualquer obrigação para com o Cliente.

Licenciados deste programa que desejam obter informações sobre este assunto compropósito de permitir: (i) a troca de informações entre programas criadosindependentemente e outros programas (incluindo este) e (ii) o uso mútuo dasinformações trocadas, devem entrar em contato com:

Gerência de Relações Comerciais e Industriais da IBM BrasilAv. Pasteur, 138-146Botafogo.Rio de Janeiro, RJCEP 22290-240

Tais informações podem estar disponíveis, sujeitas a termos e condiçõesapropriadas, incluindo em alguns casos o pagamento de uma taxa.

O programa licenciado descrito nesta publicação e todo o material licenciadodisponível são fornecidos pela IBM sob os termos do IBM Customer Agreement,do Contrato Internacional de Licença do Programa IBM ou de qualquer outrocontrato equivalente.

Todos os dados de desempenho aqui contidos foram determinados em umambiente controlado. Portanto, os resultados obtidos em outros ambientesoperacionais podem variar significativamente. Algumas medidas podem ter sidotomadas em sistemas em nível de desenvolvimento e não há garantia de que estasmedidas serão iguais em sistemas geralmente disponíveis. Além disso, algumasmedidas podem ter sido estimadas por extrapolação. Os resultados reais podemvariar. Os usuários deste documento devem verificar os dados aplicáveis para seuambiente específico.

As informações relativas a produtos não IBM foram obtidas junto aos fornecedoresdos respectivos produtos, de seus anúncios publicados ou de outras origensdisponíveis publicamente. A IBM não testou estes produtos e não pode confirmar aprecisão de seu desempenho, compatibilidade nem qualquer outra reivindicaçãorelacionada a produtos não IBM. Dúvidas sobre os recursos de produtos não IBMdevem ser encaminhadas diretamente a seus fornecedores.

Todas as declarações relacionadas aos objetivos e intenções futuras da IBM estãosujeitas a mudanças ou retirada sem aviso prévio e representam apenas metas eobjetivos.

Estas informações contêm exemplos de dados e relatórios usados nas operaçõesdiárias de negócios. Para ilustrá-los da forma mais completa possível, os exemplos

108 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração

Page 117: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

podem incluir nomes de indivíduos, empresas, marcas e produtos. Todos estesnomes são fictícios e qualquer semelhança com nomes e endereços usados por umaempresa real é mera coincidência.

Se estas informações estiverem sendo visualizadas em formato eletrônico, asfotografias e ilustrações coloridas podem não aparecer.

Dependendo das configurações implementadas, esta Oferta de Software pode usarcookies de sessão e persistentes que coletam de cada usuáriov nomev nome de usuáriov senha

para propósitos dev gerenciamento de sessãov autenticaçãov usabilidade do usuário aprimoradav configuração de conexão únicav rastreamento de uso ou propósitos funcionais diferentes de gerenciamento de

sessão, autenticação, usabilidade do usuário aprimorada e configuração deconexão única

Estes cookies não podem ser desativados.

Se as configurações implementadas para esta Oferta de Software fornecerem avocê, como cliente, a capacidade de coletar informações pessoalmente identificáveisdos usuários finais através de cookies e outras tecnologias, deve-se procurar o seupróprio conselho jurídico sobre quaisquer leis aplicáveis à coleta de dados,incluindo eventuais requisitos para notificação e consentimento.

Para obter mais informações sobre o uso de várias tecnologias, incluindo cookies,para estes propósitos, consulte a Política de Privacidade da IBM emhttp://www.ibm.com/privacy e a Declaração de Privacidade Online da IBM emhttp://www.ibm.com/privacy/details na seção intitulada "Cookies, Web Beacons eOutras Tecnologias" e "Produtos de Software IBM e Declaração de Privacidade deSoftware como Serviço" em http://www.ibm.com/software/info/product-privacy.

Marcas Registradas

IBM, o logotipo IBM e ibm.com são marcas ou marcas registradas da InternationalBusiness Machines Corp., registradas em várias jurisdições em todo o mundo.Outros nomes de produtos e serviços podem ser marcas registradas da IBM ou deoutras empresas. Uma lista atual das marcas registradas da IBM está disponível naWeb em “Copyright and trademark information ” em www.ibm.com/legal/copytrade.shtml.

Os seguintes termos 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 do Adobe Systems Incorporated nos Estados Unidos e/ou emoutros países.

v Microsoft, Windows, Windows NT e o logotipo Windows são marcas ou marcasregistradas da Microsoft Corporation nos Estados Unidos e/ou em outros países.

Avisos 109

Page 118: IBM Cognos Real-time Monitoring Versão 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/pt-br… · Instalando Arquivos do Servidor da Web Real-time Monitoring

v Linux é uma marca registrada da Linus Torvalds nos Estados Unidos e/ou emoutros países.

v UNIX é uma marca registrada da The Open Group nos Estados Unidos e emoutros países.

v Java e todas as marcas registradas e logotipos baseados em Java são marcasregistradas da Oracle e/ou suas afiliadas.

110 IBM Cognos Real-time Monitoring Versão 10.2.2: Guia de Instalação e Configuração