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.

Antes de Iniciar
Antes de iniciar estas etapas, você deve ter concluído o seguinte:
Dica: Ao utilizar o IBM® Installation Manager, os arquivos doJazz Team Server podem ser instalados em um diretório do aplicativo 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 você utilizar o IBM Installation Manager para instalar os arquivos no diretório de aplicativos da Web do WebSphere Application Server, então não é necessário mover os arquivos manualmente conforme descrito acima.
Por Que e Quando Desempenhar 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 informações adicionais, vá para o Centro de Informações do WebSphere e procure Fornecendo Segurança para Aplicativos e para o seu Ambiente. O Jazz Web UI requer que a autenticação seja configurada para realizar a autorização e personalizar o aplicativo.
  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 do DB2 de amostra. 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.

    Jazz Team Server requer o WebSphere Application Server Versão 6.1 com a Correção Acumulativa do IBM Java SDK 1.5 SR5 ou posterior aplicada ou o WebSphere Application Server Versão 7.0 com pelo menos 7.0.0.3 instalado. 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 pelo menos 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.

    Primeiro, ele precisa saber onde localizar alguns arquivos de configuração. Isto é feito configurando uma propriedade de sistema JAZZ_HOME. Esta propriedade usa uma URL em vez de um caminho simples, portanto, o valor deve ser especificado como uma URL arquivo://-style.

    A segunda propriedade que é requerida pela JVM do Jazz é fornecê-la com mais do que a alocação máxima de memória padrão, utilizando 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.

    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.

    Há algumas outras propriedades do sistema que precisam ser configuradas para controlar o comportamento do servidor. Elas estão incluídas abaixo. A seguir estão as condições específicas da configuração destas propriedades JVM noWebSphere 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 do 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 Propriedades Customizadas
    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: Para Solaris apenas, você também deve incluir o seguinte argumento da linha de comandos Java:
    -XX:MaxPermSize=256m
    Para obter informações adicionais, consulte o Capítulo 2, "Configuring a Solaris environment for 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.
    3. Sob Caminho para o Novo Aplicativo, clique em Sistema de Arquivos Local.
    4. Sob Caminho Completo, digite:
      JazzInstallDir/server/jazz.war
    5. Configure Raiz de Contexto para /jazz.
    6. Clique em Avançar e continue com as etapas de Instalação do Novo Aplicativo restantes.
    7. Clique em Concluir.
    8. 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.

O que Fazer Depois
Após o servidor ser iniciado, continue com o Executando o Assistente de Configuração.

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

Isto foi útil? É possível fornecer feedback em Jazz.net (é necessário registrar-se): Comentar nos fóruns ou submeter um erro