Installing a Bundled Update or Patch Release

Liferay DXP Bundled Update and Patch Releases are built from source code and include the following:

1. An updated patching tool (if the tool has been updated since the original release)
2. Updated plugins (if new versions have come out since the original release)
3. An updated version of Tomcat
4. The latest update or patch level

Here’s how to update your installation from one quarterly release, patch release, or update level (source) to another (destination). If possible, update to the latest available release.

Resolution

Always back up your database and installation before updating.

1. 1. Download the archive file for the destination bundle from Help Center Downloads.
   2. Extract the new bundle to your location of choice.
   3. Copy your database vendor's JDBC driver JAR to the appropriate lib folder:
      1. For Liferay DXP 7.3 and below the JDBC drivers, by default, are in $CATALINA_HOME/lib/ext.
      2. For Liferay DXP 7.4 and above the JDBC drivers, by default, are in $CATALINA_BASE/webapps/ROOT/WEB-INF/shielded-container-lib.
   4. Copy your portal-ext.properties file to the $LIFERAY_HOME folder.
   5. Copy any osgi config files to the $LIFERAY_HOME/osgi/configs folder.
   6. Copy a license xml file to the $LIFERAY_HOME/deploy folder.
   7. Copy data/document_library folder from your previous bundle
   8. Ensure that any application server configurations made in your previous bundle are also made in the new bundle.
   9. Ensure that any additional customizations made or deployed in your previous bundle are also made or deployed in the bundle.
   10. Clean up the cache folders within DXP's {$LIFERAY_HOME}:
       1. Delete the $LIFERAY_HOME/osgi/state folder.
       2. Empty the $LIFERAY_HOME/Work folder.
       3. Empty the $LIFERAY_HOME/tomcat-version/temp folder.
       4. Empty the $LIFERAY_HOME/tomcat-version/work folder.
   11. Consult the DXP Release Notes portlet to determine if there are any upgrade processes in the destination release.
   12. Consult the DXP Release Notes portlet for any important or breaking changes relevant to your installation.
   13. Consult the Upgrade Processes for Fix Packs in DXP 7.3 and Above article to decide your process for updating from the source release to the destination release.
   14. Shut down the previous DXP instance.
   15. 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