126

I have an EBS backed Amazon EC2 instance. I would like to change the root device on this instance. Can you please advise the best way to go about this?

I only find documentation on changing several attributes of block devices, but they don't seem to include setting it as the root device.

1
  • If you are using AWS web-based console, your instance doesn’t have any other volumes attached, and you are not sure what device ID you are supposed to use for boot volume, you can just attach a volume to your instance without specifying any ID and start the instance. AWS console will complain that there’s nowhere to boot from and tell you which device ID you should use (in my case it was /dev/sda1). You can then detach the volume and reattach, this time specifying that device ID. Jan 11, 2021 at 7:56

8 Answers 8

229

Yep, it's dead easy:

  1. Stop the instance.
  2. Detach the root EBS volume.
  3. Attach the alternate EBS volume as the root: /dev/sda1 or /dev/xvda (based on AMI used)
  4. Start the instance.

This presupposes that your alternate EBS volume is bootable, of course - it has to contain the bootable OS image.

20
  • 57
    The key is "as the root" -- /dev/sda1 indeed! Aug 31, 2012 at 13:47
  • 6
    Thanks, this is great. One gotcha is that the DNS/IP can change when this happens, so make sure to update any DNS / Elastic IPs, et cetera. I spent a while trying to figure out why I couldn't ssh into it anymore, and this was the reason.
    – mrooney
    Jan 17, 2013 at 22:54
  • 21
    Neither /dev/sda nor /dev/sda1 worked for me, but /dev/xvda did.
    – bhspencer
    Feb 5, 2015 at 14:37
  • 11
    Man, that was scary. /dev/sda -- didn't work. /dev/sda1, dev/sdf -- worked, but instance did't boot. /dev/xvda worked. May 18, 2016 at 18:41
  • 16
    The name which you should use is the result of this command: aws ec2 describe-instances --instance-id i-XXXXXXX | grep -i rootDeviceName in my case /dev/xvda
    – Neoecos
    Nov 29, 2016 at 23:44
49

I don't have enough rep to add a comment to the selected answer, but I do want to point out that for me, /dev/sda1 did not work (did not attach as root), but using /dev/xvda worked (attached as root). The instance is one of the newer t2.micro ones using HVM.

6
  • I think the machines which are in VPC, device names of format /dev/xv* itself works and you do not need to give names in format /dev/sd*. This is an observation - I am no expert to say this with confidence. Apr 10, 2015 at 10:45
  • I have an instance matching this description, which is unable to boot ("Unable to find root device") after detaching and reattaching the root device. I want to try this answer, but if I don't attach it as /dev/sda1 then AWS refuses to start my instance. Is there some other setting I need to configure to use an alternate root device name? Oct 2, 2015 at 18:43
  • /dev/sda1 for Linux /dev/xvda for Windows
    – Luis
    Oct 13, 2015 at 23:48
  • 1
    whoopse, make sure to identify the partition, /dev/sda 1, /dev/sda is invalid but /dev/sda1 is fine. Jun 17, 2016 at 3:39
  • And to add why it worked. this is why: superuser.com/questions/356533/….
    – human
    Nov 19, 2021 at 11:57
19

To elaborate on Diomidis Spinellis's comment in the the accepted answer's comments thread, it's important to check the filesystem label of the device you're attempting to switch in as your new root device. While troubleshooting my own server migration, I had to do the following before my instance would boot up:

Use the e2label command to change the label on the ext2/ext3/ext4 filesystem you've created for your new root device.

First, check the filesystem label for your current root device.

$ sudo e2label /dev/xvda1
cloudimg-rootfs

Set the new device to have the same filesystem label.

$ sudo e2label /dev/xvdg 'cloudimg-rootfs'

In my case, the label was cloudimg-rootfs. Sometimes it will simply be /.

It's important to understand how e2label works; check man e2label on your machine or visit http://linux.die.net/man/8/e2label for more information.

1
  • 1
    This is so incredibly important, I can't understand why this answer is not more commonly found.
    – ays0110
    Aug 26, 2016 at 7:40
6
  1. Stop the EC2 instance.
  2. On Navigation panel, click 'Volumes' under 'Elastic Block Store'.
  3. Choose the existing volume, click 'Actions' and 'Detach volume'. Complete the confirmation.
  4. Choose the new volume, click 'Actions' >> 'Attach volume'
    • In the Attach Volume dialogue box,
    • Instance: Enter Instance ID
    • Device: Enter /dev/sda1
1
  • 4
    Also note that the dialog implies that /dev/sda1 cannot be used, but ignore that and continue anyways, it works
    – Charles L.
    Oct 6, 2021 at 18:15
3

This is the aws suggested solution You can detach the root volume from the original instance after stopping it. The root volume is attached at /dev/sda1. Once this is detached, please attach it to the new instance. After the volume is attached, you may have to mount it from the OS. After it's mounted, you should see the data within it.

After you've done adding the new key, you can detach it and attach to the original instance at /dev/sda1.

I suggest creating a snapshot of the root volume before making any changes.

Before trying out any solutions just try out in the not important instances or spot instances

2

If you are wanting to do this via CloudFormation you will need to do the following:

  1. Create snapshot from existing root volume (via console or CLI)
  2. Create new AMI from this snapshot - increase the root volume size here, make sure you select correct virtualisation time (paravirtual or HVM).
  3. On your AWS::EC2::Instance resource, set the ImageId parameter to the new AMI you have just made

Deploy your stack. This will recreate your instance, so make sure you are using an Elastic IP address or have DNS access.

The reason you have to do this workaround is because CF will not let you adjust root volume size on EC2 BlockDeviceMappings, or to adjust SnapshotId of Root Volume.

0

When your volume is mounted, it gets a post-fix with numbers, eg: when /dev/sda is mounted, its mounted as /dev/sda1, /dev/sda2 depending on the partitions you make. As we are mounting the root device itself, it assumes the device is already mounted, so we need to give /dev/sda1 for mounting the volume as root device. Note: There shouldn't be any root volume attached.

Follow these steps: 1) Go to your volumes, select attach volumes from Action. 2) Select your instance 3) For mounting as root, give the device name as /dev/sda1 4) Start your instance.

0

Last week AWS announced new way to replacing Root volume with less downtime and Without Stop and Start EC2 instance. Please have a look below link. EC2 Replace Root Volume

Your Answer

Reminder: Answers generated by Artificial Intelligence tools are not allowed on Stack Overflow. Learn more

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge that you have read and understand our privacy policy and code of conduct.

Not the answer you're looking for? Browse other questions tagged or ask your own question.