update bin commands
[ganeti-extstorage-zfs] / 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 INSTALLATION
6
7 On node which will host zfs storage pool
8
9   cd /usr/share/ganeti/extstorage/
10   git clone https://github.com/ffzg/ganeti-extstorage-zfs zfs
11   cd zfs
12   vi defaults.sh
13
14 Run install scripts:
15
16 # ls install/
17 1-enable-ext-template.sh  2-create-log-directory.sh  3-lvm-wrappers.sh
18
19 Cron helper can be install under /etc/cron.daily
20
21 # ls cron/
22 daily-block-snapshot  purge-log
23
24 Overview commands are available (try running them to see output):
25
26 # ls bin/
27 adopt  backup  ill  instance  list  node
28
29 backup and instance are wrappers for running gnt-* commands
30 with same name on master node
31
32 Create test instances:
33
34 # ls t/*.sh
35 t/drbd.sh  t/plain.sh  t/zfs.sh
36
37 Review that instaces have been created:
38
39 # ./bin/ill t-
40
41 Test ganeti commands after reading them:
42
43 # ls t/gnt-*
44 t/gnt-backup-export.sh  t/gnt-instance-modify.sh
45
46
47 DRBD disk replication
48
49 Ganeti's extstorage provider doesn't support drbd target. But, lvm emulation scripts are sufficiant enough
50 to create -t drbd instance or convert plain (created on zfs thanks to wrappers ;-) to drbd.
51
52
53 KNOWN BUGS for extstorage
54
55 - gnt-backup export doesn't work because extstorage snapshoot hook are not available
56 - gnt-instance move works from somewhere to zfs, but not from zfs to somewhere
57
58
59 KNOWN BUGS for using -t plain on top of zfs
60
61 - cron/daily-block-snapshot snapshots are not correctly renamed
62 - bin/adopt will create new zvol using send/receive to break dependency on origin
63   (otherwise, deleting of origin file system will also delete new adopted instance)