Modificando o Arquivo de Configuração Principal

O arquivo festival.xml é o arquivo de configuração principal no IBM® Rational DOORS Web Access. 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 p broker estiver no mesmo sistema que o servidor do Rational DOORS Web Access, não será necessário editar estas entradas.
    <!-- Brokers que conhecemos -->
    <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 nome é o nome exibido na página de logon do Rational DOORS Web Access. É possível alterar esse atributo. O padrão é DOORS ERS Repository.
    2. O atributo repositoryUrn deve corresponder ao Nome do Recurso Uniforme (URN) do servidor de banco de dados do Rational DOORS identificado em Identificando o Nome de Recurso Uniforme (URN) 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 Rational DOORS Web Access, a fim de 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 Rational DOORS utilizar LDAP corporativo para autenticação de usuário, você deverá incluir uma linha para remover a opção Alterar 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 somente as licenças de cliente do IBM Rational DOORS forem usados, configure use.doors.client.license.only para true. Nesse caso, o aplicativo não verifica licenças do Rational DOORS Web Access Reviewer and 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 será truncado a 100 caracteres quando um objeto do Rational DOORS for 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 Conversão Layer Reportable Rest saída falhe se um erro ocorre quando os dados são recebidos do Rational DOORS Web Access. 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.

Feedback