Migrating Data to Stook Using Rclone

Rclone is a versatile command-line tool that allows you to copy data between different cloud storage providers, including Medianova’s S3-compatible cloud-based object storage; Stook. In this guide, we'll walk through the process of using Rclone to migrate data from another S3-compatible storage provider to Stook.

Prerequisites

Install Rclone: You can download and install Rclone from the official website (https://rclone.org/downloads/).

Migration Steps

Step 1: Configure Rclone for Your Source and Target Buckets

Open your terminal or command prompt and run the following command to configure Rclone:

rclone config

Follow the interactive configuration wizard:

• Choose n for a new remote.

• Give your remote a name (e.g., "s3-source").

• Select the S3-compatible storage provider you are migrating data from.

• Enter the necessary configuration details, including endpoint URL, access key, secret key, and any other provider-specific information.

Repeat the above steps to configure a remote for your target bucket (e.g., "stook-target"). When picking the s3 compatible storage type, choose the Ceph Object Storage.

Step 2: Copy Data from the Source to the Target Bucket

Now that you've configured both source and target remotes, you can start copying data. Use the rclone copy command to transfer your data:

rclone copy s3-source:source-bucket-name stook-target:target-bucket-name

Replace source-bucket-name with the name of your source bucket and target-bucket-name with the name of your target bucket. This command will copy all data from the source to the target bucket.

If you want to copy only specific files or directories, you can specify them in the command. For example:

rclone copy s3-source:source-bucket-name/path/to/source-data stook-target:target-bucket-name/path/to/target-location

Step 3: Monitor the Progress of the Data Transfer

rclone copy --progress s3-source:source-bucket-name stook-target:target-bucket-name

Rclone will now display progress information, including the number of files transferred and their sizes. You can monitor the progress of the data transfer in real-time.

Step 4: Verify Data in the Target Bucket

After the data transfer is complete, it is recommended to verify the integrity of the data in Stook. You can use rclone check for this. It compares sizes and hashes (MD5 or SHA1) and logs a report of files that don not match.

rclone check s3-source:source-bucket-name stook-target:target-bucket-name

This command will ensure that the data in Stook matches the source bucket.