运行 IBM Thin Client for Enterprise JavaBeans (EJB)

EJB 客户端是通过 Internet Inter-ORB 协议 (RMI-IIOP) Java™ 平台进行的远程方法调用，Standard Edition（Java SE）应用程序通过 Java 命名和目录接口 (JNDI) 查找从服务器访问远程企业 Java Bean。 IBM® EJB 瘦客户端占用空间较小，易于部署到 Java SE 环境和Eclipse富客户端平台 (RCP) 环境。 您可以捆绑IBM使用 EJB 库的瘦客户端WebSphere® Application Server安装或应用程序客户端WebSphere Application Server与您的应用程序一起安装。 这IBM EJB 的瘦客户端还扩展了 Java SE 运行时的选择。 它可以在随附的 Java 运行时环境 (JRE) 中运行WebSphere Application Server产品，从Oracle网站或从 HP 网站下载的 JRE。

准备工作

[AIX Solaris HP-UX Linux Windows][IBM i]这IBM如果IBM EJB 的瘦客户端正在运行非IBM产品 JRE 在非IBM产品平台。 例如，运行IBM在 Windows 上使用 Sun Microsystems JRE 的 EJB 瘦客户端， Linux®或 Solaris，并且安装了 HP JREHP-UX。 IBM 提供的 Solaris 混合 JRE 以及 HP 混合 JRE 不会被视为非 IBM 产品 JRE 环境。

这IBM EJB 的瘦客户端可以访问版本2.x和版本3.x EJB 上WebSphere Application Server使用 JNDI 查找，但无法访问版本3.x EJB 通过资源注入。 如果客户端应用程序是Java Platform, Enterprise Edition（ Java EE ）应用程序客户端在Java Platform, Enterprise Edition（ Java EE )应用程序客户端容器。

在设置 EJB Thin Client 环境之前，请获取 EJB Thin Client 的 Java 存档 (JAR) 文件WebSphere Application Server。 获取 EJB 瘦客户端WebSphere Application Server， 安装WebSphere Application Server或应用程序客户端。 EJB 瘦客户端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 ，位于app_server_root\runtimes目录。 [z/OS]Use the com.ibm.ws.ejb.thinclient.zos_8.5.0.jar对于正在运行的任何客户端z/OS。 [AIX Solaris HP-UX Linux Windows][IBM i]使用com.ibm.ws.ejb.thinclient.jar适用于在分布式平台上运行的任何客户端。 应根据客户机平台而不是您要连接至的服务器的平台来确定要使用的客户机。

复制 Java 档案 (JAR) 文件IBM带有 EJB 的瘦客户端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和endorsed_apis_8.5.0.jar文件，传输到其他机器来创建一个能够与产品进行通信的轻量级客户端环境。 副本IBM EJB 瘦客户端受许可协议的相同条款和条件约束WebSphere您从中获取 EJB 瘦客户端的产品。 请参阅许可协议以了解正确的用法及其他局限性。

复制app_server_root\runtimes\endorsed\endorsed_apis_8.5.0.jar文件放入默认目录，JAVA_JRE\lib\endorsed 。 或者，可使用 java.endorsed.dirs 属性以指定您选择的目录。 如果选择使用备用目录，那么最好只包括 endorsed_apis JAR 文件。

[AIX Solaris HP-UX Linux Windows][IBM i]这IBM带有 EJB 的瘦客户端WebSphere Application Server运行在支持 JDK 的分布式操作系统上，包括版本 6 和版本 7。 使用时IBM EJB 瘦客户端作为独立的 Java SE 应用程序，具有非IBM产品 JRE，您必须通过下列方法之一覆盖 JRE 的默认 ORB 实现：
  • 包括com.ibm.ws.orb_8.5.0.jar Java 系统类路径中的文件。
  • 使用 Java 认可标准覆盖机制覆盖 JRE 中的默认 ORB 实现。
  • 将 java.endorsed.dirs 路径设置为 com.ibm.ws.orb_8.5.0.jar 文件所在的目录。
运行IBM EJB 的瘦客户端EclipseRCP 应用程序中，建议使用方法二，覆盖默认的 JRE ORB 实现。
已弃用的功能：可插入应用程序客户端已被弃用。 取而代之的是IBM EJB 的瘦客户端。
注意力：运行IBM EJB 的瘦客户端，以及-Djava.util.logging.manager=com.ibm.ws.bootstrap.WsLogManager使用命令行选项时，ClassDefNotFoundError抛出错误。 指某东西的用途WsLogManager不支持IBM EJB 的瘦客户端，但您可以使用另一个 Java 日志管理器。

有关此任务

跑过IBM通过完成以下步骤，EJB 的瘦客户端。

过程

  1. 调用客户机应用程序。
    运行以下 Java 命令：
    [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>
    如果要启用身份验证和 SSL，请将以下系统属性添加到 Java 命令中：[Linux][AIX][HP-UX][Solaris]
    <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. 提供 IIOP 认证配置和客户机 SSL 配置。
    将以下系统属性添加到 Java 命令：
    -Dcom.ibm.SSL.ConfigURL=file:///home/user1/ssl.client.props
-Dcom.ibm.CORBA.ConfigURL=file:///home/user1/sas.client.props
    您可以获得ssl.client.props文件和sas.client.props文件来自WebSphere Application Server安装并修改文件以适合您的环境。 您必须至少在 ssl.client.props 文件中更新密钥文件的位置，以使其与目标环境的位置匹配。 例如
    -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]使用非 SSL 协议运行应用程序时推荐的 SSL 配置设置IBM产品 JRE：
    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]在应用程序运行之前，必须使用 Java keytool 实用程序创建密钥库文件和信任库文件。 不支持使用非 IBM 产品的 JRE 来生成自动密钥文件。

    [AIX Solaris HP-UX Linux Windows][IBM i]您必须覆盖非IBM产品 JRE 与com.ibm.ws.orb_8.5.0.jar文件，或者将其添加到类路径中。

  3. 运行客户机应用程序：
    • 如果已将 endorsed_apis_8.5.0.jar 文件复制到 JAVA_JRE\lib\endorsed 缺省目录中，请输入以下命令；例如：
      [Windows][z/OS]
      %JAVA_HOME%\bin\java -Dcom.ibm.SSL.ConfigURL=file:\\\home\sample\ssl.client.props <your_client_application>
      [Linux][AIX][HP-UX][IBM i][Solaris]
      $JAVA_HOME/bin/java -Dcom.ibm.SSL.ConfigURL=file:///home/sample/ssl.client.props <your_client_application>
    • 如果已将 endorsed_apis_8.5.0.jar 文件复制到缺省 JAVA_JRE\lib\endorsed 目录以外的目录，请输入以下命令；例如：
      [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>
      [Linux][AIX][HP-UX][IBM i][Solaris]
      $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>

下一步做什么？

要启用跟踪，请参阅有关在客户端和独立应用程序上启用跟踪的主题。