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 a700a7d9..0436d965 100644 --- a/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst +++ b/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst @@ -1,6 +1,6 @@ .. _increase-virtual-disk-size: -Increase virtual disk size of a Clear Linux image +Increase virtual disk size of a Clear Linux\* image ################################################# |CLOSIA| prebuilt images come in different sizes, ranging from 300 MB to 20 @@ -9,17 +9,14 @@ if you need more capacity. .. contents:: This guide will cover: - Determine the partition order and sizes of the prebuilt image *************************************************** -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 -has a disk size of 8.5 GB with /dev/sda3 being the partition -for the root filesystem (/) +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 has a disk size of 8.5 GB with / +dev/sda3 being the partition for the root filesystem (/) Checking :command:`lsblk` on the VM ----------------------------------- @@ -27,66 +24,64 @@ 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 +.. code-block:: console - NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT - sda 8:0 0 8.5G 0 disk - ├─sda1 8:1 0 512M 0 part - ├─sda2 8:2 0 32M 0 part [SWAP] - └─sda3 8:3 0 8G 0 part / + NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT + sda 8:0 0 8.5G 0 disk + ├─sda1 8:1 0 512M 0 part + ├─sda2 8:2 0 32M 0 part [SWAP] + └─sda3 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 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: +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: -#. Go to the `releases`_ repository. -#. Drill down into the `20450 > clear > config > image` directory. -#. Open the :file:`hyperv-config.json` file. -#. Locate the `PartitionLayout` key. +#. Go to the `releases`_ repository. +#. 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. + 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 - - "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 of the disk, partition, and filesystem. - +Once you have determined the disk and partition to be increased, you are +ready to perform the actual increase of the disk, partition, and filesystem. Power off VM and increase virtual disk size: -------------------------------------------- -To increase the virtual disk size for a prebuilt image, perform the steps below: +To increase the virtual disk size for a prebuilt image, perform the steps +below: #. Shut down your VM if it is running. #. Use the process defined by your hypervisor @@ -100,77 +95,75 @@ 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 :command:`parted` and :command:`resize2fs` tools. +#. 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. +#. Launch the `parted` tool. - .. code-block:: bash + .. code-block:: bash - sudo parted + sudo parted -#. In the `parted` tool, perform these steps: +#. 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 of the partition 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. - An example of this can be seen in Figure 1. + 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. - #. 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. + .. 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`. - #. Run the :command:`df -h` to verify that the filesystem size has increased. +#. Run the :command:`df -h` to verify that the filesystem size has + increased. - Figure 2 depicts the described steps to resize the partition of the virtual disk from 8.5GB to 20GB. + Figure 2 depicts the described steps to resize the partition of the virtual disk from 8.5GB to 20GB. - .. figure:: figures/increase-virtual-disk-size-2.png - :scale: 100 % - :alt: Increase root filesystem with resize2fs + .. 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. + Figure 2: Increase root filesystem size after partition has been expanded. - .. _releases: https://download.clearlinux.org/releases/ +Congratulations! You have resized the disk, partition, and filesystem. At +this point, the increase in disk capacity is usable. - -Congratulations! You have resized the disk, partition, and filesystem. At this point, the increase in disk capacity is usable. \ No newline at end of file +.. _releases: https://download.clearlinux.org/releases/ \ No newline at end of file