Se estiver usando o Rational Engineering
Lifecycle Manager, as etapas de configuração serão necessárias para configurar os
produtos como provedores TRS e fornecer ao Lifecycle Query Engine o acesso a seus
dados.
Depois de instalar e configurar todos os aplicativos e depois de
criar relacionamentos de amigos entre aplicativos em servidores remotos,
configure cada aplicativo como um provedor Tracked Resource Set (TRS) para que
o Lifecycle Query Engine (LQE) possa acessar seus dados para criar o índice.
Pré-requisitos: - Inicie o servidor para cada aplicativo que você deseja configurar
Importante: Se o aplicativo estiver em um Jazz Team Server diferente do LQE, as chaves geradas nesta tarefa serão reutilizadas posteriormente ao incluir as origens de dados no Lifecycle Query Engine, conforme descrito em:
Gerar o índice do LQE. Observe cuidadosamente o nome e o segredo de cada chave.
Designar a Licença do TRS Consumer-Internal
Designe a licença do Consumidor Interno
TRS para os usuários funcionais lqe_user e jts_user.
- Abra o console de administração do JTS em https://host_name:port/jts/admin
- Selecione Usuários > Ativar Usuários.
- Clique no link lqe_user. Na página lqe_user,
acesse a área Licença de Acesso do Cliente, selecione TRS
Consumer-Internal e clique em Salvar.
- Retorne 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 TRS
Consumer-Internal.
- Clique em Salvar.
Configurar o TRS para os Aplicativos CLM
Se estes aplicativos estiverem implementados no mesmo Jazz Team Server que o LQE, não será necessário criar consumidores de entrada. Conclua estas etapas somente se os aplicativos CCM, QM e RM estiverem em um Jazz Team Server separado.
- 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
- 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: yes
Clique em Registrar.
- Vá para a lista Chaves Autorizadas e edite a entrada
LQE clicando no ícone lápis.
- No diálogo Editar Propriedades da Chave do Consumidor,
clique no link Selecionar Usuário....
- 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.
- 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 as etapas de 7 a 10 novamente.
- Crie a Chave do Consumidor de Entrada do LQE para DOORS Next Generation, se este for seu aplicativo RM.
Abra a página de administração do RM: https://host_name:port/rm/admin e, em seguida, conclua as etapas de 7 a 10 novamente.
- 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.
- Clique em Administração > Origens de Dados > Incluir Origem de
Dados.
- 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 para indexar, aumente o número de encadeamentos
para indexação inicial para 4) e clique em Concluir.
- Registre QM como um provedor TRS e gere seu índice. Na página Origens de
Dados, clique em Incluir Origem de Dados.
- No diálogo Incluir Origem de Dados, selecione
https://host_name:port/qm/trs e inclua a etiqueta
RQM. Aceite os demais padrões e clique emConcluir.
- Registre RM como um provedor TRS e gere seu índice. Na página Origens de
Dados, clique em Incluir Origem de Dados.
- No diálogo Incluir Origem de Dados, selecione
https://host_name:port/rm/trs e inclua a etiqueta
DNG. Aceite os demais padrões e clique emConcluir.
Seus aplicativos do Rational Team Concert, do Rational Quality Manager e do Rational DOORS Next Generation estão agora indexados e disponíveis para o Rational Engineering Lifecycle Manager. Para obter informações adicionais sobre preferências para a indexação em andamento, consulte: Indexando seus Dados com o Lifecycle Query Engine
Configurar o DOORS e o DOORS Web Access como Provedores TRS
O Rational DOORS Web Access é fornecido com diversos usuários e senhas padrão para a ativação do TRS. Você deve editar os parâmetros de configuração
associados a esses usuários, conforme descrito no seguinte procedimento. A
integração usa os seguintes usuários:
- 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 tenha acesso aos
dados do banco de dados do TRS. É usado pelo
Rational
DOORS Web Access para recuperar dados do banco de
dados.
- derby.user.admin. Este é um administrador do banco de dados do 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.
- Abra [caminho_do_DWA]\server\festival\config\festival.xml.
- Procure pela seção Propriedades do sistema configurável.
- Inclua as propriedades listadas na seguinte tabela.
Formatação de
propriedades:
<f:property name="property_listed_in_table" value="appropriate_value_or_default_listed_in_table" />
Tabela 1. Propriedades do arquivo Festival.xml
para TRS e LQE| Propriedade |
Descrição/Valor |
| functional.user.consumer.key |
A chave do consumidor que está 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. |
| functional.user.consumer.secret |
O segredo do consumidor que está 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. |
| functional.user.name |
O nome do Usuário Funcional do LQE. Esse nome de
usuário deve ser um usuário válido do Rational
DOORS. Assegure-se de que o ID de usuário do DOORS usado no arquivo festival.xml exista e de que tenha acesso total aos projetos
e artefatos que você expõe no conjunto de trabalhos, |
| functional.user.password |
A senha do Usuário Funcional do LQE. |
| 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. Se esta propriedade não for especificada, o sistema usará os valores padrão. |
| trs.db.password |
A senha para o trs.db.user.
Você também deve
especificar essa senha no arquivo de propriedades do Derby.
O valor padrão é
dwaTrsPa11word. Se esta propriedade não for especificada, o sistema usará os valores padrão. |
| trs.page.size |
O número de recursos do TRS a ser incluído em uma
página. O valor padrão é 250. Se esta propriedade não for especificada, o sistema usará os valores padrão. |
| trs.enable |
Configure este valor como true. |
A seguinte extração do arquivo
festival.xml mostra um exemplo das propriedades relacionadas ao TRS:
<f:property name="functional.user.consumer.key" value="xyz" />
<f:property name="functional.user.consumer.secret" value="xyz" />
<f:property name="functional.user.name" value="Administrator" />
<f:property name="functional.user.password" value="qwert6" />
<f:property name="trs.enable" value="true" />
- Opcional: Abra o arquivo derby.properties em um
editor. Esse arquivo encontra-se no diretório dwa_install/derby.
- Opcional: Substitua os valores de senha para os parâmetros na
seguinte tabela.
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. |
- Inicialize o banco de dados do TRS. Execute os seguintes scripts:
- Efetue logon no cliente Rational DOORS como um usuário do tipo Gerenciador ou Administrador do Banco de Dados.
- Selecione . Na janela Chaves Locais, clique em Incluir. Use os valores especificados
no arquivo festival.xml.
- Nome do consumidor: Qualquer nome. LQE é
o recomendado.
- Chave do Consumidor: O conjunto de valores para a propriedade functional.user.consumer.key.
- Segredo do consumidor: O conjunto de valores para a propriedade functional.user.consumer.secret.
Clique em Registrar e, em seguida, em OK.
- Selecione . Na janela Selecionar Projeto, selecione os projetos, pastas e módulos que deseja expor ao
LQE.
- Selecione todos os módulos necessários na área de janela Selecionar Módulos.
Clique em Aplicar.
Configure LQE para usar o DOORS Web
Access como uma Origem de Dados
- Navegue até https://hostname:port/lqe/web
- Selecione Administração no menu da barra de ferramentas.
- Na página Origens de Dados, selecione Incluir
Origem de Dados
- No diálogo Incluir Origem de Dados, selecione a opção
URL do documento de Serviços Raiz. Insira a URL de serviços raiz do DOORS. Selecione a URL do TRS.
Insira uma etiqueta e selecione Especificar detalhes de autenticação.
- URL de Serviços Raiz: https://doorsserver:port/dwa/public/rootservices
- Selecione https://servidor_doors:porta/dwa/rm/trs
- Rótulo: DOORS
- Insira a chave do consumidor e segredo.
Nota: A Chave e o Segredo do Consumidor
devem corresponder aos valores no arquivo
festival.XML do DOORS Web
Access. No exemplo abaixo,
o valor
xyz é um exemplo.
<f:property name="functional.user.consumer.key" value="xyz"/>
<f:property name="functional.user.consumer.secret" value="xyz"/>
- Configure o número de encadeamentos para 1 pela primeira vez e a indexação
incremental, e clique em Concluir. Os erros ocasionais
poderão ocorrer se mais de um encadeamento for usado para indexação.
Configurar o TRS para o Aplicativo Rhapsody Design Manager
- Acesse 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 o console do Design Manager.
- Selecione Servidor > Consumidores (Entrada) e insira o que
segue, e clique em Registrar:
- Nome: LQE
- Segredo: xyz
- Confiável: yes
- Acesse a lista Chaves Autorizadas e edite a entrada
LQE clicando no ícone de lápis.
- No diálogo Editar Propriedades da Chave do Consumidor,
clique no link Selecionar Usuário....
- 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.
- Acesse https://hostname:port/dm/web
- Efetue login como o usuário administrativo.
- Selecione a área do projeto e selecione Gerenciar Propriedades
do Projeto no menu suspenso Administração
(o ícone engrenagem). Selecione Contexto OSLC Padrão e, então,
clique em Selecionar. Clique no nome do projeto e, em seguida,
pressione OK e Salvar.
- 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.
- Clique em Administração > Origens de Dados > Incluir Origem de
Dados.
- No diálogo Incluir Origem de Dados, selecione
http://nome_do_host_rdm:9443/dm/trs e inclua o rótulo
RDM. Aceite os padrões remanescentes
(se tiver uma grande quantia de dados para indexar, aumente o número de
encadeamentos para indexação inicial para 4) e clique em Concluir.
Configurar o TRS para o Aplicativo Rational Engineering Lifecycle Manager
Se a instalação for nova, você não terá dados para indexar. É possível criar
um projeto e um produto de amostra para que seja possível verificar se o
índice foi criado com êxito.
- Abra a página administrativa do Lifecycle Query Engine: https://lqe_host_name:port/lqe/web.
- Clique em Administração > Origens de Dados > Incluir Origem de
Dados.
- 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 grande quantia de dados para indexar, aumente o número de
encadeamentos para indexação inicial para 4) e clique em Concluir.
- Para testar o índice, abra o Rational Engineering
Lifecycle Manager: https://relm_host_name:port/relm/web
- Selecione um projeto de amostra. No menu Consultas, selecione
Consultas Compartilhadas.
- 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. Na página Autorização do Usuário, https://relm_host_name:port/lqe/web/auth,
clique em Autorizar, ao lado de cada aplicativo que
deseja consultar.
- O resultado da consulta exibe o produto de amostra criado.
Configurar o TRS para os Usuários do Jazz Team Server
- Abra a página administrativa do Lifecycle Query Engine: https://lqe_host_name:port/lqe/web.
- Clique em Administração > Origens de Dados > Incluir Origem de
Dados.
- No diálogo Incluir Origem de Dados, selecione http://host_name:port/jts/trsUsers e inclua a etiqueta Usuários. Aceite os demais padrões e clique emConcluir.
Próximos Passos
Depois de configurar os aplicativos como provedores TRS, siga as
etapas em Executar uma Consulta para Teste ou Depuração para
validar a configuração.