taylor 2002/07/16 16:09:06 Modified: xdocs install.xml Log: Installation procedure rewritten Revision Changes Path 1.21 +109 -19 jakarta-jetspeed/xdocs/install.xml Index: install.xml =================================================================== RCS file: /home/cvs/jakarta-jetspeed/xdocs/install.xml,v retrieving revision 1.20 retrieving revision 1.21 diff -u -r1.20 -r1.21 --- install.xml 13 Jul 2002 09:03:59 -0000 1.20 +++ install.xml 16 Jul 2002 23:09:06 -0000 1.21 @@ -31,8 +31,96 @@ </li> </ul> </section> - <section name="Installation"> - <p> + <section name="Downloading A Release Build"> +<p> +When downloading a release build, there are three kinds of builds that you can download: +<ul> +<li><b>Full WAR</b> - Gives you the entire Web Application including all documentation and javadocs. +</li> +<li><b>WAR</b> - Gives you the Web Application minus documentation and javadocs. +</li> +<li><b>Source</b> - Gives you the source code and resources. You will need to build Jetspeed yourself. +</li> +</ul> +The WAR and Full WAR downloads do not require for you to build Jetspeed. The Web Application is ready to deploy to your application server in a Web Archive (WAR) format. +</p> + <table> + <tr> + <th>Release 1.4b1 (Latest)</th> + <th>Download From:</th> + </tr> + <tr> + <td>Jetspeed Release 1.4b1 - Full WAR</td> + <td><a href="http://jakarta.apache.org/builds/jakarta-jetspeed/release/v1.4b1/jetspeed-1.4b1-release-fullwar.zip">jetspeed-1.4b1-release-fullwar.zip</a></td> + </tr> + <tr> + <td>Jetspeed Release 1.4b1 - Standard WAR</td> + <td><a href="http://jakarta.apache.org/builds/jakarta-jetspeed/release/v1.4b1/jetspeed-1.4b1-release-fullwar.zip">jetspeed-1.4b1-release-war.zip</a></td> + </tr> + <tr> + <td>Jetspeed Release 1.4b1 - Source Only</td> + <td><a href="http://jakarta.apache.org/builds/jakarta-jetspeed/release/v1.4b1/jetspeed-1.4b1-release-fullwar.zip">jetspeed-1.4b1-release-src.zip</a></td> + </tr> + + </table> + <table> + <tr> + <th>Release 1.3a2</th> + <th>Download From:</th> + </tr> + <tr> + <td>Jetspeed Release 1.3a2 - Full WAR</td> + <td><a href="http://jakarta.apache.org/builds/jakarta-jetspeed/release/v1.3a2/jetspeed-1.3a2-release-fullwar.zip">jetspeed-1.3a2-release-fullwar.zip</a></td> + </tr> + <tr> + <td>Jetspeed Release 1.3a2 - Standard WAR</td> + <td><a href="http://jakarta.apache.org/builds/jakarta-jetspeed/release/v1.3a2/jetspeed-1.3a2-release-fullwar.zip">jetspeed-1.3a2-release-war.zip</a></td> + </tr> + <tr> + <td>Jetspeed Release 1.3a2 - Source Only</td> + <td><a href="http://jakarta.apache.org/builds/jakarta-jetspeed/release/v1.3a2/jetspeed-1.3a2-release-fullwar.zip">jetspeed-1.3a2-release-src.zip</a></td> + </tr> + + </table> + + </section> +<section name="Downloading A Nightly Build"> +<p> +The Jetspeed Nightly Builds are automatically updated from CVS every night on the Jakarta server. +Each zip file is a snapshot of the entire CVS at the end of the given day. +You will need to build Jetspeed from the nightly snapshots. +The last seven builds are available for download in both GZIP and ZIP formats. +The last seven builds are available from here: +<a href="http://jakarta.apache.org/builds/jakarta-jetspeed/nightly/">Nightly Builds</a> +</p> +</section> +<section name="Checkout from CVS"> +<p> +The best way to get the latest Jetspeed source is to checkout directly from CVS. +Follow the Jakarta CVS instructions available <a href="http://jakarta.apache.org/site/cvsindex.html">here</a> +and checkout the <b>jakarta-jetspeed</b> module. +</p> +<p> +<b> +cvs -d :pserver:[EMAIL PROTECTED]:/home/cvspublic login +password: anoncvs +</b> +<br/> +<b> +cvs -d :pserver:[EMAIL PROTECTED]:/home/cvspublic checkout jakarta-jetspeed +</b> +<br/> +<br/> +To check for a particular date, use the -D option: +<br/><br/> +<b> +cvs -d :pserver:[EMAIL PROTECTED]:/home/cvspublic checkout -D 2002-06-04 jakarta-jetspeed +</b> +</p> +</section> + +<section name="Installation"> +<p> This installation procedure covers installing Jetspeed as a J2EE Web Application. Installing a Web application is simple. With Web apps, the entire application can be contained in a single archive file and deployed by placing the file into a specific directory. </p> <p> @@ -40,13 +128,12 @@ </p> <ul> <li> -1. Checkout the complete Jetspeed source from our CVS server. -Follow the Jakarta CVS instructions available <a href="http://jakarta.apache.org/site/cvsindex.html">here</a> -and checkout the jakarta-jetspeed module -</li> +1. <b>Download or Checkout Jetspeed</b> as described in one of the three sections above. + </li> + <br/><br/> <li> -2. Build Jetspeed - +2. <b>Build Jetspeed</b> +- Skip this step if you downloaded a WAR release version of Jetspeed. <ul> <li>cd <jetspeedRoot>/build</li> <li>[Win32/DOS] .\build war</li> @@ -54,38 +141,40 @@ <li>[unix] ./build.sh war</li> </ul> </li> + <br/> <li> -3. Get a Servlet 2.2 runner (container). We use Tomcat in this installation. - <ul> +3. <b>Download Tomcat</b> or another standard 2.2 or 2.3 compatible Servlet Container. +We use Jakarta Tomcat in the examples here. + <ul> <li> <a href="http://jakarta.apache.org/tomcat/">Tomcat Homepage</a> </li> - </ul> + </ul> </li> + <br/> <li> - -4. Unzip the Tomcat distribution -<p/> +4. <b>Install the Tomcat distribution</b> - Follow the instructions at the Tomcat site. </li> + <br/><br/> <li> -5. Copy the Jetspeed WAR file to the Tomcat webapps directory +5. <b>Copy the Jetspeed WAR file to the Tomcat webapps directory</b> <ul> <li>[Win32] copy <jetspeedRoot>\bin\jetspeed.war <tomcat_home>\webapps\</li> <li>[Unix] cp <jetspeedRoot>/bin/jetspeed.war <tomcat_home>/webapps/</li> </ul> </li> + <br/> <li> -6. Start Tomcat - +6. <b>Start Tomcat</b> <ul> <li>[Win32] <tomcat_home>\bin\startup.bat</li> <li>[Unix] <tomcat_home>/bin/startup.sh</li> </ul> </li> + <br/> <li> -7. Connect to Jetspeed - +7. <b>Connect to Jetspeed</b> <ul> <li> <a href="http://localhost:8080/jetspeed/">http://localhost:8080/jetspeed/</a> @@ -99,6 +188,7 @@ </li> </ul> </li> + <br/> <li> 7a. When signing up a new user in Jetspeed, the registration process includes a step where an email is sent to the new user. In order for this process to work on Windows NT or 2000, you will need to have a local SMTP server running. The Apaches James Mail Enterprise Server is available from:
-- To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]> For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>