Configurando o Rational DOORS Web Access como um provedor TRS

É possível configurar o IBM® Rational DOORS Web Access como um provedor para conjuntos de recursos controlados (TRS) editando arquivos de configuração e executando arquivos em lote do Derby.

Sobre Esta Tarefa

O Rational DOORS Web Access e o Derby são enviados com diversos usuários e senhas padrão para ativação do TRS. Se você modificar os nomes de usuário ou as senhas, deverá editar os parâmetros de configuração associados a esses usuários, conforme descrito no procedimento a seguir. A integração utiliza estes usuários:
Usuário funcional do LQE
Esse usuário padrão do Rational DOORS manipula as solicitações Lifecycle Query Engine (LQE) de um aplicativo consumidor TRS integrado para o Rational DOORS Web Access. Se esse usuário tiver nome e senha diferentes dos valores padrão, esses valores deverão corresponder às entradas no arquivo festival.xml, conforme descrito no procedimento a seguir.
trs.db.user
Esse usuário do banco de dados Derby pode acessar os dados do banco de dados TRS e é utilizado pelo Rational DOORS Web Access para recuperar dados do banco de dados. Se você desejar usar valores diferentes do nome de usuário e senha padrão, deverá criar entradas no arquivo festival.xml. Se você alterar a senha, deverá inserir uma nova no arquivo de propriedades do Derby.
derby.user.admin
Esse administrador de banco de dados Derby atualmente não fornece funções para o Rational DOORS Web Access. É possível definir uma senha para este usuário no arquivo de propriedades Derby.
Importante: Os administradores devem tomar medidas para manter a integridade do banco de dados Derby e para evitar que se corrompa. Para obter mais informações, consulte "Maintaining database integrity" no Derby Server and Administration Guide.

Procedimento

  1. Pare todos os componentes do Rational DOORS Web Access, conforme descrito em Iniciando, parando e removendo o Rational DOORS Web Access.
  2. Faça uma cópia de backup do arquivo festival.xml e abra o arquivo original. Este arquivo está localizado no diretório dwa_install\server\festival\config.
  3. Insira os valores de propriedade a seguir para o usuário funcional LQE e o usuário TRS:
    ForceHttpsForAuthenticationForOAuth
    Defina este valor como verdadeiro.
    functional.user.consumer.key
    Essa chave do consumidor está associada ao usuário funcional LQE. O LQE usa essa chave para acessar o Rational DOORS TRS. Essa chave deve corresponder à entrada Chave do consumidor na janela Chaves locais de configuração do Rational DOORS. O valor padrão é Chave do Usuário Funcional do LQE. Essa propriedade será necessária no arquivo festival.xml apenas se você usar um valor diferente do padrão.
    functional.user.consumer.secret
    Esse segredo do consumidor está associado ao usuário funcional LQE. O LQE usa essa chave para acessar o Rational DOORS TRS. Esse segredo corresponde às entradas Segredo OAuth na janela Chaves locais de configuração do Rational DOORS. O valor padrão é qwert6. Essa propriedade será necessária no arquivo festival.xml apenas se você usar um valor diferente do padrão.
    functional.user.name
    Essa propriedade é o nome do usuário funcional LQE. Esse usuário deve ser um padrão do Rational DOORS com privilégios para ler todos os dados do Rational DOORS destinados ao uso no LQE. Esse valor deve corresponder à entrada Nome do Consumidor na janela Chaves locais de configuração do Rational DOORS. O valor padrão é Usuário Funcional do LQE. Essa propriedade será necessária no arquivo festival.xml apenas se você usar um valor diferente do padrão.
    functional.user.password
    Essa propriedade é a senha do usuário funcional LQE. O valor padrão é qwert6. Essa propriedade será necessária no arquivo festival.xml apenas se você usar um valor diferente do padrão.
    trs.db.user
    Essa propriedade é um nome de usuário para a ativação TRS. O nome do usuário padrão é trs. Essa propriedade será necessária no arquivo festival.xml apenas se você usar um valor diferente do padrão.
    trs.db.password
    Essa propriedade é a senha para trs.db.user. O valor padrão é dwaTrsPa11word. Essa propriedade será necessária no arquivo festival.xml apenas se você usar um valor diferente do padrão. Se você usar um valor diferente do padrão, deverá inserir a nova senha no arquivo de propriedades do Derby, conforme descrito nas próximas etapas deste procedimento.
    trs.page.size
    Esta propriedade indica o número de recursos TRS a serem incluídos em uma página. O valor padrão é 250.
    trs.enable
    Defina este valor como verdadeiro.
    A extração a seguir do arquivo festival.xml mostra um exemplo de propriedades relacionadas ao TRS:
    <f:property name="ForceHttpsForAuthenticationForOAuth" value="true"/> 
    <f:property name="functional.user.consumer.key" value="LQE Functional User Key"/> 
    <f:property name="functional.user.consumer.secret" value=qwert6"/> 
    <f:property name="functional.user.name" value="LQE Functional User"/> 
    <f:property name="functional.user.password" value="qwert6"/> 
    <f:property name="trs.enable" value="true"/>
  4. Salve e feche o arquivo festival.xml.
  5. Se você tiver alterado o valor padrão do trs.db.password no arquivo festival.xml, siga estas etapas:
    1. Abra o arquivo derby.properties em um editor. O arquivo está no diretório dwa_install/derby.
    2. Substitua o valor derby.user.trs. O arquivo derby.properties inclui os valores a seguir:
      derby.user.trs
      Essa é a senha para a propriedade trs.db.user que você especificou no arquivo festival.xml. O valor padrão é dwaTrsPa11word.
      derby.user.admin
      Essa é a senha para o administrador do banco de dados Derby. Atualmente, esse usuário não fornece funções para o Rational DOORS Web Access. O valor padrão é dwaTrsPa11word.
  6. Inicie todos os componentes do Rational DOORS Web Access, conforme descrito em Iniciando, parando e removendo o Rational DOORS Web Access.

O que Fazer Depois

Depois que a integração com um aplicativo consumidor TRS for configurada com relacionamentos amigos OSLC, você deverá registrar o Rational DOORS como um provedor TRS no aplicativo consumidor. Para um exemplo desse procedimento, na documentação do IBM Rational Engineering Lifecycle Management, consulte "Registrar aplicativos como provedores TRS para os Lifecycle Query Engines".

O LQE, que é usado por um aplicativo consumidor TRS, como o Rational Engineering Lifecycle Management, compila um índice mestre, ou banco de dados, de dados de várias ferramentas de ciclo de vida. Cada ferramenta do provedor TRS publica seus dados por meio do TRS. O LQE pode coletar ou indexar os dados de cada ferramenta. As equipes podem gravar consultas, que são relatórios like, para dados indexados na linguagem SPARQL. Quando você incluir uma origem de dados para o Rational DOORS no aplicativo de Administração LQE, configure estes valores:
  • Número de encadeamentos para indexação inicial: 1
  • Número de encadeamentos para indexação incremental: 1
  • Taxa de atualização: 60
Na guia Administração, clique em Configuração > Propriedades avançadas e configure os valores de tempo limite HTTP a seguir. O valor padrão é 60 segundos. Aumente ambos os valores:
  • Tempo limite de conexão (mínimo): 5 minutos (300 segundos)
  • Tempo limite de soquete (mínimo): 15 minutos (900 segundos)

Feedback