diff --git a/manual/setup/migrate_backends_data.md b/manual/setup/migrate_backends_data.md index fd3ef6ae..85862a43 100644 --- a/manual/setup/migrate_backends_data.md +++ b/manual/setup/migrate_backends_data.md @@ -14,6 +14,10 @@ Data migration takes 3 steps: 3. Run final migration 4. Replace the original seafile.conf +!!! warning "Migration from S3" + + Since version 11, when you migrate from S3 to other storage servers, you have to use V4 authentication protocol. This is because version 11 upgrades to Boto3 library, which fails to list objects from S3 when it's configured to use V2 authentication protocol. + ## Create a new temporary seafile.conf We need to add new backend configurations to this file (including `[block_backend]`, `[commit_object_backend]`, `[fs_object_backend]` options) and save it under a readable path. diff --git a/manual/setup/setup_with_multiple_storage_backends.md b/manual/setup/setup_with_multiple_storage_backends.md index 08942d9e..0c703725 100644 --- a/manual/setup/setup_with_multiple_storage_backends.md +++ b/manual/setup/setup_with_multiple_storage_backends.md @@ -280,6 +280,10 @@ Then you can add option `for_new_library` to the backends which are expected to ## Multiple Storage Backend Data Migration +!!! warning "Migration from S3" + + Since version 11, when you migrate from S3 to other storage servers, you have to use V4 authentication protocol. This is because version 11 upgrades to Boto3 library, which fails to list objects from S3 when it's configured to use V2 authentication protocol. + Run the `migrate-repo.sh` script to migrate library data between different storage backends. ```