Configurando o Servidor de Relatório: Tarefas para o Oracle Server

Windows Configurar o Java Runtime Environment, criar um Listener Oracle e Serviço de Rede, configurar o Oracle como o armazenamento de conteúdo do Cognos, configurar a instância do IBM WebSphere Application Server para hospedar o servidor de relatório, construir e implementar os arquivos Enterprise Archive (EAR), instalar os arquivos EAR e criar os armazéns de dados.
Por Que e Quando Desempenhar Esta Tarefa
A lista a seguir fornece as etapas para configurar o servidor de relatório.
  1. Crie um banco de dados de armazenamento de conteúdo: Certifique-se de que você, como o usuário atual, tenha os privilégios administrativos necessários para criar bancos de dados e seus componentes. O usuário atual é aquele que pode conectar no tempo de execução ao armazenamento de conteúdo do Cognos. Se desejar que outros usuários conectem no tempo de execução ao armazenamento de conteúdo do Cognos, consulte o IBM Cognos 8 Business Intelligence Installation and Configuration Guide para obter instruções.
    1. Vá para o diretório C:\Program Files\ibm\Rational Insight\reportal\contentstore.
    2. Execute o arquivo em lote install.bat.
    3. Quando solicitado, especifique os parâmetros para o armazenamento de conteúdo. Para ver uma lista de parâmetros e suas explicações, consulte os links relacionados na parte inferior desta página.
  2. Para criar o listener:
    1. Inicie o Oracle Net Manager (Clique em Iniciar > Todos os Programas > Oracle > Ferramentas de Configuração e Migração > Net Manager).
    2. Expanda os nós e selecione Listeners. Clique em Editar > Criar.
    3. Insira o nome do listener e clique em OK.
    4. Clique em Incluir Endereço e utilize a lista suspensa para incluir o host e o comutador de porta no Serviços de Dados do Rational Insight.
    5. Clique em Incluir Banco de Dados, insira o nome do banco de dados, o diretório inicial e o SID e clique em Arquivo > Salvar Configuração de Rede.
  3. Para criar o nome do serviço:
    1. Inicie o Assistente de Configuração de Rede do Oracle (Clique em Iniciar > Todos os Programas > Oracle > Ferramentas de Configuração e Migração > Assistente de Configuração de Rede).
    2. Selecione a configuração Nome do Serviço de Rede Local e clique em Avançar.
    3. Selecione Incluir e clique em Avançar.
    4. Insira o nome do serviço e clique em Avançar.
    5. Selecione um protocolo e clique em Avançar.
    6. Insira o nome do host e a porta. Selecione Sim, executar um teste, clique em Avançar, altere o logon, se necessário, certifique-se de que a conexão passe no teste.
    7. Insira o nome do serviço de rede e clique em Avançar.
    8. Feche o Assistente de Configuração de Rede do Oracle.
  4. Para evitar problemas com criptografia, configure o Java Runtime Environment (JRE) para que o Cognos e o servidor de relatório sejam executados na mesma instância do JRE:
    1. Configure a variável JAVA_HOME para apontar para a pasta JRE do WebSphere Application Server e inclua %JAVA_HOME%\bin no início do caminho do sistema:
      JAVA_HOME=[WASDIR]\java\jre
      
      PATH=%JAVA_HOME%\bin;…
    2. Copie o arquivo [rational_insight_installation_directory]\cognos\bin\jre\1.5.0\lib\ext\bcprov-jdk14-134.jar para o diretório [WebSphere_installation_directory]\java\jre\lib\ext.
    3. Certifique-se de que o driver ojdbc14.jar esteja instalado no diretório [rational_insight_installation_directory]\cognos\webapps\p2pd\WEB-INF\lib.
  5. Exclua o serviço do IBM Cognos 8 baseado em Tomcat:
    1. Vá para o console de administração do Cognos (No Windows, clique em Iniciar > Programas > IBM Cognos 8 > Configuração do IBM Cognos).
    2. Clique com o botão direito do mouse no nó do IBM Cognos 8, selecione Excluir e clique em Sim.
    3. Clique em Salvar e clique em Fechar.
  6. Crie um novo armazenamento de conteúdo no Cognos para fazer referência ao banco de dados de conteúdo:
    1. Vá para o console de administração do Cognos (No Windows, clique em Iniciar > Programas > IBM Cognos 8 > Configuração do IBM Cognos).
    2. Clique em Acesso a Dados > Content Manager, clique com o botão direito do mouse em Armazenamento de Conteúdo e clique em Novo Recurso > Banco de Dados.
    3. No campo Nome do banco de dados, insira o nome do banco de dados criado na etapa 1.
    4. Selecione a linha ID de usuário e senha, clique no ícone Editar e insira um nome de usuário e senha que possam ser utilizados para acessar o armazenamento de conteúdo do banco de dados criado na etapa 1.
    5. Selecione Configuração Local e clique em Salvar configuração.
  7. Crie uma nova instância do WebSphere Application Server para hospedar o servidor de relatório. Esta etapa não será necessária se você tiver optado por instalar o WebSphere Application Server através do instalador do Rational Insight.
  8. Configure a instância do WebSphere Application Server para hospedar o servidor de relatório:
    1. Abra o console administrativo do WebSphere Application Server (abra um navegador para apontar para http://localhost:9060/ibm/console/).
    2. Substitua a porta 9060 por outro número de porta se ela diferir do que você registrou da ferramenta Gerenciamento de Perfil do WebSphere Application Server.
    3. Efetue logon no console administrativo do WebSphere Application Server (aponte o navegador para http://localhost:portnumber/ibm/console/login.do e insira seu nome de usuário e senha).
    4. Expanda o nó Servidores na barra lateral esquerda e selecione Servidores de Aplicativos.
    5. Clique no link server1 e expanda o nó Java e Gerenciamento de Processo.
    6. Clique no link Definição do Processo e clique no link Java Virtual Machine.
    7. Insira o tamanho de heap JVM inicial e máximo como 256 e 768.
    8. Clique em Aplicar (na parte inferior da página) e clique no link Salvar.
    9. Clique no link Entradas do Ambiente.
    10. Clique em Novo e inclua a seguinte propriedade:

      PATH=[INSTALLDIR]\cognos\bin

    11. Clique em Aplicar e clique em Salvar.
    12. Abra o painel de controle Serviços do Windows e reinicie o serviço IBM WebSphere Application Server V6.1 – Rational Insight.
  9. Construa e implemente o arquivo EAR do servidor de relatório:
    1. Vá para o console de administração do Cognos (No Windows, clique em Iniciar > Programas > IBM Cognos 8 > Configuração do IBM Cognos).
    2. Selecione Ambiente e altere todas as portas de 9300 para o número de porta do perfil do WebSphere Application Server.
    3. Selecione Serviços do Portal e altere todas as portas de 9300 para o número de porta do perfil do WebSphere Application Server.
    4. Clique em Salvar e clique em Fechar.
    5. Selecione Ações > Construir Arquivos de Aplicativos.
    6. Certifique-se de que o seguinte seja selecionado: IBM Cognos 8 e Incluir arquivos estáticos da pasta Webcontent. Escolha o servidor de aplicativos. Clique em Avançar, aceite os valores padrão e clique em Avançar.
    7. Clique em Concluir e clique em Fechar.
  10. Instale o arquivo EAR do servidor de relatório:
    1. Efetue logon no console administrativo do WebSphere Application Server (aponte o navegador para http://localhost:portnumber/ibm/console/login.do e insira seu nome de usuário e senha).
    2. Expanda o nó Aplicativos na barra lateral esquerda e selecione Instalar Novo Aplicativo.
    3. Clique em Navegar, vá para a pasta [rational_insight_installation_directory]\cognos e selecione o arquivo p2pd.ear.
    4. Aceite as opções padrão e clique em Avançar. Execute esta etapa quatro vezes.
    5. Clique no link Salvar, clique em Aplicativos Corporativos na barra lateral esquerda e, se o Aplicativo Padrão estiver listado, desinstale-o.
    6. Selecione o aplicativo IBM Cognos 8 e clique em Iniciar. O aplicativo demora alguns minutos para carregar totalmente e iniciar.
    7. Abra um navegador e aponte-o para http://server:port/insight/servlet. Se o Cognos Content Manager estiver funcionando corretamente, você verá algo semelhante ao texto a seguir na página da Web:
      IBM Cognos 8
      
      Content Manager
      
      Compilação: 8.4.2519.0
      
      Hora de início: Terça-feira, 18 de novembro de 2008 15h00min41s PST
      
      Hora atual: Terça-feira, 18 de novembro de 2008 15h01min25s PST
      
      Estado: Em execução.
    8. Aponte o navegador da Web para http://localhost:port number/p2pd/servlet/dispatch. Você deverá ver a página inicial do portal do Rational Insight.
  11. Implemente o arquivo WAR (Web Archive) para os documentos da ajuda:
    1. Inicie o console administrativo do WebSphere Application Server. A URL padrão é http://localhost:9060/ibm/console/login.do.
    2. Selecione Aplicativos > Instalar Novo Aplicativo.
    3. Clique em Navegar e localize o arquivo WAR INSIGHThelp.war. O local padrão é C:\Program Files\IBM\Rational Insight\UA. Especifique a raiz de contexto para ser help e clique em Avançar.
    4. Na página Selecionar opções de instalação, clique em Avançar.
    5. Na página Mapear módulos para servidores, clique em Avançar.
    6. Na página Mapear hosts virtuais para módulos da Web, clique em Avançar.
    7. Na página Resumo, clique em Concluir.
    8. Clique em Salvar.
  12. Instale a aparência do Rational Insight:
    1. Abra o aplicativo da Web Cognos em http://host/cognos8/cgi-bin/cognos.cgi.
    2. Abra a página de administração do Cognos (Ativar > Administração do IBM Cognos).
    3. Clique na guia Configuração.
    4. Na área de janela de navegação à esquerda da tela, clique em Estilos.
    5. Clique em Novo Estilo.
    6. No campo Nome, insira o Rational Insight e clique em Avançar.
    7. No campo Local do recurso de estilo, insira vega.
    8. No campo Recurso de visualização, insira preview.htm.
    9. Clique em Concluir.
  13. Selecione a aparência do Rational Insight:
    1. Abra a página inicial do Cognos em http://host/cognos8/cgi-bin/cognos.cgi.
    2. Clique em Minha Área e clique em Minhas Preferências.
    3. Na caixa Estilo, selecione Rational Insight e clique em OK.
  14. Configure a aparência do Rational Insight como a aparência padrão:
    1. Abra a página inicial do Cognos em http://host/cognos8/cgi-bin/cognos.cgi. Certifique-se de ter direitos de administrador.
    2. Clique em Segurança.
    3. Clique em Cognos.
    4. Clique no ícone Editar Perfil do Usuário Padrão (à esquerda do botão de procura).
    5. Clique em Preferências.
    6. Na caixa Estilo, selecione Rational Insight e clique em OK.
  15. Importe os relatórios de amostra do Rational Insight:
    1. Copie o arquivo [rational_insight_installation_directory]\reportal\deployment\Rational_Example_Reports.zip para o diretório [rational_insight_installation_directory]\cognos\deployment\.
    2. Abra o aplicativo da Web Cognos em http://server:port/insight.
    3. Abra a página de administração do Cognos (Ativar > Administração do IBM Cognos).
    4. Clique em Configuração.
    5. Clique em Administração de Conteúdo, clique no ícone Nova Importação.
    6. Certifique-se de que Rational_Example_Reports seja listado como um archive de implementação e clique em Avançar.
    7. No campo Nome, altere o nome de Rational_Example_Reports para Rational_Reports e clique em Avançar.
    8. Para importar todos os pacotes e pastas, selecione a caixa no cabeçalho da tabela e clique em Avançar quatro vezes.
    9. Clique em Concluir.
    10. Clique em Executar.
    11. Clique em OK.
    12. Clique no ícone Inicial.
    13. Verifique se todos os pacotes e pastas estão listados em Pastas Públicas.
  16. Modifique o arquivo de configuração de dados XML:
    Os arquivos de configuração de dados de amostra definem os mapeamentos padrão para todos os modelos e dados de amostra para cada produto. Faça um backup dos arquivos de configuração de dados XML de amostra e, em seguida, edite os arquivos para que correspondam ao seu ambiente. Os grupos de recursos são definidos nos seguintes níveis:
    • Rational RequisitePro: No nível do projeto
    • Rational ClearQuest: No nível de banco de dados do usuário
    • Rational ClearCase: No nível de visualização
    • Rational TestManager: No nível do projeto
    • Rational Quality Manager: Na raiz do REST Service
    • Microsoft Project: No nível do projeto
    1. Inicie Configuração de Dados XML (clique em Iniciar > Programas > IBM Rational Insight > Configuração de Dados XML).
    2. Clique em Arquivo > Abrir Configuração, vá para o diretório no qual os arquivos de configuração de dados estão localizados e abra o arquivo de configuração de dados do produto, por exemplo, clearcase.xdc. O local padrão é o diretório C:\Program Files\IBM\Rational Insight\dataconfig\configs. Quando solicitado a criar um projeto ETL, clique em OK.
    3. No XML Data Explorer, expanda a estrutura em árvore até que os grupos de recursos estejam visíveis (Configuração de Dados XML > Categoria de Recurso). Os grupos de recursos são representados pelos ícones de origem de dados.
    4. Exclua todas as definições do grupo de recursos que não sejam aplicáveis.
    5. Dê um clique duplo no grupo de recursos aplicáveis e clique em Editar.
    6. No campo Serviço de Dados, insira a URL do grupo de recursos no servidor no qual o Serviços de Dados do Rational Insight está instalado.

      A sintaxe da URL é http://host:port/Serviços de Dados/Nome do adaptador/nome do recurso, em que host é o nome do servidor Serviços de Dados do Rational Insight, port é a porta utilizada por Serviços de Dados do Rational Insight, Serviços de Dados é o diretório-raiz no qual o Serviços de Dados do Rational Insight é instalado, Nome do adaptador é o nome do produto para a origem de dados e nome do recurso é o nome do recurso do produto.

      Por exemplo: http://host:9080/DataServices/ClearQuest/ALM/SAMPL.

    7. Clique em Arquivo > Salvar.
    8. Repita as etapas e a g para todos os grupos de recursos para a origem de dados do produto.
    9. Repita as etapas b a h para todos os outros produtos.
  17. Teste as conexões da origem de dados para o armazém de dados e os produtos Rational:
    1. Abra o aplicativo da Web Rational Insight em http://server:port/insight.
    2. Abra a página de administração do Cognos (clique em Ativar > Administração do IBM Cognos ou, se você estiver na página de boas-vindas do Rational Insight, clique no link Administração no banner).
    3. Clique em Configuração > Conexões de Origem de Dados > RIDW.
    4. Clique na ação Configurar propriedades para a origem de dados RIDW.
    5. Clique em Conexão, selecione o campo Cadeia de conexão e clique no ícone Editar (o ícone de lápis na extremidade direita do campo).
    6. No campo Cadeia de conexão, certifique-se de que SAMPLEDW seja o nome do banco de dados e jdbc:db2://localhost:50000/SAMPLEDW seja a cadeia de conexão.
    7. Teste a conexão.
    8. Clique em OK duas vezes.
    9. Clique em Configuração > Conexões da Origem de Dados > DataSourceName.
    10. Clique na ação Configurar propriedades para a origem de dados do produto, por exemplo, ClearQuest.
    11. Clique em Conexão, selecione o campo Cadeia de conexão e clique no ícone Editar (o ícone de lápis na extremidade direita do campo).
    12. Clique em OK duas vezes.
  18. Faça a execução de teste dos relatórios de amostra do Rational Insight:
    1. Abra o aplicativo da Web Cognos em http://server:port/insight.
    2. Clique na pasta Definições do Relatório de Amostra.
    3. Execute os relatórios.
  19. Crie um usuário para acessar a origem de dados:
    1. Abra a página de administração do Cognos (Clique em Administração do IBM Cognos ou, se você estiver na página inicial padrão do IBM Cognos, clique em Ativar > Administrar o Conteúdo do IBM Cognos).
    2. Clique em Configuração > Conexões de Origem de Dados > RIDW.
    3. Clique em RIDW.
    4. Clique em Nova Conexão, insira um nome e clique em Avançar.
    5. Insira o ID do usuário e a senha para acessar a origem de dados. Para executar relatórios, um usuário deve ter pelo menos privilégios de leitura para a origem de dados.
Referências relacionadas
Referência: Parâmetros do Oracle Server para Criar o Armazenamento de Conteúdo para o Servidor de Relatório