Resize disks offline for Linux instances

Step 1: Create a snapshot

Before you resize a disk online, you must create a snapshot for the disk to back up the data stored in the disk.

1. Log on to the ECS console.
2. In the left-side navigation pane, choose Instances & Images > Instances.
3. In the top navigation bar, select a region.
4. Find the instance whose disk you want to resize and click the instance ID.
5. On the Instance Details page, click the Cloud Disk tab.
6. Find the disk that you want to resize and click Create Snapshot in the Actions column.
7. In the Create Snapshot dialog box, enter a snapshot name, configure tags, and then click Create.
8. Click the Snapshot tab to view the snapshot.
   When the snapshot is created, 100% appears in the Progress column that corresponds to the snapshot. You can proceed to perform subsequent operations.

Step 2: Resize the disk and start or restart the instance in the ECS console

1. On the Instance Details page, click the Cloud Disk tab.
2. Find the disk that you want to resize and choose More > Resize Disk in the Actions column.
   If you want to batch resize disks, log on to the ECS console by using your Alibaba Cloud account and choose Storage & Snapshots > Disks in the left-side navigation pane. On the Disks page, select the disks that you want to resize and click Resize Disk in the lower part of the page. Disks that are attached to the same instance cannot be resized together.

   Note Alibaba Cloud accounts are permitted to batch resize disks but Resource Access Management (RAM) users are not. Log on to the ECS console by using your Alibaba Cloud account.
3. On the Resize Disks page, set the Size after Resize parameter.
   The specified Size after Resize value must be greater than the current disk capacity.
4. Verify the price, read and select ECS Service Terms, and then click Confirm.
5. Read the notes, click I have read the notes. Resize, and then complete the payment.
6. Start or restart the instance in the ECS console.
   Note

   • If your instance is in the Running (Running) state, you must restart the instance in the ECS console. If your instance is in the Stopped (Stopped) state, you must start the instance in the ECS console.
   • The disk resizing operation takes effect only after you start or restart the instance by using the ECS console or by calling the RebootInstance operation. If you restart the instance from within the operating system, the disk resizing operation does not take effect.
   • The offline disk resizing operation takes effect only after you start or restart the instance. If you have resized a disk offline but cannot start or restart the instance due to business requirements, you can resize the disk online again to make the offline resizing operation take effect when the instance is in the Running state. You are charged for resizing the disk online. You must resize the disk based on your business requirements. For more information, see What do I do if I have resized a disk offline but do not want to restart the instance?.

   The following procedure describes how to restart an instance.

   1. In the left-side navigation pane, choose Instances & Images > Instances.
   2. On the Instances page, find the instance that you want to restart and choose More > Instance Status > Restart in the Actions column.
   3. In the Restart Instance dialog box, click OK.

Step 3: View the disk partitions

You can log on to the instance to view the partition types (such as MBR and GPT) and file system types (such as ext4 and XFS) of the system disk and data disks. Subsequent resizing operations vary based on the partition and file system types of the disks.

1. Log on to the instance. For more information, see Connect to a Linux instance by using password authentication.
2. Run the following command to view the disks attached to the instance:

   fdisk -lu

   The following command output shows the /dev/vda1 partition of the system disk and the /dev/vdb1 and /dev/vdc1 partitions of data disks.

   No.	Partition	Description
   ①	/dev/vda1	A partition of the system disk. A value of Linux for System indicates that the partition is in the MBR format.
   ②	/dev/vdb1	A partition of a data disk. A value of Linux for System indicates that the partition is in the MBR format.
   ③	/dev/vdc1	A partition of a data disk. A value of GPT for System indicates that the partition is in the GPT format.

   Note If the capacity of the system disk (/dev/vda) in the command output is still 40 GiB (Disk /dev/vda: 42.9 GB), the disk was not resized. We recommend that you restart the instance in the ECS console.
3. Run the following command to check the file system types of existing partitions:

   df -Th

   A command output similar to the following one is returned. In the command output, the Mounted on column lists the mount points that correspond to the file systems.

   

Step 4: Resize partitions

When you view the partitions of a resized disk, you may find that the partitions and file systems within the instance were not resized. This step describes how to resize the partitions of the resized disk within the instance.

1. Install the gdisk tool on the instance.
   If the partitions are in the GPT format, you must perform this step. If the partitions are in the MBR format, skip this step.

   yum install gdisk -y

2. Install the growpart tool.
   • If the instance runs an Alibaba Cloud Linux 2 or 3 operating system or a CentOS 7 or later operating system, run the following command:

     yum install -y cloud-utils-growpart

   • If the instance runs a Debian 8 or later operating system or a Ubuntu 14 or later operating system, run the following commands.

     Run the following command to update the software repository:

     apt-get update

     Run the following command to install cloud-guest-utils:

     apt-get install -y cloud-guest-utils

3. Run the following command to resize partitions:

   growpart /dev/vda 1

   In this example, the first partition of the system disk is resized. /dev/vda is the system disk and 1 is the partition number. Use a space to separate /dev/vda from1. Modify the command accordingly to resize other partitions.

   • Run the following command to resize the /dev/vdb data disk:

     growpart /dev/vdb 1

   • Run the following command to resize the /dev/vdc data disk:

     growpart /dev/vdc 1

   Note

   • If a single disk has successive partitions, you need only to resize the last partition to resize the disk. For example, the /dev/vdb data disk has three partitions named /dev/vdb1, /dev/vdb2, and /dev/vdb3, you can run the growpart /dev/vdb 3 command to resize the /dev/vdb data disk.
   • When you run the growpart /dev/vda 1 command, the unexpected output in sfdisk --version [sfdisk, from util-linux 2.23.2] error may appear. For information about how to troubleshoot this issue, see the "FAQ" section of this topic.

Step 5: Resize file systems

This step describes how to resize the file systems of partitions within the instance.

1. Resize the file systems within the instance based on the file system types that you obtained.
   • To resize ext* (such as ext4) file systems, run the following commands.
     To resize the file system of the /dev/vda1 partition of the system disk, run the following command:

     resize2fs /dev/vda1    

     To resize the file system of the /dev/vdb1 partition of a data disk, run the following command:

     resize2fs /dev/vdb1          

     Note /dev/vda1 and /dev/vdb1 are partition names. Replace them with the names of your partitions.
   • To resize the xfs file system of the /dev/vdc1 partition of a data disk, run the following command:

     xfs_growfs /media/vdc

     Note /media/vdc is the mount point of the /dev/vdc1 partition. Replace it with the mount point of your partition.
   • To resize the btrfs file system of a data disk, run the following command:

     btrfs filesystem resize max /mountpoint

     Note /mountpoint is the mount point of the data disk. Replace it with the mount point of your data disk.
2. Run the following command to check the resize results:

   df -Th

   A command output similar to the following one is returned.

   
   After you resize the file systems, check whether their actual sizes are consistent with the new specified values.

   • If the file system sizes are increased to the new specified values and the business programs on the instance can run normally, the resize operation is complete.
   • If the file system sizes are not increased to the new specified values, use the snapshot that you created in Step 1 to roll back the disk.

FAQ

• Question: When the growpart /dev/vda 1 command is run on the Linux instance, the unexpected output in sfdisk --version [sfdisk, from util-linux 2.23.2] error appears. What do I do?
  Answer:

  1. Run the locale command to check the character encoding type of the instance. If the character encoding type is not en_US.UTF-8, switch it to en_US.UTF-8.
     1. Run the following command to switch the character encoding type:

        LANG=en_US.UTF-8

     2. If the problem still persists, run the following command to switch the character encoding type:

        export LC_ALL=en_US.UTF-8

     3. If the problem still persists, run the following command to switch the character encoding type:

        localectl set-locale LANG=en_US.UTF-8

     4. If the preceding solutions do not resolve the problem, run the following command to switch the character encoding type:

        export LANGUAGE=en_US.UTF-8

  2. If the problem still persists, run the reboot command to restart the instance.

  Notice

  If the partition is resized after you switch the character encoding type, we recommend that you switch it back to the original character encoding type.

• Question: When the growpart /dev/vda 1 command is run on the Linux instance, the -bash: growpart: command not found error appears. What do I do?
  Answer:

  1. Run the uname -a command to check the version of the Linux kernel. The procedure described in this topic applies to Linux kernel 3.6.0 and later.

     If the version of the Linux kernel is earlier than 3.6.0, you must resize the partitions of disks after you resize the disks. For more information, see Procedure for instances with kernels earlier than 3.6.0 and Resize partitions and file systems of Linux data disks.

  2. Install the growpart tool.
     • If the instance runs a CentOS 7 or later operating system, run the following command:

       yum install -y cloud-utils-growpart

     • If the instance runs a Debian 8 or later operating system or an Ubuntu 14 or later operating system, run the following command:

       apt install -y cloud-guest-utils

• Question: The growpart tool used to resize partitions cannot be installed on CentOS 6.5. Why?
  Answer: The Linux kernel version of CentOS 6 is earlier than 3.6.0. To install the growpart tool on CentOS 6, perform the following steps:

  1. Change the YUM repository address for CentOS 6. For more information, see Change the CentOS 6 source address.
     Note CentOS 6 has reached its end of life (EOL). To use YUM to install CentOS software packages, you must change the YUM repository address for CentOS 6.
  2. Install the dracut-modules-growroot tool on the instance that runs a CentOS 6 operating system to resize the partitions of disks. For more information, see Procedure for instances with kernels earlier than 3.6.0.

Other scenarios for disk resizing

• If you want to create partitions on a resized data disk, see Option 2: Create and format MBR partitions or Option 4: Create and format GPT partitions.
• If a raw data disk contains a file system but no partitions, see Option 5: Resize the file system of a raw data disk.