Sample J2EE Applications

Chapter 1 Using the Samples

The SilverStream Application Server provides three complete sample applications developed according to J2EE (Java 2 Platform, Enterprise Edition) specifications:

Java Pet Store--The standard J2EE sample application from Sun Microsystems, packaged along with supporting files for easy deployment to the SilverStream Application Server. You can learn a lot about J2EE by examining and running the Java Pet Store.
SilverBooks--A Web-based e-commerce application that simulates an online bookstore. SilverBooks uses the Struts Framework architecture, an open-source framework for Web applications that implements the Model-View-Controller (MVC) design paradigm.
HTML SMC--A J2EE version of the SilverStream Management Console. This sample SMC demonstrates techniques for performing vendor-specific operations (in this case, SilverStream Server Administration API calls) in the context of a standard Struts application.

Installing and running the sample applications

By default, the J2EE sample applications are installed on your hard drive when you install the SilverStream Application Server. The directories that are installed for the J2EE sample applications include:

Directory

Description

samples

The root directory for the SilverStream J2EE sample applications and other code examples.

samples\SilverBooks

The subdirectory containing the SilverBooks sample application files.

It contains a \Cloudscape and a \SybaseASA subdirectory. These subdirectories each contain a database with an already deployed SilverBooks EAR file. Once you have added one of these databases to the SilverStream Application Server, you can run the SilverBooks application.

The SilverBooks directory also contains a \src directory that includes the SilverBooks source files.

samples\PetStore

The subdirectory containing the Pet Store sample application files.

For more information on the Pet Store application and how to deploy it to a SilverStream Application Server, see Java Pet Store.

Directory	Description
samples	The root directory for the SilverStream J2EE sample applications and other code examples.
samples\SilverBooks	The subdirectory containing the SilverBooks sample application files. It contains a \Cloudscape and a \SybaseASA subdirectory. These subdirectories each contain a database with an already deployed SilverBooks EAR file. Once you have added one of these databases to the SilverStream Application Server, you can run the SilverBooks application. The SilverBooks directory also contains a \src directory that includes the SilverBooks source files.
samples\PetStore	The subdirectory containing the Pet Store sample application files. For more information on the Pet Store application and how to deploy it to a SilverStream Application Server, see Java Pet Store.

To install and run the sample applications:

Install the SilverStream Application Server with these options:

(Optional) Install Sybase Adaptive Server Anywhere if you want to use it to run the Java Pet Store or SilverBooks sample application. (You do not need to install Sybase ASA if you plan to use Cloudscape.)

Select one of these installation types:

Type of install

What happens

Typical install

Installs the sample application files. Creates the ODBC settings for the sample applications (except Java Pet Store which you have to create yourself) but does not add them to your server.

This option allows your server to start faster (because it does not have to start any sample databases when the server starts, as it does when you do a full install).

Full install

Installs the sample application files. Creates the ODBC settings for the sample applications (except Java Pet Store). Adds all sample applications to your server at once.

Custom install

If you select Sample databases, installs the sample applications you select, creates their ODBC settings (except Java Pet Store), and adds them to your server.

Type of install	What happens
Typical install	Installs the sample application files. Creates the ODBC settings for the sample applications (except Java Pet Store which you have to create yourself) but does not add them to your server. This option allows your server to start faster (because it does not have to start any sample databases when the server starts, as it does when you do a full install).
Full install	Installs the sample application files. Creates the ODBC settings for the sample applications (except Java Pet Store). Adds all sample applications to your server at once.
Custom install	If you select Sample databases, installs the sample applications you select, creates their ODBC settings (except Java Pet Store), and adds them to your server.

If you chose Typical install, you must add the sample database to your server--by using the Add Database utility or the AddDatabase SilverCmd, or by selecting Add Database from the Main Designer.

To add the SilverBooks database:

Database type

Database name

JDBC URL

Informix Cloudscape

SilverBooksCS

jdbc:cloudscape:SilverStreamInstallDir/samples/SilverBooks/Cloudscape/SilverBooks

Sybase ASA

SilverBooks

Not needed

Database type	Database name	JDBC URL
Informix Cloudscape	SilverBooksCS	jdbc:cloudscape:SilverStreamInstallDir/samples/SilverBooks/Cloudscape/SilverBooks
Sybase ASA	SilverBooks	Not needed

Here are the username and password combinations:

Database type

Username

Password

Informix Cloudscape

APP

password

Sybase ASA

dba

sql

Database type	Username	Password
Informix Cloudscape	APP	password
Sybase ASA	dba	sql

Once you’ve added the SilverBooks database to the server, you can run it. See SilverBooks for more information.

For information on adding the Java Pet Store database and running the application, see Java Pet Store. For information on adding and running the HTML SML, see HTML SMC.

For more information about installation options, see the SilverStream Application Server Installation Guide.

Sample J2EE Applications