Running the IBM Thin Client for Enterprise JavaBeans (EJB)
An EJB Client is a Remote Method Invocation over Internet Inter-ORB Protocol (RMI-IIOP) Java™ Platform, Standard Edition (Java SE) application that accesses remote Enterprise Java Beans from a server through Java Naming and Directory Interface (JNDI) look up. IBM® Thin Client for EJB offers a smaller footprint and is easy to deploy to a Java SE environment and an Eclipse Rich Client Platform (RCP) environment. You can bundle the IBM Thin Client for EJB library using the WebSphere® Application Server installation or the Application Client for WebSphere Application Server installation with your application. The IBM Thin Client for EJB also extends the choice of Java SE runtime. It can be run in the Java Runtime Environment (JRE) that is packaged with the WebSphere Application Server product, the JRE that is downloaded from the Oracle website, or the JRE that is downloaded from the HP website.
Before you begin
The IBM ORB implementation library is required if the IBM Thin Client for EJB is running with a non-IBM product JRE on a non-IBM product platform. For example, running the IBM Thin Client for EJB with Sun Microsystems JRE on Windows, Linux®, or Solaris, and with the HP JRE on HP-UX. The IBM-provided Solaris hybrid and HP hybrid JRE are not considered non-IBM product JRE environments.
The IBM Thin Client for EJB can access version 2.x and version 3.x EJB on the WebSphere Application Server using the JNDI lookup, but it cannot access version 3.x EJB through resource injection. Resource injection is supported if the client application is a Java Platform, Enterprise Edition (Java EE) Application Client running within the Java Platform, Enterprise Edition (Java EE) Application Client Container.
Before you set up an EJB Thin
Client environment, obtain the Java archive
(JAR) file for the EJB Thin Client for WebSphere Application Server. To obtain the
EJB Thin Client for WebSphere Application Server,
install WebSphere Application Server or
Application Client. The EJB Thin Client for WebSphere Application Server file, com.ibm.ws.ejb.thinclient_8.5.0.jar
com.ibm.ws.ejb.thinclient.zos_8.5.0.jar
, is
located in the app_server_root\runtimes
directory. Use the com.ibm.ws.ejb.thinclient.zos_8.5.0.jar
for
any client that is running on z/OS. Use
the com.ibm.ws.ejb.thinclient.jar
for any client
that runs on distributed platforms. Determining the client to
use depends on the client platform, and not the platform of the server
you are connecting to.
Copy the Java archive
(JAR) file for the IBM Thin
Client for EJB with WebSphere Application Server product, com.ibm.ws.ejb.thinclient_8.5.0.jar
com.ibm.ws.ejb.thinclient.zos_8.5.0.jar
and
the endorsed_apis_8.5.0.jar
files, to other machines
to create a lightweight client environment that enables communications
with the products. Copies of the IBM Thin
Client for EJB are subject to the same terms and conditions of the
license agreement for the WebSphere product
where you obtained the Thin Client for EJB. Refer to the license agreements
for correct usage and other limitations.
Copy the app_server_root\runtimes\endorsed\endorsed_apis_8.5.0.jar
file
into the default directory, JAVA_JRE\lib\endorsed.
Alternatively, you can use the java.endorsed.dirs property to specify
a directory of your choice. If you choose to use an alternative directory,
it is a best practice to only include the endorsed_apis JAR file.
- Include the com.ibm.ws.orb_8.5.0.jar file in the Java system classpath.
- Override the default ORB implementation in the JRE, using Java Endorsed Standards Override Mechanism.
- Set the java.endorsed.dirs path to a directory that contains the com.ibm.ws.orb_8.5.0.jar file.
-Djava.util.logging.manager=com.ibm.ws.bootstrap.WsLogManager
command
line option is used, a ClassDefNotFoundError error is thrown. The
use of WsLogManager is not supported in the IBM Thin Client for EJB, but you can use another Java logging manager.