He wrote a proper description for J2's wiki.
It all came down to portlet deployment. The portlets can only be deployed after JBoss is started.
According to his description the portlets even need to be undeployed before stopping JBoss, and re-deployed after starting.
Obviously I tried to stop and start JBoss without undeploying the portlets and J2 still worked fine.
In short these are the steps I followed to deploy J2 M1 on JBoss 4.0.1, assuming that a database on MaxDB is already configured:
- Copy the default server configuration and name it e.g. jetspeed.
- Create a new subdirectory in the directory /jboss-4.0.1/server/jetspeed/lib named j2lib
- Copy the sapdb driver jar into that directory
- Copy the maxdb datasource descriptor file into the /jboss-4.0.1/server/jetspeed/deploy directory
- Open the file /jboss-4.0.1/server/jetspeed/conf/jboss-service.xml
- Locate the line that reads
<classpath codebase="lib" archives="*">
- Add a similar line below it that reads
<classpath codebase="lib/j2lib" archives="*">
- Copy the jars pluto-1.0.1-rc1.jar, portals-bridges-common-0.1.jar, jetspeed-commons-2.0-M1.jar, jetspeed-api-2.0-M1.jar and portlet-api-1.0.jar into the directory /jboss-4.0.1/server/jetspeed/lib/j2lib
- Create the directory /jboss-4.0.1/server/jetspeed/deploy/jetspeed.war
- Extract the contents of the file jetspeed.war into that directory
- Move the jars commons-logging-1.0.3.jar, log4j-1.2.8.jar, xerces-2.3.0.jar and xml-apis-2.0.2.jar from the directory /jboss-4.0.1/server/jetspeed/deploy/jetspeed.war/WEB-INF/lib into /jboss-4.0.1/server/jetspeed/lib/j2lib
- Open the file /jboss-4.0.1/server/jetspeed/deploy/jetspeed.war/WEB-INF/assembly/jetspeed-spring.xml
- Locate the bean definition with id 'org.apache.jetspeed.tools.pamanager.servletcontainer.ApplicationServerManager' and comment out the Tomcat version and uncomment the JBoss version.
- Start JBoss
- Copy all desired portlet war files into the directory /jboss-4.0.1/server/jetspeed/deploy/jetspeed.war/WEB-INF/deploy
You need at least the file jetspeed-layouts.war.