docs/doc/source/node_management/kubernetes/resizing-filesystems-on-a-host.rst
Stone 0d7d14b0c2 File structure reorg
Changed names of kubernetes and openstack subdirs, and reorganized index files
for consistency with other docs.

Signed-off-by: Stone <ronald.stone@windriver.com>
Change-Id: I234dd88e500f12e7c68b0e8bc5b68ca6e0875aba
2021-02-22 13:04:19 -05:00

120 lines
5.0 KiB
ReStructuredText

.. rso1566311417793
.. _resizing-filesystems-on-a-host:
============================
Resize Filesystems on a Host
============================
You can resize a filesystem on a host using the
:command:`system host-fs-modify` command.
The following combinations of filesystem and host types are supported.
.. _resizing-filesystems-on-a-host-table-w4n-wvn-53b:
.. table::
:widths: auto
+-------------+----------------+------------------+----------------+--------------+
| 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 |
+-------------+----------------+------------------+----------------+--------------+
| **scratch** | All node types | /scratch | scratch-lv | variable |
+-------------+----------------+------------------+----------------+--------------+
The following example changes the **docker** and **kubelet** filesystem
sizes on a controller.
.. rubric:: |proc|
#. List the filesystems on the controller.
.. code-block:: none
~(keystone_admin)$ system host-fs-list controller-1
+--------------------------------------+---------+-------------+----------------+
| UUID | FS Name | Size in GiB | Logical Volume |
+--------------------------------------+---------+-------------+----------------+
| a4d83571-a555-4ba5-999f-af709206ae35 | backup | 25 | backup-lv |
| d57652a1-af17-47b8-b941-9ebfeee4a56f | docker | 30 | docker-lv |
| a84374c6-8917-4db5-bd34-2a8d244f2bf6 | kubelet | 10 | kubelet-lv |
| 2c026d6f-5c03-4135-abca-c0047aa7f5a6 | scratch | 8 | scratch-lv |
+--------------------------------------+---------+-------------+----------------+
Note that the **docker** and **kubelet** filesystems are 30 GiB and 10 GiB
respectively.
The syntax of the :command:`host-fs-list` command is:
.. code-block:: none
host-fs-list <hostname_or_id>
**<hostname\_or\_id>** is the host name or UUID of the host.
#. Optionally, list details about a filesystem.
The syntax of the :command:`host-fs-show` command is:
.. code-block:: none
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.
.. code-block:: none
~(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 |
+----------------+--------------------------------------+
#. Modify the sizes of the **docker** and **kubelet** filesystems.
The syntax of the :command:`host-fs-modify` command is:
.. code-block:: none
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.
.. code-block:: none
~(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 |
| 2c026d6f-5c03-4135-abca-c0047aa7f5a6 | scratch | 8 | scratch-lv |
+--------------------------------------+---------+-------------+----------------+