← Back to branch summary

~openstack-charm-testers/openstack-charm-testing/openstack-monitoring

« back to all changes in this revision

Viewing changes to README-ipv6.md

  • Committer: Edward Hope-Morley
  • Date: 2016-06-28 12:08:43 UTC
  • mto: This revision was merged to the branch mainline in revision 217.
  • Revision ID: edward.hope-morley@canonical.com-20160628120843-mawgxjz1i9uxgbtr
fixes

Show diffs side-by-side

added added

removed removed

Lines of Context:
README-ipv6.md
1
 
IPv6 Charm Test Deployment Tools
2
 
=====
3
 
The Openstack charms support deploying on IPv6 networks.
 
1
Openstack Charms with IPv6
 
2
==========================
 
3
How to deploy Openstack charms on an IPv6 network.
4
4
 
5
5
NOTE[0]: the percona-cluster charm includes a workaround for bug 1380747 which
6
6
         is intended to be removed once this issue is fixed upstream.
9
9
         which only exists in distro as of Ubuntu Wily (Openstack Liberty).
10
10
 
11
11
Requirements
12
 
=====
 
12
============
13
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 emulate ipv6 address
15
 
assignment which will give you something similar to:
16
 
 
 
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
```
17
18
eth0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1400 qdisc pfifo_fast state UP group default qlen 1000
18
19
    link/ether fa:16:3e:d3:99:81 brd ff:ff:ff:ff:ff:ff
19
20
    inet 10.5.0.77/16 brd 10.5.255.255 scope global eth0
22
23
       valid_lft 86147sec preferred_lft 14147sec
23
24
    inet6 fe80::f816:3eff:fed3:9981/64 scope link 
24
25
       valid_lft forever preferred_lft forever
25
 
 
26
 
NOTE: ensure that ipv6 privacy extension is DISABLED since the charms do not
27
 
support this feature.
 
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.
28
30
 
29
31
Configuring RADVD
30
 
============
 
32
=================
31
33
 
32
34
1) Install
33
35
 
35
37
 
36
38
2) Set gateway address (assuming eth0 throughout here)
37
39
 
38
 
    sudo ip addr add 2001:db8:0:1::1/64 dev eth0
 
40
    sudo ip addr add 2001:db8:0:1::2/64 dev eth0
39
41
 
40
42
3) Configure
41
43
 
54
56
       };
55
57
    };
56
58
 
57
 
4) service radvd restart
58
 
 
59
 
5) Make sure that IPv6 forwarding is on
60
 
 
61
 
    Uncomment "net.ipv6.conf.all.forwarding=1" in /etc/sysctl.conf
62
 
 
 
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
```
63
66
6) Let IPv6 pass through the firewall
64
 
 
 
67
```
65
68
    sudo ip6tables -F
66
 
 
 
69
```
67
70
7) If you are deploying to Openstack, make sure your nova/neutron security
68
 
   group rules are allowing Ingress ICMP and TCP
 
71
   group rules are allowing Ingress ICMP and TCP (./tools/sec_groups.sh)
69
72
 
70
73
 
71
74
Deploying the charms
72
 
====
73
 
 
74
 
  next.yaml - deploys charms as HA ipv6 from /next branches
75
 
 
76
 
1) Using one of the above do:
77
 
 
78
 
    juju-deployer -c next.yaml -d trusty-liberty
79
 
 
80
 
2) Once complete, run ./configure <profile>
81
 
 
82
 
3) You can then run tests found in the tests/ directory
 
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
83
92