-
Notifications
You must be signed in to change notification settings - Fork 262
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #476 from arogge/dev/arogge/master/document-limita…
…tions Document limitations of droplet backend and max block size
- Loading branch information
Showing
2 changed files
with
19 additions
and
7 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
20 changes: 13 additions & 7 deletions
20
...ls/source/manually_added_config_directive_descriptions/sd-device-MaximumBlockSize.rst.inc
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,12 +1,18 @@ | ||
The Storage daemon will always attempt to write blocks of the specified size (in-bytes) to the archive device. As a consequence, this statement specifies both the default block size and the maximum block size. The size written never exceed the given size. If adding data to a block would cause it to exceed the given maximum size, the block will be written to the archive device, and the new data will begin a new block. | ||
The Storage daemon will always attempt to write blocks of the specified size (in bytes) to the archive device. | ||
As a consequence, this statement specifies both the default block size and the maximum block size. | ||
The size written never exceeds the given size. | ||
If adding data to a block would cause it to exceed the given maximum size, the block will be written to the archive device, and the new data will begin a new block. | ||
|
||
If no value is specified or zero is specified, the Storage daemon will use a default block size of 64,512 bytes (126 \* 512). | ||
|
||
|
||
|
||
.. warning:: | ||
|
||
If your are using LTO drives, changing the block size after labeling the tape will result into unreadable tapes. | ||
|
||
Please read chapter :ref:`Tapespeed and blocksizes`, to see how to tune this value in a safe manner. | ||
|
||
.. limitation:: Setting Maximum Block Size for non-tapes is not supported | ||
|
||
This setting has only been tested with tape drives. | ||
The use with every other storage backend is untested and therefore unsupported and discouraged. | ||
|
||
.. warning:: | ||
After setting this value the device may write volumes with the new setting. | ||
Such volumes can only be read by a device with the same or a larger maximum block size configured. | ||
You must make sure that all devices with the same :config:option:`sd/device/MediaType` have the same value applied. |