Issue
-
We are preparing the upgrade from a Liferay 7.3 FP2 to a Liferay 7.4 2024.Q1 and we are trying to prepare a rollback system if something goes wrong and we need go reinstall the 7.3.
My question is about the document library. Does the upgrade touch the doclib files during the upgrade?
It's important for us because If not, we will not have to backup/snashot this enormous file system before the upgrade and we need to process a rollback to 7.3, we can restart a 7.3 to the same doclib without any issue.
Environment
- Upgrade
Resolution
-
Of course, my first recommendation would be to have a backup of your full document library in such a situation, no matter what. It's the safest way always, to have backups of everything. However, we do understand why customers might want to skip this, since their doc libraries might be huge.
Having said that, and to reply to the actual question:
The upgrade (e.g. from Liferay DXP 7.3 FP2 to 2024.Q1.12) will not modify the files stored within the document library. The upgrade process primarily focuses on database schema updates and changes to the application code. The physical files in the document library's storage location remain untouched. Therefore, in a rollback scenario, reverting to the 7.3 instance will work seamlessly with the existing document library files, as long as the file storage location remains the same. (However, it's essential to back up the database before the upgrade to ensure a smooth rollback process if needed. This backup preserves all document library metadata and configurations.)
While the files themselves are not altered, it's important to be aware of potential changes in configurations or settings related to the document library, such as default storage locations, file size limits, or versioning settings. Review the official Liferay DXP 7.4 documentation and release notes for any such changes and adjust the configurations accordingly after the upgrade. Additionally, some updates or fixes in 7.4 might change how the document library interacts with files or handles specific file types. Thorough testing after the upgrade is crucial to verify all document library functionalities work as expected.
For your convenience, I am also linking here the documentation where you can find everything on upgrading, I recommend reading it through before you plan an upgrade:
https://learn.liferay.com/web/guest/w/dxp/installation-and-upgrades/upgrading-liferay