Signed-off-by: Hollie Teal <hollie@docker.com>
| ... | ... |
@@ -5,25 +5,29 @@ page_keywords: boot2docker, volume, virtualbox |
| 5 | 5 |
# Getting “no space left on device” Errors with Boot2Docker? |
| 6 | 6 |
|
| 7 | 7 |
If you're using Boot2Docker with a large number of images, or the images you're working |
| 8 |
-with are very large, you might run into trouble if the Boot2Docker VM's volume runs out of |
|
| 9 |
-space. The solution is to increase the volume size by first cloning it, then resizing it |
|
| 10 |
-using a disk partitioning tool. We'll use [GParted](http://gparted.sourceforge.net/download.php/index.php) |
|
| 8 |
+with are very large, your pulls might start failing with "no space left on device" errors when |
|
| 9 |
+the Boot2Docker VM's volume runs out of space. The solution is to increase the volume size by |
|
| 10 |
+first cloning it, then resizing it using a disk partitioning tool. |
|
| 11 |
+ |
|
| 12 |
+We'll use [GParted](http://gparted.sourceforge.net/download.php/index.php) |
|
| 11 | 13 |
since it's a free ISO and works well with VirtualBox. |
| 12 | 14 |
|
| 13 | 15 |
## 1. Stop Boot2Docker’s VM |
| 14 | 16 |
|
| 15 |
- $ boot2docker stop |
|
| 17 |
+Issue the command to stop the Boot2Docker VM on the command line: |
|
| 16 | 18 |
|
| 17 |
-Boot2Docker ships with a VMDK image, which can’t be resized by VirtualBox’s native tools. We will instead |
|
| 18 |
-create a VDI volume and clone the VMDK volume to it. |
|
| 19 |
+ $ boot2docker stop |
|
| 19 | 20 |
|
| 20 | 21 |
## 2. Clone the VMDK image to a VDI image |
| 21 | 22 |
|
| 23 |
+Boot2Docker ships with a VMDK image, which can’t be resized by VirtualBox’s native tools. We will |
|
| 24 |
+instead create a VDI volume and clone the VMDK volume to it. |
|
| 25 |
+ |
|
| 22 | 26 |
Using the command line VirtualBox tools, clone the VMDK image to a VDI image: |
| 23 | 27 |
|
| 24 | 28 |
$ vboxmanage clonehd /full/path/to/boot2docker-hd.vmdk /full/path/to/<newVDIimage>.vdi -—format VDI -—variant Standard |
| 25 | 29 |
|
| 26 |
-## 3. Resize the new clone volume |
|
| 30 |
+## 3. Resize the VDI volume you created |
|
| 27 | 31 |
|
| 28 | 32 |
Choose a size that will be appropriate for your needs. If you’re spinning up a lot of containers, |
| 29 | 33 |
or your containers are particularly large, larger will be better: |
| ... | ... |
@@ -33,21 +37,31 @@ or your containers are particularly large, larger will be better: |
| 33 | 33 |
## 4. Download a disk partitioning tool ISO |
| 34 | 34 |
|
| 35 | 35 |
To resize the volume, you'll need a disk partitioning tool like [GParted](http://gparted.sourceforge.net/download.php/). |
| 36 |
-Once you've downloaded the tool, add the ISO to the Boot2Docker VM’s IDE bus. You might need to |
|
| 37 |
-create the bus before you can add the ISO. |
|
| 38 |
- |
|
| 39 |
-<img src="/articles/b2d_volume_images/add_new_controller.png"></br> |
|
| 40 |
-<img src="/articles/b2d_volume_images/add_cd.png"> |
|
| 36 |
+Once you've downloaded the tool, add the ISO to the Boot2Docker VM’s IDE bus. |
|
| 37 |
+You might need to create the bus before you can add the ISO. **Note:** It's |
|
| 38 |
+important that the partitioning tool you choose is available as an ISO so that |
|
| 39 |
+the Boot2Docker VM can be booted with it. |
|
| 40 |
+ |
|
| 41 |
+<table> |
|
| 42 |
+ <tr> |
|
| 43 |
+ <td><img src="/articles/b2d_volume_images/add_new_controller.png"><br><br></td> |
|
| 44 |
+ </tr> |
|
| 45 |
+ <tr> |
|
| 46 |
+ <td><img src="/articles/b2d_volume_images/add_cd.png"></td> |
|
| 47 |
+ </tr> |
|
| 48 |
+</table> |
|
| 41 | 49 |
|
| 42 | 50 |
## 5. Add the new VDI image |
| 43 | 51 |
|
| 44 |
-to the Boot2Docker image in VirtualBox. |
|
| 52 |
+In the settings for the Boot2Docker image in VirtualBox, remove the VMDK image from |
|
| 53 |
+the SATA contoller and add the VDI image. |
|
| 45 | 54 |
|
| 46 | 55 |
<img src="/articles/b2d_volume_images/add_volume.png"> |
| 47 | 56 |
|
| 48 | 57 |
## 6. Verify the boot order |
| 49 | 58 |
|
| 50 |
-In the **System** settings for the Boot2Docker VM, make sure that **CD/DVD** is the at the top of the **Boot Order** list. |
|
| 59 |
+In the **System** settings for the Boot2Docker VM, make sure that **CD/DVD** is at |
|
| 60 |
+the top of the **Boot Order** list. |
|
| 51 | 61 |
|
| 52 | 62 |
<img src="/articles/b2d_volume_images/boot_order.png"> |
| 53 | 63 |
|
| ... | ... |
@@ -57,14 +71,23 @@ Manually start the Boot2Docker VM, and the disk partitioning ISO should start up |
| 57 | 57 |
Using GParted, choose the **GParted Live (default settings)** option. Choose the |
| 58 | 58 |
default keyboard, language, and XWindows settings, and the GParted tool will start |
| 59 | 59 |
up and display the new VDI volume you created. Right click on the VDI and choose |
| 60 |
-**Resize/Move**. Drag the slider representing the volume to its maximum size, click |
|
| 61 |
-**Resize/Move**, and then **Apply**. Quit GParted and shut down the VM. Remove |
|
| 62 |
-the GParted ISO from the IDE controller for the Boot2Docker VM in VirtualBox. |
|
| 60 |
+**Resize/Move**. |
|
| 61 |
+ |
|
| 62 |
+<img src="/articles/b2d_volume_images/gparted.png"> |
|
| 63 |
+ |
|
| 64 |
+Drag the slider representing the volume to its maximum size, click **Resize/Move**, |
|
| 65 |
+and then **Apply**. |
|
| 66 |
+ |
|
| 67 |
+<img src="/articles/b2d_volume_images/gparted2.png"> |
|
| 68 |
+ |
|
| 69 |
+Quit GParted and shut down the VM. Remove the GParted ISO from the IDE controller for |
|
| 70 |
+the Boot2Docker VM in VirtualBox. |
|
| 63 | 71 |
|
| 64 | 72 |
## 8. Start the Boot2Docker VM |
| 65 | 73 |
|
| 66 |
-Either directly in VirtualBox or using the command line (`boot2docker start`), start the Boot2Docker |
|
| 67 |
-VM to make sure the volume changes took effect. |
|
| 74 |
+Fire up the Boot2Docker VM manually in VirtualBox. The VM should log in automatically, but the credentials are ``docker/tcuser`` if it doesn't. Using the ``df -h`` command, verify that your changes took effect. |
|
| 75 |
+ |
|
| 76 |
+<img src="/images/b2d_volume_images/verify.png"> |
|
| 68 | 77 |
|
| 69 | 78 |
You’re done! |
| 70 | 79 |
|