typo
[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 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
21 Run install scripts:
22
23 # ls install/
24 1-enable-ext-template.sh  2-create-log-directory.sh  3-lvm-wrappers.sh
25
26
27 Cron helper can be install under /etc/cron.daily
28
29 # ls cron/
30 daily-block-snapshot  purge-log
31
32
33 Overview commands are available (try running them to see output):
34
35 # ls bin/
36 adopt  backup  ill  instance  list  node
37
38 backup and instance are wrappers for running gnt-* commands
39 with same name on master node
40
41 adopt will create new zvol using send/receive to break dependency on origin
42 (otherwise, removal of origin zvol will also remove new adopted disk
43
44
45 Create test instances:
46
47 # ls t/*.sh
48 t/drbd.sh  t/plain.sh  t/zfs.sh
49
50 Review that instaces have been created:
51
52 # ./bin/ill t-
53
54 Test ganeti commands after reading them:
55
56 # ls t/gnt-*
57 t/gnt-backup-export.sh  t/gnt-instance-modify.sh
58
59
60 DRBD disk replication
61
62 Ganeti's extstorage provider doesn't support drbd target.  But, lvm emulation
63 scripts are sufficiant enough to create -t drbd instance or convert plain
64 (created on zfs thanks to wrappers ;-) to drbd.
65
66
67 KNOWN BUGS for extstorage
68
69 - gnt-backup export doesn't work because snapshoot hooks are not available
70 - gnt-instance move works from somewhere to zfs, but not from zfs to somewhere
71