Configurando o Servidor de Relatório: Tarefas para o DB2

Linux As etapas necessárias para configurar o banco de dados DB2 para o servidor de relatório dependem das opções escolhidas para o recurso Insight Server durante o processo de instalação. Talvez seja necessário criar o banco de dados de armazenamento de conteúdo do DB2, configurar a instância do IBM WebSphere Application Server para hospedar o servidor de relatório e construir, implementar e instalar os arquivos Enterprise Archive.
Por Que e Quando Desempenhar Esta Tarefa
Para configurar o servidor de relatório:
Nota: As etapas 2 a 13 serão necessárias apenas se você tiver escolhido o método de instalação manual.
  1. Configure o servidor de relatório para conectar ao armazenamento de conteúdo registrando as instâncias de banco de dados para serem iniciadas automaticamente durante as reinicializações do sistema:
    1. Execute o seguinte comando:
      db2iauto -on <instance name> 
    2. Abra o arquivo /etc/inittab em um editor.
    3. Localize a seguinte cadeia de códigos:
      fmc:2345:respawn:/opt/ibm/db2/V9.1/bin/db2fmcd #DB2 Fault Monitor Coordinator 
    4. Mova a cadeia de códigos e coloque-a logo depois do comando id:5:initdefault:.
  2. 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. Inicie a janela de comandos do DB2 utilizando uma conta válida de administrador de banco de dados do DB2. Por padrão, o usuário é db2inst1.
    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 db2inst1.db2iadm1 /opt/ibm/RationalInsight/reportal/contentstore -R
      em que db2inst1 é o proprietário da instância do DB2 e db2iadm1 é o grupo do DB2.
    5. Retorne ao console do administrador de banco de dados e execute o shell script install.sh através do seguinte comando:
      [db2inst1@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.
    7. Expanda a pasta Todos os Bancos de Dados e verifique se o banco de dados incluído está listado.
  3. 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. Exporte JAVA_HOME=[WASDIR]/java/jre
    2. Exporte PATH=$JAVA_HOME/bin:…
    3. Copie o arquivo [INSTALLDIR]/cognos/bin/jre/1.5.0/lib/ext/bcprov-jdk14-134.jar para a pasta [WASDIR]/java/jre/lib/ext.
    4. Certifique-se de que os seguintes drivers do DB2 sejam instalados no diretório [INSTALLDIR]/cognos/webapps/p2pd/WEB-INF/lib:
      • db2java.jar
      • db2jcc.jar
      • db2jcc_license_cu.jar
      • db2policy.jar

      Se o arquivo db2java.jar estiver ausente e db2java.zip estiver presente, renomeie a pasta db2java.zip para db2java.jar. Se você vir que db2jcc4.jar está presente, remova-o.

    5. Copie o arquivo libdb2.so do diretório [DB2 INSTALLDIR]/lib32 ou [DB2 INSTALLDIR]//lib64 para o diretório /usr/local/lib.
  4. Exclua o serviço do IBM Cognos 8 baseado em Tomcat:
    1. Inicie o console de administração do Cognos (execute o comando 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.
  5. Crie um novo armazenamento de conteúdo no Rational Insight para fazer referência ao banco de dados de armazenamento de conteúdo do DB2:
    1. Inicie o console de administração do Cognos (execute o comando 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.
  6. 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.
  7. Configure a instância do WebSphere Application Server para hospedar o servidor de relatório:
    1. Reinicie o WebSphere Application Server se você tiver alterado a Configuração do Cognos.
    2. Abra o console administrativo do WebSphere Application Server (abra um navegador da Web e aponte para http://localhost:9060/ibm/console/). Se 9060 não for o número da porta registrado da ferramenta Gerenciamento de Perfil do WebSphere Application Server, substitua 9060 por qualquer outro número de porta.
    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.
    13. Reinicie WebSphere Application Server.
  8. Construa e implemente o arquivo Enterprise Archive do servidor de relatório:
    1. Inicie o console de administração do Cognos (execute o comando cogconfig.sh em /opt/ibm/RationalInsight/cognos/bin).
    2. Selecione Ambiente e altere todas as portas de 9300 para o número da porta do perfil do WebSphere Application Server que, por padrão, é 9080.
    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.
  9. Instale o arquivo Enterprise Archive 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. 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 da Web expandido do aplicativo. Um exemplo de um diretório de arquivamento da Web é: [WebSphere_installation_directory]/profiles/RationalInsight/installedApps/NODENAME/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://server:port/insight. Você deverá ver a página inicial do portal do Rational Insight.
  10. 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.
  11. Instale a aparência do Rational Insight:
    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 (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.
  12. 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.
  13. 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.
  14. 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 Rational Insight em server:port/insight.
    3. Abra a página de administração do 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 duas vezes.
    7. Para importar todos os pacotes e pastas, selecione a caixa no cabeçalho da tabela e clique em Avançar quatro vezes.
    8. Clique em Concluir, clique em Executar e clique em OK.
    9. Clique no ícone Inicial e verifique se todos os pacotes e pastas estão listados em Pastas Públicas.
  15. 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 TestManager: No nível do projeto
    • Rational Team Concert: No nível do projeto
    • Rational Quality Manager: 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 /opt/ibm/RationalInsight/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. Exclua todas as definições do grupo de recursos que não sejam aplicáveis.
    4. Selecione o grupo de recursos aplicável, clique com o botão direito do mouse e clique em Editar.
    5. 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. Para ver como descobrir a URL do grupo de recursos, consulte a seção sobre como configurar as origens do produto para o Serviços de Dados do Rational Insight.
    6. Clique em Arquivo > Salvar.
  16. Teste as conexões da origem de dados para o armazém de dados e as origens do produto:
    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 à direita do campo).
    6. No campo Cadeia de conexão do DB2, certifique-se de que SAMPLEDW seja o nome do banco de dados e jdbc:db2://localhost:50000/SAMPLEDW seja a cadeia de conexão. Clique em Testar a conexão.
    7. Clique em OK duas vezes.
    8. Clique em Configuração > Conexões da Origem de Dados > productsource, em que productsource é o nome da origem de dados do produto.
    9. Clique na ação Configurar propriedades para a origem de dados do produto.
    10. Clique em Conexão, selecione o campo Cadeia de conexão e clique no ícone Editar (o ícone de lápis à direita do campo).
    11. No campo Cadeia de conexão, especifique as propriedades de Conexão, se necessário.
    12. Clique em OK duas vezes.
  17. Faça a execução de teste dos relatórios de amostra do Rational Insight:
    1. Abra o aplicativo da Web Rational Insight em http://server:port/insight.
    2. Clique na pasta Definições do Relatório de Amostra.
    3. Execute os relatórios.
Referências relacionadas
Referência: Parâmetros do DB2 para Criar o Armazenamento de Conteúdo para o Servidor de Relatório