# Copyright (c) 2018 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.
"""Routing utilities library."""
from resources.libraries.python.VatExecutor import VatTerminal
from resources.libraries.python.topology import Topology
from resources.libraries.python.ssh import exec_cmd_no_error
class Routing(object):
"""Routing utilities."""
@staticmethod
def vpp_route_add(node, network, prefix_len, **kwargs):
"""Add route to the VPP node.
:param node: Node to add route on.
:param network: Route destination network address.
:param prefix_len: Route destination network prefix length.
:param kwargs: Optional key-value arguments:
gateway: Route gateway address. (str)
interface: Route interface. (str)
vrf: VRF table ID. (int)
use_sw_index: Use sw_if_index in VAT command. (bool)
resolve_attempts: Resolve attempts IP route add parameter. (int)
count: number of IP addresses to add starting from network IP (int)
local: The route is local with same prefix (increment is 1).
If None, then is not used. (bool)
lookup_vrf: VRF table ID for lookup. (int)
multipath: Enable multipath routing. (bool)
weight: Weight value for unequal cost multipath routing. (int)
:type node: dict
:type network: str
:type prefix_len: int
:type kwargs: dict
"""
gateway = kwargs.get("gateway", '')
intf = kwargs.get("interface", '')
use_sw_index = kwargs.get("use_sw_index", True)
resolve_attempts = kwargs.get("resolve_attempts", 10)
count = kwargs.get("count", 1)
vrf = kwargs.get("vrf", None)
l_vrf = kwargs.get("lookup_vrf", None)
multipath = kwargs.get("multipath", False)
weight = kwargs.get("weight", None)
local = kwargs.get("local", False)
if intf:
if use_sw_index:
int_cmd = ('sw_if_index {}'.
format(Topology.get_interface_sw_index(node, intf)))
else:
int_cmd = intf
else:
int_cmd = ''
with VatTerminal(node, json_param=False) as vat:
vat.vat_terminal_exec_cmd_from_template(
'add_route.vat',
network=network,
prefix_length=prefix_len,
via='via {}'.format(gateway) if gateway else '',
vrf='vrf {}'.format(vrf) if vrf else '',
interface=int_cmd,
resolve_attempts='resolve-attempts {}'.
format(resolve_attempts) if resolve_attempts else '',
count='count {}'.format(count) if count else '',
lookup_vrf='lookup-in-vrf {}'.format(l_vrf) if l_vrf else '',
multipath='multipath' if multipath else '',
weight='weight {}'.format(weight) if weight else '',
local='local' if local else '')
@staticmethod
def add_fib_table(node, table_id, ipv6=False):
"""Create new FIB table according to ID.
:param node: Node to add FIB on.
:param table_id: FIB table ID.
:param ipv6: Is this an IPv6 table
:type node: dict
:type table_id: int
:type ipv6: bool
"""
with VatTerminal(node) as vat:
vat.vat_terminal_exec_cmd_from_template('add_fib_table.vat',
table_id=table_id,
ipv6="ipv6" if ipv6 else "")
@staticmethod
def add_route(node, ip_addr, prefix, gateway, namespace=None):
"""Add route in namespace.
:param node: Node where to execute command.
:param ip_addr: Route destination IP address.
:param prefix: IP prefix.
:param namespace: Execute command in namespace. Optional.
:param gateway: Gateway address.
:type node: dict
:type ip_addr: str
:type prefix: int
:type gateway: str
:type namespace: str
"""
if namespace is not None:
cmd = 'ip netns exec {} ip route add {}/{} via {}'.format(
namespace, ip_addr, prefix, gateway)
else:
cmd = 'ip route add {}/{} via {}'.format(ip_addr, prefix, gateway)
exec_cmd_no_error(node, cmd, sudo=True)