J2EE[tm] Blueprints > Java[tm] Pet Store Administrator > Installation

Installation

This document describes how to install and configure the Java Pet Store Administrator application on UNIX and Win32 machines.

This application is intended to be used on top of the Java Pet Store, which you must install before installing the Java Pet Store Administrator.

Note: These instructions use $JPS_HOME (UNIX) and %JPS_HOME% (Win32) to denote the root directory of the J2EE Blueprints bundle.

Creating the administrator account

The application requires an administrator account with the user name jps_admin (and password admin) in the J2EE Reference Implementation server.

To create this account:

UNIX: Bring up a shell prompt, change your current directory to $JPS_HOME and run createadminuser.sh.
Win32: Bring up a command prompt, change your current directory to %JPS_HOME% and run createadminuser.bat.

Deploying the application

Start the Cloudscape database server and J2EE Reference Implementation server. Then, start the J2EE Reference Implementation deployment tool.

From the File menu, select Open Application.... In the subsequent file dialog, open petstoreadmin.ear, which can be found in $JPS_HOME (UNIX) or %JPS_HOME% (Win32).

Then, from the Tools menu, select Deploy Application. Click through the subsequent dialogs to complete the deployment. You shouldn't have to change any of the default values.

Testing the application

Deploy the Java Pet Store if it is not already deployed. Use it to order some pets.

Then, with the Java Pet Store Administrator deployed, follow these steps:

Visit the Java Pet Store Administrator using the link given at the end of these instructions. Click the link on the welcome page to load the administrator login page.
Log in using the administrator account (user name jps_admin, password admin). On the subsequent page, click the Update Order Status button to display the table of all the pending Java Pet Store orders.
Use the drop-down boxes in the Order Status column to change the status of each order to Approved ("A") or Denied ("D"). Check the boxes in the Update column to mark which orders you would actually like to update. Click the Submit button to update the status of all marked orders.

To use the administrator module, click the following link:

http://localhost:8000/admin/

Note: These instructions assume that the application is deployed on a machine named localhost and port 8000. You should substitute localhost and 8000 with the name of the machine and the port on which the application is deployed.