mirror of
https://github.com/rancher/rancher-docs.git
synced 2026-05-13 08:33:35 +00:00
Added link from RKE install page
Also added cluster.yml reference.
This commit is contained in:
@@ -52,6 +52,8 @@ RKE has many configuration options for customizing the install to suit your spec
|
||||
|
||||
Please see the [RKE Documentation]({{< baseurl >}}/rke/latest/en/config-options/) for the full list of options and capabilities.
|
||||
|
||||
For tuning your etcd cluster for larger Rancher installations see the [etcd settings guide]({{< baseurl >}}/rancher/v2.x/en/installation/options/etcd/).
|
||||
|
||||
### Run RKE
|
||||
|
||||
```
|
||||
|
||||
@@ -12,19 +12,24 @@ The etcd data set is automatically cleaned up on a five minute interval by Kuber
|
||||
|
||||
If you ever run into `mvcc: database space exceeded` errors, once you compact, defrag and disarm to recover you should consider increasing the keyspace to mitigate this issue.
|
||||
|
||||
**Example: This snippet increases the key space size to 5GB**
|
||||
**Example: This snippet of the RKE cluster.yml file increases the key space size to 5GB**
|
||||
```yaml
|
||||
# RKE cluster.yml
|
||||
...
|
||||
services:
|
||||
etcd:
|
||||
extra_args:
|
||||
quota-backend-bytes: 5368709120
|
||||
...
|
||||
```
|
||||
|
||||
## Scaling etcd Disk Performance ##
|
||||
## Scaling etcd disk performance ##
|
||||
|
||||
To reduce IO contention on the disks for etcd, you can split the data and WAL directories onto separate devices. To do so, you need to provision nodes with devices and format them before running etcd on them. Based on etcd best practices, mirroring array configurations are unnecessary because etcd replicates the data between the nodes. However, you can use stripping RAID configurations to increase the IOPS available to etcd. To configure dedicated arrays, you can configure this in the RKE cluster.yml file with the following snippet.
|
||||
|
||||
```yaml
|
||||
# RKE cluster.yml
|
||||
...
|
||||
services:
|
||||
etcd:
|
||||
extra_args:
|
||||
@@ -33,6 +38,7 @@ services:
|
||||
extra_binds:
|
||||
- "/var/lib/etcd/data:/var/lib/rancher/etcd/data"
|
||||
- "/var/lib/etcd/wal:/var/lib/rancher/etcd/wal"
|
||||
...
|
||||
```
|
||||
|
||||
For the solution above to work, this requires `/var/lib/etcd/data` and `/var/lib/etcd/wal` to be mounted and formated on the underlying host. Note the addition of the 'wall_dir' directory in the extra_args section. Without this directory being defined, etcd tries to modify the root directory and without sufficient permissions.
|
||||
Reference in New Issue
Block a user