Migración a HATS V7.5.1

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.

Migración de HATS

La migración de un proyecto de HATS desde un release anterior de HATS es un proceso de dos pasos.

  1. Importar el proyecto como un archivo de intercambio de proyectos, extraerlo de un depósito de código (como CVS), en un espacio de trabajo de HATS V7.5.1.
  2. Migrar el proyecto utilizando el asistente de migración de HATS.

Importación de un proyecto de HATS

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.

Nota:
un proyecto de HATS V4 exportado como un archivo zip desde WebSphere Studio Application Developer (WSAD) V4 no puede importarse como un archivo de intercambio de proyectos y, por tanto, no puede migrarse posteriormente. Un proyecto de HATS V4 exportado como un archivo zip desde WSAD V5 puede importarse y migrarse a HATS V7.5.1.

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.

Migración del espacio de trabajo de Rational SDP

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.

Utilización del asistente de migración de HATS

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:

  1. En la vista Proyectos de HATS, pulse con el botón derecho del ratón en el proyecto y seleccione Migrar proyecto.
  2. Si tiene otros proyectos de un release anterior de HATS que están asociados con el proyecto de HATS que ha seleccionado para migrarlo, esos proyectos también se migrarán, así como todos los proyectos .ear de HATS asociados.
  3. Pulse Aceptar para empezar la migración.
  4. Si el proyecto no tiene un proyecto .ear asociado, deberá asociar el proyecto .war después de realizar la migración. Para asociar el proyecto .war con un proyecto .ear, consulte Traslado de proyectos Web de HATS a un archivo .ear diferente.
Notas:
  1. Después de la migración, compruebe los detalles en el Informe de migración.
  2. Si un proyecto Web o de porlet de HATS que se va a migrar tiene una unidad ejecutable de destino no admitida (si no se ha ejecutado el asistente de migración de espacios de trabajo de Rational SDP) o facetas de WebSphere no admitidas, el asistente de migración de HATS establece la unidad ejecutable de destino y las facetas en el nivel inferior admitido de WebSphere Application Server para proyectos Web y en el nivel inferior admitido de WebSphere Portal Server para proyectos de portlet. Se muestra un mensaje y se anota, que indica el hecho de que se ha realizado el cambio.
  3. Si, después de la migración, recibe un error indicando que el entorno de ejecución de destino no está definido, edite las propiedades para el proyecto y seleccione el entorno de ejecución de destino adecuado. Para ello, pulse con el botón derecho del ratón en el proyecto y seleccione Propiedades. En la ventana Propiedades, seleccione Entornos de ejecución de destino. En la lista Entornos de ejecución, seleccione el entorno de ejecución adecuado.
  4. La migración del proyecto desde un release anterior de HATS a HATS V7.5.1 no se puede deshacer.

Migración de las transformaciones de HATS

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.

Consideraciones especiales para componentes y aparatos de HATS V4

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.

Consideraciones especiales relativas a la migración

Avance automático

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.

Archivos de copia de seguridad

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.

Nota:
Antes de suprimir la carpeta MigrationBackup, puede publicar un proyecto migrado en WebSphere Application Server para probar cómo se comporta. No obstante, los errores de la lista de tareas provocados por la carpeta MigrationBackup pueden crear problemas al publicar en WebSphere Application Server. Para evitar esto, puede eliminar la carpeta MigrationBackup del proyecto o Permitir publicar en un servidor las aplicaciones que contienen errores. Para permitir que las aplicaciones que contienen errores se publiquen en un servidor, seleccione Ventana > Preferencias > Servidor > WebSphere Application Server en la barra de menús de Rational SDP y seleccione Permitir publicar en un servidor las aplicaciones que contienen errores.

Aparato de botón

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:

  1. Elimine la línea siguiente de la declaración input.HATSBUTTON:
    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.
  2. Combine las declaraciones de CSS relacionadas con el color para cada color. Por ejemplo, cambie:
    .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.

Beans de acceso EJB

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.

Aparato Campo

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:

  1. Añada la clase siguiente a los archivos whitetheme.css, graytheme.css, monochrometheme.css, tantheme.css y blacktheme.css:
    .HF {
      font-family: courier new, monospace;
    }
  2. Elimine font-family: monospace de todas las clases H-color (color de HATS) de todos los archivos CSS.

Normas globales

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"/>

Variables globales

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.

Compresión HTTP

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:

  1. En HATS Toolkit, cambie a la vista Navegador de la perspectiva de HATS.
  2. Abra el archivo web.xml que se encuentra en la carpeta Contenido Web\WEB-INF del proyecto.
  3. Pulse la pestaña Fuente para ver el fuente de este archivo.
  4. Copie las sentencias siguientes después de la última correlación de servlets definida (busque la última aparición de </servlet-mapping>).
    <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>
       
  5. Copie las sentencias siguientes después de la última correlación de filtros definida (busque la última aparición de </filter-mapping>).
    <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>
       
  6. Guarde el archivo.
Nota:
si ha ejecutado este proyecto en el servidor, deberá volver a publicar la aplicación para que WebSphere Application Server aplique el cambio en el archivo web.xml.

IBM Tivoli License Manager

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.

Aplicaciones Web de WebFacing

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.

  1. Cree una carpeta llamada itlm directamente bajo el EAR asociado del proyecto de WebFacing.
  2. Localice el archivo de signatura denominado HATS0705.sys2 en el directorio del plug-in de HATS
    <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.
  3. Copie el archivo de signatura desde el plug-in a la carpeta itlm que creó anteriormente.
  4. Exporte el proyecto como un EAR y vuelva a desplegarlo. ITLM podrá ahora detectar la aplicación.

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.

Nota:
los portlets de WebFacing no se detectan porque no pueden desplegarse como EAR.

Seguridad de Java 2

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.

Correlaciones del teclado

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.

Aplicaciones de Cliente enriquecido

Enlaces del teclado de Lotus Notes

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.

Iniciar configuraciones

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.

Temas

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.

Series de caracteres en un idioma distinto del inglés (Estados Unidos) en plantillas y transformaciones

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.

Habilitación de Runtime

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

Nota:
Las aplicaciones Web de HATS cuyos tiempos de ejecución no están totalmente habilitados están restringidos a sólo dos conexiones de sistema principal en tiempo de ejecución. Las aplicaciones de cliente enriquecido de HATS cuyos tiempos de ejecución no estén totalmente habilitados permiten conexiones de sistema principal ilimitadas en el entorno de prueba local pero no permiten conexiones de sistema principal en un entorno de producción desplegado.

Secure Sockets Layer (SSL)

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.

Modalidades de prueba

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.

Componentes de sistema principal del URL

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.

Inicio de sesión Express en WEb (WEL)

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.

CMPI_DCAS_KEYRING_FILE
Este parámetro se ha desechado y no debe utilizarse. Sin embargo, si se utiliza, está soportado en HATS V7.5.1 junto con el parámetro desechado CMPI_DCAS_KEYRING_PASSWORD y se presupone que el tipo de conjunto de claves es pkcs12. En su lugar, utilice CMPI_DCAS_TRUSTSTORE. Si desea obtener más información, consulte Parámetros de inicialización.

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.

CMPI_DCAS_KEYRING_PASSWORD
Este parámetro se ha desechado y no debe utilizarse. Sin embargo, si se utiliza, está soportado en HATS V7.5.1 junto con el parámetro desechado CMPI_DCAS_KEYRING_FILE y se presupone que el tipo de conjunto de claves es pkcs12. En su lugar, utilice CMPI_DCAS_TRUSTSTORE_PASSWORD. Si desea obtener más información, consulte Parámetros de inicialización.

Este parámetro especifica la contraseña para la base de datos de conjunto de claves.

Portlets de HATS V4

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.

Migración desde HATS LE

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:

  1. Inicie la Consola administrativa de HATS LE entrando el siguiente URL en el navegador Web: http://<nombre_servidor>/HATSLE/admin donde <nombre_servidor> es el nombre del servidor donde se ejecuta la aplicación de HATS LE.
  2. Seleccione Avanzadas.
  3. Seleccione Empaquetar.
  4. Descargue y guarde el paquete como 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:

  1. Pulse Archivo > Importar para abrir el asistente Importar.
  2. Seleccione HATS > Aplicación de HATS LE y pulse Siguiente.
  3. En el campo Nombre del archivo zip, escriba la ubicación y el nombre del archivo .zip. También puede buscar y seleccionar el archivo .zip pulsando Examinar.
  4. En el campo Nuevo nombre de proyecto, especifique un nombre de proyecto o acepte el que se proporciona.
  5. Establezca la ubicación del proyecto o acepte la ubicación por omisión.
  6. En el campo Proyecto de Enterprise Application, especifique un nombre para el proyecto .ear o seleccione un nombre existente en la lista desplegable.
  7. Pulse Finalizar.
Notas:
  1. Si la aplicación de HATS LE tiene habilitado SSL en la conexión, recibirá un mensaje de aviso al migrarla a HATS V7.5.1 y el certificado SSL no se migrará.

    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.

  2. La funcionalidad de conexión múltiple de HATS LE V5 se pierde después de migrar a HATS V7.5.1. La conexión por omisión de la aplicación de HATS LE V5 pasa a ser la conexión por omisión del proyecto de HATS V7.5.1. Las otras conexiones configuradas en HATS LE V5 pasan a ser conexiones de fondo del proyecto de HATS V7.5.1.

HATS para usuarios de Host Publisher

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:

Nota:
si ha creado objetos de integración de Host Publisher utilizando una plantilla modificada, deberá volver a crear los objetos de integración realizando modificaciones similares en la plantilla de objetos de integración de HATS y volver a generar los objetos de integración a partir de las macros. Si desea obtener más información sobre el uso de plantillas para personalizar objetos de integración, consulte la publicación HATS Web Application Programmer's Guide.

Si está importando una aplicación de Host Publisher V4.0 (a diferencia de una aplicación de Host Publisher V4.0.1):

Migración de Host Publisher Versión 4

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:

Asistente Importar EAR de Host Publisher

Puede importar proyectos de Host Publisher V4 en HATS como nuevos proyectos de HATS o como parte de un proyecto de HATS existente.

  1. Pulse Archivo > Importar > HATS > EAR de Host Publisher V4 para abrir el asistente Importar archivo EAR de Host Publisher.
  2. Especifique el archivo EAR que desee importar en el campo Nombre del archivo EAR.
  3. Decida si el archivo EAR se va a utilizar para un nuevo proyecto de HATS o para un proyecto de HATS existente.
  4. En la sección Opciones, puede establecer Grabar encima los recursos sin avisar si selecciona el recuadro de selección.
  5. Si utiliza el cifrado en Host Publisher, puede entrar la clave de cifrado en el recuadro de texto Clave de cifrado de la lista de usuarios.
  6. Pulse Finalizar.

Asistente Importar objeto de integración de Host Publisher

También puede importar objetos de integración de Host Publisher individuales en un proyecto de HATS existente.

  1. Pulse Archivo > Importar > HATS > Objeto de integración de Host Publisher V4 para abrir el asistente Importar objeto de integración de Host Publisher.
  2. Especifique la ubicación de los objetos de integración que desee importar en el campo Directorio de objetos de integración de Host Publisher.
  3. Seleccione los objetos de integración que desee importar en el campo Seleccione los objetos de integración a importar.
  4. Seleccione el proyecto de HATS en el recuadro desplegable Seleccione el proyecto de HATS.
  5. Puede Grabar encima los recursos sin avisar y Regenerar objetos de integración importados si selecciona el recuadro de selección correspondiente.
    Nota:
    si ha encadenado objetos de integración, asegúrese de seleccionar la opción Regenerar objetos de integración importados. Esto garantiza la conservación de la información de encadenamiento. Una vez importados los objetos de integración encadenados, la información de estado está en el fuente Java y estará predefinido cuando utilice el asistente Crear objeto de integración encadenado. Si desea obtener más información sobre los objetos de integración encadenados, consulte Encadenamiento de objetos de integración.
  6. Pulse Finalizar.
Nota:
cuando se importan objetos de integración, la configuración de la conexión asociada con el objeto de integración se añade al proyecto de HATS.

Migración de un portlet de Host Publisher V4

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.

Migración de J2EE

Si desea migrar el nivel de soporte J2EE en los proyectos de HATS, siga estos pasos:

  1. En Rational SDP, cambie a la vista Navegador.
  2. Pulse el botón derecho del ratón en el proyecto .ear que contiene los proyectos de HATS y seleccione Java EE > Asistente de migración de J2EE.
  3. En el panel de la página de bienvenida, pulse Siguiente.
  4. En el panel Enterprise Application, seleccione la versión de J2EE y quite la marca del recuadro Migrar todos los proyectos del módulo.
    Nota:
    si deselecciona este recuadro, podrá seleccionar individualmente qué proyectos desea migrar. Si el proyecto .ear contiene un proyecto EJB de HATS, no debe seleccionarlo para migrar el proyecto .ear satisfactoriamente.
  5. En el panel Módulo EJB (si aparece), no seleccione ningún proyecto EJB de HATS.
  6. En el panel Proyectos Web, seleccione todos los proyectos Web de HATS.
  7. Pulse Finalizar.