← Back to branch summary

~openstack-charm-testers/+junk/cinder-backup

« back to all changes in this revision

Viewing changes to README-ipv6.md

  • Committer: Edward Hope-Morley
  • Date: 2016-11-25 09:32:24 UTC
  • mfrom: (172.1.83 openstack-charm-testing)
  • Revision ID: edward.hope-morley@canonical.com-20161125093224-dncneu9cljwslqyl
rebase

Show diffs side-by-side

added added

removed removed

Lines of Context:
README-ipv6.md
 
1
Openstack Charms with IPv6
 
2
==========================
 
3
How to deploy Openstack charms on an IPv6 network.
 
4
 
 
5
NOTE[0]: the percona-cluster charm includes a workaround for bug 1380747 which
 
6
         is intended to be removed once this issue is fixed upstream.
 
7
 
 
8
NOTE[1]: swift-proxy and neutron-gateway both require python-eventlet >= 0.17
 
9
         which only exists in distro as of Ubuntu Wily (Openstack Liberty).
 
10
 
 
11
Requirements
 
12
============
 
13
In order for IPv6 enabled charms to work, hosts much be configured with ipv6
 
14
addresses. For test purposes one case use radvd to automatically provide ipv6
 
15
addresses to nodes on your network so that you end up with something similar
 
16
to the following:
 
17
```
 
18
eth0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1400 qdisc pfifo_fast state UP group default qlen 1000
 
19
    link/ether fa:16:3e:d3:99:81 brd ff:ff:ff:ff:ff:ff
 
20
    inet 10.5.0.77/16 brd 10.5.255.255 scope global eth0
 
21
       valid_lft forever preferred_lft forever
 
22
    inet6 2001:db8:0:1:f816:3eff:fed3:9981/64 scope global dynamic 
 
23
       valid_lft 86147sec preferred_lft 14147sec
 
24
    inet6 fe80::f816:3eff:fed3:9981/64 scope link 
 
25
       valid_lft forever preferred_lft forever
 
26
```
 
27
NOTE: ensure that ipv6 privacy extensions are DISABLED since the charms do not
 
28
support this feature. Ubuntu server currently has them disabled by default and
 
29
desktop has them enabled.
 
30
 
 
31
Configuring RADVD
 
32
=================
 
33
 
 
34
1) Install
 
35
 
 
36
    sudo apt-get install radvd
 
37
 
 
38
2) Set gateway address (assuming eth0 throughout here)
 
39
 
 
40
    sudo ip addr add 2001:db8:0:1::2/64 dev eth0
 
41
 
 
42
3) Configure
 
43
 
 
44
    In /etc/radvd.conf:
 
45
 
 
46
    The prefix "2001:db8:0:1::/64" should be changed according to real network
 
47
    allocation e.g.
 
48
 
 
49
    interface eth0
 
50
    {
 
51
       AdvSendAdvert on;
 
52
       prefix 2001:db8:0:1::/64
 
53
       {
 
54
            AdvOnLink on;
 
55
            AdvAutonomous on;
 
56
       };
 
57
    };
 
58
 
 
59
4) sudo service radvd restart
 
60
 
 
61
5) Make sure ipv6 forwarding is enabled
 
62
```
 
63
    echo "net.ipv6.conf.all.forwarding = 1"| sudo tee /etc/sysctl.d/100-openstack-charms-ipv6.conf
 
64
    sudo sysctl -p /etc/sysctl.d/100-openstack-charms-ipv6.conf
 
65
```
 
66
6) Let IPv6 pass through the firewall
 
67
```
 
68
    sudo ip6tables -F
 
69
```
 
70
7) If you are deploying to Openstack, make sure your nova/neutron security
 
71
   group rules are allowing Ingress ICMP and TCP (./tools/sec_groups.sh)
 
72
 
 
73
 
 
74
Deploying the charms
 
75
====================
 
76
 
 
77
1) choose a bundle from:
 
78
 
 
79
  * bundles/ipv6/next-ipv6.yaml - deploys charms ipv6 from the development branches
 
80
  * bundles/ipv6/next-ipv6-ha.yaml - deploys charms as HA ipv6 from the development branches
 
81
 
 
82
2) Using one of the above do:
 
83
```
 
84
    juju-deployer -c <bundle> -d trusty-mitaka
 
85
```
 
86
 
 
87
3) Once complete, switch novarc to tools/ipv6/novarc and run ./configure <profile>
 
88
 
 
89
NOTE: if you are not deploying HA you'll need to set OS_AUTH_URL to the v6 address of your keystone unit
 
90
 
 
91
4) You can then run tests found in the tools/ipv6 directory
 
92