前言 JCMS是Jetspeed Content Management System的缩写，目前的版本是基于Jetspeed2.0的α1版本，功能还非常有限。本文介绍了如何在Jetspeed2.0的final release版本下安装和部署JCMS，并将JCMS提供的几个Portlet定制到页面上。 安装和配置Jetspeed2.0和JCMS需要的时间比较长，因为需要从网上找安装程序、下载安装、配置环境，还要懂Maven,不过如果大家有耐心，还是可以成功的，我花了一整天的时间才弄好。 安装JCMS前需要安装jetspeed2.0,请使用官方发布的2.0release版本，不要从jetspeed2.0的最新原码库下载，否则JCMS不能正常部署使用。 安装步骤 先安装JDK 我认为1.42 以上版本就可以了。。。 1） JetSpeed2.0安装程序： 从http://portals.apache.org/jetspeed-2/ 地址下载Jetspeed2.0-derby-install.jar 然后你进DOS 下 找到你放Jetspeed2.0-derby-install.jar 的路径 运行java –jar Jetspeed2.0-derby-install.jar 例如我把Jetspeed2.0-derby-install.jar 放到了I:\jakarta-tomcat-5.0.28 我在DOS下I:\jakarta-tomcat-5.0.28>java –jar Jetspeed2.0-derby-install.jar 这时候你就可以进行安装了 先一顿下一步 完了出现一个 让你选择的安装路径 你最好是用默认的要不会包错误，至于为啥，我也不知道！ 这样就安装好了。。。 这样你就可以启动TOMCAT了（我安装到了C:\Apache Jetspeed 2.0\bin） 。http://localhost:8080/jetspeed 在出现的页面中有一个登录用户和密码的Portlet窗口，输入用户名和口令都是admin,admin,登录成功以后修改密码保存。关掉tomcat开始进行以下步骤。 2） 安装maven: 我使用的maven是maven-1.1-beta-2.exe，下载地址忘记了。建议不要使用maven的最新版本，否则可能有问题，而且与本文的安装方式可能不一致。安装好maven后需要配置环境变量，增加系统环境变量：MAVEN_HOME ，值为你安装Maven的根路径，这个根路径下有bin子目录。系统变量还要修改path,在系统的path环境变量增加%MAVEN_HOME%\bin; 3）下载JCMS源代码 JCMS源代码下载地址是：https://svn.apache.org/repos/asf/incubator/graffito/ ，下载前需要安装Subversion,我使用的是svn-1.2.3-setup.exe（好不容易从网上找到的windows安装版），找到Subversion的bin目录，自己写一个.bat文件或在命令行模式下输入：svn checkout https://svn.apache.org/repos/asf/incubator/graffito/ c:\cmsjetspeed 其中c:\cmsjetspeed 是下载源码的目标地址，大家可以任意指定。 修改C:\cmsjetspeed\trunk\jetspeed2-deploy\src\assembly\graffito.xml（这个文件在JCMS部署后会自动复制到C:\tomcat\webapps\jetspeed\WEB-INF\assembly目录下），找到 JetspeedDS，将JetspeedDS改为JetspeedCMS,因为我要配置JCMS使用Mysql数据库，而不是使用Jetspeed2内嵌的Derby数据库。JetspeedCMS对应到C:\tomcat\webapps\jetspeed\WEB-INF\assembly\boot\datasource.xml里的配置，打开datasource.xml，找到： java:comp/env/jdbc/jetspeed 复制上段配置，粘贴到下面一行，并做修改，修改后的配置： java:comp/env/jdbc/mycms 这是JCMS要使用的数据源。 再到C:\tomcat\webapps\jetspeed\WEB-INF打开web.xml文件，在 DB Connection jdbc/jetspeed javax.sql.DataSource Container 下面增加： DB Connection jdbc/mycms javax.sql.DataSource Container 修改C:\tomcat\conf\context.xml，内容如下： WEB-INF/web.xml maxActive="100" maxIdle="30" maxWait="10000" username="root" password="mysql" driverClassName="org.gjt.mm.mysql.Driver" url="jdbc:mysql://localhost/graffitotest"/> 更改C:\tomcat\conf\tomcat-users.xml，为tomcat用户增加manager角色： 。 4） 在网上找到mysql-connector-java-3.1.12-bin.jar，放到tomcat的common\lib里。 5） 安装Mysql数据库，并更改root的登录口令为mysql,并创建一个graffitotest和j2数据库。 6)配置maven的编译环境： 如果你的机器是windows xp,并且windows xp装在c盘，则进入C:\Documents and Settings，选择你现在使用windows的用户名的这个目录，进入这个目录创建一个build.properties文件，内容如下： # --------------------------------------------------------------------------------- # GRAFFITO # --------------------------------------------------------------------------------- #Uncomment the following line if you want to run the unit tests #maven.test.skip=false # configure TEST DB org.apache.portals.graffito.test.database.default.name=mysql org.apache.portals.graffito.test.jetspeed=false org.apache.portals.graffito.test.database.url = jdbc:mysql://localhost/graffitotest?useServerPrepStmts=false org.apache.portals.graffito.test.database.driver = com.mysql.jdbc.Driver org.apache.portals.graffito.test.database.user = root org.apache.portals.graffito.test.database.password = mysql org.apache.portals.graffito.test.jdbc.drivers.path=C:/cmsjetspeed/mysql-connector-java-3.1.12-bin.jar # configure PRODUCTION DB org.apache.portals.graffito.production.database.default.name=mysql org.apache.portals.graffito.production.jetspeed=true #org.apache.portals.graffito.production.database.url = jdbc:mysql://localhost/j2?useServerPrepStmts=false org.apache.portals.graffito.production.database.url = jdbc:mysql://localhost/graffitotest?useServerPrepStmts=false org.apache.portals.graffito.production.database.driver = com.mysql.jdbc.Driver org.apache.portals.graffito.production.database.user = root org.apache.portals.graffito.production.database.password = mysql org.apache.portals.graffito.production.jdbc.drivers.path=C:/cmsjetspeed/mysql-connector-java-3.1.12-bin.jar #Configue the Graffito Master OJB Store - USED FOR THE UNIT TESTS org.apache.portals.graffito.database.ojb.platform=MySQL org.apache.portals.graffito.database.ojb.datasource=java:comp/env/jdbc/mycms # --------------------------------------------------------------------------------- # JETSPEED 2 # --------------------------------------------------------------------------------- org.apache.jetspeed.server.home=C:/tomcat org.apache.jetspeed.server.shared=${org.apache.jetspeed.server.home}/shared/lib/ org.apache.jetspeed.deploy.war.dir=${org.apache.jetspeed.server.home}/webapps/ org.apache.jetspeed.services.autodeployment.user=tomcat org.apache.jetspeed.services.autodeployment.password=tomcat org.apache.jetspeed.catalina.version.major=5.5 #下面这个目录有自己指定路径，指定的目录要求已经存在 org.apache.jetspeed.project.home = c:/cmsjetspeed/myproject org.apache.jetspeed.portal.home = ${org.apache.jetspeed.project.home} # configure MySQL TEST DB #org.apache.jetspeed.test.database.default.name=mysql #org.apache.jetspeed.test.database.url = jdbc:mysql://localhost/j2test?useServerPrepStmts=false #org.apache.jetspeed.test.database.driver = com.mysql.jdbc.Driver #org.apache.jetspeed.test.database.user = root #org.apache.jetspeed.test.database.password = mysql #org.apache.jetspeed.test.jdbc.drivers.path= C:/cmsjetspeed/mysql-connector-java-3.1.12-bin.jar # configure MySQL Production DB org.apache.jetspeed.production.database.default.name=mysql org.apache.jetspeed.production.database.url = jdbc:mysql://localhost/j2?useServerPrepStmts=false org.apache.jetspeed.production.database.driver = com.mysql.jdbc.Driver org.apache.jetspeed.production.database.user = root org.apache.jetspeed.production.database.password = mysql org.apache.jetspeed.production.jdbc.drivers.path= C:/cmsjetspeed/mysql-connector-java-3.1.12-bin.jar 上面的配置也可能不是很科学，不过我这样配置是成功部署了JCMS,注意目录间隔用/而不是\,另外mysql-connector-java-3.1.12-bin.jar的路径指定为你机器上此文件的路径. 下面开始用maven编译： 第一步： maven allClean allBuild 希望你能看到BUILD SUCCESS的字样，这一步执行成功后接着执行： maven allDeploy 这一步如果成功的话，JCMS生成的war文件应该已放到了C:\tomcat\webapps\jetspeed\WEB-INF\deploy下面，在启动tomcat后会把deploy目录下的war转移到webapps目录下，启动时注意看一下控制台是否有错误抛出。 如果启动正常，请在地址栏输入:http://localhost:8080/jetspeed,页面应该出现jetspeed的主页而不是空白页或错误信息输出，登录后在页面左侧找到”第二个PSML页面”，点击，在页面右上角找一个笔状的编辑图标，在新出来的页面右上角有一个+号的图标，点击，会出现一个Portlet选择器窗口，有三个是与JCMS相关的，这三个Portlet分别是Graffito Tree,Graffito Document Viewer,Graffito Tree,选择复选框将三个Portlet加入到当前页面中。 关于JCMS的如何应用将另文叙述。