starlingx/docs
Code Issues Proposed changes
a18b20c7fd
docs/doc/source/storage/kubernetes/increase-controller-filesystem-storage-allotments-using-the-cli.rst
Keane Lim ceea9dda0d Storage Guide update 
Applied review feedback.

Fixed 'grey bars' formatting.
Fixed gerunds and lists
Added abbreviations and references

Change-Id: I104d678ce3ea52bddcbc141f8aad49ea1e1971db
Signed-off-by: Keane Lim <keane.lim@windriver.com>
2021-02-09 12:50:24 -05:00

4.7 KiB
Raw Blame History

Increase Controller Filesystem Storage Allotments Using the CLI

You can use the to list or increase the allotments for controller-based storage at any time after installation.

For more information about increasing filesystem allotments, or to use the Horizon Web interface, see Increase Controller Filesystem Storage Allotments Using Horizon <increase-controller-filesystem-storage-allotments-using-horizon>.

Caution

Decreasing the filesystem size is not supported, and can result in synchronization failures requiring system re-installation. Do not attempt to decrease the size of the filesystem.

Before proceeding, review the prerequisites given for Increase Controller Filesystem Storage Allotments Using Horizon <increase-controller-filesystem-storage-allotments-using-horizon>.

  1. To review the existing storage configuration, use the system controllerfs-list command.

    ~(keystone_admin)$ system controllerfs-list
+-------------+-----------+------+--------------+------------+-----------+
| UUID        | FS Name   | Size | Logical      | Replicated | State     |
|             |           | in   | Volume       |            |           |
|             |           | GiB  |              |            |           |
|             |           |      |              |            |           |
+-------------+-----------+------+--------------+------------+-----------+
| aa9c7eab... | database  | 10   | pgsql-lv     | True       | available |
|             |           |      |              |            |           |
| 173cbb02... | docker-   | 16   | docker       |            |           |
|             |           |      | distribution | True       | available |
|             |           |      |-lv           |            |           |
|             |           |      |              |            |           |
| 448f77b9... | etcd      | 5    | etcd-lv      | True       | available |
|             |           |      |              |            |           |
| 9eadf06a... | extension | 1    | extension-lv | True       | available |
|             |           |      |              |            |           |
| afcb9f0e... | platform  | 10   | platform-lv  | True       | available |
+-------------+-----------+------+--------------+------------+-----------+

    Note

    The values shown by system controllerfs-list are not adjusted for space used by the filesystem, and therefore may not agree with the output of the Linux df command. Also, they are rounded compared to the df output.

  2. Modify the backup filesystem size on controller-0.

    ~(keystone_admin)$ system host-fs-modify controller-0 backup=35
+-------------+---------+---------+----------------+
| UUID        | FS Name | Size in | Logical Volume |
|             |         | GiB     |                |
+-------------+---------+---------+----------------+
| bf0ef915... | backup  | 35      | backup-lv      |
| e8b087ea... | docker  | 30      | docker-lv      |
| 4cac1020... | kubelet | 10      | kubelet-lv     |
| 9c5a53a8... | scratch | 8       | scratch-lv     |
+-------------+---------+---------+----------------+

  3. On a non AIO-Simplex system, modify the backup filesystem size on controller-1.

    The backup filesystem is not replicated across controllers. You must repeat the previous step on the other controller.

    For example:

    ~(keystone_admin)$ system host-fs-modify controller-1 backup=35
+-------------+---------+------+----------------+
| UUID        | FS Name | Size | Logical Volume |
|             |         | in   |                |
|             |         | GiB  |                |
+-------------+---------+------+----------------+
| 45f22520... | backup  | 35   | backup-lv      |
| 173cbb02... | docker  | 30   | docker-lv      |
| 4120d512... | kubelet | 10   | kubelet-lv     |
| 8885ad63... | scratch | 8    | scratch-lv     |
+-------------+---------+------+----------------+