IBM WebSphere Development Studio Client para iSeries Versão 5.0 - Guia de Migração

• Se o projeto WebFacing já foi convertido utilizando a Versão 4.0 IDE, não será necessário reconverter o projeto, após a migração ser concluída.
• Se o projeto original tiver sido migrado a partir de WebSphere Development Tools Versão 5.1, será necessário reconverter o projeto.

Migrando projetos da Web do iSeries

Migrando projetos iSeries da Web da Versão 4.0 para a Versão 5.0

Esta seção descreve como migrar projetos iSeries da Web criados no Development Studio Client para iSeries da Versão 4.0 para a Versão 5.0.

As atividades de migração envolvem os seguintes estágios:

1. Migrando projetos utilizando uma área de trabalho V4.0.x existente.
2. Migrando a estrutura do projeto da Web para a estrutura de projeto J2EE 1.3

   Nota: Migrar o projeto da Web para J2EE 1.3 é opcional. Entretanto, o J2EE 1.2 não suporta JCA (Java Connector Achitecture).

3. Migrando o conteúdo do projeto iSeries Web Tools
4. Endereçando erros e avisos gerados como resultado da migração

Estágio 1: Migrando projetos utilizando um espaço de trabalho V4.0.x existente

Esta abordagem é parcialmente suportada e resultará em uma migração incompleta. As definições de interface do usuário, definições de depuração e a maioria das preferências serão todas perdidas. Os nomes de projeto, arquivos de origem de projeto e caminho de construção de projeto Java (caminho de classe) são retidos, mas nada mais é garantido. Assuma esta abordagem apenas se nenhum sistema SCM (Software Configuration Management) suportado estiver sendo utilizado e se for crítico para reter as informações do caminho de construção do projeto; isto será perdido quando você importar os projetos da Versão 4.0. Você pode utilizar a área de trabalho existente da Versão 4.0.x, fazendo o seguinte:

Antes da instalação

1. Depositar (liberar) quaisquer alterações pendentes no repositório.
2. Feche todas as perspectivas e encerre o produto da Versão 4.0.
3. Faça backup do conteúdo de workspace_directory, em que workspace_directory é o nome completo do diretório que contém o espaço de trabalho Versão 4.0.x. Por padrão, o subdiretório do espaço de trabalho Versão 4.0.x está localizado no mesmo diretório em que o produto está instalado. Você precisará deste backup se você desejar trabalhar com o produto Versão 4.0.x novamente. Uma vez que você tenha apontado para uma área de trabalho Versão 4.0.x de um IDE Versão 5.0, você não pode mais voltar a utilizar este área de trabalho no produto na Versão 4.0.x.
4. Instale o Development Studio Client para iSeries Versão 5.0.

1. Ao iniciar o produto da Versão 5.0 (Iniciar > Programas > IBM WebSphere Studio > Development Studio Client para iSeries), uma janela do WebSphere Studio se abre na qual você especifica o diretório a ser utilizado para a sessão. Especifique a localização do diretório de seu espaço de trabalho Versão 4.0.x nesta janela.
2. Quando solicitado a confirmar que você deseja converter o formato de interface do novo usuário, clique em OK.
3. Antes de fazer qualquer reconstrução ou validar quaisquer projetos que estão no espaço de trabalho, selecione todos os projetos na exibição Navegador dentro da perspectiva Recurso e então selecione Atualizar no menu pop-up. Isto assegura que todos os arquivos fiquem sincronizados com seus metadados apropriados.
4. Abra qualquer projeto fechado (consulte os problemas conhecidos abaixo).
5. Verifique suas variáveis de caminho da classe (consulte os problemas conhecidos abaixo).
6. Alguns construtores e validadores foram adicionados, removidos ou modificados nesta versão. Para garantir que todos os erros e avisos corretos sejam mostrados, você deve reconstruir todos os projetos, selecionando Projeto > Reconstruir Todos e, então, selecionar Executar Validação para cada projeto Java.
7. Algumas preferências do usuário podem ser mantidas, mas muitas outras não serão. Verifique suas definições de preferências na Versão 5.0 para assegurar que elas estejam conforme desejado.

Remoção Pós-migração das referências de caminho absoluto do EAR e da Configuração do Servidor

Os arquivos application.xml EAR Versão 4.0 e os arquivos de configuração do servidor continham referências de caminho absoluto. Após tê-los migrados na Versão 5.0, você precisará abri-los com seu editor (que altera automaticamente suas referências de caminho absoluto antigas em novas referências relativas).

1. Para cada projeto EAR, em uma exibição do Navegador, clique com o botão direito em META-INF/application.xml > Abrir com > Editor do Descritor de Implementação.
   1. Aparece uma janela de mensagem: "O caminho absoluto de um ou mais módulos foi alterado desde a última vez que este aplicativo foi salvo. . . Gostaria de autocorrigir?"
   2. Clique em Sim.
   3. Salve e, em seguida, feche a janela do editor.
2. Para cada configuração de servidor, em uma Perspectiva de Servidor, Exibição de Configuração do Servidor, clique com o botão direito no servidor > Abrir.
   1. Uma janela de autocorreção semelhante é aberta.
   2. Clique em Sim.
   3. Salve e, em seguida, feche a janela do editor.

Problemas e limitações conhecidas

Os seguintes problemas podem ocorrer se você tentar migrar, abrindo uma área de trabalho Versão 4.0 no produto Versão 5.0.

Valor incorreto na variável do caminho de classe JRE_LIB

Para redefinir sua variável de caminho de classe JRE_LIB em um local válido, siga estas etapas. Faça isto mesmo se os valores parecerem corretos quando você abrir a janela Preferências pela primeira vez.

1. Selecione Janela > Preferências > Java > JREs Instalados.
2. Na lista, selecione a caixa de opções para a localização padrão do JRE que você deseja definir para seu JRE_LIB.
3. Escolha Editar e, em seguida, clique em OK para fechar a caixa de diálogo Editar JRE.

Se você não fizer isto, o valor para JRE_LIB poderá estar incorreto, causando muitos erros de construção em arquivos Java.

Como uma verificação geral, verifique o valor de todas as suas outras variáveis de caminho de classe.

Para projetos SCM anteriormente compartilhados, o menu Equipe contém Compartilhar Projeto

A equipe de suporte foi significativamente alterada entre o Eclipse 1.0 e 2.0. O método de compartilhamento de projetos com o repositório também foi alterado.

• Se você selecionar a opção Equipe > Compartilhar Projeto, um assistente o guiará através do processo de migração. Quando você tiver concluído, seu projeto será compartilhado e a exibição Sincronizar será aberta. Você verá alterações conflitantes em cada arquivo. Isto é causado pelas alterações na forma que as informações de sincronização são armazenadas entre Eclipse 1.0 e 2.0.
• Se você não tiver nenhuma alteração de saída (que você não deve ter caso tenha consolidado todas as alterações de saída antes de fazer o upgrade conforme recomendado acima), então você pode, simplesmente, selecionar o projeto na exibição Sincronizar e selecione Substituir e Atualizar que carregará os conteúdos atuais do servidor.
• Se você tiver alterações de saída, é possível fazer pull down do menu triangular na exibição Sincronizar e selecionar Comparar Conteúdo de Arquivos. Após algum trabalho, a exibição Sincronizar mostrará apenas os arquivos que são realmente diferentes. Você pode, então, utilizar a exibição Sincronizar para resolver estes conflitos.

Projetos criados fora do diretório do espaço de trabalho

Por padrão, os projetos são criados no diretório de espaço de trabalho. Se você substituiu o padrão para criar projetos em outro lugar, abra todos os seus projetos agora antes de fechar o workbench. Isto permite que o arquivo .project para tal projeto seja gravado na localização correta. Falha ao abrir um projeto fechado cujo diretório está fora da área de trabalho resulta em um projeto que mascara o projeto real, com apenas um arquivo .project existente dentro dele.

Estágio 2: Migrando a estrutura do projeto da Web para a estrutura do projeto J2EE 1.3

Observe que o Assistente para Migração J2EE pode executar duas funções:

• Migrar a estrutura de projeto da Web ou J2EE da Versão 4.0 para a Versão 5.0.
• Migrar opcionalmente o J2EE nível 1.2 para o nível 1.3.

Para migrar para a estrutura do projeto J2EE,

1. Se ainda não estiver aberto, abra o IDE Versão 5.0, selecionando o produto no menu Iniciar > Programas.
2. No IDE, selecione Janela > Abrir Perspectiva > Web para abrir a perspectiva da Web.
3. Clique com o botão direito do mouse no nome do projeto na exibição Navegador J2EE da perspectiva da Web e selecione Migrar > Assistente de Migração J2EE.
4. Siga as instruções nas páginas do assistente. Se você pretende utilizar o suporte JCA (Java Connector Architecture), assegure-se de selecionar a caixa de opções Migrar projeto da versão nível J2EE 1.2 para J2EE 1.3.
5. Clique em Finalizar para migrar os projetos da Web selecionados.

Estágio 3: Migrando o conteúdo do projeto iSeries Web Tools

O processo de migração a seguir depende da migração bem-sucedida do projeto da Web para a estrutura do projeto J2EE descrito na seção anterior.

Para migrar o conteúdo do projeto iSeries Web Tools,

1. Clique com o botão direito do mouse no nome do projeto na perspectiva Web e selecione Migrar > Projeto das Ferramentas da Web do iSeries 4.0 para 5.0.
2. Importante: Feche e abra novamente o projeto neste ponto para evitar uma exceção relacionada à exclusão dos recursos.
3. A janela Confirmar Migração indica que a estrutura do projeto e os conteúdos serão migrados. Para continuar o processo, selecione OK.
4. A janela Informações de Progresso é aberta indicando que a operação de migração está acontecendo e mostrando o progresso de migração.
5. Na conclusão do processo de migração, uma janela de mensagens de Aviso, Erro ou Êxito indica os resultados da migração.
6. Se o processo de migração foi concluído com êxito, nenhuma outra ação será requerida. Se o processo de migração é concluído com erros ou avisos, prossiga para Endereçando erros e avisos gerados como um resultado da migração abaixo.

O processo de migração executa as seguintes ações:

• Converte todos os controles de tempo de design nos arquivos JSP para os campos e controles de novos Componentes da Web.
• Adiciona o arquivo de tempo de execução Apache Struts 1.02 e regeneração dos arquivos relacionados à interação na Web com base na estrutura struts dos arquivos .wit.

Estágio 4: Endereçando erros e avisos gerados como um resultado da migração

Se o processo de migração encontrar problemas, uma janela é aberta indicando que erros ou avisos ocorreram e que eles estão no arquivo log de migração projectName_MigrationDetails.txt no nome do projeto na perspectiva da Web.

A seção Resultado de Migração na parte superior do arquivo log de migração indica o status geral da migração e refere-se a um arquivo nas informações on-line que descrevem os erros e avisos e a ação requerida para corrigi-los.

Consulte também "Detalhes dos erros e avisos de migração" na ajuda on-line.

       Development Studio Client para iSeries >
aplicativos da Web >
      iSeries Web Development > Referência > Detalhes dos erros
e avisos de migração.

Migrando projetos da Web da pré-versão 4.0 do iSeries

Este tópico descreve como migrar do produto WebSphere Studio, utilizado com o WebSphere Development Tools para iSeries Versão 3.5. Este produto WebSphere Studio é conhecido como WebSphere Studio clássico ao longo deste tópico para distingui-lo das versões atuais do WebSphere Studio. Estas informações pertencem às edições Advanced e Professional do WebSphere Studio clássico.

Nota: As instruções a seguir são para a migração do WebSphere Studio clássico, Versão 4.0. Para migrar de uma versão anterior do WebSphere Studio clássico, você deve primeiro migrar para o WebSphere Studio clássico, Versão 4.0, antes de continuar.

Migrar do WebSphere Studio clássico envolve as seguintes etapas:

1. Criar um novo estágio de um único servidor para a migração.
2. Criar um arquivo descritor de configuração da Web.
3. Exportar um arquivo JAR de migração.
4. Importar o arquivo JAR de migração para o projeto da Web.
5. Concluir a migração do projeto iSeries Web.
6. Configurar o servidor e testar o aplicativo migrado.

Esteja ciente das seguintes limitações antes de migrar qualquer dado do WebSphere Studio clássico:

• O ambiente de desenvolvimento integrado na versão atual do WebSphere Studio utiliza um editor SQL baseado em XML; portanto, seus arquivos .sql não podem ser utilizados nele.
• As informações sobre a publicação do projeto e as etapas não podem ser migradas.
• As informações de configuração do servidor WebSphere Studio clássico não podem ser migradas.
• As informações sobre controle de versão não podem ser migradas.

Durante o processo de migração descrito a seguir, você cria um arquivo JAR que contém todos os seus arquivos de projeto, publicáveis e fonte, para um único servidor. Todos os arquivos visíveis na exibição Publicação para o servidor padrão serão empacotados no arquivo JAR. Em seguida, você pode importar o arquivo JAR em um projeto da Web no WebSphere Development Studio Client para iSeries, Versão 5.0.

Quando você migra projetos existentes, todas as informações sobre publicação e estágio do projeto são perdidas durante a migração. Se o seu estágio tiver vários servidores, somente os arquivos publicados no servidor padrão serão mantidos. Portanto, para a migração, você criará um novo estágio que tenha apenas um servidor.

Etapas da migração

Etapa 1 - Criar um novo estágio de um único servidor para a migração

Se você tiver mais de um servidor no estágio atual, crie um novo estágio chamado Migração com apenas um servidor, seguindo estas etapas:

1. Abra o projeto que você pretende migrar e clique no menu Projeto > Personalizar Estágio de Publicação.
2. Digite Migração no campo Nome do estágio.
3. Clique em Adicionar.
4. Clique em OK.
5. Clique no menu Projeto > Estágio de Publicação e selecione Migração na lista de estágios disponíveis.
6. Clique em Migração na exibição Publicação e, em seguida, clique no menu Inserir > Servidor.
7. Insira um nome do servidor, como localhost e clique em OK.
8. Opcional: Conclua esta tarefa se você tiver definido as informações de mapeamento de servlet, caso contrário, continue com a Etapa 2 abaixo. A alteração do servidor ou do estágio de publicação não propaga as informações de mapeamento do servlet para o WebSphere Application Server, Versão 4.0. Vá para a exibição Publicação e, para cada servlet, clique com o botão direito no servlet e selecione Propriedades. Na guia Publicação da janela Propriedades, insira o mapeamento real do servlet no campo Mapeamento de Servlet e clique em OK. O mapeamento de servlet é o padrão de URL para o servlet registrado no Servidor de Aplicativos.

Etapa 2 - Criar um arquivo descritor de configuração da Web

1. Na exibição Publicação, clique Projeto > Criar Arquivo Descritor de Configuração da Web.
2. Selecione todos os servlets necessários.
3. Selecione todos os arquivos TLD (descritor de biblioteca de marcação) necessários.
4. Clique em Criar.

O nome do arquivo descritor de configuração da Web está no formato serverName_web.xml. Para o servidor localhost, o nome do arquivo descritor de configuração da Web é localhost_web.xml. A menos que você tenha especificado uma localização diferente, o arquivo .xml será salvo no diretório WEB-INF.

Etapa 3 - Exportar um arquivo JAR de migração

1. Na exibição Publicação, clique com o botão direito no servidor localhost e clique no menu Propriedades > Publicação.
2. Insira um caminho da Web (raiz do contexto) no campo Caminho da Web Webapp. Esta entrada é utilizada como o nome do projeto da Web quando o projeto é criado no Development Studio Client para iSeries, Versão 5.0. Por exemplo, se você inserir myproj, isto será utilizado como o nome do projeto da Web na versão 5.0.
3. Clique em OK.
4. Na exibição Publicação, clique em Projeto > Criar Arquivo de Migração.
5. Verifique se localhost é o servidor selecionado.
6. Verifique se localhost_web.xml é o arquivo descritor de configuração da Web selecionado.
7. Clique em OK.
8. O nome do arquivo JAR está no formato serverName.jar. Para o servidor localhost, o nome do arquivo JAR é localhost.jar. Renomeie o arquivo, se desejar.
9. Especifique a localização para o arquivo JAR no campo Salvar em e clique em Salvar para criar o arquivo JAR.

Etapa 4 - Importar o arquivo JAR de migração para um projeto da Web

1. Inicie o WebSphere Development Studio Client para iSeries, Versão 5.0.
2. Clique no menu Janela > Abrir Perspectiva > Outro, selecione Web e clique em OK para abrir a perspectiva da Web.
3. Importe o arquivo JAR.
   1. Clique em Arquivo > Importar.
   2. Clique no arquivo WAR na janela Importar e clique em Avançar.
4. Na janela Importar Recursos de um Arquivo WAR,
   1. Insira o caminho completo e o nome do arquivo JAR no campo arquivo WAR. Por exemplo, se o nome do arquivo JAR for localhost.jar e estiver localizado em d:\myjar, insira d:\myjar\localhost.jar no campo arquivo WAR.
      Nota: Você deve importar o arquivo JAR utilizando a opção do arquivo WAR; caso contrário, ele não funcionará corretamente.
   2. Selecione o botão de opções Novo para o projeto da Web.
   3. No campo Novo nome do projeto, insira o nome Caminho da Web Webapp que você definiu acima na Etapa 3 como seu nome de projeto da Web. Este nome é adicionado automaticamente no campo Raiz do Contexto. Se não for adicionado, insira o nome do projeto no campo Raiz do Contexto.
   4. Selecione o botão de opções Novo para Projeto do aplicativo corporativo e insira um nome para o arquivo EAR. O arquivo EAR possui um nome padrão de DefaultEAR. Você pode alterar este nome para o identificar prontamente com seu novo projeto. Por exemplo, se o seu novo nome de projeto for myproj, você poderá nomear o arquivo EAR myprojEAR.
   5. Clique em Concluir para descompactar o arquivo JAR e criar o projeto da Web.
5. Para completar a inicialização do projeto da Web, execute o assistente do iSeries Web Tools Run-Time Configuration.
   1. Clique com o botão direito do mouse no nome do projeto da Web na exibição do Navegador J2EE e selecione Especificar a configuração do tempo de execução do iSeries Web Tool no menu.
   2. Clique em Concluir na página do assistente, sem inserir nada nos campos. Esta ação copia arquivos JAR requerido pelas ferramentas da Web do iSeries no Web-INF > lib no projeto Web.
6. Talvez haja várias referências não resolvidas ou arquivos de importação inexistentes. Eles aparecem na exibição Tarefas. Para corrigir, é preciso modificar o caminho de construção Java do projeto da Web:
   1. Clique com o botão direito no nome do projeto e clique em Propriedades para abrir a janela Propriedades.
   2. Clique em Caminho de Construção Java e clique na guia Bibliotecas.
   3. Clique em Adicionar JARs Externos.
   4. Importe os JARs necessários dos seguintes diretórios:
      x:\WS*D\runtimes\base_v5\lib,
      x:\WS*D\runtimes\aes_v4\lib e
      x:\WS*D\wstools\eclipse\plugins\com.ibm.etools.websphere.tools\runtime
      em que x:\WS*D é o diretório de instalação para o produto base.
7. Na exibição Navegador J2EE, clique com o botão direito no projeto e selecione Reconstruir Projeto.

Etapa 5 - Concluir a migração do projeto iSeries Web

Siga as tarefas descritas nos Estágios 2, 3 e 4 de Migrando projetos da Web iSeries da Versão 4.0 para concluir a migração do projeto:

1. Opcional: As tarefas no Estágio 2 não serão necessárias se você pretende executar o aplicativo da Web na Versão 4.x de WebSphere Application Server. Entretanto, se você deseja executar o seu aplicativo da Web no WebSphere Application Server, Versão 5.0, é necessário concluir as tarefas no Estágio 2 para migrar o projeto da Web de J2EE 1.2 para J2EE 1.3.
2. O Estágio 3 descreve como migrar o conteúdo do projeto da Web.
3. O Estágio 4 fornece informações sobre o endereçamento de erros e avisos que são gerados quando o conteúdo do projeto da Web é migrado.

Quando estas tarefas forem concluídas, passe para a Etapa 6 abaixo.

Etapa 6 - Teste seu aplicativo migrado em um servidor de testes

Agora você está pronto para testar seu aplicativo. Para testá-lo no servidor de teste padrão, siga estas etapas:

1. Clique com o botão direito na página inicial do aplicativo da Web.
2. Selecione Executar no Servidor.

Para testar o aplicativo em outros ambientes de tempo de execução do servidor, consulte a ajuda on-line do recurso Ferramentas do Servidor.

Migrando projetos iSeries da Versão 4.0 para a Versão 5.0

Se você ainda tiver o Development Studio Client para iSeries Versão 4.0 instalado:

Antes de desinstalar o Development Studio Client Versão 4.0, você deve exportar o conteúdo do projeto para a máquina host. Em seguida, instale o Development Studio Client Versão 5.0. Após a instalação, os projetos podem ser criados novamente, executando uma ação do Explorador de Sistema Remoto:

1. Na Versão 4.0, clique com o botão direito no Projeto iSeries e selecione Enviar Alterações. Isso deve fazer o upload de todas as alterações de código na biblioteca associada do referido projeto. (Se você não tiver certeza do host e da biblioteca que são o alvo deste projeto, clique com o botão direito no projeto e selecione Propriedades > Projeto iSeries.)
2. Feche a Versão 4.0 e desinstale-a.
3. Continue a instalação do Development Studio Client para iSeries Versão 5.0.

1. Na Versão 5.0, abra a perspectiva do Explorador de Sistema Remoto: Clique na Janela > Abrir Perspectiva > Explorador de Sistema Remoto.
2. Navegue até a biblioteca associada de seu Projeto iSeries. Esta biblioteca contém todo o código fonte do upload feito do projeto iSeries.
3. Selecione os arquivos físicos fonte nesta biblioteca que faziam parte do seu projeto iSeries, clique neles com o botão direito e selecione Disponibilizar Offline. Isso cria novamente o projeto iSeries que mapeia até essa biblioteca e faz download de todos os membros fonte localmente em seu projeto. Agora você pode continuar o desenvolvimento.

   Nota: selecionar Criar Projeto iSeries de uma biblioteca no Explorador de Sistema Remoto é outra forma rápida de criar novamente o seu projeto, mas isso não efetua download de nenhum membro fonte dessa biblioteca. Isto simplesmente cria e configura um projeto iSeries que mapeia até essa biblioteca e host.

Se você já instalou o Development Studio Client para iSeries Versão 5.0 e sabe que não efetuou upload de seus projetos no host remoto:

1. Ative a Versão 5.0.
2. No menu principal, clique em Janela > Abrir Perspectiva > Recurso. Clique em OK.
3. Crie um projeto simples, clicando em Arquivo > Novo > Outro > Simples > Projeto e o denomine Temp. Esse projeto é um contêiner para importar o projeto da Versão 4.0 na área de trabalho da Versão 5.0.
4. Selecione Arquivo > Importar > Sistema de Arquivos. Clique em Avançar.
5. Navegue até a sua antiga área de trabalho (por exemplo: X:\WDSC\WSSD\workspace, em que X é a unidade em que instalou a Versão 4.0) e importe o projeto que você quer criar novamente.
6. Crie um Projeto iSeries que mapeia até a biblioteca e o host do projeto da Versão 4.0 recém-importado.
   • Clique com o botão direito em qualquer local na exibição do Navegador e selecione Novo > Projeto > iSeries > Local > Projeto iSeries.
   • Se você não se lembra da biblioteca e do host, poderá localizar essas informações em um arquivo XML chamado .iseries_project_properties no projeto Temp.
7. Crie novamente os arquivos físicos de origem que existiam no projeto da Versão 4.0:
   • Clique em Arquivo > Novo > Outro > iSeries > Local > Arquivo Físico Fonte iSeries.
   • Se você não tiver certeza de quais eram o CCSID e o comprimento do registro de seus arquivos, essas informações podem ser localizadas em um arquivo XML chamado .iseries_srcpf_properties diretamente em cada arquivo físico fonte.
8. Agora arraste e solte os membros fonte do antigo projeto da Versão 4.0 até o novo projeto da Versão 5.0.
9. Exclua o projeto Temp, que você não mais precisa e abra a Perspectiva de Projetos iSeries: Clique em Janela > Abrir Perspectiva > Projetos iSeries.