Sun Java System Application Server

The Form-Based Authentication Sample Application

The Form-Based Authentication application is a collection of simple applications that demonstrate how to use the servlet and Java Server Pages^(JSP) APIs. Assemble and deploy this application for a quick introduction to web applications and application development and administration tools.

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/webapps/apps/security/form-auth.
appname is the application name: web-form-auth.
The prebuilt WAR file is web-form-auth.war.

Follow this general procedure:

Build the Application. The build file, build.xml, is in the app_dir directory, specifically, install_dir/samples/webapps/apps/security/form-auth.
Deploy the Application. The WAR file is install_dir/samples/webapps/apps/security/form-auth/web-form-auth.war.
Run the Application. The application name is web-form-auth.

Note

You must run asant undeploy before redeploying this sample. This ensures that all modules are undeployed and the resources are disabled. The application is undeployed, however. To remove resources, run the asant keydel command.
Warning: Do not execute this asant keydel step if form--auth security sample is running.