Preparando Artefatos de Origem para Migração

Antes de migrar artefatos de origem para o WebSphere Integration Developer do WebSphere Studio Application Developer Integration Edition, primeiro, certifique-se de que tenha preparado corretamente seu ambiente.

As etapas a seguir descrevem como preparar seu ambiente antes de migrar artefatos de origem para o WebSphere Integration Developer do WebSphere Studio Application Developer Integration Edition:
  1. Certifique-se de ter uma cópia de backup do espaço de trabalho inteiro da 5.1 antes de tentar migrar.
  2. Reveja a seção de migração do Rational Application Developer Information Center para determinar a melhor maneira de migrar projetos específicos não-WBI no espaço de trabalho: http://publib.boulder.ibm.com/infocenter/rtnl0600/topic/ com.ibm.etools.rad.migration.doc/topics/tmigratefrom51x.html
  3. Reveja a seção Serviço da Web do Rational Application Developer Information Center para obter informações de segundo plano sobre a funcionalidade do serviço da Web fornecida pelo Rational Application Developer: http://publib.boulder.ibm.com/infocenter/rtnl0600/topic/com.ibm.webservices.rad.nav.doc/developingweb.html
  4. Certifique-se de que todos os recursos adequados do WebSphere Integration Developer estejam ativados. Se esses recursos não estiverem ativados, você não poderá ver as opções de menu que serão discutidas abaixo. Para ativar os recursos importantes:
    • No WebSphere Integration Developer, vá para o item de menu Janela e selecione Preferências.
    • Vá para Workbench e, em seguida, selecione a categoria Recursos.
    • Selecione todos os recursos nas seguintes categorias:
      • J2EE Avançado
      • Enterprise Java
      • Desenvolvedor de Integração
      • Java Developer
      • Web Developer (típico)
      • Web Service Developer
      • XML Developer
    • Clique em OK.
  5. Utilize um novo diretório de espaço de trabalho para o WebSphere Integration Developer. Não é recomendável abrir o WebSphere Integration Developer em um espaço de trabalho antigo do WebSphere Studio Application Developer Integration Edition que contenha projetos de serviço, pois esses projetos primeiro devem ser migrados para um formato que possa ser lido pelo WebSphere Integration Developer. As etapas recomendadas para isso são:
    1. Copie todos os projetos não de serviço do espaço de trabalho antigo para o novo. Não copie os projetos EJB, da Web e EAR 5.1 criados durante a geração do código de implementação para um projeto de serviço 5.1. O novo código de implementação da 6.0 será gerado outra vez automaticamente quando o módulo BI for construído.
    2. Abra o WebSphere Integration Developer no espaço de trabalho vazio e importe todos os projetos não de serviço clicando em Arquivo > Importar > Projeto Existente para o Espaço de Trabalho e selecione os projetos copiados para o novo espaço de trabalho.
      • Se o projeto for um projeto J2EE, então, você deverá migrá-lo para o nível 1.4 utilizando o assistente Rational Application Developer Migration:
        1. Clique com o botão direito do mouse no projeto e selecione Migração > Assistente de Migração do J2EE….
        2. Reveja as instruções de aviso na primeira página e clique em Avançar.
        3. Certifique-se de que o Projeto J2EE esteja marcado na lista Projetos. Deixe marcados Migrar estrutura do projeto e Migrar nível de especificação do J2EE. Escolha J2EE versão 1.4 e WebSphere Process Server v6.0 do Servidor de Destino.
        4. Selecione quaisquer outras opções que possam ser adequadas para seu projeto J2EE e clique em Concluir. Se essa etapa for concluída com êxito, você verá uma mensagem Migração concluída com êxito.
        5. Se houver erros no projeto J2EE após a migração, você deverá remover todas as entradas do caminho de classe que se referem aos arquivos .jar ou bibliotecas da v5 e incluir a Biblioteca do Sistema JRE e as bibliotecas de Destino do Servidor WPS no caminho de classe (discutido abaixo). Isso deverá remover a maioria dos erros ou todos.
      • Para projetos EJB do WebSphere Business Integration com Extended Messaging (CMM) ou CMP/A (Container Managed Persistence over Anything), os arquivos do descritor de Extensão Jar EJB da IBM devem ser migrados depois da importação do projeto da 5.1 para o espaço de trabalho da 6.0. Consulte "Migrando Projetos EJB do WebSphere Business Integration" para obter informações adicionais.
      • Corrija o caminho de classe para cada projeto não de serviço importado no espaço de trabalho. Para incluir as bibliotecas do JRE e do WebSphere Process Server no caminho de classe, clique com o botão direito do mouse no projeto importado e selecione Propriedades. Vá para a entrada Caminho de Construção Java e selecione a guia Bibliotecas. Então, faça o seguinte:
        1. Selecione Incluir biblioteca > Biblioteca do Sistema JRE > Alternar JRE - WPS Server v6.0 JRE > Concluir.
        2. Em seguida, selecione Incluir Biblioteca > Destino do Servidor WPS > Configurar Caminho de Classe do Servidor wps > Concluir.
  6. Para melhores resultados, antes de executar o assistente de Migração, vá para o item de menu Projeto e certifique-se de que Construir Automaticamente NÃO esteja marcado. O WebSphere Integration Developer é diferente do WebSphere Studio Application Developer Integration Edition porque as opções de implementação de serviço são especificadas no tempo de design. Quando o projeto for construído, o código de implementação será atualizado automaticamente nos projetos EJB e da Web gerados, portanto, não existe mais nenhuma opção para Gerar Código de Implementação manualmente.
  7. Para migrar totalmente os arquivos .bpel em um projeto de serviço, é necessário assegurar que todos os arquivos .wsdl e .xsd referidos pelos arquivos .bpel possam ser resolvidos em um projeto de integração de negócios no novo espaço de trabalho:
    • Se os arquivos .wsdl e/ou .xsd estiverem no mesmo projeto de serviço que o arquivo .bpel, nenhuma ação adicional será requerida.
    • Se os arquivos .wsdl e/ou .xsd estiverem em um projeto de serviço diferente daquele que você está migrando, os artefatos da 5.1 deverão ser reorganizados utilizando o WebSphere Studio Application Developer Integration Edition antes da migração. A razão para isso é que os projetos de Módulo do Business Integration podem não compartilhar artefatos. A seguir estão as duas opções para reorganizar os artefatos da 5.1:
      • No WebSphere Studio Application Developer Integration Edition, crie um novo projeto Java que mantenha todos os artefatos comuns. Coloque todos os arquivos .wsdl e .xsd compartilhados por mais de um projeto de serviço nesse novo projeto Java. Inclua uma dependência nesse novo projeto Java para todos os projetos de serviço que utilizam esses artefatos comuns. No WebSphere Integration Developer, crie um novo projeto de Biblioteca do Business Integration com o mesmo nome do projeto Java compartilhado da 5.1 antes de migrar qualquer um dos projetos de serviço. Copie manualmente os arquivos .wsdl e .xsd antigos do projeto Java compartilhado da 5.1 para esta nova pasta de projetos da Biblioteca de BI. Isso deve ser feito antes da migração dos projetos de serviço do BPEL.
      • Outra opção é manter uma cópia local desses artefatos .wsdl e .xsd compartilhados em cada projeto de serviço de forma que não existam dependências entre projetos de serviço.
    • Se os arquivos .wsdl e/ou .xsd estiverem em qualquer outro tipo de projeto (geralmente outros Projetos Java), será necessário criar um projeto de Biblioteca de Business Integration com o mesmo nome que o projeto 5.1. Você também deve configurar o caminho de classe do novo projeto de biblioteca, incluindo as entradas do projeto Java 5.1, se houver. Este tipo de projeto é útil para armazenar artefatos compartilhados.
Agora você está pronto para iniciar o processo de migração.
Tarefas relacionadas
Migrando Projetos de Serviço Utilizando o Assistente de Migração do WebSphere Integration Developer

Feedback
(C) Direitos Autorais IBM Corporation 2005, 2006. Todos os Direitos Reservados.