lvm guide

goharbor · Nov 28, 2016 · d01bb30 · d01bb30
1 parent 0c9c258
commit d01bb30
Show file tree

Hide file tree

Showing 10 changed files with 91 additions and 0 deletions.
diff --git a/docs/expand_hard_disk.md b/docs/expand_hard_disk.md
@@ -0,0 +1,91 @@
+# Expand the Hard Disk of Virtual Appliance
+
+If you install Harbor with OVA, the persistent data(such as images and database) is stored in a hard disk which is mounted on directory "/data", and the default size is 50GB. As more and more images are pushed into it, the capacity may not meet your requirements. You can refer to this guide to expand the size of the hard disk.  
+
+1. Add New Hard Disk to VM  
+
+	(1) Log in vSphere web client. Power off Harbor's virtual appliance.  
+	(2) Right click on the VM and select "Edit Settings".  
+	(3) Select "New Hard Disk", and click "OK".  
+	(4) Power on the VM.  
+
+2. Expand Hard Disk using LVM  
+
+	Login from the console of the virtual appliance and run the following commands:  
+
+	(1) Check the current size of "/data":  
+	```sh
+	df -h /data
+	```
+
+	![lvm](img/lvm/size_of_data_01.png)
+
+	(2) Find the new hard disk, e.g. "/dev/sdc". Replace all "/dev/sdc" with your disk in the following commands.  
+	```sh
+	fdisk -l
+	```
+
+	![lvm](img/lvm/find_the_new_harddisk.png)
+
+	(3) Create new physical volume:  
+	```sh
+	pvcreate /dev/sdc
+	```
+
+	(4) Check the volume group:  
+	```sh
+	vgdisplay
+	```
+
+	![lvm](img/lvm/vg_01.png)
+
+	(5) Expand the volume group:
+	```sh
+	vgextend data1_vg /dev/sdc
+	```
+
+	(6) Check the volume group again:  
+	```sh
+	vgdisplay
+	```
+
+	![lvm](img/lvm/vg_02.png)
+
+	(7) Check the logical volume:
+	```sh
+	lvdisplay
+	```
+
+	![lvm](img/lvm/lv_01.png)
+
+	(8) Resize the logical volume:  
+	```sh
+	lvresize -l +100%FREE /dev/data1_vg/data
+	```
+
+	![lvm](img/lvm/resize_lv.png)
+
+	(9) Check the logical volume again, note the change of "LV Size":
+	```sh
+	lvdisplay
+	```
+
+	![lvm](img/lvm/lv_02.png)
+
+	(10) Resize the file system:
+	```sh
+	resize2fs /dev/data1_vg/data
+	```
+
+	(11) Check the size "/data" again:
+	```sh
+	df -h /data
+	```
+
+	![lvm](img/lvm/size_of_data_02.png)
+
+	You can also check the size on Harbor web UI by clicking on the admin's name at the upper left corner and selecting "About" from the drop-down menu if you log in with an admin user:
+
+	![lvm](img/lvm/check_on_ui.png)
+
+After that, your disk should be expanded successfully. If you want to add more hard disks, do the steps again.
diff --git a/docs/img/lvm/check_on_ui.png b/docs/img/lvm/check_on_ui.png
diff --git a/docs/img/lvm/find_the_new_harddisk.png b/docs/img/lvm/find_the_new_harddisk.png
diff --git a/docs/img/lvm/lv_01.png b/docs/img/lvm/lv_01.png
diff --git a/docs/img/lvm/lv_02.png b/docs/img/lvm/lv_02.png
diff --git a/docs/img/lvm/resize_lv.png b/docs/img/lvm/resize_lv.png
diff --git a/docs/img/lvm/size_of_data_01.png b/docs/img/lvm/size_of_data_01.png
diff --git a/docs/img/lvm/size_of_data_02.png b/docs/img/lvm/size_of_data_02.png
diff --git a/docs/img/lvm/vg_01.png b/docs/img/lvm/vg_01.png
diff --git a/docs/img/lvm/vg_02.png b/docs/img/lvm/vg_02.png