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 代码

<Context path="">
    <Resource
        name="jdbc/LiferayPool"
        auth="Container"
        type="javax.sql.DataSource"
        driverClassName="org.hsqldb.jdbcDriver"
        url="jdbc:hsqldb:test"
        username="sa"
        password=""
        maxActive="20"
    />
    <Resource
        name="mail/MailSession"
        auth="Container"
        type="javax.mail.Session"
        mail.transport.protocol="smtp"
        mail.smtp.host="localhost"
    />
    <Realm
        className="org.apache.catalina.realm.JAASRealm"
        appName="PortalRealm"
        userClassNames="com.liferay.portal.security.jaas.PortalPrincipal"
        roleClassNames="com.liferay.portal.security.jaas.PortalRole"
        debug="99"
        useContextClassLoader="false"
    />
<!---->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应该能够正确运行了