Configurando o WebSphere Application Server para Rational Engineering Lifecycle Manager

A implementação e iniciação do Jazz Team Server começam com a seleção do servidor de aplicativos, que hospeda o Jazz Team Server e seus aplicativos. Antes que seja possível implementar os arquivos WAR do aplicativo Rational Engineering Lifecycle Manager, deve-se configurar o WebSphere Application Server.

Antes de Iniciar

Importante: Se você estiver fazendo upgrade de uma versão mais antiga do produto, siga as instruções de upgrade para configurar seu servidor de aplicativos.
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 criptografia são cobertas na documentação do produto WebSphere Application Server. Para obter mais informações, acesse a documentação do produto WebSphere e use esta frase na procura: Assegurando aplicativos e seu ambiente.

Procedimento

  1. Configure a Java Virtual Machine na qual o Rational Engineering Lifecycle Manager é executado.

    Clique em Servidores > Tipos de Servidor > WebSphere Application Servers > Server1. Em Infraestrutura do Servidor, clique em Java e Gerenciamento de Processo > Definição de Processo. Em Propriedades Adicionais, clique em Java Virtual Machine. Insira as configurações a seguir. Clique em Aplicar e, em seguida, Salvar diretamente na configuração principal.

    Tabela 1. Configuração da Java Virtual Machine
    Campo Valor Comentários
    Heap Inicial 4096  
    Tamanho Máximo do Heap 24576
    • 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 4096 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 Tamanho Máximo do Heap for muito pequeno, a origem de dados do Rational Engineering Lifecycle Manager para o Lifecycle Query Engine pode parar o processamento do backlog existente, e quaisquer novas mudanças que criam, modificam ou excluem produtos.
    • É 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 do heap Java, assegure-se de que memória física não usada 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.
    Argumentos genéricos de JVM Linux
    -Xmx4g -Xms4g -Xmn512m
    -Xgcpolicy:gencon -Xcompressedrefs
    -Xgc:preferredHeapBase=0x100000000
    Windows
    -Xmx4g -Xms4g -Xmn512m
    -Xgcpolicy:gencon -Xcompressedrefs
    -Xgc:preferredHeapBase=0x100000000
    Linux
    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
  2. Configure suas propriedades customizadas.

    Sob Propriedades Adicionais, clique em Propriedades Customizadas > Novo. Insira as informações de propriedades gerais para cada uma das propriedades customizadas a seguir e clique em OK para salvar as informações para cada propriedade customizada. Em seguida, clique em Salvar diretamente na configuração principal.

    Tabela 2. Informações das propriedades customizadas
    Nome da Propriedade Customizada Valor da Propriedade Customizada Comentários
    JAZZ_HOME file:///JazzInstallDir/server/conf

    Substitua JazzInstallDir pelo diretório de instalação do Jazz Team Server.

    Lembre-se:
    • Você deve usar três barras (///) após file:
    • 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.
    Exemplos:

    Linux file:///opt/IBM/JazzTeamServer/server/conf

    Windows file:///C:/PROGRA~1/IBM/JazzTeamServer/server/conf

    A propriedade de sistema especifica onde localizar determinados arquivos de configuração. Esta propriedade usa uma URL ao invés de um caminho simples. Insira um valor como uma URL no estilo de arquivo: file:///file_path.
    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.
    java.awt.headless verdadeiro  
    org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin verdadeiro  
    Oracle

    ORACLE_JDBC_DRIVER_FILE

    Caminho absoluto para o JDBC_driver/ojdbc6.jar 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

    SQL_JDBC_DRIVER_FILE

    Caminho absoluto para o JDBC_driver/sqljdbc4.jar O caminho para o driver JDBC deve ser um caminho absoluto. Não use o caminho da URL (arquivo:///). Para obter mais informações sobre como conectar-se a um banco de dados SQL Server, consulte a Documentação para o Rational Solution for Collaborative Lifecycle Management.
    log4j.configuration file:///JazzInstallDir/server/conf/startup_log4j.properties  
  3. Aumente o conjunto de encadeamentos padrão para permitir diversos usuários.

    Clique em Servidores > Tipos de Servidor > WebSphere Application Servers > Server1. Sob Propriedades Adicionais, clique em Conjunto de encadeamentos > WebContainerConjuntos de encadeamentos. Aumente o tamanho máximo padrão de 50 para 200 encadeamentos e clique em Salvar diretamente na configuração principal.

  4. Configure a propriedade customizada InvalidateOnUnauthorizedSessionRequestException.
    Clique em Servidores > Tipos de servidores > Servidores de aplicativos > Server1 > Gerenciamento de sessões > Propriedades customizadas > Novo. Insira o par de nome e valor para sua propriedade customizada. Clique em OK ou Aplicar e, em seguida, clique em Salvar na barra de tarefas do console para salvar suas alterações de configuração.
    Tabela 3. Informações da propriedade customizada
    Nome da Propriedade Customizada Valor da Propriedade Customizada Comentários
    InvalidateOnUnauthorizedSessionRequestException verdadeiro O valor padrão para essa propriedade customizada de gerenciamento de sessão é false.
  5. Configure a biblioteca compartilhada do Jazz Reporting Service.
    1. No console administrativo, acesse Ambiente > Bibliotecas compartilhadas. Altere o escopo suspenso para server e clique em Novo.
    2. Insira o nome da biblioteca compartilhada como Biblioteca Compartilhada JRS, inclua uma descrição e configure o caminho de classe para 5.0.1_install_dir/server/conf/rs/SharedLibrary. Sob Carregamento de Classe, selecione a caixa de seleção para usar um carregador de classes isolado para a biblioteca compartilhada e clique em Aplicar.
    3. Clique em Salvar na configuração principal.
  6. Reinicie o servidor de aplicativos para que as mudanças entrem em vigor.
    • Linux Execute os comandos stopServer.sh e startServer.sh.
    • Windows Execute os comandos stopServer.bat e startServer.bat.

O que Fazer Depois

  1. Implemente seus arquivos de aplicativos.
    1. No console administrativo do WebSphere Application Server, acesse Aplicativos > Novo Aplicativo > Novo Aplicativo Corporativo.
    2. No assistente Preparando para instalação do aplicativo, sob Caminho para o novo aplicativo, selecione Sistema de arquivos local e especifique o caminho completo para o seu arquivo de aplicativo. No assistente Instalar Novo Aplicativo, configure a raiz de contexto do aplicativo e siga todas as etapas de instalação. Na página de resumo Instalar Novo Aplicativo, verifique suas opções de instalação selecionadas e clique em Concluir.
      Tabela 4. Arquivos de valores do aplicativo
      Aplicativo Valor do Caminho Completo Raiz de Contexto
      Rational Engineering Lifecycle Manager RELM_install_dir/server/webapps/relm.war /relm
      Documentação do Rational Engineering Lifecycle Manager RELM_install_dir/server/webapps/relmhelp.war /relmhelp
      Aplicativo Configuration Management RELM_install_dir/server/webapps/vvc.war /vvc
      Jazz Reporting Service RELM_install_dir/server/webapps/rs.war /rs
    3. Clique em Salvar diretamente na configuração principal.

  2. Inclua a referência de biblioteca do Jazz Reporting Service.
    1. Acesse Aplicativos > Tipos de aplicativos > WebSphere Enterprise Applications e clique em rs_war na lista de aplicativos.
    2. Na seção Referência, clique em Referências da biblioteca compartilhada.
    3. Selecione a caixa de seleção próxima a rs_war e clique em Bibliotecas compartilhadas de referência.
    4. Selecione Biblioteca compartilhada JRS e clique na seta para a direita.
    5. Clique em OK. Em seguida, clique em OK novamente para salvar suas configurações na configuração principal.

  3. Assegure-se de que a ordem de carregamento de classes do Jazz Reporting Service seja configurada corretamente.
    1. Acesse Aplicativos > Tipos de aplicativos > WebSphere Enterprise Applications e clique em rs_war na lista de aplicativos.
    2. Na seção Propriedades de detalhes, 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 em Salvar na configuração principal.

  4. 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 criptografia são cobertas na documentação do produto WebSphere Application Server. Para obter mais informações, acesse a documentação do produto WebSphere e use esta frase na procura: Assegurando aplicativos e seu ambiente.

Feedback