blob: 6c28534b93ee79fd8b2eb59e8398efac0192da2f [file] [log] [blame]
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Apache TomEE</title>
<meta name="description"
content="Apache TomEE is a lightweight, yet powerful, JavaEE Application server with feature rich tooling." />
<meta name="keywords" content="tomee,asf,apache,javaee,jee,shade,embedded,test,junit,applicationcomposer,maven,arquillian" />
<meta name="author" content="Luka Cvetinovic for Codrops" />
<link rel="icon" href="../../favicon.ico">
<link rel="icon" type="image/png" href="../../favicon.png">
<meta name="msapplication-TileColor" content="#80287a">
<meta name="theme-color" content="#80287a">
<link rel="stylesheet" type="text/css" href="../../css/normalize.css">
<link rel="stylesheet" type="text/css" href="../../css/bootstrap.css">
<link rel="stylesheet" type="text/css" href="../../css/owl.css">
<link rel="stylesheet" type="text/css" href="../../css/animate.css">
<link rel="stylesheet" type="text/css" href="../../fonts/font-awesome-4.1.0/css/font-awesome.min.css">
<link rel="stylesheet" type="text/css" href="../../fonts/eleganticons/et-icons.css">
<link rel="stylesheet" type="text/css" href="../../css/jqtree.css">
<link rel="stylesheet" type="text/css" href="../../css/idea.css">
<link rel="stylesheet" type="text/css" href="../../css/cardio.css">
<script type="text/javascript">
var _gaq = _gaq || [];
_gaq.push(['_setAccount', 'UA-2717626-1']);
_gaq.push(['_setDomainName', 'apache.org']);
_gaq.push(['_trackPageview']);
(function() {
var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
})();
</script>
</head>
<body>
<div class="preloader">
<img src="../../img/loader.gif" alt="Preloader image">
</div>
<nav class="navbar">
<div class="container">
<div class="row"> <div class="col-md-12">
<!-- Brand and toggle get grouped for better mobile display -->
<div class="navbar-header">
<button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
<span class="sr-only">Toggle navigation</span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
</button>
<a class="navbar-brand" href="/">
<span>
<img src="../../img/logo-active.png">
</span>
Apache TomEE
</a>
</div>
<!-- Collect the nav links, forms, and other content for toggling -->
<div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
<ul class="nav navbar-nav navbar-right main-nav">
<li><a href="../../docs.html">Documentation</a></li>
<li><a href="../../community/index.html">Community</a></li>
<li><a href="../../security/security.html">Security</a></li>
<li><a href="../../download-ng.html">Downloads</a></li>
</ul>
</div>
<!-- /.navbar-collapse -->
</div></div>
</div>
<!-- /.container-fluid -->
</nav>
<div id="main-block" class="container main-block">
<div class="row title">
<div class="col-md-12">
<div class='page-header'>
<h1>Running a standalone OpenEJB server</h1>
</div>
</div>
</div>
<div class="row">
<div class="col-md-12">
<h1 id="_configuring_the_openejb_runtime_the_openejb_eclipse_plugin_provides" class="sect0">Configuring the OpenEJB Runtime The OpenEJB Eclipse plugin provides</h1>
<div class="paragraph">
<p>support for running OpenEJB as a standalone server in Eclipse using WTP.</p>
</div>
<div class="paragraph">
<p>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.</p>
</div>
<div class="paragraph">
<p>To set up a new runtime, click on Window, Preferences, and select
Installed Runtimes under the Server category. Click the Add button.</p>
</div>
<div class="paragraph">
<p><span class="image"><img src="http://people.apache.org/<sub>jgallimore/images/server_step_4.jpg" alt="http://people.apache.org/</sub>jgallimore/images/server_step_4.jpg"></span></p>
</div>
<div class="paragraph">
<p>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.</p>
</div>
<div class="paragraph">
<p><span class="image"><img src="http://people.apache.org/<sub>jgallimore/images/server_step_5.jpg" alt="http://people.apache.org/</sub>jgallimore/images/server_step_5.jpg"></span></p>
</div>
<div class="paragraph">
<p>Browse to, or enter the path to your copy of OpenEJB. Click on Finish.</p>
</div>
<h1 id="_configuring_the_openejb_server_open_the_servers_view_if_it_isn_t" class="sect0">Configuring the OpenEJB Server Open the Servers view (if it isn&#8217;t</h1>
<div class="paragraph">
<p>already), and right click and select New&#8594;Server.</p>
</div>
<div class="paragraph">
<p><span class="image"><img src="http://people.apache.org/<sub>jgallimore/images/server_step_8.jpg" alt="http://people.apache.org/</sub>jgallimore/images/server_step_8.jpg"></span></p>
</div>
<div class="paragraph">
<p>Select OpenEJB 3.0.0 from the Apache category, ensure you have the
OpenEJB runtime selected, and click Next.</p>
</div>
<div class="paragraph">
<p><span class="image"><img src="http://people.apache.org/<sub>jgallimore/images/server_step_9.jpg" alt="http://people.apache.org/</sub>jgallimore/images/server_step_9.jpg"></span></p>
</div>
<div class="paragraph">
<p>Select the EJB port for the server, and select Finish.</p>
</div>
<div class="paragraph">
<p><span class="image"><img src="http://people.apache.org/<sub>jgallimore/images/server_step_10.jpg" alt="http://people.apache.org/</sub>jgallimore/images/server_step_10.jpg"></span></p>
</div>
<h1 id="_deploying_a_project_in_order_to_deploy_your_project_to_an_openejb" class="sect0">Deploying a project In order to deploy your project to an OpenEJB</h1>
<div class="paragraph">
<p>server in Eclipse, your project must be a Java EE project, with the EJB
facet enabled. If your project doesn&#8217;t have the Faceted nature, you can
use the OpenEJB plugin to add it. Simply select OpenEJB&#8594;Add Faceted
Nature from the menu bar.</p>
</div>
<div class="paragraph">
<p><span class="image"><img src="http://people.apache.org/<sub>jgallimore/images/server_step_1.jpg" alt="http://people.apache.org/</sub>jgallimore/images/server_step_1.jpg"></span></p>
</div>
<div class="paragraph">
<p>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.</p>
</div>
<div class="paragraph">
<p><span class="image"><img src="http://people.apache.org/<sub>jgallimore/images/server_step_2.jpg" alt="http://people.apache.org/</sub>jgallimore/images/server_step_2.jpg"></span></p>
</div>
<div class="paragraph">
<p>Select the EJB Module facet, and the Java Facet. Remember to select your
OpenEJB runtime too. Click Next.</p>
</div>
<div class="paragraph">
<p><span class="image"><img src="http://people.apache.org/<sub>jgallimore/images/server_step_6.jpg" alt="http://people.apache.org/</sub>jgallimore/images/server_step_6.jpg"></span></p>
</div>
<div class="paragraph">
<p>Enter the source folder for the EJBs in your project and click Finish.</p>
</div>
<div class="paragraph">
<p><span class="image"><img src="http://people.apache.org/<sub>jgallimore/images/server_step_6.jpg" alt="http://people.apache.org/</sub>jgallimore/images/server_step_7.jpg"></span></p>
</div>
<div class="paragraph">
<p>Now right click on your OpenEJB server in the servers view, and select
Add and Remove Projects.</p>
</div>
<div class="paragraph">
<p><span class="image"><img src="http://people.apache.org/<sub>jgallimore/images/server_step_11.jpg" alt="http://people.apache.org/</sub>jgallimore/images/server_step_11.jpg"></span></p>
</div>
<div class="paragraph">
<p>Add your project to the server, and click Finish.</p>
</div>
<div class="paragraph">
<p><span class="image"><img src="http://people.apache.org/<sub>jgallimore/images/server_step_12.jpg" alt="http://people.apache.org/</sub>jgallimore/images/server_step_12.jpg"></span></p>
</div>
<div class="paragraph">
<p>To start the server, Right click on your OpenEJB server, and select
Start.</p>
</div>
<div class="paragraph">
<p><span class="image"><img src="http://people.apache.org/<sub>jgallimore/images/server_step_13.jpg" alt="http://people.apache.org/</sub>jgallimore/images/server_step_13.jpg"></span></p>
</div>
</div>
</div>
</div>
<footer>
<div class="container">
<div class="row">
<div class="col-sm-6 text-center-mobile">
<h3 class="white">Be simple. Be certified. Be Tomcat.</h3>
<h5 class="light regular light-white">"A good application in a good server"</h5>
<ul class="social-footer">
<li><a href="https://www.facebook.com/ApacheTomEE/"><i class="fa fa-facebook"></i></a></li>
<li><a href="https://twitter.com/apachetomee"><i class="fa fa-twitter"></i></a></li>
<li><a href="https://plus.google.com/communities/105208241852045684449"><i class="fa fa-google-plus"></i></a></li>
</ul>
</div>
<div class="col-sm-6 text-center-mobile">
<div class="row opening-hours">
<div class="col-sm-3 text-center-mobile">
<h5><a href="../../latest/docs/" class="white">Documentation</a></h5>
<ul class="list-unstyled">
<li><a href="../../latest/docs/admin/configuration/index.html" class="regular light-white">How to configure</a></li>
<li><a href="../../latest/docs/admin/file-layout.html" class="regular light-white">Dir. Structure</a></li>
<li><a href="../../latest/docs/developer/testing/index.html" class="regular light-white">Testing</a></li>
<li><a href="../../latest/docs/admin/cluster/index.html" class="regular light-white">Clustering</a></li>
</ul>
</div>
<div class="col-sm-3 text-center-mobile">
<h5><a href="../../latest/examples/" class="white">Examples</a></h5>
<ul class="list-unstyled">
<li><a href="../../latest/examples/simple-cdi-interceptor.html" class="regular light-white">CDI Interceptor</a></li>
<li><a href="../../latest/examples/rest-cdi.html" class="regular light-white">REST with CDI</a></li>
<li><a href="../../latest/examples/ejb-examples.html" class="regular light-white">EJB</a></li>
<li><a href="../../latest/examples/jsf-managedBean-and-ejb.html" class="regular light-white">JSF</a></li>
</ul>
</div>
<div class="col-sm-3 text-center-mobile">
<h5><a href="../../community/index.html" class="white">Community</a></h5>
<ul class="list-unstyled">
<li><a href="../../community/contributors.html" class="regular light-white">Contributors</a></li>
<li><a href="../../community/social.html" class="regular light-white">Social</a></li>
<li><a href="../../community/sources.html" class="regular light-white">Sources</a></li>
</ul>
</div>
<div class="col-sm-3 text-center-mobile">
<h5><a href="../../security/index.html" class="white">Security</a></h5>
<ul class="list-unstyled">
<li><a href="http://apache.org/security" target="_blank" class="regular light-white">Apache Security</a></li>
<li><a href="http://apache.org/security/projects.html" target="_blank" class="regular light-white">Security Projects</a></li>
<li><a href="http://cve.mitre.org" target="_blank" class="regular light-white">CVE</a></li>
</ul>
</div>
</div>
</div>
</div>
<div class="row bottom-footer text-center-mobile">
<div class="col-sm-12 light-white">
<p>Copyright &copy; 1999-2016 The Apache Software Foundation, Licensed under the Apache License, Version 2.0. Apache TomEE, TomEE, Apache, the Apache feather logo, and the Apache TomEE project logo are trademarks of The Apache Software Foundation. All other marks mentioned may be trademarks or registered trademarks of their respective owners.</p>
</div>
</div>
</div>
</footer>
<!-- Holder for mobile navigation -->
<div class="mobile-nav">
<ul>
<li><a hef="../../latest/docs/admin/index.html">Administrators</a>
<li><a hef="../../latest/docs/developer/index.html">Developers</a>
<li><a hef="../../latest/docs/advanced/index.html">Advanced</a>
<li><a hef="../../community/index.html">Community</a>
</ul>
<a href="#" class="close-link"><i class="arrow_up"></i></a>
</div>
<!-- Scripts -->
<script src="../../js/jquery-1.11.1.min.js"></script>
<script src="../../js/owl.carousel.min.js"></script>
<script src="../../js/bootstrap.min.js"></script>
<script src="../../js/wow.min.js"></script>
<script src="../../js/typewriter.js"></script>
<script src="../../js/jquery.onepagenav.js"></script>
<script src="../../js/tree.jquery.js"></script>
<script src="../../js/highlight.pack.js"></script>
<script src="../../js/main.js"></script>
</body>
</html>