Liferay DXP service packs and updates are built from source code and bundled with the following updates included:
- An updated patching tool (if the tool has been updated since the original release)
- Updated plugins (if new versions have come out since the original release)
- An updated version of Tomcat (most, but not all service packs)
- The latest fix pack or update level
Here’s how to update your installation from one service pack or update level (source) to another (destination). If possible, update to the latest available service pack or update.
Resolution
Always back up your database and installation before updating.
-
- Download the service pack or update archived bundle from Help Center Downloads.
- Extract the new bundle to your location of choice.
- Copy your database vendor's JDBC driver JAR to the appropriate lib folder:
- For Liferay DXP 7.3 and below the JDBC drivers, by default, are in
$CATALINA_HOME/lib/ext
. - For Liferay DXP 7.4 and above the JDBC drivers, by default, are in
$CATALINA_BASE/webapps/ROOT/WEB-INF/shielded-container-lib
.
- For Liferay DXP 7.3 and below the JDBC drivers, by default, are in
- Copy your portal-ext.properties file to the
$LIFERAY_HOME
folder. - Copy any osgi config files to the
$LIFERAY_HOME/osgi/configs
folder. - Copy a license xml file to the
$LIFERAY_HOME/deploy
folder. - Copy
data/document_library
folder from your previous bundle - Ensure that any application server configurations made in your previous bundle are also made in the new service pack or update bundle.
- Ensure that any additional customizations made or deployed in your previous bundle are also made or deployed in the new service pack or update bundle.
- Clean up the cache folders within DXP's
{$LIFERAY_HOME}
:- Delete the
$LIFERAY_HOME/osgi/state
folder. - Empty the
$LIFERAY_HOME/Work
folder. - Empty the
$LIFERAY_HOME/tomcat-version/temp
folder. - Empty the
$LIFERAY_HOME/tomcat-version/work
folder.
- Delete the
- Consult the DXP Release Notes portlet to determine if there are any upgrade processes in the destination service pack or update.
- Consult the DXP Release Notes portlet for any Important Changes relevant to your installation.
- Consult the Upgrade Processes for Fix Packs in DXP 7.3 and Above article to decide your process for updating from the source service pack or update to the destination service pack or update.
- Shut down the previous DXP instance.
- Start the new DXP instance or run Database Upgrade Tool.
Additional Information
- For instructions concerning Tomcat deployments or manual deployment please see: Updating Liferay
- For instructions concerning other environments, please see: Installing Liferay on an Application Server
- Installing Fix Packs and Hotfixes on Liferay DXP
Subscriber Exclusive Content
A Liferay Enterprise Subscription provides access to over 1,500 articles that include best practices, troubleshooting, and other valuable solutions. Sign in for full access.
Sign In