Requirements
- JDK 1.5.0 (Required by Tomcat 5.5)
- Maven 1.0.2
- Tomcat 5.5.15
- Subversion 1.2.1
- Jetspeed 2 Source code
Note that other versions of Java, Subversion, and Tomcat may work. These are the versions used to create this guide on Suse 9.2. Maven 2 will not work, but you may want to look at the BuildUsingMaven2 article.
Environment Settings
Set the following environment variables (JRE_HOME is needed by Tomcat 5.5).
Linux
export JAVA_HOME=/usr/local/jdk/ export JRE_HOME=/usr/local/jdk/jre/ export MAVEN_HOME=/home/opensource/apache-maven-1.0.2/ export CATALINA_HOME=/home/opensource/apache-tomcat-5.5.12/
Windows
set JAVA_HOME=/usr/local/jdk/ set JRE_HOME=/usr/local/jdk/jre/ set MAVEN_HOME=/home/opensource/apache-maven-1.0.2/ set CATALINA_HOME=/home/opensource/apache-tomcat-5.5.12/
Modify Tomcat's tomcat-users.xml to contain the following lines
<role rolename="manager" /> <user username="j2deployer" password="j2deployer" roles="manager" />
Checkout Jetspeed source
svn co http://svn.apache.org/repos/asf/portals/jetspeed-2/trunk portals-jetspeed-2
Create build.properties
Create a build.properties text file in the root of the source code directory (portals-jetspeed-2).
org.apache.jetspeed.server.home=/home/opensource/bin/apache-tomcat-5.5.15 org.apache.jetspeed.server.shared=/home/opensource/bin/apache-tomcat-5.5.15/shared/lib org.apache.jetspeed.deploy.war.dir=/home/opensource/bin/apache-tomcat-5.5.15/webapps org.apache.jetspeed.services.autodeployment.user=j2deployer org.apache.jetspeed.services.autodeployment.password=j2deployer org.apache.jetspeed.catalina.version.major=5.5 org.apache.jetspeed.project.home=/home/opensource/svnProjects/portals-jetspeed-2 org.apache.jetspeed.portal.home=/home/opensource/svnProjects/portals-jetspeed-2
Building Jetspeed
Build the Maven plugin
maven initMavenPlugin
Clean all, build all, and create documentation (allSite is optional)
maven allClean allBuild allSite
Deploying Jetspeed
Set up and deploy Jetspeed and the demo portlets
maven j2:quickStart
Running Jetspeed
Start Tomcat.
$CATALINA_HOME/bin/catalina run
View Jetspeed.
http://localhost:8080/jetspeed
What Next
What can I do next? Try creating a very simple portlet or try to modify the source code or create your own simple servlet portlet.
I'm thinking about Jetspeed documentation. What can be done about it. Here are some things that can be done by Users, Developers, Administrators, and Managers.
Users
Users can customize the layout, customize the layout decorator, customize the portlet decorator, customize templates, create pages, create folders, create separators, create links, arrange portlet on pages, add portlets to pages, remove portlets from pages.
Developers
Developers can create a very simple portlet, write portlets, configure portlets, write layouts, write styles, write modes as well as anything a user can do.
Administrators
Administrators can install Jetspeed, optimize Jetspeed, cluster Jetspeed, create users, create groups, create roles, manage applications, deploy applications. As well as anything a user or developer can do. They are extremely lazy people who often say "That's the developers job".
Managers
Managers can approve the use of Jetspeed.