X-Git-Url: http://git.rot13.org/?a=blobdiff_plain;f=README;h=b0ba03abec4f9f025bf4af9fba9f3024c187022d;hb=c4be5618a6eb1b7b9e19016f02e71871050e3b8c;hp=5765b930965a6b759c381f725e629df456566e6c;hpb=c2088f86938412377e0c5cc900982221381094a0;p=ganeti-extstorage-zfs

diff --git a/README b/README
index 5765b93..b0ba03a 100644
--- a/README
+++ b/README
@@ -1,5 +1,7 @@
 Ganet extstorage provider for local zfs volumes
 
+http://docs.ganeti.org/ganeti/master/html/man-ganeti-extstorage-interface.html
+
 INSTALLATION
 
 On node which has zfs storage pool
@@ -25,7 +27,63 @@ Now ssh into ganeti master node and do following:
 3. try instance creation with something similar to
 
   gnt-instance add -t ext --disk=0:size=10G,provider=zfs \
-	--disk=1:size=20G,provider=zfs \
-	-n arh-hw --no-name-check --no-ip-check \
-	-o debootstrap+default -B maxmem=512M zfs-ext-test
+	--net 0:mode=bridged,link=br1001 \
+	--net 1:mode=bridged,link=br0060 \
+	--net 2:mode=bridged,link=br0080 \
+	--no-name-check --no-ip-check \
+	-o debootstrap+default \
+	-B maxmem=1G -n arh-hw zfs
+
+4. install helper scripts for daily block snapshots
+
+  ln -sf /usr/share/ganeti/extstorage/zfs/bin/daily-block-snapshot /etc/cron.daily/
+
+5. install lvm wrapper scripts to report zfs volumes as lv
+
+  find /usr/share/ganeti/extstorage/zfs/sbin/ -type f | xargs -i ln -v -s -f {} /sbin/
+
+This scripts enable gnt-node commands to work:
+
+root@vmh02:/home/dpavlin# gnt-node list arh-hw
+Node               DTotal DFree MTotal MNode MFree Pinst Sinst
+arh-hw.gnt.ffzg.hr  87.8G 87.2G   7.8G  252M  5.6G     1     0
+
+root@vmh02:/home/dpavlin# gnt-node list-storage arh-hw
+Node               Type   Name     Size  Used   Free Allocatable
+arh-hw.gnt.ffzg.hr lvm-vg arh-hw 190.0G 62.7G 127.3G Y
+arh-hw.gnt.ffzg.hr lvm-vg ffzgvg  87.8G  610M  87.2G Y
+
+
+HELPER SCRIPTS
+
+Helper scripts in bin directory list volumes, show size or snapshots.
+
+
+arh-hw:/usr/share/ganeti/extstorage/zfs# ./bin/list 
+NAME                                                           USED  AVAIL  REFER  MOUNTPOINT
+tmp500g/block                                                  612M  87.2G    30K  /tmp500g/block
+tmp500g/block/af1a90e8-0566-4cbf-bc8c-99fc82b67ce3.ext.disk0   612M  87.2G   610M  -
+
+
+arh-hw:/usr/share/ganeti/extstorage/zfs# ./bin/size 
+NAME                                                          PROPERTY  VALUE    SOURCE
+tmp500g/block/af1a90e8-0566-4cbf-bc8c-99fc82b67ce3.ext.disk0  volsize   11G      local
+
+
+arh-hw:/usr/share/ganeti/extstorage/zfs# ./bin/snapshots 
+NAME                                                                      USED  AVAIL  REFER  MOUNTPOINT
+tmp500g/block@etckeeper                                                      0      -    30K  -
+tmp500g/block/af1a90e8-0566-4cbf-bc8c-99fc82b67ce3.ext.disk0@2014-06-24  2.64M      -   610M  -
+
+
+DRBD disk replication
+
+Ganti's extstorage provider doesn't support drbd target. But, lvm emulation scripts are sufficiant enough
+to create -t drdb instance or convert plain (created on zfs thanks to wrappers ;-) to drdb.
+
+
+KNOWN BUGS
 
+- in current ganeti, gnt-backup export doesn't work because extstorage
+  snapshoot hook is not available
+- gnt-instance move works from somewhere to zfs, but not from zfs to somewhere