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 <install_dir>/docs/getting-started/index.html
Before Working With Samples
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 ONE 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.
If you are using the application server that is installed as part of
a Solaris 9 installation, you will need to download and install PointBase
if you intend to use the 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
When the PointBase database server is installed as part of the application
server installation, the database server includes a prepopulated database
containing the tables and data required by the sample applications.
For more information on how to use PointBase with the samples, see the
section Using PointBase with the Samples.
This section also addresses how to download, install and configure the
PointBase server when you are using the application server that is installed
as part of a Solaris 9 installation.
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 ONE Application Server 7 area of
the Sun Software Forums.