Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

...

openejb start - OpenEJB Remote Server

SYNOPSIS

openejb start options #options

NOTE

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 OPENEJB_HOME to the path of the directory where you unpacked the OpenEJB installation.

...

In UNIX, Linux, or Mac OS X, the deploy tool can be executed as follows:

[user@host openejb-3.0]# ./bin/openejb start

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.

[user@host openejb-3.0]# chmod 755 bin/openejb

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.

...

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.

OPTIONS

-D<name>=<value>

Specifies a system property passed into OpenEJB at startup.

--admin-bind <host>

Sets the host to which the admin service should be bound.

--admin-port <int>

Sets the port to which the admin service should be bound.

--conf <file>

Sets the OpenEJB configuration to the specified file.

--ejbd-bind <host>

Sets the host to which the ejbd service should be bound.

--ejbd-port <int>

Sets the port to which the ejbd service should be bound.

--examples

Show examples of how to use the options.

-h, --help

Print this help message.

--hsql-bind <host>

Sets the host to which the hsql service should be bound.

--hsql-port <int>

Sets the port to which the hsql service should be bound.

--httpejbd-bind <host>

Sets the host to which the httpejbd service should be bound.

--httpejbd-port <int>

Sets the port to which the httpejbd service should be bound.

--local-copy <boolean>

Instructs the container system to marshal (ie, copy) all calls between beans.

--telnet-bind <host>

Sets the host to which the telnet service should be bound.

--telnet-port <int>

Sets the port to which the telnet service should be bound.

-v, --version

Print the version.

...

Sets the openejb.configuration system variable to the file C:\openejb\conf\mytest.conf. When the server starts up and initializes OpenEJB, this configuration will be used to assemble the container system and load beans.

Example: --local-copy

The local-copy option controls whether Remote interface arguments and results are always copied.

openejb start --local-copy=true (default)

Remote interface business method arguments and results are always copied (via serialization), which is compliant with the EJB standard. Instructs the container system to marshal (ie, copy) all calls between beans are required by the EJB 1.1 specification.

openejb start --local-copy=false

Remote interface business method arguments and results are copied only when the client is in a different JVM. Otherwise, they are passed by reference - as if it were a Local interface. This is faster, of course, but non-compliant with the EJB standard.

Local interfaces are not affected; their arguments and results are passed by reference and never copied 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.

CONFIG OVERRIDE EXAMPLES

...

Code Block
Apache OpenEJB 3.0    build: 20070825-01:10
http://openejb.apache.org/
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!