--------------------------  
 Jetspeed 1.6 Fusion
   May 25, 2005
--------------------------

Jetspeed 1.6 introduces JSR 168 support into Jetspeed-1    

---------------------
 Tested App Servers:
---------------------
 * Tomcat 5.0.30
 * Tomcat 5.5.9

 Check out our wiki page for details: http://wiki.apache.org/portals/Jetspeed2


---------------------
 NO Longer Supported:
---------------------
 * Tomcat 4.1.x

Support for Tomcat 4.1.x has been dropped for Fusion

---------------------------
 Installation Instructions
---------------------------

1. Download jetspeed-fusion-1.6-Tomcat-5.0.30.tar.gz, or
   Download jetspeed-fusion-1.6-Tomcat-5.0.30.zip (windows), or
   Download jetspeed-fusion-1.6-Tomcat-5.5.9.tar.gz, or 
   Download jetspeed-fusion-1.6-Tomcat-5.5.9.zip (windows)
2. Expand jetspeed-fusion-1.6-Tomcat-<version>.tar.gz into a clean directory (as example we will use 'jetspeed')
   
   cd /jetspeed
   tar xfz jetspeed-fusion-1.6-Tomcat-<version>.tar.gz

   For Windows:
   
   cd c:\jetspeed
   unzip jetspeed-fusion-1.6-Tomcat-<version>.zip 

3. start the database

   cd /jetspeed/jetspeed-database
   start-database.sh
   
   For Windows:
   
   cd c:\jetspeed\jetspeed-database
   start-database.bat

4. startup Tomcat 

   execute /jetspeed/jakarta-tomcat-<version>/bin/startup.sh
   
   For Windows:
   
   execute c:\jetspeed\jakarta-tomcat-<version>\bin\startup.bat
   

5. start up a web browser and navigate to http://localhost:8080/jetspeed/portal


------------------------------
 Using Another J2 Database 
------------------------------

1. cd $TOMCAT_HOME/jetspeed-database/scripts
2. edit the build.properties, set the properties for your database connection, save.
3. create a database schema/catalog to hold your database tables 
4. type 'ant' to run the database population scripts
5. edit the jetspeed.xml properties 
    - $TOMCAT_HOME/conf/Catalina/localhost/jetspeed.xml
   
    and set your database connection

6. copy your database driver into Tomcat's common/endorsed directory

7. start up a web browser, navigate to http://localhost:8080/jetspeed/portal

see the instructions on the Jetspeed-1 website for general Jetspeed-1 Database configuration:

http://portals.apache.org/jetspeed-1/database.html

 Sample accounts to login as:
    
 admin/jetspeed
 turbine/turbine
 

--------------------------------
 Deploying JSR 168 Applications
--------------------------------


To deploy a portlet application to the server, 
simply copy the war file into the Jetspeed-1 Auto Deployment directory located under
            
            ${TOMCAT_HOME}/webapps/jetspeed/WEB-INF/deploy/
    

Jetspeed will automatically pick up and deploy the application within 10 seconds or so. 
You can then go to the portlet customizer, and select the portlets that you deployed and 
place them in your portal. From the Customizer Add Portlet page, there are two filters 
to help you find JSR-168 standard portlets: JSR-168 and Portlet API. 
Once you've selected the portlets in the customizer, you can then start using the portlets immediately. 

A sample portlet application to test with may be found here:

http://www.bluesunrise.com/maven/jetspeed2/wars/demo.war

For more information see:

http://portals.apache.org/jetspeed-1/fusion.html