Registrar os Aplicativos como Provedores TRS para o Lifecycle Query Engines

Se você estiver usando o Rational Engineering Lifecycle Manager, as etapas de configuração adicionais serão necessárias para configurar os produtos como provedores TRS e fornecer acesso ao Lifecycle Query Engine aos seus dados. Se você não estiver usando o Rational Engineering Lifecycle Manager, não será necessário concluir as etapas nesta seção.

Depois que você tiver instalado e configurado todos os aplicativos e criado relacionamentos de amigos entre aplicativos em servidores remotos, será necessário configurar cada aplicativo como um provedor Tracked Resource Set (TRS), para que o Lifecycle Query Engine tenha acesso aos seus dados ao criar o índice.

Pré-requisitos:

Designar a Licença do Consumidor Interno TRS

Designe a licença do Consumidor Interno TRS para os usuários funcionais lqe_user e jts_user.

  1. Abra o console de administração JTS em https://host_name:port/jts/admin
  2. Selecione Usuários > Ativar Usuários.
  3. Clique no link lqe_user. Na página lqe_user, acesse a área Licença de Acesso do Cliente e selecione Consumidor Interno TRS e clique em Salvar.
    Selecionando a licença do Consumidor Interno TRS para o usuário LQE principal
  4. Retorne para a página Ativar Usuários. Clique no link jts_user. Na página jts_user, acesse a área Licença de Acesso do Cliente e selecione Consumidor Interno TRS.
  5. Clique em Salvar.

Configurar o TRS para os Aplicativos CLM

Se esses aplicativos forem implementados no mesmo Jazz Team Server que o LQE, não será necessário criar consumidores de entrada. Estas etapas deverão ser concluídas apenas se os aplicativos CCM, QM e RM estiverem em um Jazz Team Server separado.

  1. Crie a Chave do Consumidor de Entrada do LQE para CCM. Abra a página de administração do CCM: https://host_name:port/ccm/admin
  2. Na página Aplicativo, selecione Comunicação > Consumidores (Entrada) e crie uma nova Chave do Consumidor OAuth para LQE:
    • Nome: LQE
    • Segredo: xyz
    • Confiável: sim
    Clique em Registrar.
  3. Acesse a lista Chaves Autorizadas e edite a entrada LQE clicando no ícone lápis.
  4. No diálogo Editar Propriedades da Chave do Consumidor, clique no link Selecionar Usuário....
  5. Insira lqe no campo de filtro e selecione lqe_user na lista de usuários correspondentes. Clique em Incluir e Fechar e, em seguida, em Concluir.
  6. Crie a Chave do Consumidor de Entrada do LQE para QM. Abra a página de administração do QM: https://host_name:port/qm/admin e, em seguida, conclua etapas 7 a 10 novamente.
  7. Crie a Chave do Consumidor de Entrada do LQE para DOORS Next Generation se esse for seu aplicativo RM. Abra a página de administração do RM: https://host_name:port/rm/admin e, em seguida, conclua etapas 7 a 10 novamente.
  8. Registre os aplicativos como provedores TRS e gere seu índice. Abra a página administrativa do Lifecycle Query Engine: https://host_name:port/lqe/web.
  9. Clique em Administração > Origens de Dados > Incluir Origem de Dados.
  10. No diálogo Incluir Origem de Dados, selecione https://host_name:port/ccm/oslc/workitem/trs e inclua a etiqueta RTC. Aceite os padrões remanescentes (se tiver uma grande quantia de dados a serem indexados, você pode desejar aumentar para 4 o número de encadeamentos para indexação inicial) e clique em Concluir.
  11. Registre QM como um provedor TRS e gere seu índice. Na página Origens de Dados, clique em Incluir Origem de Dados.
  12. No diálogo Incluir Origem de Dados, selecione https://host_name:port/qm/trs e inclua a etiqueta RQM. Aceite os padrões remanescentes e clique em Concluir.
  13. Registre RM como um provedor TRS e gere seu índice. Na página Origens de Dados, clique em Incluir Origem de Dados.
  14. No diálogo Incluir Origem de Dados, selecione https://host_name:port/rm/trs e inclua a etiqueta DNG. Aceite os padrões remanescentes e clique em Concluir.

Agora, os aplicativos Rational Team Concert, Rational Quality Manager e Rational DOORS Next Generation são indexados e disponíveis no Rational Engineering Lifecycle Manager. Consulte a documentação do Lifecycle Query Engine para obter informações adicionais sobre as preferências da indexação em andamento: Indexando seus Dados com o Lifecycle Query Engine

Configurar o DOORS e o DOORS Web Access como Provedores TRS

O Rational DOORS e Derby são enviados com vários usuários padrão e senhas para a ativação do TRS. Você deve editar os parâmetros de configuração associados a esses usuários, conforme descrito no procedimento abaixo. A integração usa os usuários a seguir:
  • Usuário Funcional do LQE. Esse usuário manipula as solicitações de LQE a partir de um aplicativo consumidor de TRS integrado para Rational DOORS Web Access. Esse usuário deve existir no banco de dados do Rational DOORS. Você deve especificar os parâmetros para este usuário no arquivo festival.xml.
  • trs.db.user. Esse é um usuário do banco de dados Derby que tem acesso aos dados do banco de dados TRS. É usado pelo Rational DOORS Web Access para recuperar dados do banco de dados. Você deve especificar uma senha para esse usuário no arquivo festival.xml e o arquivo de propriedades Derby.
  • derby.user.admin. Este é um administrador do banco de dados Derby. Atualmente, esse usuário não fornece funções para Rational DOORS Web Access ou o banco de dados Derby. É possível definir uma senha para este usuário no arquivo de propriedades Derby.
  1. Abra [caminho_do_DWA]\server\festival\config\festival.xml.
    1. Procure pela seção Propriedades do Sistema configurável.
    2. Abaixo da propriedade oauth.domain, inclua as propriedades listadas na tabela abaixo, substituindo seu ID administrativo do DOORS e sua senha e selecionando uma chave do consumidor e um segredo. A formatação dessas propriedades deve ser o seguinte:
      <f:property name="functional.user.consumer.key" value="consumer_key" />
    Tabela 1. Propriedades do Arquivo Festival.xml para TRS e LQE
    Propriedade Descrição/Valor
    ForceHttpsForAuthenticationForOAuth Configure este valor como true.
    oauth.domain Configure este valor como https://server:port/dwa, em que server é um nome de domínio do servidor ou endereço IP.
    functional.user.consumer.key A chave do consumidor associada ao Usuário Funcional do LQE. Ela é usada pelo Lifecycle Query Engine para acessar o DOORS Tracked Resource Set (TRS). Essa chave deve estar na guia Chaves Locais da configuração do Rational DOORS. O valor padrão é Chave do Usuário Funcional do LQE.
    functional.user.consumer.secret O segredo do consumidor associado ao Usuário Funcional do LQE. Ela é usada pelo Lifecycle Query Engine para acessar o DOORS Tracked Resource Set (TRS). Esse segredo deve estar na guia Chaves Locais da configuração do Rational DOORS. O valor padrão é qwert6.
    functional.user.name O nome do usuário para o Usuário Funcional do LQE. Esse nome de usuário deve ser um usuário válido do Rational DOORS. O valor padrão é Usuário Funcional do LQE.
    functional.user.password A senha para o Usuário Funcional do LQE. O valor padrão é qwert6.
    trs.db.user Um nome de usuário para a ativação do TRS. Para simplicidade, use o nome do usuário padrão trs.db.user.
    trs.db.password A senha para o trs.db.user. Você também deve especificar essa senha no arquivo de propriedades Derby.
    trs.page.size O número de recursos do TRS a ser incluído em uma página. O valor padrão é 250.
    trs.enable Configure este valor como true.
  2. Abra o arquivo derby.properties em um editor. Esse arquivo está localizado no diretório dwa_install/derby.
  3. Substitua os valores de senha para os parâmetros na tabela a seguir.
    Tabela 2. Parâmetros do Arquivo de Propriedades Derby para TRS
    Parâmetro Descrição
    derby.user.trs A senha para o trs.db.user especificada no arquivo festival.xml. O valor padrão é dwaTrsPa11word.
    derby.user.admin A senha para o administrador do banco de dados Derby. Atualmente, esse usuário não fornece funções para Rational DOORS Web Access ou o banco de dados Derby. O valor padrão é dwaTrsPa11word.
  4. Execute o arquivo em lote a seguir: dwa_install/derby.start.bat.
  5. Execute o arquivo em lote a seguir: dwa_install/derby/scripts/init_trs.bat.
  6. Ative os parâmetros do Data Change Notifications (DCN) para configurar o servidor de banco de dados Rational DOORS para se comunicar com o broker Rational DOORS Web Access e o servidor Rational DOORS Web Access. Para obter informações adicionais, consulte este tópico: http://publib.boulder.ibm.com/infocenter/doorshlp/v9/index.jsp?topic=/com.ibm.rational.dwa.install.doc/topics/c_setupddbs.html
  7. Reinicie os servidores DOORS Web Access nesta ordem:
    1. Corretor
    2. Interoperabilidade
    3. Servidor de banco de dados
    4. Servidor de Aplicativos da Web
  8. Efetue o logon para Rational DOORS usando estas credenciais:
    • Nome de usuário: Usuário Funcional do LQE ou o nome do usuário funcional especificado no arquivo festival.xml.
    • Senha: qwert6 ou a senha de usuário funcional especificada no arquivo festival.xml.
  9. No menu Arquivo selecione OSLC...Chave Local e clique em Incluir.
    • Nome: LQE
    • Chave: xyz
    • Segredo: xyz
    Clique em Registrar e, em seguida, em OK.
  10. No menu Arquivo selecione OSLC...Conjuntos de Trabalhos.
  11. Na área de janela Selecionar Projeto localize a pasta Requisitos e, em seguida, selecione todos os módulos que essa pasta contém na área de janela Selecionar Módulos. Clique em Aplicar.

Configure LQE para usar o DOORS Web Access como uma origem de dados

  1. Navegue para https://hostname:port/lqe/web
  2. Selecione Administração no menu da barra de ferramentas.
  3. Na página Origens de Dados, selecione Incluir Origem de Dados
  4. No diálogo Incluir Origens de Dados, selecione a opção URL do documento Root Services e insira o DOORS Root Services URL, selecione a URL do TRS, insira uma etiqueta e selecione Especificar Detalhes da Autenticação .
    • Root Services URL: https://doorsserver:port/dwa/public/rootservices
    • Selecione https://servidor_doors:porta/dwa/rm/trs
    • Etiqueta: DOORS
    Captura de tela dos valores de Origem de Dados para DOORS sendo incluídos em LQE
  5. Insira a chave do consumidor e segredo.
    Nota: A Chave do Consumidor e Segredo devem corresponder aos valores no arquivo Festival.XML do DOORS Web Access.
    <f:property name="functional.user.consumer.key" value="xyz"/>
    <f:property name="functional.user.consumer.secret" value="xyz"/>
    Captura de tela da chave do consumidor e segredo
  6. Configure o número de encadeamentos para 1 pela primeira vez e a indexação incremental e clique em Concluir. Erros ocasionais poderão ocorrer se mais de um encadeamento for usado para indexação.

Configurar o TRS para o Aplicativo Rhapsody Design Manager

  1. Navegue para https://hostname:port/jts/admin
    Nota: Os consumidores de entrada do Design Manager são definidos no console administrativo do Jazz Team Server, não no console do Design Manager.
  2. Selecione Servidor > Consumidores (Entrada) e insira o que segue e clique em Registrar:
    • Nome: LQE
    • Segredo: xyz
    • Confiável: sim
  3. Acesse a lista Chaves Autorizadas e edite a entrada LQE clicando no ícone lápis.
  4. No diálogo Editar Propriedades da Chave do Consumidor, clique no link Selecionar Usuário....
  5. Insira lqe no campo de filtro e selecione lqe_user na lista de usuários correspondentes. Clique em Incluir e Fechar e, em seguida, em Concluir.
  6. Navegue para https://hostname:port/dm/web
  7. Efetue login como o usuário administrativo.
  8. Selecione sua área de projeto e selecione Gerenciar Propriedades do Projeto no menu suspenso Administração (o ícone de configuração). Selecione Contexto OSLC Padrão, clique em Selecionar, no nome do projeto, em seguida, pressione OK e Salvar.
    Selecione sua Área do Projeto e assegure-se de que o Contexto OSLC padrão esteja designado.
  9. Registre o Rhapsody DM como um provedor TRS e gere seu índice. Abra a página administrativa do Lifecycle Query Engine: https://lqe_host_name:port/lqe/web.
  10. Clique em Administração > Origens de Dados > Incluir Origem de Dados.
  11. No diálogo Incluir Origem de Dados, selecione http://rdm_host_name:9443/dm/trs e inclua a etiqueta RDM. Aceite os padrões remanescentes (se tiver uma grande quantia de dados a serem indexados, você pode desejar aumentar para 4 o número de encadeamentos para indexação inicial) e clique em Concluir.

Configurar o TRS para o Aplicativo Rational Engineering Lifecycle Manager

Se a instalação for nova, você não terá nenhum dado para o índice. Você pode desejar criar um projeto de amostra e produto, para que seja possível verificar se o índice foi criado com sucesso.

  1. Abra a página administrativa do Lifecycle Query Engine: https://lqe_host_name:port/lqe/web.
  2. Clique em Administração > Origens de Dados > Incluir Origem de Dados.
  3. No diálogo Incluir Origem de Dados, selecione http://relm_host_name:port/productdef/resource/tracked_resource_set e inclua a etiqueta RELM. Aceite os padrões remanescentes (se tiver uma quantia muito grande de dados a serem indexados, você poderá desejar aumentar para 4 o número de encadeamentos da indexação inicial) e clique em Concluir.
    Lista de origens de dados que mostra todos os componentes que foram indexados.
  4. Para testar o índice, abra o Rational Engineering Lifecycle Manager: https://relm_host_name:port/relm/web
  5. Selecione um projeto de amostra. No menu Consultas, selecione Consultas Compartilhadas.
  6. Expanda o nó de Amostra e selecione Todos os Artefatos. Poderá ser solicitado que você autorize todos os aplicativos com relação aos quais está executando a consulta. Clique em Autorizar ao lado de cada aplicativo que deseja consultar.
    Tela de autorização do usuário
  7. Os resultados da consulta devem exibir o produto de amostra criado.

Configurar o TRS para Usuários do Jazz Team Server

  1. Abra a página administrativa do Lifecycle Query Engine: https://lqe_host_name:port/lqe/web.
  2. Clique em Administração > Origens de Dados > Incluir Origem de Dados.
  3. No diálogo Incluir Origem de Dados, selecione http://host_name:port/jts/trsUsers e inclua a etiqueta Users. Aceite os padrões remanescentes e clique em Concluir.

Feedback