<%-- 
/**
  * Copyright (c) 2004 Red Hat, Inc. All rights reserved.
  *
  * This library is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Lesser General Public
  * License as published by the Free Software Foundation; either
  * version 2.1 of the License, or any later version.
  *
  * This library is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  * Lesser General Public License for more details.
  *
  * You should have received a copy of the GNU Lesser General Public
  * License along with this library; if not, write to the Free Software
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307
  * USA
  *
  * Component of: Red Hat Application Server
  * 
  * Initial Developers: Aizaz Ahmed
  *                     Vivek Lakshmanan
  *                     Andrew Overholt
  *                     Matthew Wringe
  *
  */
--%>

<%-- 
This Page displays a message saying that the database needs to be populated to continue
The database is only populated the first time the application is ran
--%>


<% request.setAttribute ( "page_title", "Help Information" ); %>

<jsp:include page="../nav/loginHeader.jsp" />

<div ALIGN="center">
<h2>
OLSTORE HELP INFORMATION
</h2>
</div>

<div style="MARGIN-LEFT:10%; MARGIN-RIGHT:10%">
<h3>
		<br/>
		This information is also contained in the README file under examples/olstore in the source code.
		<br/>
		<br/>
		
		To visit the Olstore Web Application visit:

		<a href="/olstore">
		http://localhost:9000/olstore 
		</a>	 
		<br/><br/>
	
		If this is your first visit to the store an page will be displayed asking you to populate 
		the database please follow these instructions. This message should only be displayed when 
		the database is empty (ie when you use it the first time or after you have cleared the database).
		<br/><br/>
		If you have made changes in the Olstore application and wish to return it to its original 
		state you will have to clear/drop the database and recreate it.
		<br/><br/>

		<h2>Clearing/Dropping the Database:</h2><br/>

		<b>NOTE:</b> there may be other application using this same database. Clearing/dropping the database 
		will remove all information stored in it. Clear/drop this database at your own risk.<br/><br/>

		Here is an example of how you would clear/drop a database in PostgreSQL </br></br>

		<li>Stop the jonas server:	service jonas stop	</li>
		<li>Drop the database:		dropdb -p 5433 db_jonas </li>
		<li>Create the database:	createdb -p 5433 db_jonas</li>
		<li>Start the server:		service jonas start</li>
		<li>Deploy the app:		jonas admin -a olstore.ear (or using the JonasAdmin Web Application) </li>
		<li>visit Olstore:			http://localhost:9000/olstore</li>
		<br/>
		
		Alternatively, tables in the database related to the Olstore Application are prefixed with 'olstore'
		in their names and they can be selectively dropped.
		<br/><br/>


		<h2>HOW TO USE THE RHAPS ONLINE STORE DEMO:</h2>
		<br/><br/>
		
		The online store demo acts like almost any other online store, except it has the added feature that 
		users can have friends associated with them. Users can buy products or mark products as 
		interesting and these products will be displayed to their friends. This was done with the presumption 
		that friends usually share the same interests and basic spending habits. How 
		to use this demo should be intuitive to the user. Most actions can be performed by using a 
		navigation bar on the left side of the screen. <br/><br/>
		
		There are two classes of users: customers and administrators.<br/><br/>
		
		CUSTOMERS:<br/><br/>
		Customer users can perform the usual actions associated with an online store. They can browse and 
		purchase products, mark products as interesting, checkout items, check the status of their orders, 
		see which items they have bought, and update their user information. The usernames and passwords of 
		some built in users are listed below. Some of these users already have friends associated with them 
		and some have also purchased items. Also note that a new user can be created by clicking on the 
		"register a new user" link on the login page.<br/><br/>
		
		Customer Usernames and Passwords: <br/>
			mwringe/qwerty<br/>
			aahmed/password<br/>
			SamOak/Oaktree<br/>
			bobbyv/bob47<br/>
			lucy666/meow666<br/>
			troll/troll9<br/>
			mfrost/elley<br/>
			icyMeg/74yci<br/>
			Sammy/MarG14<br/>
			user1/user1<br/>
			user2/user2<br/>
			user3/user3<br/>
			user4/user4<br/>
			
			<br/><br/>
		
		ADMINISTRATORS:<br/><br/>
		Another class of users is Administrator. These users can perform the same actions that customers 
		can, but they also have special administrative actions they can perform. Administrators can: update 
		the information about an item, create a new item, create a new type of item, and update orders. The 
		usernames and passwords of the administrators are listed below. Please note that new administrators 
		cannot be created by a user at this time.<br/><br/>
		
		Administrator Usernames and Passwords:<br/>
			admin/admin<br/>
			vivek/vivek<br/>
			jonas/jonas<br/>
		<br/><br/>
		
		
		<h2>KNOWN ISSUES:</h2>
		
		Here are some known issues about the RHAPS Online Store Demo: <br/></br>
		
		1) Problems can occur if the user changes the location bar manually to  <br/>
		   a jsp page. Please use links or access the pages through the URLs you<br/>
		   see in the location bar of your browser.<br/>
		2) If the user's session times out or if the user removes their<br/>
		   cookies, then if the user hits the logout page, they will have to<br/>
		   login twice (once to validate themselves to logout)<br/>
		3) If the user's session times out or if the user removes there cookies<br/>
		   and the user is currently looking at the login page, when they try to<br/>
		   log in they will get an error about an invalid reference to the<br/>
		   login page. This is a side-effect of the paranoid approach that<br/>
		   container managed security takes.<br/>
		4) When the user changes any of their information and if there is an<br/>
		   error in any of the text fields, any changes to the user's friends<br/>
		   list will be lost.<br/>
		5) If the user hits the login button twice rapidly, on some random<br/>
		   occasions it will take the user to an error page that says 'location <br/>
		   was not found' with a link to return to the store. </br>
		
		 <br/><br/><br/>
 		 
    	 
    	 <div ALIGN="center">
    	 <a href="/olstore">
		 Please click here to return to the Olstore Front Page. <br/>
		 </a>	 
 
		 </div>
</h3>
</div>


<jsp:include page="../nav/Footer.jsp" />
