diff --git a/CHANGELOG-3.3.md b/CHANGELOG-3.3.md index 3916028aebf..8333d7f7d13 100644 --- a/CHANGELOG-3.3.md +++ b/CHANGELOG-3.3.md @@ -28,6 +28,7 @@ See [code changes](https://github.com/coreos/etcd/compare/v3.2.0...v3.3.0-rc.0) - Use [`coreos/bbolt`](https://github.com/coreos/bbolt/releases) to replace [`boltdb/bolt`](https://github.com/boltdb/bolt#project-status). - Fix [etcd database size grows until `mvcc: database space exceeded`](https://github.com/coreos/etcd/issues/8009). +- [Support database size larger than 8GiB](https://github.com/coreos/etcd/pull/7525) (8GiB is now a suggested maximum size for normal environments) - [Reduce memory allocation](https://github.com/coreos/etcd/pull/8428) on [Range operations](https://github.com/coreos/etcd/pull/8475). - [Rate limit](https://github.com/coreos/etcd/pull/8099) and [randomize](https://github.com/coreos/etcd/pull/8101) lease revoke on restart or leader elections. - Prevent [spikes in Raft proposal rate](https://github.com/coreos/etcd/issues/8096). diff --git a/Documentation/dev-guide/limit.md b/Documentation/dev-guide/limit.md index 1fc8f0f3b76..853defa6ffc 100644 --- a/Documentation/dev-guide/limit.md +++ b/Documentation/dev-guide/limit.md @@ -6,5 +6,4 @@ etcd is designed to handle small key value pairs typical for metadata. Larger re ## Storage size limit -The default storage size limit is 2GB, configurable with `--quota-backend-bytes` flag; supports up to 8GB. - +The default storage size limit is 2GB, configurable with `--quota-backend-bytes` flag. 8GB is a suggested maximum size for normal environments and etcd warns at startup if the configured value exceeds it. diff --git a/Documentation/faq.md b/Documentation/faq.md index b11349566e0..4078407e71a 100644 --- a/Documentation/faq.md +++ b/Documentation/faq.md @@ -22,7 +22,7 @@ A member's advertised peer URLs come from `--initial-advertise-peer-urls` on ini ### System requirements -Since etcd writes data to disk, SSD is highly recommended. To prevent performance degradation or unintentionally overloading the key-value store, etcd enforces a 2GB default storage size quota, configurable up to 8GB. To avoid swapping or running out of memory, the machine should have at least as much RAM to cover the quota. At CoreOS, an etcd cluster is usually deployed on dedicated CoreOS Container Linux machines with dual-core processors, 2GB of RAM, and 80GB of SSD *at the very least*. **Note that performance is intrinsically workload dependent; please test before production deployment**. See [hardware][hardware-setup] for more recommendations. +Since etcd writes data to disk, SSD is highly recommended. To prevent performance degradation or unintentionally overloading the key-value store, etcd enforces a configurable storage size quota set to 2GB by default. To avoid swapping or running out of memory, the machine should have at least as much RAM to cover the quota. 8GB is a suggested maximum size for normal environments and etcd warns at startup if the configured value exceeds it. At CoreOS, an etcd cluster is usually deployed on dedicated CoreOS Container Linux machines with dual-core processors, 2GB of RAM, and 80GB of SSD *at the very least*. **Note that performance is intrinsically workload dependent; please test before production deployment**. See [hardware][hardware-setup] for more recommendations. Most stable production environment is Linux operating system with amd64 architecture; see [supported platform][supported-platform] for more.