diff options
Diffstat (limited to 'resources/libraries/python')
-rw-r--r-- | resources/libraries/python/GeneveUtil.py | 126 | ||||
-rw-r--r-- | resources/libraries/python/LispSetup.py | 4 | ||||
-rw-r--r-- | resources/libraries/python/VPPUtil.py | 23 | ||||
-rw-r--r-- | resources/libraries/python/topology.py | 2 |
4 files changed, 152 insertions, 3 deletions
diff --git a/resources/libraries/python/GeneveUtil.py b/resources/libraries/python/GeneveUtil.py new file mode 100644 index 0000000000..3c8ebeebb3 --- /dev/null +++ b/resources/libraries/python/GeneveUtil.py @@ -0,0 +1,126 @@ +# Copyright (c) 2020 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. + +"""VPP GENEVE Plugin utilities library.""" + +from ipaddress import ip_address + +from resources.libraries.python.Constants import Constants +from resources.libraries.python.InterfaceUtil import InterfaceUtil +from resources.libraries.python.IPAddress import IPAddress +from resources.libraries.python.PapiExecutor import PapiSocketExecutor +from resources.libraries.python.topology import Topology + + +class GeneveUtil: + """VPP GENEVE Plugin Keywords.""" + + @staticmethod + def add_geneve_tunnel( + node, local_address, remote_address, vni, multicast_if=None, + encap_vrf=0, l3_mode=False, next_index=None): + """Add GENEVE tunnel on the specified VPP node. + + :param node: Topology node. + :param local_address: Local IP address. + :param remote_address: Remote IP address. + :param vni: Virtual network ID. + :param multicast_if: Interface key of multicast interface; used only if + remote is multicast. (Default value = None) + :param encap_vrf: The FIB ID for sending unicast GENEVE encap packets or + receiving multicast packets. (Default value = 0) + :param l3_mode: Use geneve tunnel in L3 mode (ip routing) if Tue else in + L2 mode (L2 switching). (Default value = False) + :param next_index: The index of the next node. + :type node: dict + :type local_address: str + :type remote_address: str + :type vni: int + :type multicast_if: str + :type encap_vrf: int + :type l3_mode: bool + :type next_index: int + :returns: SW interface index of created geneve tunnel. + :rtype: int + """ + cmd = u"geneve_add_del_tunnel2" + args = dict( + is_add=True, + local_address=IPAddress.create_ip_address_object( + ip_address(local_address) + ), + remote_address=IPAddress.create_ip_address_object( + ip_address(remote_address) + ), + mcast_sw_if_index=Topology.get_interface_sw_index( + node, multicast_if + ) if multicast_if else Constants.BITWISE_NON_ZERO, + encap_vrf_id=int(encap_vrf), + decap_next_index=next_index if l3_mode + else Constants.BITWISE_NON_ZERO, + vni=int(vni), + l3_mode=l3_mode + ) + err_msg = f"Failed to configure GENEVE tunnel on host {node[u'host']}!" + with PapiSocketExecutor(node) as papi_exec: + sw_if_index = papi_exec.add(cmd, **args).get_sw_if_index(err_msg) + + if_key = Topology.add_new_port(node, u"geneve_tunnel") + Topology.update_interface_sw_if_index(node, if_key, sw_if_index) + + ifc_name = InterfaceUtil.vpp_get_interface_name(node, sw_if_index) + Topology.update_interface_name(node, if_key, ifc_name) + + ifc_mac = InterfaceUtil.vpp_get_interface_mac(node, sw_if_index) + Topology.update_interface_mac_address(node, if_key, ifc_mac) + + return sw_if_index + + @staticmethod + def enable_interface_geneve_bypass(node, interface, is_ipv6=False): + """Add ipv4/ipv6-geneve-bypass graph node for a given interface on + the specified VPP node. + + :param node: Topology node. + :param interface: Interface key from topology file of interface + to add geneve bypass node for. + :param is_ipv6: Enable ipv6-geneve-bypass graph node if True else enable + ipv4-geneve-bypass graph node. + :type node: dict + :type interface: str + :type is_ipv6: bool + """ + cmd = u"sw_interface_set_geneve_bypass" + args = dict( + is_ipv6=is_ipv6, + enable=True, + sw_if_index=Topology.get_interface_sw_index(node, interface) + ) + err_msg = ( + f"Failed to enable {u'ipv6' if is_ipv6 else u'ipv4'}-geneve-bypass " + f"on interface {interface} on host {node[u'host']}!" + ) + with PapiSocketExecutor(node) as papi_exec: + papi_exec.add(cmd, **args).get_reply(err_msg) + + @staticmethod + def show_geneve_tunnel_data(node): + """Show the GENEVE tunnels data. + + :param node: DUT node. + :type node: dict + """ + cmds = [ + u"geneve_tunnel_dump", + ] + PapiSocketExecutor.dump_and_log(node, cmds) diff --git a/resources/libraries/python/LispSetup.py b/resources/libraries/python/LispSetup.py index 59cb1a808d..6579764596 100644 --- a/resources/libraries/python/LispSetup.py +++ b/resources/libraries/python/LispSetup.py @@ -40,8 +40,8 @@ class LispEid: :type eid: str :type prefix_len: int """ - eid_addr = dict(prefix=IPUtil.create_prefix_object( - ip_address(eid), prefix_len) + eid_addr = dict( + prefix=IPUtil.create_prefix_object(ip_address(eid), prefix_len) ) if prefix_len else dict(mac=str(eid)) return dict( diff --git a/resources/libraries/python/VPPUtil.py b/resources/libraries/python/VPPUtil.py index c735494282..a7ec44c974 100644 --- a/resources/libraries/python/VPPUtil.py +++ b/resources/libraries/python/VPPUtil.py @@ -361,3 +361,26 @@ class VPPUtil: logger.trace(f"show threads:\n{threads_data}") return threads_data + + @staticmethod + def vpp_add_graph_node_next(node, graph_node_name, graph_next_name): + """Set the next node for a given node. + + :param node: Node to run command on. + :param graph_node_name: Graph node to add the next node on. + :param graph_next_name: Graph node to add as the next node. + :type node: dict + :type graph_node_name: str + :type graph_next_name: str + :returns: The index of the next node. + :rtype: int + """ + cmd = u"add_node_next" + args = dict( + node_name=graph_node_name, + next_name=graph_next_name + ) + with PapiSocketExecutor(node) as papi_exec: + reply = papi_exec.add(cmd, **args).get_reply() + + return reply[u"next_index"] diff --git a/resources/libraries/python/topology.py b/resources/libraries/python/topology.py index 338ccb6b57..2b930c08dc 100644 --- a/resources/libraries/python/topology.py +++ b/resources/libraries/python/topology.py @@ -174,7 +174,7 @@ class Topology: port_types = ( u"subinterface", u"vlan_subif", u"memif", u"tap", u"vhost", u"loopback", u"gre_tunnel", u"vxlan_tunnel", u"eth_bond", - u"eth_avf", u"eth_rdma" + u"eth_avf", u"eth_rdma", u"geneve_tunnel" ) for node_data in nodes.values(): |