| |
| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> |
| <HTML> |
| <HEAD> |
| <!-- $PAGETITLE --> |
| <TITLE>OpenEJB - Startup</TITLE> |
| <LINK href="http://openejb.apache.org/default.css" rel="stylesheet" type="text/css"> |
| <LINK href="http://openejb.apache.org/style.css" rel="stylesheet" type="text/css"> |
| <LINK rel="SHORTCUT ICON" href="http://openejb.apache.org/images/favicon.ico"> |
| <SCRIPT language="JavaScript" src="http://cwiki.apache.org/confluence/pages/viewpage.action?spaceKey=OPENEJB&title=functions.js" type="text/javascript"></SCRIPT> |
| <META http-equiv="Content-Type" content="text/html;charset=UTF-8"></HEAD> |
| <BODY bgcolor="#ffffff" link="#6763a9" vlink="#6763a9" topmargin="0" bottommargin="0" leftmargin="0" marginheight="0" marginwidth="0"> |
| |
| <!-- Delay the loading of the external javascript file needed for labels (as it takes too long to load and visibly holds loading of the page body) --> |
| <!-- To do this without javascript errors over undefined functions, we need to declare stubs here (that are overrided later by the proper implementations) --> |
| <SCRIPT language="JavaScript" type="text/javascript"> |
| function doAddLabel(hideTextfieldAfterAddParam) |
| { |
| // stub |
| } |
| |
| function onAddLabel() |
| { |
| // stub |
| } |
| |
| function showLabelsInput() |
| { |
| // stub |
| } |
| </SCRIPT> |
| |
| <A name="top"></A> |
| <TABLE border="0" cellpadding="0" cellspacing="0" width="100%" height="400"> |
| <TR> |
| <TD width="20" valign="top" align="left" bgcolor="#7270c2"><IMG src="http://openejb.apache.org/images/dotTrans.gif" width="1" height="1" border="0"></TD> |
| <TD width="95" valign="top" align="left" bgcolor="#7270c2"><IMG src="http://openejb.apache.org/images/dotTrans.gif" width="1" height="1" border="0"></TD> |
| <TD width="7" valign="top" align="left"><IMG src="http://openejb.apache.org/images/dotTrans.gif" border="0" width="1" height="1"></TD> |
| <TD width="40" valign="top" align="left"><IMG src="http://openejb.apache.org/images/dotTrans.gif" width="40" height="6" border="0"></TD> |
| <TD width="100%" valign="top" align="left" bgcolor="#5A5CB8"><IMG src="http://openejb.apache.org/images/top_2.gif" width="430" height="6" border="0"></TD> |
| <TD width="120" valign="top" align="left" bgcolor="#E24717"><IMG src="http://openejb.apache.org/images/top_3.gif" width="120" height="6" border="0"></TD> |
| </TR> |
| <TR> |
| <TD width="20" bgcolor="#7270c2" valign="top" align="left"><IMG src="http://openejb.apache.org/images/dotTrans.gif" border="0" width="1" height="1"></TD> |
| <TD width="95" bgcolor="#7270c2" valign="top" align="left"><IMG src="http://openejb.apache.org/images/dotTrans.gif" border="0" width="1" height="1"></TD> |
| <TD width="7" bgcolor="#ffffff" valign="top" align="left"></TD> |
| <TD width="40" valign="top" align="left"><IMG src="http://openejb.apache.org/images/dotTrans.gif" width="1" height="1" border="0"></TD> |
| <TD id="breadcrumbs" width="100%" valign="middle" align="left"> |
| <!-- $TOP_NAV_BAR --> |
| <SPAN id="Content"> |
| |
| |
| |
| |
| |
| <A href="index.html" title="Index">Index</A> | <A href="news.html" title="News">News</A> | <A href="faq.html" title="FAQ">FAQ</A> | <A href="download.html" title="Download">Download</A> | <A href="mailing-lists.html" title="Mailing Lists">Lists</A> | <SPAN class="nobr"><A href="http://issues.apache.org/jira/browse/OPENEJB" title="Visit page outside Confluence" rel="nofollow">Issues<SUP><IMG class="rendericon" src="http://cwiki.apache.org/confluence/images/icons/linkext7.gif" height="7" width="7" align="absmiddle" alt="" border="0"></SUP></A></SPAN> |
| </SPAN> |
| <IMG src="http://openejb.apache.org/images/dotTrans.gif" width="1" height="2" border="0"></TD> |
| <TD width="120" height="20" valign="top" align="left"> </TD> |
| </TR> |
| <TR> |
| <TD width="20" bgcolor="#7270c2" valign="top" align="left"><IMG src="http://openejb.apache.org/images/dotTrans.gif" width="20" height="3" border="0"></TD> |
| <TD width="95" bgcolor="#7270c2" valign="top" align="left"><IMG src="http://openejb.apache.org/images/line_sm.gif" width="105" height="3" border="0"></TD> |
| <TD width="7" bgcolor="#a9a5de" valign="top" align="left"><IMG src="http://openejb.apache.org/images/line_sm.gif" width="7" height="3" border="0"></TD> |
| <TD width="40" valign="top" align="left"><IMG src="http://openejb.apache.org/images/line_light.gif" width="40" height="3" border="0"></TD> |
| <TD width="100%" valign="top" align="left"><IMG src="http://openejb.apache.org/images/line_light.gif" width="430" height="3" border="0"></TD> |
| <TD width="120" valign="top" align="left"><IMG src="http://openejb.apache.org/images/dotTrans.gif" border="0" width="1" height="1"></TD> |
| </TR> |
| <TR> |
| <TD bgcolor="#7270c2" valign="top" align="left"><IMG src="http://openejb.apache.org/images/dotTrans.gif" width="20" height="10" border="0"></TD> |
| <TD id="leftColumn" valign="top" style="padding-top: 0px;"> |
| <SPAN id="Content"> |
| |
| |
| |
| |
| |
| <H3><A name="Navigation-Overview"></A>Overview</H3> |
| |
| <UL class="alternate" type="square"> |
| <LI><A href="index.html" title="Index">Home</A></LI> |
| <LI><A href="news.html" title="News">News</A></LI> |
| <LI><A href="faq.html" title="FAQ">FAQ</A></LI> |
| <LI><A href="download.html" title="Download">Download</A></LI> |
| <LI><A href="examples.html" title="Examples">Examples</A></LI> |
| <LI><A href="mailing-lists.html" title="Mailing Lists">Mailing Lists</A></LI> |
| <LI><A href="source-code.html" title="Source Code">Source Code</A></LI> |
| </UL> |
| |
| |
| <H3><A name="Navigation-General"></A>General</H3> |
| |
| <UL class="alternate" type="square"> |
| <LI><A href="deploy-tool.html" title="Deploy Tool">Deployment</A></LI> |
| <LI><A href="" title="Startup">Startup</A></LI> |
| <LI><A href="validation-tool.html" title="Validation Tool">Validation</A></LI> |
| <LI><A href="webadmin.html" title="Webadmin">Webadmin</A></LI> |
| </UL> |
| |
| |
| <H3><A name="Navigation-Configuration"></A>Configuration</H3> |
| |
| <UL class="alternate" type="square"> |
| <LI><A href="configuration.html" title="Configuration">General</A></LI> |
| <LI><A href="http://cwiki.apache.org/confluence/display/OPENEJBx30/Deployments" title="Deployments">Deployments</A></LI> |
| <LI><A href="containers.html" title="Containers">Containers</A></LI> |
| </UL> |
| |
| |
| <H3><A name="Navigation-Servers"></A>Servers</H3> |
| |
| <UL class="alternate" type="square"> |
| <LI><A href="local-server.html" title="Local Server">Local</A></LI> |
| <LI><A href="remote-server.html" title="Remote Server">Remote</A></LI> |
| </UL> |
| |
| |
| <H3><A name="Navigation-Integrations"></A>Integrations</H3> |
| |
| <UL class="alternate" type="square"> |
| <LI><A href="tomcat.html" title="Tomcat">Tomcat</A></LI> |
| <LI><A href="geronimo.html" title="Geronimo">Geronimo</A></LI> |
| <LI><A href="webobjects.html" title="WebObjects">WebObjects</A></LI> |
| </UL> |
| |
| |
| <H3><A name="Navigation-Community"></A>Community</H3> |
| |
| <UL class="alternate" type="square"> |
| <LI><A href="team.html" title="Team">Team</A></LI> |
| <LI><A href="articles.html" title="Articles">Articles</A></LI> |
| <LI><A href="annoyances.html" title="Annoyances">Annoyances</A></LI> |
| <LI><SPAN class="nobr"><A href="index.html" title="Visit page outside Confluence" rel="nofollow">Wiki<SUP><IMG class="rendericon" src="http://cwiki.apache.org/confluence/images/icons/linkext7.gif" height="7" width="7" align="absmiddle" alt="" border="0"></SUP></A></SPAN></LI> |
| <LI><SPAN class="nobr"><A href="irc://irc.freenode.net/#openejb" title="Visit page outside Confluence" rel="nofollow">IRC<SUP><IMG class="rendericon" src="http://cwiki.apache.org/confluence/images/icons/linkext7.gif" height="7" width="7" align="absmiddle" alt="" border="0"></SUP></A></SPAN></LI> |
| </UL> |
| </SPAN> |
| |
| <H3 class="heading3">Feeds</H3> |
| <TABLE border="0" cellspacing="4px"> |
| <TR> |
| <TD align="right"> |
| <A href="http://cwiki.apache.org/confluence/spaces/rss.action?key=OPENEJB&newPages=false"><IMG src="http://openejb.apache.org/images/rss.gif" border="0"></A><BR> |
| </TD> |
| <TD align="left"> |
| <A href="http://cwiki.apache.org/confluence/spaces/rss.action?key=OPENEJB&newPages=false">Site</A> |
| </TD> |
| </TR> |
| <TR> |
| <TD align="right"> |
| <A href="http://cwiki.apache.org/confluence/spaces/blogrss.action?key=OPENEJB"><IMG src="http://openejb.apache.org/images/rss.gif" border="0"></A> |
| </TD> |
| <TD align="left"> |
| <A href="http://cwiki.apache.org/confluence/spaces/blogrss.action?key=OPENEJB">News</A> |
| </TD> |
| </TR> |
| </TABLE> |
| </TD> |
| <TD width="7" bgcolor="#a9a5de" valign="top" align="left"> </TD> |
| <TD width="40" valign="top" align="left"> </TD> |
| <TD rowspan="4" width="100%" valign="top"> |
| <TABLE cols="1" rows="2" border="0" cellpadding="0" cellspacing="0" width="100%"> |
| <TR> |
| <TD valign="top" align="left"><BR> |
| <TABLE cols="3" rows="1" border="0" cellpadding="0" cellspacing="0" width="100%"> |
| <TR> |
| <TD valign="top" width="200" align="left"> |
| <A href="http://openejb.org/"> |
| <IMG border="0" hspace="0" src="http://openejb.apache.org/images/logo_openejb.gif" vspace="0"> |
| </A> |
| </TD> |
| <TD align="right" valign="middle" style="padding:0px;margin:0px;"> |
| <TABLE style="padding:0px;margin:0px;"> |
| <TR> |
| <TD> |
| <A href="http://www.apache.org/"> |
| <IMG src="http://www.apache.org/images/asf-logo.gif" border="0" width="258" height="66"> |
| </A> |
| </TD> |
| <TR> |
| <!-- |
| <tr> |
| <td align="right" valign="top" style="font- size:12px;color:#777777"> |
| [OpenEJB is a Podling in the Apache Incubator] |
| </td> |
| </tr> |
| --> |
| </TABLE> |
| </TD> |
| </TR> |
| </TABLE> |
| <BR> |
| </TD> |
| </TR> |
| <TR> |
| <TD valign="top" align="left"> |
| <IMG border="0" height="7" hspace="0" src="http://openejb.apache.org/images/dotTrans.gif"><BR> |
| <DIV id="page_title"> |
| <TABLE width="100%"> |
| <TR> |
| <TD> |
| <!-- $TITLE --> |
| Startup |
| </TD> |
| |
| <!-- Google CSE Search Box Begins --> |
| <TD align="right"> |
| <FORM 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 name="q" type="text" size="25"> |
| <INPUT type="submit" name="sa" value="Search"> |
| </FORM> |
| <SCRIPT type="text/javascript" src="http://www.google.com/coop/cse/brand?form=searchbox_010475492895890475512:_t4iqjrgx90"></SCRIPT> |
| </TD> |
| <!-- Google CSE Search Box Ends --> |
| |
| <TD align="right" style="padding-left:0px;"><A style="color:#999;font-size:small;font-weight:normal;" href="http://cwiki.apache.org/confluence/pages/editpage.action?spaceKey=OPENEJB&title=Startup">[ edit ]</A></TD> |
| <TD align="right" width="25"> |
| |
| <SCRIPT type="text/javascript" language="javascript"> |
| document.write('<a href="http://cwiki.apache.org/confluence/pages/viewpage'); |
| document.write('.action?pageId=26536&decorator=printable">'); |
| </SCRIPT> |
| <IMG src="http://cwiki.apache.org/confluence/images/icons/print_16.gif" height="16" width="16" border="0" align="absmiddle" title="Print"></A> |
| |
| </TD> |
| </TR> |
| </TABLE> |
| </DIV> |
| <IMG border="0" height="1" hspace="0" src="http://openejb.apache.org/images/dotTrans.gif"></TD> |
| </TR> |
| </TABLE> |
| <P> |
| <!-- $BODY --> |
| <DIV id="PageContent"> |
| |
| <DIV class="pagecontent"> |
| <DIV class="wiki-content"> |
| <H1><A name="Startup-NAME"></A>NAME</H1> |
| |
| <P>openejb start - OpenEJB Remote Server</P> |
| |
| <H1><A name="Startup-SYNOPSIS"></A>SYNOPSIS</H1> |
| |
| <P>openejb start <SPAN class="nobr"><A href="http://cwiki.apache.org/confluence/pages/createpage.action?spaceKey=OPENEJB&title=options&linkCreation=true&fromPageId=26536" title="Create Page: options" class="createlink">OPENEJB:options<SUP><IMG class="rendericon" src="http://cwiki.apache.org/confluence/images/icons/plus.gif" height="7" width="7" align="absmiddle" alt="" border="0"></SUP></A></SPAN></P> |
| |
| <H1><A name="Startup-NOTE"></A>NOTE</H1> |
| |
| <P>The OpenEJB Remote Server can be started by running the openejb.bat script for windows and the openejb script for Linux and other Unix based OSes. Before running these scripts you need to set the environment variable <EM>OPENEJB_HOME</EM> to the path of the directory where you unpacked the OpenEJB installation. </P> |
| |
| <P>From now on we will refer to this directory as <OPENEJB_HOME> and assume that you unpacked OpenEJB into the directory <TT>C:\openejb-3.0</TT> The startup scripts are present in the <OPENEJB_HOME>/bin directory. You can set this directory in the system <EM>PATH</EM> for starting openejb from the command shell. </P> |
| |
| <P>In Windows, the remote server can be executed as follows:</P> |
| |
| <P><TT>C:\openejb-3.0> bin\openejb start</TT></P> |
| |
| <P>In UNIX, Linux, or Mac OS X, the deploy tool can be executed as follows:</P> |
| |
| <P><TT><SPAN class="error">[OPENEJB:user@host openejb-3.0]</SPAN># ./bin/openejb start</TT></P> |
| |
| <P>Depending on your OpenEJB version, you may need to change execution bits to make the scripts executable. You can do this with the following command.</P> |
| |
| <P><TT><SPAN class="error">[OPENEJB:user@host openejb-3.0]</SPAN># chmod 755 bin/openejb</TT></P> |
| |
| <P>From here on out, it will be assumed that you know how to execute the right openejb script for your operating system and commands will appear in shorthand as show below.</P> |
| |
| <P><TT>openejb start -help</TT></P> |
| |
| <H1><A name="Startup-DESCRIPTION"></A>DESCRIPTION</H1> |
| |
| <P>Starts OpenEJB as an EJB Server that can be accessed by remote clients via the OpenEJB Remote Server.</P> |
| |
| <P>ALWAYS check your openejb.log file for warnings immediately after starting the Remote Server.</P> |
| |
| <P>OpenEJB issues warnings when it works around a potential problem, encounters something it didn't expect, or when OpenEJB wants to let you know something may not work as you expected it.</P> |
| |
| <P>OpenEJB itself is configured with the OpenEJB configuration file, which is extremely simple and self-documenting. This file is located at c:\openejb-3.0\conf\openejb.xml.</P> |
| |
| <H1><A name="Startup-OPTIONS"></A>OPTIONS</H1> |
| |
| <TABLE class="confluenceTable"><TBODY> |
| <TR> |
| <TD class="confluenceTd"> <EM>--admin-bind <host></EM> </TD> |
| <TD class="confluenceTd"> Sets the host to which the admin service should be bound.</TD> |
| </TR> |
| <TR> |
| <TD class="confluenceTd"> <EM>--admin-port <int></EM> </TD> |
| <TD class="confluenceTd"> Sets the port to which the admin service should be bound.</TD> |
| </TR> |
| <TR> |
| <TD class="confluenceTd"> <EM>--conf <file></EM> </TD> |
| <TD class="confluenceTd"> Sets the OpenEJB configuration to the specified file. </TD> |
| </TR> |
| <TR> |
| <TD class="confluenceTd"> <EM>--ejbd-bind <host></EM> </TD> |
| <TD class="confluenceTd"> Sets the host to which the ejbd service should be bound. </TD> |
| </TR> |
| <TR> |
| <TD class="confluenceTd"> <EM>--ejbd-port <int></EM> </TD> |
| <TD class="confluenceTd"> Sets the port to which the ejbd service should be bound. </TD> |
| </TR> |
| <TR> |
| <TD class="confluenceTd"> <EM>--examples</EM> </TD> |
| <TD class="confluenceTd"> Show examples of how to use the options. </TD> |
| </TR> |
| <TR> |
| <TD class="confluenceTd"> -h, --<EM>help</EM> </TD> |
| <TD class="confluenceTd"> Print this help message. </TD> |
| </TR> |
| <TR> |
| <TD class="confluenceTd"> <EM>--hsql-bind <host></EM> </TD> |
| <TD class="confluenceTd"> Sets the host to which the hsql service should be bound.</TD> |
| </TR> |
| <TR> |
| <TD class="confluenceTd"> <EM>--hsql-port <int></EM> </TD> |
| <TD class="confluenceTd"> Sets the port to which the hsql service should be bound.</TD> |
| </TR> |
| <TR> |
| <TD class="confluenceTd"> <EM>--httpejbd-bind <host></EM> </TD> |
| <TD class="confluenceTd"> Sets the host to which the httpejbd service should be bound.</TD> |
| </TR> |
| <TR> |
| <TD class="confluenceTd"> <EM>--httpejbd-port <int></EM> </TD> |
| <TD class="confluenceTd"> Sets the port to which the httpejbd service should be bound.</TD> |
| </TR> |
| <TR> |
| <TD class="confluenceTd"> <EM>--local-copy <boolean></EM> </TD> |
| <TD class="confluenceTd"> Instructs the container system to marshal (ie, copy) all calls between beans. </TD> |
| </TR> |
| <TR> |
| <TD class="confluenceTd"> <EM>--telnet-bind <host></EM> </TD> |
| <TD class="confluenceTd"> Sets the host to which the telnet service should be bound.</TD> |
| </TR> |
| <TR> |
| <TD class="confluenceTd"> <EM>--telnet-port <int></EM> </TD> |
| <TD class="confluenceTd"> Sets the port to which the telnet service should be bound.</TD> |
| </TR> |
| <TR> |
| <TD class="confluenceTd"> -v, --<EM>version</EM> </TD> |
| <TD class="confluenceTd"> Print the version. </TD> |
| </TR> |
| </TBODY></TABLE> |
| |
| <H1><A name="Startup-EXAMPLES"></A>EXAMPLES</H1> |
| |
| <H2><A name="Startup-Example%3ASimplestscenario"></A>Example: Simplest scenario</H2> |
| |
| <P><TT>openejb start</TT></P> |
| |
| <P>That's it. The ejbd will start up and bind to IP 127.0.0.1 and port 4201.</P> |
| |
| <P>The following properties would then be used to get an InitialContext from the Remote Server.</P> |
| |
| <DIV class="code"><DIV class="codeContent"> |
| <PRE class="code-java">java.naming.factory.initial = org.apache.openejb.client.RemoteInitialContextFactory |
| java.naming.provider.url = ejbd:<SPAN class="code-comment">//127.0.0.1:4201 |
| </SPAN> java.naming.security.principal = myuser |
| java.naming.security.credentials = mypass</PRE> |
| </DIV></DIV> |
| |
| <H2><A name="Startup-Example%3Aconf%3Dfile"></A>Example: --conf=file</H2> |
| |
| <P><TT>openejb start --conf=C:\openejb-3.0\conf\mytest.conf</TT></P> |
| |
| <P> Sets the openejb.configuration system variable to the file <TT>C:\openejb\conf\mytest.conf</TT>. When the server starts up and initializes OpenEJB, this configuration will be used to assemble the container system and load beans.</P> |
| |
| <H2><A name="Startup-Example%3Alocalcopy"></A>Example: --local-copy</H2> |
| |
| <P> <TT>openejb start --local-copy=true</TT></P> |
| |
| <P> Instructs the container system to marshal (ie, copy) all calls between beans are required by the EJB 1.1 specification.</P> |
| |
| <P> <TT>openejb start --local-copy=false</TT></P> |
| |
| <P> Instructs the container system to not marshal (copy) calls between beans. The container system as will pass parameters and return values without copying or marshalling as is required for EJB 2.0 Local interfaces.</P> |
| |
| <H2><A name="Startup-CONFIGOVERRIDEEXAMPLES"></A>CONFIG OVERRIDE EXAMPLES</H2> |
| |
| <H2><A name="Startup-Example%3AD%3Cservice%3E.bind%3D%3Caddress%3E"></A>Example: -D<service>.bind=<address></H2> |
| |
| <P> <TT>openejb start -Dejbd.bind=10.45.67.8</TT></P> |
| |
| <P> This is the most common way to use the EJBd Server Service. The service will start up and bind to IP 10.45.67.8 and port 4201. The following properties would then be used to get an InitialContext from the EJBd Server Service.</P> |
| |
| <DIV class="code"><DIV class="codeContent"> |
| <PRE class="code-java">java.naming.factory.initial = org.apache.openejb.client.RemoteInitialContextFactory |
| java.naming.provider.url = ejbd:<SPAN class="code-comment">//10.45.67.8:4201 |
| </SPAN> java.naming.security.principal = myuser |
| java.naming.security.credentials = mypass</PRE> |
| </DIV></DIV> |
| |
| <P> DNS names can also be used.</P> |
| |
| <P> <TT>openejb start -Dejbd.bind=myhost.foo.com</TT></P> |
| |
| <P> The following properties would then be used to get an InitialContext from the Remote Server.</P> |
| |
| <DIV class="code"><DIV class="codeContent"> |
| <PRE class="code-java">java.naming.factory.initial = org.apache.openejb.client.RemoteInitialContextFactory |
| java.naming.provider.url = ejbd:<SPAN class="code-comment">//myhost.foo.com:4201 |
| </SPAN> java.naming.security.principal = myuser |
| java.naming.security.credentials = mypass</PRE> |
| </DIV></DIV> |
| |
| <P> <TT>openejb start -Dtelnet.bind=myhost.foo.com</TT></P> |
| |
| <P> The following properties would then be used to log into the server via a telnet client as such:</P> |
| |
| <P> <TT>telnet myhost.foo.com 4202</TT></P> |
| |
| |
| <H2><A name="Startup-Example%3AD%3Cservice%3E.port%3D%3Cport%3E"></A>Example: -D<service>.port=<port></H2> |
| |
| <P> <TT>openejb start -Dejbd.port=8765</TT></P> |
| |
| <P> The server will start up and bind to IP 127.0.0.1 and port 8765.</P> |
| |
| <P> The following properties would then be used to get an InitialContext from the Remote Server.</P> |
| |
| <DIV class="code"><DIV class="codeContent"> |
| <PRE class="code-java">java.naming.factory.initial = org.apache.openejb.client.RemoteInitialContextFactory |
| java.naming.provider.url = ejbd:<SPAN class="code-comment">//127.0.0.1:8765 |
| </SPAN> java.naming.security.principal = myuser |
| java.naming.security.credentials = mypass</PRE> |
| </DIV></DIV> |
| |
| <P> <TT>openejb start -Dhttpejbd.port=8888</TT></P> |
| |
| <P> The server will start up and the EJB over HTTP service will bind to IP 127.0.0.1 and port 8888.</P> |
| |
| <P> The following properties would then be used to get an InitialContext from the HTTP/Remote Server.</P> |
| |
| <DIV class="code"><DIV class="codeContent"> |
| <PRE class="code-java">java.naming.factory.initial = org.apache.openejb.client.RemoteInitialContextFactory |
| java.naming.provider.url = http:<SPAN class="code-comment">//127.0.0.1:8888/openejb |
| </SPAN> java.naming.security.principal = myuser |
| java.naming.security.credentials = mypass</PRE> |
| </DIV></DIV> |
| |
| <H2><A name="Startup-Example%3AD%3Cservice%3E.onlyfrom%3D%3Caddresses%3E"></A>Example: -D<service>.only_from=<addresses></H2> |
| |
| <P> <TT>openejb start -Dadmin.only_from=192.168.1.12</TT></P> |
| |
| <P> Adds 192.168.1.12 to the list of IP addresses that are authorized to shutdown the server or access the server<BR> |
| via a telnet client. The host that this server was started on is always allowed to administer the server.</P> |
| |
| <P> Multiple hosts can be given administrative access to this server by listing all the host names separated<BR> |
| by commas as such:</P> |
| |
| <P> <TT>openejb start -Dadmin.only_from=192.168.1.12,joe.foo.com,robert</TT></P> |
| |
| <P> The first host in the string names the host explicitly using an IP address (192.168.1.12).</P> |
| |
| <P> The second host uses a DNS name (joe.foo.com) to refer to the hosts IP address. The DNS name will be resolved and the IP will be added to the admin list.</P> |
| |
| <P> The third address refers to a the host by a name (robert)that the opperating system is able to resolve into a valid IP address. This is usually done via a hosts file, interal DNS server, or Windows Domain Server.</P> |
| |
| <H2><A name="Startup-Example%3AD%3Cservice%3E.threads%3D%3Cmax%3E"></A>Example: -D<service>.threads=<max></H2> |
| |
| <P> <TT>openejb start -Dejbd.threads=200</TT></P> |
| |
| <P> Sets the max number of concurrent threads that can enter the EJBd Server Service to 200.</P> |
| |
| <H2><A name="Startup-Example%3AD%3Cservice%3E.disabled%3D%3Ctrue%2Ffalse%3E"></A>Example: -D<service>.disabled=<true/false></H2> |
| |
| <P> <TT>openejb start -Dtelnet.disabled=true</TT></P> |
| |
| <P> Prevents the Telnet Server Service from starting when the OpenEJB Server starts.</P> |
| |
| <H1><A name="Startup-CONSOLEOUTPUT"></A>CONSOLE OUTPUT</H1> |
| |
| <P>Once you start OpenEJB using the <TT>openejb start</TT> command the following output will be seen on the console </P> |
| |
| <DIV class="code"><DIV class="codeContent"> |
| <PRE class="code-java">Apache OpenEJB 3.0 build: 20070825-01:10 |
| http:<SPAN class="code-comment">//openejb.apache.org/ |
| </SPAN>OpenEJB ready. |
| [OPENEJB:init] OpenEJB Remote Server |
| ** Starting Services ** |
| NAME IP PORT |
| httpejbd 0.0.0.0 4204 |
| telnet 0.0.0.0 4202 |
| ejbd 0.0.0.0 4201 |
| hsql 0.0.0.0 9001 |
| admin thread 0.0.0.0 4200 |
| ------- |
| Ready!</PRE> |
| </DIV></DIV> |
| </DIV> |
| </DIV> |
| </DIV> |
| </P> |
| </TD> |
| |
| |
| |
| |
| </TR> |
| <TR height="5"> |
| <TD width="20" height="5" bgcolor="#7270c2" valign="top" align="left"> </TD> |
| <TD width="95" height="5" bgcolor="#7270c2" valign="top"> </TD> |
| <TD width="7" height="5" bgcolor="#a9a5de" valign="top" align="left"> </TD> |
| <TD width="40" height="5" valign="top" align="left"> </TD> |
| <TD width="120" height="5" valign="top" align="left"> </TD> |
| </TR> |
| <TR> |
| <TD width="20" height="5" bgcolor="#7270c2" valign="top" align="left"> </TD> |
| <TD width="95" bgcolor="#7270c2" valign="BOTTOM" align="left"> </TD> |
| <TD width="7" bgcolor="#a9a5de" valign="top" align="left"><IMG src="http://openejb.apache.org/images/dotTrans.gif" width="1" height="25" border="0"></TD> |
| <TD width="40" valign="top" align="left"><IMG src="http://openejb.apache.org/images/dotTrans.gif" width="1" height="25" border="0"></TD> |
| <TD width="120" valign="top" align="left"> </TD> |
| </TR> |
| <TR> |
| <TD width="20" height="5" bgcolor="#7270c2" valign="top" align="left"> </TD> |
| <TD width="95" bgcolor="#7270c2" valign="BOTTOM" align="left"> </TD> |
| <TD width="7" bgcolor="#a9a5de" valign="top" align="left"><IMG src="http://openejb.apache.org/images/dotTrans.gif" width="1" height="25" border="0"></TD> |
| <TD width="40" valign="top" align="left"><IMG src="http://openejb.apache.org/images/dotTrans.gif" width="1" height="25" border="0"></TD> |
| <TD width="120" valign="top" align="left"> </TD> |
| </TR> |
| <TR height="5"> |
| <TD width="20" rowspan="2" height="100%" bgcolor="#7270c2" valign="bottom" align="left"><IMG src="http://openejb.apache.org/images/stripes1.gif" width="20" height="125" border="0"></TD> |
| <TD width="95" rowspan="2" height="100%" bgcolor="#7270c2" valign="bottom" align="left"><IMG src="http://openejb.apache.org/images/stripe105.gif" width="105" height="125" border="0"></TD> |
| <TD width="7" rowspan="2" height="100%" bgcolor="#a9a5de" valign="top" align="left"> </TD> |
| <TD width="40" height="100%" valign="top" align="left"> </TD> |
| <TD width="120" height="100%" valign="top" align="left"> </TD> |
| </TR> |
| <TR height="5"> |
| <TD width="40" height="25" valign="top" align="left"> </TD> |
| <TD width="100%" height="25" valign="bottom" align="left"><BR> |
| <BR> |
| <IMG src="http://openejb.apache.org/images/line_light.gif" border="0" width="430" height="3"><BR> |
| <P> |
| </P> |
| <SPAN class="bodyGrey"> |
| <SMALL><NOTICE><!-- $FOOTER --> |
| Apache OpenEJB is an project of The Apache Software Foundation (ASF) |
| </NOTICE> <BR> |
| <BR> |
| Powered by <A href="http://atlassian.com/">Atlassian</A> <A href="http://atlassian.com/confluence/">Confluence</A>. |
| </SMALL> |
| </SPAN> |
| <P> |
| </P> |
| </TD> |
| <TD width="120" height="25" valign="top" align="left"> </TD> |
| </TR> |
| </TABLE> |
| |
| <!-- Needed for composition plugin --> |
| <!-- delay the loading of large javascript files to the end so that they don't interfere with the loading of page content --> |
| <SPAN style="display: none"> |
| <SCRIPT type="text/javascript" language="JavaScript" src="http://cwiki.apache.org/confluence/labels-javascript"></SCRIPT> |
| |
| <SCRIPT src="http://www.google-analytics.com/urchin.js" type="text/javascript"> |
| </SCRIPT> |
| <SCRIPT type="text/javascript"> |
| _uacct = "UA-2717626-1"; |
| urchinTracker(); |
| </SCRIPT> |
| </SPAN> |
| |
| </BODY> |
| </HTML> |
