Si es usuario de Host Publisher V4, HATS V4 LE, HATS V5 LE, HATS V4, V5, V6, V7.0 o V7.1, puede migrar los proyectos a HATS V7.5.1.
Si desea información sobre la migración desde HATS LE, consulte Migración desde HATS LE.
Si está utilizando una versión de Host Publisher anterior a la V4.0, primero tiene que seguir las instrucciones de migración de las aplicaciones de Host Publisher a Host Publisher V4.0. Vaya a http://www.ibm.com/software/awdtools/hats/support/index.html y entre la serie de búsqueda "How to migrate Host Publisher" (Cómo migrar Host Publisher). Si desea obtener más información, consulte HATS para usuarios de Host Publisher.
La migración de un proyecto de HATS desde un release anterior de HATS es un proceso de dos pasos.
Si tiene instalado un release anterior de HATS, primero tiene que exportar el proyecto a un archivo zip o a un archivo de intercambio de proyectos antes de poder importarlo y migrarlo a HATS V7.5.1. Consulte la documentación del release anterior de HATS para obtener información sobre la exportación de proyectos de HATS.
Después de exportar el proyecto desde un release anterior de HATS, debe importarlo como un archivo de intercambio de proyectos en el espacio de trabajo de HATS V7.5.1. Si desea información sobre la importación de proyectos Web y de cliente enriquecido de HATS, consulte Exportación e importación de proyectos Web de HATS y Exportación e importación de proyectos de cliente enriquecido de HATS.
Si ha almacenado los proyectos de HATS en Rational ClearCase, debe crear una vista instantánea que contenga estos proyectos y, a continuación, importarlos en el espacio de trabajo de HATS V7.5.1 mediante Archivo > Importar > General > Proyectos existentes en el espacio de trabajo. Durante la importación, no seleccione la opción Copiar proyectos en el espacio de trabajo. Después de importar los proyectos en el espacio de trabajo de HATS V7.5.1, dispondrá de la opción de migrarlos a HATS V7.5.1. Durante la migración, los archivos que deben actualizarse se desprotegen automáticamente de Rational ClearCase.
Se muestra el asistente de migración de espacios de trabajo de Rational SDP si se importa un proyecto en el espacio de trabajo y necesita algún nivel de migración de Rational SDP. Este asistente realiza alguna migración básica del proyecto de Rational SDP y si el proyecto tiene como destino una unidad ejecutable no admitida, fuerza que se elija una unidad ejecutable de destino admitida. Como preparativo para ejecutar el asistente de migración de HATS, debe ejecutar primero el asistente de migración de espacios de trabajo de Rational SDP.
Cuando conmuta a la perspectiva de HATS, si tiene un proyecto creado con un release anterior de HATS en el espacio de trabajo de HATS V7.5.1, recibirá un mensaje indicando que el espacio de trabajo contiene un proyecto de HATS que tiene que migrarse.
Debe utilizar el asistente de migración de HATS para migrar este proyecto a HATS V7.5.1 antes de investigar los errores mostrados en la vista Problemas, ya que la migración puede eliminar algunos o todos estos errores.
Para utilizar el asistente de migración de HATS siga estos pasos:
Al migrar proyectos de HATS de un release anterior de HATS a HATS V7.5.1, las transformaciones de los proyectos también se migran. Los cambios efectuados en las transformaciones dependen del release de HATS desde el que se efectúa la migración. Todas las transformaciones se guardan en la carpeta MigrationBackup antes de migrarse.
Se han introducido nuevos componentes y aparatos en HATS V5. Los componentes y aparatos estaban soportados en HATS V4, pero se han desechado en HATS V5 y V6. Los componentes y aparatos de HATS V4 no están soportados en HATS V7.5.1. Si tiene componentes y aparatos de HATS V4 en los proyectos, durante la migración tiene la posibilidad de migrarlos a componentes y aparatos de HATS V7.5.1 o bien cancelar la migración del proyecto. Si elige efectuar la migración, es posible que el proyecto se represente de forma diferente. Asegúrese de probar exhaustivamente los proyectos migrados.
Si tiene componentes y aparatos de subarchivo de HATS V4, se migran a componentes y aparatos de subarchivo de HATS V5. Si tiene componentes y aparatos de subarchivo de HATS V5, quedarán igual. Hay nuevos componentes y aparatos de subarchivo con más funciones para HATS V6 y posteriores. Es recomendable que investigue para usar los nuevos componentes y aparatos en lugar de los antiguos. Si desea obtener más información, consulte Subarchivo.
Si en HATS V4 eligió un componente de tecla de función y lo representó como aparato desplegable (selección) o botón de selección (selección), tiene la opción de someter automáticamente o mostrar un botón someter. Si eligió mostrar un botón someter, al migrar el proyecto de HATS V4 a HATS V7.5.1, el botón someter ya no aparece. En HATS V7.5.1 se ha eliminado la posibilidad de mostrar un botón someter.
Todos los pares de DefaultExtract/DefaultWidget de HATS V4 se migran a la representación por omisión de HATS V7.5.1. Dado que es posible que esta correlación no produzca los resultados previstos originalmente, la migración de HATS V7.5.1 muestra y anota un mensaje en el que se indica que se ha migrado un par DefaultExtract/DefaultWidget a la representación por omisión. En este caso, debe revisar la transformación y efectuar los ajustes necesarios.
Los componentes y aparatos personalizados que amplían o se emparejan con componentes y aparatos de HATS V4 no se pueden migrar y mantienen los resultados originales. Cuando la migración de HATS V7.5.1 detecta esto, se muestra y anota un mensaje en el que se indica que la transformación contiene componentes y aparatos de HATS V4 que no pueden migrarse. En este caso, debe revisar la transformación y migrarla manualmente.
Si en versiones anteriores de HATS ha habilitado la función de avance automático añadiendo la línea turnAutoTabOn(); al archivo lxgwfunctions.js, ahora debe utilizar el valor Habilitar avance automático de campo en la sección Valores del cliente de la pestaña Otros del editor Valores del proyecto. Si desea obtener más información, consulte Valores de cliente.
La migración de HATS crea una carpeta de copia de seguridad en el directorio de proyectos denominada MigrationBackup. Esta carpeta contiene copias de los archivos del proyecto anteriores al proceso de migración, durante el que se sobrescribieron. Estos archivos se guardan para permitir compararlos y fusionarlos con los nuevos archivos de HATS V7.5.1. No se preocupe si surgen problemas; la aplicación ya no utiliza estos archivos. Una vez se hayan comparado o fusionado todos los archivos guardados, puede suprimir la carpeta MigrationBackup.
Si migra un proyecto creado antes de HATS V7.0.0.2 y elige implementar la opción Habilitar colores de primer plano, si utiliza una plantilla que usa la hoja de estilos blacktheme.css, debe actualizar la hoja de estilos blacktheme.css manualmente de una de las formas siguientes:
color: lime;Esto permite que los colores de primer plano se representen en teclas de función; sin embargo, hace que otros botones generados por un aparato de HATS se representen en un color por omisión.
.HBLUE {
color: #3c9dff;
}
input.HBLUE {
white-space: normal;
letter-spacing: normal;
}a
.HBLUE, input.HBLUE {
color: #3c9dff;
white-space: normal;
letter-spacing: normal;
}Repita este cambio para cada color.Una alternativa a la edición manual de la hoja de estilos blacktheme.css es crear un nuevo proyecto ficticio y copiar los archivos CSS de tema de este proyecto en su proyecto. Asegúrese de que cualquier cambio que efectúe a los archivos CSS se sobrescribe.
Si tiene proyectos de HATS V5 que contengan beans de acceso EJB, es posible que tenga problemas de compilación o de tiempo de ejecución que empiecen con "No se pudo resolver HPubReqCompleteEvent." Para corregirlos, vuelva a generar los beans de acceso EJB.
Si desea utilizar el valor Representar utilizando font monoespacio para el aparato Campo, y se ha creado su proyecto inicialmente en un release anterior a HATS V7.0,deberá actualizar los archivos CSS de la manera siguiente:
.HF {
font-family: courier new, monospace;
}Se ha añadido un valor nuevo, enforceImmediacy, a cualquier normal global importada en HATS V7.5.1 desde HATS V5. Cuando este valor es true, la norma global se comporta como lo hacía en HATS V5 al seleccionar Sólo el campo de entrada más cercano para la opción Transformar del patrón Buscar campos de entrada por texto adyacente. Cuando este valor es false (valor por omisión), la norma global se comporta como lo hace en HATS V7.5.1.
Para que las normas globales que se acaban de definir se comporten como lo hacían las normas globales de HATS V5, debe añadir el valor enforceImmediacy y establecerlo en true. Para ello, en la pestaña Fuente del editor de Valores del proyecto, añada el valor siguiente al código componentSettings de las normas globales:
<setting name="enforceImmediacy" value="true"/>
Antes de HATS V7, el valor de una variable global, especificado en una solicitud insertada en una transformación mediante la opción Solicitar la variable global con recuadro de entrada, podría haberse truncado debido a algunos caracteres no especificados correctamente.
En esta versión de HATS, los valores de variable global solicitados por una transformación se especifican correctamente para evitar recortes. Las variables globales insertadas en una transformación mediante la opción Mostrar la variable global como texto estático no se ven afectadas por este cambio. Las solicitudes de variables globales insertadas en una transformación en una versión de HATS anterior a HATS V7 no se actualizan automáticamente durante la migración, por lo que no se ven afectadas por este cambio.
Si desea utilizar el soporte de HATS para la compresión HTTP en proyectos migrados de HATS V5.0.x, V6.0 y V6.0.1, debe añadir manualmente el filtro de compresión al archivo del descriptor de despliegue Web (web.xml). Para añadir el filtro de compresión al archivo web.xml:
<filter>
<description>Proporciona compresión para la salida del servlet de
entrada de HATS</description>
<display-name>CompressionFilter</display-name>
<filter-name>CompressionFilter</filter-name>
<filter-class>com.ibm.hats.runtime.filters.CompressionFilter</filter-class>
</filter>
<filter-mapping> <filter-name>CompressionFilter</filter-name> <servlet-name>EntryServlet</servlet-name> <dispatcher>ERROR</dispatcher> <dispatcher>FORWARD</dispatcher> <dispatcher>INCLUDE</dispatcher> <dispatcher>REQUEST</dispatcher> </filter-mapping> <filter-mapping> <filter-name>CompressionFilter</filter-name> <url-pattern>/</url-pattern> </filter-mapping> <filter-mapping> <filter-name>CompressionFilter</filter-name> <url-pattern>/index.jsp</url-pattern> </filter-mapping>
Las aplicaciones HATS, WebFacing y enlazadas de HATS/WebFacing que se migran a HATS V7.5.1 deben volver a desplegarse en el entorno de producción para que se aplique el soporte de IBM® Tivoli License Manager para el nuevo archivo de signatura de HATS V7.5.1.
ITLM detecta las aplicaciones Web desplegadas como Enterprise Archives (EAR) en los servidores WebSphere Application Server soportados. Ya que los proyectos Web de WebFacing se crean de forma independiente de los EAR asociados, el archivo de signatura de ITLM debe incluirse manualmente. Siga los pasos siguiente para habilitar que ITLM detecte las aplicaciones Web de WebFacing.
<directorio_instalación_compartido>\plugins\com.ibm.hats_nnn\donde directorio_instalación_compartido es el directorio de recursos compartidos donde se ha instalado la oferta de HATS mediante IBM Installation Manager y nnn es la versión y el nivel de build de HATS.
Si habilitó que ITLM detectase un proyecto de WebFacing antiguo y migró el proyecto a V7.5.1, debe eliminar el archivo de signatura existente (por ejemplo, WDHT0700.sys2 si el proyecto de WebFacing antiguo es de la V7.0) del EAR asociado al proyecto y añadir el archivo de signatura V7.5.1 (HATS0705.sys2) antes de volver a efectuar el despliegue.
Durante la migración a HATS V7.5.1, se sobrescribe el archivo was.policy de seguridad de WebSphere Application Server Java™ 2. Si ha personalizado el archivo was.policy en un proyecto anterior a HATS V7.5, entonces debe volver a personalizar el archivo después de la migración.
En versiones anteriores del terminal de sistema principal de HATS, la tecla Pausa estaba correlacionada con la acción [clear] del sistema principal. En el terminal de sistema principal de HATS V7 y posterior, la tecla Esc está correlacionada con la acción [clear] del sistema principal.
En versiones anteriores de HATS anteriores a HATS V6, se utilizaba Control+R en sesiones bidireccionales para invertir la dirección de la pantalla. En HATS V6 y posteriores, la combinación Control+R está correlacionada con una acción RESET para sesiones bidireccionales y no bidireccionales, y Alt+Intro está correlacionada con la acción de invertir la dirección de la pantalla en sesiones bidireccionales.
Si migra a HATS V7.5.1 un proyecto de cliente enriquecido anterior a HATS V7.5 diseñado para Lotus Expeditor, las correlaciones de teclas para Lotus Notes se añaden al proyecto. Estas correlaciones de teclas tambieŽn se añaden a proyectos diseñados para Lotus Expeditor si se actualiza la instalación de HATS V7.5.0.x a V7.5.1 mediante IBM Installation Manager.
Después de migrar un proyecto de cliente enriquecido, si no puede iniciarlo en el entorno de prueba, cree una configuración de inicio nueva para utilizar en el entorno de prueba. Para hacerlo, en la vista de proyectos de HATS, pulse con el botón derecho del ratón en el proyecto y seleccione Ejecutar o DepurarAparecerá la ventana de configuración de Ejecutar (o Depurar). Si el proyecto está diseñado para Eclipse RCP, pulse con el botón derecho del ratón en Aplicación Eclipse y seleccione Nuevo. Si el proyecto está diseñado para Lotus Notes o Lotus Expeditor, pulse con el botón derecho del ratón en Servicios de cliente y seleccione Nuevo. Modifique el nombre de configuración de inicio y la ubicación si lo desea. También puede eliminar configuraciones de inicio anteriores desde esta ventana. Pulse Ejecutar (o Depurar) para iniciar el proyecto en el entorno de prueba.
Las aplicaciones de Cliente enriquecido que utilizan el tema Emulador de terminal clásico tendrán habilitado el valor Navegación con teclas de flecha después de la migración.
Las series de caracteres en un idioma distinto del inglés (Estados Unidos) incluidas en plantillas y transformaciones de un proyecto de cliente enriquecido de HATS creado con HATS V7.0 o V7.0.0.1 no se compilan correctamente cuando el proyecto se exporta como una característica. Para resolver este problema, después de migrar el proyecto a HATS V7.5.1, edite el archivo build.properties situado en la carpeta raíz del proyecto. Añada la línea siguiente al final del archivo build.properties:
javacCustomEncodings.library.jar = src/proyectoce/templates/[UTF-8], src/proyectoce/transformations/[UTF-8]
Dondeproyectoce es el nombre del proyecto de cliente enriquecido.
Para habilitar completamente HATS V7.5.1 Runtime para producción, debe especificar los valores de licencia mediante el asistente Valores de licencia. Debe hacerlo incluso para los proyectos cuyos módulos de ejecución se habilitaron completamente en versiones anteriores de HATS. Si desea obtener información sobre la especificación de valores de licencia, consulte Habilitación de Runtime de HATS y los valores de licencia en la publicación Guía de iniciación de HATS
Durante la migración, HATS V7.5.1 convierte los archivos de clase de certificado SSL, archivos CustomizedCAs.class, en archivos de almacén de claves PKCS12 con los nombres nombreapl-CustomizedCAs.p12 y las contraseñas hats, donde nombreapl es el nombre del proyecto. Tras la migración, debe utilizar la herramienta de gestión de certificados (también conocida como IBM Key Management o iKeyMan) para cambiar las contraseñas de los nuevos archivos de almacén de claves y verificarlas mediante el editor de conexiones. Si desea obtener más información, consulte Seguridad.
A partir de HATS V7, se pueden utilizar las modalidades de prueba Ejecutar en servidor (para proyectos Web) y Ejecutar (para proyectos de cliente enriquecido) para modificar y probar los valores de tiempo de ejecución desplegados en el entorno de producción. Tenga en cuenta que cualquier cambio efectuado en los valores del tiempo de ejecución mientras se efectúan pruebas en esta modalidad se retienen y pasan a aplicarse al desplegar la aplicación de HATS en un entorno de producción.
Se pueden utilizar las modalidades de prueba Depurar en servidor (para proyectos Web) y Depurar (para proyectos de cliente enriquecido) para modificar y probar los valores del tiempo de ejecución sin modificar los valores desplegados en el entorno de producción.
Si desea obtener más información sobre el cambio de valores del tiempo de ejecución para proyectos Web, consulte Inicio de la consola administrativa en HATS Toolkit. Si desea obtener más información sobre el cambio de valores del tiempo de ejecución para proyectos de cliente enriquecido, consulte Administración de aplicaciones de cliente enriquecido de HATS.
Antes de HATS V7, el componente de sistema principal del URL ha buscado en los campos protegidos y en los de entrada. A partir de HATS V7, el componente de sistema principal del URL sólo busca en campos protegidos no ocultos.
Cuando un proyecto Web de HATS se migra a V7.5.1 de HATS sin ningún EAR asociado, el Inicio de sesión Express en Web (WEL) no funciona correctamente. La información de configuración de WEL para un proyecto Web se guarda en su proyecto EAR asociado. Si el proyecto EAR asociado no está importado y migrado entonces se pierde esta información.
Si importa los proyectos Web y EAR como archivos de Intercambio de proyectos al espacio de trabajo y migra el proyecto Web, el proyecto EAR asociado también se migrará y la información de configuración de WEL no se perderá.
A partir de HATS V7, los plug-ins de Credential Mapper de DCAS/RACF/JDBC y DCAS/RACF basado en certificado de HATS utilizan JSSE (Java Secure Socket Extension) para conectarse de forma segura al servidor DCAS. Como resultado de esto, tenga en cuenta los cambios siguientes en los parámetros de inicialización de los plug-ins.
Este parámetro especifica una base de datos de conjunto de claves. Debe especificarse un conjunto de claves para proporcionar acceso al certificado del cliente DCAS así como al certificado del servidor DCAS. Los certificados establecen una conexión segura autenticada de cliente con un servidor DCAS. Este parámetro es una referencia de archivo al conjunto de claves que debe utilizarse. El plug-in de DCAS es el cliente DCAS. El archivo de conjunto de claves debe almacenarse en el archivo .ear.
Este parámetro especifica la contraseña para la base de datos de conjunto de claves.
La migración de portlets de HATS V4 no está soportada. Si desea utilizar un proyecto Web existente de HATS V4 como portlet, primero debe migrarlo a HATS V7.5.1. Después de migrar el proyecto, puede generar un proyecto de portlet de HATS V7.5.1 a partir del mismo. Si desea obtener más información, consulte Generación de portlets a partir de proyectos Web de HATS.
Si tiene instalado actualmente HATS LE, primero debe exportar la aplicación antes de poder importarla en HATS V7.5.1. Para exportar la aplicación de HATS LE de la Consola administrativa de HATS LE a un archivo .zip:
Después de que se haya exportado la aplicación de HATS LE como un archivo .zip, impórtela en HATS V7.5.1 siguiendo estos pasos:
Para que el certificado SSL pueda utilizarse en HATS V7.5.1, debe crear un archivo de almacén de claves PKCS12 y añadirle el certificado SSL. Si ya no tiene el certificado SSL, debe ponerse en contacto con el administrador del servidor Telnet para solicitarlo. Si desea más información, consulte Habilitación de la seguridad SSL.
Si es un usuario experimentado de IBM WebSphere Host Publisher, deberá adaptar su enfoque para desarrollar proyectos con HATS. A continuación se muestran algunas de las diferencias clave entre los enfoques de HATS y Host Publisher para el desarrollo de proyectos:
Si está importando una aplicación de Host Publisher V4.0 (a diferencia de una aplicación de Host Publisher V4.0.1):
Si actualmente es usuario de Host Publisher V4, puede migrar proyectos completos o sólo los objetos de integración de los proyectos existentes. Cuando se importan archivos .ear de Host Publisher, los objetos de integración permanecen empaquetados en el archivo .jar.
Si el objeto de integración está en un módulo Web, el archivo .jar está en el directorio WEB-INF/LIB. Si el objeto de integración está en un módulo EJB, el archivo .jar estará en el directorio imported_classes\IntegrationObject. Los beans de acceso EJB también continuarán empaquetados en el archivo .jar en el directorio WEB-INF/LIB del módulo Web.
Si importa un archivo .ear y modifica la macro para la que se ha creado un objeto de integración, tendrá el archivo .jar del objeto de integración original que se importó, así como el fuente Java. Después de volver a generar el objeto de integración para HATS, podrá suprimir el archivo .jar importado.
A continuación se muestra una lista de consideraciones a tener en cuenta cuando se realiza la migración desde Host Publisher V4:
Puede importar proyectos de Host Publisher V4 en HATS como nuevos proyectos de HATS o como parte de un proyecto de HATS existente.
También puede importar objetos de integración de Host Publisher individuales en un proyecto de HATS existente.
El portlet de recorte que se suministra con WebSphere Portal Server V6.x es equivalente en funcionalidad al portlet de Host Publisher V4. Puede crear un portlet de recorte que apunte a una aplicación de HATS basada en objetos de integración, o a una aplicación migrada desde Host Publisher V4, y sustituir el portlet de Host Publisher V4 por éste. El portlet de Host Publisher V4 ya no está soportado.
Si desea obtener más información sobre la integración de las aplicaciones basadas en objetos de integración con WebSphere Portal, consulte la publicación HATS Web Application Programmer's Guide.
Si desea migrar el nivel de soporte J2EE en los proyectos de HATS, siga estos pasos: