content/remote-server.mdtext

Title: Remote Server

!http://www.openejb.org/images/diagram-remote-server.gif|valign=top,
align=right, hspace=15!
<a name="RemoteServer-AccessingEJBsRemotely"></a>
# Accessing EJBs Remotely

When using OpenEJB as a stand-alone server you can connect across a network
and access EJBs from a remote client.  The client code for accessing an
EJB's Remote Interface is the same, however to actually connect across a
network to the server, you need to specify different JNDI parameters.

<a name="RemoteServer-Shortversion"></a>
# Short version

Using OpenEJB's default remote server implementation is pretty straight
forward. You simply need to:

1. Deploy your bean.
1. Start the server on the IP and Port you want, 25.14.3.92 and 4201 for
example.
1. Use that information in your client to create an initial context
1. Add the right jars to your client's classpath

So, here it is in short.

Deploy your bean with the Deploy Tool:

    c:\openejb> openejb.bat deploy beans\myBean.jar

See the [OPENEJBx30:Deploy Tool](openejbx30:deploy-tool.html)
 documentation for more details on deploying beans.

Start the server:

    c:\openejb> openejb.bat start -h 25.14.3.92 -p 4201

See the Remote Server command-line guide for more details on starting the
Remote Server.

Create an initial context in your client as such:


    Properties p = new Properties();
    p.put("java.naming.factory.initial", "org.apache.openejb.client.RemoteInitialContextFactory");
    p.put("java.naming.provider.url", "ejbd://25.14.3.92:4201");
    p.put("java.naming.security.principal", "myuser");
    p.put("java.naming.security.credentials", "mypass");
        
    InitialContext ctx = new InitialContext(p);


If you don't have any EJBs or clients to run, try the ubiquitous [Hello World](openejbx30:hello-world.html)
 example.
Add the following library to your clients classpath:

* openejb-client-x.x.x.jar
* javaee-api-x.x.jar

Both can be found in the lib directory where you installed OpenEJB or in Maven repositories.