docs/running-a-standalone-openejb-server.adoc

= Running a standalone OpenEJB server
:index-group: EJB
:jbake-date: 2018-12-05
:jbake-type: page
:jbake-status: published


= Configuring the OpenEJB Runtime The OpenEJB Eclipse plugin provides
support for running OpenEJB as a standalone server in Eclipse using WTP.

To setup a server, first of all, you will need to have a copy of OpenEJB
extracted on your machine. Once you have that, the next step is to set
up a runtime.

To set up a new runtime, click on Window, Preferences, and select
Installed Runtimes under the Server category. Click the Add button.

image:http://people.apache.org/~jgallimore/images/server_step_4.jpg[http://people.apache.org/~jgallimore/images/server_step_4.jpg]

Select OpenEJB 3.0.0 from the Apache category, and click next. If you
choose to 'also create a new server' on this panel, you can add a server
straight after configuring the runtime.

image:http://people.apache.org/~jgallimore/images/server_step_5.jpg[http://people.apache.org/~jgallimore/images/server_step_5.jpg]

Browse to, or enter the path to your copy of OpenEJB. Click on Finish.

= Configuring the OpenEJB Server Open the Servers view (if it isn't
already), and right click and select New->Server.

image:http://people.apache.org/~jgallimore/images/server_step_8.jpg[http://people.apache.org/~jgallimore/images/server_step_8.jpg]

Select OpenEJB 3.0.0 from the Apache category, ensure you have the
OpenEJB runtime selected, and click Next.

image:http://people.apache.org/~jgallimore/images/server_step_9.jpg[http://people.apache.org/~jgallimore/images/server_step_9.jpg]

Select the EJB port for the server, and select Finish.

image:http://people.apache.org/~jgallimore/images/server_step_10.jpg[http://people.apache.org/~jgallimore/images/server_step_10.jpg]

= Deploying a project In order to deploy your project to an OpenEJB
server in Eclipse, your project must be a Java EE project, with the EJB
facet enabled. If your project doesn't have the Faceted nature, you can
use the OpenEJB plugin to add it. Simply select OpenEJB->Add Faceted
Nature from the menu bar.

image:http://people.apache.org/~jgallimore/images/server_step_1.jpg[http://people.apache.org/~jgallimore/images/server_step_1.jpg]

To add the EJB facet, right click on the project in the navigator, and
select Properties. Select Project Facets on the left hand side. Click on
the Modify Project button.

image:http://people.apache.org/~jgallimore/images/server_step_2.jpg[http://people.apache.org/~jgallimore/images/server_step_2.jpg]

Select the EJB Module facet, and the Java Facet. Remember to select your
OpenEJB runtime too. Click Next.

image:http://people.apache.org/~jgallimore/images/server_step_6.jpg[http://people.apache.org/~jgallimore/images/server_step_6.jpg]

Enter the source folder for the EJBs in your project and click Finish.

image:http://people.apache.org/~jgallimore/images/server_step_6.jpg[http://people.apache.org/~jgallimore/images/server_step_7.jpg]

Now right click on your OpenEJB server in the servers view, and select
Add and Remove Projects.

image:http://people.apache.org/~jgallimore/images/server_step_11.jpg[http://people.apache.org/~jgallimore/images/server_step_11.jpg]

Add your project to the server, and click Finish.

image:http://people.apache.org/~jgallimore/images/server_step_12.jpg[http://people.apache.org/~jgallimore/images/server_step_12.jpg]

To start the server, Right click on your OpenEJB server, and select
Start.

image:http://people.apache.org/~jgallimore/images/server_step_13.jpg[http://people.apache.org/~jgallimore/images/server_step_13.jpg]