Configurando o WebSphere Application Server para Rational Engineering Lifecycle Manager

A implementação e início do Jazz Team Server começam com a seleção do servidor de aplicativos, que hospeda o Jazz Team Server e seus aplicativos. Antes de poder implementar arquivos war dos aplicativos do Rational Engineering Lifecycle Manager, você deverá configurar o WebSphere Application Server.

Antes de Iniciar

Certifique-se de ter concluído as seguintes tarefas:

A interface da Web do Jazz requer que a autenticação seja configurada para executar a autorização e personalizar o aplicativo.

Nota:
  • O Rational Engineering Lifecycle Manager v1.x deve compartilhar um servidor de aplicativos com o Lifecycle Query Engine.
  • O Rational Engineering Lifecycle Manager v4.x pode compartilhar um servidor de aplicativos com o Lifecycle Query Engine ou ser implementado em um servidor de aplicativos diferente. No entanto, ambos os aplicativos devem ser registrados no mesmo Jazz Team Server.

Sobre Esta Tarefa

Este documento não fornece detalhes para configurar autenticação do WebSphere ou SSL, que é um tópico complexo. Informações detalhadas sobre as várias opções de autenticação e de criptografia são cobertas no Centro de Informações do WebSphere Application Server. Para obter mais informações, acesse o Centro de Informações do WebSphere e use esta frase na procura: Protegendo Aplicativos e seu Ambiente.

Procedimento

  1. Rational Engineering Lifecycle Manager requer várias configurações específicas na Java Virtual Machine em que ele executa. Para configurar essas propriedades, no WebSphere Integrated Solutions Console, clique em Servidores > Tipos de Servidor > Servidores de Aplicativo WebSphere > Servidor1.
  2. Sob Infraestrutura do Servidor, clique em Gerenciamento Java e de Processos > Definição de Processo.
  3. Sob Propriedades Adicionais, clique em Java Virtual Machine.
  4. Inclua o valor 4096 em Heap Inicial.
  5. Inclua o valor 24576 em Tamanho Máximo de Heap.
    Dica: A figura aqui é somente uma sugestão; configure o valor de acordo com seu ambiente. Uma equipe típica de médio porte pode usar um valor de 4.096 MB, fornecendo 4 GB de memória heap para o processo do Rational Engineering Lifecycle Manager em um computador de 64 bits. Se o valor de Tamanho Máximo de Heap for muito pequeno, a origem de dados do Rational Engineering Lifecycle Manager para o Lifecycle Query Engine poderá precisar parar o processamento da lista não processada existente e quaisquer novas mudanças que criam, modificam ou excluem os produtos.

    Também é importante que haja mais memória física do que é necessário por todos os processos na máquina combinada para evitar paginação ou troca. A paginação reduz o desempenho do sistema e afeta o desempenho do sistema de gerenciamento da memória Java.

    Ao aumentar o tamanho de heap do Java, assegure que memória física não utilizada suficiente esteja disponível na máquina para cobrir o aumento. Se não houver memória física suficiente disponível, instale memória adicional ou leve em consideração o efeito sobre o desempenho geral que ocorre.

  6. No campo Argumentos de JVM Genéricos, digite a seguinte linha:
    Windows:
    -Xmx4g -Xms4g -Xmn512m
    -Xgcpolicy:gencon -Xcompressedrefs
    -Xgc:preferredHeapBase=0x100000000
    Linux:
    -Xmx4g -Xms4g -Xmn512m
    -Xgcpolicy:gencon -Xcompressedrefs
    -Xgc:preferredHeapBase=0x100000000
    Dica: Se precisar de mais tamanho de heap, será possível utilizar a configuração a seguir, substituindo {N} pela quantia de memória a ser usada e {N/8} por 1/8 da memória total. Por exemplo, se -Xmx for configurado como 8 g, -Xmn deve ser configurado como 1 g.
    -Xgcpolicy:gencon -Xmx{N} -Xms{N} -Xmn{N/8}
    -Xcompressedrefs  -Xgc:preferredHeapBase=0x100000000
  7. Clique em Aplicar e, em seguida, clique em Salvar Diretamente na Configuração Principal.
  8. Uma das propriedades customizadas que você deve incluir é JAZZ_HOME, uma propriedade do sistema que especifica onde localizar determinados arquivos de configuração. Essa propriedade usa uma URL em vez de um caminho simples, portanto, especifique o valor como uma URL com estilo de arquivo: file:///file path. Sob Java Virtual Machine > Propriedades Adicionais, clique em Propriedades Customizadas.
    Lembre-se: Você deve usar três barras (///) após file:
    Importante: Em um ambiente distribuído, quando estiver usando um servidor de aplicativos separado para cada aplicativo da Web, você deve incluir essas propriedades customizadas para cada instância do WebSphere Application Server.
  9. Clique em Novo, digite JAZZ_HOME no campo Nome e insira file:///JazzInstallDir/server/conf no campo Valor. Substitua JazzInstallDir pelo local do diretório de instalação do Jazz Team Server. Por exemplo, insira file:///C:/PROGRA~1/IBM/JazzTeamServer/server/conf no Windows ou insira file:///opt/IBM/JazzTeamServer/server/conf nos sistemas Linux.
    Nota: Para evitar problemas, não use espaços nos caminhos de arquivo. Para o diretório Program Files, é possível usar PROGRA~1, e para o diretório Program Files (x86), é possível usar PROGRA~2.
  10. Clique em OK.
  11. Repita a etapa 10 e inclua estas propriedades customizadas:
    • Nome: java.awt.headless Valor: true
    • Nome: org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin Valor: true
    • Se você estiver se conectando a um banco de dados Oracle, o caminho absoluto Name: ORACLE_JDBC_DRIVER_FILE Value: para o driver JDBC/ojdbc6.jar
      Nota: O caminho para o driver JDBC deve ser um caminho absoluto. Não use o caminho da URL (arquivo:///). Para obter informações adicionais sobre conexões Java Database Connectivity (JDBC) do Oracle, consulte Configurando um Banco de Dados Oracle para Rational Engineering Lifecycle Manager e o Lifecycle Query Engine
    • Nome: log4j.configuration Valor: file:///JazzInstallDir/server/conf/startup_log4j.properties
      Nota: As configurações que o arquivo startup_log4j.properties contém são usadas nos primeiros estágios no processo de inicialização para passar mensagens para o arquivo SystemOut.log do WebSphere Application Server. Após os estágios iniciais, cada aplicativo Jazz alterna para usar as configurações específicas do aplicativo do arquivo JazzInstallDir/server/conf/app context/log4j.properties.
  12. Clique em Salvar diretamente na configuração principal.
  13. Aumente o conjunto de encadeamentos padrão para permitir diversos usuários. Clique em Servidores > Tipos de Servidor > WebSphere Application Servers > Server1.
  14. Sob Propriedades Adicionais, clique em Conjuntos de Encadeamentos.
  15. Clique em WebContainer e aumente o tamanho máximo padrão de 50 a 200 encadeamentos.
  16. Clique em Salvar diretamente na configuração principal.
  17. Clique em Servidores > Tipos de servidores > Servidores de aplicativos > Server1 > Gerenciamento de sessão > Propriedades customizadas. Na página Propriedades customizadas, clique em Novo.
  18. Na página Configuração, insira InvalidateOnUnauthorizedSessionRequestException no campo Nome e insira true no campo Valor. O valor padrão para essa propriedade customizada de gerenciamento de sessão é false. Clique em OK ou Aplicar.
  19. Clique em Salvar na barra de tarefas do console para salvar as mudanças na configuração.
  20. Para que as mudanças entrem em vigor, reinicie o servidor de aplicativos.

O que Fazer Depois

Depois de ter configurado o servidor, é preciso implementar os arquivos de aplicativos para ele.

  1. No console administrativo do WebSphere Application Server, selecione Aplicativos > Instalar Novo Aplicativo (ou Aplicativos > Novo Aplicativo > Novo Aplicativo Corporativo).
  2. Em Caminho para o Novo Aplicativo, selecione Sistema de Arquivo Local.
  3. Em Caminho Completo, insira [dir_de_instalação_do_relm]/server/webapps/relm.war
  4. Configure a raiz de contexto para /relm
  5. Clique em Avançar e continue com as etapas restantes de Instalar Novo Aplicativo, conforme solicitado por esse editor. Clique em Concluir.
  6. Instale o aplicativo Configuration Management, vvc.war, usando as mesmas etapas acima, substituindo [relm_install_dir]/server/webapps/vvc.war pelo caminho e /vvc pela raiz de contexto.
  7. Instale o aplicativo do componente Gateway SPARQL, SPARQL_Gateway.war, usando as mesmas etapas conforme acima, substituindo [dir_de_instalação_do_relm]/server/webapps/SPARQL_Gateway.war para o caminho, e /SPARQL_Gateway como a raiz de contexto.
  8. Se você gostaria de servir a documentação do servidor em vez de visualizá-lo online, poderá também implementar o aplicativo relmhelp.war.
  9. Selecione Salvar diretamente na configuração principal.
  10. O Gateway SPARQL requer uma mudança para a ordem de carregamento de classes padrão.
    1. Selecione Aplicativos > Tipos de Aplicativos > Aplicativos Corporativos do WebSphere, escolha SPARQL_Gateway_war da lista de aplicativos.
    2. Clique em Carregamento de Classes e Detecção de Atualização.
    3. Na seção Ordem do Carregador de Classes, selecione Classes carregadas com o carregador de classes local primeiro (pai por último)
    4. Clique em OK e Salvar para configuração principal.
    5. Selecione Gerenciar Módulos. Selecione o módulo SPARQL_Gateway.
    6. Localize o campo Ordem do Carregador de Classes e selecione Classes carregadas com o carregador de classes local primeiro (pai por último).
    7. Clique em OK e Salvar para configuração principal.
  11. Na página Aplicativos Corporativos, selecione os aplicativos que você acabou de implementar no WebSphere Application Server e selecione Iniciar.
Nota: Este documento não fornece detalhes para configurar autenticação do WebSphere ou SSL, que é um tópico complexo. Informações detalhadas sobre as várias opções de autenticação e de criptografia são cobertas no Centro de Informações do WebSphere Application Server. Para obter informações adicionais, acesse o Centro de Informações do WebSphere e use esta frase na procura: Segurando Aplicativos e seu Ambiente.

Feedback