Configure target filesystems
Configure one or more target filesystems to start migrating data.
#
Add target filesystems with the UITo add a target filesystem from your LiveData Migrator dashboard, select the following:
The relevant instance from the Products panel.
Add target filesystem in the Filesystem Configuration page.
You can create a target from one of the following supported targets:
Azure Data Lake Storage (ADLS) Gen2 (preview) - You can override the default value (
dfs.core.windows.net
) for Data Lake Storage Endpoint by replacing it with a custom or private endpoint.
Select one of the following under Authentication Type:Amazon S3/IBM Cloud Object Storage (preview)
Use AWS PrivateLink (Optional) - Select this checkbox if you want private connectivity between Amazon Simple Storage Service (S3) and on-premises resources using private IPs. See AWS PrivateLink for Amazon S3. After you select this checkbox, enter the endpoint that LiveData Migrator should use to connect to Amazon S3 in the S3 Endpoint field.note
You must not include dots (.) in the names of S3 buckets you want to use with LiveData Migrator. See the recommendation in the Amazon bucket naming rules guide.
Oracle Object Storage (preview) - you must enter an Oracle Cloud endpoint to configure Oracle Cloud as an S3 target. When you enter an Oracle Cloud endpoint, all the other fields are filled automatically. For more information about Oracle endpoints and availability domains, go to the Oracle Cloud documentation.
note
To add a Google Cloud Storage target, you must first add a Service Account with at least Storage Admin role permissions to your Google Cloud Storage bucket.
For more information, see Creating and managing service accounts.
#
Update target filesystem configurationsUpdate a target filesystem's configuration in its Filesystem Configuration page by selecting it in the Filesystems & Agents list in the LiveData Migrator dashboard.
note
To update existing filesystems, first stop all migrations associated with them.
After saving updates to your configuration, you'll need to restart the LiveData Migrator service for your updates to take effect. In most supported Linux distributions, run the command service livedata-migrator restart
.
Update the filesystem details and select Save.
The following details can be reconfigured:
Filesystem type | Details |
---|---|
Google Cloud Storage (preview) | The credentials file type can be changed. You can't change the bucket name. |
Azure Data Lake Storage (ADLS) Gen2 (preview) | Authentication fields can be changed, but not authentication type or container name. |
Hadoop Distributed File System (HDFS) target | Only configuration files can be changed. |
Amazon S3 (preview) | Authentication fields can be changed, but not the authentication type. |
IBM Cloud Object Storage (preview) | Authentication fields and configuration files can be changed. The endpoint can't be changed. |
Oracle Object Storage (preview) | Authentication fields, type, and configuration files can be changed. |
#
Delete target filesystemsDelete a target filesystem from the Filesystems panel. Select Delete Filesystem. Before you delete a target filesystem, first delete any associated migrations.
#
Add and manage target filesystems with the CLIAdd filesystems to provide LiveData Migrator with information required to read content from your source and to migrate content to your target.
A range of different filesystem types are supported as targets, including Azure Data Lake Storage (ADLS) Gen2 (preview), Hadoop Distributed File System (HDFS), Google Cloud Storage (preview), and S3 (preview).
You can define multiple target filesystems to which you can migrate simultaneously. For more information about creating each target type, see below:
- ADLS Gen2
- Google Cloud Storage
- HDFS
- S3
Command | Action |
---|---|
filesystem add adls2 oauth | Add an ADLS Gen2 filesystem resource using a service principal and 0Auth credentials |
filesystem add adls2 sharedKey | Add an ADLS Gen2 filesystem resource using access key credentials |
filesystem clear | Delete all target filesystems |
filesystem delete | Delete a target filesystem |
filesystem list | List of target filesystems |
filesystem show | Get target filesystem details |
filesystem types | List the types of target filesystems available |
If you have ADLS Gen2 installed on a private network with a custom ADLS Gen2 endpoint, you can override the default endpoint value (dfs.core.windows.net
) using the following property and example value:
[--properties] fs.account.endpoint=<private_endpoint>
Command | Action |
---|---|
filesystem add gcs | Add a Google Cloud Storage resource |
filesystem clear | Delete all target filesystems |
filesystem delete | Delete a target filesystem |
filesystem list | List of target filesystems |
filesystem show | Get target filesystem details |
filesystem types | List the types of target filesystems available |
Command | Action |
---|---|
filesystem add hdfs | Add an HDFS resource |
filesystem clear | Delete all target filesystems |
filesystem delete | Delete a target filesystem |
filesystem list | List of target filesystems |
filesystem show | Get target filesystem details |
filesystem types | List the types of target filesystems available |
note
You must not include dots (.) in the names of S3 buckets you want to use with LiveData Migrator. See the recommendation in the Amazon bucket naming rules guide.
Command | Action |
---|---|
filesystem add s3a | Add an S3 filesystem resource (select this when using Amazon S3, IBM Cloud Object Storage, or Oracle Object Storage) |
filesystem clear | Delete all target filesystems |
filesystem delete | Delete a target filesystem |
filesystem list | List of target filesystems |
filesystem show | Get target filesystem details |
filesystem types | List the types of target filesystems available |
For more information, view the S3 mandatory parameters and the S3 optional parameters.
note
This is an example of a successful Oracle Object Storage configuration:
- fs.s3a.endpoint=wandiscodev.compat.objectstorage.us-ashburn-1.oraclecloud.com
- fs.s3a.path.style.access=true
- fs.s3a.list.version=1
#
Next stepsOnce you have your source and target filesystem configured, you're ready to migrate data. If you want 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.