docker
/
docs
mirror of https://github.com/docker/docs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Fix mistakes in LVM config procedure (#3447) 

1. remove step 8 from "Configure direct-lvm mode for production" session.
2. change "0 = disabled" to "100 = disabled" in step 10 for thin_pool_autoextend_threshold.
This commit is contained in:
Zion Wu 2017-06-03 01:53:02 +08:00 committed by Misty Stanley-Jones
parent 633d6edac1
commit 5f02225ea1
1 changed files with 11 additions and 26 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

37
engine/userguide/storagedriver/device-mapper-driver.md
View File

@ -214,35 +214,20 @@ assumes that the Docker daemon is in the `stopped` state.
Converted docker/thinpool to thin pool. Converted docker/thinpool to thin pool.
``` ```
8. Create an LVM profile that will enable automatic extension of the thin 8. Configure autoextension of thin pools via an `lvm` profile.
pool. Edit the file `/etc/lvm/profile/docker-thinpool.profile` and add the
following contents:
```none
thin_pool_autoextend_threshold = 80
```
If desired, set a different value. The value refers to the percentage of
space that needs to be used before LVM attempts to auto-extend the available
space. To disable automatic extension entirely, set the value to `100`. This
is not recommended.
Save the file.
7. Configure autoextension of thin pools via an `lvm` profile.
```bash ```bash
$ sudo vi /etc/lvm/profile/docker-thinpool.profile $ sudo vi /etc/lvm/profile/docker-thinpool.profile
``` ```
8. Specify `thin_pool_autoextend_threshold` and `thin_pool_autoextend_percent` 9. Specify `thin_pool_autoextend_threshold` and `thin_pool_autoextend_percent`
values. values.
`thin_pool_autoextend_threshold` is the percentage of space used before `lvm` `thin_pool_autoextend_threshold` is the percentage of space used before `lvm`
attempts to autoextend the available space (0 = disabled). attempts to autoextend the available space (100 = disabled, not recommended).
`thin_pool_autoextend_percent` is the amount of space to add to the device `thin_pool_autoextend_percent` is the amount of space to add to the device
when automatically extending (100 = disabled). when automatically extending (0 = disabled).
The example below will add 20% more capacity when the disk usage reaches The example below will add 20% more capacity when the disk usage reaches
80%. 80%.
@ -256,7 +241,7 @@ assumes that the Docker daemon is in the `stopped` state.
Save the file. Save the file.
9. Apply the LVM profile, using the `lvchange` command. 10. Apply the LVM profile, using the `lvchange` command.
```bash ```bash
$ sudo lvchange --metadataprofile docker-thinpool docker/thinpool $ sudo lvchange --metadataprofile docker-thinpool docker/thinpool
@ -264,7 +249,7 @@ assumes that the Docker daemon is in the `stopped` state.
Logical volume docker/thinpool changed. Logical volume docker/thinpool changed.
``` ```
10. Enable monitoring for logical volumes on your host. Without this step, 11. Enable monitoring for logical volumes on your host. Without this step,
automatic extension will not occur even in the presence of the LVM profile. automatic extension will not occur even in the presence of the LVM profile.
```bash ```bash
@ -274,7 +259,7 @@ assumes that the Docker daemon is in the `stopped` state.
thinpool docker twi-a-t--- 95.00g 0.00 0.01 monitored thinpool docker twi-a-t--- 95.00g 0.00 0.01 monitored
``` ```
11. If you have ever run Docker on this host before, or if `/var/lib/docker/` 12. If you have ever run Docker on this host before, or if `/var/lib/docker/`
exists, move it out of the way so that Docker can use the new LVM pool to exists, move it out of the way so that Docker can use the new LVM pool to
store the contents of image and containers. store the contents of image and containers.
@ -286,7 +271,7 @@ assumes that the Docker daemon is in the `stopped` state.
If any of the following steps fail and you need to restore, you can remove If any of the following steps fail and you need to restore, you can remove
`/var/lib/docker` and replace it with `/var/lib/docker.bk`. `/var/lib/docker` and replace it with `/var/lib/docker.bk`.
12. Edit `/etc/docker/daemon.json` and configure the options needed for the 13. Edit `/etc/docker/daemon.json` and configure the options needed for the
`devicemapper` storage driver. If the file was previously empty, it should `devicemapper` storage driver. If the file was previously empty, it should
now contain the following contents: now contain the following contents:
@ -301,7 +286,7 @@ assumes that the Docker daemon is in the `stopped` state.
} }
``` ```
13. Start Docker. 14. Start Docker.
**systemd**: **systemd**:
@ -315,7 +300,7 @@ assumes that the Docker daemon is in the `stopped` state.
$ sudo service docker start $ sudo service docker start
``` ```
14. Verify that Docker is using the new configuration using `docker info`. 15. Verify that Docker is using the new configuration using `docker info`.
```bash ```bash
$ docker info $ docker info
@ -351,7 +336,7 @@ assumes that the Docker daemon is in the `stopped` state.
If Docker is configured correctly, the `Data file` and `Metadata file` will If Docker is configured correctly, the `Data file` and `Metadata file` will
be blank, and the pool name will be `docker-thinpool`. be blank, and the pool name will be `docker-thinpool`.
15. After you have verified that the configuration is correct, you can remove the 16. After you have verified that the configuration is correct, you can remove the
`/var/lib/docker.bk` directory which contains the previous configuration. `/var/lib/docker.bk` directory which contains the previous configuration.
```bash ```bash