Howto: 如何使用war包在tomcat中安装liferay

有时我们无法使用预集成的liferay(比如在已有的tomcat上再部署)。这时候就可以使用war包进行部署安装。

我们将使用apache-tomcat-5.5.17，liferay-portal-4.1.3.war进行试验。为了化简复杂度，我们将会把war部署在根context下，也就是 /

在部署之前首先需要创建liferay所需数据库(http://liferay.iteye.com/group/topic/338)。并且寻找到数据库jdbc驱动和portlet.jar文件。
jdbc可以从所使用数据库厂商网站下载
portlet.jar文件可以从
http://www.jcp.org/en/jsr/detail?id=168下载。你也可以在预集成的liferay tomcat bundle中找到

数据库创建后，我们可以使用war包进行部署了。

在部署过程中我们将会重起tomcat，所以请确保不会影响生产。

1，将下载liferay-portal-4.1.3.war 放到tomcat目录下，启动tomcat对war解压，解压完成后停止tomcat
2，将解压后的目录liferay-portal-4.1.3改名为ROOT，删除原始的 liferay-portal-4.1.3.war 文件
3，修改 ${tomca_home}\conf\catalina.properties 在common.loade上新增${catalina.home}/common/lib/ext/*.jar，并且在$ {catalina.home}/common/lib下创建ext目录
4，将liferay解压后WEB-INF/lib中的activation.jar、jms.jar、jta.jar、mail.jar、portal-kernel.jar移动到${catalina.home}/common/lib/ext下。
将jdbc驱动和portlet.jar拷贝到${catalina.home}/common/lib/ext下。
在
5，在${tomca_home}\conf下新建文件jaas.config，其中内容为
PortalRealm {
com.liferay.portal.kernel.security.jaas.PortalLoginModule required;
};
该文件也可以在预集成的liferay tomcat bundle中找到
6，在${tomca_home}\conf\Catalina\localhost下新建文件ROOT.xml其中内容类似
<context path=""></context>

xml 代码

 

1. <Context path="">  
2.     <Resource  
3.         name="jdbc/LiferayPool"  
4.         auth="Container"  
5.         type="javax.sql.DataSource"  
6.         driverClassName="org.hsqldb.jdbcDriver"  
7.         url="jdbc:hsqldb:test"  
8.         username="sa"  
9.         password=""  
10.         maxActive="20"  
11.     />  
12.     <Resource  
13.         name="mail/MailSession"  
14.         auth="Container"  
15.         type="javax.mail.Session"  
16.         mail.transport.protocol="smtp"  
17.         mail.smtp.host="localhost"  
18.     />  
19.     <Realm    
20.         className="org.apache.catalina.realm.JAASRealm"  
21.         appName="PortalRealm"  
22.         userClassNames="com.liferay.portal.security.jaas.PortalPrincipal"  
23.         roleClassNames="com.liferay.portal.security.jaas.PortalRole"  
24.         debug="99"  
25.         useContextClassLoader="false"  
26.     />  
27. Context>  

请修改jdbc/LiferayPool和mail/MailSession中配置。
该文件也可以在预集成的liferay tomcat bundle中找到。
7，修改${tomca_home}/bin/catalina.bat，在
rem ----- Execute The Requested Command -----------------------------------
下方添加
set JAVA_OPTS=-Xms128m -Xmx512m -Dfile.encoding=UTF8 -Duser.timezone=GMT -Djava.security.auth.login.config=%CATALINA_HOME%/conf/jaas.config
该步骤将影响全局jvm系统参数，请修改后测试该tomcat上其他应用是否出现问题，可能会出现的问题有中文乱码以及时间错乱问题。

重新启动tomcat liferay应该能够正确运行了