Mandato endptEnabler

El mandato endptEnabler para habilitar un conjunto de servicios web en un archivo EAR (Enterprise Archive). El mandato endptEnabler debe ejecutarse en los archivos EAR que contengan módulos EJB (Enterprise JavaBeans) habilitados para los servicios web.

Cada módulo de direccionador proporciona un punto final de servicio web para un transporte determinado. Por ejemplo, se puede añadir un módulo de direccionador HTTP para que el servicio web pueda recibir solicitudes a través del transporte HTTP. O puede añadir un módulo de direccionador JMS (Java™ Message Service) para que el servicio web pueda recibir solicitudes desde un tema o una cola JMS.

En su modalidad interactiva, endptEnabler le guía a través de los pasos necesarios para habilitar uno o más servicios de una aplicación. El mandato endptEnabler hace una copia de seguridad del archivo EAR original en caso de que necesitara eliminar o añadir servicios más adelante. Si el archivo EAR contiene un archivo JAR (Java archive) de enterprise bean habilitado para servicios web, debe ejecutar el mandato endptEnabler antes de desplegar el archivo EAR. Si no es así, no tiene que ejecutar el mandato.

Avoid trouble Avoid trouble: En el script de shell de endptEnabler.sh, el script finaliza con EXIT 0. No utilice este código de retorno para determinar el resultado de ejecución del script. gotcha

Sintaxis de uso de endptEnabler

Invoque el mandato endptEnabler desde el directorio bin de WebSphere Application Server. La sintaxis del mandato se muestra en el siguiente ejemplo:
endptEnabler
    [-verbose|-v]
    [-quiet|-q]
    		[-help|-h|-?]          
    		[-properties|-p nombrearchivo_propiedades]
    		[-transport|-t transportes-por_omisión]
    [-enableHttpRouterSecurity]
    [-enableClientCertSecurity]
    		[nombrearchivo-ear]
    [-classpath|-cp]
Todos los parámetros son opcionales y se describen en la siguiente lista:
-verbose, -v
Este parámetro detalla y muestra los mensajes de progreso cuando la herramienta endptEnabler procesa el archivo EAR. Esta opción de línea de mandatos se correlaciona con la propiedad global verbose.
-quiet, -q
Este parámetro se asegurar de que no se muestre ningún mensaje de progreso por módulo mientras la herramienta procesa el archivo EAR. Esta opción de línea de mandatos se correlaciona con la propiedad global quiet.
-help, -h, -?
Este parámetro muestra un mensaje breve de ayuda explicando las distintas opciones.
-properties, -p <nombre_archivo_propiedades>
Este parámetro lee las propiedades de nombre_archivo_propiedades y controla el comportamiento de la herramienta endptEnabler.
-transport, -t <transportes_por_omisión>
Este parámetro especifica la lista de transportes predeterminada para los que se crean módulos de direccionador para cada archivo JAR de enterprise bean contenido en el archivo EAR. Esta opción de línea de mandatos se correlaciona con la propiedad global de defaultTransports. Los siguientes son ejemplos de este parámetro:
-transport http (the default)
-transport jms
-t http,jms
-enableHttpRouterSecurity
Este parámetro permite añadir una política de seguridad para todos los usuarios autenticados, para proteger el módulo de direccionador HTTP si todos los módulos EJB están protegidos en el archivo JAR de enterprise bean. Esta opción de línea de mandatos se correlaciona con la propiedad global http.enableRouterSecurity.
-enableClientCertSecurity
Este parámetro le permite añadir la siguiente stanza login-config en el archivo web.xml para la autenticación de certificados, en lugar de basic-auth o form-login. Esta opción de línea de mandatos se correlaciona con la propiedad global http.enableClientCertSecurity.
<login-config>
  <auth-method>CLIENT-CERT</auth-method>
</login-config>
Best practice Best practice: Utilice el parámetro -enableClientCertSecurity con el parámetro -enableHttpRouterSecurity. bprac
<nombrearchivo-ear>
Este parámetro especifica el nombre del archivo EAR que se va a ejecutar.

Si no se especifica el parámetro nombrearchivo_ear en la línea de mandatos, se utilizará la modalidad interactiva. En la modalidad interactiva, se deben entrar el nombre del archivo EAR, los nombres de los módulos de direccionador y otros valores importantes mientras se ejecuta el proceso. El siguiente diálogo es un ejemplo de la modalidad interactiva de endptEnabler.

En este diálogo, los datos de entrada del usuario aparecen con font de ancho fijo y los datos de salida de endptEnabler aparecen en negrita.

endptEnabler<intro>   
WSWS2004I: IBM WebSphere Application Server Release 5 
WSWS2005I: Herramienta habilitadora de puntos finales para EAR de Servicios web. 
WSWS2007I: (C) COPYRIGHT International Business Machines Corp. 1997, 2003 
WSWS2006I: Introduzca el nombre del archivo EAR: AddressBook.ear<intro>   

WSWS2003I: Realizando copia de seguridad del archivo EAR en: AddressBook.ear~   

WSWS2016I: Cargando archivo EAR: AddressBook.ear 
WSWS2017I: Se ha encontrado el módulo EJB: AddressBookEJB.jar

WSWS2029I: Entre el nombre del direccionador http del módulo EJB AddressBookEJB 
[AddressBookEJB_HTTPRouter.war]:<intro>
WSWS2030I: Entre el directorio raíz de contexto de http para el módulo EJB AddressBookEJB 
[/AddressBookEJB]:<intro>
WSWS2024I: Añadiendo direccionador http de módulo EJB AddressBookEJB.jar. 
WSWS2036I: Guardando el archivo EAR AddressBook.ear... 
WSWS2037I: Ha finalizado guardar el archivo EAR. 
WSWS2018I: Ha finalizado el proceso del archivo EAR AddressBook.ear.

Si se especifica el parámetro nombrearchivo_ear en la línea de mandatos, se utiliza la modalidad no interactiva. En la modalidad no interactiva, los nombres de los módulos de direccionador y otros valores importantes se determinan a partir de las propiedades especificadas por el usuario o de los valores predeterminados.

-classpath, -cp
Este parámetro permite especificar archivos JAR independientes en la classpath para el mandato endptEnabler. Utilice este parámetro si el archivo EJB hace referencia a tipos Java en archivos JAR independientes que no existen en el archivo EAR. Puede especificar varios valores para este parámetro. Por ejemplo:
endptEnabler -classpath C:\MyWork\Utility.jar;D:\SharedFiles\Hello.zip;HelloWorld.jar

Si no especifica este parámetro, es posible que encuentre un error similar al mensaje siguiente:

WSWS2021I: Omitiendo el módulo de enterprise bean nombre_módulo 
Porque no contiene servicios web.

Propiedades de endptEnabler

Con el mandato endptEnabler se puede controlar el comportamiento del tiempo de ejecución especificando un conjunto de propiedades con la opción de línea de mandatos -properties. Estas propiedades están organizadas de dos formas: global y por módulo. Las propiedades globales afectan al comportamiento general de la herramienta, y procesan varios módulos JAR de enterprise bean dentro del archivo EAR. Las propiedades por módulo afectan al proceso de un módulo JAR de enterprise bean determinado.

Tabla 1. Propiedades globales para el mandato endptEnabler. Utilice estas propiedades globales del mandato endptEnabler cuando habilite un conjunto de servicios web dentro de un archivo EAR (archivador empresarial).
Nombre de propiedad Descripción Valor por omisión
verbose Muestra los mensajes detallados de progreso. False
quiet Muestra sólo mensajes breves de progreso. False
http.enableRouterSecurity Permite añadir una política de seguridad para todos los usuarios autenticados, para proteger el módulo de direccionador HTTP si todos los módulos EJB están protegidos en el archivo JAR de enterprise bean. False
http.enableClientCertSecurity Le permite añadir la siguiente stanza login-config en el archivo web.xml para la autenticación de certificados, en lugar de basic-auth o form-login:
<login-config>
  <auth-method>CLIENT-CERT</auth-method>
</login-config>
False
http.routerModuleNameSuffix Especifica el sufijo utilizado para construir los nombres de módulos de direccionador HTTP predeterminado. El mandato endptEnabler añade la extensión .war. _HTTPRouter
jms.routerModuleNameSuffix Especifica el sufijo utilizado para construir los nombres de módulos de direccionador JMS predeterminado. El mandato endptEnabler añade la extensión .jar. _JMSRouter
jms.defaultDestinationType Especifica el tipo de destino predeterminado que se utiliza para todos los módulos de direccionador JMS añadidos al archivo EAR. Este tipo es queue o topic. queue
defaultTransports Especifica la lista de transportes predeterminados para los que se crean módulos de direccionador. La lista puede contener los valores http y jms. Si hay varios valores, se separan con una coma. Por ejemplo: http, jms y http,jms. http

En la tabla siguiente se describen las propiedades por módulo soportadas por el mandato endptEnabler. La variable ejbJarName hace referencia al nombre de un módulo JAR de enterprise bean dentro del archivo EAR, sin la extensión .jar.

Tabla 2. Propiedades por módulo para el mandato endptEnabler. Utilice estas propiedades del mandato endptEnabler que afectan al proceso de un módulo JAR de enterprise bean concreto.
Nombre de propiedad Descripción Valor por omisión
<NombreJarEjb> .transports
Lista los transportes para los que se deben crear módulos de direccionador para un archivo JAR de enterprise bean determinado. La lista puede contener los valores http y jms. Si hay varios valores, se separan con una coma. Por ejemplo: http, jms y http,jms. http
<NombreJarEjb>.http.skip
Especifica el distintivo que omite la adición de un módulo de direccionador HTTP, aunque se añada por otros procedimientos basándose en otras propiedades. Los valores válidos son true y false. false
<nombreJarEjb> 
.http.routerModuleName
Especifica el nombre del módulo de direccionador HTTP para un archivo JAR de enterprise bean determinado. nombreJarEjb_HTTPRouter
<nombreJarEjb>.http.contextRoot
Especifica la raíz de contexto asociada con el módulo de direccionador HTTP de un archivo JAR de enterprise bean determinado. /nombreJarEjb
<NombreJarEjb>.jms.skip
Especifica el distintivo que omite la adición de un módulo de direccionador JMS, aunque se añada por otros procedimientos basándose en otras propiedades. Los valores válidos son true y false. false
<nombreJarEjb>.jms.
routerModuleName
Especifica el nombre del módulo de direccionador JMS para un archivo JAR de enterprise bean determinado. nombreJarEjb_JMSRouter
<nombreJarEjb>.jms.
activationSpecJndiName
Especifica el nombre JNDI (Java Naming and Directory Interface) de la especificación de activación que se configura para el MDB (bean controlado por mensajes) del módulo de direccionador JMS. null
<nombreJarEjb>.jms.
listenerInputPortName
Especifica el nombre del puerto de escucha que se va a configurar para el MDB dentro del módulo de direccionador JMS. El puerto de escucha se configura sólo si no se especifica una propiedad activationSpecJndiName. null
<nombreJarEjb>.jms.destinationType
Especifica el tipo de destino JMS asociado al MDB dentro del direccionador JMS. Los valores válidos son queue y topic. queue
<nombreJarEjb>.<nombre_local_puerto>
.http.urlPattern=
<nombre_patrón_url>
Especifica el patrón de URL para los puertos. Si tiene un módulo EJB con el nombre indicado que tenga un puerto con el nombre local indicado, puede especificar el patrón de URL HTTP con esta propiedad. Esta propiedad sólo se aplica a módulos de direccionador HTTP. No tiene ningún efecto en módulos de direccionador JMS. null

Ejemplo de propiedades

Supongamos que un archivo EAR contiene un archivo JAR de enterprise bean denominado StockQuoteEJB.jar que contiene servicios web. Se puede utilizar el siguiente conjunto de propiedades para controlar el comportamiento en tiempo de ejecución del mandato endptEnabler mientras procesa el archivo EAR:
StockQuoteEJB.transports=http,jms

StockQuoteEJB.http.routerModuleName=StockQuoteEJB_HTTP

StockQuoteEJB.http.contextRoot=/StockQuote

StockQuoteEJB.jms.routerModuleName=StockQuoteEJB_JMS

StockQuoteEJB.jms.destinationType=queue

Ejemplos de endptEnabler

Los siguientes mandatos son ejemplos de cómo se puede utilizar el mandato endptEnabler:
endptEnabler MyApp.ear

endptEnabler -t jms,http MyApp.ear

endptEnabler -v -properties MyApp.props MyApp.ear

endptEnabler -q -t jms MyApp.ear

endptEnabler -v -t http,jms

Icon that indicates the type of topic Reference topic



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