Documentation

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.

Warning

Always back up your file store and database before migrating. Testing the migration process on backup copies is advised.

Migrating Files

Here are the migration steps:

  1. Configure the new file store in System SettingsFile Storage.

  2. In Server AdministrationData Migration, select the repository hook (store implementation class) and click Execute.

    Data Migration utility

  3. Make sure the data migrated correctly.

  4. Configure portal-ext.properties to 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
    
  5. Restart DXP.

Your DXP instance is using the migrated files on the newly configured file store.

Warning

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