Before working with the samples, ensure that you've followed the Getting
Started Guide in order to familiarize yourself with the features and basic
operation of the application server. The Getting Started Guide is available
at http://docs.sun.com/db/prod/s1appsrv.
In addition to following the Getting Started Guide, it is recommended
that you review the following sections prior to working with the sample
applications.
1. Set Up Your Environment
Before deploying sample applications to Sun Java (tm) System Application Server,
ensure your application server environment is functioning properly. The
basic operations introduced in the Getting Started Guide will help ensure
that your environment is configured properly. A key requirement prior to
working with the samples is to ensure that the following directory is added
to your PATH environment variable:
<install_dir>/bin
If you are either sharing your application server installation with other
users or using a user ID that does not have write permissions to the area
in which the application server is installed (for example, a non root user
using an application server installed under
/usr/appserver/ on Solaris[tm] 9), you should make a copy of the
sample applications in your own directory before working with the samples.
For more information on creating your own samples environment, see the
section Creating Your Own Samples Environment.
To use PointBase with sample applications that depend on JDBC[tm] to
access a database. Follow the steps in Using
PointBase with the Samples section for instructions on downloading,
installing and configuring PointBase for use with the sample applications.
Alternatively, you can use an Oracle database server by following the section
below that addresses how to use Oracle with the samples.
2. Review Samples Directory Structure
The sample applications included in the application server installation
are packaged according to a consistent structure. Each sample's directory
structure represents a typical source code directory structure layout.
For more information on the manner in which the samples are organized,
see the section Samples Directory Structure.
3. Review Using Ant with the Samples
All of the samples include build.xml
files that enable you to use the Java[tm]-based Ant build facility to easily
recompile, reassemble and redeploy the sample applications. For more information
on using Ant with the samples, see the section Using
Ant with the Samples.
4. Review Using PointBase with the
Samples
To use PointBase with the samples which require database connections,
see the section Using PointBase with the
Samples. This section also addresses how to download, install and
configure the PointBase server.
5. Review Using Oracle with the Samples
The samples which require database connections can also work with an
Oracle RDBMS. For more information on how to use an Oracle RDBMS with the
samples, see the section Using Oracle with
the Samples.
If you encounter problems while running the samples, please access the
Sample Applications topic in the Sun Java (tm) System Application Server 7 area of the
Sun Software Forums.