JavaServerTM Faces 1.1 FCS
Installation Instructions



Revised: 20040205

Please refer to the Release Notes, located in your download bundle, for information regarding supported operating systems, required software, limitations and bugs.

Table of Contents:


Installing JavaServer Faces Technology in JWSDP

  1. Download the JavaTM Web Services Developer Pack 1.3 (Java WSDP).
  2. Follow the Installation Instructions for the Java WSDP.
  3. Update your path so that JWSDP_HOME points to the location of your Java WSDP installation.
  4. Download the JavaServer Faces 1.1 ZIP file.
  5. Archive or remove the the old JavaServer Faces EA3 release located in JWSDP_HOME/jsf
  6. Unzip the JavaServer Faces 1.1 ZIP file into JWSDP_HOME and rename the base directory to "jsf"
  7. You should now have the contents of the JavaServer Faces 1.1 release in your JWSDP_HOME/jsf directory
  8. If you have previously run JavaServer Faces applications, you should remove your web server's cached files before running the new release. The cached files will be located in JWSDP_HOME/work/Catalina/localhost/jsf-*. You should remove all the old jsf-* files and directories before restarting your server.
You are now ready to start developing and running JavaServer Faces applications.
 

Running the Examples in JWSDP

To run one of the samples,
  1. Copy the desired WAR file from the samples directory of the JavaServer Faces installation to JWSDP_HOME/webapps.

  2. Go to the  JWSDP_HOME/bin directory.

  3. In a terminal window start the web server.

    If you are on a Unix platform, invoke the following command to start the web server:

    catalina.sh run 

    If you are running Windows, invoke the following command to start the web server:

    catalina run


  4. Wait for the copyright license to display in your terminal window.

  5. Launch your browser.

  6. You can find a page containing links to the JavaServer Faces sample programs on your default server port:
http://localhost:8080

You can also run each sample individually by specifing the name of the war file in your web browser:

http://localhost:8080/<EXAMPLE NAME>/ 


For example, this is the address you enter if you are running the cardemo:

http://localhost:8080/jsf-cardemo/

Please note that the samples are provided as a proof-of-concept rather than a best-practices guide for writing JavaServer Faces applications.

Building and Running the Examples

To build one of the samples, you need to run its build.xml file using Ant , which is a portable make tool.

When Ant builds the application, it copies files to a temporary build directory. This directory contains an exact image of the binary distribution for your JavaServer Faces application. When Ant builds the WAR file, it packages all the files from the build directory into the WAR file while preserving the directory structure contained in the build directory

To build the samples you first need to enter some paths in the build.properties file:

  1. Make sure you have the necessary preconditions as listed in the ReleaseNotes.
  2. Make sure you have Ant version 1.5.1 installed and working on your machine.
  3. Copy build.properties.sample to build.properties and edit accordingly for your system.
  4. Go to the directory of the sample you want to build.

To build a sample WAR file and deploy it:

  1. Go to the directory of the sample you want to build.
  2. At the command line, run the default target:
    	ant
  3. The war file of the sample you just built will be placed in the JWSDP_HOME/jsf/samples directory.
  4. In JWSDP 1.3 your application will be automatically deployed.
  5. Start the server by either running catalina.sh run if you are using UNIX or catalina run if your are using Windows.
  6. When the server has started, open your browser and enter this URL:
    	http://localhost:8080/<EXAMPLE NAME>
In JWSDP, you can also find a page containing links to the JavaServer Faces samples on your default server port:
	http://localhost:8080



Installing, Building and Running the Examples in a Non-JWSDP container

  1. Download the JavaServer Faces 1.1 ZIP file
  2. Unzip the Zip file
  3. Copy build.properties.sample file to build.properties and edit accordingly for your system configuration.
  4. Make sure the following properties in your customized build.properties file point to the correct jar file location according to your system configuration:
  5. If you have previously run JavaServer Faces applications, you should remove your web server's cached files before running the new release. For instance, the cached files in a JWSDP container will be located in JWSDP_HOME/work/Catalina/localhost/jsf-*. It is safe to remove all these files before restarting your server. Read your container's documentation to find out where the cached files are located in your specific container.
  6. Follow the Building and Running the Examples section
You will need to rebuild each of the JavaServer Faces sample applications with the build.standalone property set to "true" so that each sample's web archive includes all of the jar file dependencies. This step is not necessary in a JWSDP container since all the jar dependencies that JavaServer Faces requires are already part of the container.

Note: the Building and Running the Examples section makes reference to JWSDP_HOME, substitute your container's home directory for JWSDP_HOME. You will also need to manually deploy the sample war files into your container's webapps directory

Copyright © 2004 Sun Microsystems, Inc., 4150 Network Circle, Santa
Clara, California 95054, U.S.A. All rights reserved.

Sun Microsystems, Inc. has intellectual property rights relating to
technology embodied in this product. In particular, and without
limitation, these intellectual property rights may include one or more
of the U.S. patents listed at http://www.sun.com/patents and one or more
additional patents or pending patent applications in the U.S. and other
countries.

This product is distributed under licenses restricting its use, copying
distribution, and decompilation. No part of this product may be
reproduced in any form by any means without prior written authorization
of Sun and its licensors, if any.

Third-party software, including font technology, is copyrighted and
licensed from Sun suppliers.

Sun, Sun Microsystems, the Sun logo, the Java Coffee Cup logo,
JavaServer, and Java are trademarks or registered trademarks of Sun
Microsystems, Inc. in the U.S. and other countries.

Federal Acquisitions: Commercial Software - Government Users Subject to
Standard License Terms and Conditions.


Copyright © 2004 Sun Microsystems, Inc., 4150 Network Circle,
Santa Clara, California 95054, Etats-Unis. Tous droits réservés.

Sun Microsystems, Inc. a les droits de propriété intellectuels relatants
à la technologie incorporée dans ce produit. En particulier, et sans la
limitation, ces droits de propriété intellectuels peuvent inclure un ou
plus des brevets américains énumérés à http://www.sun.com/patents et un
ou les brevets plus supplémentaires ou les applications de brevet en
attente dans les Etats - Unis et les autres pays.

Ce produit ou document est protégé par un copyright et distribué avec
des licences qui en restreignent l'utilisation, la copie, la
distribution, et la décompilation. Aucune partie de ce produit ou
document ne peut être reproduite sous aucune forme, par quelque moyen
que ce soit, sans l'autorisation préalable et écrite de Sun et de ses
bailleurs de licence, s'il y ena.

Le logiciel détenu par des tiers, et qui comprend la technologie
relative aux polices de caractères, est protégé par un copyright et
licencié par des fournisseurs de Sun.

Sun, Sun Microsystems, le logo Sun, le logo Java Coffee Cup, JavaServer,
et Java sont des marques de fabrique ou des marques déposées de Sun
Microsystems, Inc. aux Etats-Unis et dans d'autres pays.