Project

General

Profile

Documentation #20486

Document how to use bluestore compression

Added by Joao Eduardo Luis over 5 years ago. Updated over 5 years ago.

Status:
Resolved
Priority:
High
Assignee:
-
Category:
Administration/Usability
Target version:
-
% Done:

0%

Tags:
Backport:
Reviewed:
Affected Versions:
Pull request ID:

Description

Bluestore is becoming the de facto default, and I haven't found any docs on how to configure compression.

The bits I found out were through skimming the code, and that did not provide too much insight on what the options really do. Regardless, we can't expect our average user to do the same.

We should, at least, document how to use this with `osd pool set`, with a brief description of each option and possible values.

History

#1 Updated by Lenz Grimmer over 5 years ago

Joao Luis wrote:

The bits I found out were through skimming the code, and that did not provide too much insight on what the options really do.
Regardless, we can't expect our average user to do the same.

We should, at least, document how to use this with `osd pool set`, with a brief description of each option and possible values.

FWIW, Joao performed a quick scan of the code (mon/MonCommands.h and compressor/Compressor.cc), which revealed the following options for 'osd pool set': 'compression_mode, compression_algorithm, compression_required_ratio, compression_max_blob_size, and compression_min_blob_size

For 'mode', allowed values are "force", "aggressive", "passive", "none", for algorithm, "none", "snappy", "zlib", "zstd", and "lz4".

However, it would be helpful if these various options would be documented in more detail in the documentation.

#2 Updated by Sage Weil over 5 years ago

  • Status changed from New to Resolved

Also available in: Atom PDF