Instalando o Cliente do Rational Team Concert Utilizando o IBM Installation Manager


Esta versão foi criada em 09 Jun 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/v2r0m0/index.jsp.

Índice

Instalando o Cliente Utilizando o IBM Installation Manager
Fazendo Upgrade para o Rational Team Concert 2.0
Instalando o Rational Team Concert com Security-Enhanced Linux

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

  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.

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:

  1. Em um navegador da Web, navegue para https://server-host:9443/jazz/admin.action=com.ibm.team.repository.admin.serverReset.
  2. Clique em Solicitar Reconfiguração do Servidor.
  3. 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.

  1. 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.
  2. Remova as propriedades JVM customizadas antigas:
    1. com.ibm.team.repository.provision.profile
    2. com.ibm.team.server.configURL
    3. log4j.configuration
  3. Inclua a nova propriedade JVM customizada JAZZ_HOME e configure o valor para:
    file:///<Dir_de_Instalação_do_Jazz>/server/conf
  4. 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:
    1. Navegando para Segurança -> Administração, Aplicativos e Infraestrutura Seguros -> Segurança da Web - Configurações Gerais.
    2. 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:

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 alterações e alterações 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 alteração é que, a menos que você a configure, nenhum dado será coletado.

Para configurar a captura instantânea do SCM:

  1. É necessário ter permissões de gravação para o fluxo para o qual você deseja coletar dados.
  2. Vá para a página Relatórios na UI da Web.
  3. No painel de navegação esquerdo, selecione Administrar Captura Instantânea do SCM. Uma lista de fluxos é exibida.
  4. Selecione a caixa de opção para um ou mais fluxos e, em seguida, selecione Salvar Alterações.

Os dados serão coletados para os fluxos selecionados em todas as capturas instantâneas subsequentes.

Alterações 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:

Importação dos Dados dos Itens de Trabalho no Armazém de Dados

No Rational Team Concert 2.0, há várias alterações 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:

  1. No rich client, abra a visualização Artefatos da Equipe.
  2. Expanda sua área do projeto, expanda Relatórios.
  3. 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 alterações 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.

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: