Exécution du client léger IBM pour EJB (Enterprise JavaBeans)

Un client EJB est une application Java™ SE (Java Platform, Standard Edition) RMI-IIOP (Remote Method Invocation over Internet Inter-ORB Protocol) qui accède à des EJB (Enterprise Java Beans) distants à partir d'un serveur via la recherche JNDI (Java Naming and Directory Interface). Avec son empreinte réduite, IBM® Thin Client for EJB peut être déployé aussi bien dans un environnement Java SE que dans un environnement Eclipse Rich Client Platform (RCP). Vous pouvez incorporer la bibliothèque du client léger IBM Thin Client for EJB dans votre application en utilisant l'installation de WebSphere Application Server ou d'Application Client for WebSphere Application Server. Le client léger IBM pour EJB ne se limite pas à l'environnement d'exécution Java SE. Il peut être exécuté dans l'environnement JRE (Java Runtime Environment) intégré au produit WebSphere Application Server, dans l'environnement JRE téléchargé depuis le site Web Oracle ou dans l'environnement JRE téléchargé depuis le site Web HP.

Avant de commencer

[AIX Solaris HP-UX Linux Windows][IBM i]La bibliothèque d'implémentation ORB d'IBM est requise si le client IBM Thin Client for EJB est exécuté dans un JRE autre que celui d'IBM ou sur une plateforme non IBM. C'est le cas, par exemple, si IBM Thin Client for EJB fonctionne dans un JRE Sun Microsystems sous Windows, Linux ou Solaris, ou dans le JRE HP sous HP-UX. Les environnements JRE hybrides Solaris et HP fournis par IBM ne sont pas considérés comme des JRE de produits non IBM.

IBM Thin Client for EJB peut accéder aux EJB versions 2.x et 3 exécutés dans WebSphere Application Server via la recherche JNDI, mais il ne peut pas accéder aux EJB version 3.x via l'injection de ressources. L'injection de ressources est prise en charge si l'application client est un client d'application Java EE (Java Platform, Enterprise Edition) s'exécutant dans l'environnement Java, conteneur du client d'application Java EE.

Avant de configurer un environnement Thin Client for EJB, procurez-vous le fichier JAR (fichier d'archive Java) d'IBM EJB Thin Client for WebSphere Application Server. Pour ce faire, installez WebSphere Application Server ou Application Client for WebSphere Application Server. Le fichier d'IBM 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, est situé dans le répertoire racine_serveur_app\runtimes. [z/OS]Utilisez le fichier com.ibm.ws.ejb.thinclient.zos_8.5.0.jar pour tout client exécuté sous z/OS. [AIX Solaris HP-UX Linux Windows][IBM i]Utilisez le fichier com.ibm.ws.ejb.thinclient.jar pour tout client exécuté sur des plateformes réparties. Le choix du client à utiliser dépend de la plateforme client et non de la plateforme du serveur auquel vous vous connectez.

Copiez le fichier JAR (Java archive) pour le client IBM Thin Client pour EJB avec le produit WebSphere Application Server, les fichiers [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 et endorsed_apis_8.5.0.jar sur d'autres machines afin d'y créer un environnement client léger permettant de communiquer avec les produits. Les copies d'IBM Thin Client for EJB sont sujettes aux mêmes termes et conditions que le contrat de licence du produit WebSphere dans lequel vous avez obtenu Thin Client for EJB. Pour connaître la syntaxe correcte et d'autres limitations, consultez le contrat de licence.

Copiez le fichier racine_serveur_app\runtimes\endorsed\endorsed_apis_8.5.0.jar dans le répertoire par défaut, JAVA_JRE\lib\endorsed. Vous pouvez également utiliser la propriété java.endorsed.dirs pour spécifier un répertoire de votre choix. Si vous choisissez d'utiliser un autre répertoire, il est recommandé de n'inclure que le fichier JAR endorsed_apis.

[AIX Solaris HP-UX Linux Windows][IBM i]IBM Thin Client for EJB avec WebSphere Application Server s'exécute sur des systèmes d'exploitation distribués avec le support JDK. Si vous utilisez IBM Thin Client for EJB en tant qu'application Java SE autonome avec un environnement JRE non IBM, vous devez remplacer l'implémentation ORB par défaut de ce JRE en procédant de l'une des manières suivantes :
  • Ajoutez le fichier com.ibm.ws.orb_8.5.0.jar dans le chemin d'accès aux classes système Java.
  • Remplacez l'implémentation ORB par défaut dans l'environnement JRE à l'aide du mécanisme Java Endorsed Standards Override Mechanism.
  • Faites pointer la propriété java.endorsed.dirs sur un répertoire contenant le fichier com.ibm.ws.orb_8.5.0.jar.
Si vous exécutez IBM Thin Client for EJB comme application Eclipse RCP, il est recommandé d'utiliser la deuxième méthode pour remplacer l'implémentation ORB par défaut du JRE.
Avertissement : Si vous lancez IBM Thin Client for EJB avec l'option de ligne de commande -Djava.util.logging.manager=com.ibm.ws.bootstrap.WsLogManager, il se produit une erreur ClassDefNotFoundError. WsLogManager n'est pas pris en charge dans IBM Thin Client for EJB, mais vous pouvez utiliser un autre gestionnaire de journaux Java.

Pourquoi et quand exécuter cette tâche

Exécutez IBM Thin Client for EJB en procédant comme suit.

Procédure

  1. Appelez l'application client. Exécutez la commande Java suivante :
    [Windows]
    <java_install_root>\bin\java  
    -classpath com.ibm.ws.ejb.thinclient_8.5.0.jar;<list_of_your_application_jars_and_classes> 
    -Djava.naming.provider.url=iiop://<your_application_server_machine_name>
    <fully_qualified_class_name_to_run>
    Ajoutez les propriétés système suivantes à la commande Java pour activer les fonctions d'authentification et SSL :[AIX][HP-UX][Solaris][Linux]
    <java_install_root>/bin/java  
    -classpath com.ibm.ws.ejb.thinclient_8.5.0.jar:<list_of_your_application_jars_and_classes> 
    -Djava.naming.provider.url=iiop://<your_application_server_machine_name> 
    -Dcom.ibm.SSL.ConfigURL=file:///home/user1/ssl.client.props
    -Dcom.ibm.CORBA.ConfigURL=file:///home/user1/sas.client.props
    <fully_qualified_class_name_to_run>
    [z/OS]
    export LIBPATH=<app_server_root>/lib:$LIBPATH
    <java_install_root>/bin/java  
    -classpath com.ibm.ws.ejb.thinclient.zos_8.5.0.jar:<list_of_your_application_jars_and_classes> 
    -Djava.naming.provider.url=iiop://<your_application_server_machine_name> 
    -Dcom.ibm.SSL.ConfigURL=file:///home/user1/ssl.client.props
    -Dcom.ibm.CORBA.ConfigURL=file:///home/user1/sas.client.props
    <fully_qualified_class_name_to_run>
  2. Configurez l'authentification IIOP et le SSL du client. Ajoutez les propriétés système suivantes à la commande Java :
    -Dcom.ibm.SSL.ConfigURL=file:///home/user1/ssl.client.props
    -Dcom.ibm.CORBA.ConfigURL=file:///home/user1/sas.client.props
    Vous pouvez obtenir les fichiers ssl.client.props et sas.client.props à partir de l'installation de WebSphere Application Server et les modifier en fonction de votre environnement. Vous devez au moins mettre à jour l'emplacement des fichiers de clés dans le fichier ssl.client.props afin qu'il corresponde à l'emplacement de votre environnement cible. Par exemple,
    -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]Paramètres de configuration SSL recommandés lors de l'exécution de l'application dans un environnement JRE non 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]Le fichier de clés et le fichier de clés certifiées doivent être créés à l'aide de l'outil de clé Java avant que l'application ne soit exécutée. La génération automatique de fichier de clés n'est pas prise en charge avec un environnement d'exécution Java (JRE) non IBM.

    [AIX Solaris HP-UX Linux Windows][IBM i]Vous devez remplacer l'implémentation ORB par défaut du JRE du produit non IBM par le fichier com.ibm.ws.orb_8.5.0.jar, ou ajouter ce dernier au chemin de classes.

  3. Lancez votre application client :
    • Entrez la commande suivante si vous avez copié le fichier endorsed_apis_8.5.0.jar dans le répertoire par défaut JAVA_JRE\lib\endorsed. Par exemple :
      [Windows][z/OS]
      %JAVA_HOME%\bin\java -Dcom.ibm.SSL.ConfigURL=file:\\\home\sample\ssl.client.props <your_client_application>
      [AIX][HP-UX][Solaris][Linux][IBM i]
      $JAVA_HOME/bin/java -Dcom.ibm.SSL.ConfigURL=file:///home/sample/ssl.client.props <your_client_application>
    • Entrez la commande suivante si vous avez copié le fichier endorsed_apis_8.5.0.jar dans un répertoire autre que le répertoire par défaut JAVA_JRE\lib\endorsed. Par exemple :
      [Windows][z/OS]
      %JAVA_HOME%\bin\java 
      -Djava.endorsed.dirs=<directory_that_includes_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=<directory_that_includes_endorsed_apis_8.5.0.jar>
      -Dcom.ibm.SSL.ConfigURL=file:///home/sample/ssl.client.props <your_client_application>

Que faire ensuite

Activez la trace pour le client léger IBM pour EJB en ajoutant la ligne de code suivante à la commande Java :
  -Dcom.ibm.ejs.ras.lite.traceSpecification=*=all

Icône indiquant le type de rubrique Rubrique de tâche



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tcli_ejbthinclient
Nom du fichier : tcli_ejbthinclient.html