Configurando um WebSphere Application Server

Este tópico descreve como configurar o Jazz Team Server para funcionar com o WebSphere Application Server. Esta configuração assume que você está instalando o Jazz Team Server na mesma máquina que o Websphere Application Server. As instruções são baseadas no WebSphere Application Server versão 6.1.0.23. Existem pequenas variações para a versão 7.0.0.7 e posterior. Essas variações são anotadas no texto onde for apropriado.

Antes de Iniciar

Antes de iniciar estas etapas, você deve ter concluído o seguinte:
Dica: Quando você utiliza o IBM® Installation Manager para instalar Jazz Team Server para uso com Rational Team Concert, os arquivos do Jazz Team Server podem ser instalados em um diretório de aplicativos da Web. Durante o processo de instalação, você não deve instalar o servidor de aplicativos Apache Tomcat; isto faz com que o Installation Manager solicite um diretório de Aplicativo da Web e instale apenas os arquivos necessários para o WebSphere. O diretório padrão é C:\Program Files\IBM\JazzTeamServer noWindows® ou /opt/IBM/JazzTeamServer no Linux®. O diretório de instalação é mencionado como JazzInstallDir neste procedimento. Se utilizar o IBM Installation Manager para instalar os arquivos no diretório de aplicativos da Web do WebSphere Application Server, você não precisará mover os arquivos manualmente conforme descrito acima.

Sobre Esta Tarefa

Nota: Este documento não ensina a configuração da autenticação do WebSphere ou SSL, que é um tópico complexo. Informações detalhadas sobre as diversas opções de autenticação e criptografia para o WebSphere são cobertas no Centro de Informações do WebSphere. Para obter mais informações, acesse o Centro de Informações do WebSphere e procure Protegendo Aplicativos e Seu Ambiente. O Jazz Web UI requer que a autenticação seja configurada para realizar a autorização e personalizar o aplicativo.

Procedimento

  1. Revise e atualize o local do banco de dados no arquivo teamserver.properties.
    com.ibm.team.repository.db.vendor = DB2
    com.ibm.team.repository.db.jdbc.location=//localhost:50000/JAZZ:user=db2admin;password={password};
    com.ibm.team.repository.db.jdbc.password=db2admin
    Nota: Esta é uma configuração de amostra do DB2. O teamserver.properties deve ser atualizado dependendo do fornecedor do banco de dados (Oracle/MS-SQL).
  2. Verifique ou atualize o nível do WebSphere Application Server.

    O Jazz Team Server exige que o WebSphere Application Server Versão 6.1 com o IBM Java SDK 1.5 SR5 ou Correção Acumulativa posterior aplicada, ou o WebSphere Application Server Versão 7.0 com no mínimo a 7.0.0.7 instalada. A atualização de SDK IBM Java SDK 1.5 SR6 está disponível no endereçohttp://www-1.ibm.com/support/docview.wss?rs=180&uid=swg24017492. Com oWebSphere 6.1 e o GA IBM Java SDK, o Jazz começa a relatar "erros de proxy" após algumas das operações.

    É necessário obter as i-fixes correspondentes do WebSphere Application Server para correções no IBM Java SDK 1.5 SR9 ou IBM Java SDK 1.6 SR4 que são necessárias para o IBM Rational Team Concert 2.0 executar corretamente. Caso contrário, alguns serviços no servidor poderão não iniciar corretamente. As i-fixes estão disponíveis em seus APARs correspondentes do WebSphere Application Server. Para o IBM Java SDK 1.5/WebSphere Application Server 6.1, o APAR é PK85942 e você pode fazer download dos arquivos a partir de ftp://ftp.software.ibm.com/software/websphere/appserv/support/fixes/PK85942/. Instale no mínimo o WebSphere Application Server 6.1 fixpack 19 antes de instalar o i-fix do JRE. Para o IBM Java SDK 1.6/WebSphere Application Server 7.0, o APAR é PK 86771 e você pode fazer download dos arquivos a partir de ftp://ftp.software.ibm.com/software/websphere/appserv/support/fixes/PK86771/.

  3. Atualize os argumentos da JVM.

    O Jazz Team Server precisa de algumas configurações específicas na Java Virtual Machine na qual é executado.

    A primeira propriedade que precisa ser configurada nos argumentos Genéricos da JVM é a alocação máxima de memória padrão, usando a configuração -Xmx. Isto deve ser configurado com base no tamanho da equipe suportada pelo servidor e a capacidade de memória do servidor onde o Jazz Team Server está em execução. Uma típica equipe de tamanho médio pode usar um valor de -Xmx1536M, fornecendo 1536 MB de memória heap para o processo do Jazz Team Server.

    Uma segunda propriedade que precisa ser configurada nos argumentos Genéricos da JVM, especificamente para o Rational Quality Manager, é o tamanho da pilha de encadeamento. Um tamanho de pilha típico para o Rational Quality Manager é -Xss786K.

    Se você estiver conectando-se a um banco de dados Oracle ou SQL Server, precisará incluir uma propriedade denominada "ORACLE_JDBC" ou "SQLSERVER_JDBC". Configure a propriedade com o caminho de arquivo absoluto (não uma URL) para os drivers JDBC apropriados.

    Os exemplos a seguir mostram os argumentos Genéricos da JVM para conexão com os bancos de dados Oracle e SQL Server, juntamente com a alocação de memória máxima padrão e o tamanho da pilha de encadeamento. Substitua JazzInstallDir por seu diretório de instalação do Jazz Team Server.

    -DORACLE_JDBC=JazzInstallDir\server\oracle -Xmx1536M -Xss768k
    -DSQLSERVER_JDBC=JazzInstallDir\server\sqlserver -Xmx1536M -Xss768k

    Há diversas outras propriedades de sistema que precisam ser configuradas para controlar determinados comportamentos do servidor. Elas estão incluídas a seguir. Aqui há informações específicas sobre a configuração dessas propriedades da JVM no WebSphere Administrative Console. Substitua JazzInstallDir por seu diretório de instalação do Jazz Team Server:

    1. Clique em Servidores > Servidores de Aplicativos.
    2. Clique em server1.
    3. Clique em Gerenciamento Java e de Processos > Definição do Processo.
    4. Clique em Java Virtual Machine.
    5. Inclua o valor 100 no Heap Inicial.
    6. Inclua o valor 1000 ao Tamanho Máximo do Heap.
    7. Clique em Aplicar.
    8. Clique em Criação de Log e Rastreio. Clique em Alterar Níveis de Detalhes do Log. O Jazz Team Server utiliza o mecanismo de relatório BIRT. Para evitar que entradas informativas BIRT sejam gravadas no arquivo de log do WebSphere, configure o nível de criação de log como severe para os pacotes org.eclipse.birt.*. Clique em Aplicar.
    9. Clique em Servidores de Aplicativos > {server_name} > Definição de Processo > Java Virtual Machine > Propriedades Customizadas. Uma das propriedades customizadas que você precisa incluir é JAZZ_HOME, uma propriedade do sistema que especifica onde localizar certos arquivos de configuração. Esta propriedade usa uma URL em vez de um caminho simples, portanto, o valor deve ser especificado como uma URL arquivo://-style.
    10. Inclua as seguintes propriedades: Clique em Novo; digite Nome e Valor; então clique em OK.
      • Nome: java.awt.headless Valor: true
      • Nome: org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin Valor: true
      • Nome: JAZZ_HOME Valor: file:///JazzInstallDir/server/conf
    11. Clique em Salvar diretamente na configuração principal.
    Importante: Apenas para Solaris, você também deve incluir o seguinte argumento de linha de comandos Java:
    -XX:MaxPermSize=256m
    Para obter informações adicionais, consulte o Capítulo 2, "Configurando um Ambiente Solaris para WebSphere Application Server" do redbook IBM WebSphere Application Server V6.1 on the Solaris 10 Operating System.
  4. Reinicie o Websphere para instalar o Jazz Application.
    Nos exemplos de linha de comandos a seguir, WASInstallDir representa o local onde o WebSphere Application Server está instalado em seu servidor.
    • No Windows, o valor padrão para o diretório de instalação do WebSphere é:
      C:\Program Files\IBM\WebSphere\AppServer
      Você pode reiniciar o servidor com os seguintes comandos no Windows:
      cd WASInstallDir\bin 
      stopServer.bat server1 [para um servidor seguro, inclua: -username {LDAP_User} -password {LDAP_Password}] 
      startServer.bat server1
    • No Linux, o valor padrão para o diretório de instalação do WebSphere é:
      /opt/IBM/WebSphere/AppServer
      Você pode reiniciar o servidor com os seguintes comandos no Linux:
      cd WASInstallDir/bin 
      ./stopServer.sh server1 [para um servidor seguro, inclua: -username {LDAP_User} -password {LDAP_Password}] 
      ./startServer.sh server1
    1. Abra o console administrativo para o seu WebSphere Application Server.
    2. Clique em Aplicativos > Instalar Novo Aplicativo. (Para WebSphere Application Server 7.0.0.7 e posterior, clique em Aplicativos > Novo Aplicativo > Novo Aplicativo Corporativo.)
    3. Em Caminho para o novo Aplicativo, clique em Sistema de Arquivos Local.
    4. Sob Caminho Completo, digite:
      JazzInstallDir/server/tomcat/webapps/jazz.war
    5. Configure Raiz de Contexto como /jazz e clique em Avançar.
      Nota: Esta etapa aparece no final da instalação no WebSphere Application Server 7.0.0.7 e posterior.
    6. Clique em Avançar e continue com as etapas de Instalação do Novo Aplicativo restantes.
    7. Clique em Concluir.
    8. Verifique se o aplicativo jazz_war foi instalado e clique em Salvar diretamente na configuração principal.
    9. Clique em Aplicativos > Aplicativos Corporativos.
    10. Selecione a caixa próxima a jazz_war; clique em Iniciar.

      Uma seta verde deve aparecer, indicando que o aplicativo foi iniciado com êxito.

      Nota: As etapas restantes são apenas para Rational Quality Manager.
    11. Retorne para a página Instalar Novo Aplicativo.
    12. Navegue para o local do arquivo help.war no sistema de arquivos local e selecione o arquivo. Digite a raiz de contexto como /help e clique em Avançar.
      Nota: É possível localizar o arquivo help.war em JazzInstallDir\server\tomcat\webapps\help.war.
    13. Continue clicando em Avançar até ver a tela Sumário, em seguida, clique em Concluir para instalar o novo aplicativo.
    14. Verifique se o aplicativo help_war foi instalado e clique em Salvar para salvar as alterações no arquivo de Configuração Principal.
    15. Clique em Aplicativos > Aplicativos Corporativos.
    16. Selecione help_ war e clique em Iniciar.

O que Fazer Depois

Se for um usuário do Rational Team Concert, prossiga para o tópico Executando o Assistente de Configuração. Para Rational Quality Manager, continue com o tópico "Configurando LDAP no WebSphere Application Server" e depois com o tópico "Executando o Assistente de Configuração do Jazz Team Server".

Para obter informações adicionais sobre este tópico, visite os seguintes links:

http://jazz.net/library/techtip/95

https://jazz.net/wiki/bin/view/Main/WASSetupFAQ


Feedback