Setting up and running Jetspeed 2 on Tomcat 5.5.15, JBOSS 4.0.3 and WebSphere Application Server 5.1.1.3
This page contains details on installation and setup instructions for the Jetspeed 2 Enterprise Portal on different server with Derby and MySQL database.
Jetspeed Configuration on Tomcat 5.5.15, JBOSS 4.0.3 and WAS 5.1.1.3 with Derby Database
Note:- Already "Apache Jeetspeed 2.0" installed by "Jetspeed2.0-MultiDb-install.jar" and selected Derby as database which is default database.
A) Jetspeed Configuration on Tomcat 5.5.15 (Derby is Database)
- Copy 1 file "jetspeed.xml" from "\Apache Jetspeed 2\conf\Catalina\localhost" folder to "C:\apache-tomcat-5.5.15\conf\Catalina\localhost"
2. Copy 6 jar files from "\Apache Jetspeed 2\shared\lib" to "C:\apache-tomcat-5.5.15\shared\lib" folder
- jetspeed-api-2.0.jar, jetspeed-commons-2.0.jar, pluto-1.0.1.jar, portals-bridges-common-1.0.jar, portlet-api-1.0.jar, derby-10.1.1.0.jar
3. Placed 1 file "jetspeed.war" at C:\apache-tomcat-5.5.15\webapps
4. Placed this 1 file "jetspeed-layouts.war" at C:\apache-tomcat-5.5.15\webapps\jetspeed\WEB-INF\deploy
5. Start tomcat
6. Run "http://localhost:8080/jetspeed"
7. Deploy other portlet applications (*.war) files directly in "\jetspeed\WEB-INF\deploy\" folder
- demo.war, j2-admin.war, jpetstore.war, jsf-demo.war, perl.war, php.war, rss.war
Jetspeed Configuration on JBOSS 4.0.3 (Derby is Database)
- Copy 6 jar files from "\Apache Jetspeed 2\shared\lib" to "C:\Program Files\jboss-4.0.3SP1\server\default\lib" folder
- jetspeed-api-2.0.jar, jetspeed-commons-2.0.jar, pluto-1.0.1.jar, portals-bridges-common-1.0.jar, portlet-api-1.0.jar, derby-10.1.1.0.jar
2. Unzip the "jetspeed.war" into a directory C:\Program Files\jboss-4.0.3SP1\server\default\deploy\jetspeed.war
3. Copy the JBoss datasource definition jetspeed-ds.xml from the Jetspeed2 source's "jetspeed-2.0-src\etc\conf\jboss" directory to JBoss' "server/default/deploy".
Note: As you have already installed "Apache Jeetspeed 2.0" on your machine, then add/modify this code in jetspeed-ds.xml:
<jndi-name>JetspeedDS</jndi-name>
<connection-url>jdbc:derby:C:\Program Files\Apache Jeetspeed 2.0/webapps/jetspeed/WEB- INF/productiondb;create=true</connection-url>
<driver-class>org.apache.derby.jdbc.EmbeddedDriver</driver-class>
<user-name></user-name>
<password></password>
4. Move the following jars out of "jetspeed.war/WEB-INF/lib" into JBoss' server/default/lib directory (commons-logging-1.0.3.jar, log4j-1.2.8.jar, xerces-2.3.0.jar, xml-apis-2.0.2.jar)
5. In jetspeed-spring.xml, (at "\jetspeed.war\WEB-INF\assembly") locate the bean with the id="org.apache.jetspeed.tools.pamanager.servletcontainer.ApplicationServerManager". Comment out the current bean definition, which is targeted at Tomcat 4/5, and uncomment the bean definition below that one, which is targeted at JBoss.
Note: jetspeed-spring.xml may not contain the JBoss ApplicationServerManager definition, so here it is (copy/paste into the jetspeed-spring.xml):
<bean id="org.apache.jetspeed.tools.pamanager.servletcontainer.ApplicationServerManager" class="org.apache.jetspeed.tools.pamanager.servletcontainer.JBossManager" init-method="start" />
6. Deploy jetspeed-layouts.war and other war files.
7. You can now start JBoss.
8. Run "http://localhost:8080/jetspeed"
9. Deploy other portlet applications (*.war) files directly in "\jetspeed.war\WEB-INF\deploy\" folder
- demo.war, j2-admin.war, jpetstore.war, jsf-demo.war, perl.war, php.war, rss.war
C) Jetspeed Configuration on WebSphere Application Server 5.1.1.3 (Derby is Database)
WebSphere Application Server doesnot support Derby database.
Jetspeed Configuration on Tomcat 5.5.15, JBOSS 4.0.3 and WAS 5.1.1.3 with MySQL Database
Note:- Already "MySQL 5.0" is installed on your machine and create a database (create database jetspeed Download "mysql-connector-java-3.1.12-bin.jar" file from "http://dev.mysql.com/downloads/connector/j/3.1.html"
A) Install Apache Jetspeed 2.0 with MySQL 5.0 as Database
- Double click on "Jetspeed2.0-MultiDb-install.jar"
2. Select next with all default option, except database generation part.
3. Fill these data:
Database type: MySQL
user name: root
password: root (As I have given like thiswhen I installed MySQl. You can change it.)
connection string : jdbc:mysql://localhost/jetspeed
Driver class: com.mysql.jdbc.Driver
JDBC driver: mysql-connector-java-3.1.12-bin.jar (select this jar file, which you have already downloaded)
4. Start Apache Jetspeed 2.0
5. Run "http://localhost:8080/jetspeed"
Problem:- if you are getting any database problem during installation of Jetspeed, drop the database and create once again. (drop database jetspeed
Jetspeed Configuration on Tomcat 5.5.15 (MySQL 5.0 is Database)
- Copy 1 file "jetspeed.xml" from "\Apache Jetspeed 2\conf\Catalina\localhost" folder to "C:\apache-tomcat-5.5.15\conf\Catalina\localhost"
2. Copy 6 jar files from "\Apache Jetspeed 2\shared\lib" to "C:\apache-tomcat-5.5.15\shared\lib" folder
- jetspeed-api-2.0.jar, jetspeed-commons-2.0.jar, pluto-1.0.1.jar, portals-bridges-common-1.0.jar, portlet-api-1.0.jar, mysql-connector-java-3.1.12-bin.jar
3. Placed 1 file "jetspeed.war" at C:\apache-tomcat-5.5.15\webapps
4. Start tomcat
5. Placed this 1 file "jetspeed-layouts.war" at C:\apache-tomcat-5.5.15\webapps\jetspeed\WEB-INF\deploy
6. Restart tomcat
7. Run "http://localhost:8080/jetspeed"
8. Deploy other portlet applications (*.war) files directly in "\jetspeed\WEB-INF\deploy\" folder
- demo.war, j2-admin.war, jpetstore.war, jsf-demo.war, perl.war, php.war, rss.war
C) Jetspeed Configuration on JBOSS 4.0.3 (MySQL 5.0 is Database)
- Copy 6 jar files from "\Apache Jetspeed 2\shared\lib" dir to C:\Program Files\jboss-4.0.3SP1\server\default\lib
(jetspeed-api-2.0.jar, jetspeed-commons-2.0.jar, pluto-1.0.1.jar, portals-bridges-common-1.0.jar, portlet-api-1.0.jar, mysql-connector-java-3.1.12-bin.jar)
2. Unzip the "jetspeed.war" into a directory C:\Program Files\jboss-4.0.3SP1\server\default\deploy\jetspeed.war
3. Copy the JBoss datasource definition "jetspeed-mysql-ds.xml" from the Jetspeed2 source's "jetspeed-2.0-src\etc\conf\jboss" directory to JBoss' "server/default/deploy". Note:-follow the correct username and password.
4. Move the following jars out of "jetspeed.war/WEB-INF/lib" into JBoss' server/default/lib directory (commons-logging-1.0.3.jar, log4j-1.2.8.jar, xerces-2.3.0.jar, xml-apis-2.0.2.jar)
5. In jetspeed-spring.xml, (at "\jetspeed.war\WEB-INF\assembly") locate the bean with the id="org.apache.jetspeed.tools.pamanager.servletcontainer.ApplicationServerManager". Comment out the current bean definition, which is targeted at Tomcat 4/5, and uncomment the bean definition below that one, which is targeted at JBoss.
Note: jetspeed-spring.xml may not contain the JBoss ApplicationServerManager definition, so here it is (copy/paste into the jetspeed-spring.xml):
<bean id="org.apache.jetspeed.tools.pamanager.servletcontainer.ApplicationServerManager" class="org.apache.jetspeed.tools.pamanager.servletcontainer.JBossManager" init-method="start" />
6. Deploy jetspeed-layouts.war and other war files.
7. You can now start JBoss.
8. Run "http://localhost:8080/jetspeed"
D) Jetspeed Configuration on WebSphere Application Server 5.1.1.3 (MySQL 5.0 is Database)
- Copy 6 jar files to "Websphere/Appserver/lib" folder
( jetspeed-api-2.0.jar, jetspeed-commons-2.0.jar, pluto-1.0.1.jar, portals-bridges-common-1.0.jar, portlet-api-1.0.jar, mysql-connector-java-3.1.12-bin.jar)
2. Start Websphere Application Server Websphere\AppServer\bin> startServer server1 http://localhost:9090/admin
3. Create a DataSource by JDBC Provider. (This is most critical step.)
3.1. Create JDBC Provider with these data:
Name: MySQL
Description:
Classpath: Websphere/AppServer/lib/mysql-connector-java-3.1.12-bin.jar
Implemenation Classname: com.mysql.jdbc.jdbc2.optional.MysqlConnectionPoolDataSource
3.2. Create Data Source with these data:
Name: JetspeedDS
JNDI: JetspeedDS
Datasource Helper Class: com.ibm.websphere.rsadapter.ConnectJDBCDataStoreHelper
Container-managed Auth: localhost/mysqlAuth (I created like this)
(J2C Authentication with user=root;password=root)
3.3. Add Some Custom Properties: (data type is STRING for all)
databaseName: jetspeed?autoReconnect=true
serverName: localhost
user: root
password: root
4. Install jetspeed.war file using the Websphere's application installation wizard
5. Place "jetspeed-layouts.war" in "\jetspeed.ear\jetspeed.war\WEB-INF\deploy" and start jetspeed.
6. Go to http://localhost:9080/jetspeed
7. Install Portlet Applications using the Websphere application installation wizard.
Problem:- j2-admin.war and jsf-demo.war, these two are not working. Still I am working on these two. Error in SystemOut.log file is:
"Failure to initialize Web application Jetspeed-2 Portal Administration Portlets. An error occurred while loading Web application."
IF You have any suggestions or queries please contact me. I will appreciate to work with you.
Kabi Prasad Samal
kabi_prasad@yahoo.co.in