Dear all,
just some docs I'll be putting up on my site which I quickly drafted since I
bet I'm not the only one finding it hard going and I've had enough head
banging for a day. I will put more meat later.
Any comments or additions pls, let me know.
Lionel
Jetspeed 1.3a2 Development 101 :
These steps are all the compulsory ones. You cannot avoid doing them. If u
do not understand what I'm talking about, you are far too newbie to be doing
such development. Go see Paul's Getting Started Guide.
Install Your JDK
1) Download your reference JDK from http://www.javasoft.com. I have
tested it with JDK 1.3_03 for Windows which works fine.
2) Make sure you set your JAVA_HOME environment variable to point to the
installation directory.
Install Your Web Container
1) Download the reference Web Container from http://jakarta.apache.org.
I have tested it on Tomcat release binary 3.2.3.
2) Make sure you set the TOMCAT_HOME environment variable to point to
the installation directory.
Gotchas :
1) The current tomcat release binaries come with parser.jar and
jaxp.jar. Please note that these NEED to be replaced with the Xalan and
Xerces equivalents which can be found in <jetspeed>/lib. This is different
for Tomcat 4.0 which I haven't tried.
Install Jetspeed
1) Download the latest CVS from http://jakarta.apache.org. Plentiful
instructions over there.
2) Once installed, you need to do a build with Ant. Go to
<jetspeed>/build and type build war. The jetspeed war is created in
<jetspeed>/bin
3) Move the <jetspeed> to <tomcat>/webapp
Gotcha :
1) The build target u only really need is the WAR. The release and
release_binary is for distribution purposes.
2) Also, unlike 1.3a1, the class files are now not packaged in the
<tomcat>/webapp/jetspeed/WEB-INF/lib any more. This makes development so
much easier.
Start Tomcat
1) Go to <tomcat>/bin and type startup and a console window should
launch and show tomcat deploying the jetspeed war.
Jetspeed Test
1) Surf over to http://localhost:8080/jetspeed and the page should be
loaded automatically.
Jetspeed Development
1) Go See Fran's documentation on how to create a New Portlet and
reconfigure the layout.
2) Put your source files any where u want them but deploy them to
<tomcat>/webapp/jetspeed/WEB-INF/classes bearing in mind the package
structure.
Gotcha :
1) In your FirstPortlet, there isn't a package name, so you should
leave it in <tomcat>/webapp/jetspeed/WEB-INF/classes.
Production Deployment
1) Jar your <tomcat>/webapp/jetspeed directory into jetspeed.war.
2) Copy jetspeed.war into your production machine's tomcat.
Gotchas :
1) Please note if you are using the wrapper for the NT Service in Tomcat,
it has only a static classpath unlike the normal tomcat start up! So, in the
deployment, in addition to the compulsory stuff in the docs, you need to
make sure you manually set the Xalan and Xerces inside the file. Similarly,
if there are any other special libs that tomcat needs, it has to be set
also.
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
