Modificando o Arquivo de Configuração Principal

O arquivo festival.xml é o arquivo de configuração principal no IBM® Engineering Requirements Management DOORS - Web Access (DWA). Modifique as entradas para f:broker, f:repository-mapping e f:properties para corresponder à configuração do broker, do repositório e do servidor de licença.

Procedimento

  1. O arquivo festival.xml possui três entradas f:broker que descrevem onde está o broker. Edite estas entradas para que apontem para a URL do sistema onde o broker está instalado com a porta padrão (61616). Se o broker estiver no mesmo sistema que o servidor DWA, não será necessário editar essas entradas.
    <!-- Brokers we know about -->
    <f:endpoints>
       <f:broker 
          .
          url="tcp://127.0.0.1:61616?wireFormat.tcpNoDelayEnabled=true&amp;wireFormat.maxInactivityDuration=0" 
          .
          .
             
       <f:broker 
          .
          url="tcp://127.0.0.1:61616?wireFormat.tcpNoDelayEnabled=true&amp;wireFormat.maxInactivityDuration=0" 
          .
          .
             
       <f:broker 
          .
          url="tcp://127.0.0.1:61616?wireFormat.tcpNoDelayEnabled=true&amp;wireFormat.maxInactivityDuration=0" 
          .
          .
             
    </f:endpoints>
  2. A entrada f:repository-mapping deve corresponder ao recurso uniforme (URN) do repositório.
    1. O atributo name é o nome que é exibido na página de logon do DWA. É possível alterar esse atributo. O padrão é DOORS ERS Repository.
    2. O atributo repositoryUrn deve corresponder ao nome de recurso uniforme (URN) do servidor de banco de dados do IBM Engineering Requirements Management DOORS (DOORS) que você identificou no Identificando o Nome de Recurso Uniforme do banco de dados. É necessário alterar esse atributo.
    <!-- Mapeamento a partir dos IDs de repositório para o broker que usamos para atingir o repositório -->
       <f:mappings>
          <f:repository-mapping 
             .
             .
             name="DOORS ERS Repository"
             repositoryUrn="urn:rational:ers-46dd5d7806b96973:" />
       </f:mappings>
  3. Você deve alterar a seção f:properties do arquivo.
    1. Necessário se um servidor de licença não tiver sido configurado por outros meios, como o registro do Windows: insira o local do servidor de licença. Atualize o valor nesta linha:
      <f:properties>
        <f:property name="licence.server.location" value="19353@localhost"/>
      Esse local é incluído na lista de locais de licença retidos em seu sistema.
    2. Opcional: É possível configurar o DWA para exibir a URL do módulo atual na interface. Para exibir as URLs, altere o value="false" para value="true" nesta linha:
       <f:property name="display.redirector.urls" value="false"/>
    3. Opcional: Se o banco de dados do DOORS usar LDAP corporativo para autenticação do usuário, será necessário incluir uma linha para remover a opção Mudar senha da tela de boas-vindas. Inclua esta linha:
       <f:property name="change.password.enabled" value="false"/>
    4. Necessário: Configure ForceHttpsForAuthenticationForOAuth para falso:
       <f:property name="ForceHttpsForAuthenticationForOAuth" value="false" />
      Nota: Se o Tomcat estiver configurado para utilizar o SSL, configure o ForceHttpsForAuthenticationForOAuth para verdade.
    5. Opcional: Para se proteger contra ataques de segurança de falsificação de solicitação de site cruzado (CSRF), configure disable.csrf.token como false. Inclua esta linha:
       <f:property name="disable.csrf.token" value="false"/>
    6. Opcional: Para melhorar o desempenho quando apenas as licenças de cliente do DOORS são usadas, configure use.doors.client.license.only como true. Nesse caso, o aplicativo não verifica as licenças do DWA Reviewer e Editor. O valor padrão para essa configuração é false, o que faz com que o aplicativo verifique todos os tipos de licença. Inclua esta linha:
       <f:property name="use.doors.client.license.only" value="true"/>
    7. Opcional: Para modificar o limite de truncamento para o número de caracteres em um título do objeto, conforme relatado por um link OSLC, configure um valor do dcterms.title.truncation.limit no arquivo festival.xml. Por padrão, o campo OSLC dcterms:title é truncado em 100 caracteres quando um objeto do DOORS é referenciado por um link OSLC externo. Os caracteres restantes no título serão substituídos por reticências (...). É possível configurar esse valor para 0 para remover o truncamento completamente ou modificar o valor, conforme necessário. Essa configuração controla o limite de truncamento para todos os títulos de objeto em todas as integrações do OSLC. Para configurar o valor como zero, inclua essa linha:
       <f:property name="dcterms.title.truncation.limit" value="0"/>
    8. A propriedade rrtl.fail.on.error afeta serviços de relatórios que usam o para extrair, transformar e carregar (ETL) processo. O valor true faz com que a saída Rest da Camada de Tradução Reportável falhe se ocorrer um erro quando os dados forem recebidos do DWA. A falha torna mais fácil para o aplicativo de chamada para detectar e resolver quaisquer problemas ETL.
       <f:property name="rrtl.fail.on.error" value="true" />
  4. Salve e feche o arquivo.

ícone de vídeo Vídeo

Canal Jazz.net
Canal Software Education

ícone de aprendizado Cursos

IoT Academy
Skills Gateway

ícone de pergunta Comunidade

Jazz.net
Fóruns do Jazz.net
Biblioteca do Jazz.net

ícone de suporte Suporte

Comunidade de suporte IBM
Wiki de implementação