Instalando o IBM Rational Team Concert Express Edition Utilizando o IBM Installation Manager
Instalando o Rational Team Concert Express Edition
Fazendo Upgrade para o Rational Team Concert 2.0
Geralmente, é possível fazer upgrade dos clientes e servidores Rational Team Concert
executando uma instalação de zip ou do IBM Installation Manager.
Nota:
Se você usar o IBM Installation
Manager para instalar o Rational Team Concert 2.0
em um computador no qual o Rational Team Concert
não está atualmente instalado, o Installation Manager solicitará que você selecione
os idiomas a instalar. Entretanto, se você atualizar de uma versão anterior
para a 2.0, o IBM Installation Manager assumirá que você deseja usar os idiomas atuais e não
solicitará que você selecione idiomas. Para selecionar os idiomas adicionais,
após atualizar para a 2.0, selecione
Modificar na
tela principal no IBM Installation Manager, em seguida, selecione a oferta. A tela a seguir mostra a lista de idiomas suportados. Selecione os necessários.
Se você iniciar o Jazz Team Server após atualizar
para a 2.0 e antes de selecionar Modificar para incluir
ou remover idiomas, deverá reconfigurar o servidor conforme a seguir:
- Em um navegador da Web, navegue para https://server-host:9443/jazz/admin.action=com.ibm.team.repository.admin.serverReset.
- Clique em Solicitar Reconfiguração do Servidor.
- Encerre o servidor.
Em seguida, você pode selecionar Modificar no IBM Installation Manager para incluir
ou remover idiomas.
Fazendo Upgrade de um Cliente Rational Team Concert
para Eclipse IDE
Se você tiver as versões 1.0, 1.0.1 ou 1.0.1.1
do Cliente para Eclipse IDE, é necessário que obtenha o
cliente 2.0 para conectar-se ao seu novo servidor versão 2.0. É possível instalar
isto usando um arquivo zip ou você pode atualizar suas instalações do IBM Installation Manager anteriores.
Instalando um Cliente Rational Team Concert
para Microsoft Visual Studio
IDE
Se você tiver a versão 1.0.1.1 do Cliente para Microsoft Visual Studio IDE,
é necessário que você obtenha o cliente 2.0 para conectar-se ao seu novo
servidor versão 2.0.
Lembre-se:
Um arquivo .zip não é fornecido
para o Cliente para Microsoft Visual Studio. Para instalar ou fazer upgrade
para a versão 2.0, é necessário usar o IBM Installation Manager.
Atualizando um Servidor a partir de um Release Experimental ou de
Acesso Antecipado para um Release Permanente
Se você estiver executando um release Early Access
do Rational Team Concert,
primeiro faça upgrade para o release Trial 2.0.
A partir do release Trial 2.0,
é possível tornar seu servidor Permanente adquirindo e instalando o
Server Activation Kit para sua edição, que está disponível aqui: http://www.ibm.com/software/awdtools/rtc/. O kit de ativação consiste em um arquivo JAR contendo a chave do servidor
Permanente. Ele é instalado utilizando a página de Gerenciamento de Chaves de Licença
de sua interface administrativa da Web.
Fazendo Upgrade de um Servidor a partir de 1.0, 1.0.1 ou 1.0.1.1
É possível
fazer upgrade diretamente para o release 2.0 do Rational Team Concert a partir de releases anteriores. Uma migração de banco de dados é necessária para atualizações de 1.x para
2.x.
Nota:
Antes de iniciar o upgrade de um WebSphere Application Server, reconfigure o
servidor navegando para https://servername:9443/jazz/admin#action=com.ibm.team.repository.admin.serverReset e
clicando em Solicitar Reconfiguração do Servidor.
Se
você instalou o release anterior a partir de um arquivo zip, não há
interseção com a instalação anterior. É possível instalar o release 2.0
a partir de um zip em um novo local ou você pode usar o IBM Installation Manager para instalar uma instância de 2.0.
Se você usou o IBM Installation Manager para instalar o release anterior, poderá instalar a 2.0
como uma instância separada ou atualizar a instância anterior para 2.0. Se
você instalar uma instância separada do servidor para o release 2.0,
selecione Criar um Novo Grupo de Pacotes na página
Instalar Pacotes do assistente de instalação.
Nota:
Para fazer upgrade
de uma implementação do WebSphere Application
Server do Jazz Team Server,
remova o arquivo jazz.war anterior e implemente o arquivo jazz.war 2.0.
Para concluir o upgrade, consulte Copiando os Arquivos de Configuração Necessários
a partir de uma Instalação de Servidor Anterior e Instalando as Chaves de Ativação 2.0.
Fazendo Upgrade de um Servidor de uma Edição do Rational Team Concert
para Outra
É possível atualizar entre edições do Rational Team Concert.
Geralmente os upgrades incluem mover de Express-C para Express ou de Express para
Standard. Você também pode fazer downgrade na direção oposta, seguindo o
mesmo processo.
Como todas as edições do Rational Team Concert 2.0
suportam bancos de dados Derby, não é necessário migrar do
Derby para o DB2 ou Oracle se você
estiver movendo de Express-C para Express ou
Standard. Recomendamos
que você migre sua edição do servidor primeiro, certifique-se de que as coisas funcionem sem problemas
com o banco de dados existente e, em seguida, execute uma migração do banco de dados, se necessário.
Para obter informações sobre como executar
uma migração de banco de dados, consulte Migrando o Repositório Jazz após o Upgrade de Jazz Team
Server.
Se
você tiver instalado uma edição do Rational Team Concert 2.0
e desejar fazer upgrade para outra, faça download e instale a nova
edição, ao lado da edição existente e, em seguida, copie os arquivos de
configuração necessários para executar a nova edição. A seção abaixo descreve os arquivos de configuração
necessários.
Se você instalou a edição anterior a partir de um arquivo
zip, não existe nenhuma interseção com a instalação anterior. É possível instalar a nova edição a partir de um
zip em um novo local ou você pode usar a instalação do IBM Installation Manager para a nova
edição. Recomendamos que o IBM Installation Manager seja usado para servidores de produção para possibilitar que futuras atualizações
sejam aplicadas.
Se você usou o IBM Installation Manager para executar sua instalação de servidor anterior e desejar usar o IBM Installation Manager para instalar
sua nova edição, durante a nova instalação do Installation Manager, não
sobreponha a edição anterior. Na página Instalar
Pacotes do assistente de instalação, selecione Criar
um Novo Grupo de Pacotes.
Isso instalará a nova edição
em um local diferente e criará atalhos de programa utilizando o novo nome do
grupo de pacotes.
Se você não executar essa tarefa, a instalação falhará
com uma colisão de arquivos. Isso ocorre se você vir um diálogo de erro intitulado Instalação
Falhou e os detalhes mostram o seguinte texto:
A Instalação falhou.
Erro durante a fase de "instalação":
Falha ao extrair zip padrão 1.0.1.I20081018-1820. Arquivo
D:\JazzTeamServer\server\license-update-site\site.xml já existe.
Se isso ocorre, ele não é fatal; é possível reiniciar a instalação
e criar corretamente um novo grupo de pacotes.
Atualizações de Configuração do WebSphere Application
Server
As etapas a seguir são necessárias
para configurar corretamente o WebSphere Application
Server no Rational Team Concert 2.0.
- Assegure-se de que os fix packs mais recentes para WAS e WASDK estejam instalados.
Se estiver implementando no WAS 7.0, é crítico que pelo menos o WebSphere Application Server 7.0.0.3 esteja
instalado.
- Remova as propriedades JVM customizadas antigas:
- com.ibm.team.repository.provision.profile
- com.ibm.team.server.configURL
- log4j.configuration
- Inclua a nova propriedade JVM customizada JAZZ_HOME e
configure o valor para:
file:///<Dir_de_Instalação_do_Jazz>/server/conf
- 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".
Copiando os Arquivos de Configuração Necessários
a partir de uma Instalação de Servidor Anterior
Copie os seguintes arquivos do
servidor de origem para o servidor de destino. Primeiro, renomeie os arquivos originais na
instalação do servidor atualizado para criar backups. Se
você usou o IBM Installation
Manager para atualizar de 1.0, 1.0.1 ou 1.0.1.1 para 2.0, um diretório de backup
contendo seus arquivos de configuração 1.0.x foi criado com um nome,
tal como backup-config-timestamp no
subdiretório do servidor do local da instalação.
Se você estiver fazendo upgrade para a edição Standard ou Enterprise e
adquiriu o Developer Client Activation Kit para Express, adquira e instale
o Developer Client Activation Kit para Standard ou Enterprise Editions,
para que você possa usar as licenças do cliente. Suas designações de licença do Developer ainda estarão em vigor, mas
as licenças do Developer serão desativadas até que o kit de ativação correto
seja instalado.
Instalando as Chaves de Ativação 2.0
O release 2.0 usa as chaves de ativação 2.0. Se um
servidor for atualizado de 1.0.x.x para 2.0, ele será revertido para uma licença para teste
após o upgrade e você precisará obter as chaves de ativação 2.0
a partir do Passport Advantage.
Abaixo estão os nomes das chaves aplicáveis para cada kit:
- IBM Rational Team Concert Express Edition - Server License
Activation Kit V2.0 Multiplatform (jazz_team_server_express_release.jar)
- IBM Rational Team Concert Express Edition - Developer Client
License Activation Kit V2.0 Multiplatform (rtc_express_developer_unlocked.jar)
- IBM Rational Team Concert -
Contributor Client License Activation Kit V2.0 Multiplatform (rtc_all_contributor_unlocked.jar)
- IBM Rational Team Concert Standard
Edition - Server License Activation Kit V2.0 Multiplatform (jazz_team_server_standard_release.jar )
- IBMRational Team Concert Developer
Client License Activation Kit V2.0 Multiplatform (rtc_standard_developer_unlocked.jar)
- IBM Rational Team Concert Floating
Developer Client License Activation Kit V2.0 Multiplatform (rtc_standard_floating_developer_unlocked.jar)
- IBM Rational Team Concert -
Floating Contributor Client License Activation Kit V2.0 Multiplatform
(rtc_standard_floating-developer_unlocked.jar)
- IBMRational Team Concert Enterprise
Edition - Server License Activation Kit V2.0 Multiplatform (jazz_team_server_enterprise_release.jar )
Configurando uma Linha de Tempo do Projeto
No Rational Team Concert 1.x,
os projetos podiam ter múltiplas linhas de tempo (anteriormente chamadas de "linhas
de desenvolvimento") e todas essas linhas de tempo eram consideradas iguais.
No Rational Team Concert 2.0,
os projetos ainda podem ter múltiplas linhas de tempo, mas uma delas pode ser
marcada como a "linha de tempo do projeto". Ao migrar seu banco de dados para
2.0, a linha de tempo primária do projeto não é conhecida, portanto, seus projetos
não terão uma linha de tempo de projeto configurada. Você pode atualizar manualmente seus
projetos para configurar a linha de tempo do projeto, após seu upgrade para 2.0
Configurando a Captura Instantânea do Controle de Origem
A
captura instantânea de Source Control Management (SCM) para o Data Warehouse coleta
dados nos fluxos, incluindo informações sobre o tamanho dos fluxos e
a atividade (conjunto de mudanças e mudanças de arquivo/pasta) dentro dele. Na versão
1.0, esta captura instantânea coletava automaticamente informações sobre todos os fluxos.
Como esta pode ser uma operação dispendiosa, na versão 2.0, as opções de
configuração são incluídas na captura instantânea do SCM para permitir que os usuários decidam
para quais fluxos os dados devem ser coletados. O impacto imediato desta
mudança é que, a menos que você a configure, nenhum dado será coletado.
Para
configurar a captura instantânea do SCM:
- É necessário ter permissões de gravação para o fluxo para o qual você
deseja coletar dados.
- Vá para a página Relatórios na UI da Web.
- No painel de navegação esquerdo, selecione Administrar
Captura Instantânea do SCM. Uma lista de fluxos é exibida.
- Selecione a caixa de opção para um ou mais fluxos e, em seguida, selecione Salvar
Mudanças.
Os dados serão coletados para os fluxos selecionados em todas as capturas instantâneas subsequentes.
Mudanças Incompatíveis nos Relatórios do BIRT
Se
você tiver usado o designer de relatório do BIRT para criar seus próprios modelos de relatório, poderá encontrar um ou mais problemas ao tentar usar estes relatórios
na versão 2.0. Você deve estar ciente dos seguintes problemas:
- Mudanças na ordem em que as classes Java e JavaScript são
resolvidas. Se você tiver gravado o código JavaScript em seu relatório BIRT
que usa a instrução importPackage() para importar
o pacote java.lang, esteja ciente que referências
não-qualificadas ao Objeto no código, que costumavam referir-se à classe
Java, podem agora referir-se à classe JavaScript (e como resultado não
funcionarão corretamente). Outras classes que são nomeadas de maneira idêntica entre
JavaScript e Java, como java.util.Date, podem
ter o mesmo problema. A solução é qualificar totalmente sua referência
à classe Java e remover a instrução importPackage().
- Mudanças no processamento dos conjuntos de dados. No passado, o simples
ato de ligar um elemento (tal como um Rótulo) a um conjunto de dados, fazia com
que o conjunto de dados fosse processado em sua totalidade quando o elemento era
renderizado. Isto era conveniente porque significava que alguém poderia impingir uma ordenação
no processamento do conjunto de dados usando (ocultos) rótulos ligados aos conjuntos
de dados na ordem em que eles deveriam ser processados. Agora, uma ligação desse tipo
processará somente a primeira linha do conjunto de dados. Para obter o comportamento anterior,
use um elemento de Texto Dinâmico e invoque algum código JavaScript que
forçará o processamento do conjunto de dados inteiro. Total.count() é
uma boa opção.
- Os erros do designer de relatório do BIRT podem causar perda de dados. Estes problemas
aparecem quando você abre um arquivo de design do relatório do BIRT criado no BIRT 2.2.2
(ou seja, RTC 1.0) com o designer de relatório do BIRT 2.3.2 (ou seja, RTC 2.0).
Os problemas a seguir foram observados:
- Ao editar um conjunto de dados pela primeira vez com o BIRT 2.3.2,
na página "Parâmetros", os campos "Valor-padrão" e "Parâmetro do Relatório"
podem ser perdidos. A solução alternativa é reinserir os valores ou
copiar e colar os valores de uma versão anterior do editor. Após
salvar o arquivo com os novos valores inseridos, o problema não
se repetirá.
- Ao editar um arquivo de design de relatório pela primeira vez com o BIRT
2.3.2, o valor-padrão para os parâmetros do relatório pode ser perdido. Isto
também pode ocorrer após o problema anterior descrito. A solução alternativa é reinserir os valores ou copiar e colar os valores de uma versão anterior do editor. Após
salvar o arquivo com os novos valores inseridos, o problema não
se repetirá.
Estes problemas podem ser muito sérios se não observados, pois os dados reunidos pelo relatório poderão estar incorretos. É uma boa prática
verificar cada conjunto de dados e cada parâmetro de relatório ao editar um relatório
pela primeira vez com o designer de relatório do BIRT 2.3.2. Estes problemas
não ocorrem para novos relatórios que são criados com as ferramentas do
BIRT 2.3.2.
As mudanças acima são feitas em todos os relatórios prontos para utilização do Rational Team Concert 2.0 - nenhuma
ação é necessária. Entretanto,
se você tiver criado manualmente modelos de relatórios em sua área do projeto
usando nossos relatórios prontos para utilização e não tiver especificado um identificador
apropriado (consistente com o uso), seu modelo de relatório não será
atualizado quando for migrado. Ou seja, o conteúdo estará
desatualizado e não funcionará. Nesse caso, você deve fazer upload do novo
conteúdo para os modelos afetados, usando o arquivo .rptdesign padrão apropriado.
Importação dos Dados dos Itens de Trabalho no Armazém de Dados
No Rational Team Concert 2.0,
há várias mudanças de esquema nas tabelas de item de trabalho no armazém de
dados. Como consequência, ao migrar de 1.0 para 2.0, o importador
ignorará quaisquer dados de itens de trabalho no armazém. Como resultado, quando você
iniciar o servidor 2.0 pela primeira vez, seus relatórios de itens de trabalho poderão
não funcionar corretamente. A solução alternativa é aguardar a captura instantânea
dos itens de trabalho ser executada pela primeira vez ou fazer com que ela seja
executada manualmente após você iniciar o servidor. Na primeira execução após a migração,
a captura instantânea dos itens de trabalho reconstituirá as informações de itens de trabalho
de histórico inteiras no armazém de dados. Isto também significa que a
primeira execução da captura instantânea após a migração provavelmente demorará mais
tempo que uma execução média à noite.
Descobrindo Novos Relatórios
No Rational Team Concert 2.0, vários novos relatórios são incluídos. Embora estes relatórios aparecem nos novos
modelos de processos que são fornecidos com o produto, eles não são incluídos
automaticamente nas áreas do projeto existentes na migração. Nós incluímos uma
nova ação que o ajudará a descobrir e implementar estes novos modelos de
relatórios em suas áreas do projeto existentes após a migração. Para implementar
novos modelos de relatórios:
- No rich client, abra a visualização Artefatos da Equipe.
- Expanda sua área do projeto, expanda Relatórios.
- Clique com o botão direito do mouse em Modelos de Relatório e selecione Implementar
Novos Modelos.
O diálogo o ajudará a descobrir quaisquer modelos de relatório que estão disponíveis mas ainda não foram implementados em sua área do projeto.
Você pode selecionar um ou mais deles e eles serão criados. Após a
criação, é possível criar novos relatórios a partir dos modelos usando as
ações de menu disponíveis.
Customizações
As mudanças que você fez nos
tipos de item de trabalho, atributos, fluxos de trabalho, funções e manipuladores de eventos
são preservadas quando você faz upgrade de 1.x para 2.0. Se você customizou
um modelo de processo predefinido (tal como Scrum), esteja ciente que, se você
reimplementar o modelo predefinido (na visualização Modelos de Processo),
sobrescreverá suas customizações. Se você precisar reimplementar o
modelo predefinido, deverá primeiro alterar o nome e ID do
modelo predefinido que você customizou, de forma que ele não
será sobrescrito.
Visão Geral da Instalação Express Edition
O pacote de instalação inclui tudo o que você precisa para começar.
A configuração padrão inclui estes itens:
- As versões suportadas de um JDK
(Java Development
Kit) para Windows
e Linux.
- Uma imagem em construção do servidor de aplicativos da Web do Apache Tomcat que contém o aplicativo da
Web do Jazz.
- Um banco de dados Derby e todas as bibliotecas de banco de dados necessárias.
Importante:
Utilizar o
Jazz Team
Server
com um banco de dados Derby suporta até 10 usuários. Para suportar mais de 10 usuários, use um banco de dados DB2 Workgroup Server, DB2 ou Oracle. O DB2 Workgroup Server é fornecido com os pacotes de instalação Enterprise, Standard e Express Edition quando você usa o IBM Installation Manager. Se você usar o método de instalação do arquivo .zip, o download do DB2 Workgroup Server estará disponível no mesmo site que o download do Rational Team Concert. Após o DB2 Workgroup Server ser instalado, você deverá instalar e configurá-lo conforme descrito no guia de configuração da instalação.
Nota:
Uma
planilha
de planejamento opcional está disponível na ajuda on-line para ajudá-lo a escolher sua configuração e
registrar suas decisões.
Preparando-se para Instalar a Express Edition
Antes de instalar o servidor, verifique se as considerações especiais são atendidas.
Instruções Especiais para
Linux
Revise as seguintes instruções especiais quando
o Jazz Team
Server
está instalado no Linux.
Instalando a Express Edition a partir do
IBM Installation Manager
Após obter os arquivos de instalação, inicie a instalação.
O
Jazz Team
Server,
o cliente do
Rational Team Concert,o
Build
System Toolkit,
o
ClearCase Connector,
o
ClearQuest Connector
e outros arquivos incubadores podem ser transferidos por download
do http://jazz.net. Para comprar o
Rational Team Concert,
vá para o endereço
http://www.ibm.com/software/awdtools/rtc/, onde você
pode fazer download de uma imagem instalável ou solicitar um DVD.
- Faça download de um dos seguintes pacotes de instalação.
Há dois métodos para instalar o
Rational Team Concert
Express Edition utilizando o
IBM Installation Manager.
- Inicie o programa da barra de ativação.
Se o Installation Manager não estiver em execução, inicie-o.
Nota:
Você deve ter privilégios de administrador para executar o programa da barra de ativação.
- Se você estiver utilizando a instalação via Web do Installation Manager, execute o arquivo
executável. Os arquivos são extraídos em um diretório e um programa de barra de ativação é exibido.
- Se você estiver utilizando o arquivo .zip Conteúdo do DVD Completo, extraia os conteúdos do
archive em um diretório temporário e execute o programa da barra de ativação.
- Para executar o arquivo no Windows, execute este comando:
launchpad.exe
- Para executar o arquivo no Linux, execute este comando:
sh launchpad.sh
-
Quando o programa da barra de ativação inicia, você visualiza uma lista de itens para instalar. Instale
cada pacote que deseja utilizar na ordem listada.
- Instale o Jazz Team
Server.
Ao utilizar o IBM Installation Manager, anote o Diretório de Instalação na
página Local durante o processo de instalação.
O diretório é mencionado como o
JazzInstallDir.
Nota:
Se você estiver planejando utilizar um servidor de aplicativos
existente, ao invés do servidor Apache Tomcat incluído, desmarque a caixa de opção do pacote Apache Tomcat.
Fazer isto instala apenas os arquivos necessário para utilização com seu servidor de aplicativos existente. O
Installation Manager solicita que você escolha um local para instalar estes arquivos.
- Opcional: Instale o DB2 Workgroup
Server.
Nota:
Embora um banco de dados Derby esteja incluído na configuração padrão e não requeira instalação, este banco
de dados não pode suportar mais de 10 usuários. Se você desejar suportar mais de 10 usuários e não tiver acesso a um banco de dados DB2 ou Oracle existente, instale o DB2 Workgroup Server Edition incluído no pacote configurável.
Se você instalar o DB2 Workgroup Server, registre o ID do usuário, a senha e o número da porta. Estas informações serão
necessárias posteriormente. Aceitar os padrões durante a instalação simplifica a configuração do
Jazz Team
Server.
- Instale o ClienteRational Team Concert.
- Opcional: Instale o Build
System Toolkit.
Configurando o Banco de Dados
Após seu banco de dados ser instalado, o trabalho de configuração é necessário.
Atalho:
Se você estiver utilizando o banco de dados Derby incluído, nenhuma configuração
adicional é necessária. Continue com
Iniciando o Servidor.
As etapas de visão geral para configuração de um banco de dados são:
- Criar um banco de dados.
- Configurar os arquivos de propriedades.
- Criar as tabelas de banco de dados.
Se você estiver usando qualquer edição do DB2 suportada,
continue com Configurando um Banco de Dados DB2.
Se você estiver utilizando o Oracle, continue com
Configurando um Banco de Dados Oracle.
Se você estiver usando SQL Server, continue com Configurando um Banco de Dados do SQL Server.
Configurando um Banco de Dados DB2
Configure o banco de dados DB2 suportado ou o banco de dados DB2 Workgroup
Server incluído no pacote configurável para trabalhar com o Jazz Team
Server.
Este procedimento assume que os seguintes pré-requisitos foram atendidos.
Consulte sua documentação do DB2 ou um DBA (Administrador de Banco de Dados DB2) para obter ajuda.
Para configurar um banco de dados DB2:
- Crie o banco de dados na Janela de Comandos do DB2. Os comandos de exemplo criam um novo banco de dados denominado JAZZ. Estes comandos são executados
na Janela de Comandos do DB2. A Janela de Comandos pode ser aberta a partir do menu Inicial do aplicativo sob
o menu do DB2 Command Line Tools.
Nota:
Para garantir a manipulação
adequada do conteúdo Unicode, o conjunto de caracteres de banco de dados deve ter a codificação UTF-8. Como a tabela
AUDITABLE_LINKS não se ajusta no tamanho da página padrão de 4 K no Windows, configure
o tamanho da página para pelo menos 8 K.
Dica:
Se o banco de dados não estiver em execução, o comando db2start inicia o
DB2.
- Localize o arquivo teamserver.properties no
diretório JazzInstallDir/server/conf/jazz e
renomeie-o para teamserver.derby.properties.
- Localize o arquivo teamserver.db2.properties no
diretório JazzInstallDir/server/conf/jazz e
renomeie-o para teamserver.properties.
- Especifique os detalhes do banco de dados e da conexão no arquivo teamserver.properties.
A especificação da conexão padrão conecta-se a um banco de dados DB2 que é executado em um host local na
porta 50000. No Windows, o banco de dados é denominado JAZZ e tanto o nome de usuário
como a senha são db2admin. Se os valores padrão foram utilizados
ao configurar seu banco de dados, o arquivo teamserver.properties já deve estar configurado corretamente. Se
não, altere estas informações para corresponder sua configuração.
- Abra o arquivo teamserver.properties em um editor de texto.
- Localize as linhas a seguir:
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
- Edite o valor de com.ibm.team.repository.db.jdbc.location para seu servidor e banco
de dados DB2.
Dica:
Na Janela de
Comandos do DB2, execute o comando db2 get dbm cfg, em seguida, localize a linha que
contém SVCENAME, que indica o nome ou o número da porta do DB2. Se este comando exibir um número, utilize-o
como o número da porta (no lugar de 50000 no exemplo acima). Se o comando retornar um nome não-numérico,
determine qual número de porta foi designado por este nome e utilize tal número de porta. No Linux, o arquivo
/etc/services contém o mapeamento entre nomes e números de porta, e no Windows, o
arquivo C:\windows\system32\drivers\etc\services contém o mapeamento. Para obter
informações adicionais, entre em contato com seu administrador de banco de dados ou consulte a documentação
do banco de dados.
- Edite o valor de com.ibm.team.repository.db.jdbc.location para o seu nome de
usuário do DB2.
Nota:
O DB2 É importante que o usuário tenha autoridade para criar tabelas, espaços de tabela e modificar a configuração do banco de dados. Os usuários do DB2
são criados pelo sistema operacional.
- Especifique a senha do usuário na propriedade com.ibm.team.repository.db.jdbc.password.
Nota:
Não altere o texto password={password} na propriedade com.ibm.team.repository.db.jdbc.location.
- Se necessário, altere a propriedade com.ibm.team.repository.db.db2.content.tablespace.location
para um caminho em seu Jazz Team
Server onde o espaço de tabela principal pode ser criado.
Nota:
Se este valor não for alterado do padrão de content_tablespace, o espaço de tabela será
criado sob o local de armazenamento do banco de dados. No Windows, se um novo caminho for especificado, ele
deve ser especificado utilizando barras duplas invertidas, por exemplo:
com.ibm.team.repository.db.db2.content.tablespace.location=c:\\db2\\jazz\\content_tablespace.
Você concluiu a configuração do seu banco de dados. Continue com Criando as Tabelas de Banco de Dados Jazz Team
Server
no DB2 e Oracle.
Configurando um Banco de Dados Oracle
Configure um banco de dados Oracle para funcionar com o
Jazz Team
Server.
Isto assume que os seguintes pré-requisitos foram atendidos. Consulte sua documentação do Oracle ou
um DBA (administrador de banco de dados Oracle) para obter ajuda.
- O Oracle é instalado em uma máquina para ser utilizado com o servidor de banco de dados.
Esta máquina pode ser uma máquina diferente daquela que o
Jazz Team
Server
executa.
- Um banco de dados padrão existe no servidor Oracle.
Dica:
Quando você instala o Oracle, tem a opção de
criar um banco de dados automaticamente.
Importante:
Para garantir a manipulação adequada do conteúdo
Unicode, o conjunto de caracteres de banco de dados deve ter a codificação UTF-8.
- O usuário que realiza estas instruções possui autoridade de administração do sistema no banco de dados
Oracle.
Ao executar o
Jazz Team
Server
no Oracle, crie um espaço de tabela Oracle para aprimorar o desempenho. Você deve criar um usuário vinculado
a este espaço de tabela.
Lembre-se:
Nenhuma dessas etapas é realizada por um criador do banco de dados com as
ferramentas do repositório.
Para configurar um banco de dados Oracle:
-
Crie um espaço de tabela. O local do espaço de tabela deve ser apropriado para a máquina e a unidade de disco.
Nota:
O espaço de tabela pode ter uma destas propriedades:
- Um nome diferente de oracle_tbs
- Um local em outro diretório
- Um tamanho maior do que 1 GB. Para instalações maiores, você precisa alocar mais espaço.
O exemplo abaixo mostra uma instrução create executada em uma máquina
Windows:
CREATE BIGFILE TABLESPACE oracle_tbs DATAFILE 'D:\oracle_tbs\oracle_tbs.dbf' SIZE 1G AUTOEXTEND ON
EXTENT MANAGEMENT LOCAL AUTOALLOCATE
Importante:
O caminho do diretório (neste exemplo D:\oracle_tbs) deve existir. Não é
necessário criar um espaço de tabela especial separado. Você pode utilizar o espaço de tabela
USERS padrão do Oracle, mas o Oracle tem um desempenho melhor com um espaço previamente
alocado no disco que ele gerencia.
- Crie um usuário Oracle.
Após o espaço de tabela ser criado, um usuário especial Oracle deve ser criado para o
Jazz utilizar o banco de dados
Oracle.
Neste exemplo, o usuário tem o nome jazzDBuser e a senha (IDENTIFIED
BY nos termos do Oracle) jazzDBpswd e existe no espaço de tabela criado no
1.
CREATE USER jazzDBuser IDENTIFIED BY jazzDBpswd DEFAULT TABLESPACE oracle_tbs
Depois do usuário ser criado, ele deve receber as permissões necessárias para inicializar
o banco de dados do Jazz. Os seguintes comandos SQL podem ser usados
para conceder as permissões adequadas:
GRANT CREATE SESSION TO jazzDBuser;
GRANT CREATE TABLE, ALTER ANY TABLE, DROP ANY TABLE, CREATE ANY INDEX, ALTER ANY INDEX, DROP ANY INDEX TO jazzDBuser;
GRANT INSERT ANY TABLE, UPDATE ANY TABLE, DELETE ANY TABLE TO jazzDBuser;
GRANT CREATE PROCEDURE TO jazzDBuser;
GRANT CREATE VIEW TO jazzDBuser;
- Localize o arquivo teamserver.properties no
diretório JazzInstallDir/server/conf/jazz e
renomeie-o para teamserver.OtherDBProvider.properties.
- Localize o arquivo teamserver.oracle.properties no
diretório JazzInstallDir/server/conf/jazz e
renomeie-o para teamserver.properties.
Dica:
Renomear o arquivo original teamserver.properties
possibilita restaurar o arquivo para a versão de trabalho anterior. Por padrão,
o Provedor do BD é derby.
- Configurar o servidor
- Edite o arquivo de configuração do servidor se você usou um nome de usuário,
senha, ou nome de BD diferente, instalou o servidor Oracle em uma máquina
diferente de Jazz Team Server
ou está usando uma porta diferente da padrão. Abra o arquivo teamserver.properties no diretório JazzInstallDir/server/conf/jazz
e altere as informações listadas abaixo para corresponderem a sua configuração.
com.ibm.team.repository.db.vendor = ORACLE
com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@localhost:1521/ORCL
Altere
jazzDBuser com o usuário criado para o Jazz para
usar o banco de dados Oracle. Se você estiver usando o host local, remova o comentário desta
linha removendo # do início da linha e comente a
próxima linha local. As cadeias de conexão do host local não devem incluir
// precedente. Altere 1521 com sua porta TCIP da máquina servidor
Oracle. Altere ORCL com seu nome do banco de dados Oracle.
com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@//oracleserver.example.com:1521/ORCL
Se
você estiver usando uma conexão não de host local, remova o comentário desta linha removendo
o # do início da linha e comente a linha local
anterior. As cadeias de conexão não de host local devem incluir
// precedente.
com.ibm.team.repository.db.jdbc.password=jazzDBpswd
Altere
jazzDBpswd com a senha do usuário criado para o Jazz para
usar o banco de dados Oracle.
Importante:
Não altere o texto {password}
na propriedade com.ibm.team.repository.db.jdbc.location.
A senha de usuário deve ser especificada na propriedade com.ibm.team.repository.db.jdbc.password.
Se
você estiver usando o Oracle Express, use 1521 para a porta TCIP e XE para o nome do banco
de dados Oracle:
com.ibm.team.repository.db.vendor = ORACLE
com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@localhost:1521/XE
com.ibm.team.repository.db.jdbc.password=jazzDBpswd
-
No mesmo diretório que o dos scripts de servidor
JazzInstallDir/server),
crie um diretório denominado oracle.
- Localize o arquivo JAR do driver JDBC Oracle, denominado ojdbc14.jar.
O local pode variar dependendo do produto Oracle e do sistema operacional.
Copie este arquivo no diretório denominado oracle.
Nota:
Se você estiver utilizando o
WebSphere Application
Server, configure uma propriedade denominada "ORACLE_JDBC"; a seguir, configure-a como o caminho absoluto do
arquivo (não a URL) para os drivers JDBC Oracle. Esta tarefa é descrita nas instruções de configuração do
WebSphere Application
Server. Faça uma anotação do caminho de arquivo para utilização posterior nestas instruções.
Você concluiu a configuração do seu banco de dados e pode continuar com os
Criando as Tabelas de Banco de Dados Jazz Team
Server
no DB2 e Oracle.
Configurando um Banco de Dados do SQL Server
Configure um banco de dados do SQL Server para funcionar com o Jazz Team Server.
Este procedimento assume que os seguintes pré-requisitos foram atendidos:
- Você tem o SQL Server instalado
- O serviço do SQL Server está iniciado
- Você tem os drivers JDBC de SQL Server instalados. Para obter mais informações, consulte http://msdn2.microsoft.com/en-us/data/aa937724.aspx
- O protocolo TCP está ativado para o SQL Server
- O usuário que cria a tabela do BD deve ter uma das seguintes
permissões:
- Uma associação na função do servidor fixada por sysadmin ou propriedade
do banco de dados (dbo)
Lembre-se:
O nome de login padrão definido no arquivo JazzInstallDir/server/teamserver.properties
para um banco de dados SQL Server é jazzDBuser e
a senha padrão é jazzDBpswd. Esses valores são utilizados nas
etapas abaixo para criar um banco de dados. É possível substituir esses valores
pelo nome do usuário e senha para o seu banco de dados.
Configurando um Banco de Dados
Esta seção descreve
como configurar o banco de dados do SQL Server utilizando a ferramenta de linha de comandos sqlcmd,
fornecida com a instalação do SQL Server. Também é possível utilizar uma
ferramenta visual, como o SQL Server Studio Management, que também está disponível para a versão do Express
como SQL Server Studio Management Express. Consulte a documentação do SQL Server
ou um database administrator (DBA) do SQL Server, para obter informações adicionais.
Para
configurar um banco de dados do SQL Server utilizando a ferramenta de comando sqlcmd:
- Crie um banco de dados do Jazz Team Server.
A partir da ferramenta de linha de comandos, digite:
CREATE DATABASE jazz
IR
- Crie um usuário e senha e altere a propriedade do banco de dados do Jazz Team Server. A partir da ferramenta de linha de comandos, digite:
CREATE LOGIN jazzDBuser
WITH PASSWORD = 'jazzDBpswd';
USE jazz;
exec sp_changedbowner 'jazzDBuser'
IR
- Altere a intercalação do banco de dados do Jazz Team Server.
A partir da ferramenta de linha de comandos, digite:
ALTER DATABASE jazz COLLATE SQL_Latin1_General_CP437_CS_AS
IR
Configurando o Servidor
Lembre-se:
Por
padrão, o arquivo teamserver.properties no diretório JazzInstallDir/server/conf/jazz
não é configurado para conectar-se a um banco de dados SQL Server. Todas as configurações padrão, junto com configurações
específicas do SQL Server, estão contidas no arquivo teamserver.sqlserver.properties
no mesmo diretório.
Para configurar o servidor:
- Renomeie os seguintes arquivos:
- Renomeie o arquivo JazzInstallDir/server/conf/jazz/teamserver.properties
para teamserver.OtherDBProvider.properties
- Renomeie o arquivo teamserver.sqlserver.properties para teamserver.properties
Dica:
Renomear o arquivo original teamserver.properties
possibilita restaurar o arquivo para a versão de trabalho anterior. Por padrão,
o Provedor do BD é derby.
- Edite o arquivo de configuração do servidor se você usou um nome de usuário,
senha ou nome do BD diferente, instalou o servidor SQL em uma máquina diferente
de Jazz Team Server
ou estiver usando uma porta diferente da padrão. Abra o arquivo teamserver.properties no diretório JazzInstallDir/server/conf/jazz
e altere as informações listadas abaixo para corresponderem a sua configuração.
com.ibm.team.repository.db.vendor = SQLSERVER
com.ibm.team.repository.db.jdbc.location=//SQL SERVER MACHINE IP:SQL SERVER TCIP PORT;databaseName=JAZZ DATABASE NAME;user=JAZZ USERNAME;password={password}
com.ibm.team.repository.db.jdbc.password=JAZZ LOGIN PASSWORD
Importante:
Não altere o texto password={password} no repositório
com.ibm.team.repository.db.jdbc.location. A senha de usuário deve ser especificada na propriedade com.ibm.team.repository.db.jdbc.password.
Para especificar o local do arquivo jar para JDBC:
- No mesmo diretório dos scripts de servidor
(JazzInstallDir/server),
crie um diretório denominado sqlserver.
- Localize o arquivo JAR do driver JDBC do SQL Server, denominado sqljdbc.jar.
O local pode variar, dependendo de onde os drivers foram instalados, conforme indicado
na seção de pré-requisitos. Copie o arquivo no diretório
sqlserver recém-criado.
- Especifique o local do arquivo JAR para JDBC concluindo a
seguinte tarefa:
- Configure a variável de ambiente SQLSERVER_ABSPATH para
apontar para o diretório que contém o arquivo JAR. Se o caminho contiver
caracteres de espaço, você deverá incluí-los entre aspas.
Dica:
Se você utilizar o WebSphere Application
Server, configure uma propriedade denominada SQLSERVER_JDBC; em seguida,
configure-a como o caminho absoluto do arquivo (não a URL) para o diretório de drivers JDBC
do SQL Server. Para obter informações adicionais, consulte as instruções de configuração do WebSphere Application
Server. Anote o caminho de arquivo para uso posterior nessas instruções.
Você concluiu a configuração do seu banco de dados. Agora, crie as tabelas de banco de dados do Jazz Team Server. Para obter informações adicionais, consulte
Criando as Tabelas de Banco de Dados Jazz Team
Server
no DB2 e Oracle.
Resolução de Problemas
Se o comando repotools não for
bem-sucedido, verifique o arquivo de log denominado repotools_createTables.log,
localizado no diretório JazzInstallDir/server.
Além disso,
verifique o seguinte:
- O SQL Server está configurado para permitir conexões utilizando o protocolo TCP/IP.
Se necessário, reinicie o serviço da SQL.
- O nome do host da máquina do SQL Server e a porta estão refletidos corretamente
no arquivo teamserver.properties.
- O nome de login, a senha e o nome do banco de dados estão refletidos corretamente
no arquivo teamserver.properties.
- Um firewall não evita que você acesse o SQL Server. Utilize um comando
telnet para efetuar telnet para a máquina utilizando o nome do host e a porta do arquivo teamserver.properties.
- O usuário criado possui permissões apropriadas no banco de dados do Jazz Team Server.
Nota:
O código do banco de dados para o Jazz Team Server foi
projetado para ser genérico e padrão a fim de ser executado em várias plataformas de bancos de dados;
entretanto, diferenças entre os fornecedores de bancos de dados corporativos existem na sintaxe,
nas estratégias de otimização e na semântica de bloqueio. O servidor foi testado
no SQL Server utilizando uma combinação de testes automatizados e simulações de
cargas de trabalho normais e testes de estresse. A simulação de cargas de trabalho normais
mostrou um desempenho aceitável. Em algumas instâncias foram observados conflitos de banco de dados
em testes de simultaneidade automatizados; no entanto, estes não foram reproduzidos
consistentemente no hardware do servidor diferente.
O servidor é projetado para prestar serviço a um grande número
de pedidos simultâneos. Em casos excepcionais, conflitos podem ocorrer no
banco de dados do repositório, já que objetos semelhantes ou iguais são atualizados
simultaneamente em transações associadas aos pedidos. Estes são eventos raros, mas normais.
O sistema é projetado para ser defensivo em relação a isto e a integridade de dados
é mantida; não há nenhuma perda de dados. Ocasionalmente, conflitos são registrados
por tarefas, como a execução do mecanismo de construção. Geralmente, a condição é detectada
e a tarefa é tentada repetida. O conflito pode resultar em uma construção com falha. Em casos
muito raros, ela pode ser uma ação do usuário, como trabalhar com itens de trabalho
ou código-fonte, que é interrompida para resolver um conflito. Nesse caso, a ação do usuário
falha e um erro com detalhes relativos a um conflito é exibido para o usuário.
O usuário pode então tentar novamente a ação.
Todos os conflitos encontrados são registrados no servidor
para fornecer informações sobre o que aconteceu quando o conflito
ocorreu. A entrada de log possui texto semelhante ao seguinte: com.ibm.team.repository.common.RetryableDatabaseException:
Falha de serialização.
Se o seu sistema encontrar conflitos,
consulte o log de erros, que está disponível no endereço https://servername:9443/jazz/service/com.ibm.team.repository.common.internal.IFeedService?category=SystemLog.
Se você encontrar exceções de conflito frequentes, entre em contato com o seu
suporte ao produto ou verifique os fóruns no jazz.net para obter as informações,
atualizações ou técnicas mitigantes mais recentes.
Criando as Tabelas de Banco de Dados Jazz Team
Server
no DB2 e Oracle
Crie as tabelas de banco de dados utilizando as ferramentas do repositório.
Para criar tabelas de banco de dados:
- Execute o comando repotools -createTables para criar tabelas de banco de dados para
um repositório do Jazz.
O arquivo repotools está localizado
no JazzInstallDir/server.
O comando utiliza as propriedades de configuração no teamserver.properties para as
configurações de conexão e tamanho. Por padrão, o comando é exibido no diretório atual. O parâmetro
teamserver.properties pode ser utilizado para fazer referência a um arquivo de
propriedades diferente.
Este comando cria o espaço de tabela e todas as tabelas
e índices necessários para um repositório
Jazz Team
Server
- Após as tabelas de banco de dados serem criadas, você deve parar e reiniciar o banco de dados para
certificar-se de que todas as mudanças estejam em efeito.
Dica:
Apenas DB2.
Comandos de exemplo que param e iniciam o
DB2 são
db2stop e db2start.
Estes comandos são executados na Janela de Comandos do
DB2. A Janela de Comandos pode
ser aberta a partir do menu iniciar aplicativos sob o menu em cascata
do DB2 Command Line Tools.
Você concluiu a configuração do seu banco de dados e pode continuar com os
Iniciando o Servidor.
Iniciando o Servidor
Este tópico descreve as diferentes opções para executar os scripts de inicialização do servidor.
Se você planeja utilizar o servidor de aplicativos Apache Tomcat incluído,
está pronto para iniciar o
Jazz Team
Server.
Se você planeja
utilizar o WebSphere
Application Server, configure seu ambiente de servidor conforme descrito no
Configurando um
WebSphere Application
Server.
Iniciando o Servidor Apache Tomcat
Agora você está pronto para iniciar o servidor Apache Tomcat.
O Apache Tomcat foi instalado no diretório
JazzInstallDir/server/tomcat.
O aplicativo da Web (jazz.war) foi instalado no diretório Apache Tomcat webapps. Em uma janela de comando, configure seu diretório atual como
JazzInstallDir/server. Os scripts de inicialização e encerramento do servidor estão localizados neste diretório.
- Se você desejar executar os scripts de inicialização e encerramento a partir de qualquer outro diretório, deverá alterar o arquivo profiles.ini em JazzInstallDir/server/conf/jazz/provision_profiles para usar um caminho absoluto.
- O Apache Tomcat está configurado para utilizar as portas 9080 e 9443 no arquivo
JazzInstallDir/server/tomcat/conf/server.xml.
Se necessário, altere-as conforme apropriado para o seu sistema. Se necessário, atualize também as definições
de configuração das portas HTTP do repositório do servidor Jazz na página de configuração Propriedades
Avançadas do Jazz Admin Web UI.
- O diretório JazzInstallDir/server/logs contém os arquivos de log do servidor. Se você tiver problemas ao iniciar o servidor, verifique os arquivos
de log.
- O arquivo JazzInstallDir/server/tomcat/conf/server.xml contém configurações de SSL que especificam um algoritmo disponível apenas no IBM JRE. Para executar o servidor com um Sun JRE, no arquivo server.xml, altere as configurações para Connector port="9443", de forma que sslProtocol="TLS" em vez de "SSL". Também remova o parâmetro do algoritmo.
Iniciando o Servidor no
Windows
Execute o arquivo de inicialização para iniciar seu servidor no
Windows.
- Para iniciar o servidor, a partir do diretório JazzInstallDir/server,
execute este comando:
server.startup.bat
Nota:
Uma janela separada do console do Apache Tomcat é aberta. Não feche esta janela ou o servidor parará de
funcionar. Além disso, diversas mensagens informativas são ativadas, incluindo uma mensagem sobre o Apache
Tomcat Native Library. Estas mensagens informativas não afetam a funcionalidade do
Jazz Team
Server.
- Para parar o servidor, a partir do diretório JazzInstallDir/server,
execute este comando:
server.shutdown.bat
Nota:
O exemplo acima executa os scripts de início e interrupção diretamente
do diretório
JazzInstallDir/server.
Se você instalou
o Jazz Team
Server
utilizando o IBM Installation
Manager, também pode executar os comandos a partir do menu Iniciar do
Jazz Team
Server
Windows.
Após
o servidor ser iniciado, continue com o Executando o Assistente de Configuração.
Iniciando o Servidor no
Linux
Execute o arquivo de inicialização para iniciar o servidor no
Linux.
- Para iniciar o servidor, a partir do diretório JazzInstallDir/server,
como usuário root, execute este comando:
./server.startup
Se o seu ID do usuário possuir acesso de
administrador, execute este comando:
sudo ./server.startup
Uma janela separada do console do Apache Tomcat não está visível. Você
pode verificar o progresso de inicialização do servidor visualizando o arquivo de log em JazzInstallDir/server/logs/jazz.log.
- Para parar o servidor, a partir do diretório JazzInstallDir/server,
como usuário root, execute este comando:
./server.shutdown
Se o seu ID do usuário possuir acesso de
administrador, execute este comando:
sudo ./server.shutdown
Nota:
Este exemplo executa os scripts de início e interrupção diretamente do
JazzInstallDir/server.
Se você instalou o
Jazz Team
Server
utilizando o IBM Installation
Manager, também pode executar os comandos a partir do menu Iniciar do aplicativo
Jazz Team
Server.
Após
o servidor ser iniciado, continue com o Executando o Assistente de Configuração.
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.
- 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.
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 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 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 Servidores -> Servidores de Aplicativos.
- Clique em server1.
- Clique em Gerenciamento Java e de Processos -> Definição do Processo.
- 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.
- 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
- Abra o console administrativo para o seu WebSphere Application Server.
- Clique em Aplicativos -> Instalar Novo Aplicativo.
- 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 Aplicativos -> Aplicativos Corporativos.
- 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.
Para obter
informações adicionais sobre este tópico, visite os seguintes links:
https://jazz.net/learn/LearnItem.jsp?href=content/tech-notes/jazz-team-server-1_0-was-setup/index.html
https://jazz.net/wiki/bin/view/Main/WASSetupFAQ
Executando o Assistente de Configuração
Executar o assistente de configuração verifica se o servidor está
operando adequadamente e o guia através das etapas para configurar o servidor.
Para verificar se o Jazz Team
Server está
se conectando ao banco de dados, consulte o log do servidor ou a saída do console. As informações de conexão
e do banco de dados são ecoadas em seu primeiro acesso.
O diretório JazzInstallDir/server/logs é usado para os arquivos de log do servidor.
Este procedimento assume que o seu servidor esteja disponível
utilizando o host local do nome do host e as portas padrão 9443. Se necessário, substitua o host local por seu nome
do host do servidor e substitua a porta 9443.
Inicie o assistente de configuração para configurar seu servidor. Utilize a URL https://localhost:9443/jazz/setup.
O nome de usuário e a senha padrão fazem distinção entre maiúsculas e minúsculas:
- O nome de usuário é ADMIN.
- A senha é ADMIN.
Se você configurou o contêiner de Web do diretório LDAP, efetue login com um
usuário JazzAdmin que é definido em seu diretório LDAP.
Escolha um caminho de configuração. O assistente de configuração tem dois caminhos principais.
- A Configuração Rápida de Caminho utiliza a configuração padrão. Se você desejar que o
servidor execute rapidamente, a configuração rápida do caminho é uma boa opção. Durante a Configuração
Rápida do Caminho, configure:
- A Configuração Customizada orienta-o através da configuração detalhada do servidor,
incluindo a habilidade de ativar notificações de e-mail. Durante a Configuração Customizada,
você configura os seguintes itens:
- Banco de Dados
- Notificação de e-mail
- Registro do usuário
Nota:
Por padrão, o servidor é configurado para utilizar Derby como o banco de dados.
Para utilizar um outro banco de dados, como o DB2, selecione o caminho de configuração customizado e
conclua a Etapa 2: Configurar Banco de Dados.
Quando a configuração inicial é concluída, opções adicionais podem ser configuradas a partir da interface
com o usuário do Jazz Team
Server Admin Web através da utilização da URL https://localhost:9443/jazz/admin.
Se o assistente de configuração do servidor não carregar, verifique os itens a seguir:
- Verifique se o servidor de aplicativos foi iniciado. Utilize a URL http://localhost:9080.
- Verifique se o Jazz Team
Server foi iniciado efetuando login no Jazz Team
Server Admin
Web UI utilizando a URL https://localhost:9443/jazz/admin. Se a
página não for carregada ou se o servidor tiver erros, o servidor não iniciou corretamente. Consulte as informações de resolução de problemas emResolução de Problemas do Servidor.
- A raiz da URI para o caminho do Jazz Team
Server
deve ser /jazz. Por exemplo, https://example.com:9443/jazz deve ser utilizado ao invés de https://example.com:9443.
Concluindo a Instalação
Após o servidor ser instalado, você deve considerar algumas opções de configuração antes de
continuar.
Após a instalação, há algumas poucas ações adicionais a tomar.
- Alguns arquivos contêm senhas. Estes arquivos devem ser protegidos para que eles possam ser lidos apenas
por usuários autorizados a saberem a senha para as contas.
- teamserver.properties - O Jazz Team
Server requer
que a senha do banco de dados seja armazenada em JazzInstallDir/server/conf/jazz/teamserver.properties.
Quando os arquivos de propriedades são salvos, o aplicativo sempre
faz uma cópia de backup da versão anterior no mesmo diretório. Se você desejar remover todos os arquivos que
contêm a senha de texto simples, remova os arquivos de propriedades de backup após configurar o servidor pela
primeira vez.
- Ao conectar-se ao servidor com o cliente do
Rational Team Concert
ou com um navegador da Web, você deve visualizar avisos do certificado de segurança.
Para desativar o aviso, consulte
Definindo
as Configurações do Certificado de Segurança.
- Se você configurou o servidor de aplicativos para utilizar portas que não as padrão, estas portas também
devem ser configuradas na configuração do Jazz.
Estes números de portas são utilizados para compor URLs para coisas como links de feed e links de item em
notificações de e-mail. Para atualizar os padrões, utilize a página de configuração das propriedades
avançadas do Admin Web UI para modificar as propriedades a seguir:
- com.ibm.team.repository.servlet.internal.ServletConfigurationService
- Porta HTTP do repositório
- Porta HTTPS do repositório
- com.ibm.team.repository.service.internal.webuiInitializer.ConfigPropertyInitializer
- Porta HTTP da URL
- Porta HTTPS da URL
- Agora você está pronto para conectar-se ao servidor com o cliente do
Rational Team Concert
ou com o navegador da Web.
Instalando o Cliente Utilizando o
IBM Installation Manager
O cliente é distribuído como um arquivo que pode ser transferido por download através do
IBM Installation Manager.
Nota:
Se você desejar instalar o cliente em um ambiente de trabalho Eclipse existente, use o IBM Installation Manager. A instalação do IBM Installation Manager solicita o ambiente de trabalho que você deseja estender e
cuida do gerenciamento de atualizações, rollbacks e modificações futuras do ambiente de trabalho.
Nota:
Se o SELinux (Security-Enhanced
Linux) estiver ativado,
você
deve desativá-lo ou alterar o contexto de segurança do JRE (Java Runtime Environment) para
possibilitar a alocação de texto para instalar e executar o Rational Team Concert. Para obter informações
adicionais, consulte
Instalando o
Rational Team Concert
com Security-Enhanced Linux.
- Faça download de um dos seguintes pacotes de instalação.
Há três métodos para instalar o cliente do
Rational Team Concert.
- Inicie o programa da barra de ativação.
Se o Installation Manager não estiver em execução, conclua as seguintes etapas para iniciá-lo.
Nota:
Você deve ter privilégios de administrador para executar o programa da barra de ativação.
Nota:
Os comandos do Linux para inciar o programa da barra de ativação funcionam somente para o Rational Team Concert para Eclipse IDE.
Para iniciar o arquivo do
programa da barra de ativação:
- Se você estiver utilizando o arquivo .zip dos Conteúdos do CD do Cliente, extraia os conteúdos
do archive em um diretório temporário e execute o programa da barra de ativação. Para iniciar o arquivo do
programa da barra de ativação:
- Para executar o arquivo no Windows, execute este comando:
launchpad.exe
- Para executar o arquivo no Linux, execute este comando:
sh launchpad.sh
- Se você estiver utilizando a instalação via Web do Installation Manager, execute o arquivo
executável. Os arquivos são extraídos em um diretório e um programa de barra de ativação é exibido. Para
iniciar o arquivo executável:
- Se você estiver utilizando o arquivo .zip Conteúdo do DVD Completo, extraia os conteúdos do
archive em um diretório temporário e execute o programa da barra de ativação. Para iniciar o arquivo do
programa da barra de ativação:
- Para executar o arquivo no Windows, execute este comando:
launchpad.exe
- Para executar o arquivo no Linux, execute este comando:
sh launchpad.sh
- É possível instalar os seguintes clientes:
- Para instalar o cliente do Rational Team Concert para Eclipse, clique no link do Cliente do Rational Team Concert para Eclipse IDE.
- Para instalar o cliente do Rational Team Concert para Microsoft Visual Studio, clique no link do Rational Team Concert Client
para Microsoft Visual Studio
IDE.
O assistente do Installation Manager é exibido.
O assistente o guia na instalação do cliente.
- Inicie o cliente clicando no atalho do
Rational Team Concert
criado pela instalação.
- Conecte-se ao servidor. A maneira mais fácil de conectar-se a um servidor é utilizar o Convite da Equipe. Se você não tiver um
convite, pode conectar-se manualmente.
- Clique em Arquivo -> Aceitar Convite da Equipe. O assistente o
orienta pelo processo.
Nota:
Se você não tiver um convite, precisará de uma URI ou URL do seu administrador do servidor. (um formato de
exemplo é: https://example.com:9443/jazz). Clique no hyperlink conectando-se a uma área do projeto
existente que aparece no canto inferior direito da janela Aceitar Convite da
Equipe.
- Siga as instruções no assistente para definir sua conexão.
Resolução de Problemas: A seguir estão algumas técnicas de gerenciamento de problemas sugeridas.
- Comece com uma área de trabalho vazia.
- As construções do cliente e do servidor devem corresponder. Certifique-se de que os IDs da construção
correspondam para as distribuições do cliente e do servidor.
- Certifique-se de que o servidor esteja ativo. Confirme utilizando a URL de status:
https://example.com:9443/jazz.
- No Linux, se você desejar iniciar o cliente de fora do
diretório JazzInstallDir/client/eclipse,
deve alterar cada arquivo no
JazzInstallDir/client/eclipse/links/
e incluir o caminho absoluto para o diretório nomeado. Por padrão, são utilizados caminhos relativos. Por exemplo, JazzInstallDir/client/eclipse/links/build.link contém o texto "path=jazz/build".
Se o seu cliente estiver instalado no diretório /home/username/teamconcert, edite o arquivo para que ele se
pareça como "path=/home/username/teamconcert/jazz/client/eclipse/build".
Após ter instalado o cliente bem-sucedidamente, você deve fazer referência aos seguintes tópicos para ajudá-lo a começar a utilizar o Rational Team Concert.
O
Build
System Toolkit
pode ser instalado nas máquinas de construção utilizando o
IBM Installation Manager.
- Inicie o programa da barra de ativação.
Se o Installation Manager não estiver em execução, inicie-o.
Nota:
Você deve ter privilégios de administrador para executar o programa da barra de ativação.
- Se você estiver utilizando a instalação via Web do Installation Manager, execute o arquivo
executável. Os arquivos são extraídos em um diretório e um programa de barra de ativação é exibido.
- Se você estiver utilizando o arquivo .zip Conteúdo do DVD Completo, extraia os conteúdos do
archive em um diretório temporário e execute o programa da barra de ativação.
- Para executar o arquivo no Windows, execute este comando:
launchpad.exe
- Para executar o arquivo no Linux, execute este comando:
sh launchpad.sh
- Quando o programa da barra de ativação aparece, clique no
Build
System Toolkit
para iniciar o processo de instalação.
- Depois da instalação estar completa, você pode configurar uma construção.
Mais informações sobre o
Build
System Toolkit
podem ser localizadas
em Sobre
a Construção de Equipes do
Jazz.
Instalando o
Rational Team Concert
com Security-Enhanced Linux
Se o SELinux (Security-Enhanced
Linux) estiver ativado,
você deve também desativá-lo ou alterar o contexto de segurança do JRE
(Java Runtime
Environments) utilizado para instalação e execução do
Rational Team Concert
para permitir a realocação de texto.
Se você tiver configurado uma máquina com o propósito exclusivo de avaliar o
Rational Team Concert
e os recursos SELinux não forem importantes para você, então a maneira mais fácil de continuar é desativar o
SELinux.
Nota:
- O SELinux é instalado e ativado por padrão no Red Hat Enterprise
Linux 5.
- O SELinux não é instalado no Suse
Linux Enterprise Server 10
ou Suse Linux Enterprise
Desktop 10.
- Para desativar o SELinux, execute um dos procedimentos a seguir:
- A partir do sistema de janelas:
- Selecione Sistema -> Administração -> Nível
de Segurança e Firewall.
- Alterne para a guia SELinux.
- Altere a configuração do SELinux para Desativado.
- Clique em OK para salvar a nova configuração.
- A partir da linha de comandos:
- Execute o comando "setup" (isto é, /usr/bin/setup)
- Selecione Configuração do Firewall e pressione Enter
- Utilize as teclas Tab e de seta para alterar o SELinux para Desativado
- Selecione OK e pressione Enter
-
Para alterar o contexto de segurança dos JREs:
-
Se você estiver instalando diretamente da mídia de DVD; vá para a etapa
2.
Caso contrário, altere o contexto de segurança do JRE da instalação.
- No diretório dos arquivos de instalação, localize o diretório jre. linux/jre_5.0.2.sr5_20070511/jre.
Se você extraiu os arquivos de instalação no diretório /tmp/rtc então o jre do diretório está localizado no
/tmp/rtc/linux/jre_5.0.2.sr5_20070511/jre.
- Execute o comando chcon -R -t textrel_shlib_t junto ao diretório jre.
Este comando processa os arquivos recursivamente e possibilita a realocação de texto. Por exemplo, se você
extraiu os arquivos de instalação no /tmp/rtc, execute o comando a seguir:
chcon -R -t textrel_shlib_t /tmp/rtc/linux/jre_5.0.2.sr5_20070511/jre
-
Instale o servidor, o cliente e os conectores do
Rational Team Concert,
mas não os inicie.
- Antes de iniciar
o Rational Team Concert,
você deve alterar o contexto de segurança dos JREs do produto. Para cada produto que você instalar, execute o
mesmo comando (chcon -R -t textrel_shlib_t) com o diretório do JRE específico do produto apropriado. Os
diretórios padrão são listados abaixo.
Nota:
Os caminhos são o padrão se você instalou o produto como usuário root. Se você instalou como um usuário
não root, procure estes diretório dentro de uma estrutura opt/IBM no diretório inicial do usuário da
instalação.
- IBM Installation Manager:
- /opt/IBM/InstallationManager/eclipse/jre_5.0.2.sr5_20070511/jre
- Jazz Team
Server:
- /opt/IBM/JazzTeamServer/server/linux/ibm-java2-i386-50/jre
- Rational Team Concert
- Cliente: (execute chcon nos 4 diretórios)
- /opt/IBM/TeamConcert/jdk/bin
- /opt/IBM/TeamConcert/jdk/lib
- /opt/IBM/TeamConcert/jdk/jre/bin
- /opt/IBM/TeamConcert/jdk/jre/lib
- Rational Team Concert - Build
System Toolkit:
- não aplicável (nenhum JRE incluído)
- Rational Team Concert
-
ClearCase Connector:
(execute chcon nos 4 diretórios)
- /opt/IBM/ClearCaseConnector/jdk/bin
- /opt/IBM/ClearCaseConnector/jdk/lib
- /opt/IBM/ClearCaseConnector/jdk/jre/bin
- /opt/IBM/ClearCaseConnector/jdk/jre/lib
- Rational Team Concert - ClearQuest Connector:
- /opt/IBM/ClearQuestConnector/gateway/linux/ibm-java2-i386-50/jre