Creación de una configuración de escucha de punto final nueva

Un escucha de punto final es el punto (dirección) en el que se reciben mensajes de un servicio de entrada. Los escuchas de punto final proporcionados con el soporte WebSphere Application Server SOAP sobre HTTP y SOAP sobre enlaces JMS.

Antes de empezar

Para cada servidor o clúster que debe alojar un escucha de punto final, debe instalar y configurar un repositorio SDO (Service Data Objects) en el servidor autónomo, o (para un servidor o clúster que forme parte de una célula gestionada) en la célula de despliegue de red.

Si desea cambiar el rol de seguridad del escucha de punto final HTTP predeterminado, debe hacerlo antes de configurar el escucha de punto final SOAP sobre HTTP.

Antes de configurar un escucha de punto final SOAP sobre JMS, configure los recursos JMS asociados.

Puede establecer escuchas de punto final independientes para las peticiones de entrada y salida. Para obtener más información, consulte el apartado Escuchas de punto final y puertos de entrada: puntos de entrada al bus de integración de servicios.

Decida qué método se debe utilizar para configurar estos recursos. Puede crear una nueva configuración de escucha de punto final utilizando la consola administrativa como se describe en esta tarea, o bien utilizando el Mandato createSIBWSEndpointListener.
Nota: Si desea crear una configuración de escucha de punto final para su propia aplicación de escucha de punto final, en lugar de para una de las escuchas proporcionadas con WebSphere Application Server, debe utilizar la herramienta wsadmin.

Acerca de esta tarea

Los escuchas de punto final son un punto final físico para recibir solicitudes de servicio de entrada. Un servicio de entrada describe un destino de bus como un servicio web lógico. Un puerto de entrada asocia un servicio de entrada (lógico) a un escucha de punto final para proporcionar un punto final (físico) donde se pueda invocar al servicio. Por lo tanto, debe haber definido un escucha de punto final antes de poder crear un puerto de entrada.

Una petición llega a un escucha de punto final. Pasa a un puerto de entrada, en el que pueden aplicarse las listas de manejadores JAX-RPC y la seguridad y, a continuación, se envía al destino de servicio. Las respuestas siguen la misma vía pero a la inversa.

La configuración de un nuevo escucha de punto final para ser utilizado con un servicio de entrada es un proceso de dos fases:
  1. Configure el escucha para un servidor de aplicaciones o clúster específico (tal como se describe en esta tarea).
  2. Configure un servicio de entrada en el mismo bus para utilizar el escucha (tal como se describe en la tarea Convertir un servicio alojado internamente en disponible como servicio web).

Para utilizar la consola administrativa para configurar un escucha de punto final, efectúe los pasos siguientes:

Procedimiento

  1. Inicie la consola administrativa.
  2. En el panel de navegación, pulse una de las siguientes vías de acceso:
    • Servidores -> Tipos de servidor -> WebSphere Application Servers -> nombre_servidor -> Escuchas de punto final
    • Servidores -> Clústeres -> Clústeres de WebSphere Application Server -> nombre_clúster -> Escuchas de punto final
    Se visualiza el formulario de colección de escuchas de punto final.
  3. Pulse Nuevo. Se visualiza el nuevo asistente de escucha de punto final.
  4. Utilice el asistente para crear la nueva configuración de escucha de punto final efectuando los pasos siguientes. Para obtener más información acerca de las propiedades que se establecen con el asistente, consulte Escuchas de punto final [Valores]. Es posible que desee utilizar los valores determinados de Valores de ejemplo de la configuración de escucha de punto final.
    1. Seleccione el nombre de escucha y el tipo de enlace.
      Nombre de escucha de punto final
      Escriba el nombre elegido por el que se conoce el escucha de punto final. Por ejemplo: wsgwsoaphttp; wsgwsoaphttp2; SOAPJMSChannel1; SOAPJMSChannel2.
      Tipo de enlace
      Seleccione el tipo de enlace que este escucha de punto final soporta. Para un escucha de punto final SOAP sobre HTTP o SOAP sobre HTTPS, seleccione SOAP/HTTP o SOAP/HTTPS. Para un escucha de punto final SOAP sobre JMS, seleccione SOAP/JMS.
    2. Opcional: Configure valores JMS.

      Este panel sólo se visualiza si ha seleccionado SOAP/JMS en el panel anterior.

      Puede elegir desplegar la aplicación de escucha de punto final para utilizar una especificación de activación o un puerto de escucha. Los puertos de escucha se han estabilizado. Para obtener más información, consulte el artículo sobre las características estabilizadas. Siempre que sea posible, deberá desplegar la aplicación de escucha de punto final para utilizar una especificación de activación. Sólo puede utilizar las especificaciones de activación con el proveedor de mensajería predeterminado; puede utilizar las especificaciones de activación o bien los puertos de escucha con el proveedor de mensajería WebSphere MQ.

      Seleccione en las listas desplegables el puerto de escucha o la especificación de activación y fábrica de conexiones de cola que ha configurado previamente como se describe en Configuración de recursos JMS para el escucha de punto final SOAP sobre JMS síncrono.

    3. Configure los URL necesarios. Configure las direcciones web para la raíz de la aplicación y la raíz de servicio WSDL. Puede seleccionar direcciones preconfiguradas basándose en los hosts virtuales conocidos o crear nuevos valores.
      Raíz de URL
      Seleccione o escriba la dirección desde la que los clientes externos acceden al escucha de punto final. La raíz de URL es la raíz de contexto de la aplicación de escucha de punto final y proporciona la raíz de la dirección web que se utiliza para generar las direcciones de punto final dentro de los archivos WSDL para dirigir a los solicitantes a este escucha de punto final.
      Se puede utilizar un servidor HTTP con un servidor de aplicaciones autónomo. De forma alternativa, si clientes externos utilizan el escucha de punto final para acceder a un clúster que proporciona alta disponibilidad o gestión de carga de trabajo, normalmente, el clúster emplea un servidor HTTP configurado de forma apropiada (o servidor proxy WebSphere) que funciona como un distribuidor de IP. En cualquier caso, si los clientes externos acceder al escucha de punto final a través de un servidor HTTP o un clúster de servidores, que utiliza el puerto predeterminado 80, debe especificar el nombre de servidor HTTP y no el número de puerto. Por ejemplo (para el escucha de punto final SOAP sobre HTTP 1):

      http://www.suempresa.com/wsgwsoaphttp1

      Para un servidor de aplicaciones autónomo, el escucha de punto final suele estar configurada para clientes que se conectan directamente a un servidor de aplicaciones individual. Si los clientes externos utilizan el escucha de punto final para acceder a un clúster, puede configurar el escucha para que los clientes se conecten directamente a un servidor de aplicaciones individual dentro del clúster, tal como se muestra en el siguiente ejemplo, pero esto podría limitar las capacidades de alta disponibilidad o gestión de carga de trabajo del clúster. Sin embargo, si permite a los clientes externos conectarse directamente al servidor de aplicaciones (por ejemplo, porque es un servidor autónomo o en un entorno de desarrollo o de prueba) especifique el nombre de host y el número de puerto del servidor de aplicaciones. Por ejemplo (para el escucha de punto final SOAP sobre HTTP 1):

      http://su.nombre.servidor:9080/wsgwsoaphttp1

      donde el número de puerto (especificado como 9080 en este ejemplo) coincide con el valor de puerto WC_defaultHost para el servidor de aplicaciones implicado.
      Raíz de URL HTTP de servicio WSDL
      Escriba la raíz de la dirección web para los archivos WSDL de los servicios de entrada que están disponibles en el escucha de punto final. Esta dirección consta del raíz de la dirección HTTP desde el que los clientes externos acceden a la aplicación de la escucha de punto final, seguido de /sibws. Esto representa el URL que se utiliza al publicar el URL de WSDL en un registro de UDDI. El nombre de host y de puerto que especifica para la Raíz del URL HTTP que da servicio al WSDL normalmente coinciden con los que ha especificado para la Raíz del URL.
      Si los clientes externos acceden al escucha de punto final a través de un servidor HTTP o un clúster de servidores utilizando normalmente el puerto 80 predeterminado, esta raíz de URL incluye el nombre del servidor HTTP pero no un número de puerto. Por ejemplo:
      http://www.suempresa.com/sibws
      No obstante, si permite a los clientes externos conectarse directamente al servidor de aplicaciones (por ejemplo, en un entorno de desarrollo o de prueba), esta raíz de URL incluye el nombre de host del servidor de aplicaciones y el número de puerto. Por ejemplo:
      http://su.nombre.servidor:9080/sibws
      Nota: Otros componentes de WebSphere Application Server (especialmente el registro UDDI de IBM) son los únicos que utilizan internamente el raíz del URL HTTP que da servicio al WSDL. Para los demás usos, debe acceder al archivo WSDL a través del escucha de punto final para el servicio de entrada. Para obtener detalles de la ubicación para un archivo WSDL de servicio de entrada determinado, publique el archivo WSDL en un archivo comprimido tal como se describe en Modificación de una configuración de servicio de entrada existente y, a continuación, busque la ubicación dentro del archivo WSDL exportado.
    4. Seleccione los buses de integración de servicios a los que deberá conectar el nuevo escucha de punto final. Sólo los buses de los que es miembro el servidor de aplicación o clúster están disponibles para ser seleccionados.
  5. Pulse Finalizar.

Resultados

Si el proceso se completa correctamente, la lista de escuchas de punto final se actualiza para incluir el nuevo escucha de punto final. De lo contrario, aparece un mensaje de error.

Qué hacer a continuación

Ya está preparado para seleccionar este escucha de punto final para su uso en un servicio de entrada, como se describe en Convertir un servicio alojado internamente en disponible como servicio web.

Icon that indicates the type of topic Task topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tjw_epl_new_61x
File name: tjw_epl_new_61x.html