blob: 531028b232f77d696c9c5a6a172d0fcbd4b9c43e [file] [log] [blame]
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Running a standalone OpenEJB server</title>
<meta name="description" content="Apache TomEE">
<meta name="author" content="Apache TomEE">
<meta name="google-translate-customization" content="f36a520c08f4c9-0a04e86a9c075ce9-g265f3196f697cf8f-10">
<meta http-equiv="Pragma" content="no-cache">
<meta http-equiv="Expires" content="0">
<meta http-equiv="Cache-Control" content="no-store, no-cache, must-revalidate, max-age=0">
<!-- Le HTML5 shim, for IE6-8 support of HTML elements -->
<!--[if lt IE 9]>
<script src="http://html5shim.googlecode.com/svn/trunk/html5.js"></script>
<![endif]-->
<!-- Le styles -->
<link href="./resources/css/bootstrap.css" rel="stylesheet">
<link href="./resources/css/prettify.css" rel="stylesheet">
<!--link href="./resources/css/bootstrap-mods.css" rel="stylesheet"-->
<link href="./resources/css/main.css" rel="stylesheet">
<link href="./resources/font-awesome-4.6.3/css/font-awesome.min.css" rel="stylesheet">
<script type="text/javascript">
var t = encodeURIComponent(document.title.replace(/^\s+|\s+$/g,""));
var u = encodeURIComponent(""+document.URL);
function fbshare () {
window.open(
"http://www.facebook.com/sharer/sharer.php?u="+u,
'Share on Facebook',
'width=640,height=426');
};
function gpshare () {
window.open(
"https://plus.google.com/share?url="+u,
'Share on Google+',
'width=584,height=385');
};
function twshare () {
window.open(
"https://twitter.com/intent/tweet?url="+u+"&text="+t,
'Share on Twitter',
'width=800,height=526');
};
function pinshare () {
window.open("//www.pinterest.com/pin/create/button/?url="+u+"&media=http%3A%2F%2Ftomee.apache.org%2Fresources%2Fimages%2Ffeather-logo.png&description="+t,
'Share on Pinterest',
'width=800,height=526');
};
</script>
<!-- Le fav and touch icons -->
<link rel="shortcut icon" href="./favicon.ico">
<link rel="apple-touch-icon" href="./resources/images/apple-touch-icon.png">
<link rel="apple-touch-icon" sizes="72x72" href="./resources/images/apple-touch-icon-72x72.png">
<link rel="apple-touch-icon" sizes="114x114" href="./resources/images/apple-touch-icon-114x114.png">
<script src="./resources/js/prettify.js" type="text/javascript"></script>
<script src="./resources/js/jquery-latest.js"></script>
<script src="http://platform.twitter.com/widgets.js" type="text/javascript"></script>
<script src="./resources/js/common.js"></script>
<script src="./resources/js/prettyprint.js"></script>
<!--script src="//assets.pinterest.com/js/pinit.js" type="text/javascript" async></script//-->
<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="topbar" data-dropdown="dropdown">
<div class="fill">
<div class="container">
<a class="brand" href="./index.html">Apache TomEE</a>
<ul class="nav">
<li class="dropdown">
<a class="dropdown-toggle" data-toggle="dropdown" href="#">
Apache
<b class="caret"></b>
</a>
<ul class="dropdown-menu">
<!-- <li><a href="./misc/whoweare.html">Who we are?</a></li> -->
<!-- <li><a href="./misc/heritage.html">Heritage</a></li> -->
<li><a href="http://www.apache.org">Apache Home</a></li>
<!-- <li><a href="./misc/resources.html">Resources</a></li> -->
<li><a href="./misc/contact.html">Contact</a></li>
<li><a href="./misc/legal.html">Legal</a></li>
<li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li>
<li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
<li class="divider"/>
<li><a href="http://www.apache.org/security">Security</a></li>
</ul>
</li>
<li><a href="./index.html">Home</a></li>
<li><a href="./downloads.html">Downloads</a></li>
<li><a href="./documentation.html">Documentation</a></li>
<li><a href="./examples-trunk/index.html">Examples</a></li>
<li><a href="./support.html">Support</a></li>
<li><a href="./contribute.html">Contribute</a></li>
<li><a href="./security/index.html">Security</a></li>
</ul>
<!-- Google CSE Search Box Begins -->
<FORM class="pull-right" id="searchbox_010475492895890475512:_t4iqjrgx90" action="http://www.google.com/cse">
<INPUT type="hidden" name="cx" value="010475492895890475512:_t4iqjrgx90">
<INPUT type="hidden" name="cof" value="FORID:0">
<INPUT size="18" width="130" style="width:130px" name="q" type="text" placeholder="Search">
</FORM>
<!--<SCRIPT type="text/javascript" src="http://www.google.com/coop/cse/brand?form=searchbox_010475492895890475512:_t4iqjrgx90"></SCRIPT>-->
<!-- Google CSE Search Box Ends -->
</div>
</div>
</div>
<div class="container">
<div class="page-header">
<small><a href="./index.html">Home</a></small><br>
<h1>Running a standalone OpenEJB server
<div style="float: right; position: relative; bottom: -10px; ">
<a onclick="javascript:gpshare()" class="gp-share sprite" title="Share on Google+">share [gp]</a>
<a onclick="javascript:fbshare()" class="fb-share sprite" title="Share on Facebook">share [fb]</a>
<a onclick="javascript:twshare()" class="tw-share sprite" title="Share on Twitter">share [tw]</a>
<a onclick="javascript:pinshare()" class="pin-share sprite" title="Share on Pinterest">share [pin]</a>
<a data-toggle="modal" href="#edit" class="edit-page" title="Contribute to this Page">contribute</a>
</div>
</h1>
</div>
<p><a name="RunningastandaloneOpenEJBserver-ConfiguringtheOpenEJBRuntime"></a></p>
<h1>Configuring the OpenEJB Runtime</h1>
<p>The OpenEJB Eclipse plugin provides support for running OpenEJB as a
standalone server in Eclipse using WTP.</p>
<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>
<p>To set up a new runtime, click on Window, Preferences, and select Installed
Runtimes under the Server category. Click the Add button.</p>
<p><img src="http://people.apache.org/~jgallimore/images/server_step_4.jpg" alt="http://people.apache.org/~jgallimore/images/server_step_4.jpg" /></p>
<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>
<p><img src="http://people.apache.org/~jgallimore/images/server_step_5.jpg" alt="http://people.apache.org/~jgallimore/images/server_step_5.jpg" /></p>
<p>Browse to, or enter the path to your copy of OpenEJB. Click on Finish.</p>
<p><a name="RunningastandaloneOpenEJBserver-ConfiguringtheOpenEJBServer"></a></p>
<h1>Configuring the OpenEJB Server</h1>
<p>Open the Servers view (if it isn't already), and right click and select
New->Server.</p>
<p><img src="http://people.apache.org/~jgallimore/images/server_step_8.jpg" alt="http://people.apache.org/~jgallimore/images/server_step_8.jpg" /></p>
<p>Select OpenEJB 3.0.0 from the Apache category, ensure you have the OpenEJB
runtime selected, and click Next.</p>
<p><img src="http://people.apache.org/~jgallimore/images/server_step_9.jpg" alt="http://people.apache.org/~jgallimore/images/server_step_9.jpg" /></p>
<p>Select the EJB port for the server, and select Finish.</p>
<p><img src="http://people.apache.org/~jgallimore/images/server_step_10.jpg" alt="http://people.apache.org/~jgallimore/images/server_step_10.jpg" /></p>
<p><a name="RunningastandaloneOpenEJBserver-Deployingaproject"></a></p>
<h1>Deploying a project</h1>
<p>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.</p>
<p><img src="http://people.apache.org/~jgallimore/images/server_step_1.jpg" alt="http://people.apache.org/~jgallimore/images/server_step_1.jpg" /></p>
<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>
<p><img src="http://people.apache.org/~jgallimore/images/server_step_2.jpg" alt="http://people.apache.org/~jgallimore/images/server_step_2.jpg" /></p>
<p>Select the EJB Module facet, and the Java Facet. Remember to select your
OpenEJB runtime too. Click Next.</p>
<p><img src="http://people.apache.org/~jgallimore/images/server_step_6.jpg" alt="http://people.apache.org/~jgallimore/images/server_step_6.jpg" /></p>
<p>Enter the source folder for the EJBs in your project and click Finish.</p>
<p><img src="http://people.apache.org/~jgallimore/images/server_step_6.jpg" alt="http://people.apache.org/~jgallimore/images/server_step_7.jpg" /></p>
<p>Now right click on your OpenEJB server in the servers view, and select Add
and Remove Projects.</p>
<p><img src="http://people.apache.org/~jgallimore/images/server_step_11.jpg" alt="http://people.apache.org/~jgallimore/images/server_step_11.jpg" /></p>
<p>Add your project to the server, and click Finish.</p>
<p><img src="http://people.apache.org/~jgallimore/images/server_step_12.jpg" alt="http://people.apache.org/~jgallimore/images/server_step_12.jpg" /></p>
<p>To start the server, Right click on your OpenEJB server, and select Start.</p>
<p><img src="http://people.apache.org/~jgallimore/images/server_step_13.jpg" alt="http://people.apache.org/~jgallimore/images/server_step_13.jpg" /></p>
<div id="edit" class="modal hide fade in" style="display: none; ">
<div class="modal-header">
<a class="close" data-dismiss="modal">x</a>
<h3>Thank you for contributing to the documentation!</h3>
</div>
<div class="modal-body">
<h4>Any help with the documentation is greatly appreciated.</h4>
<p>All edits are reviewed before going live, so feel free to do much more than fix typos or links. If you see a page that could benefit from an entire rewrite, we'd be thrilled to review it. Don't be surprised if we like it so much we ask you for help with other pages :)</p>
<small>NOTICE: unless indicated otherwise on the pages in question, all editable content available from apache.org is presumed to be licensed under the Apache License (AL) version 2.0 and hence all submissions to apache.org treated as formal Contributions under the license terms.</small>
<!--[if gt IE 6]>
<h4>Internet Explorer Users</h4>
<p>If you are not an Apache committer, click the Yes link and enter a <i>anonymous</i> for the username and leave the password empty</p>
<![endif]-->
</div>
<div class="modal-footer">
Do you have an Apache ID?
<a href="javascript:void(location.href='https://cms.apache.org/redirect?uri='+escape(location.href))" class="btn">Yes</a>
<a href="javascript:void(location.href='https://anonymous:@cms.apache.org/redirect?uri='+escape(location.href))" class="btn">No</a>
</div>
</div>
<script src="./resources/js/bootstrap-modal.js"></script>
<footer>
<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>
</footer>
</div> <!-- /container -->
<!-- Javascript
================================================== -->
<!-- Placed at the end of the document so the pages load faster -->
<script src="./resources/js/bootstrap-dropdown.js"></script>
</body>
</html>