
                  A  P  A  C  H  E    J  E  T  S  P  E  E  D


  What is it?
  -----------

  Jetspeed is an Enterprise Information Portal framework aiming to provide :

  * an efficient multi-device user customizable portal interface
  
  * a portal independant "portlet" API used for developing customizable
    components that can be integrated into any compatible portal

  * a lightweight syndication system that can be used as a simple distributed
    HTTP content management system
    
  Jetspeed will not provide a full content management system but will 
  provide bridges to external CMS systems like Apache Slide or Infozone Prowler
  
  Where is it?
  ------------

  The home page for the Apache Jetspeed project can be found in the Apache Java 
  Project web site (http://jakarta.apache.org/jetspeed/). There you also find 
  information on how to download the latest release as well as all the other 
  information you might need regarding this project.

  Requirements
  ------------

  Jetspeed is implemented as a Java web application.
  The following requirements exist for installing it:

   o  A Java 1.2 or later compatible virtual machine for your operating system.

   o  Server API 2.2 compatible Servlet Engine.
  

  Installation Instructions for the war distribution
  -----------------------------------------------------

  Read the INSTALL file in this directory for the installation instructions.

  The documentation available as of the date of this release is
  included in the WAR file.

  Look for the most updated documentation on the Apache Jetspeed web site under
  the Apache Java Project (http://jakarta.apache.org/jetspeed/).

  Installation Instructions for the source distribution
  -----------------------------------------------------

  Read the INSTALL file in this directory for the installation instructions.

  The documentation available as of the date of this release is
  included in the "docs/" directory.

  Look for the most updated documentation on the Apache Jetspeed web site under
  the Apache Java Project (http://jakarta.apache.org/jetspeed/).


  Release Notes and Known issues
  ------------------------------

  For additional information on this release, please read the NOTES file.


  Licensing and legal issues
  --------------------------

  For legal and licensing issues, please read the LICENSE file.


  Usage Warnings
  --------------

  Please, read the WARNING file before continuing.


  Thanks for using Apache Jetspeed.

==============================================
Migration Issues from Jetspeed 1.4b1
==============================================

There are three known issues:

1. Add a new column on TURBINE_USER table:

PASSWORD_CHANGED TIMESTAMP

2. Torque has been upgraded. See issue list here:

http://jakarta.apache.org/jetspeed/site/supporting-projects.html

3. If you're using the Hypersonic SQL db, the primary key id columns have
been changed to auto-increment. To not use auto-increment, change your security-schema.xml 
back to using the ID_TABLE, add the new column, and regenerate.
You must then add the new column to your hypersonic database in production by edition jetspeed.script.

==============================================
Commons logging usage notes for release 1.4b4
==============================================

The final release of Jetspeed will use commons logging instead of turbine logging facilities. As an interim
solution, Jetspeed ships with a custom logging service that allows to use log4j directly. To activate:

        1. Add init-param "logging" in web.xml and set it to "org.apache.jetspeed.services.logging.JetspeedLoggingService".
        2. Change this in tr.props:
                services.LoggingService.classname = org.apache.jetspeed.services.logging.JetspeedLoggingService
                services.LoggingService.default = jetspeed
        3. Add this in tr.props:
                services.LoggingService.log4j.properties = /WEB-INF/conf/log4j.properties
 
Now you can configure logging via log4j.properties.

==============================================
Maven usage notes for release 1.4b4
==============================================

Maven build is a work in progress and will be complete for the final release. The major part still missing from
the Maven build is creation of the Torque object model and castor registry peers. So theoretically, if you use
ant build to generate these once, you can start using maven from that point on. Also, in CVS, there's a maven
jetspeed plugin (/src/plugins-build/jetspeed) which offers various options on building custom portals based on
jetspeed .war file or binary distribution (product of maven dist:build). In the future, this plugin will be
distributed with maven or available through maven-plugins.sourceforge.net.

The maven build was tested with version 1.0 Beta 9 of Maven.

==============================================
Jetspeed 1.4b4 was released on April 25, 2003.
==============================================

* New Features *

	- Registry editors (portlet, security, client, skin). Contributed by Jeremy Ford
	- Ant task for overriding properties. Contributed by Eric Pugh
        - Maven jetspeed plugin. Contributed by Eric Pugh
	- MVC portlet. Joint effort by Scott Weaver and Tod Kuebler
        - JSP Stock Quote Portfolio demo portlet
	- Greatly improved international support (change language portlet + custom localization service)
	- Jetspeed questionnaire
	- Forwarding tool

* Jetspeed Security *

	- Plugged security hole allowing unathorized access to psml
	- Default security ref may now be defined for newly created portal resources

* Misc *

	- Access to skins, references and security refs in the customizer is now security driven
	- Sample Hypersonic database now comes pre-populated with psml
	- Directory based skin support for images

* Bug Fixes *

	- See FIXES.html for a full list of fixes in this release


================================================
Jetspeed 1.4b3 was released on December 15, 2002
================================================
Jetspeed 1.4b3 is a patch to version 1.4b2 fixing two sets of bugs:

Bugs 14907, 15000 - Security hole bugs fixed. 
                     Users with admin role can no longer access admin resources.

Bugs 14917, 15265 - Xerces does not handle correctly file paths on some platforms (Novell),  Windows with spaces. 
                    This was causing many Windows-based installs to fail.


===============================================
Jetspeed 1.4b2 was released on December 9, 2002
===============================================

* New Features *

This release is full of new features thanks in great part to a very welcome new committer, Mark Orciuch. Here is a list of new features implemented by Mark:

    - Parameter Presentation Styles - Data Entry Widgets including Date/Calendar, ListBox, CheckBoxGroup, TextArea, Custom JSP, Custom Velocity
    - Portlet Preview Mode
    - Portlet Usage Logging
    - Password Expiration 
    - Online Profile Import/Export
    - Print Friendly Mode
    - Filtering in User Browser and Psml Browser 


* Documentation *

Jetspeed 1.4b2 introduces a new set of documentation to more fully cover the changes made to version 1.4. We have added the following documents:

    - New 100+ page Jestpeed Tutorial 
    - JPortal Application Examples, accompanies the tutorial
    - Jetspeed Axis Integration Guide
    - New Registry Documentation
    - New Layout Documentation
    - New Client Media Documentation


* Dependencies *

We updated as many Jars as we could to the latest versions without breaking the dependencies.
Most importantly, we are now again in sync with the latest releases of: 

    Torque 
    Turbine 
    Commons
    Hypersonic DB


* Improved JSP Support *

Jetspeed JSP Tag library updated to support internationalization and Jetspeed Links. JSP templating engine updated to operate like Velocities, supporting the same media/language/country fallback algorithm.


* Client and Media Type Registries *

Two new registries have been added to better support new Media Types and Client agents.


* Jetspeed Security *

Further enhancements to security:
    - New LDAP Security Implementation from Ender Kilicoglu
    - Added "owner rule" to only allow access to the owner of a portal resource
    - Cleaned up security in default site
    - Add Security to References


** Misc **

    - Allow Customization of Portlet Control per Portlet
    - New File Cache utility
    - CheckStyle added to build

 