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:
- O WebSphere Application Server
já está instalado.
- O banco de dados é criado e o arquivo teamserver.properties é atualizado com suas configurações de banco de dados.
- Ativar o login sem distinção entre maiúsculas e minúsculas (opcional): Se o método de autenticação do servidor de aplicativos permitir login sem distinção entre maiúsculas e minúsculas, será possível fazer com que o aplicativo Jazz aceite-os também. A permissão do login sem distinção entre maiúsculas e minúsculas pode ser ativada através da propriedade "Usar correspondência de ID de usuário sem distinção entre maiúsculas e minúsculas" na página Propriedades Avançadas da IU da Web do administrador. O padrão é inalterado; os administradores devem substituir de forma explícita esta propriedade para ativar o login sem distinção entre maiúsculas e minúsculas.
- A opção de Segurança do Java™ 2 deve ser desligada. Se esta opção estiver ativada no WebSphere Application Server, ela fará o .war do
Jazz Team
Server falhar ao iniciar.
- Assegure-se de que a configuração de segurança do WAS "Usar dados de autenticação disponíveis quando um URI desprotegido for acessado" esteja marcada. Se você estiver usando o Integrated Solutions Console do WAS, poderá fazer isto:
- Navegando para Segurança -> Administração, Aplicativos e Infraestrutura Seguros -> Segurança da Web - Configurações Gerais. (No WAS 7.0.0.7, navegue para Segurança -> Segurança Global -> Segurança do SIP e Web -> Configurações Gerais.)
- Selecionando a caixa de opção para "Usar dados de autenticação disponíveis quando um URI desprotegido é acessado".
- O Jazz Team
Server inclui os arquivos necessários para executar um servidor baseado em Apache Tomcat completo. Para uma instalação do WebSphere, você precisa apenas de um subconjunto de arquivos do Jazz Team
Server e deve colocá-los em um diretório em sua máquina de servidor do WebSphere. Instruções posteriores mencionam isso como o diretório de instalação do Jazz Team
Server, ou
JazzInstallDir para abreviar. A partir deste diretório, utilize:
- O arquivo JazzInstallDir/server/tomcat/webapps/jazz.war.
- O diretório
JazzInstallDir/server/update-site.
- O diretório JazzInstallDir/server/conf.
- O banco de dados do repositório padrão no JazzInstallDir/repositoryDB.
- As ferramentas do repositório no JazzInstallDir/repotools.
- O diretório JazzInstallDirserver/license-update-site.
- O diretório JazzInstallDir/server/nl1-update-site.
- O diretório JazzInstallDir/server/nl2-update-site.
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
- 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).
- 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/.
- 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:
- Clique em .
- Clique em server1.
- Clique em .
- Clique em Java Virtual Machine.
- Inclua o valor 100 no Heap Inicial.
- Inclua o valor 1000 ao Tamanho Máximo do Heap.
- Clique em Aplicar.
- 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.
- 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.
- 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
- Clique em Salvar diretamente na configuração principal.
- 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.
- Abra o console administrativo para o seu WebSphere Application Server.
- Clique em . (Para WebSphere Application Server 7.0.0.7 e posterior,
clique em .)
- Em Caminho para o novo Aplicativo,
clique em Sistema de Arquivos Local.
- Sob Caminho Completo, digite:
JazzInstallDir/server/tomcat/webapps/jazz.war
- 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.
- Clique em Avançar e continue com as etapas de Instalação do Novo Aplicativo restantes.
- Clique em Concluir.
- Verifique se o aplicativo jazz_war foi instalado e clique em Salvar diretamente na configuração principal.
- Clique em .
- 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.
- Retorne para a página Instalar Novo Aplicativo.
- 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.
- Continue clicando em Avançar até ver a tela
Sumário, em seguida, clique em Concluir para instalar o novo aplicativo.
- Verifique se o aplicativo help_war foi instalado e clique em Salvar para
salvar as alterações no arquivo de Configuração Principal.
- Clique em .
- Selecione help_ war e clique em Iniciar.
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