diff options
| -rw-r--r-- | resources/libraries/python/Map.py | 83 | ||||
| -rw-r--r-- | resources/libraries/robot/map.robot | 67 | ||||
| -rw-r--r-- | resources/templates/vat/map_add_del_rule.vat | 1 | ||||
| -rw-r--r-- | resources/templates/vat/map_add_domain.vat | 1 | ||||
| -rw-r--r-- | resources/test_data/softwire/map_utils.py | 53 | ||||
| -rwxr-xr-x | resources/traffic_scripts/send_ipv4_check_lw_4o6.py | 135 | ||||
| -rw-r--r-- | tests/suites/softwire/lightweight_4over6.robot | 90 |
7 files changed, 430 insertions, 0 deletions
diff --git a/resources/libraries/python/Map.py b/resources/libraries/python/Map.py new file mode 100644 index 0000000000..7d48c20d2e --- /dev/null +++ b/resources/libraries/python/Map.py @@ -0,0 +1,83 @@ +# Copyright (c) 2016 Cisco and/or its affiliates. +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at: +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +"""Map utilities library.""" + + +from resources.libraries.python.VatExecutor import VatExecutor + + +class Map(object): + """Utilities for manipulating MAP feature in VPP.""" + + @staticmethod + def map_add_domain(vpp_node, ip4_pfx, ip6_pfx, ip6_src, ea_bits_len, + psid_offset, psid_len): + """Add map domain on node. + + :param vpp_node: VPP node to add map domain on. + :param ip4_pfx: Rule IPv4 prefix. + :param ip6_pfx: Rule IPv6 prefix. + :param ip6_src: MAP domain IPv6 BR address / Tunnel source. + :param ea_bits_len: Embedded Address bits length. + :param psid_offset: Port Set Identifier (PSID) offset. + :param psid_len: Port Set Identifier (PSID) length. + :type vpp_node: dict + :type ip4_pfx: str + :type ip6_pfx: str + :type ip6_src: str + :type ea_bits_len: int + :type psid_offset: int + :type psid_len: int + :return: Index of created map domain. + :rtype: int + :raises RuntimeError: If unable to add map domain. + """ + output = VatExecutor.cmd_from_template(vpp_node, "map_add_domain.vat", + ip4_pfx=ip4_pfx, + ip6_pfx=ip6_pfx, + ip6_src=ip6_src, + ea_bits_len=ea_bits_len, + psid_offset=psid_offset, + psid_len=psid_len) + if output[0]["retval"] == 0: + return output[0]["index"] + else: + raise RuntimeError('Unable to add map domain on node {}' + .format(vpp_node['host'])) + + @staticmethod + def map_add_rule(vpp_node, index, psid, dst, delete=False): + """Add or delete map rule on node. + + :param vpp_node: VPP node to add map rule on. + :param index: Map domain index to add rule to. + :param psid: Port Set Identifier. + :param dst: MAP CE IPv6 address. + :param delete: If set to True, delete rule. Default False. + :type vpp_node: dict + :type index: int + :type psid: int + :type dst: str + :type delete: bool + :raises RuntimeError: If unable to add map rule. + """ + output = VatExecutor.cmd_from_template(vpp_node, "map_add_del_rule.vat", + index=index, + psid=psid, + dst=dst, + delete='del' if delete else '') + + if output[0]["retval"] != 0: + raise RuntimeError('Unable to add map rule on node {}' + .format(vpp_node['host'])) diff --git a/resources/libraries/robot/map.robot b/resources/libraries/robot/map.robot new file mode 100644 index 0000000000..1e96061571 --- /dev/null +++ b/resources/libraries/robot/map.robot @@ -0,0 +1,67 @@ +# Copyright (c) 2016 Cisco and/or its affiliates. +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at: +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +*** Settings *** +| Variables | resources/libraries/python/topology.py +| Library | resources.libraries.python.topology.Topology +| Library | resources.libraries.python.DUTSetup +| Library | resources.libraries.python.TGSetup +| Library | resources.libraries.python.Map +| Documentation | Keywords for MAP feature in VPP. + +*** Keywords *** +| Send IPv4 UDP and check headers for lightweight 4over6 +| | [Documentation] +| | ... | Send empty UDP to given IPv4 dst and UDP port and check received \ +| | ... | packets headers (Ethernet, IPv6, IPv4, UDP). +| | ... +| | ... | *Arguments:* +| | ... | - tg_node - Node where to run traffic script. Type: string +| | ... | - tx_if - Interface from where to send ICPMv4 packet. Type: string +| | ... | - rx_if - Interface where to receive IPinIP packet. Type: string +| | ... | - tx_dst_mac - Destination MAC address of IPv4 packet. Type: string +| | ... | - tx_dst_ipv4 - Destination IPv4 address. Type: string +| | ... | - tx_src_ipv4 - Source IPv4 address. Type: string +| | ... | - tx_dst_udp_port - Destination UDP port. Type: integer +| | ... | - rx_dst_mac - Expected destination MAC address. Type: string +| | ... | - rx_src_mac - Expected source MAC address. Type: string +| | ... | - dst_ipv6 - Expected destination IPv6 address. Type: string +| | ... | - src_ipv6 - Expected source IPv6 address. Type: string +| | ... +| | ... | *Return:* +| | ... | - No value returned +| | ... +| | ... | *Example:* +| | ... +| | ... | \| Send IPv4 UDP and check headers for lightweight 4over6 \ +| | ... | \| ${tg_node} \| eth3 \| eth2 \| 08:00:27:66:b8:57 \| 20.0.0.1 \ +| | ... | \| 20.0.0.2 \| 1232 \| 08:00:27:46:2b:4c \| 08:00:27:f3:be:f0 \ +| | ... | \| 2001:1::2 \| 2001:1::1 \| +| | ... +| | [Arguments] +| | ... | ${tg_node} | ${tx_if} | ${rx_if} | ${tx_dst_mac} | ${tx_dst_ipv4} +| | ... | ${tx_src_ipv4} | ${tx_dst_udp_port} | ${rx_dst_mac} | ${rx_src_mac} +| | ... | ${dst_ipv6} | ${src_ipv6} +| | ... +| | ${tx_name}= | Get interface name | ${tg_node} | ${tx_if} +| | ${rx_name}= | Get interface name | ${tg_node} | ${rx_if} +| | ${args}= | Catenate +| | ... | --tx_if | ${tx_name} | --rx_if | ${rx_name} +| | ... | --tx_dst_mac | ${tx_dst_mac} | --tx_src_ipv4 | ${tx_src_ipv4} +| | ... | --tx_dst_ipv4 | ${tx_dst_ipv4} +| | ... | --tx_dst_udp_port | ${tx_dst_udp_port} +| | ... | --rx_dst_mac | ${rx_dst_mac} | --rx_src_mac | ${rx_src_mac} +| | ... | --src_ipv6 | ${src_ipv6} | --dst_ipv6 | ${dst_ipv6} +| | ... +| | Run Traffic Script On Node +| | ... | send_ipv4_check_lw_4o6.py | ${tg_node} | ${args} diff --git a/resources/templates/vat/map_add_del_rule.vat b/resources/templates/vat/map_add_del_rule.vat new file mode 100644 index 0000000000..4d82b36674 --- /dev/null +++ b/resources/templates/vat/map_add_del_rule.vat @@ -0,0 +1 @@ +map_add_del_rule index {index} psid {psid} dst {dst} {delete} diff --git a/resources/templates/vat/map_add_domain.vat b/resources/templates/vat/map_add_domain.vat new file mode 100644 index 0000000000..f5996294ee --- /dev/null +++ b/resources/templates/vat/map_add_domain.vat @@ -0,0 +1 @@ +map_add_domain ip4-pfx {ip4_pfx} ip6-pfx {ip6_pfx} ip6-src {ip6_src} ea-bits-len {ea_bits_len} psid-offset {psid_offset} psid-len {psid_len}
\ No newline at end of file diff --git a/resources/test_data/softwire/map_utils.py b/resources/test_data/softwire/map_utils.py new file mode 100644 index 0000000000..58ef551d7a --- /dev/null +++ b/resources/test_data/softwire/map_utils.py @@ -0,0 +1,53 @@ +# Copyright (c) 2016 Cisco and/or its affiliates. +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at: +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +"""Utils for MAP feature.""" + + +def map_port_ranges(psid, length, offset=6): + """Return list of port ranges for given PSID in tuple <min, max>. + + :param psid: PSID. + :param length: PSID length. + :param offset: PSID offset. + :type psid: int + :type length: int + :type offset: int + :return: List of (min, max) port range tuples inclusive. + :rtype: list + + 0 1 + 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 + +-----------+-----------+-------+ + Ports in | A | PSID | j | + the CE port set | > 0 | | | + +-----------+-----------+-------+ + | a bits | k bits |m bits | + """ + + port_field_len = 16 + port_field_min = int('0x0000', 16) + port_field_max = int('0xffff', 16) + + a = offset + k = length + m = port_field_len - offset - length + km = k + m + j_max = port_field_max >> a + k + + port_ranges = [] + for A in range(1, (port_field_max >> km) + 1): + port_ranges.append((((A << k) | psid) << m, + ((A << k) | psid) << m | j_max)) + + return port_ranges diff --git a/resources/traffic_scripts/send_ipv4_check_lw_4o6.py b/resources/traffic_scripts/send_ipv4_check_lw_4o6.py new file mode 100755 index 0000000000..881abc83a2 --- /dev/null +++ b/resources/traffic_scripts/send_ipv4_check_lw_4o6.py @@ -0,0 +1,135 @@ +#!/usr/bin/env python +# Copyright (c) 2016 Cisco and/or its affiliates. +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at: +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +"""Traffic script that sends an empty UDP datagram and checks if IPv4 is +correctly encapsulated into IPv6 packet.""" + +import sys + +from scapy.layers.l2 import Ether +from scapy.layers.inet import IP, UDP + +from resources.libraries.python.PacketVerifier import RxQueue, TxQueue +from resources.libraries.python.TrafficScriptArg import TrafficScriptArg + + +def _is_ipv4_in_ipv6(pkt): + """If IPv6 next header type in the given pkt is IPv4, return True, + else return False. False is returned also if exception occurs.""" + ipv6_type = int('0x86dd', 16) # IPv6 + try: + if pkt.type == ipv6_type: + if pkt.payload.nh == 4: + return True + except: # pylint: disable=bare-except + return False + return False + + +def main(): # pylint: disable=too-many-statements, too-many-locals + """Main function of the script file.""" + args = TrafficScriptArg(['tx_dst_mac', 'tx_src_ipv4', 'tx_dst_ipv4', + 'tx_dst_udp_port', 'rx_dst_mac', 'rx_src_mac', + 'src_ipv6', 'dst_ipv6']) + rx_if = args.get_arg('rx_if') + tx_if = args.get_arg('tx_if') + tx_dst_mac = args.get_arg('tx_dst_mac') + tx_src_ipv4 = args.get_arg('tx_src_ipv4') + tx_dst_ipv4 = args.get_arg('tx_dst_ipv4') + tx_dst_udp_port = int(args.get_arg('tx_dst_udp_port')) + tx_src_udp_port = 20000 + rx_dst_mac = args.get_arg('rx_dst_mac') + rx_src_mac = args.get_arg('rx_src_mac') + rx_src_ipv6 = args.get_arg('src_ipv6') + rx_dst_ipv6 = args.get_arg('dst_ipv6') + + rxq = RxQueue(rx_if) + txq = TxQueue(tx_if) + sent_packets = [] + + # Create empty UDP datagram + udp = (Ether(dst=tx_dst_mac) / + IP(src=tx_src_ipv4, dst=tx_dst_ipv4) / + UDP(sport=tx_src_udp_port, dport=tx_dst_udp_port)) + + txq.send(udp) + sent_packets.append(udp) + + for _ in range(5): + pkt = rxq.recv(2) + if _is_ipv4_in_ipv6(pkt): + ether = pkt + break + else: + raise RuntimeError("IPv4 in IPv6 Rx error.") + + # check ethernet + if ether.dst != rx_dst_mac: + raise RuntimeError("Destination MAC error {} != {}.". + format(ether.dst, rx_dst_mac)) + print "Destination MAC: OK." + + if ether.src != rx_src_mac: + raise RuntimeError("Source MAC error {} != {}.". + format(ether.src, rx_src_mac)) + print "Source MAC: OK." + + ipv6 = ether.payload + + # check ipv6 + if ipv6.dst != rx_dst_ipv6: + raise RuntimeError("Destination IP error {} != {}.". + format(ipv6.dst, rx_dst_ipv6)) + print "Destination IPv6: OK." + + if ipv6.src != rx_src_ipv6: + raise RuntimeError("Source IP error {} != {}.". + format(ipv6.src, rx_src_ipv6)) + print "Source IPv6: OK." + + ipv4 = ipv6.payload + + # check ipv4 + if ipv4.dst != tx_dst_ipv4: + raise RuntimeError("Destination IP error {} != {}.". + format(ipv4.dst, tx_dst_ipv4)) + print "Destination IPv4: OK." + + if ipv4.src != tx_src_ipv4: + raise RuntimeError("Source IP error {} != {}.". + format(ipv4.src, tx_src_ipv4)) + print "Source IPv4: OK." + + if ipv4.proto != 17: # UDP + raise RuntimeError("IP protocol error {} != UDP.". + format(ipv4.proto)) + print "IPv4 protocol: OK." + + udp = ipv4.payload + + # check udp + if udp.dport != tx_dst_udp_port: + raise RuntimeError("UDP dport error {} != {}.". + format(udp.dport, tx_dst_udp_port)) + print "UDP dport: OK." + + if udp.sport != tx_src_udp_port: + raise RuntimeError("UDP sport error {} != {}.". + format(udp.sport, tx_src_udp_port)) + print "UDP sport: OK." + + sys.exit(0) + +if __name__ == "__main__": + main() diff --git a/tests/suites/softwire/lightweight_4over6.robot b/tests/suites/softwire/lightweight_4over6.robot new file mode 100644 index 0000000000..28fb920951 --- /dev/null +++ b/tests/suites/softwire/lightweight_4over6.robot @@ -0,0 +1,90 @@ +# Copyright (c) 2016 Cisco and/or its affiliates. +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at: +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +*** Settings *** +| Resource | resources/libraries/robot/default.robot +| Resource | resources/libraries/robot/testing_path.robot +| Resource | resources/libraries/robot/ipv4.robot +| Resource | resources/libraries/robot/ipv6.robot +| Resource | resources/libraries/robot/map.robot +| Library | resources.libraries.python.Trace +| Force Tags | HW_ENV | VM_ENV | 3_NODE_DOUBLE_LINK_TOPO +| Test Setup | Run Keywords | Setup all DUTs before test +| ... | AND | Setup all TGs before traffic script +| Test Teardown | Show Packet Trace on All DUTs | ${nodes} +| Documentation | *Lightweight 4 over 6 test cases* +| ... +| ... | LW4o6 is a subset of MAP-E, with per-subscriber rules. It uses the +| ... | same tunneling mechanism and configuration as MAP-E. It does not use +| ... | embedded address bits. +| ... +| ... | *[Top] Network Topologies:* TG=DUT1 2-node topology with two links +| ... | between nodes. +| ... | *[Enc] Packet Encapsulations:* Eth-IPv4-UDP on TG_if1-DUT, +| ... | Eth-IPv6-IPv4-UDP on TG_if2_DUT. +| ... | *[Cfg] DUT configuration:* DUT1 is configured as lwAFTR. +| ... | *[Ver] TG verification:* Test UDP ICMP Echo Request in IPv4 are +| ... | sent to lwAFTR and are verified by TG for correctness their +| ... | encapsulation in IPv6 src-addr, dst-addr and MAC addresses. +| ... | *[Ref] Applicable standard specifications:* RFC7596 RFC7597. + +*** Variables *** +| ${dut_ip4}= | 10.0.0.1 +| ${dut_ip6}= | 2001:0::1 +| ${ipv4_prefix_len}= | 24 +| ${ipv6_prefix_len}= | 64 + +| ${lw_ipv4_pfx}= | 20.0.0.1/32 +| ${lw_ipv6_pfx}= | 2001:1::/64 +| ${lw_ipv6_src}= | 2001:1::1 +| ${lw_psid_length}= | ${8} +| ${lw_psid_offset}= | ${6} +| ${lw_rule_psid}= | ${52} +| ${lw_rule_ipv6_dst}= | 2001:1::2 +| ${test_ipv4_inside}= | 20.0.0.1 +| ${test_ipv4_outside}= | 10.0.0.100 +# test_port depends on psid, length, offset +| ${test_port}= | ${1232} + +*** Test Cases *** +| TC01: Encapsulate IPv4 into IPv6. IPv6 dst depends on IPv4 and UDP destination +| | [Documentation] +| | ... | [Top] TG=DUT1. +| | ... | [Enc] Eth-IPv4-UDP on TG_if1-DUT, Eth-IPv6-IPv4-UDP on TG_if2_DUT. +| | ... | [Cfg] On DUT1 configure Map domain and Map rule. +| | ... | [Ver] Make TG send non-encapsulated UDP to DUT; verify TG received +| | ... | IPv4oIPv6 encapsulated packet is correct. +| | ... | [Ref] RFC7596 RFC7597 +| | ... +| | Given Path for 2-node testing is set +| | ... | ${nodes['TG']} | ${nodes['DUT1']} | ${nodes['TG']} +| | And Interfaces in 2-node path are up +| | And IP addresses are set on interfaces +| | ... | ${dut_node} | ${dut_to_tg_if1} | ${dut_ip4} | ${ipv4_prefix_len} +| | ... | ${dut_node} | ${dut_to_tg_if2} | ${dut_ip6} | ${ipv6_prefix_len} +| | And Add IP Neighbor +| | ... | ${dut_node} | ${dut_to_tg_if2} | ${lw_rule_ipv6_dst} +| | ... | ${tg_to_dut_if2_mac} +| | ${domain_index}= +| | ... | When Map Add Domain +| | ... | ${dut_node} | ${lw_ipv4_pfx} | ${lw_ipv6_pfx} +| | ... | ${lw_ipv6_src} | 0 | ${lw_psid_offset} +| | ... | ${lw_psid_length} +| | And Map Add Rule +| | ... | ${dut_node} | ${domain_index} | ${lw_rule_psid} +| | ... | ${lw_rule_ipv6_dst} +| | Then Send IPv4 UDP and check headers for lightweight 4over6 +| | ... | ${tg_node} | ${tg_to_dut_if1} | ${tg_to_dut_if2} +| | ... | ${dut_to_tg_if1_mac} | ${test_ipv4_inside} | ${test_ipv4_outside} +| | ... | ${test_port} | ${tg_to_dut_if2_mac} | ${dut_to_tg_if2_mac} +| | ... | ${lw_rule_ipv6_dst} | ${lw_ipv6_src} |