Sun Microsystems Logo



Sun[tm] ONE Application Server 7
Sample Applications

Samples Index

Complete index of sample applications provided as part of the application server.

Getting Started Guide 

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.

 

Obtaining Assistance

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.