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

Linux 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, instalar os arquivos Enterprise Archive e criar os armazéns de dados.
Por Que e Quando Desempenhar Esta Tarefa
Para configurar o servidor de relatório:
Nota: A etapa 1 e as etapas 5 a 16 não serão necessárias se você tiver optado pelo método de instalação automática para instalar o servidor de relatório.
  1. Crie um banco de dados de armazenamento de conteúdo:
    Nota: Certifique-se de que você, como o usuário atual, tenha os privilégios administrativos necessários para criar bancos de dados e contêineres de espaço de tabela. 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. Efetue login como um usuário DBA Oracle.
    2. Vá para o diretório /opt/ibm/RationalInsight/reportal/contentstore.
    3. Alterne para o usuário raiz executando o comando su. Se solicitado, digite a senha raiz.
    4. Configure as permissões para os arquivos e pastas executando o seguinte comando:
      chown oinstall.oinstall /opt/ibm/RationalInsight/reportal/contentstore -R
    5. Retorne ao console do administrador de banco de dados e execute o shell script install.sh através do seguinte comando:
      [oinstall@VEGAVM contentstore]$ ./install.sh
    6. 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. Crie o listener:
    1. Configure a variável do sistema ORACLE_SID=$SID, em que $SID é o banco de dados criado na etapa 1.
    2. Inicie o Oracle Net Manager.
    3. Expanda os nós e selecione Listeners. Clique em Editar > Criar.
    4. Insira o nome do listener e clique em OK.
    5. Clique em Incluir Endereço e especifique o host e a porta para o Serviços de Dados do Rational Insight.
    6. 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. Inicie o listener através do seguinte comando:
    lsnrctl start
  4. Crie o nome do serviço:
    1. Inicie o Assistente de Configuração de Rede Oracle.
    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.
  5. 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:
    Nota: Esta etapa não será necessária se você tiver optado pelo método de instalação automático para instalar o servidor de relatório.
    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 os drivers Oracle apropriados estejam instalados no diretório [rational_insight_installation_directory]/cognos/webapps/p2pd/WEB-INF/lib:
      • Oracle 10g: ojdbc14.jar
      • Oracle 11g: ojdbc5.jar
  6. Exclua o serviço do IBM Cognos 8 baseado em Tomcat:
    Nota: Esta etapa não será necessária se você tiver optado pelo método de instalação automático para instalar o servidor de relatório.
    1. Inicie o console de administração do Cognos (execute cogconfig.sh em /opt/ibm/RationalInsight/cognos/bin).
    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.
  7. Crie um novo armazenamento de conteúdo no Cognos para fazer referência ao banco de dados de conteúdo:
    Nota: Esta etapa não será necessária se você tiver optado pelo método de instalação automático para instalar o servidor de relatório.
    1. Inicie o console de administração do Cognos (execute cogconfig.sh em /opt/ibm/RationalInsight/cognos/bin).
    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.
  8. 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.
    Nota: Esta etapa não será necessária se você tiver optado pelo método de instalação automático para instalar o servidor de relatório.
  9. Se tiver alterado a configuração do Cognos, reinicie o WebSphere Application Server.
    Nota: Esta etapa não será necessária se você tiver optado pelo método de instalação automático para instalar o servidor de relatório.
  10. Configure a instância do WebSphere Application Server para hospedar o servidor de relatório:
    Nota: Esta etapa não será necessária se você tiver optado pelo método de instalação automático para instalar 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 RationalInsightServer 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:

      LD_LIBRARY_PATH=[INSTALLDIR]\cognos\bin

    11. Clique em OK, clique em Novo e inclua a seguinte propriedade:

      PATH=[INSTALLDIR]\cognos\bin

    12. Clique em Aplicar e clique em Salvar.
  11. Construa e implemente o arquivo Enterprise Archive do servidor de relatório:
    Nota: Esta etapa não será necessária se você tiver optado pelo método de instalação automático para instalar 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. 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. Clique em Avançar, aceite os valores padrão e clique em Avançar.
    7. Clique em Concluir e clique em Fechar.
  12. Instale o arquivo Enterprise Archive do servidor de relatório:
    Nota: Esta etapa não será necessária se você tiver optado pelo método de instalação automático para instalar o servidor de relatório.
    1. Efetue logon no console administrativo do WebSphere Application Server (aponte o navegador para http://localhost:port/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. Copie os arquivos de conteúdo da Web do Cognos estáticos de [rational_insight_installation_directory]\cognos\webcontent\*.* para o diretório de arquivamento Web expandido do aplicativo. Um exemplo de um diretório de arquivamento Web é: [WASDIR]\profiles\RationalInsight\installedApps\vega9Node01Cell\IBM Cognos 8.ear\p2pd.war.
    7. Selecione o aplicativo IBM Cognos 8 e clique em Iniciar. O aplicativo demora alguns minutos para carregar totalmente e iniciar.
    8. 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.
    9. Aponte o navegador da Web para http://host:port/insight. Você deverá ver a página inicial do portal do Rational Insight.
  13. Implemente o arquivo WAR (Web Archive) para os documentos da ajuda:
    1. Inicie o console administrativo do WebSphere Application Server (aponte o navegador para 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.
  14. 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.
  15. 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.
  16. 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.
  17. Importe os relatórios de amostra do Rational Insight:
    Nota: Esta etapa não será necessária se você tiver optado pelo método de instalação automático para instalar o servidor de relatório.
    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://host/cognos8/cgi-bin/cognos.cgi.
    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.
  18. 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 ClearQuest: No nível de banco de dados do usuário
    • Rational ClearCase: No nível de visualização
    • Rational Quality Manager: Na raiz do REST Service
    • Rational Team Concert: No nível do projeto
    1. Inicie 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.
  19. Teste as conexões da origem de dados do Cognos para o armazém de dados e os produtos suportados:
    1. Inicie o console administrativo do WebSphere Application Server. A URL padrão é http://localhost:9060/ibm/console/login.do.
    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.
    7. Teste a conexão.
    8. Clique em OK duas vezes.
    9. Clique em Configuração > Conexões da Origem de Dados > RationalProductName.
    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.
  20. 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.
  21. 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