Skip to content

Commit

Permalink
Record platform limitation of the Kopia block mode uploader in docs. (#…
Browse files Browse the repository at this point in the history
…7013)

Signed-off-by: Xun Jiang <jxun@vmware.com>
  • Loading branch information
blackpiglet authored Oct 25, 2023
1 parent 30bf6bd commit 45ed3bf
Show file tree
Hide file tree
Showing 4 changed files with 6 additions and 1 deletion.
2 changes: 1 addition & 1 deletion changelogs/unreleased/6989-blackpiglet
Original file line number Diff line number Diff line change
@@ -1 +1 @@
Add both non-Windows version and Windows version code for PVC block mode logic.
Limit PVC block mode logic to non-Windows platform.
Original file line number Diff line number Diff line change
Expand Up @@ -666,6 +666,9 @@ At present, VBDM doesn't support recovery, so it will follow the second rule.
## Kopia For Block Device
To work with block devices, VGDP will be updated. Today, when Kopia attempts to create a snapshot of the block device, it will error because kopia does not support this file type. Kopia does have a nice set of interfaces that are able to be extended though.

**Notice**
The Kopia block mode uploader only supports non-Windows platforms, because the block mode code invokes some system calls that are not present in the Windows platform.

To achieve the necessary information to determine the type of volume that is being used, we will need to pass in the volume mode in provider interface.

```go
Expand Down
1 change: 1 addition & 0 deletions site/content/docs/main/csi-snapshot-data-movement.md
Original file line number Diff line number Diff line change
Expand Up @@ -248,6 +248,7 @@ that anyone who has access to your backup storage can decrypt your backup data**
to the backup storage appropriately.
- [Velero built-in data mover] Even though the backup data could be incrementally preserved, for a single file data, Velero built-in data mover leverages on deduplication to find the difference to be saved. This means that large files (such as ones storing a database) will take a long time to scan for data deduplication, even if the actual difference is small.
- [Velero built-in data mover] You may need to [customize the resource limits][11] to make sure backups complete successfully for massive small files or large backup size cases, for more details refer to [Velero file system level backup performance guide][12].
- The block mode is supported by the Kopia uploader, but it only supports non-Windows platforms, because the block mode code invokes some system calls that are not present in the Windows platform.

## Troubleshooting

Expand Down
1 change: 1 addition & 0 deletions site/content/docs/v1.12/csi-snapshot-data-movement.md
Original file line number Diff line number Diff line change
Expand Up @@ -261,6 +261,7 @@ that anyone who has access to your backup storage can decrypt your backup data**
to the backup storage appropriately.
- [Velero built-in data mover] Even though the backup data could be incrementally preserved, for a single file data, Velero built-in data mover leverages on deduplication to find the difference to be saved. This means that large files (such as ones storing a database) will take a long time to scan for data deduplication, even if the actual difference is small.
- [Velero built-in data mover] You may need to [customize the resource limits][11] to make sure backups complete successfully for massive small files or large backup size cases, for more details refer to [Velero file system level backup performance guide][12].
- The block mode is supported by the Kopia uploader, but it only supports non-Windows platforms, because the block mode code invokes some system calls that are not present in the Windows platform.

## Troubleshooting

Expand Down

0 comments on commit 45ed3bf

Please sign in to comment.