summaryrefslogtreecommitdiffstats
path: root/docs/gapanalysis/gap-analysis-odl-beryllium.rst
blob: e77e7cc5063c86d8c2e181996bf03f36e54b5c43 (plain) 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57

.. This work is licensed under a Creative Commons Attribution 4.0 International License.
.. http://creativecommons.org/licenses/by/4.0
.. (c) Bin Hu (AT&T) and Sridhar Gaddam (RedHat)

==============================================
IPv6 Gap Analysis with Open Daylight Beryllium
==============================================

This section provides users with IPv6 gap analysis regarding feature requirement with
Open Daylight Beryllium Official Release. The following table lists the use cases / feature
requirements of VIM-agnostic IPv6 functionality, including infrastructure layer and VNF
(VM) layer, and its gap analysis with Open Daylight Beryllium Official Release.

.. table::
  :class: longtable

  +-------------------------------------------------------------+--------------------------+--------------------------------------------------------------------------+
  |Use Case / Requirement                                       |Supported in ODL Beryllium|Notes                                                                     |
  +=============================================================+==========================+==========================================================================+
  |REST API support for IPv6 subnet creation in ODL             |Yes                       |Yes, it is possible to create IPv6 subnets in ODL using Neutron REST API. |
  |                                                             |                          |                                                                          |
  |                                                             |                          |For a network which has both IPv4 and IPv6 subnets, ODL mechanism driver  |
  |                                                             |                          |will send the port information which includes IPv4/v6 addresses to ODL    |
  |                                                             |                          |Neutron northbound API. When port information is queried it displays IPv4 |
  |                                                             |                          |and IPv6 addresses. However, in Beryllium release, ODL net-virt provider  |
  |                                                             |                          |does not support IPv6 features (i.e., the actual functionality is missing |
  |                                                             |                          |and would be available only in the later releases of ODL).                |
  +-------------------------------------------------------------+--------------------------+--------------------------------------------------------------------------+
  |IPv6 Router support in ODL                                   |**No**                    |ODL net-virt provider in Beryllium release only supports IPv4 Router.     |
  |                                                             |                          |                                                                          |
  |1. Communication between VMs on same compute node            |                          |In the meantime, if IPv6 Routing is necessary, we can use ODL for L2      |
  |2. Communication between VMs on different compute nodes      |                          |connectivity and Neutron L3 agent for IPv4/v6 routing.                    |
  |   (east-west)                                               |                          |                                                                          |
  |3. External routing (north-south)                            |                          |                                                                          |
  +-------------------------------------------------------------+--------------------------+--------------------------------------------------------------------------+
  |IPAM: Support for IPv6 Address assignment modes.             |**No**                    |Although it is possible to create different types of IPv6 subnets in ODL, |
  |                                                             |                          |ODL_L3 would have to implement the IPv6 Router that can send out Router   |
  |1. SLAAC                                                     |                          |Advertisements based on the IPv6 addressing mode. Router Advertisement    |
  |2. DHCPv6 Stateless                                          |                          |is also necessary for VMs to configure the default route.                 |
  |3. DHCPv6 Stateful                                           |                          |                                                                          |
  +-------------------------------------------------------------+--------------------------+--------------------------------------------------------------------------+
  |When using ODL for L2 forwarding/tunneling, it is compatible |Yes                       |                                                                          |
  |with IPv6.                                                   |                          |                                                                          |
  +-------------------------------------------------------------+--------------------------+--------------------------------------------------------------------------+
  |Full support for IPv6 matching (i.e., IPv6, ICMPv6, TCP, UDP)|**No**                    |Security Groups for IPv6 is a work in progress.                           |
  |in security groups. Ability to control and manage all IPv6   |                          |                                                                          |
  |security group capabilities via Neutron/Nova API (REST and   |                          |                                                                          |
  |CLI) as well as via Horizon.                                 |                          |                                                                          |
  +-------------------------------------------------------------+--------------------------+--------------------------------------------------------------------------+
  |Shared Networks support                                      |**No**                    |ODL currently assumes a single tenant to network mapping and does not     |
  |                                                             |                          |support shared networks among tenants.                                    |
  +-------------------------------------------------------------+--------------------------+--------------------------------------------------------------------------+
  |IPv6 external L2 VLAN directly attached to a VM.             |**ToDo**                  |                                                                          |
  +-------------------------------------------------------------+--------------------------+--------------------------------------------------------------------------+
  |ODL on an IPv6 only Infrastructure.                          |**ToDo**                  |Deploying OpenStack with ODL on an IPv6 only infrastructure where the API |
  |                                                             |                          |endpoints are all IPv6 addresses.                                         |
  +-------------------------------------------------------------+--------------------------+--------------------------------------------------------------------------+
ce *atalk_get_interface_idx(loff_t pos) { struct atalk_iface *i; for (i = atalk_interfaces; pos && i; i = i->next) --pos; return i; } static void *atalk_seq_interface_start(struct seq_file *seq, loff_t *pos) __acquires(atalk_interfaces_lock) { loff_t l = *pos; read_lock_bh(&atalk_interfaces_lock); return l ? atalk_get_interface_idx(--l) : SEQ_START_TOKEN; } static void *atalk_seq_interface_next(struct seq_file *seq, void *v, loff_t *pos) { struct atalk_iface *i; ++*pos; if (v == SEQ_START_TOKEN) { i = NULL; if (atalk_interfaces) i = atalk_interfaces; goto out; } i = v; i = i->next; out: return i; } static void atalk_seq_interface_stop(struct seq_file *seq, void *v) __releases(atalk_interfaces_lock) { read_unlock_bh(&atalk_interfaces_lock); } static int atalk_seq_interface_show(struct seq_file *seq, void *v) { struct atalk_iface *iface; if (v == SEQ_START_TOKEN) { seq_puts(seq, "Interface Address Networks " "Status\n"); goto out; } iface = v; seq_printf(seq, "%-16s %04X:%02X %04X-%04X %d\n", iface->dev->name, ntohs(iface->address.s_net), iface->address.s_node, ntohs(iface->nets.nr_firstnet), ntohs(iface->nets.nr_lastnet), iface->status); out: return 0; } static __inline__ struct atalk_route *atalk_get_route_idx(loff_t pos) { struct atalk_route *r; for (r = atalk_routes; pos && r; r = r->next) --pos; return r; } static void *atalk_seq_route_start(struct seq_file *seq, loff_t *pos) __acquires(atalk_routes_lock) { loff_t l = *pos; read_lock_bh(&atalk_routes_lock); return l ? atalk_get_route_idx(--l) : SEQ_START_TOKEN; } static void *atalk_seq_route_next(struct seq_file *seq, void *v, loff_t *pos) { struct atalk_route *r; ++*pos; if (v == SEQ_START_TOKEN) { r = NULL; if (atalk_routes) r = atalk_routes; goto out; } r = v; r = r->next; out: return r; } static void atalk_seq_route_stop(struct seq_file *seq, void *v) __releases(atalk_routes_lock) { read_unlock_bh(&atalk_routes_lock); } static int atalk_seq_route_show(struct seq_file *seq, void *v) { struct atalk_route *rt; if (v == SEQ_START_TOKEN) { seq_puts(seq, "Target Router Flags Dev\n"); goto out; } if (atrtr_default.dev) { rt = &atrtr_default; seq_printf(seq, "Default %04X:%02X %-4d %s\n", ntohs(rt->gateway.s_net), rt->gateway.s_node, rt->flags, rt->dev->name); } rt = v; seq_printf(seq, "%04X:%02X %04X:%02X %-4d %s\n", ntohs(rt->target.s_net), rt->target.s_node, ntohs(rt->gateway.s_net), rt->gateway.s_node, rt->flags, rt->dev->name); out: return 0; } static void *atalk_seq_socket_start(struct seq_file *seq, loff_t *pos) __acquires(atalk_sockets_lock) { read_lock_bh(&atalk_sockets_lock); return seq_hlist_start_head(&atalk_sockets, *pos); } static void *atalk_seq_socket_next(struct seq_file *seq, void *v, loff_t *pos) { return seq_hlist_next(v, &atalk_sockets, pos); } static void atalk_seq_socket_stop(struct seq_file *seq, void *v) __releases(atalk_sockets_lock) { read_unlock_bh(&atalk_sockets_lock); } static int atalk_seq_socket_show(struct seq_file *seq, void *v) { struct sock *s; struct atalk_sock *at; if (v == SEQ_START_TOKEN) { seq_printf(seq, "Type Local_addr Remote_addr Tx_queue " "Rx_queue St UID\n"); goto out; } s = sk_entry(v); at = at_sk(s); seq_printf(seq, "%02X %04X:%02X:%02X %04X:%02X:%02X %08X:%08X " "%02X %u\n", s->sk_type, ntohs(at->src_net), at->src_node, at->src_port, ntohs(at->dest_net), at->dest_node, at->dest_port, sk_wmem_alloc_get(s), sk_rmem_alloc_get(s), s->sk_state, from_kuid_munged(seq_user_ns(seq), sock_i_uid(s))); out: return 0; } static const struct seq_operations atalk_seq_interface_ops = { .start = atalk_seq_interface_start, .next = atalk_seq_interface_next, .stop = atalk_seq_interface_stop, .show = atalk_seq_interface_show, }; static const struct seq_operations atalk_seq_route_ops = { .start = atalk_seq_route_start, .next = atalk_seq_route_next, .stop = atalk_seq_route_stop, .show = atalk_seq_route_show, }; static const struct seq_operations atalk_seq_socket_ops = { .start = atalk_seq_socket_start, .next = atalk_seq_socket_next, .stop = atalk_seq_socket_stop, .show = atalk_seq_socket_show, }; static int atalk_seq_interface_open(struct inode *inode, struct file *file) { return seq_open(file, &atalk_seq_interface_ops); } static int atalk_seq_route_open(struct inode *inode, struct file *file) { return seq_open(file, &atalk_seq_route_ops); } static int atalk_seq_socket_open(struct inode *inode, struct file *file) { return seq_open(file, &atalk_seq_socket_ops); } static const struct file_operations atalk_seq_interface_fops = { .owner = THIS_MODULE, .open = atalk_seq_interface_open, .read = seq_read, .llseek = seq_lseek, .release = seq_release, }; static const struct file_operations atalk_seq_route_fops = { .owner = THIS_MODULE, .open = atalk_seq_route_open, .read = seq_read, .llseek = seq_lseek, .release = seq_release, }; static const struct file_operations atalk_seq_socket_fops = { .owner = THIS_MODULE, .open = atalk_seq_socket_open, .read = seq_read, .llseek = seq_lseek, .release = seq_release, }; static struct proc_dir_entry *atalk_proc_dir; int __init atalk_proc_init(void) { struct proc_dir_entry *p; int rc = -ENOMEM; atalk_proc_dir = proc_mkdir("atalk", init_net.proc_net); if (!atalk_proc_dir) goto out; p = proc_create("interface", S_IRUGO, atalk_proc_dir, &atalk_seq_interface_fops); if (!p) goto out_interface; p = proc_create("route", S_IRUGO, atalk_proc_dir, &atalk_seq_route_fops); if (!p) goto out_route; p = proc_create("socket", S_IRUGO, atalk_proc_dir, &atalk_seq_socket_fops); if (!p) goto out_socket; p = proc_create("arp", S_IRUGO, atalk_proc_dir, &atalk_seq_arp_fops); if (!p) goto out_arp; rc = 0; out: return rc; out_arp: remove_proc_entry("socket", atalk_proc_dir); out_socket: remove_proc_entry("route", atalk_proc_dir); out_route: remove_proc_entry("interface", atalk_proc_dir); out_interface: remove_proc_entry("atalk", init_net.proc_net); goto out; } void __exit atalk_proc_exit(void) { remove_proc_entry("interface", atalk_proc_dir); remove_proc_entry("route", atalk_proc_dir); remove_proc_entry("socket", atalk_proc_dir); remove_proc_entry("arp", atalk_proc_dir); remove_proc_entry("atalk", init_net.proc_net); }