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 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 possibilitem que você faça login sem distinção entre maiúsculas e minúsculas, o Jazz Team Server armazena registros do usuário com IDs de usuário exatamente como eles são importados. Ao efetuar login no Jazz Team Server, o registro do usuário é recuperado da lista de usuários a utilização de letras maiúsculas e minúsculas deve corresponder exatamente.
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.
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/teamserver.properties.
- O arquivo JazzInstallDir/server/log4j.properties. Se você utilizar um Websphere Application Server, neste arquivo você pode alterar o caminho para o arquivo jazz.log, que registra apenas mensagens do Jazz Team Server. O caminho padrão é tomcat/logs/jazz.log.
- O arquivo JazzInstallDir/server/tomcat/webapps/jazz.war.
- O diretório JazzInstallDir/server/provision_profiles.
- O diretório JazzInstallDir/server/update-site.
- O banco de dados do repositório padrão no JazzInstallDir/repositoryDB.
- As ferramentas do repositório no JazzInstallDir/repotools.

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.

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.

Modifique os arquivos profile.ini e license-profile.ini:
Edite cada um dos perfis no JazzInstallDir/server/provision_profiles/ e configure um caminho absoluto para a propriedade da URL.
Exemplo,
- Altere esta linha:
```
url=file:./update-site
```
- Para algo como:
```
url=file:/opt/IBM/JazzTeamServer/server/update-site
```
Nota: O diretórioJazzInstallDir/server/provision_profiles/ deve conter apenas os arquivos .ini incluídos e não deve conter nenhum arquivo de backup. Alguns editores salvam automaticamente um arquivo de backup que deve ser removido.

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:fullyMaterializeLobData=false;user=db2admin;password={password};
com.ibm.team.repository.db.jdbc.password=db2admin

Verifique ou atualize o nível do WebSphere Application Server.
O Jazz Team Server requer o WebSphere Application Server Versão 6.1 com a Correção Acumulativa IBM Java SDK 1.5 SR5 ou posterior aplicada. 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.
Atualize os argumentos da JVM.
O Jazz Team Server precisa de algumas configurações específicas na Java Virtual Machine na qual é executado.

Primeiro, é necessário saber onde localizar os arquivos de configuração para o servidor e para log4j, a estrutura de criação de log utilizada pelo servidor. Isto é feito através da configuração das propriedades do sistema com.ibm.team.server.configURL e log4j.configuration. Estas propriedades utilizam uma URL ao invés de um caminho simples, portanto, o valor deve ser especificado como file://-style URL.

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 equipe típica de tamanho médio pode utilizar um valor de -Xmx1000M, fornecendo 1000 MB de memória heap para o processo do Jazz Team Server.

Se você estiver se conectando a um banco de dados Oracle, então você precisa incluir uma propriedade denominada "ORACLE_JDBC". Configure a propriedade para o caminho absoluto do arquivo (não uma URL) para os drivers JDBC Oracle.

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: com.ibm.team.repository.provision.profile Valor: file:///JazzInstallDir/server/provision_profiles (como a URL do arquivo)
    Nota: A propriedade com.ibm.team.repository.provision.profile precisa apontar para o diretório contendo o provision_profiles.
  - Nome: com.ibm.team.server.configURL Valor: file:///JazzInstallDir/server/teamserver.properties (como a URL do arquivo)
  - Nome: log4j.configuration Valor: file:///JazzInstallDir/server/log4j.properties (como a URL do arquivo)
  - Nome: java.awt.headless Valor: true
  - Nome: org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin Valor: true
11. 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.
- 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.

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