Sun Java System Application Server

The bmp-simple Sample Application

The bmp-simple application provides a basic example of an application that uses bean-managed persistence (BMP) Enterprise JavaBeans (EJBs). The EJB uses a relational database, which requires you to register a JDBC resource, as described in the following instructions.

Setting up the environment

Before you deploy or run the application, you must ensure that a database resource has been configured for Application Server. The included asant deployment script automatically performs this step for you. But if you are using another deployment mechanism, you must perform it manually.

You can use any JDBC-compliant relational database server, but specific instructions are provided for the following:

Derby: Derby comes with Application Server in most configurations. For more information, see Using the Derby Database with Sample Applications.
PointBase: a small-footprint Java relational database. For more information, see Using PointBase with the Samples
Oracle: One of the most popular relational databases. For more information, see How to run samples with Oracle database server

Building, Deploying, and Running the Application

The general instructions for building, deploying, and running sample applications are provided in Building, Deploying, and Running Sample Applications. In reading this document, use the following application-specific variables for this application:

install_dir is the directory where Application Server is installed.
app_dir is the application base directory: install_dir/samples/ejb/bmp/apps/simple.
The application client JAR is bmp-simpleClient.jar.
The prebuilt EAR file is bmp-simple.ear.

Follow this general procedure:

Build the Application. The build file, build.xml, is in the app_dir directory, specifically, install_dir/samples/ejb/bmp/apps/simple.
Deploy the Application The EAR file is install_dir/samples/ejb/bmp/apps/simple/bmp-simple.ear.
Run the Application as described below.

Running the Application

To run the application, execute the bmp-simpleClient.jar in the application client container:

cd app_dir
appclient -client bmp-simpleClient.jar

The appclient executable is located in install_dir/bin/appclient.