对 Enterprise JavaBeans (EJB) 运行 IBM 瘦客户机

EJB 客户机是“基于因特网 ORB 间协议的远程方法调用”(RMI-IIOP) Java™ Platform, Standard Edition (Java SE) 应用程序,它通过查找 Java 命名和目录接口 (JNDI) 来访问服务器中的远程 Enterprise Java Beans。IBM® Thin Client for EJB 的覆盖区较小,因此易于部署到 Java SE 环境和 Eclipse 富客户机平台 (RCP) 环境。可通过将 WebSphere® Application Server 安装或 Application Client for WebSphere Application Server 安装与您的应用程序配合使用来捆绑 IBM Thin Client for EJB 库。IBM Thin Client for EJB 还扩展了 Java SE 运行时选项。它可在随 WebSphere Application Server 产品打包的 Java 运行时环境 (JRE)、从 Oracle Web 站点下载的 JRE 或从 HP Web 站点下载的 JRE 中运行。

开始之前

[AIX Solaris HP-UX Linux Windows][IBM i]如果在非 IBM 产品平台上将 IBM Thin Client for EJB 与非 IBM 产品 JRE 配合运行,那么需要 IBM ORB 实现库。例如,在 Windows、Linux 或 Solaris 上将 IBM Thin Client for EJB 与 Sun Microsystems JRE 或者在 HP-UX 上与 HP JRE 配合运行。IBM 提供的 Solaris 混合 JRE 以及 HP 混合 JRE 不会被视为非 IBM 产品 JRE 环境。

IBM Thin Client for EJB 可使用 JNDI 查找操作来访问 WebSphere Application Server 上的 V2.x 和 V3.0 EJB,但无法通过资源注入来访问 V3.x EJB。如果客户机应用程序是在 Java Platform, Enterprise Edition (Java EE) 应用程序客户机容器内运行的 Java Platform, Enterprise Edition (Java EE) 应用程序客户机,那么资源注入是受支持的。

设置 EJB 瘦客户机环境之前,请获取 EJB Thin Client for WebSphere Application Server 的 Java 归档 (JAR) 文件。要获取 EJB Thin Client for WebSphere Application Server,请安装 WebSphere Application Server 或应用程序客户机。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 位于 app_server_root\runtimes 目录。[z/OS]使用 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(对于在分布式平台上运行的任何客户机)。应根据客户机平台而不是您要连接至的服务器的平台来确定要使用的客户机。

WebSphere Application Server 产品附带的 IBM Thin Client for EJB 的 Java 归档 (JAR) 文件([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.jarendorsed_apis_8.5.0.jar 文件)复制到其他机器上,以创建允许与产品通信的轻量级客户机环境。IBM Thin Client for EJB 的副本都遵循从中获取 Thin Client for EJB 的 WebSphere 产品的许可协议的条款和条件。请参阅许可协议以了解正确的用法及其他局限性。

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]WebSphere Application Server 附带的 IBM Thin Client for EJB 在支持 JDK 的分布式操作系统上运行。将 IBM Thin Client for 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 Thin Client for EJB 作为 Eclipse RCP 应用程序运行时,建议使用方法二来覆盖缺省 JRE ORB 实现。
注意: 运行 IBM Thin Client for EJB 并且使用了 -Djava.util.logging.manager=com.ibm.ws.bootstrap.WsLogManager 命令行选项时,将抛出 ClassDefNotFoundError 错误。在 IBM Thin Client for EJB 中,不支持使用 WsLogManager,但您可以使用另一个 Java 日志记录管理器。

关于此任务

通过完成下列步骤,运行 IBM Thin Client for 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 命令中添加下列系统属性: [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. 提供 IIOP 认证配置和客户机 SSL 配置。 将以下系统属性添加到 Java 命令中:
    -Dcom.ibm.SSL.ConfigURL=file:///home/user1/ssl.client.props
    -Dcom.ibm.CORBA.ConfigURL=file:///home/user1/sas.client.props
    可从 WebSphere Application Server 安装中获取 ssl.client.props 文件和 sas.client.props 文件并修改该文件以适应您的环境。您必须至少在 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]将应用程序与非 IBM 产品 JRE 配合运行时,建议的 SSL 配置设置如下:
    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]您必须使用 com.ibm.ws.orb_8.5.0.jar 文件来覆盖非 IBM 产品 JRE 的缺省 ORB 实现或者将其添加到类路径。

  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>
      [AIX][HP-UX][Solaris][Linux][IBM i]
      $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>
      [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>

下一步做什么

通过在 Java 命令中添加以下内容,对 IBM Thin Client for EJB 启用跟踪。
  -Dcom.ibm.ejs.ras.lite.traceSpecification=*=all

指示主题类型的图标 任务主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tcli_ejbthinclient
文件名:tcli_ejbthinclient.html