starlingx/docs
Code Issues Proposed changes
docs/doc/source/node_management/kubernetes/resizing-filesystems-on-a-host.rst
Elaine Fonaro f75aed2e28 Need to add / and /var file system expansion (r8, dsr8) 
- Added 2x rows to HTML table with var and root information.

Change-Id: I722fe92616364b282971fa012cde7157cc4657f8
Signed-off-by: Elaine Fonaro <elaine.fonaro@windriver.com>
2023-08-24 13:30:12 +00:00

6.1 KiB
Raw Blame History

Resize Filesystems on a Host

You can resize a filesystem on a host using the system host-fs-modify command.

The following combinations of filesystem and host types are supported.

Filesystem Host Type Folder Logical Volume Default Size
backup controller /opt/backups backup-lv 25 GiB
docker All node types /var/lib/docker docker-lv 30 GiB
kubelet All node types /var/lib/kubelet kubelet-lv 10 GiB
log All node types /var/log log-lv 7.5 GiB
root All node types /sysroot root-lv 20 GiB
scratch All node types /scratch scratch-lv variable
var All node types /var var-lv 20 GiB

The following example changes the docker and kubelet filesystem sizes on a controller.

  1. List the filesystems on the controller.

    ~(keystone_admin)$ system host-fs-list controller-1
+--------------------------------------+-----------+-------------+----------------+
| UUID                                 | FS Name   | Size in GiB | Logical Volume |
+--------------------------------------+-----------+-------------+----------------+
| 42dba35b-d2cb-4cbe-85b5-4ffc0fd75d37 | backup    | 25          | backup-lv      |
| 0c83c1cb-63f3-4d7a-961e-21b460890417 | docker    | 30          | docker-lv      |
| dc212c9b-ba1b-49f1-8bbc-dc41f7f226f2 | kubelet   | 10          | kubelet-lv     |
| 766ad3d7-e420-4aff-9e35-a8e495413ead | log       | 8           | log-lv         |
| 0215defd-ded2-46df-9338-1d39e7648028 | root      | 20          | root-lv        |
| 3079f0ca-28c8-444f-a955-44cc98f96156 | scratch   | 16          | scratch-lv     |
| c987d5d7-729e-400c-8d51-ff464b2b9675 | var       | 20          | var-lv         |
+--------------------------------------+-----------+-------------+----------------+

    Note that the docker and kubelet filesystems are 30 GiB and 10 GiB respectively.

    The syntax of the host-fs-list command is:

    host-fs-list <hostname_or_id>

    <hostname_or_id> is the host name or UUID of the host.

  2. Optionally, list details about a filesystem.

    The syntax of the host-fs-show command is:

    host-fs-show <hostname_or_id> <fs_name_or_uuid>
    <hostname_or_id>

    The host name or UUID of the host.

    <fs_name_or_uuid>

    The name or UUID of the file system.

    ~(keystone_admin)$ system host-fs-show controller-1 d57652a1-af17-47b8-b941-9ebfeee4a56f
+----------------+--------------------------------------+
| Property       | Value                                |
+----------------+--------------------------------------+
| uuid           | d57652a1-af17-47b8-b941-9ebfeee4a56f |
| name           | docker                               |
| size           | 30                                   |
| logical_volume | docker-lv                            |
| created_at     | 2019-08-08T03:05:25.341669+00:00     |
| updated_at     | None                                 |
+----------------+--------------------------------------+

  3. Modify the sizes of the docker and kubelet filesystems.

    The syntax of the host-fs-modify command is:

    host-fs-modify <hostname_or_id> <fs_name>=<size> [<fs_name>=<size>]
    <hostname_or_id>

    The host name or UUID of the node.

    <fs_name>

    The name of the filesystem.

    <size>

    The new size of the filesystem, in GiB.

    The following command changes the size of the docker filesystem to 31 GiB and that of the kubelet filesystem to 11 GiB.

    ~(keystone_admin)$ system host-fs-modify controller-1 docker=31 kubelet=11
+--------------------------------------+---------+-------------+----------------+
| UUID                                 | FS Name | Size in GiB | Logical Volume |
+--------------------------------------+---------+-------------+----------------+
| a4d83571-a555-4ba5-999f-af709206ae35 | backup  | 25          | backup-lv      |
| d57652a1-af17-47b8-b941-9ebfeee4a56f | docker  | 31          | docker-lv      |
| a84374c6-8917-4db5-bd34-2a8d244f2bf6 | kubelet | 11          | kubelet-lv     |
| 3fe89994-a5b9-4612-8321-443fc9d2fba7 | log     | 8           | log-lv         |
| 2c026d6f-5c03-4135-abca-c0047aa7f5a6 | scratch | 8           | scratch-lv     |
| 0215defd-ded2-46df-9338-1d39e7648028 | root    | 20          | root-lv        |
| c987d5d7-729e-400c-8d51-ff464b2b9675 | var     | 20          | var-lv         |
+--------------------------------------+---------+-------------+----------------+