I am currently using Liferay 7.4 with Document Library using Advanced File System Store, and I want to migrate all existing files to MinIO S3 store.
I have configured S3 Store settings in System Settings, but the S3 option does not appear in the Data Migration UI under Control Panel → Server Administration → Data Migration.
Could someone please share the step-by-step workflow to migrate from Advanced File System to MinIO S3, specifically:
How to configure MinIO S3 settings correctly so that the target S3 store appears in the Data Migration dropdown?
What configuration properties I should set and where (e.g., portal-ext.properties vs System Settings)?
Migration procedure including:
how to trigger the data migration tool,
how to verify files are successfully migrated,
how to switch the active store to S3 afterwards.
Any gotchas or tips for MinIO (e.g., path-style access, bucket policies, IAM settings).
Examples of config values (e.g., s3.endpoint, s3.path.style.access etc.) that you used successfully.
Right now:
Advanced File System is active.
MinIO S3 is configured but does not show up in the Data Migration options.
I want to avoid manual copy and ensure thumbnails / versions work too.
If the option for com.liferay.portal.store.s3.S3Store still does not appear in Control Panel → Server Administration → Data Migration, then you likely need to first migrate to first to com.liferay.portal.store.file.system.FileSystemStore. For this, follow the tutorial: File Store Migration - Liferay Official Documentation - Liferay Learn to migrate to FileSystemStore. After completing it, check if the S3 option appears.
Along with the reference shared by André, you can refer to the following as well:
S3 option does not appear in the Data Migration UI under Control Panel → Server Administration → Data Migration. - If you are still unable to locate this option after migration, then first you need to check the configurations you have given in System Settings > File Storage > S3 Store (Bucket Name, Access Key, and Secret Key are must).
After this, try to upload the document to check if connectivity between S3 storage and Liferay is working or not. If not, check for the errors in Liferay console.
Now, once the connectivity works and the correct configurations are in place, then you will be able to see the S3 option.
how to trigger the data migration tool
how to verify files are successfully migrated
Once you click the execute button in Server Administration > Data Migration, you can see the Liferay logs, where Migration info logs will be printed. This will assist the user in knowing how many files are migrated and if it is successful or not.
