Migrando do WebSphere Studio V5.1, 5.1.1 ou 5.1.2

Esta documentação fornece instruções para migrar do WebSphere Studio Application Developer V5.1.x para o Rational Application Developer V6.0.

As informações sobre a utilização do Rational Application Developer podem ser encontradas na ajuda on-line.

Consulte www.ibm.com/developerworks/rational para obter a documentação atualizada.

Para obter informações sobre como migrar de versões anteriores do WebSphere Studio para a v5.x ou migrar do VisualAge para Java para o WebSphere Studio, vá para o endereço www.ibm.com/software/awdtools/studioappdev/support/ e procure o "guia de migração".

Para migrar do WebSphere Studio V5.1.x:
  1. Antes da instalação, leia sobre a compatibilidade com o Eclipse V2.x e WebSphere Studio V5.1.x. Observe que a compatibilidade com releases anteriores não é suportada para projetos de aplicativos de portlet migrados do Portal Toolkit V5.0.2.2 com o WebSphere Studio V5.1.2.
  2. Faça backup do espaço de trabalho do WebSphere Studio V5.1.x.
  3. Instale o Rational Application Developer. Consulte o Guia de Instalação (arquivo install.html) que está disponível na raiz do primeiro CD do produto.
  4. Recomendado: Por padrão, a primeira vez que você iniciar o Rational Application Developer, será solicitada a confirmação de que você deseja utilizar um espaço de trabalho denominado rationalsdp6.0\workspace. Ou seja, a caixa de diálogo Ativador do Espaço de Trabalho aponta para o diretório que não é seu espaço de trabalho do WebSphere Studio. Para explorar o novo ambiente antes de migrar seu espaço de trabalho antigo, aceite o padrão ou especifique algum outro novo nome de diretório ao iniciar o Rational Application Developer. Você pode fazer isso, por exemplo, para que possa criar um ou mais projetos de teste, ler sobre o que há de novo, (Ajuda > Bem-vindo), executar alguns dos novos tutoriais (Ajuda > Tutorials Gallery) ou fazer experiências com algumas das novas amostras (Ajuda > Samples Gallery).
  5. Migre seus projetos para a V6.0. Os projetos criados no WebSphere Studio V5.1.x podem ser migrados automaticamente para a V6.0 da seguinte forma:
    1. Migrando um espaço de trabalho: Quando você estiver pronto para migrar o espaço de trabalho da V5.1.x definitivamente, inicie o Rational Application Developer com o espaço de trabalho antigo. Um indicador de progresso confirma que seus projetos estão sendo migrados automaticamente.

      Notas: Durante a migração do espaço de trabalho, uma caixa de diálogo Problemas é aberta com a mensagem Não foi possível restaurar o layout do workbench. Razão: Ocorreram problemas na restauração do workbench. As mensagens de erro não têm nenhum impacto na migração bem-sucedida do espaço de trabalho. Observe o nome da perspectiva que não pôde ser restaurada clicando no botão Detalhes na caixa de diálogo de erro e, em seguida, clique em OK para fechar a caixa de diálogo.

      Para restaurar a perspectiva:
      1. Feche a perspectiva, selecionando Janela > Fechar Perspectiva
      2. Reabra a perspectiva, selecionando Janela > Abrir Perspectiva.
      Nota: Para projetos EGL (Enterprise Generation Language) que utilizavam a perspectiva da Web EGL no WebSphere Studio V5.1.2: esta perspectiva foi removida no Rational Application Developer V6.0. Todos os projetos EGL são migrados com segurança sem essa perspectiva no Rational Application Developer V6.0. Faça o seguinte se tiver utilizado a perspectiva da Web do EGL:
      1. Feche a perspectiva da Web do EGL.
      2. Ative as capacidades do EGL em Preferências (Janela > Preferências). Consulte a ajuda on-line para obter detalhes sobre como ativar as capacidades do EGL.
      3. Selecione Janela > Abrir Perspectiva e escolha a perspectiva da Web.
    2. Migrando projetos carregados de um sistema SCM (Source Code Management): Os projetos do WebSphere Studio 5.1.x que existem em um sistema SCM são automaticamente migrados para a V6.0 quando são carregados no Rational Application Developer.
    3. Migrando projetos importados utilizando o Intercâmbio de Projetos: Os projetos exportados do WebSphere Studio V5.1.2 ou V5.1.1 e importados para o Rational Application Developer V6.0 utilizando o recurso Intercâmbio de Projetos são automaticamente migrados para a V6.0. O recurso Intercâmbio de Projetos estava disponível no WebSphere Studio V5.1.2 e era um plug-in opcional para a V5.1.1.
    Notas:
    • Se você tiver utilizado o Portal Toolkit V5.0.2.2 com o WebSphere Studio V5.1.2 para desenvolver projetos de portlet, seu espaço de trabalho será migrado automaticamente para ser compatível com o Rational Application Developer. Consulte Migrando para o Portal Tools no Rational Application Developer V6.0 para obter informações adicionais.
    • Para cada projeto V5.1.x migrado para a V6.0, o programa de migração automaticamente inclui um arquivo .compatibility na pasta de projeto na V6.0. Esse arquivo é utilizado para a finalidade de compatibilidade com releases anteriores com o WebSphere Studio V5.1.x. Não edite ou exclua esse arquivo. Consulte a seção sobre compatibilidade com o WebSphere Studio V5.1.x para obter informações adicionais.
    Importante:
    • Se houver configurações de ativação de depuração associadas ao espaço de trabalho que está sendo migrado, observe que alguma configuração de ativação não será migrada automaticamente. Para obter informações sobre como restaurar as configurações de ativação para um espaço de trabalho migrado, consulte Alterações do Depurador na V6.0.
    • Se você utilizou o depurador XSLT ou o depurador EGL em projetos de seu espaço de trabalho migrado, será necessário alterar o JRE (Java Runtime Environment) instalado com o Rational Application Developer V6.0. Consulte Alterações do Depurador na V6.0 para obter detalhes sobre como fazer essa alteração.
    • Se você tiver programas desenvolvidos utilizando o Enterprise Generation Language que foram migrados para a V6.0, será necessário observar se há novas palavras reservadas para EGL na versão 6.0. Se você utilizar essas palavras como variáveis ou nomes de partes, será necessário alterá-las. Consulte Palavras Reservadas do EGL na V6.0
  6. O Driver JDBC de Rede do DB2 não é suportado no Rational Application Developer V6.0. Se tiver criado conexões JDBC utilizando o driver JDBC de Rede do DB2, não será possível reconectar ao Rational Application Developer V6.0. Será necessário alterar a conexão para utilizar um dos drivers JDBC suportados. Consulte a ajuda on-line para obter informações adicionais sobre os drivers JDBC suportados na V6.0.
  7. Se você tiver o conteúdo de arquivos da Web ou XML migrado a partir do WebSphere Studio Application Developer V5.1.x que utilizou o conjunto de caracteres Shift_JIS e incluiu caracteres selecionados do fornecedor, será necessário especificar o conjunto de caracteres Windows-31J.
  8. Se você tiver instalado plug-ins de fornecedores com o WebSphere Studio Application Developer V5.1.x, será necessário obter os plug-ins correspondentes para a V6.0 e reinstalá-los.
  9. Se você tiver instalado ambientes de teste de unidade do WebSphere de nível anterior ao instalar o Rational Application Developer e se você utilizar o serviço de sistema de mensagens incorporado, faça upgrade instalando a versão fornecida com o Rational Application Developer. Consulte o Guia de Instalação para obter detalhes sobre como instalar o serviço do sistema de mensagens incorporado.
  10. Se você utilizar recursos que exijam o Agent Controller, faça seu upgrade instalando a versão fornecida com o Rational Application Developer. Para obter detalhes, consulte o Guia de Instalação.
  11. Para migrar do VisualAge Generator, consulte o Guia de Migração do VisualAge Generator para EGL (Enterprise Generation Language) que está disponível no formato PDF na seção "Instalando e Migrando" da ajuda on-line no tópico de ajuda "Acessando o Guia de Migração do VisualAge Generator para EGL." A cópia mais recente pode ser obtida no endereço http://www.ibm.com/developerworks/rational/library/egldoc.html.

Conceitos relacionados
Compatibilidade com o WebSphere Studio V5.1.x

Tarefas relacionadas
Migrando Recursos JavaServer Faces em um Projeto da Web
Migrando Recursos Faces em um Projeto de Portlet
Migrando para o Portal Tools no Rational Application Developer V6.0

Referências relacionadas
Alterações do Depurador na V6.0
Migração do WDO para o SDO
Palavras Reservadas do EGL na V6.0
Alterações nos Ambientes de Teste do WebSphere

(C) Copyright IBM Corporation 2000, 2004. Todos os Direitos Reservados.