Fazendo Upgrade de uma Versão Anterior no WebSphere Application Server

Use este guia para fazer upgrade de uma versão anterior do IBM® Rational Asset Manager no IBM WebSphere Application Server.

Antes de Iniciar

Importante:

Como o Rational Asset Manager Versão 7.5.2 e posterior não suporta o WebSphere Application Server integrado e não suporta versões do WebSphere Application Server anteriores a 7.0, se você estiver executando o Rational Asset Manager no WebSphere Application Server integrado ou em uma versão do WebSphere Application Server anterior a 7.0, você deverá primeiro reinstalar a versão existente do Rational Asset Manager sobre uma versão suportada do WebSphere Application Server 7.0 ou posterior. Em seguida, siga as etapas deste tópico para fazer upgrade para o Rational Asset Manager Versão 7.5.2 ou posterior.

Você deve fazer upgrade do seu servidor de licença e arquivar uma solicitação para chaves de licença atualizadas. Para obter mais informações sobre a versão necessária do Rational License Server, consulte Instalando o Rational License Key Server.

Também será necessário parar e reiniciar seu servidor de aplicativos várias vezes.

Você também pode configurar um servidor Rational Team Concert existente para trabalhar com o Rational Asset Manager. O aplicativo de configuração do servidor manipula a configuração. Você deve saber o nome de usuário e a senha para o administrador do servidor Rational Team Concert.

Se você tiver acesso à Internet, é possível usar o IBM Installation Manager para localizar e instalar as atualizações diretamente a partir do repositório de atualização da IBM para o Rational Asset Manager.

Importante: Quando o Rational Asset Manager é instalado, o local de seu repositório de atualização é integrado automaticamente ao Installation Manager. Para que o Installation Manager procure no repositório de atualização padrão, a preferência Procurar nos repositórios vinculados durante a instalação e as atualizações na página de preferências Repositórios deve ser selecionada; essa preferência é selecionada por padrão.

Para instalar o fix pack a partir de um local de repositório diferente (por exemplo, se a atualização estiver em uma unidade compartilhada ou no servidor HTTP ou HTTPS), inclua o local do repositório no Installation Manager. Para incluir um local de repositório, consulte Configurando as Preferências do Repositório de Instalação no Installation Manager.

Para trabalhar com o Installation Manager, você deve usar uma interface gráfica com o usuário (GUI). Se você não tiver acesso a uma GUI, deverá instalar silenciosamente na linha de comandos com arquivos de resposta. Para obter informações adicionais, consulte a Ajuda on-line do IBM Installation Manager e o Instalando Silenciosamente com o Installation Manager.

Sobre Esta Tarefa

Este resumo mostra o que você deve fazer para atualizar para a versão mais recente do Rational Asset Manager:
  1. Preparar upgrade fazendo backups e configurando o servidor de aplicativos: etapas 1-5.
  2. Se estiver utilizando Oracle, copiar arquivos .jar JDBC adicionais: etapas 6-7.
  3. Fazer upgrade do servidor de licença para o Rational Common Licensing V8.1.2: etapa 8.
  4. Recuperar os arquivos do aplicativo para a versão mais recente do Rational Asset Manager e implemente o aplicativo de configuração do servidor: etapas 910.
  5. Usar o aplicativo de configuração do servidor para atualizar os outros aplicativos do Rational Asset Manager: etapas 1114.
  6. Reiniciar o servidor de aplicativos: etapa 17.
  7. Efetuar login no Web client do Rational Asset Manager e migre o repositório: etapas 1920.
  8. Opcionalmente, atualize o aplicativo Rational Asset Manager Eclipse: etapa 21.

Procedimento

  1. Antes de fazer upgrade, crie um backup completo do repositório, dos bancos de dados, dos arquivos de ativos e das configurações de servidor de aplicativos através das instruções no Criando um Backup de um Repositório do Rational Asset Manager.
  2. Para Linux:Para AIX:Para Linux for zSeries:No Linux, AIX ou Linux for zSeries, aumente para pelo menos 65535 o número de descritores de arquivos que podem ser abertos de uma vez para um processo:
    1. Para visualizar o número atual de descritores que podem ser abertos de uma vez, na linha de comandos, digite: ulimit -n
    2. Se o limite não for de pelo menos 65535, aumente-o com o seguinte comando: ulimit -n 65535
  3. Se você tiver modificado seu tema ou suas mensagens de e-mail, antes de atualizar o servidor Rational Asset Manager, faça download dos arquivos de tema e mensagem de correio atuais (na página Administração > Ferramentas) e, em seguida, depois de ter atualizado o servidor, reaplique o tema e suas mensagens. Para obter mais informações, consulte Migrando o Tema.
  4. Para WebSphere: Configure as definições de segurança do aplicativo e de autenticação do WebSphere Application Server:
    1. Em um navegador da web, efetue login no console administrativo doWebSphere Application Server. Por padrão, ele está localizado em:
      • No WebSphere Application Server: http://localhost:9060/ibm/console
    2. Clique em Segurança.
    3. Clique em Segurança Global.
    4. Na seção Segurança Administrativa, se a caixa de seleção Ativar Segurança Administrativa estiver marcada, marque a caixa de seleção Ativar Segurança do Aplicativo.
    5. Clique em Aplicar.
    6. Na janela Mensagens, clique em Salvar diretamente na configuração principal.
    7. Pare e, em seguida, reinicie o servidor.
  5. Verifique se todos os servidores do repositório estão configurados para a mesma data, hora e fuso horário atuais.
  6. Para o Oracle: Se você estiver usando o Oracle, copie o arquivo ojdbc6.jar para o diretório WebSphere_install_directory/profiles/profile_name/config/cells/cell_name/ram_jdbc de seu servidor de aplicativos. É possível fazer download dos arquivos .jar apropriadosa partir do Oracle. Se estiver usando Oracle 10g, faça o download de um pacote para Oracle 11 para obter os arquivos .jar apropriados.
  7. Se você estiver usando o Oracle e estiver usando o AIX, Linux ouLinux para zSeries, configure as permissões apropriadas para o novo arquivo .jar JDBC, conforme descrito em Ativando a Conectividade do Banco de Dados para Usuários Não-Root (Linux e AIX). O usuário que acessa o banco de dados Oracle a partir do Rational Asset Manager deve receber o privilégio apropriado para concluir a migração.
    • Se você estiver usando o usuário RAMSCHEMA, conceda o privilégio CREATE VIEW para o usuário RAMSCHEMA. Exemplo: GRANT CREATE VIEW TO RAMSCHEMA
    • Se estiver usando um usuário diferente, conceda o privilégio CREATE ANY VIEW para tal usuário. Exemplo: GRANT CREATE ANY VIEW TO User
  8. Para Windows:Para Linux:Para AIX: Migre seu Rational Licensing Server para um Rational Common Licensing V8.1.2 ou posterior. Para obter mais informações, consulte Migrando do Rational Licensing Server v7.1.x ou anterior para o Rational Common Licensing.

    Rational License Key Server está incluído com a mídia de instalação do Rational Asset Manager. Você também pode recuperar a versão mais recente do Rational License Server através da conta do Passport Advantage ou através do Centro de Download da IBM.

    Este processo requer que você encerre todos os aplicativos que usam o Rational Licensing Server, desinstale seu Rational Licensing Server existente, atualize seus arquivos de licença e instale o servidor Rational Common Licensing. Para Windows, consulte Configurando um servidor de licença para Windows; para AIX ou Linux, consulte Configurando um servidor de licença para UNIX.

    Para Linux para zSeries, continue a usar o Rational License Server para UNIX e Linux 7.0.0.1.
  9. Recupere os aplicativos apropriados do Rational Asset Manager:
    • Se você usar o WebSphere Application Server e usou o Installation Manager para implementar o Rational Asset Manager em seu servidor, use o Installation Manager para o processo de upgrade. Consulte as instruções de Instalando o Servidor Rational Asset Manager Usando o Installation Manager e observe estas diferenças:
      1. Inicie o Gerenciador de Instalação. No Windows Vista, execute o Installation Manager como um administrador (Clique com o botão direito do mouse no atalho do programa e selecione Executar como Administrador.
      2. Talvez seja necessário atualizar o Installation Manager para uma versão mais recente. Para configurar o Installation Manager para que ele procure atualizações: na página Iniciar, clique em Arquivo > Preferências e, em seguida, clique em Atualizações. Na página Atualizações, selecione Procurar por Atualizações do Gerenciador de Instalação.
      3. Na página Iniciar do Gerenciador de Instalação, clique em Atualizar.
      4. Se houver uma versão mais recente do Installation Manager disponível, aparecerá uma janela solicitando atualização. Clique em Sim. Depois que o processo de atualização estiver concluído, clique em OK para reiniciar o Installation Manager e, em seguida, clique em Atualizar novamente.
      5. Na página Pacotes de Atualização, selecione IBM Rational Asset Manager e, em seguida, clique em Avançar. Expanda e selecione a versão mais recente do servidor do Rational Asset Manager e clique em Avançar.
      6. Siga as instruções no Assistente de Atualização.
        1. Na página Raiz de Contexto, o Installation Manager detecta as raízes de contexto para seus atuais aplicativos da Web do Rational Asset Manager. Anote a raiz de contexto do Servidor de Configuração do Rational Asset Manager; a raiz de contexto é necessária para acessar o aplicativo de configuração do servidor. Em seguida, clique em Avançar.
        2. Se a segurança do servidor de aplicativos estiver ativada (ela provavelmente está) ou se as configurações de segurança para o WebSphere Application Server foram alteradas desde a instalação do produto, na página Segurança Administrativa da seção Recursos, selecione Sim e digite o nome de usuário e a senha para o administrador do servidor de aplicativos. Em seguida, clique em Avançar.
      7. Depois da conclusão do processo de atualização:
        1. Se você usar um WebSphere Application Server existente, o arquivo .ear do aplicativo de configuração do servidor foi atualizado. Vá para a etapa 11.
        2. Se você usar um WebSphere Application Server ND Cluster existente, acesse a etapa 11. Se você estiver fazendo upgrade da versão 7.5 ou posterior e que foi a primeira versão do produto instalado, o aplicativo de configuração do servidor foi atualizado no servidor de aplicativos especificado quando o produto foi instalado originalmente. Se você instalou qualquer versão anterior à 7.5, o aplicativo da configuração do servidor será atualizado no servidor Deployment Manager para sua célula.
    • Se você implementou os arquivos Rational Asset Manager .ear e .war em seu servidor de aplicativos, recupere a versão mais recente dos arquivos de aplicativos do Rational Asset Manager. Para obter informações adicionais, consulte Recuperando os Arquivos de Aplicativo do Servidor Diretamente da Mídia de Instalação. Depois que tiver os arquivos de aplicativo, continue com a etapa 10.
  10. Implemente o aplicativo de configuração do servidor do Rational Asset Manager em seu servidor de aplicativos:
    • Se você estiver usando um cluster do WebSphere Application Server e implementou o aplicativo de configuração do servidor no servidor Deployment Manager (isto descreve a maioria dos ambientes em um cluster antes da V7.5), você deve usar um script para desinstalar o aplicativo de configuração do servidor existente e, em seguida, instale o aplicativo de configuração do servidor mais recente. Para obter mais informações sobre o uso dos scripts deployClusterSetup.py e UninstallSetup.py, consulte Implementando o Aplicativo de Configuração do Servidor no Deployment Manager em um Cluster do WebSphere Application Server. Alternativamente, é possível implementar o aplicativo de configuração do servidor no cluster ao invés de diretamente no Deployment Manager; não será necessário executar um script Jython se você implementar o aplicativo desta maneira. Após implementar o aplicativo de configuração do servidor no Deployment Manager, vá para a etapa 11.
    • Se você implementou o aplicativo de configuração do servidor do Rational Asset Manager diretamente em um servidor de aplicativos, atualize com.ibm.ram.repository.setup.web.ear para a versão mais recente que recuperou:
      1. Ative o console administrativo do WebSphere Application Server e efetue login como um administrador.
      2. Atualize o aplicativo de configuração do servidor do Rational Asset Manager:
        1. Clique em Aplicativos > Tipos de aplicativos.
        2. Clique em Aplicativos corporativos do WebSphere.
        3. Selecione com.ibm.ram.repository.setup.web.ear e, em seguida, clique em Atualizar.
        4. Digite ou navegue até o caminho e o nome do arquivo archive corporativo de configuração do servidor Rational Asset Manager (com.ibm.ram.repository.setup.web.ear).
        5. Nas próximas três páginas, clique em Avançar.
        6. Na página Resumo, clique em Concluir.
        7. Quando o arquivo com.ibm.ram.repository.setup.web.ear for instalado, clique em Salvar na Configuração Principal. O aplicativo de configuração do servidor está agora atualizado e implementado. Você usa o aplicativo de configuração do servidor para atualizar todos os outros aplicativos. Vá para a etapa 11.
    • Se você usar o WebSphere Application Server e não tiver o aplicativo de configuração do servidor (com.ibm.ram.repository.setup.web.ear) implementado, implemente o aplicativo com.ibm.ram.repository.setup.web.ear ao concluir as instruções em Implementando o Aplicativo de Configuração do Servidor no WebSphere Application Server. Se estiver implementando em um cluster, consulte Implementando o Aplicativo de Configuração do Servidor em um Cluster do Websphere Application Server. Você usa o aplicativo de configuração do servidor para atualizar todos os outros aplicativos. Depois de implementar o aplicativo de configuração do servidor, vá para a etapa 11.
  11. Depois de ter implementado a versão mais recente do aplicativo de configuração do servidor, em um navegador da Web, abra o aplicativo de configuração do servidor usando a URL:http://host:port/setup-server-context-root. A raiz de contexto padrão para o aplicativo da configuração do servidor é ram.setup. Se a segurança estiver ativada no servidor de aplicativos, digite o ID de usuário e a senha de um administrador do servidor de aplicativos.
  12. Na Etapa 1: Localize a seção Arquivos de Instalação, clique em Fornecer o diretório que contém os seguintes arquivos no servidor e digite o diretório no sistema de arquivos no servidor que está executando o aplicativo de configuração do servidor no qual os novos arquivos de aplicativo da web estão localizados. Se você usou o assistente de atualização no Installation Manager, os arquivos estão no diretório package_group_location/ram/apps/was. Estes arquivos devem estar em tal diretório:
    • com.ibm.ram.repository.web_runtime.ear
    • RTC-Server_401.zip
    • RTC-Server_3013.zip
    • ramhelp_war.ear
    • rmcabdgovernprocess_war.ear

    Observe que o arquivo rlsclients_rlsibmratl_812.zip está no diretório package_group_location/ram/SharedLibs.

    Se você implementou o aplicativo de configuração do servidor em um servidor de aplicativos que faz parte de um cluster e estiver acessando tal servidor de aplicativos, para fazer upload dos arquivos no servidor que está executando o aplicativo de configuração do servidor, clique em Fazer upload dos arquivos no servidor; em seguida, clique em Procurar e selecione cada um dos arquivos necessários.

  13. Para verificar se todos os arquivos de aplicativos necessários estão no diretório, ou para fazer upload deles para o servidor, clique em Verificar Arquivos de Instalação. Se você fez upload dos arquivos de aplicativos, o aplicativo de configuração do servidor os salva em um diretório temporário. Uma mensagem verifica se todos os arquivos necessários estão presentes.
  14. Clique em Atualizar. O aplicativo de configuração do servidor atualiza todos os outros arquivos de aplicativos do Rational Asset Manager com as versões mais recentes e mantém suas raízes de contexto, um processo que pode levar vários minutos. O aplicativo de configuração do servidor também remove o Rational Team Concert V2.0.0.2. A página de Introdução é aberta. Se você estiver implementando em um cluster e escolher a opção para usar o Rational Team Concert interno que é empacotado com o RAM, o Rational Team Concert deverá ser instalado em um cluster separado que possua apenas um servidor de aplicativos. Crie esse cluster se ainda não tiver feito isso. Em seguida, efetue logout e login no aplicativo de configuração do servidor para poder selecionar o cluster na lista para implementação do Rational Team Concert. Clique em Avançar para abrir a página Implementação. Clique em Implementar Aplicativos para implementar os aplicativos Rational Team Concert CCM e JTS, que são os componentes do servidor Rational Team Concert. Esse processo também pode demorar vários minutos porque ele extrai o Rational Team Concert 3.0.1.3 e o Rational Team Concert 4.0.1. Observe que o Rational Team Concert 3.0.1.3 é necessário para migrar o banco de dados do Rational Team Concert 2.0.0.2 para o Rational Team Concert 4.0.1. O banco de dados é primeiro migrado para o Rational Team Concert 3.0.1.3 e, em seguida, para o Rational Team Concert 4.0.1. Essa migração ocorre posteriormente no processo de configuração do servidor.
  15. Configure o banco de dados do Rational Team Concert. Na primeira página da seção Configurar Banco de Dados, selecione o banco de dados que você precisa para criar ou modificar. Três bancos de dados são necessários: um para gerenciar Ativos e dois bancos de dados adicionais que são usados para gerenciar os ciclos de vida. Geralmente, quando fizer upgrade de uma versão anterior a 7.5.1.2, selecione É necessário criar o banco de dados JTS do RTC. O banco de dados Jazz Team Server (JTS) é necessário para o Rational Team Concert 4. Siga as instruções no aplicativo de configuração do servidor para criar o banco de dados para seu software do servidor de banco de dados específico. Para aprender mais sobre como criar o banco de dados JTS, consulte os tópicos em Criando Bancos de Dados para Ciclos de Vida de Ativos. Após o banco de dados ter sido criado, migre o banco de dados do Rational Team Concert do Rational Team Concert 2.0.0.2 para o Rational Team Concert 4.0.1. Após especificar as informações corretas, clique em Migrar. Isso poderá levar um tempo significativo, até várias horas, para executar, dependendo do número de ativos, ciclos de vida e políticas. Uma janela de progresso indica as etapas que estão sendo executadas conforme o aplicativo de configuração do servidor executa os comandos.
  16. Continue com o aplicativo de configuração do servidor para configurar ou ajustar as definições do seu banco de dados e do servidor de aplicativos até chegar à Parte 4: Definir as Configurações de Heap do Java Virtual Memory. Selecione Médio ou Grande.
  17. Clique em Reiniciar o Servidor.
  18. Na página Configurar as definições de gerenciamento do ciclo de vida, digite o caminho e as informações de login para o aplicativo Rational Team Concert:
    1. Na Etapa 1, no campo Servidor Rational Team Concert, digite o caminho para o local do Rational Team Concert. No campo Jazz Team Server, digite o caminho para o local do Jazz Team Server. Você deverá usar uma conexão segura (https://). Por padrão, esses valores são:
      • Para um WebSphere Application Server existente: https://server_host:9443/ramccm e https://server_host:9443/ramjts para o Jazz Team Server.
      • Para um servidor Rational Team Concert externo: https://url:port/ccm e https://url:port/jts para o Jazz Team Server.
    2. Na Etapa 2, no campo ID do Administrador Jazz, digite o ID do usuário do administrador para o servidor Rational Team Concert (o padrão é admin); em seguida, no campo Senha, digite a senha para esse usuário (por padrão, é admin). Se o Rational Team Concert tiver acabado de ser instalado com o aplicativo de configuração do servidor, digite o nome de usuário e senha para o administrador do servidor de aplicativos.
    3. Na Etapa 3, no campo Nome da Área do Projeto, digite um nome descritivo para a área do projeto que será criada para os ciclos de vida (por exemplo, Ciclos de Vida do Rational Asset Manager). Em seguida, no campo D de Administrador da Área do Projeto, digite o ID do usuário que deverá ser o administrador da área do projeto. Em seguida, digite a Senha para esse usuário. Se você estiver usando um servidor Rational Team Concert externo, o administrador da Área do Projeto provavelmente será um usuário diferente do administrador do servidor Jazz. Se você estiver instalando um novo Rational Team Concert, o aplicativo de configuração do servidor sugerirá o uso do ID de Administrador do Jazz como o ID de Administrador da Área do Projeto.
    4. Clique em Configurar servidor. Este processo pode levar alguns minutos. Após a configuração, a página Resumo aparece.
  19. Na página Resumo, clique em Iniciar o uso de Rational Asset Manager. ou clique em Concluir. O Web client é aberto.
  20. Migre o repositório do Rational Asset Manager para a versão mais recente:
    1. Em um navegador da Web, abra o Web client do Rational Asset Manager. Na primeira vez que você abre o Web client após o upgrade, uma mensagem será exibida indicando que você deve migrar o repositório.
    2. Se necessário, efetue login com um ID do usuário que tenha autoridade do administrador de repositório.
      Nota: Para o SQL Server, se um banco de dados Rational Asset Manager existente não tiver o conjunto de ordenação para uma sequência que termina com _BIN2 (por exemplo, Latin1_General_BIN2), então a página Configuração Manual Necessária aparece com uma mensagem. É possível recriar o banco de dados e configurar a opção de ordenação com distinção entre maiúsculas e minúsculas para funcionar corretamente com o Rational Asset Manager ou é possível aceitar que pode haver conflitos de distinção entre maiúsculas e minúsculas inesperados.
    3. Clique em Migrar. Em grandes repositórios, a migração pode levar vários minutos; até que a migração seja concluída, algumas informações sobre o repositório podem não estar disponíveis.
    4. Após a conclusão do processo de migração, clique em Início.
  21. Opcional: Atualize o aplicativo Eclipse do Rational Asset Manager usando o mesmo método usado para sua instalação. Para obter mais informações sobre a instalação do cliente Eclipse, consulte Instalando o Cliente Eclipse do Rational Asset Manager.
    Nota: Antes de instalar a versão mais recente do cliente Eclipse do Rational Asset Manager, desinstale o plug-in do cliente Eclipse do Rational Asset Manager.

    Se você instalou os plug-ins do cliente Eclipse do Rational Asset Manager usando o Gerenciador de Atualização Eclipse, antes de instalar a versão mais recente do Rational Asset Manager, use o Gerenciador de Configuração Eclipse para remover todos os recursos com o nome Rational Asset Manager. Para usar o Gerenciador de Configuração Eclipse, no Eclipse, clique em Ajuda > Atualizações de Software > Gerenciar Configuração.

O que Fazer Depois

Para o Rational Asset Manager versão 7.5.1 e posterior, a URL para o servidor Rational Team Concert interno foi alterada de https://host:port/jazz para https://host:port/ramjazz. Se estiver fazendo upgrade de um release do Rational Asset Manager anterior à 7.5.1, revise as referências de URL e informe aos seus usuários sobre quais mudanças eles devem fazer.

Atualize as URLs nesses locais:
  • As conexões do repositório Rational Team Concert Eclipse IDE que usam a URL anterior. Para atualizar uma conexão de repositório:
    1. Abra a visualização Artefatos da Equipe.
    2. Expanda Conexões do Repositório.
    3. Clique com o botão direito do mouse na conexão do Rational Asset Manager e selecione Propriedades.
    4. Selecione Conexão do Repositório Jazz.
    5. No local do URI, altere a URL para http://host_name/ramjazz.
    6. Clique em OK.
  • As propriedades avançadas no servidor Rational Team Concert que usam a URL anterior. Para atualizar as propriedades avançadas:
    1. Abra o Rational Asset Manager em um navegador da web ao usar a URL revisada: http://host_name/ramjazz/admin
    2. Efetue logon como o administrador.
    3. Clique em Servidor > Configuração > Propriedades Avançadas.
    4. Atualize as propriedades que incluem a URL anterior. Por exemplo: com.ibm.ram.repository.service.internal.RepositoryRemoteService
  • Os links do Rational Asset Manager que estão armazenados nos marcadores nos navegadores da web.

Feedback