document helper scripts in bin/
[ganeti-extstorage-zfs] / README
1 Ganet 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 has 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 You need to specify zfs filesystem under which block devices will be created.
15
16 Now ssh into ganeti master node and do following:
17
18 1. enable new disk template
19
20   gnt-cluster modify --enabled-disk-templates plain,drbd,ext \
21         --ipolicy-disk-templates plain,drbd,ext
22
23 2. create log directory
24
25   mkdir /var/log/ganeti/extstorage
26
27 3. try instance creation with something similar to
28
29   gnt-instance add -t ext --disk=0:size=10G,provider=zfs \
30         --net 0:mode=bridged,link=br1001 \
31         --net 1:mode=bridged,link=br0060 \
32         --net 2:mode=bridged,link=br0080 \
33         --no-name-check --no-ip-check \
34         -o debootstrap+default \
35         -B maxmem=1G -n arh-hw zfs
36
37 4. install helper scripts for daily block snapshots
38
39   ln -sf /usr/share/ganeti/extstorage/zfs/bin/daily-block-snapshot /etc/cron.daily/
40
41
42 HELPER SCRIPTS
43
44 Helper scripts in bin directory to list volumes, show size or snapshots.
45
46
47 KNOWN BUGS
48
49 - in current ganeti, gnt-backup export doesn't work because extstorage
50   snapshoot hook is not available