docs/doc/source/storage/kubernetes/increase-the-size-for-lvm-local-volumes-on-controller-filesystems.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

Increase the Size for LVM Local Volumes on Controller Filesystems

Controller filesystems are allocated as LVM local volumes inside the cgts-vg volume group. You can increase controller filesystem storage inside the cgts-vg volume group by using the , or the Horizon Web interface.

To provision filesystem storage, enough free disk space has to be available in this volume group. You can increase available space for provisioning by creating a partition and assigning it to cgts-vg volume group. This partition can be created on the root disk or on a different disk of your choice. In , Simplex or Duplex systems that use a dedicated disk for nova-local, some root disk space reserved for nova-local is unused. You can recover this space for use by the cgts-vg volume group to allow for controller filesystem expansion.

For convenience, this operation is permitted on an unlocked controller.

Note

Using more than one disk during setup for cgts-vg, may increase disk failures. In case any of the disks in the cgts-vg volume group fails, the disk has to be replaced and the node has to be reinstalled. It is strongly recommended to limit cgts-vg to the root disk.

Note

The partition should be the same size on both controllers, otherwise only the smallest common denominator size can be provisioned from cgts-vg.

Caution

Once the cgts-vg partition is added, it cannot be removed.

The following example is used for provisioning cgts-vg on a root disk. The default rootfs device is /dev/sda.

  1. Check the free space on the rootfs, by using the following command:

    ~(keystone_admin)$ system host-disk-list 1
  2. Create a new partition on rootfs, for example:

    ~(keystone_admin)$ system host-disk-partition-add -t lvm_phys_vol controller-0 /dev/sda 22
     +---------------+------------------------------------------------+
     | Property      |     Value                                      |
     +---------------+------------------------------------------------+
     | device_path   |/dev/disk/by-path/pci-0000:00:0d.0-ata-1.0-part7|
     | device_node   | /dev/sda7                                      |
     | type_guid     | ba5eba11-0000-1111-2222-000000000001           |
     | type_name     | None                                           |
     | start_mib     | None                                           |
     | end_mib       | None                                           |
     | size_mib      | 22528                                          |
     | uuid          | 994d7efb-6ac1-4414-b4ef-ae3335dd73c7           |
     | ihost_uuid    | 75ea78b6-62f0-4821-b713-2618f0d5f834           |
     | idisk_uuid    | 685bee31-45de-4951-a35c-9159bd7d1295           |
     | ipv_uuid      | None                                           |
     | status        | Creating                                       |
     | created_at    | 2020-07-30T21:29:04.014193+00:00               |
     | updated_at    | None                                           |
     +---------------+------------------------------------------------+
  3. Check for free disk space on the new partition, once it is created.

    ~(keystone_admin)$ system host-disk-partition-list 1
  4. Assign the unused partition on controller-0 as a physical volume to cgts-vg volume group.

    ~(keystone_admin)$ system host-pv-add controller-0 cgts-vg dev/sda
  5. Assign the unused partition on controller-1 as a physical volume to cgts-vg volume group. You can also swact the hosts, and repeat the procedure on controller-1.

    ~(keystone_admin)$ system host-pv-add controller-1 cgts-vg /dev/sda

After increasing the cgts-vg volume size, you can provision the filesystem storage. For more information about increasing filesystem allotments using the CLI, or the Horizon Web interface, see:

  • Increase Controller Filesystem Storage Allotments Using Horizon <increase-controller-filesystem-storage-allotments-using-horizon>
  • Increase Controller Filesystem Storage Allotments Using the CLI <increase-controller-filesystem-storage-allotments-using-the-cli>