Migración de una configuración de pasarela de servicios web para Versión 5.1
En WebSphere Application Server Versión 5.1, la pasarela de servicios web era un componente independiente con su propia interfaz de usuario. En las versiones posteriores del producto, la pasarela se integra en los servicios web habilitados para el bus de integración de servicios, y se vuelven a implementar como un mecanismo para ampliar y enlazar los servicios de entrada y salida.Utilice un script de mandatos wsadmin para migrar una configuración de pasarela existente desde un servidor de aplicaciones de Versión 5.1 a un servidor de aplicaciones o clúster en una versión posterior.
Antes de empezar
- WebSphere Application Server Versión 5.0 ya no está soportado, por lo que debe migrar cualquier pasarela existente que se ejecute en los servidores de aplicaciones Versión 5.0 para ejecutarse en servidores de aplicaciones en el nivel actual del producto.
- Las pasarelas de servicios web que se ejecutan en WebSphere Application Server Versión 5.1 pueden, sujetas a determinadas restricciones, coexistir con instancias de pasarela que se ejecutan en servidores de aplicaciones Versión 7.0 o posterior .
- Una célula de Versión 7.0 o posterior puede contener los servidores de aplicaciones Versión 5.1, Versión 6 y Versión 7.0 o posterior. .
Puede migrar una pasarela de la Versión 5.1 que se esté utilizando para producción sin detener la pasarela; a continuación, las aplicaciones solicitantes pueden pasar a utilizar la nueva configuración de pasarela mientras la pasarela de la Versión 5.1 existente se sigue ejecutando.
Acerca de esta tarea
El proceso de migración toma una aplicación de pasarela de Versión 5.1 cuya configuración se haya exportado a un archivo XML y utiliza el archivo XML exportado para configurar las mismas funciones de pasarela en un solo servidor de aplicaciones o clúster en la versión posterior. Para ello, exporte la configuración de pasarela de Versión 5.1 y, a continuación, ejecute un script para migrar la configuración exportada a una nueva instancia de pasarela de un servidor de aplicaciones o clúster ya existente en la versión posterior.
- Como parte del proceso de migración, se creará automáticamente una instancia de pasarela.
- Los servicios Gateway, los servicios de destino y las referencias UDDI se migran directamente.
- También se migran las definiciones que hay en la pasarela de manejadores y listas de manejadores JAX-RPC. Debe asegurarse de que las clases de manejadores subyacentes estén disponibles durante la ejecución.
- Las asignaciones de servicios Gateway a canales específicos se sustituyen por asignaciones equivalentes a pares de escucha de punto final y puerto de entrada específico (ya que en versiones posteriores la funcionalidad de un canal se comparte entre un escucha de punto final y un puerto de entrada). Cualquier uso de una canal SOAP de Apache se migra a un escucha de punto final SOAP sobre HTTP y un puerto de entrada.
- Los filtros existentes no se migran. El uso de filtros está en desuso en Versión 5.1.1 y el soporte de los filtros se eliminó en la versión 7. El rol desempeñado anteriormente por los filtros lo lleva a cabo ahora una combinación de manejadores JAX-RPC y mediaciones de bus de integración de servicios.
- Los clientes de servicios Web que se generan a partir del WSDL para el servicio de destino, no para el servicio Gateway, se marcan de forma predeterminada en versiones posteriores como si fueran un error.
- Si utilizó el WSDL del servicio Gateway Versión 5.1 para generar los clientes de servicios Gateway y su enlace WSDL y estilo de codificación no es documento literal, después de la migración a una versión posterior debe volver a generar los apéndices de cliente utilizando el nuevo WSDL de servicio Gateway.
- Los enlaces de WS-Security se migran como enlaces que
cumplen la especificación WS-Security Draft 13. No obstante:
- La versión final (1.0) de la especificación WS-Security (implementada en WebSphere Application Server Versión 6) no es compatible con la versión Draft 13 y, por consiguiente, WS-Security Draft 13 se ha dejado de utilizar en WebSphere Application Server Versión 6. El uso de la especificación del borrador 13 de WS-Security está en desuso y sólo debe utilizarla para permitir el uso continuado de una aplicación cliente de servicios web existente que se ha escrito en la especificación del borrador 13 de WS-Security.
- Los objetos de enlace de WS-Security sólo se migran si el proceso de migración se ejecuta en la máquina en que funciona el servidor de destino en caso de un servidor autónomo, o en la máquina en que se ejecuta el gestor de despliegue en una configuración de Network Deployment.
- Sólo se migran los objetos de enlace de WS-Security utilizados por una configuración WS-Security de servicio Gateway o servicio de destino. Cualquier objeto de enlace que se haya creado pero que no se utilice, no se migrará. Por ejemplo: si tiene una configuración de WS-Security que hace referencia a un objeto Información de firma, y éste hace referencia a un Ancla de confianza, los objetos Información de firma y Ancla de confianza se migrarán junto con la configuración de WS-Security que hace referencia a los mismos.
- La migración da por supuesto que las direcciones web externas para los servicios migrados no se modificarán. Esta suposición se basa en la expectativa de que estas direcciones están asociadas con un servidor web en vez de estarlo con la máquina en que está alojada la pasarela, y que, por lo tanto, el nombre de host y el número de puerto para estas direcciones no se ven afectados. Si en su configuración las direcciones web externas apuntan a la máquina de pasarela, modifique la configuración de escucha de punto final después de haber completado el proceso de migración.
- Puede utilizar WebSphere Application Server Network Deployment para migrar a un único servidor que se ejecute bajo uno de los perfiles de configuración (servidor autónomo o gestor de despliegue). Sin embargo, es recomendable migrar a un solo servidor que se ejecute bajo un perfil de gestor de despliegue. Si migra a un perfil de servidor autónomo, no podrá utilizar la consola administrativa para modificar posteriormente la configuración de pasarela.
- Los servicios web habilitados para bus de integración de servicios validan los mensajes de servicio web de forma más exhaustiva que en WebSphere Application Server Versión 5.1. Como consecuencia, algunas aplicaciones cliente que utilizan solicitudes o respuestas con formato defectuoso (donde las partes del mensaje reciben nombres erróneos), y que funcionan cuando se utiliza Versión 5.1, se identifican ahora como mensajes de formato defectuoso. Para ver los pasos que deben seguirse para resolver el problema, consulte Servicios web habilitados para bus: Limitaciones conocidas.
Para migrar una configuración de pasarela existente de un servidor de aplicaciones de la Versión 5.1 a la función de pasarela de un servidor de aplicaciones o clúster de una versión posterior, siga estos pasos:
Procedimiento
Qué hacer a continuación
- Si la pasarela de Versión 5.1 utilizaba filtros, vuelva a crear las funciones de filtro utilizando una combinación de manejadores JAX-RPC y mediaciones de bus de integración de servicios.
- Si la configuración de pasarela incluye servicios Gateway que tengan varios servicios de destino, la configuración de la Versión 5.1 podría haber utilizado un filtro de direccionamiento para elegir un servicio de destino en particular. Si este es el caso, deberá configurar la pasarela migrada para elegir un servicio y puerto de destino a través de una mediación de direccionamiento.
- Web Services Gateway en una versión posterior utiliza más memoria para procesar un mensaje, por lo que, si pasa un archivo adjunto grande a través de la pasarela migrada, podría recibir un error de memoria agotada en la máquina virtual Java. Para solucionar este problema, aumente el tamaño de almacenamiento dinámico JVM.