$Id: README,v 1.3 2005/07/08 14:02:52 pasmith Exp $

==============================================================================
ENTERPRISE MEDIA BEANS SAMPE README
==============================================================================

As a pre-requisite, please deploy the emb-sample application.

To visit the emb-sample Application visit:

	http://localhost:9000/emb-sample

First you have to had some media to the database :
	- to add default samples select Load
	- to add your own samples by uploading it

All your sample will be remove after session timeout


======================================
DIRECTORY STRUCTURE:
======================================

emb-core/ 		customizes preset core application of EMB
etc/	  		all deployment descriptor
lib/			upload lib
resources/		JSPs, samples, images, html files.
src/		  	java files


======================================
KNOWN ISSUES:
======================================

Here are some known issues about the emb-sample demo:

1)	By default the application is set to work only on localhost

2)	Cookies have to be accepted in order to use this sample

3)	If the user's session times out or if the user removes their
   	cookies, all generated media will be removed

4)	This sample needs some memory under quite heavy load, I advice you to start
	JOnAS more memory than default (64MB). (if you got OutOfMemoryError)
	To do this set JAVA_OPTS environment variable to -Xmx128m, in order to
	set the maximum memory of the JVM to 128MB.


======================================
HOW TO CUSTOMIZE EMB-SAMPLE SETTING:
======================================

Customize application :
	emb sample have some few setting in order to limit the load of the 	server
	in case of an on line demo.

	- in etc/web.xml : set the session timeout (in minutes
	- in etc/embSampleSession.xml :
		- set the env entry ejb/embSample/isCopyAllowed in order to copy or
		  to modify the media when using some conversion (limit numbers of ejb
		  entity).
		- set the env entry ejb/embSample/maxMediaPerSession to set the
		  maximum of media that can be created (upload, convert if copy is
		  allowed)

	Some features are only avaiable by using some plugins such has streaming
	capabilities, video conversion or more image format support.
	For using this sample through a network (not localhost) see the
	Enterprise Media Beans documentation.
