diff --git a/source/clear-linux/guides/maintenance/figures/increase-virtual-disk-size-1.png b/source/clear-linux/guides/maintenance/figures/increase-virtual-disk-size-1.png index db5a2f3f..a4692c9a 100755 Binary files a/source/clear-linux/guides/maintenance/figures/increase-virtual-disk-size-1.png and b/source/clear-linux/guides/maintenance/figures/increase-virtual-disk-size-1.png differ diff --git a/source/clear-linux/guides/maintenance/figures/increase-virtual-disk-size-2.png b/source/clear-linux/guides/maintenance/figures/increase-virtual-disk-size-2.png new file mode 100644 index 00000000..90b1eb28 Binary files /dev/null and b/source/clear-linux/guides/maintenance/figures/increase-virtual-disk-size-2.png differ diff --git a/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst b/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst index 005d436b..755a327f 100644 --- a/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst +++ b/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst @@ -10,14 +10,15 @@ if you need more capacity. .. contents:: This guide will cover: -Determine the partition sizes of the prebuilt image +Determine the partition order and sizes of the prebuilt image *************************************************** -There are two methods to find the virtual disk size of your prebuilt |CL| +There are two methods to find the order and sizes of partitions virtual disk of your prebuilt |CL| image. -In both examples, the prebuilt Hyper-V image used starting off at about 8.5 GB -with /dev/sdd3 being the partition +In both examples, the prebuilt Hyper-V image +has a disk size of 8.5 GB with /dev/sdd3 being the partition +for the root filesystem (/) Checking :command:`lsblk` on the VM @@ -26,26 +27,28 @@ Checking :command:`lsblk` on the VM The first method is to boot up your :abbr:`VM (Virtual Machine)` and execute the :command:`lsblk` command as shown below: - .. code-block:: bash + .. code-block:: bash - sudo lsblk + sudo lsblk An example output of the :command:`lsblk` command: - .. code-block:: console - - NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT - sda 8:0 0 8.5G 0 disk - ├─sdd1 8:1 0 512M 0 part - ├─sdd2 8:2 0 32M 0 part [SWAP] - └─sdd3 8:3 0 8G 0 part / + .. code-block:: console + NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT + sda 8:0 0 8.5G 0 disk + ├─sdd1 8:1 0 512M 0 part + ├─sdd2 8:2 0 32M 0 part [SWAP] + └─sdd3 8:3 0 8G 0 part / +An example of this can also be seen in Figure 1. Checking :file:`config.json` used to build the image ---------------------------------------------------- -The second method is to check the :file:`config.json` file used to create prebuilt image, located in the + +The second method to determine partition to check the :file:`config.json` +file used to create prebuilt image, located in the `releases`_ repository. For example, to find the size of the Hyper-V\* image version number 20450, follow these steps: @@ -53,101 +56,117 @@ version number 20450, follow these steps: #. Drill down into the `20450 > clear > config > image` directory. #. Open the :file:`hyperv-config.json` file. #. Locate the `PartitionLayout` key. - The example shows 512 MB for the EFI partition, 32 MB for the swap - partition, and 8 GB for the root partition. - .. code-block:: console + The example shows 512 MB for the EFI partition, 32 MB for the swap + partition, and 8 GB for the root partition. - "PartitionLayout" : [ { "disk" : "hyperv.img", - "partition" : 1, - "size" : "512M", - "type" : "EFI" }, - { "disk" : "hyperv.img", - "partition" : 2, - "size" : "32M", - "type" : "swap" }, - { "disk" : "hyperv.img", - "partition" : 3, - "size" : "8G", - "type" : "linux" } ], + + .. code-block:: console + + "PartitionLayout" : [ { "disk" : "hyperv.img", + "partition" : 1, + "size" : "512M", + "type" : "EFI" }, + { "disk" : "hyperv.img", + "partition" : 2, + "size" : "32M", + "type" : "swap" }, + { "disk" : "hyperv.img", + "partition" : 3, + "size" : "8G", + "type" : "linux" } ], Increase virtual disk size ************************** +Once you have determined the disk and partition to be increased, you are ready to perform the actual increase. + Power off VM and increase virtual disk size: -------------------------------------------- To increase the virtual disk size for a prebuilt image, perform the steps below: -#. Shut down your VM if it is running. -#. Use an appropriate hypervisor tool to increase the virtual disk size of - your VM. -#. Power up the VM. +#. Shut down your VM if it is running. +#. Use the process defined by your hypervisor to + increase the virtual disk size of your |CL| VM. +#. Power up the VM. Resize the partition of the virtual disk: ----------------------------------------- -#. Log in to an account with root privileges. -#. Open a terminal emulator. -#. Add the |CL| `storage-utils` bundle to install the `parted` and - `resize2fs` tools. +#. Log in to an account with root privileges. +#. Open a terminal emulator. +#. Add the |CL| `storage-utils` bundle to install the :command:`parted` and :command:`resize2fs` tools. - .. code-block:: bash + .. code-block:: bash - sudo swupd bundle-add storage-utils + sudo swupd bundle-add storage-utils #. Launch the `parted` tool. - .. code-block:: bash + .. code-block:: bash - sudo parted + sudo parted #. In the `parted` tool, perform these steps: - #. Press :command:`p` to print the partitions table. - #. If the warning message below is displayed, enter :command:`Fix`. + #. Press :command:`p` to print the partitions table. + #. If the warning message below is displayed, enter :command:`Fix`. - .. code-block:: console + .. code-block:: console - Warning: Not all of the space available to /dev/sda appears to be - used, you can fix the GPT to use all of the space (an extra ... - blocks) or continue with the current setting? + Warning: Not all of the space available to /dev/sda appears to be + used, you can fix the GPT to use all of the space (an extra ... + blocks) or continue with the current setting? - Fix/Ignore? + Fix/Ignore? - #. Enter :command:`resizepart [partition number]` where - *[partition number]* is the partition number to modify. - #. Enter :command:`yes` when prompted. - #. Enter the new `End` size. + #. Enter :command:`resizepart [partition number]` where + *[partition number]* is the partition number of the partition to modify. + #. Enter :command:`yes` when prompted. + #. Enter the new `End` size. - .. note:: + .. note:: - If you want a partition to take up the remaining disk space, then - enter the total size of the disk. When you print the partitions - table with the :command:`p` command, the total disk size is shown - after the `Disk` label. + If you want a partition to take up the remaining disk space, then + enter the total size of the disk. When you print the partitions + table with the :command:`p` command, the total disk size is shown + after the `Disk` label. - #. Enter :command:`q` to exit `parted` when you are finished resizing the - image. + An example of this can be seen in Figure 1. + + + + #. Enter :command:`q` to exit `parted` when you are finished resizing the + image. + + +Figure 1 depicts the described steps to resize the partition of the virtual disk from 8.5GB to 20GB. + +.. figure:: figures/increase-virtual-disk-size-1.png + :scale: 100 % + :alt: Increase root partition size + + Figure 1: Increase root partition size. Resize the filesytem -------------------- -#. Enter :command:`sudo resize2fs -p /dev/[modified partition name]` where - *[modified partition name]* is the partition that was changed in `parted`. +#. Enter :command:`sudo resize2fs -p /dev/[modified partition name]` where + *[modified partition name]* is the partition that was changed in `parted`. -Figure 1 shows how to increase the size of a |CL| Hyper-V image from 8.5 -GB to 20 GB. Before the steps shown in Figure 1, we used the Hyper-V Manager -to increase the VM virtual disk size from 8.5 GB to 20 GB. +#. Run the :command:`df -h` to verify that the filesystem size has increased. -.. figure:: figures/increase-virtual-disk-size-1.png - :scale: 100 % - :alt: Increase root partition size example +Figure 2 depicts the described steps to resize the partition of the virtual disk from 8.5GB to 20GB. - Figure 1: Increase root partition size example. +.. figure:: figures/increase-virtual-disk-size-2.png + :scale: 100 % + :alt: Increase root filesystem with resize2fs + + Figure 2: Increase root filesystem size after partition has been expanded. .. _releases: https://download.clearlinux.org/releases/