Skip to content

Commit

Permalink
Update docs/upload-image.md
Browse files Browse the repository at this point in the history
Co-authored-by: Jillian <[email protected]>
  • Loading branch information
WebberHuang1118 and jillian-maroket authored Jun 27, 2024
1 parent 0ef99d3 commit 482f0a7
Showing 1 changed file with 3 additions and 9 deletions.
12 changes: 3 additions & 9 deletions docs/upload-image.md
Original file line number Diff line number Diff line change
Expand Up @@ -134,17 +134,11 @@ If Rancher is deployed on an RKE2 cluster, perform the following steps:

3. Delete the stuck image, and then restart the upload process.

#### Upload the image which is downloaded from Harvester before
#### Uploading Images Previously Downloaded from Harvester

Since **Longhorn v1.5.5**, Longhorn [compresses the backing image for downloading](https://github.com/longhorn/backing-image-manager/pull/153). If you directly upload such file to the Harvester, It will be rejected with message **Upload failed: the uploaded file size xxxx should be a multiple of 512 bytes since Longhorn uses directIO by default**, because the compressed data violates Longhorn's data alignment.
Starting with **v1.5.5**, Longhorn [compresses backing images for downloading](https://github.com/longhorn/backing-image-manager/pull/153). If you attempt to upload a compressed backing image, Harvester rejects the attempt and displays the message **Upload failed: the uploaded file size xxxx should be a multiple of 512 bytes since Longhorn uses directIO by default** because the compressed data violates Longhorn's data alignment.

To re-upload the image, please decompress it first with:

```
$ gzip -d <file name>
```

Then it should be ready for uploading.
Before uploading, decompress backing images using the command `$ gzip -d <file name>`.

### Create Images via Volumes

Expand Down

0 comments on commit 482f0a7

Please sign in to comment.