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:
- 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 Java™ 2
Security deve ser desativada.
Se esta opção estiver ativada no WebSphere Application Server, fará com que o .war
do Jazz Team
Server falhe 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.
- 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: 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.
- 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).
- 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/.
- 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:
- 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 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.
- Clique em Propriedades Customizadas
- 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 .
- Sob Caminho para o Novo Aplicativo, clique em Sistema de Arquivos Local.
- Sob Caminho Completo, digite:
JazzInstallDir/server/jazz.war
- Configure Raiz de Contexto para /jazz.
- Clique em Avançar e continue com as etapas de Instalação do Novo Aplicativo restantes.
- Clique em Concluir.
- 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.
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