clearlinux/clear-linux-documentation
2
0
Fork 0
mirror of https://github.com/clearlinux/clear-linux-documentation.git synced 2026-08-25 01:06:37 +00:00
Code Issues Packages Projects Releases Wiki Activity

Fixes syntax on figures and code blocks for proper rendering.

Browse Source 
Signed-off-by: Michael Vincerra <michaelx.vincerra@intel.com>
This commit is contained in:
Michael Vincerra
2018-06-26 16:26:00 -07:00
parent a19a19e48d
commit 5b6c781c69
1 changed files with 83 additions and 90 deletions
Download Patch File Download Diff File Expand all files Collapse all files
source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst
+83 -90
View File
@@ -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.
.. _releases: https://download.clearlinux.org/releases/