Instalando o
IBM
Rational Team Concert
Standard Edition utilizando o
IBM Installation
Manager


Esta versão foi criada em 28 Jan 2009.

A versão mais recente desse procedimento de instalação, junto com informações de planejamento úteis, pode ser localizada on-line no endereço http://publib.boulder.ibm.com/infocenter/rtc/v1r0m1/index.jsp.

Índice

Instalando o Rational Team Concert Standard Edition
Atualizando para o Rational Team Concert 1.0.1 ou 1.0.1.1
Visão Geral da Instalação da Standard Edition
Preparando-se para Instalar a Standard Edition
Instruções Especiais para Linux
Instalando a Standard Edition a partir do IBM Installation Manager
Configurando o Banco de Dados
Configurando um Banco de Dados DB2
Configurando um Banco de Dados Oracle
Configurando um Banco de Dados do Servidor SQL
Criando as Tabelas de Banco de Dados do Jazz Team Server
Iniciando o Servidor
Iniciando o Servidor Apache Tomcat
Iniciando o Servidor no Windows
Iniciando o Servidor no Linux
Configurando um WebSphere Application Server
Executando o Assistente de Configuração
Concluindo a Instalação
Instalando o Cliente Utilizando o IBM Installation Manager
Instalando o Build System Toolkit a partir do IBM Installation Manager
Instalando o Rational Team Concert ClearCase Connector Utilizando o IBM Installation Manager
Instalando o Rational Team Concert ClearQuest Connector Utilizando o IBM Installation Manager
Instalando o Rational Team Concert com Security-Enhanced Linux

Instalando o Rational Team Concert Standard Edition

Atualizando para o Rational Team Concert 1.0.1 ou 1.0.1.1

É possível atualizar os clientes e servidores do Rational Team Concert executando uma instalação do zip ou do Installation Manager.

Nota:
Se o Installation Manager é usado para instalar o Rational Team Concert 1.0.1.1 em um computador em que o Rational Team Concert não está instalado atualmente, o Installation Manager solicita que os idiomas a serem instalados sejam selecionados. Entretanto, se for feita uma atualização a partir de uma versão anterior para o 1.0.1.1, o Installation Manager assume que você deseja usar os idiomas atuais e não solicita que os idiomas sejam selecionados. Versões pré-1.0.1.1 estão disponíveis somente em inglês. Para selecionar idiomas adicionais, após atualizar para 1.0.1.1, selecione Modificar na tela principal do Installation Manager e, em seguida, selecione a oferta. A tela a seguir mostra a lista de idiomas suportados. Selecione os necessários.

Atualizando Clientes do 1.0 Rational Team Concert Eclipse

Se você tiver clientes do 1.0, recomendamos que obtenha o cliente do 1.0.1 ou do 1.0.1.1 para conectar-se ao seu novo servidor 1.0.1 ou 1.0.1.1. É possível instalar esses, utilizando um arquivo zip ou você pode atualizar suas instalações anteriores do 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 de Acesso Antecipado do Rational Team Concert, primeiro atualize para o release Experimental 1.0 ou diretamente para o produto do Servidor 1.0.1 adquirido. As chaves do servidor 1.0 não tornam um servidor de Acesso Antecipado Permanente.

A partir do release Experimental 1.0, é possível tornar seu servidor Permanente adquirindo e instalando o Kit de Ativação do Servidor para sua edição que está disponível aqui: http://www-306.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.

Atualizando um Servidor a partir do 1.0

É possível atualizar diretamente para o release 1.0.1 ou 1.0.1.1 do Rational Team Concert a partir do release 1.0. É possível reutilizar seu banco de dados 1.0; não há nenhuma migração do banco de dados necessária.

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 Request Server Reset.

Se você estiver executando um marco ou Beta anterior, siga as instruções de upgrade para o 1.0 https://jazz.net/downloads/rational-team-concert/releases/. Primeiro, execute qualquer migração de banco de dados necessária.

Se você instalou o release 1.0 a partir de um arquivo zip, não existe nenhuma interseção com a instalação anterior. É possível instalar o release 1.0.1 ou 1.0.1.1 a partir de um zip em um novo local, ou é possível usar o Installation Manager para instalar uma instância do 1.0.1 ou 1.0.1.1.

Se o Installation Manager foi usado para instalar o release 1.0, é possível instalar o 1.0.1 ou 1.0.1.1 como uma instância separada ou atualizar a instância 1.0 para 1.0.1 ou 1.0.1.1. Se você instalar uma instância separada do servidor para o release 1.0.1 ou 1.0.1.1, selecione Criar um Novo Grupo de Pacotes na página Instalar Pacotes do assistente de instalação.

Nota:
Para atualizar um Websphere Application Server, remova o arquivo jazz.war 1.0 e implemente o arquivo jazz.war 1.0.1

Para concluir o upgrade, consulte Copiando os Arquivos de Configuração Necessários a partir de uma Instalação de Servidor Anterior e Instalando Chaves de Ativação 1.0.1.

Atualizando um Servidor de Um Rational Team Concert Edition para Outro

É possível atualizar entre edições do Rational Team Concert. Upgrades típicos incluem mudar do Express-C para o Express ou do 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 1.0.1 e 1.0.1.1 suportam bancos de dados Derby, não é necessário migrar do Derby para o DB2 ou Oracle se você estiver mudando do Express-C para o 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 desempenhar uma migração do banco de dados, consulte Migrating the Jazz Team Server.

Se você tiver instalado uma edição do Rational Team Concert 1.0.1 ou 1.0.1.1 e deseja atualizar para outra, faça download da nova edição e instale-a, 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 utilizar a instalação do Installation Manager para a nova edição. Recomendamos que o Installation Manager seja utilizado para servidores de produção a fim de possibilitar que futuras atualizações sejam aplicadas.

Se você utilizou o Installation Manager para desempenhar a instalação do seu servidor anterior e deseja utilizar o 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.

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ê utilizou o Installation Manager para atualizar de 1.0 para 1.0.1, um diretório de backup contendo seus arquivos de configuração 1.0 foi criado com um nome, como backup-config-timestamp no subdiretório do servidor do local de instalação.

Se você estiver atualizando para a edição Padrão e adquiriu o Developer Client Activation Kit para Express, compre e instale o Developer Client Activation Kit para Standard Edition, para poder utilizar essas 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 Chaves de Ativação 1.0.1

Se você instalou a Chave de Ativação do Servidor permanente e as Chaves de Licença de Ativação do Cliente na instalação de servidor 1.0, obtenha e instale as versões 1.0.1 dessas chaves. O servidor reverte para uma licença experimental após o upgrade para 1.0.1. Obtenha as chaves de ativação 1.0.1 a partir do Passport Advantage. Abaixo estão os nomes das chaves aplicáveis para cada edição de servidor:

Chaves de edição expressa:

Chaves de edição padrão:

Visão Geral da Instalação da Standard Edition

O pacote de instalação inclui tudo o que você precisa para começar.

A configuração padrão inclui:

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 Standard 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 Standard Edition a partir do IBM Installation Manager

Após obter os arquivos de instalação, inicie a instalação.

Por Que e Quando Desempenhar Esta Tarefa

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.

  1. Faça download de um dos seguintes pacotes de instalação. Escolha a plataforma na qual está instalando.

    Há dois métodos para instalar o Rational Team Concert Standard Edition utilizando o IBM Installation Manager.

  2. 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.
  3. 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.
    1. 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.
    2. Opcional: Instale o DB2 Express.
      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 Express

      Se você instalar o DB2 Express, 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.

    3. Instale o ClienteRational Team Concert.
    4. Opcional: Instale o Build System Toolkit.
    5. Opcional: Instale o ClearCase Connector.
    6. Opcional: Instale o ClearQuest Connector.

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:

  1. Criar um banco de dados.
  2. Configurar os arquivos de propriedades.
  3. Criar as tabelas de banco de dados.

Se você estiver utilizando o DB2 ou o DB2 Express, continue comConfigurando um Banco de Dados DB2.

Se você estiver utilizando o Oracle, continue com Configurando um Banco de Dados Oracle.

Configurando um Banco de Dados DB2

Configure um banco de dados DB2 ou DB2 Express para funcionar com o Jazz Team Server.

Antes de Iniciar

Este procedimento assume que os seguintes pré-requisitos foram atendidos. Consulte sua documentação do DB2 ou um DBA (DB2 Database Administrator) para obter ajuda.

Por Que e Quando Desempenhar Esta Tarefa

Para configurar um banco de dados DB2:

  1. 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 Iniciar 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.
    Dica:
    Se o banco de dados não estiver em execução, o comando db2start inicia o DB2.
  2. Localize o arquivo teamserver.properties no diretório JazzInstallDir/server e renomeie-o como teamserver.derby.properties.
  3. Localize o arquivo teamserver.db2.properties no diretórioJazzInstallDir/server e renomeie-o como teamserver.properties.
  4. 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 no host local na porta 50000. O banco de dados denominado JAZZ, 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.

    1. Abra o arquivo teamserver.properties em um editor de texto.
    2. Localize as linhas a seguir:
      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
    3. Edite o valor do com.ibm.team.repository.db.jdbc.location para seu servidor e banco de dados do 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.
    4. Edite o valor do com.ibm.team.repository.db.jdbc.location para 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.
    5. 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.
    6. 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 é 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.

Resultados

Você concluiu a configuração do seu banco de dados. Continue com Criando as Tabelas de Banco de Dados do Jazz Team Server.

Configurando um Banco de Dados Oracle

Configure um banco de dados Oracle para funcionar com o Jazz Team Server.

Antes de Iniciar

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.

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.

Nota:
Nenhuma dessas etapas é realizada por um criador do banco de dados com as ferramentas do repositório.

Por Que e Quando Desempenhar Esta Tarefa

Para configurar um banco de dados Oracle:

  1. 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
    Nota:
    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.
  2. 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
    Após o usuário ser criado, conceda permissões do sistema de banco de dados necessárias para realizar estas ações:
  3. Localize o arquivo teamserver.properties no diretório JazzInstallDir/server e renomeie-o como teamserver.derby.properties.
  4. Localize o arquivo teamserver.oracle.properties no diretório JazzInstallDir/server e renomeie-o como teamserver.properties.
  5. Configurar o servidor
    1. Abra o arquivo teamserver.properties em um editor de texto. Localize as linhas a seguir; e altere as propriedades do local e da senha para sua configuração:
      com.ibm.team.repository.db.vendor = ORACLE
      com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@localhost:1521/ORCL
      com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@//oracleserver.example.com:1521/ORCL
      com.ibm.team.repository.db.jdbc.password=jazzDBpswd
      Nota:
      Se você estiver utilizando o Oracle Express, altere ORCL para XE.
      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.location=thin:jazzDBuser/{password}@//oracleserver.example.com:1521/XE
      com.ibm.team.repository.db.jdbc.password=jazzDBpswd
      Especifique a senha do usuário na propriedade com.ibm.team.repository.db.jdbc.password.
      Nota:
      Não altere o texto password={password} no repositório com.ibm.team.repository.db.jdbc.location.
    2. No mesmo diretório que o dos scripts de servidor JazzInstallDir/server), crie um diretório denominado oracle.
    3. 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.

Resultados

Você concluiu a configuração do seu banco de dados e pode continuar com os Criando as Tabelas de Banco de Dados do Jazz Team Server.

Configurando um Banco de Dados do Servidor SQL

Configure um banco de dados do Servidor SQL para funcionar com o Jazz Team Server.

Este procedimento assume que os seguintes pré-requisitos foram atendidos:

Nota:
O nome de login padrão definido no arquivo JazzInstallDir/server/teamserver.properties para um banco de dados do Servidor SQL é 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

Nota:
Esta seção descreve como configurar o banco de dados do Servidor SQL utilizando a ferramenta de linha de comandos sqlcmd, fornecida com a instalação do Servidor SQL. 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 Servidor SQL ou um database administrator (DBA) do Servidor SQL, para obter informações adicionais.

Para configurar um banco de dados do Servidor SQL utilizando a ferramenta de comando sqlcmd:

  1. Crie um banco de dados do Jazz Team Server. A partir da ferramenta de linha de comandos, digite:
    CREATE DATABASE jazz
    IR
  2. 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
  3. 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

Nota:
Por padrão, o arquivo teamserver.properties no diretório JazzInstallDir/server não é configurado para conectar a um banco de dados do Servidor SQL. Todas as configurações padrão, junto com configurações específicas do Servidor SQL, estão contidas no arquivo teamserver.sqlserver.properties no mesmo diretório.

Para configurar o servidor:

  1. Renomeie os seguintes arquivos:
    Nota:
    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.
  2. Edite o arquivo de configuração do servidor se você utilizou um nome de usuário, senha ou nome de bd diferente, instalou o Servidor SQL em uma máquina diferente do Jazz Team Server ou está utilizando uma porta diferente do padrão. Abra o arquivo teamserver.properties no diretório JazzInstallDir/server e altere as informações listadas abaixo para corresponderem à 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
  3. Localize o arquivo JAR do driver JDBC do Servidor SQL, denominado sqljdbc.jar. O local pode variar, dependendo de onde os drivers foram instalados, conforme indicado na seção de pré-requisitos.
  4. Especifique o local do arquivo JAR JDBC para JDBC concluindo uma das seguintes tarefas:

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 do Jazz Team Server.

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:

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 Servidor SQL 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 freqüentes, 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 do Jazz Team Server

Crie as tabelas de banco de dados utilizando as ferramentas do repositório.

Por Que e Quando Desempenhar Esta Tarefa

Para criar tabelas de banco de dados:

  1. 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
  2. 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 alterações estejam em efeito.
    Dica:
    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.

Resultados

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.

Por Que e Quando Desempenhar Esta Tarefa

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.

Iniciando o Servidor no Windows

Execute o arquivo de inicialização para iniciar seu servidor no Windows.

Por Que e Quando Desempenhar Esta Tarefa

  1. 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.
  2. Para parar o servidor, a partir do diretório JazzInstallDir/server, execute este comando:
    server.shutdown.bat

O que Fazer Depois

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.

Por Que e Quando Desempenhar Esta Tarefa

  1. 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 no JazzInstallDir/server/tomcat/logs/catalina.out.

  2. 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

O que Fazer Depois

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

Antes de iniciar estas etapas, você deve ter concluído o seguinte:

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.

  1. 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,

    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.
  2. 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
  3. 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.

  4. 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.
  5. 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.

    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.

O que Fazer Depois

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

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.

Por Que e Quando Desempenhar Esta Tarefa

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/tomcat/logs é utilizado 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:

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.



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.

O que Fazer Depois

Se o assistente de configuração do servidor não carregar, verifique os itens a seguir:

Concluindo a Instalação

Após o servidor ser instalado, você deve considerar algumas opções de configuração antes de continuar.

Por Que e Quando Desempenhar Esta Tarefa

Após a instalação, há algumas poucas ações adicionais a tomar.

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.

Por Que e Quando Desempenhar Esta Tarefa

Nota:
Se você desejar instalar o cliente em um ambiente de trabalho do Eclipse existente, utilize 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.

  1. Faça download de um dos seguintes pacotes de instalação.

    Há três métodos para instalar o cliente do Rational Team Concert.

  2. 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:
  3. É possível instalar os seguintes clientes: O assistente do Installation Manager é exibido. O assistente o guia na instalação do cliente.
  4. Inicie o cliente clicando no atalho do Rational Team Concert criado pela instalação.
  5. 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.
    1. 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.
    2. Siga as instruções no assistente para definir sua conexão.

Exemplo

Resolução de Problemas: A seguir estão algumas técnicas de gerenciamento de problemas sugeridas.

O que Fazer Depois

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.

Instalando o Build System Toolkit a partir do IBM Installation Manager

O Build System Toolkit pode ser instalado nas máquinas de construção utilizando o IBM Installation Manager.

Por Que e Quando Desempenhar Esta Tarefa

  1. 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.
  2. Quando o programa da barra de ativação aparece, clique no Build System Toolkit para iniciar o processo de instalação.
  3. Após a instalação ser concluída, uma construção deve ser configurada. 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 ClearCase Connector Utilizando o IBM Installation Manager

O ClearCase Connector pode ser instalado nas máquinas de construção utilizando o IBM Installation Manager.

Por Que e Quando Desempenhar Esta Tarefa

  1. 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.
  2. Quando o programa da barra de ativação aparece, clique no ClearCase Connector para iniciar o processo de instalação.
  3. Após a instalação ser concluída, configure o ClearCase Connector. ConsulteImplementando o ClearCase Connector.

Instalando o Rational Team Concert ClearQuest Connector Utilizando o IBM Installation Manager

O ClearQuest Connector pode ser instalado nas máquinas de construção utilizando o IBM Installation Manager.

Por Que e Quando Desempenhar Esta Tarefa

  1. 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.
  2. Quando o programa da barra de ativação aparece, clique no ClearQuest Connector para iniciar o processo de instalação.
  3. Após a instalação ser concluída, configure o ClearQuest Connector. ConsulteImplementando o ClearQuest Connector.

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.

Por Que e Quando Desempenhar Esta Tarefa

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:


Feedback