Ejecución de IBM Thin Client for Enterprise JavaBeans (EJB)

Un cliente EJB es una aplicación RMI (invocación de método remoto) a través de RMI-IIOP (Internet Inter-ORB Protocol) Java™ Platform, Standard Edition (Java SE) que accede a Enterprise Java Beans remotos desde un servidor a través de una búsqueda JNDI (Java Naming and Directory Interface). El cliente ligero de IBM® para EJB ofrece un menor espacio y es fácil de desplegar en un entorno Java SE y un entorno RCP (Rich Client Platform) de Eclipse. Puede incluir el cliente ligero de IBM para la biblioteca EJB utilizando la instalación de WebSphere Application Server o la instalación de Application Client para WebSphere Application Server con su aplicación. El cliente ligero de IBM para EJB también amplía la oferta de tiempos de ejecución Java SE. Se puede ejecutar en el entorno Java Runtime Environment (JRE) que se empaqueta con el producto WebSphere Application Server, el JRE que se descarga del sitio web de Oracle o el JRE que se descarga del sitio web de HP.

Antes de empezar

[AIX Solaris HP-UX Linux Windows][IBM i]La biblioteca de implementación ORB de IBM es necesaria si el cliente ligero de IBM para EJB se ejecuta con un JRE de producto no IBM o una plataforma de producto no IBM. Por ejemplo, ejecutar el cliente ligero de IBM para EJB con el JRE de Sun Microsystems JRE en Windows, Linux o Solaris, y con el JRE de HP en HP-UX. El híbrido de Solaris proporcionado por IBM y el JRE híbrido de HP no se consideran entornos JRE de productos no IBM.

El cliente ligero de IBM para EJB puede acceder a los EJB de las versiones 2.x y 3.x en WebSphere Application Server utilizando la búsqueda JNDI, pero no puede acceder a los EJB de la versión 3.x a través de la inyección de recursos. La inyección de recursos está soportada si la aplicación cliente es un cliente de aplicaciones Java Platform, Enterprise Edition (Java EE) que se ejecuta en el contenedor del cliente de aplicaciones Java Platform, Enterprise Edition (Java EE).

Antes de configurar un entorno de cliente ligero EJB, debe obtener el archivo JAR (Java archive) para el cliente ligero de EJB para WebSphere Application Server. Para obtener EJB Thin Client for WebSphere Application Server, instale WebSphere Application Server o el cliente de aplicaciones. El archivo de EJB Thin Client for WebSphere Application Server, [AIX Solaris HP-UX Linux Windows][IBM i]com.ibm.ws.ejb.thinclient_8.5.0.jar[z/OS]com.ibm.ws.ejb.thinclient.zos_8.5.0.jar, se encuentra en el directorio raíz_servidor_aplicaciones\runtimes. [z/OS]Utilice com.ibm.ws.ejb.thinclient.zos_8.5.0.jar para cualquier cliente que se ejecute en z/OS. [AIX Solaris HP-UX Linux Windows][IBM i]Utilice com.ibm.ws.ejb.thinclient.jar para cualquier cliente que se ejecute en plataformas distribuidas. La determinación del cliente que se va a utilizar depende de la plataforma de cliente, y no de la plataforma del servidor al que se conecta.

Copie el archivo JAR Java Archive) para el cliente ligero de IBM para EJB con el producto WebSphere Application Server, [AIX Solaris HP-UX Linux Windows][IBM i]com.ibm.ws.ejb.thinclient_8.5.0.jar[z/OS]com.ibm.ws.ejb.thinclient.zos_8.5.0.jar y los archivos endorsed_apis_8.5.0.jar en otras máquinas para crear un entorno de cliente ligero que permita las comunicaciones con los productos. Las copias del cliente ligero de IBM para EJB están sujetas a los mismos términos y condiciones del acuerdo de licencia para el producto WebSphere donde se ha obtenido el cliente ligero para EJB. Consulte los acuerdos de licencia para un uso correcto y otras limitaciones.

Copie el archivo raíz_servidor_aplicaciones\runtimes\endorsed\endorsed_apis_8.5.0.jar en el directorio predeterminado, JAVA_JRE\lib\endorsed. Como alternativa, puede utilizar la propiedad java.endorsed.dirs para especificar un directorio de su elección. Si elige utilizar un directorio alternativo, se recomienda incluir sólo el archivo JAR endorsed_apis.

[AIX Solaris HP-UX Linux Windows][IBM i]El cliente ligero de IBM para EJB con WebSphere Application Server se ejecuta en sistemas operativos distribuidos con soporte de JDK. Cuando utilice el cliente ligero de IBM para EJB como una aplicación Java SE autónoma con un JRE de un producto no de IBM, debe alterar temporalmente la implementación del ORB predeterminada para el JRE mediante uno de los métodos siguientes:
  • Incluya el archivo com.ibm.ws.orb_8.5.0.jar en la classpath del sistema Java.
  • Altere temporalmente la implementación ORB en el JRE, utilizando el Java Endorsed Standards Override Mechanism.
  • Establezca la vía de acceso java.endorsed.dirs en un directorio que contenga el archivo com.ibm.ws.orb_8.5.0.jar.
Al ejecutar el cliente ligero de IBM para EJB como aplicación RCP de Eclipse, se recomienda utilizar el método dos, para alterar temporalmente la implementación ORB JRE por omisión.
Atención: Cuando ejecuta el cliente ligero IBM para EJB, y se utiliza la opción de línea de mandatos -Djava.util.logging.manager=com.ibm.ws.bootstrap.WsLogManager, se emite un error ClassDefNotFoundError. El uso de WsLogManager no se admite en el cliente ligero IBM para EJB, pero puede utilizar otro gestor de registros cronológicos Java.

Acerca de esta tarea

Ejecute el cliente ligero de IBM para EJB realizando los siguientes pasos.

Procedimiento

  1. Invoque la aplicación cliente. Ejecute el mandato Java:
    [Windows]
    <raíz_instalación_java>\bin\java  
    -classpath com.ibm.ws.ejb.thinclient_8.5.0.jar;<lista_de_jars_y_clases_de_su_aplicación>
    -Djava.naming.provider.url=iiop://<nombre_máquina_servidor_aplicaciones>
    <nombre_clase_completo_a_ejecutar>
    Añada las siguientes propiedades del sistema al mandato Java si desea habilitar la autenticación y SSL:[AIX][HP-UX][Solaris][Linux]
    <raíz_instalación_java>/bin/java  
    -classpath com.ibm.ws.ejb.thinclient_8.5.0.jar:<lista_de_jars_y_clases_de_su_aplicación>
    -Djava.naming.provider.url=iiop://<nombre_máquina_servidor_aplicaciones> 
    -Dcom.ibm.SSL.ConfigURL=file:///home/user1/ssl.client.props
    -Dcom.ibm.CORBA.ConfigURL=file:///home/user1/sas.client.props
    <nombre_clase_completo_a_ejecutar>
    [z/OS]
    export LIBPATH=<raíz_servidor_aplic>/lib:$LIBPATH
    <raíz_instalación_java>/bin/java  
    -classpath com.ibm.ws.ejb.thinclient.zos_8.5.0.jar:<lista_de_clases_y_jars_de_su_aplicación>
    -Djava.naming.provider.url=iiop://<nombre_máquina_servidor_aplicaciones> 
    -Dcom.ibm.SSL.ConfigURL=file:///home/user1/ssl.client.props
    -Dcom.ibm.CORBA.ConfigURL=file:///home/user1/sas.client.props
    <nombre_clase_completo_a_ejecutar>
  2. Proporciona la configuración de autenticación IIOP y la configuración del cliente SSL. Añada las siguientes propiedades del sistema al mandato Java:
    -Dcom.ibm.SSL.ConfigURL=file:///home/user1/ssl.client.props
    -Dcom.ibm.CORBA.ConfigURL=file:///home/user1/sas.client.props
    Puede obtener el archivo ssl.client.props y el archivo sas.client.props desde la instalación de WebSphere Application Server y modificar el archivo para que se ajuste a su entorno. Como mínimo, debe actualizar la ubicación de los archivos de clave del archivo ssl.client.props para que coincida con la ubicación del entorno de destino. Por ejemplo,
    -Dcom.ibm.ssl.keyStore=/home/user1/etc/key.p12 
    -Dcom.ibm.ssl.trustStore=/home/user1/etc/trust.p12
    [AIX Solaris HP-UX Linux Windows][IBM i]Los valores de configuración SSL recomendados cuando se ejecuta la aplicación con un JRE de producto no IBM:
    com.ibm.ssl.protocol=SSL
    com.ibm.ssl.trustManager=SunX509
    com.ibm.ssl.keyManager=SunX509
    com.ibm.ssl.contextProvider=SunJSSE
    
    com.ibm.ssl.keyStoreType=JKS
    com.ibm.ssl.keyStoreProvider=SUN
    com.ibm.ssl.keyStore=/home/user1/etc/key.jks
    
    com.ibm.ssl.trustStoreType=JKS
    com.ibm.ssl.trustStoreProvider=SUN
    com.ibm.ssl.trustStore=/home/user1/etc/trust.jks

    [AIX Solaris HP-UX Linux Windows][IBM i]El archivo del almacén de claves y el archivo del almacén de confianza se deben crear utilizando el programa de utilidad keytool de Java antes de ejecutar la aplicación. No se da soporte a la generación automática de archivos de claves con un JRE de un producto que no es de IBM.

    [AIX Solaris HP-UX Linux Windows][IBM i]Debe alterar temporalmente la implementación ORB predeterminada del JRE del producto que no es de IBM con el archivo com.ibm.ws.orb_8.5.0.jar, o añadirlo a la vía de acceso de clases.

  3. Ejecute la aplicación cliente:
    • Introduzca el mandato siguiente si ha copiado el archivo endorsed_apis_8.5.0.jar en el directorio predeterminado JAVA_JRE\lib\endorsed; por ejemplo:
      [Windows][z/OS]
      %JAVA_HOME%\bin\java -Dcom.ibm.SSL.ConfigURL=file:\\\home\sample\ssl.client.props <su_aplicación_cliente>
      [AIX][HP-UX][Solaris][Linux][IBM i]
      $JAVA_HOME/bin/java -Dcom.ibm.SSL.ConfigURL=file:///home/sample/ssl.client.props <aplicación_cliente>
    • Introduzca el mandato siguiente si ha copiado el archivo endorsed_apis_8.5.0.jar en un directorio distinto del predeterminado JAVA_JRE\lib\endorsed; por ejemplo:
      [Windows][z/OS]
      %JAVA_HOME%\bin\java
      -Djava.endorsed.dirs=<directorio_que_incluye_endorsed_apis_8.5.0.jar>
      -Dcom.ibm.SSL.ConfigURL=file:\\\home\sample\ssl.client.props <your_client_application>
      [AIX][HP-UX][Solaris][Linux][IBM i]
      $JAVA_HOME/bin/java
      -Djava.endorsed.dirs=<directorio_que_incluye_endorsed_apis_8.5.0.jar>
      -Dcom.ibm.SSL.ConfigURL=file:///home/sample/ssl.client.props <aplicación_cliente>

Qué hacer a continuación

Habilite el rastreo para el cliente ligero de IBM para EJB añadiendo lo siguiente al mandato Java.
  -Dcom.ibm.ejs.ras.lite.traceSpecification=*=all

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=tcli_ejbthinclient
File name: tcli_ejbthinclient.html