Skip to main content
Version: 3.0 (latest)

Configure target filesystems

Configure one or more target filesystems to start migrating data.

Add target filesystems with the UI

To add a target filesystem from your dashboard:

  1. Select the instance from the Instances panel.

  2. Add target filesystem.

  3. Create a target from one of the following supported targets:

For information about configuring filesystem health check notifications and email alerts, see Configure email notifications with the UI.

Update target filesystems with the UI

note

To update existing filesystems, first stop all migrations associated with them. After saving updates to your configuration, restart the Data Migrator service for your updates to take effect. In most supported Linux distributions, run the command service livedata-migrator restart.

  1. Update a target filesystem in the Filesystems page by selecting it in the Filesystems & Agents menu.
  2. Update the filesystem details and select Save.
  3. Restart the Data Migrator service.

The following details can be reconfigured:

Filesystem typeDetails
Alibaba Cloud OSSAuthentication fields and configuration files can be changed. You can't change the endpoint.
Amazon S3Authentication fields can be changed, but not the authentication type.
ADLS Gen2Authentication fields can be changed, but not authentication type or container name.
Google Cloud StorageThe Key File Options can be changed. You can't change the bucket name.
HDFSOnly configuration files can be changed.
IBM Cloud Object StorageAuthentication fields and configuration files can be changed. You can't change the endpoint.
Local filesystemAuthentication fields and configuration files can be changed. You can't change the endpoint.
Oracle Object StorageAuthentication fields, type, and configuration files can be changed.
S3Authentication fields and configuration files can be changed. You can't change the endpoint.

Delete target filesystems with the UI

note

Before you delete a target filesystem, first delete any associated migrations.

Active migrations will prevent filesystem removal. Migrations that are stopped but not deleted will not prevent deletion.

  1. Select the target you want to remove from the Filesystems panel.
  2. Select Delete on the Filesystem Configuration page.

Add and manage target filesystems with the CLI

Add filesystems to provide Data Migrator with information required to read content from your source and to migrate content to your target.

You can define multiple target filesystems to which you can migrate simultaneously.

note

Don't include dots (.) in the names of S3 buckets you want to use with Data Migrator. See the recommendation in the Amazon bucket naming rules guide.

CommandAction
filesystem add s3aAdd an S3 filesystem resource (select this when using Amazon S3, IBM Cloud Object Storage, or Oracle Object Storage)
filesystem clearDelete all target filesystems
filesystem deleteDelete a target filesystem
filesystem listList of target filesystems
filesystem showGet target filesystem details
filesystem typesList the types of target filesystems available

For more information, see the S3a mandatory parameters and the S3a optional parameters.

Next steps

After you have your source and target filesystem configured, you're ready to migrate data. If you want to migrate data to a different path on your target filesystem, create path mappings first.

If you want to exclude specific file sizes or file names from your data migrations, define exclusions.