Este tópico descreve como configurar o
Jazz Team Server para System z para funcionar com 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.
- Consulte sua documentação do WebSphere para configuração de segurança e desative a propriedade sem distinção entre maiúsculas e minúsculas.
Nota: Embora
o Websphere e muitos diretórios LDAP permitam efetuar login sem distinção de maiúsculas e minúsculas,
o Jazz Team Server para System z armazena registros do usuário com IDs do usuário com
correspondência exata de maiúsculas e minúsculas com que eles foram importados. Ao efetuar login no Jazz Team
Server para System z, o registro do usuário é recuperado da lista de usuários
e as maiúsculas e minúsculas devem corresponder exatamente.
- A opção Java™ 2
Security deve ser desativada.
Se esta opção estiver ativada no WebSphere Application Server, ela fará o
.war do Jazz Team Server para System z falhar ao iniciar.
- Assegure-se de que a configuração de segurança WAS "Usar dados de autenticação disponíveis quando uma URI não-protegida for acessada" esteja marcada. Se estiver usando o WAS Integrated Solutions Console, você pode fazer isto:
- Navegando para Segurança -> Administração segura, aplicativos e infraestrutura -> Segurança da Web - Configurações Gerais.
- Selecionando a caixa de opção para "Usar dados de autenticação disponíveis quando uma URI não-protegida for acessada".
- O Jazz Team Server para System z 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 dos arquivos do Jazz Team Server para System z
e deve colocá-los em um diretório na máquina servidor do WebSphere.
Instruções posteriores referem-se a isto como o diretório de instalação do Jazz Team Server
para System z, 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 em JazzInstallDir/repositoryDB.
- As ferramentas de repositório em 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.
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 amostra de configuração 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. Consulte Requisitos do Sistema
Detalhados para Ambientes do Servidor Rational Team
Concert para System z.
- Atualize os argumentos da JVM.
O Jazz Team Server
para System z precisa de algumas configurações específicas na Java Virtual
Machine na qual ele é executado.
Primeiro, ele precisa saber onde encontrar alguns arquivos de configuração. Isto é feito através da configuração de uma propriedade de sistema JAZZ_HOME. Esta propriedade usa uma URL em vez de um caminho simples, assim o valor deve ser especificado como uma URL no estilo file://.
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 na capacidade de memória do servidor no qual
o Jazz Team Server para System z está em execução. Uma equipe típica de tamanho médio
pode usar um valor -Xmx1000M, fornecendo 1000 MB de memória de heap
para o processo do Jazz Team Server para System z.
Se estiver se conectando a um banco de dados Oracle ou Servidor SQL, então você precisa incluir uma propriedade chamada "ORACLE_JDBC" ou "SQLSERVER_JDBC". Configure a propriedade para o caminho de arquivo absoluto (não uma URL) para os drivers JDBC adequados.
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 os detalhes específicos
da configuração destas propriedades JVM no WebSphere Administrative
Console, substitua JazzInstallDir pelo diretório de instalação
do Jazz Team Server para System z.
- 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 para System z usa
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 seguintes exemplos da linha de comandos,
WASInstallDir representa
o local onde o WebSphere Application Server
está instalado no 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.