Welcome to the NetUI/JSF Sample
===============================

Requirements
============
The following software is required to build and deploy this sample:
  - Java 5
  - Ant 1.6.2
  - Servlet or J2EE Container
  - A JavaServer Faces implementation; either MyFaces or the JavaServer Faces
    Reference Implementation.

Installing Dependencies
=======================
1) Java 5

  Download: http://java.sun.com/j2se/1.5.0/download.jsp

  Install Java 5 and set the JAVA_HOME environment variable to
  refernce the JDK install directory.  Ensure that $JAVA_HOME/bin is
  available in your $PATH.

2) Ant 1.6.2

  Download: http://ant.apache.org/bindownload.cgi

  Ant 1.6.2 is the minimum version required by the Beehive build infrastructure.
  Install Ant 1.6.2 and set the ANT_HOME environment variable to reference the
  Ant install directory.  Ensure that $ANT_HOME/bin is available in your $PATH.

3) J2EE Container

  A Servlet or J2EE container is required.  The NetUI/JSF sample will run well
  on Tomcat 5.x.  If you are using Tomcat, make sure that the CATALINA_HOME
  environment variable is set to the root of the Tomcat installation.

4) JavaServer Faces

   Download one of the following:
       - MyFaces 1.0.9 or later, at http://myfaces.apache.org
       - JavaServer Faces v1.1.01 Reference Implementation, at
         http://java.sun.com/j2ee/javaserverfaces/download.html

   Once a JSF implementation has been downloaded, set the "jsf-api.jar" and
   "jsf-impl.jar" property as appropriate in build.properties. Note, if you
   use MyFaces 1.1.2 or later, it is dependent on commons-collections-3.1.jar
   and commons-lang-2.1.jar. You will need to set the "commons-collections.jar"
   and "commons-lang.jar" properties in build.properties as well.

Building
========
The application is set up to create an exploded web application directory in
build/ by copying the web/ directory, building Beehive source artifacts, and 
compiling the source files in the src/ directory.

The first time you build the web application, the Beehive runtime libraries will
need to be copied into the webapp with:

  $> ant deploy-beehive

Then, the webapp can be built with:

  $> ant build-myfaces
          -or-
  $> ant build-jsf-ri

To clean the webapp, run:

  $> ant clean

To build a .war file for the webapp, run:

  $> ant war

Deploying and Running
=====================
Use your container's standard deployment practice to deploy the Web
application found in samples/netui-jsf.

The default context path for the webapp is "netui-jsf".  When deployed to the
server, the web appliciation should be available at the URL:

  http://<host>:<port>/netui-jsf/

If you are using Tomcat 5.0.x for you J2EE container, you can deploy using the
following *after you have built using 'build-myfaces' or 'build-jsf-ri'*:

  $> ant build war
  $> cp netui-jsf.war $CATALINA_HOME/webapps

Check the Beehive Wiki or your application container's documentation for
information about deploying to other application containers.