Using the Data Migration Tool in Liferay DXP 7.1

This article documents how to use the data migration tool in the Server Administration section of Liferay Digital Experience Platform (DXP) 7.1. The Data Migration Tool allows administrators to migrate data quickly between Documents and Media repository to another, such as moving from File System Store or DB Store to Advanced File System Store.

There are two ways to accomplish this process. The first way is using an .config file based on the OSGi implementation in Liferay DXP 7.1. The second way is to use the Control Panel.

Resolution

Method 1: Using OSGi

1. Shut down the application server running Liferay Digital Experience Platform 7.1.
2. Go to the [Liferay Home]/osgi/configs folder.
3. If you are migrating to the Advanced File System Store, create a new file called com.liferay.portal.store.file.system.configuration.AdvancedFileSystemStoreConfiguration.config.
   • By default, Liferay Digital Experience Platform 7.1. uses dl.store.impl=com.liferay.portal.store.file.system.FileSystemStore
4. Open the newly created .config file and add the following configuration: rootDir=${document_library_path}
   For example: rootDir=/opt/lfr/docs (Unix/Linux) or rootDir=C:\liferay\data  (Windows)
5. Save the file.
6. Next, in the portal-ext.properties, enter the following: dl.store.impl=com.liferay.portal.store.file.system.AdvancedFileSystemStore.
7. Save the file.
8. Restart the application server.

Once the server has restarted, the documents will now be stored in the new repository.

Method 2: Using the Control Panel's Server Administration

DXP 7.1 offers the ability to execute the same data migration process between file stores from the Control Panel.

1. Navigate to the Admin → Control Panel → Server Administration.
2. Click the Data Migration tab.
3. Select the desired file store system option, such as Advanced File Store.
4. Then click Execute.
5. Watch the logs to know when the process is complete, and make special note of any exceptions. The platform will be unavailable until it is restarted with the changes applied to portal.properties.
6. Verify the data was written to the appropriate document library store location;
   • The default location is ${liferay.home}/data/document_library.
   • Alternately, the library store location is whatever you set in your .config file.
7. Shut down Liferay Liferay DXP 7.1.
8. In the portal-ext.properties file, enter the following:
   dl.store.impl={whatever the new file store system is}
   For example: dl.store.impl=com.liferay.portal.store.file.system.AdvancedFileSystemStore
9. Save the file.
10. Start the application server again.

The platform has migrated the data to the new file store system.