OpenEJB QuickStart Guide

|  |  |  | OpenEJB OpenJMS OpenORB Castor Tyrex |

Main
Welcome!
Download
Mailing Lists
The Team

Users
Quickstart
Hello World!
CMP Example
CMP Guide
Deploy
Startup
Validation
Configuration
Support
Request Feature
FAQ

Servers
Local Server
Remote Server
Tomcat

Integrators
Why OpenEJB
Overview
Design
Specification
Presentation

Developers
Custom Services
Release Plan
Source Code
SourceForge

OpenEJB QuickStart Guide

1Installation
2Using OpenEJB
3Join the mailing list

## Installation

To install OpenEJB, simply download the latest release and unpack your zip or tar.gz into the directory where you want OpenEJB to live.

Windows users can download the zip and unpack it with the WinZip program.

Linux users can download the tar.gz and unpack it with the following command:

tar xzvf openejb-0.8.3.tar.gz

Congradulations, you've installed OpenEJB.

NOTE

If you are on Mac OS X and have downloaded the tar.gz, don't bother trying to unpack it with anything other than the above tar command, it won't work.

If you've unpacked OpenEJB into the directory C:\openejb, for example, than this directory is your OPENEJB_HOME directory. The OPENEJB_HOME directory is refered to in various parts of the documentation, so it's good to remeber where it is.

## Using OpenEJB

Now all you need to do is move to the OPENEJB_HOME directory, the directory where OpenEJB was unpacked, and type:

openejb help

For Windows users, that looks like this:

C:\openejb> openejb help

For UNIX/Linux/Mac OS X users, that looks like this:

[user@host openejb]# ./openejb.sh help

You really only need to know two commands to use OpenEJB, deploy and start. Both are completely documented and have examples.

For help information and command options, try this:

openejb deploy -help
openejb start -help

For examples on using the command and options, try this:

openejb deploy -examples
openejb start -examples

That's it!

If you don't have any EJBs or clients to run, try the ubiquitous Hello World example.

## Join the mailing list

The OpenEJB User list is where the general OpenEJB community goes to ask questions, make suggestions, chat with other users, and keep a finger on the pulse of the project.

Please feel free to ask as many questions as you need while becoming familiar with the project. We believe the perspective of those who are new the project is very valuable and we rely on your feedback to make the project easier to use and understand for everyone. If you have any suggestions on ways we can help those that are new to the project get up to speed more quickly, we are more than willing to listen.

Subscribe/View Archive

Java, EJB, JDBC, JNDI, JTA, Sun, Sun Microsystems are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and in other countries. XML, XML Schema, XSLT and related standards are trademarks or registered trademarks of MIT, INRIA, Keio or others, and a product of the World Wide Web Consortium. All other product names mentioned herein are trademarks of their respective owners.