File Store Migration¶
Files can be migrated from one file store type to another. Here are some migration scenarios:
Migrating from Simple File System Store to Advanced File System Store for improved performance and scalability.
Migrating from Simple, Advanced, or S3 to DBStore to avoid transaction rollback vulnerabilities.
Migrating from DBStore to Advanced File System Store to accommodate files larger than 1 gigabyte.
The Data Migration utility in Server Administration facilitates the migration.
Always back up your file store and database before migrating. Testing the migration process on backup copies is advised.
Here are the migration steps:
Configure the new file store in System Settings → File Storage.
In Server Administration → Data Migration, select the repository hook (store implementation class) and click Execute.
Make sure the data migrated correctly.
portal-ext.propertiesto the target file store type, using one of these settings:
dl.store.impl=com.liferay.portal.store.db.DBStore dl.store.impl=com.liferay.portal.store.file.system.AdvancedFileSystemStore dl.store.impl=com.liferay.portal.store.file.system.FileSystemStore dl.store.impl=com.liferay.portal.store.s3.S3Store
Your DXP instance is using the migrated files on the newly configured file store.
Make sure to save your new store configuration in System Settings. Otherwise, you can’t use the new store and following exception occurs:
java.lang.IllegalStateException: Store is not available