git.rot13.org Git - ganeti-extstorage-zfs/blob - README

   1 Ganeti extstorage provider for local zfs volumes
   2
   3 http://docs.ganeti.org/ganeti/master/html/man-ganeti-extstorage-interface.html
   4
   5 It also encludes LVM emulation which enable zfs to work as plain disk type.
   6
   7 This allows usage of drbd where one (or both) sides are on zfs, and supports
   8 gnt-backup export and import.
   9
  10
  11 INSTALLATION
  12
  13 On node which will host zfs storage pool
  14
  15   cd /usr/share/ganeti/extstorage/
  16   git clone https://github.com/ffzg/ganeti-extstorage-zfs zfs
  17   cd zfs
  18   vi defaults.sh
  19
  20 Alternative to editing defaults.sh is to create etc/`hostname -s` file
  21 with minimal configuration which just specify pool name (in this case
  22 again hostname -s) and filesystem where new volumes will be created:
  23
  24   echo EXTP_ZFS=`hostname -s`/ffzgvg > etc/`hostname -s`.sh
  25
  26
  27 Run install scripts:
  28
  29 # ls install/
  30 1-enable-ext-template.sh  2-create-log-directory.sh  3-lvm-wrappers.sh
  31
  32
  33 Cron helper can be install under /etc/cron.daily
  34
  35 # ls cron/
  36 daily-block-snapshot  purge-log
  37
  38
  39 Overview commands are available (try running them to see output):
  40
  41 # ls bin/
  42 adopt  backup  ill  instance  list  node
  43
  44 backup and instance are wrappers for running gnt-* commands
  45 with same name on master node
  46
  47 adopt will create new zvol using send/receive to break dependency on origin
  48 (otherwise, removal of origin zvol will also remove new adopted disk
  49
  50
  51 Create test instances:
  52
  53 # ls t/*.sh
  54 t/drbd.sh  t/plain.sh  t/zfs.sh
  55
  56 Review that instaces have been created:
  57
  58 # ./bin/ill t-
  59
  60 Test ganeti commands after reading them:
  61
  62 # ls t/gnt-*
  63 t/gnt-backup-export.sh  t/gnt-instance-modify.sh
  64
  65
  66 DRBD disk replication
  67
  68 Ganeti's extstorage provider doesn't support drbd target.  But, lvm emulation
  69 scripts are sufficiant enough to create -t drbd instance or convert plain
  70 (created on zfs thanks to wrappers ;-) to drbd.
  71
  72
  73 KNOWN BUGS for extstorage
  74
  75 - gnt-backup export doesn't work because snapshoot hooks are not available
  76 - gnt-instance move works from somewhere to zfs, but not from zfs to somewhere
  77