Deuxfleurs/garage
48
56
Fork 73
Code Issues 100 Pull requests 13 Releases 30 Wiki Activity

A few other changes in documentation
All checks were successful
continuous-integration/drone/push Build is passing
Details
continuous-integration/drone/pr Build is passing
Details

Browse source
This commit is contained in:
Alex 2022-02-10 13:12:15 +01:00
parent 39d9b860ad
commit 831f977c5e
No known key found for this signature in database
GPG key ID: EDABF9711E244EB1
1 changed files with 15 additions and 13 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

28
doc/book/reference-manual/configuration.md
View file

@ -40,7 +40,6 @@ root_domain = ".s3.garage"
[s3_web] [s3_web]
bind_addr = "[::]:3902" bind_addr = "[::]:3902"
root_domain = ".web.garage" root_domain = ".web.garage"
index = "index.html"
``` ```
The following gives details about each available configuration option. The following gives details about each available configuration option.
@ -60,19 +59,22 @@ Store this folder on a fast SSD drive if possible to maximize Garage's performan
The directory in which Garage will store the data blocks of objects. The directory in which Garage will store the data blocks of objects.
This folder can be placed on an HDD. The space available for `data_dir` This folder can be placed on an HDD. The space available for `data_dir`
should be counted to determine a node's capacity should be counted to determine a node's capacity
when [configuring it](@/documentation/cookbook/real-world.md). when [adding it to the cluster layout](@/documentation/cookbook/real-world.md).
### `block_size` ### `block_size`
Garage splits stored objects in consecutive chunks of size `block_size` Garage splits stored objects in consecutive chunks of size `block_size`
(except the last one which might be smaller). The default size is 1MB and (except the last one which might be smaller). The default size is 1MB and
should work in most cases. If you are interested in tuning this, feel free should work in most cases. We recommend increasing it to e.g. 10MB if
to do so (and remember to report your findings to us!). If this value is you are using Garage to store large files and have fast network connections
changed for a running Garage installation, only files newly uploaded will be between all nodes (e.g. 1gbps).
affected. Previously uploaded files will remain available. This however
means that chunks from existing files will not be deduplicated with chunks If you are interested in tuning this, feel free to do so (and remember to
from newly uploaded files, meaning you might use more storage space that is report your findings to us!). When this value is changed for a running Garage
optimally possible. installation, only files newly uploaded will be affected. Previously uploaded
files will remain available. This however means that chunks from existing files
will not be deduplicated with chunks from newly uploaded files, meaning you
might use more storage space that is optimally possible.
### `replication_mode` ### `replication_mode`
@ -114,12 +116,12 @@ default value (currently `3`). Finally, zstd has also compression designed to be
than default compression levels, they range from `-1` (smaller file) to `-99` (faster than default compression levels, they range from `-1` (smaller file) to `-99` (faster
compression). compression).
If you do not specify a `compression_level` entry, garage will set it to `1` for you. With If you do not specify a `compression_level` entry, Garage will set it to `1` for you. With
this parameters, zstd consumes low amount of cpu and should work faster than line speed in this parameters, zstd consumes low amount of cpu and should work faster than line speed in
most situations, while saving some space and intra-cluster most situations, while saving some space and intra-cluster
bandwidth. bandwidth.
If you want to totally deactivate zstd in garage, you can pass the special value `'none'`. No If you want to totally deactivate zstd in Garage, you can pass the special value `'none'`. No
zstd related code will be called, your chunks will be stored on disk without any processing. zstd related code will be called, your chunks will be stored on disk without any processing.
Compression is done synchronously, setting a value too high will add latency to write queries. Compression is done synchronously, setting a value too high will add latency to write queries.
@ -184,8 +186,8 @@ Garage does not yet support talking to Consul over TLS.
This parameter can be used to tune the capacity of the cache used by This parameter can be used to tune the capacity of the cache used by
[sled](https://sled.rs), the database Garage uses internally to store metadata. [sled](https://sled.rs), the database Garage uses internally to store metadata.
Tune this to fit the RAM you wish to make available to your Garage instance. Tune this to fit the RAM you wish to make available to your Garage instance.
More cache means faster Garage, but the default value (128MB) should be plenty This value has a conservative default (128MB) so that Garage doesn't use too much
for most use cases. RAM by default, but feel free to increase this for higher performance.
### `sled_flush_every_ms` ### `sled_flush_every_ms`