Applying Patches to Liferay Portal for Versions 6.0 EE SP1 and earlier

This article is a legacy article. It applies to previous versions of the Liferay product. While the article is no longer maintained, the information may still be applicable.

This article describes how to deploy patches to Liferay in a variety of environments. The steps are seperated by application servers and based on the patching process that was used prior to 6.0SP2 where we introduced the patching-tool, hot-fixes and fixpacks.

Resolution

1. For patches that are .war, these are copied to the deploy folder.
2. For portal-service jars, these are copied to the global library.
3. For portal-impl jars, these are copied to the application library.
4. For portal-util jars, these are copied to the application library.
5. Please reference these examples:

GlassFish Server Open Source Edition 3.x

Installation tip: I found that deploying Liferay via command line worked better than through the GUI. The easiest way to do this is to navigate to C:\$GLASSFISH_HOME\glassfish\bin, place your Liferay.war file, then type: asadmin deploy Liferay.war. Input your Windows password and it should deploy!

• Stop Glassfish
• Place your portal-service/kernel.jar patch in this directory, C:\$GLASSFISH_HOME\glassfish\domains\domain1\lib
• Place your portal-impl.jar patch in this directory, C:\$GLASSFISH_HOME\glassfish\domains\domain1\applications\$Liferay.war_folder\WEB-INF\lib
• Place your portal-util.jar patch in this directory, C:\$GLASSFISH_HOME\glassfish\domains\domain1\applications\$Liferay.war_folder\WEB-INF\lib
• Start Glassfish
• Test to see if the patch works.

IBM Websphere

• Stop Websphere
• Place your portal-service/kernel.jar patch in this directory, $WEBSPHERE_HOME\AppServer\lib\ext
• Place your portal-impl.jar patch in this directory, $WEBSPHERE_HOME\AppServer\profiles\AppSrv01\installedApps\$DOMAIN_NAME\liferay-portal.ear\$LIFERAY_WAR\WEB-INF\lib
• Place your portal-util.jar patch in this directory, $WEBSPHERE_HOME\AppServer\profiles\AppSrv01\installedApps\$DOMAIN_NAME\liferay-portal.ear\$LIFERAY_WAR\WEB-INF\lib
• Start Websphere
• Test to see if the patch was applied.

JBoss 5.1.x

• Stop JBoss
• Place the portal-service/kernel.jar patch in this directory, C:\$JBOSS_HOME\server\default\lib\ext
• Place your portal-impl.jar patch in this directory, C:\$JBOSS_HOME\server\default\deploy\$Liferay.war_folder (ROOT.war)\WEB-INF\lib
• Place your portal-util.jar patch in this directory, C:\$JBOSS_HOME\server\default\deploy\$Liferay.war_folder (ROOT.war)\WEB-INF\lib
• Start JBoss
• Test to see if the patch works.

Tomcat 6.0.x

• Stop Tomcat
• Place your portal-service/kernel.jar patch in this directory, C:\$TOMCAT_HOME\lib\ext
• Place your portal-impl.jar patch in this directory, C:\$TOMCAT_HOME\webapps\ROOT\WEB-INF\lib
• Place your portal-util.jar patch in this directory, C:\$TOMCAT_HOME\webapps\ROOT\WEB-INF\lib
• Start Tomcat
• Test to see if the patch works.

Oracle Weblogic

• Stop Weblogic
• Place your portal-service/kernel.jar C:\Oracle\Middleware\user_projects\domains\lportal\lib
• Place your portal-impl.jar patch in the Liferay WAR, located here: C:\$WEBLOGIC_HOME\user_projects\domains\liferay\servers\$SERVER_NAME\stage\$LIFERAY_WAR
• Place your portal-util.jar patch in the Liferay WAR, located here: C:\$WEBLOGIC_HOME\user_projects\domains\liferay\servers\$SERVER_NAME\stage\$LIFERAY_WAR
• Start Weblogic
• Test to see if the patch works.