IBM WebSphere Development Studio Client para iSeries Versión 5.0 Guía de migración

Este tema explica cómo migrar los proyectos de IBM WebSphere Development Studio Client para iSeries(TM) Versión 4.0 o de WebSphere Development Tools V5R1M0.

Antes de empezar

Importante: si tiene actualmente WebSphere Development Studio Client para iSeries Versión 4.0 o WebSphere Development Tools V5R1M0 y desea instalar WebSphere Development Studio Client Versión 5.0, el proceso de instalación desinstalará la versión anterior del producto.

Antes de desinstalar Development Studio Client para iSeries Versión 4.0:

  1. Debe saber dónde está el área de trabajo de la versión 4.0. Si aceptó la ubicación por omisión cuando instaló la versión 4.0, el área de trabajo estará en el directorio X:\WDSC\WSSD\workspace, siendo X la unidad en la que ha instalado el producto. En caso contrario, lleve a cabo una de estas acciones:
  2. Haga copia de seguridad del área de trabajo de la versión 4.0. Si no lo hace, no podrá recuperar sus proyectos de la versión 4.0.
  3. Lea los apartados pertinentes de esta guía de migración. Hay más información para Antes de la instalación en los apartados individuales de la guía.

    La guía también está disponible después de la instalación. Puede encontrarla, por ejemplo, en X:\WDSC\install\help\migrate.html.

  4. Si desea más información sobre cómo puede verse afectada el área de trabajo o los proyectos debido a la migración a la versión 5.0, lea los apartados pertinentes de la guía de migración suministrada junto con el producto base WebSphere Studio. La ubicación de la guía depende de qué edición de Development Studio Client haya adquirido. La guía también está disponible después de la instalación en C:\Archivos de programa\IBM\WebSphere Studio\migrate.html, por ejemplo.

Migrar beans de llamada a programa de la versión 4.0 a la versión 5.0

Migrar valores del Explorador de Sistemas Remotos

Migrar los proyectos WebFacing

Migrar los proyectos Web de iSeries

Migrar los proyectos de iSeries de la versión 4.0 a la versión 5.0

Migrar beans de llamada a programa existentes en los proyectos Java(TM) y Web de iSeries de la versión 4.0 a la versión 5.0

Este apartado explica cómo migrar a la versión 5.0 los beans de llamada a programa creados en Development Studio Client para iSeries Versión 4.0.

Después de la instalación

Para los beans de llamada a programa existentes en un proyecto Java:

  1. Cuando inicia el producto de la versión 5.0 (Inicio > Programas > IBM WebSphere Studio > Development Studio Client para iSeries), se abre una ventana de WebSphere Studio en la que se especifica el directorio que hay que utilizar para la sesión. En esta ventana especifique la ubicación del directorio del área de trabajo de la versión 4.0.
  2. Cuando se le pida que confirme que desea convertir al formato de la nueva interfaz de usuario, pulse Aceptar.
  3. Elimine la vía de acceso de clases antigua cambiando la vía de construcción Java del proyecto.
    1. Pulse el proyecto Java con el botón derecho del ratón y seleccione Propiedades.
    2. En el panel de la izquierda, seleccione Vía de construcción Java.
    3. Seleccione la pestaña Bibliotecas; luego seleccione los siguientes archivos JAR y pulse Eliminar para eliminarlos de la vía de acceso de clases:
         ECLIPSE_HOME/plugins/com.ibm.etools.iseries.toolbox/runtime/jt400.jar
         ECLIPSE_HOME/plugins/com.ibm.etools.iseries.webtools/lib/wdt400rt.jar
         ECLIPSE_HOME/plugins/com.ibm.etools.websphere.runtime/lib/j2ee.jar
         ECLIPSE_HOME/plugins/com.ibm.etools.websphere.runtime/lib/xerces.jar
  4. Vuelva a ejecutar el asistente de llamada a programa en todos los archivos PCML.

Para los beans de llamada a programa existentes en un proyecto Web:

  1. Cuando inicia el producto de la versión 5.0 (Inicio > Programas > IBM WebSphere Studio > Development Studio Client para iSeries), se abre una ventana de WebSphere Studio en la que se especifica el directorio que hay que utilizar para la sesión. En esta ventana especifique la ubicación del directorio del área de trabajo de la versión 4.0.
  2. Cuando se le pida que confirme que desea convertir al formato de la nueva interfaz de usuario, pulse Aceptar.
  3. Utilice el asistente de migración J2EE para:
  4. Pulse el nombre del proyecto con el botón derecho del ratón en la perspectiva Web y seleccione Migrar > Proyecto de herramientas Web de iSeries de 4.0 a 5.0.
  5. Importante: en este momento, cierre el proyecto y vuelva a abrirlo para evitar que se produzca una excepción relacionada con la supresión de recursos.
  6. La ventana Confirmar Migración indica que se migrará la estructura y el contenido del proyecto. Para seguir realizando el proceso, pulse Aceptar.
  7. El proceso de migración eliminará los archivos wdt400rt.jar y wdt400tb.jar de la carpeta WEB-INF\lib y copiará los archivos iwdtrt.jar y jt400.jar de la versión 5.0 en la carpeta.
  8. Vuelva a ejecutar el asistente de llamada a programa en todos los archivos PCML.

Migrar valores del Explorador de Sistemas Remotos

Después de la instalación
  1. Cuando inicia el producto de la versión 5.0 (Inicio > Programas > IBM WebSphere Studio > Development Studio Client para iSeries), se abre una ventana de WebSphere Studio en la que se especifica el directorio que hay que utilizar para la sesión. En esta ventana especifique la ubicación del directorio del área de trabajo de la versión 4.0.
  2. Cuando se le pida que confirme que desea convertir al formato de la nueva interfaz de usuario, pulse Aceptar.
  3. En el menú principal, pulse Ventana > Preferencias.
  4. En el panel de la izquierda, expanda Editor LPEX y seleccione Analizadores.
  5. En el panel de la derecha, seleccione ILErpg. En el campo Nombre de clase situado en la parte inferior, cambie el nombre de la clase por com.ibm.etools.iseries.editor.ISeriesEditorRPGILEParser. Pulse Establecer.
  6. En el panel de la derecha, seleccione rpg. En el campo Nombre de clase situado en la parte inferior, cambie el nombre de la clase por com.ibm.etools.iseries.editor.ISeriesEditorRPGOPMParser. Pulse Establecer.
  7. Pulse Aplicar. Pulse Aceptar.

Migrar los proyectos WebFacing

Si tiene proyectos WebFacing de WebSphere Development Studio Client Versión 4.0 o WebSphere Development Tools Versión 5.1, puede migrarlos a la versión 5.0 mediante el asistente de importación. Siga estos pasos:

Después de la instalación

  1. Seleccione Archivo > Importar.
  2. Elija Proyectos WebFacing. Pulse Siguiente.
  3. Pulse Examinar para ir a la carpeta que contiene los proyectos WebFacing que desea migrar a la versión 5.0. Pulse Siguiente.
    Nota:
    • Cuando actualiza desde la versión 4.0, los proyectos WebFacing siguen estando disponibles en el directorio workspace original de la versión 4.0. A menos que haya cambiado la ubicación por omisión del área de trabajo y en función de la vía de acceso de directorio que eligió al instalar la versión 4.0, podrá encontrar el directorio workspace en una ubicación como X:\WDSC\WSSD\workspace.
    • Cuando actualiza desde WebSphere Development Tools Versión 5.1, en función de la vía de acceso de directorio que eligió al instalar la versión 5.1, podrá encontrar los proyectos WebFacing en una ubicación como X:\WDT\WebFacing\eclipse.
  4. Los proyectos WebFacing que encuentre el asistente figurarán en el panel Proyectos WebFacing encontrados. Seleccione los proyectos que desea importar. El asistente creará un archivo EAR del proyecto. Los archivos EAR son archivos de archivado de aplicación de empresa J2EE. Por omisión, el archivo EAR tendrá el nombre del proyecto WebFacing con el sufijo _EAR. Si desea utilizar un nombre distinto o si se propone consolidar varios proyectos en un solo archivo EAR, puede cambiar el nombre en el campo Proyecto de aplicación de empresa.
  5. Pulse Finalizar. El proyecto migrará al área de trabajo de la versión 5.
  6. Para ver el proyecto en la perspectiva WebFacing, seleccione Ventana > Abrir perspectiva > WebFacing.
Nota:
  • Si el proyecto WebFacing ya ha sido convertido mediante el IDE de la versión 4.0, no hace falta volver a convertirlo una vez finalizada la migración.
  • Si el proyecto original ha migrado de WebSphere Development Tools Versión 5.1, tendrá que volver a convertirlo.

Migrar los proyectos Web de iSeries

Migrar proyectos Web de iSeries de la versión 4.0 a la versión 5.0

Este apartado explica cómo migrar a la versión 5.0 los proyectos Web de iSeries creados en Development Studio Client para iSeries Versión 4.0.

Las actividades de migración constan de las siguientes etapas:

  1. Migrar los proyectos utilizando un área de trabajo existente en V4.0.x
  2. Migrar la estructura del proyecto Web a la estructura del proyecto J2EE 1.3

    Nota: la migración del proyecto Web a J2EE 1.3 es una actividad opcional. Sin embargo, en J2EE 1.2 no está soportada la arquitectura de conectores J2EE (JCA).

  3. Migrar el contenido del proyecto de herramientas Web de iSeries
  4. Tener en cuenta los errores y los avisos generados a causa de la migración

Etapa 1: migrar los proyectos utilizando un área de trabajo existente en V4.0.x

Este enfoque está parcialmente soportado y de él se deriva una migración incompleta. Se pierden los valores de la interfaz de usuario, los valores de depuración y la mayoría de las preferencias. Se conservan los nombres de los proyectos, los archivos fuente de los proyectos y la vía de construcción Java (vía de acceso de clases) de los proyectos, pero no hay ninguna garantía de que se conserve lo demás. Solo debe tomar este enfoque si no se está utilizando ningún sistema de gestión de configuraciones de software (SCM) soportado y si es esencial conservar la información sobre la vía de construcción de los proyectos, la cual se pierde al importar los proyectos de la versión 4.0. Puede utilizar el área de trabajo existente en la versión 4.0.x siguiendo estos pasos:

Antes de la instalación

  1. Comprometa (libere) en el depósito los cambios que estén pendientes.
  2. Cierre todas las perspectivas y concluya el producto de la versión 4.0.
  3. Haga copia de seguridad del contenido de directorio_workspace, siendo directorio_workspace el nombre totalmente calificado del directorio que contiene el área de trabajo de la versión 4.0.x. Por omisión, el subdirectorio workspace de la versión 4.0.x está situado en el mismo directorio que aquel en el que está instalado el producto. Necesitará esta copia de seguridad por si alguna vez desea volver a trabajar con el producto de la versión 4.0.x. Una vez que haya señalado hacia un área de trabajo de la versión 4.0.x desde un IDE de la versión 5.0, ya no podrá hacer marcha atrás para utilizar esa área de trabajo en el producto de la versión 4.0.x.
  4. Instale Development Studio Client para iSeries Versión 5.0.
Después de la instalación
  1. Cuando inicia el producto de la versión 5.0 (Inicio > Programas > IBM WebSphere Studio > Development Studio Client para iSeries), se abre una ventana de WebSphere Studio en la que se especifica el directorio que hay que utilizar para la sesión. En esta ventana especifique la ubicación del directorio del área de trabajo de la versión 4.0.x.
  2. Cuando se le pida que confirme que desea convertir al formato de la nueva interfaz de usuario, pulse Aceptar.
  3. Antes de realizar tareas de reconstrucción o de validar los proyectos que estén en el área de trabajo, seleccione todos los proyectos existentes en la vista Navegador, en la perspectiva Recursos, y luego seleccione Renovar en el menú emergente. Esto hace que todos los archivos se sincronicen con los correspondientes metadatos.
  4. Abra los proyectos que estén cerrados (vea el apartado de problemas conocidos, más abajo).
  5. Verifique las variables de vía de acceso de clases (vea el apartado de problemas conocidos, más abajo).
  6. En esta versión se han añadido, eliminado o modificado algunos constructores y validadores. Para asegurarse de que se muestran los errores y avisos correctos, debe reconstruir todos los proyectos seleccionando Proyecto > Reconstruir todo, y luego seleccione Ejecutar validación para cada proyecto Java.
  7. Puede ser que se mantengan algunas preferencias del usuario, pero hay otras muchas que no se mantendrán. Compruebe los valores de sus preferencias en la versión 5.0 para asegurarse de que son tal como las que quiere.

Eliminación tras la migración de las referencias a vías de acceso absolutas de los archivos EAR y de configuración de servidor

Los archivos EAR application.xml y los archivos de configuración de servidor de la versión 4.0 contenían referencias a vías de acceso absolutas. Después de haberlos migrado a la versión 5.0, tendrá que abrirlos con el correspondiente editor (que cambia automáticamente las antiguas referencias a vías de acceso absolutas en nuevas referencias relativas).

  1. Para cada proyecto EAR, vaya a una vista Navegador y, con el botón derecho del ratón, pulse META-INF/application.xml > Abrir con > Editor de descriptor de despliegue.
    1. Se abre una ventana con el siguiente mensaje: "La vía absoluta de uno o más módulos ha cambiado desde la última vez que se ha guardado esta aplicación . . . ¿Desea corregirla automáticamente?"
    2. Pulse .
    3. Guarde y luego cierre la ventana del editor.
  2. Para cada configuración de servidor, vaya a una vista Configuración de servidor, en una perspectiva Servidores, y pulse con el botón derecho del ratón el servidor > Abrir.
    1. Se abre una ventana similar de corrección automática.
    2. Pulse .
    3. Guarde y luego cierre la ventana del editor.

Problemas conocidos y limitaciones

Si intenta migrar abriendo un área de trabajo de la versión 4.0 en el producto de la versión 5.0, pueden producirse los problemas que se indican a continuación.

Valor incorrecto en la variable de vía de acceso de clases JRE_LIB

Para restablecer la variable de vía de acceso de clases JRE_LIB en una ubicación válida, siga estos pasos. Sígalos aunque el valor parezca correcto cuando abra por primera vez la ventana Preferencias.

  1. Seleccione Ventana > Preferencias > Java > JRE instalados.
  2. En la lista, marque el recuadro de selección de la ubicación de JRE por omisión en la que desea establecer la variable JRE_LIB.
  3. Elija Editar y después pulse Aceptar para cerrar el diálogo Editar JRE.

Si no lo hace, el valor de JRE_LIB podría ser incorrecto, lo que provocaría muchos errores de construcción en los archivos Java.

Como comprobación general, verifique el valor de las demás variables de vía de acceso de clases.

Para los proyectos SCM compartidos anteriormente, el menú Equipo contiene Compartir proyecto

El soporte de equipo ha cambiado notablemente entre Eclipse 1.0 y 2.0. También ha cambiado el método de compartir proyectos con el depósito.

  • Si selecciona la opción Equipo > Compartir proyecto, aparecerá un asistente que le orientará en el proceso de migración. Cuando haya terminado, su proyecto estará compartido y se abrirá la vista Sincronizar. Verá cambios conflictivos en cada archivo. Ello se debe a los cambios que afectan a cómo se almacena la información de sincronización en Eclipse 1.0 y 2.0.
  • Si no tiene cambios salientes (no los tendrá si los comprometió todos antes de actualizar, según las recomendaciones anteriores), basta con que tan solo seleccione el proyecto en la vista Sincronizar y luego seleccione Alterar temporalmente y actualizar, lo que cargará el contenido actual a partir del servidor.
  • Si tiene cambios salientes, puede desplegar el menú del triángulo en la vista Sincronizar y seleccionar Comparar contenido de archivo. Se llevará a cabo un proceso y después en la vista Sincronizar solo figurarán los archivos que realmente presenten diferencias. Entonces, la vista Sincronizar le permitirá resolver estos conflictos.

Proyectos creados fuera del directorio workspace

Por omisión, los proyectos se crean en el directorio workspace. Si altera temporalmente el valor por omisión para que los proyectos se creen en otro lugar, abra ahora todos los proyectos antes de cerrar el entorno de trabajo. Esto permite que el archivo .project de ese proyecto se escriba en la ubicación pertinente. Si no se puede abrir un proyecto cerrado cuyo directorio esté fuera del área de trabajo, se obtendrá un proyecto que enmascara el proyecto real, y en él solo existirá un archivo .project.

Etapa 2: migrar la estructura del proyecto Web a la estructura del proyecto J2EE 1.3

Fíjese en que el asistente Migración J2EE puede llevar a cabo dos funciones:

  • Migrar la estructura del proyecto Web o la estructura del proyecto J2EE de la versión 4.0 a la versión 5.0.
  • Migrar, opcionalmente, el nivel 1.2 al nivel 1.3 de J2EE.

Para migrar la estructura del proyecto J2EE:

  1. Si todavía no está abierto, abra el IDE de la versión 5.0 seleccionando el producto en el menú Inicio > Programas.
  2. En el IDE, seleccione Ventana > Abrir perspectiva > Web para abrir la perspectiva Web.
  3. Pulse el nombre del proyecto con el botón derecho del ratón en la vista Navegador J2EE de la perspectiva Web y seleccione Migrar > Asistente de migración J2EE.
  4. Siga las instrucciones que figuran en las páginas del asistente. Si se propone utilizar el soporte JCA (arquitectura de conectores J2EE), debe marcar el recuadro de selección Migrar proyecto del nivel de versión J2EE 1.2 a J2EE 1.3.
  5. Pulse Finalizar para migrar los proyectos Web seleccionados.

Etapa 3: migrar el contenido del proyecto de herramientas Web de iSeries

El siguiente proceso de migración depende de la migración satisfactoria de la estructura del proyecto Web a la estructura del proyecto J2EE, tal como se ha explicado en el apartado anterior.

Para migrar el contenido del proyecto de herramientas Web:

  1. Pulse el nombre del proyecto con el botón derecho del ratón en la perspectiva Web y seleccione Migrar > Proyecto de herramientas Web de iSeries de 4.0 a 5.0.
  2. Importante: en este momento, cierre el proyecto y vuelva a abrirlo para evitar que se produzca una excepción relacionada con la supresión de recursos.
  3. La ventana Confirmar Migración indica que se migrará la estructura y el contenido del proyecto. Para seguir realizando el proceso, pulse Aceptar.
  4. Se abre la ventana Información de Progreso, para indicar que se está realizando la operación de migración y mostrar cómo avanza el proceso.
  5. Al terminarse el proceso de migración, aparece una ventana con un mensaje de aviso, error o éxito para indicar el resultado de la migración.
  6. Si el proceso de migración se ha llevado a cabo satisfactoriamente, no hay que hacer nada más. Si el proceso de migración se ha llevado a cabo con errores o avisos, continúe en el apartado Resolver errores y avisos generados como resultado de la migración, más abajo.

El proceso de migración lleva a cabo las acciones siguientes:

  • Convierte todos los controles de tiempo de diseño existentes en los archivos JSP en los nuevos campos y controles de componentes Web.
  • Añade el archivo de tiempo de ejecución de Apache Struts 1.02 y la regeneración de archivos relacionados con interacción Web y basados en la infraestructura struts a partir de los archivos .wit.

Etapa 4: tener en cuenta los errores y los avisos generados a causa de la migración

Si surgen problemas en el proceso de migración, se abre una ventana que indica que se han producido errores o avisos y que están en el archivo de anotaciones de migración que se llama nombreProyecto_MigrationDetails.txt, bajo el nombre del proyecto en la perspectiva Web.

La sección de resultados de la migración situada en la parte superior del archivo de anotaciones de migración indica el estado global de la migración y hace referencia a un archivo de la información en línea que describe los errores y avisos, y proporciona la acción correctora.

Vea asimismo el apartado "Detalles de errores y avisos de migración", en la ayuda en línea:

       Development Studio Client para iSeries > Aplicaciones Web >
Desarrollo Web de iSeries > Referencia > Detalles de errores y avisos de migración. 

Migrar los proyectos Web de iSeries anteriores a la versión 4.0

Este tema explica cómo migrar del producto WebSphere Studio que se utilizó con WebSphere Development Tools para iSeries Versión 3.5. A este producto WebSphere Studio se le conoce en este tema como WebSphere Studio clásico para distinguirlo de las versiones actuales de WebSphere Studio. Esta información atañe a las ediciones Advanced y Professional de WebSphere Studio clásico.

Nota: las siguientes instrucciones sirven para migrar de WebSphere Studio clásico, Versión 4.0. Si desea migrar de una versión anterior de WebSphere Studio clásico, primero deberá migrar a WebSphere Studio clásico, Versión 4.0 para poder continuar.

El proceso de migración de WebSphere Studio clásico consta de los siguientes pasos:

  1. Crear una nueva etapa de un solo servidor para la migración.
  2. Crear un archivo descriptor de configuración Web.
  3. Exportar un archivo JAR de migración.
  4. Importar el archivo JAR de migración a un proyecto Web.
  5. Llevar a cabo la migración del proyecto Web de iSeries.
  6. Configurar el servidor y probar la aplicación migrada.

Antes de migrar datos de WebSphere Studio clásico, debe tener presentes las siguientes limitaciones:

  • El entorno de desarrollo integrado (IDE) de la versión actual de WebSphere Studio utiliza un editor SQL basado en XML y esto impide que en él se puedan utilizar los archivos .sql.
  • La información de publicación del proyecto y la información de etapa no se puede migrar.
  • La información de configuración de servidor de WebSphere Studio clásico no se puede migrar.
  • La información de control de versión no se puede migrar.

Durante el proceso de migración indicado más abajo, creará un archivo JAR que contiene todos los archivos de proyecto, publicables y fuente, correspondientes a un solo servidor. Todos los archivos visibles en la vista Publicación del servidor por omisión se empaquetan en el archivo JAR. Después puede importar el archivo JAR a un proyecto Web de WebSphere Development Studio Client para iSeries, Versión 5.0.

Al migrar proyectos existentes, toda la información de publicación y etapa de los proyectos se pierde durante la migración. Si la etapa tiene múltiples servidores, solo se conservan los archivos publicados en el servidor por omisión. Por lo tanto, con vistas a la migración, creará una nueva etapa que solo tenga un servidor.

Pasos de migración

Paso 1: crear una nueva etapa de un solo servidor para la migración

Si tiene más de un servidor en la etapa actual, cree una nueva etapa que se llame Migración y que solo conste de un servidor; para ello, siga estos pasos:

  1. Abra el proyecto que se propone migrar y pulse el menú Proyecto > Personalizar etapas de publicación.
  2. Teclee Migración en el campo Nombre de etapa.
  3. Pulse Añadir.
  4. Pulse Aceptar.
  5. Pulse el menú Proyecto > Etapa de publicación y seleccione Migración en la lista de etapas disponibles.
  6. Pulse Migración en la vista Publicación; después pulse el menú Insertar > Servidor.
  7. Escriba el nombre de un servidor, como puede ser localhost, y pulse Aceptar.
  8. Opcional: realice esta tarea si tiene definida información de correlación de servlet; de lo contrario, vaya directamente al Paso 2, más abajo. El hecho de cambiar el servidor o la etapa de publicación no hace que se propague la información de correlación de servlet de WebSphere Application Server, Versión 4.0. Vaya a la vista Publicación, pulse cada uno de los servlets y seleccione Propiedades. En la pestaña Publicación de la ventana Propiedades, escriba la correlación de servlet real en el campo Correlación de servlet y pulse Aceptar. La correlación de servlet es el patrón de URL del servlet registrado en el servidor de aplicaciones.

Paso 2: crear un archivo descriptor de configuración Web

  1. Mientras está en la vista Publicación, pulse Proyecto > Crear archivo descriptor de configuración Web.
  2. Seleccione todos los servlets necesarios.
  3. Seleccione todos los archivos descriptores de biblioteca de códigos (TLD) necesarios.
  4. Pulse Crear.

El nombre del archivo descriptor de configuración Web tiene el formato nombreServidor_web.xml. En el caso del servidor localhost, el nombre del archivo descriptor de configuración Web es localhost_web.xml. A menos que haya especificado una ubicación distinta, el archivo .xml se guarda en el directorio WEB-INF.

Paso 3: exportar un archivo JAR de migración

  1. Mientras está en la vista Publicación, pulse el servidor localhost con el botón derecho del ratón y elija el menú Propiedades > Publicación.
  2. Escriba una vía Web (raíz de contexto) en el campo Vía Web de aplicación Web. Esta entrada se emplea como nombre del proyecto Web cuando se crea el proyecto en Development Studio Client para iSeries, Versión 5.0. Por ejemplo, si escribe miproy, este será el nombre del proyecto Web en la versión 5.0.
  3. Pulse Aceptar.
  4. Mientras está en la vista Publicación, pulse Proyecto > Crear archivo de migración.
  5. Verifique que localhost es el servidor seleccionado.
  6. Verifique que localhost_web.xml es el archivo descriptor de configuración Web seleccionado.
  7. Pulse Aceptar.
  8. El nombre del archivo JAR tiene el formato nombreServidor.jar. En el caso del servidor localhost, el nombre del archivo JAR es localhost.jar. Cambie el nombre del archivo si lo desea.
  9. Especifique la ubicación del archivo JAR en el campo Guardar en y pulse Guardar para crear el archivo JAR.

Paso 4: importar el archivo JAR de migración a un proyecto Web.

  1. Inicie WebSphere Development Studio Client para iSeries, Versión 5.0.
  2. Pulse el menú Ventana > Abrir perspectiva > Otras, seleccione Web y pulse Aceptar para abrir la perspectiva Web.
  3. Importe el archivo JAR.
    1. Pulse Archivo > Importar.
    2. Pulse Archivo WAR en la ventana Importar; después pulse Siguiente.
  4. En la ventana Importar recursos a partir de un archivo WAR:
    1. Escriba la vía de acceso completa y el nombre del archivo JAR en el campo Archivo WAR. Por ejemplo, si el archivo JAR se llama localhost.jar y está situado en d:\mijar, escribiría d:\mijar\localhost.jar en el campo Archivo WAR.
      Nota: debe importar el archivo JAR utilizando la opción de archivo WAR; de lo contrario no funcionaría correctamente.
    2. Marque el botón de selección Nuevo correspondiente al proyecto Web.
    3. En el campo Nombre de proyecto nuevo, escriba el nombre de la vía Web de aplicación Web que definió en el Paso 3 anterior como nombre de proyecto Web. Este nombre se añade automáticamente al campo Raíz de contexto. Si no se añade, escriba el nombre del proyecto en el campo Raíz de contexto.
    4. Marque el botón de selección Nuevo correspondiente a Proyecto de aplicación de empresa y escriba un nombre para el archivo EAR. El archivo EAR tiene por omisión el nombre DefaultEAR. Puede cambiar este nombre de manera que le resulte más fácil identificarlo con el proyecto nuevo. Por ejemplo, si el nombre del proyecto nuevo es miproy, puede hacer que el nombre del archivo EAR sea miproyEAR.
    5. Pulse Finalizar para desempaquetar el archivo JAR y crear el proyecto Web.
  5. Para llevar a cabo la inicialización del proyecto Web, ejecute el asistente Configuración de tiempo de ejecución de herramientas Web de iSeries.
    1. Pulse el nombre del proyecto Web con el botón derecho del ratón en la vista Navegador J2EE y seleccione Especificar configuración de tiempo de ejecución de herramientas Web de iSeries.
    2. Pulse Finalizar en la página del asistente sin entrar nada en los campos. Esta acción hace que los archivos JAR que se necesitan en las herramientas Web de iSeries se copien en Web-INF > lib, en el proyecto Web.
  6. Es posible que queden varias referencias sin resolver o que falten archivos de importación. Los verá en la vista Tareas. Para solucionarlo, debe modificar la vía de construcción Java del proyecto Web:
    1. Pulse el nombre del proyecto con el botón derecho del ratón y elija Propiedades para abrir la ventana Propiedades.
    2. Pulse Vía de construcción Java y, después, la pestaña Bibliotecas.
    3. Pulse Añadir JAR externos.
    4. Importe los JAR que necesita de los siguientes directorios:
      x:\WS*D\runtimes\base_v5\lib,
      x:\WS*D\runtimes\aes_v4\lib y
      x:\WS*D\wstools\eclipse\plugins\com.ibm.etools.websphere.tools\runtime
      Aquí, x:\WS*D es el directorio de instalación del producto base.
  7. En la vista Navegador J2EE, pulse el proyecto con el botón derecho del ratón y seleccione Reconstruir proyecto.

Paso 5: llevar a cabo la migración del proyecto Web de iSeries

Para llevar a cabo la migración del proyecto, realice las tareas descritas en las etapas 2, 3 y 4 de Migrar los proyectos Web de iSeries de la versión 4.0:

  1. Opcional: las tareas de la etapa 2 no son necesarias si se propone ejecutar la aplicación Web en la versión 4.x de WebSphere Application Server. Sin embargo, si desea ejecutar la aplicación Web en WebSphere Application Server, Versión 5.0, tendrá que llevar a cabo las tareas de la etapa 2 para migrar el proyecto Web de J2EE 1.2 a J2EE 1.3.
  2. La etapa 3 describe cómo migrar el contenido del proyecto Web.
  3. La etapa 4 proporciona información sobre cómo resolver los errores y avisos generados al migrar el contenido del proyecto Web.

Una vez terminadas estas tareas, vaya al Paso 6, más abajo.

Paso 6: probar la aplicación migrada en un servidor de prueba

Ahora ya está listo para probar su aplicación. Para probarla en el servidor de prueba por omisión, siga estos pasos:

  1. Con el botón derecho del ratón, pulse la página inicial de la aplicación Web.
  2. Seleccione Ejecutar en servidor.

Para probar su aplicación en otros entornos de tiempo de ejecución de servidor, consulte la ayuda en línea de la característica Server Tools.

Migrar los proyectos de iSeries de la versión 4.0 a la versión 5.0

Si aún tiene instalado Development Studio Client para iSeries Versión 4.0:

Antes de desinstalar Development Studio Client Versión 4.0, debe exportar el contenido del proyecto a la máquina de sistema principal. Entonces instale Development Studio Client Versión 5.0. Tras la instalación, es posible volver a crear los proyectos ejecutando una acción desde el Explorador de Sistemas Remotos:

Antes de la instalación
  1. En la versión 4.0, pulse el proyecto de iSeries con el botón derecho del ratón y seleccione Enviar cambios. Esto hará que se carguen todos los cambios de código en la biblioteca asociada de ese proyecto. (Si no está seguro de cuáles son el sistema principal y la biblioteca destino de este proyecto, pulse el proyecto con el botón derecho del ratón y seleccione Propiedades > Proyecto de iSeries).
  2. Cierre la versión 4.0 y desinstálela.
  3. Continúe con el proceso de instalación de Development Studio Client para iSeries Versión 5.0.
Después de la instalación
  1. En la versión 5.0, abra la perspectiva Explorador de Sistemas Remotos: pulse Ventana > Abrir perspectiva > Explorador de Sistemas Remotos.
  2. Navegue hasta la biblioteca asociada del proyecto de iSeries. Esta biblioteca contiene todo el fuente que cargó a partir del proyecto de iSeries.
  3. Seleccione los archivos físicos fuente de esta biblioteca que formaban parte del proyecto de iSeries, púlselos con el botón derecho del ratón y seleccione Hacer disponible fuera de línea. Esto hace que vuelva a crearse el proyecto de iSeries que se correlaciona con esta biblioteca, y descarga localmente todos los miembros fuente en el proyecto. Ahora puede continuar con el proceso de desarrollo.

    Nota: otra manera de volver a crear rápidamente el proyecto consiste en seleccionar Crear proyecto de iSeries en una biblioteca del Explorador de Sistemas Remotos, pero así no se descarga ningún miembro fuente de esa biblioteca. Tan solo se crea y configura un proyecto de iSeries que se correlaciona con esa biblioteca y ese sistema principal.

Si ya ha instalado Development Studio Client para iSeries Versión 5.0 y sabe que no ha cargado los proyectos en el sistema principal remoto:

Después de la instalación
  1. Lance la versión 5.0.
  2. En el menú principal, pulse Ventana > Abrir perspectiva > Recursos. Pulse Aceptar.
  3. Cree un proyecto simple pulsando Archivo > Nuevo > Otros > Simple > Proyecto, y llámelo Temp. Este proyecto es un contenedor para importar el proyecto de la versión 4.0 al área de trabajo de la versión 5.0.
  4. Seleccione Archivo > Importar > Sistema de archivos. Pulse Siguiente.
  5. Navegue hasta el área de trabajo antigua (por ejemplo, X:\WDSC\WSSD\workspace, siendo X la letra de la unidad en la que ha instalado la versión 4.0) e importe el proyecto que desea crear de nuevo.
  6. Cree un proyecto de iSeries que se correlacione con la biblioteca y el sistema principal del proyecto de la versión 4.0 que acaba de importar.
    • Pulse el botón derecho del ratón en cualquier punto de la vista Navegador y seleccione Nuevo > Proyecto > iSeries > Local > Proyecto de iSeries.
    • Si no recuerda cuál es la biblioteca y el sistema principal, hallará esta información en un archivo XML que se llama .iseries_project_properties, bajo el proyecto Temp.
  7. Vuelva a crear los archivos físicos fuente que existían en el proyecto de la versión 4.0:
    • Pulse Archivo > Nuevo > Otros > iSeries > Local > Archivo físico fuente de iSeries.
    • Si no está seguro de cuál era el CCSID y la longitud de registro de sus archivos, hallará esta información en un archivo XML que se llama .iseries_srcpf_properties, situado directamente bajo cada archivo físico fuente.
  8. Ahora arrastre los miembros fuente del antiguo proyecto de la versión 4.0 y suéltelos en el nuevo proyecto de la versión 5.0.
  9. Suprima el proyecto Temp, que ya no necesita, y abra la perspectiva Proyectos de iSeries: pulse Ventana > Abrir perspectiva > Proyectos de iSeries.

Marcas registradas y marcas de servicio

Los términos siguientes son marcas o marcas registradas de International Business Machines Corporation en Estados Unidos y/o en otros países:

Java y todas las marcas y logotipos basados en Java son marcas registradas de Sun Microsystems, Inc., en Estados Unidos y en otros países.

Los demás nombres de empresas, productos y servicios pueden ser marcas registradas o de servicio de terceros.