CSIT-523 HC Test: routing

 - add routing test suite, variables and keywords

Change-Id: I57e180350c30221befe8d1fc4e3b146d394c4f5d
Signed-off-by: selias <samelias@cisco.com>

7 files changed, 851 insertions, 1 deletions

diff --git a/resources/libraries/python/honeycomb/HcAPIKwInterfaces.py b/resources/libraries/python/honeycomb/HcAPIKwInterfaces.py
index 3a32cbe5ff..eff0719e26 100644
--- a/resources/libraries/python/honeycomb/HcAPIKwInterfaces.py
+++ b/resources/libraries/python/honeycomb/HcAPIKwInterfaces.py
@@ -1,4 +1,4 @@
-# Copyright (c) 2016 Cisco and/or its affiliates.
+# Copyright (c) 2017 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:
@@ -555,6 +555,9 @@ class InterfaceKeywords(object):
         :rtype: bytearray
         """
 
+        interface = Topology.convert_interface_reference(
+            node, interface, "name")
+
         path = ("interfaces", ("interface", "name", interface), "ietf-ip:ipv4",
                 "neighbor")
         neighbor = [{"ip": ip_addr, "link-layer-address": link_layer_address}, ]
@@ -626,6 +629,9 @@ class InterfaceKeywords(object):
         :rtype: bytearray
         """
 
+        interface = Topology.convert_interface_reference(
+            node, interface, "name")
+
         path = ("interfaces", ("interface", "name", interface), "ietf-ip:ipv6")
         address = {"address": [{"ip": ip_addr, "prefix-length": prefix_len}, ]}
         return InterfaceKeywords._set_interface_properties(
@@ -686,6 +692,9 @@ class InterfaceKeywords(object):
         :rtype: bytearray
         """
 
+        interface = Topology.convert_interface_reference(
+            node, interface, "name")
+
         path = ("interfaces", ("interface", "name", interface), "ietf-ip:ipv6",
                 "neighbor")
         neighbor = [{"ip": ip_addr, "link-layer-address": link_layer_address}, ]
@@ -752,6 +761,9 @@ class InterfaceKeywords(object):
         :raises HoneycombError: If the parameter is not valid.
         """
 
+        interface = Topology.convert_interface_reference(
+            node, interface, "name")
+
         if param not in InterfaceKeywords.ROUTING_PARAMS:
             raise HoneycombError("The parameter {0} is invalid.".format(param))
 
diff --git a/resources/libraries/python/honeycomb/Routing.py b/resources/libraries/python/honeycomb/Routing.py
new file mode 100644
index 0000000000..d0f23892af
--- /dev/null
+++ b/resources/libraries/python/honeycomb/Routing.py
@@ -0,0 +1,201 @@
+# Copyright (c) 2017 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.
+
+"""This module implements keywords to manipulate routing tables using
+Honeycomb REST API."""
+
+from robot.api import logger
+
+from resources.libraries.python.HTTPRequest import HTTPCodes
+from resources.libraries.python.honeycomb.HoneycombSetup import HoneycombError
+from resources.libraries.python.honeycomb.HoneycombUtil \
+    import HoneycombUtil as HcUtil
+from resources.libraries.python.honeycomb.HoneycombUtil \
+    import DataRepresentation
+from resources.libraries.python.VatExecutor import VatTerminal
+
+
+class RoutingKeywords(object):
+    """Implementation of keywords which make it possible to:
+    - add/remove routing tables,
+    - add/remove routing table entries
+    - get operational data about routing tables,
+    """
+
+    def __init__(self):
+        pass
+
+    @staticmethod
+    def _set_routing_table_properties(node, path, data=None):
+        """Set routing table properties and check the return code.
+
+        :param node: Honeycomb node.
+        :param path: Path which is added to the base path to identify the data.
+        :param data: The new data to be set. If None, the item will be removed.
+        :type node: dict
+        :type path: str
+        :type data: dict
+        :return: Content of response.
+        :rtype: bytearray
+        :raises HoneycombError: If the status code in response is not
+        200 = OK.
+        """
+
+        if data:
+            status_code, resp = HcUtil.\
+                put_honeycomb_data(node, "config_routing_table", data, path,
+                                   data_representation=DataRepresentation.JSON)
+        else:
+            status_code, resp = HcUtil.\
+                delete_honeycomb_data(node, "config_routing_table", path)
+
+        if status_code not in (HTTPCodes.OK, HTTPCodes.ACCEPTED):
+            if data is None and '"error-tag":"data-missing"' in resp:
+                logger.debug("data does not exist in path.")
+            else:
+                raise HoneycombError(
+                    "The configuration of routing table was not successful. "
+                    "Status code: {0}.".format(status_code))
+        return resp
+
+    @staticmethod
+    def configure_routing_table(node, name, ip_version, data, vrf=1,
+                                special=False):
+        """Configure a routing table according to the data provided.
+
+        :param node: Honeycomb node.
+        :param name: Name for the table.
+        :param ip_version: IP protocol version, ipv4 or ipv6.
+        :param data: Route configuration that should be set.
+        :param vrf: vrf-id to attach configuration to.
+        :param special: Must be True if the configuration is a special route.
+        :type node: dict
+        :type name: str
+        :type ip_version: str
+        :type data: dict
+        :type vrf: int
+        :type special: bool
+        :returns: Content of response.
+        :rtype: bytearray
+        """
+        if special:
+            ip_version = "hc2vpp-ietf-{0}-unicast-routing:{0}".format(
+                ip_version)
+            protocol = "vpp-routing-ra:vpp-protocol-attributes"
+        else:
+            ip_version = ip_version
+            protocol = "vpp-protocol-attributes"
+
+        full_data = {
+            "routing-protocol": [
+                {
+                    "name": name,
+                    "description": "hc2vpp-csit test route",
+                    "enabled": "true",
+                    "type": "static",
+                    protocol: {
+                        "primary-vrf": vrf
+                    },
+                    "static-routes": {
+                        ip_version: {
+                            "route": data
+                        }
+                    }
+                }
+            ]
+        }
+
+        path = "/routing-protocol/{0}".format(name)
+        return RoutingKeywords._set_routing_table_properties(
+            node, path, full_data)
+
+    @staticmethod
+    def delete_routing_table(node, name):
+        """Delete the specified routing table from configuration data.
+
+        :param node: Honeycomb node.
+        :param name: Name of the table.
+        :type node: dict
+        :type name: str
+        :returns: Content of response.
+        :rtype: bytearray
+        """
+
+        path = "/routing-protocol/{0}".format(name)
+        return RoutingKeywords._set_routing_table_properties(node, path)
+
+    @staticmethod
+    def get_routing_table_oper(node, name, ip_version):
+        """Retrieve operational data about the specified routing table.
+
+        :param node: Honeycomb node.
+        :param name: Name of the routing table.
+        :param ip_version: IP protocol version, ipv4 or ipv6.
+        :type node: dict
+        :type name: str
+        :type ip_version: str
+        :returns: Routing table operational data.
+        :rtype: list
+        :raises HoneycombError: If the operation fails.
+        """
+
+        path = "/routing-protocol/{0}".format(name)
+        status_code, resp = HcUtil.\
+            get_honeycomb_data(node, "oper_routing_table", path)
+
+        if status_code != HTTPCodes.OK:
+            raise HoneycombError(
+                "Not possible to get operational information about the "
+                "classify tables. Status code: {0}.".format(status_code))
+
+        data = RoutingKeywords.clean_routing_oper_data(
+            resp['routing-protocol'][0]['static-routes']
+            ['hc2vpp-ietf-{0}-unicast-routing:{0}'.format(ip_version)]['route'])
+
+        return data
+
+    @staticmethod
+    def clean_routing_oper_data(data):
+        """Prepare received routing operational data to be verified against
+         expected data.
+
+        :param data: Routing operational data.
+        :type data: list
+        :returns: Routing operational data without entry ID numbers.
+        :rtype: list
+        """
+
+        for item in data:
+            # ID values are auto-incremented based on existing routes in VPP
+            item.pop("id", None)
+            if "next-hop-list" in item.keys():
+                for item2 in item["next-hop-list"]["next-hop"]:
+                    item2.pop("id", None)
+
+            if "next-hop-list" in item.keys():
+                # List items come in random order
+                item["next-hop-list"]["next-hop"].sort()
+
+        return data
+
+    @staticmethod
+    def log_routing_configuration(node):
+        """Retrieve route configuration using VAT and print the response
+         to robot log.
+
+         :param node: VPP node.
+         :type node: dict
+         """
+
+        with VatTerminal(node) as vat:
+            vat.vat_terminal_exec_cmd("ip_fib_dump")
diff --git a/resources/libraries/robot/honeycomb/routing.robot b/resources/libraries/robot/honeycomb/routing.robot
new file mode 100644
index 0000000000..7e38ef1e52
--- /dev/null
+++ b/resources/libraries/robot/honeycomb/routing.robot
@@ -0,0 +1,203 @@
+# Copyright (c) 2017 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 ***
+| Library | resources.libraries.python.honeycomb.Routing.RoutingKeywords
+| Documentation | Keywords used to test Honeycomb routing.
+
+*** Keywords ***
+| Honeycomb configures routing table
+| | [Documentation] | Uses Honeycomb API to configure a routing table.
+| | ...
+| | ... | *Arguments:*
+| | ... | - node - information about a DUT node. Type: dictionary
+| | ... | - name - name for the new routing table. Type: string
+| | ... | - ip_version - IP protocol version, ipv4 or ipv6. Type:string
+| | ... | - data - Settings for the new routing table. Type: dictionary
+| | ... | - vrf - vrf-id the new table will belong to. Type: integer
+| | ... | - special - Does the table contain special rules. Type: boolean
+| | ...
+| | ... | *Example:*
+| | ...
+| | ... | \| Honeycomb configures routing table \| ${nodes['DUT1']} \
+| | ... | \| table1 \| ipv4 \| ${data} \| ${1} \| ${TRUE} \|
+| | [Arguments] | ${node} | ${name} | ${ip_version} | ${data} | ${vrf}=${1}
+| | ... | ${special}=${EMPTY}
+| | Configure routing table | ${node} | ${name} | ${ip_version} | ${data}
+| | ... | ${vrf} | ${special}
+
+| Routing data from Honeycomb should contain
+| | [Documentation] | Uses Honeycomb API to retrieve operational data about\
+| | ... | a routing table, and compares with the data provided.
+| | ...
+| | ... | *Arguments:*
+| | ... | - node - information about a DUT node. Type: dictionary
+| | ... | - name - name of the routing table. Type: string
+| | ... | - ip_version - IP protocol version, ipv4 or ipv6. Type:string
+| | ... | - expected_data - Data to compare against. Type: dictionary
+| | ...
+| | ... | *Example:*
+| | ...
+| | ... | \| Routing data from Honeycomb should contain \| ${nodes['DUT1']} \
+| | ... | \| table1 \| ipv4 \| ${data} \|
+| | [Arguments] | ${node} | ${name} | ${ip_version} | ${expected_data}
+| | ${data}= | Get Routing Table Oper | ${node} | ${name} | ${ip_version}
+| | Should Contain | ${data} | ${expected_data}
+
+| Log routing configuration from VAT
+| | [Documentation] | Uses test API to read routing configuration from VPP\
+| | ... | and prints received response into robot log.
+| | ...
+| | ... | *Arguments:*
+| | ... | - node - information about a DUT node. Type: dictionary
+| | ...
+| | ... | *Example:*
+| | ...
+| | ... | \| Log routing configuration from VAT \| ${nodes['DUT1']} \|
+| | [Arguments] | ${node}
+| | Log routing configuration | ${node}
+
+| Honeycomb removes routing configuration
+| | [Documentation] | Uses Honeycomb API to remove Honeycomb-created\
+| | ... | routing configuration from the node. Entries configured automatically\
+| | ... | by VPP will not be removed.
+| | ...
+| | ... | *Arguments:*
+| | ... | - node - information about a DUT node. Type: dictionary
+| | ... | - name - name of the routing table to remove. Type: string
+| | ...
+| | ... | *Example:*
+| | ...
+| | ... | \| Honeycomb removes routing configuration \| ${nodes['DUT1']} \
+| | ... | \| table1 \|
+| | [Arguments] | ${node} | ${name}
+| | Delete routing table | ${node} | ${name}
+
+| Verify Route IPv4
+| | [Documentation] | Send an ICMP packet from one TG interface and receive\
+| | ... | it on the other TG interface.
+| | ...
+| | ... | *Arguments:*
+| | ...
+| | ... | _NOTE:_ Arguments are based on topology:
+| | ... | TG(if1)->(if1)DUT(if2)->TG(if2)
+| | ...
+| | ... | - tg_node - Node to execute scripts on (TG). Type: dictionary
+| | ... | - src_ip - IP of source interface (TG-if1). Type: integer
+| | ... | - dst_ip - IP of destination interface (TG-if2). Type: integer
+| | ... | - tx_port - Source interface (TG-if1). Type: string
+| | ... | - tx_mac - MAC address of source interface (TG-if1). Type: string
+| | ... | - rx_port - Destionation interface (TG-if2). Type: string
+| | ... | - rx_mac - MAC address of DUT interface (DUT-if1). Type: string
+| | ...
+| | ... | *Example:*
+| | ...
+| | ... | \| Verify Route IPv4 \| ${nodes['TG']} \
+| | ... | \| 16.0.0.1 \| 32.0.0.1 \| eth1 \| 08:00:27:cc:4f:54 \
+| | ... | \| eth2 \| 08:00:27:c9:6a:d5 \|
+| | ...
+| | [Arguments] | ${tg_node} | ${src_ip} | ${dst_ip} | ${tx_port}
+| | ... | ${tx_mac} | ${rx_port} | ${rx_mac}
+| | ${tx_port_name}= | Get interface name | ${tg_node} | ${tx_port}
+| | ${rx_port_name}= | Get interface name | ${tg_node} | ${rx_port}
+| | ${args}= | Catenate | --src_mac | ${tx_mac}
+| | ...                 | --dst_mac | ${rx_mac}
+| | ...                 | --src_ip | ${src_ip}
+| | ...                 | --dst_ip | ${dst_ip}
+| | ...                 | --tx_if | ${tx_port_name}
+| | ...                 | --rx_if | ${rx_port_name}
+| | Run Traffic Script On Node | send_ip_icmp.py | ${tg_node} | ${args}
+
+| Verify Route IPv6
+| | [Documentation] | Send an ICMPv6 packet from one TG interface and receive\
+| | ... | it on the other TG interface.
+| | ...
+| | ... | *Arguments:*
+| | ...
+| | ... | _NOTE:_ Arguments are based on topology:
+| | ...             | TG(if1)->(if1)DUT(if2)->TG(if2)
+| | ...
+| | ... | - tg_node - Node to execute scripts on (TG). Type: dictionary
+| | ... | - src_ip - IP of source interface (TG-if1). Type: integer
+| | ... | - dst_ip - IP of destination interface (TG-if2). Type: integer
+| | ... | - tx_port - Source interface (TG-if1). Type: string
+| | ... | - tx_mac - MAC address of source interface (TG-if1). Type: string
+| | ... | - rx_port - Destionation interface (TG-if2). Type: string
+| | ... | - rx_mac - MAC address of DUT interface (DUT-if1). Type: string
+| | ...
+| | ... | *Example:*
+| | ...
+| | ... | \| Verify Route IPv6 \| ${nodes['TG']} \
+| | ... | \| 10::1 \| 11::1 \| eth2 \| 08:00:27:cc:4f:54 \
+| | ... | \| eth4 \| 08:00:27:c9:6a:d5 \|
+| | ...
+| | [Arguments] | ${tg_node} | ${src_ip} | ${dst_ip} | ${tx_port}
+| | ... | ${tx_mac} | ${rx_port} | ${rx_mac}
+| | ${tx_port_name}= | Get interface name | ${tg_node} | ${tx_port}
+| | ${rx_port_name}= | Get interface name | ${tg_node} | ${rx_port}
+| | ${args}= | Catenate | --src_mac | ${tx_mac}
+| | ...                 | --dst_mac | ${rx_mac}
+| | ...                 | --src_ip | ${src_ip}
+| | ...                 | --dst_ip | ${dst_ip}
+| | ...                 | --tx_if | ${tx_port_name}
+| | ...                 | --rx_if | ${rx_port_name}
+| | Run Traffic Script On Node | send_ip_icmp.py | ${tg_node} | ${args}
+
+| Verify multipath route
+| | [Documentation] | Send 100 ICMP or ICMPv6 packets from one TG interface\
+| | ... | and receive them on the other TG interface. Verify destination MAC\
+| | ... | addresses of the packets so that exactly 50 of them use the first\
+| | ... | address and the other 50 use the second address.
+| | ...
+| | ... | *Arguments:*
+| | ...
+| | ... | _NOTE:_ Arguments are based on topology:
+| | ...             | TG(if1)->(if1)DUT(if2)->TG(if2)
+| | ...
+| | ... | - tg_node - Node to execute scripts on (TG). Type: dictionary
+| | ... | - src_ip - IP of source interface (TG-if1). Type: integer
+| | ... | - dst_ip - IP of destination interface (TG-if2). Type: integer
+| | ... | - tx_port - Source interface (TG-if1). Type: string
+| | ... | - tx_src_mac - MAC address of source interface (TG-if1). Type: string
+| | ... | - rx_port - Destionation interface (TG-if2). Type: string
+| | ... | - tx_dst_mac - MAC address of DUT ingress interface (DUT-if1).\
+| | ... | Type: string
+| | ... | - rx_src_mac - MAC address of DUT egress interface (DUT-if2).\
+| | ... | Type: string
+| | ... | - rx_dst_mac1 - MAC address of first next-hop option. Type: string
+| | ... | - rx_dst_mac2 - MAC address of second next-hop option. Type: string
+| | ... |
+| | ...
+| | ... | *Example:*
+| | ...
+| | ... | \| Verify multipath route \| ${nodes['TG']} \
+| | ... | \| 16.0.0.1 \| 32.0.0.1 \| eth2 \| 08:00:27:cc:4f:54 \
+| | ... | \| eth4 \| 08:00:27:c9:6a:d5 \|
+| | ... | \| 00:00:00:00:00:01 \| 00:00:00:00:00:02 \|
+| | ...
+| | [Arguments] | ${tg_node} | ${src_ip} | ${dst_ip} | ${tx_port}
+| | ... | ${tx_src_mac} | ${rx_port} | ${tx_dst_mac} | ${rx_src_mac}
+| | ... | ${rx_dst_mac1} | ${rx_dst_mac2}
+| | ${tx_port_name}= | Get interface name | ${tg_node} | ${tx_port}
+| | ${rx_port_name}= | Get interface name | ${tg_node} | ${rx_port}
+| | ${args}= | Catenate | --tg_if1_mac | ${tx_src_mac}
+| | ...                 | --dut_if1_mac | ${tx_dst_mac}
+| | ...                 | --src_ip | ${src_ip}
+| | ...                 | --dst_ip | ${dst_ip}
+| | ...                 | --tx_if | ${tx_port_name}
+| | ...                 | --rx_if | ${rx_port_name}
+| | ...                 | --dut_if2_mac | ${rx_src_mac}
+| | ...                 | --path_1_mac | ${rx_dst_mac_1}
+| | ...                 | --path_2_mac | ${rx_dst_mac_2}
+| | Run Traffic Script On Node | send_icmp_check_multipath.py | ${tg_node}
+| | ... | ${args}
\ No newline at end of file
diff --git a/resources/templates/honeycomb/config_routing_table.url b/resources/templates/honeycomb/config_routing_table.url
new file mode 100644
index 0000000000..9c15c49912
--- /dev/null
+++ b/resources/templates/honeycomb/config_routing_table.url
@@ -0,0 +1 @@
+/restconf/config/hc2vpp-ietf-routing:routing/routing-instance/vpp-routing-instance/routing-protocols
\ No newline at end of file
diff --git a/resources/templates/honeycomb/oper_routing_table.url b/resources/templates/honeycomb/oper_routing_table.url
new file mode 100644
index 0000000000..0b34793d70
--- /dev/null
+++ b/resources/templates/honeycomb/oper_routing_table.url
@@ -0,0 +1 @@
+/restconf/operational/hc2vpp-ietf-routing:routing-state/routing-instance/vpp-routing-instance/routing-protocols
\ No newline at end of file
diff --git a/resources/test_data/honeycomb/routing.py b/resources/test_data/honeycomb/routing.py
new file mode 100644
index 0000000000..df7d94121c
--- /dev/null
+++ b/resources/test_data/honeycomb/routing.py
@@ -0,0 +1,221 @@
+# Copyright (c) 2017 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.
+
+"""Test data for Honeycomb routing test."""
+
+from resources.libraries.python.topology import Topology
+
+
+def get_variables(node, ip_version, out_interface):
+
+    out_interface = Topology.convert_interface_reference(
+        node, out_interface, "name")
+
+    ip_version = ip_version.lower()
+    variables = {}
+
+    # base network settings
+    ipv4_base = {
+        "dut_to_tg_if1_ip": "16.0.0.1",
+        "dut_to_tg_if2_ip": "16.0.1.1",
+        "src_ip": "16.0.0.2",
+        "dst_ip": "16.0.2.1",
+        "dst_net": "16.0.2.0",
+        "prefix_len": 24,
+        "next_hop": "16.0.1.2",
+        "next_hop1": "16.0.1.3",
+        "next_hop2": "16.0.1.4",
+        "next_hop_mac1": "00:11:22:33:44:55",
+        "next_hop_mac2": "11:22:33:44:55:66"
+    }
+
+    ipv6_base = {
+        "dut_to_tg_if1_ip": "10::1",
+        "dut_to_tg_if2_ip": "11::1",
+        "src_ip": "10::2",
+        "dst_ip": "12::1",
+        "dst_net": "12::0",
+        "dst_net_full": "12:0:0:0:0:0:0:0",
+        "prefix_len": 64,
+        "next_hop": "11::2",
+        "next_hop1": "11::3",
+        "next_hop2": "11::4",
+        "next_hop_mac1": "00:11:22:33:44:55",
+        "next_hop_mac2": "11:22:33:44:55:66"
+    }
+
+    if ip_version == "ipv4":
+        variables.update(ipv4_base)
+    elif ip_version == "ipv6":
+        variables.update(ipv6_base)
+    else:
+        raise ValueError("IP version must be either IPv4 or IPv6.")
+
+    # route configuration used in tests
+    tables_cfg = {
+        "table1": {
+            "id": 1,
+            "description": "single hop ipv4",
+            "destination-prefix":
+                "{0}/{1}".format(ipv4_base["dst_net"], ipv4_base["prefix_len"]),
+            "next-hop": ipv4_base["next_hop"],
+            "outgoing-interface": out_interface,
+            "vpp-ipv4-route": {}
+        },
+        "table2": {
+            "id": 1,
+            "description": "multi hop ipv4",
+            "destination-prefix":
+                "{0}/{1}".format(ipv4_base["dst_net"], ipv4_base["prefix_len"]),
+            "next-hop-list": {
+                "next-hop": [
+                    {
+                        "id": 1,
+                        "address": ipv4_base["next_hop1"],
+                        "outgoing-interface": out_interface,
+                        "weight": "1"
+                    },
+                    {
+                        "id": 2,
+                        "address": ipv4_base["next_hop2"],
+                        "outgoing-interface": out_interface,
+                        "weight": "1"
+                    }
+                ]
+            }
+        },
+        "table3": {
+            "id": 1,
+            "description": "blackhole ipv4",
+            "destination-prefix":
+                "{0}/{1}".format(ipv4_base["dst_net"], ipv4_base["prefix_len"]),
+            "special-next-hop": "receive"
+        },
+        "table4": {
+            "id": 1,
+            "description": "single hop ipv6",
+            "destination-prefix":
+                "{0}/{1}".format(ipv6_base["dst_net"], ipv6_base["prefix_len"]),
+            "next-hop": ipv6_base["next_hop"],
+            "outgoing-interface": out_interface,
+            "vpp-ipv6-route": {}
+        },
+        "table5": {
+            "id": 1,
+            "description": "multi hop ipv6",
+            "destination-prefix":
+                "{0}/{1}".format(ipv6_base["dst_net"], ipv6_base["prefix_len"]),
+            "next-hop-list": {
+                "next-hop": [
+                    {
+                        "id": 1,
+                        "address": ipv6_base["next_hop1"],
+                        "outgoing-interface": out_interface,
+                        "weight": "1"
+                    },
+                    {
+                        "id": 2,
+                        "address": ipv6_base["next_hop2"],
+                        "outgoing-interface": out_interface,
+                        "weight": "1"
+                    }
+                ]
+            }
+        },
+        "table6": {
+            "id": 1,
+            "description": "blackhole ipv6",
+            "destination-prefix":
+                "{0}/{1}".format(ipv6_base["dst_net"], ipv6_base["prefix_len"]),
+            "special-next-hop": "blackhole"
+        }
+    }
+
+    # expected route operational data
+    tables_oper = {
+        "table1_oper": {
+            "destination-prefix":
+                "{0}/{1}".format(ipv4_base["dst_net"], ipv4_base["prefix_len"]),
+            "next-hop": ipv4_base["next_hop"],
+            "outgoing-interface": out_interface,
+            "vpp-ipv4-route-state": {}
+        },
+        "table2_oper": {
+            "destination-prefix":
+                "{0}/{1}".format(ipv4_base["dst_net"], ipv4_base["prefix_len"]),
+            "next-hop-list": {
+                "next-hop": [
+                    {
+                        "address": ipv4_base["next_hop1"],
+                        "outgoing-interface": out_interface,
+                        "weight": 1
+                    },
+                    {
+                        "address": ipv4_base["next_hop2"],
+                        "outgoing-interface": out_interface,
+                        "weight": 1
+                    }
+                ]
+            },
+            'vpp-ipv4-route-state': {}
+        },
+        "table3_oper": {
+            "destination-prefix":
+                "{0}/{1}".format(ipv4_base["dst_net"], ipv4_base["prefix_len"]),
+            "special-next-hop": "receive",
+            "vpp-ipv4-route-state": {}
+        },
+        "table4_oper": {
+            "destination-prefix":
+                "{0}/{1}".format(ipv6_base["dst_net_full"],
+                                 ipv6_base["prefix_len"]),
+            "next-hop": ipv6_base["next_hop"],
+            "outgoing-interface": out_interface,
+            "vpp-ipv6-route-state": {}
+        },
+        "table5_oper": {
+            "destination-prefix":
+                "{0}/{1}".format(ipv6_base["dst_net_full"],
+                                 ipv6_base["prefix_len"]),
+            "next-hop-list": {
+                "next-hop": [
+                    {
+                        "address": ipv6_base["next_hop1"],
+                        "outgoing-interface": out_interface,
+                        "weight": 1
+                    },
+                    {
+                        "address": ipv6_base["next_hop2"],
+                        "outgoing-interface": out_interface,
+                        "weight": 1
+                    }
+                ]
+            },
+            "vpp-ipv6-route-state": {}
+        },
+        "table6_oper": {
+            "destination-prefix":
+                "{0}/{1}".format(ipv6_base["dst_net_full"],
+                                 ipv6_base["prefix_len"]),
+            "special-next-hop": "blackhole",
+            'vpp-ipv6-route-state': {}
+        }
+    }
+
+    for item in tables_oper.values():
+        if "next-hop-list" in item.keys():
+            item["next-hop-list"]["next-hop"].sort()
+
+    variables.update(tables_cfg)
+    variables.update(tables_oper)
+    return variables
diff --git a/tests/func/honeycomb/mgmt-cfg-routing-apihc-apivat-func.robot b/tests/func/honeycomb/mgmt-cfg-routing-apihc-apivat-func.robot
new file mode 100644
index 0000000000..6651cd7fa2
--- /dev/null
+++ b/tests/func/honeycomb/mgmt-cfg-routing-apihc-apivat-func.robot
@@ -0,0 +1,211 @@
+# Copyright (c) 2017 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 ***
+| Library | resources.libraries.python.honeycomb.Routing.RoutingKeywords
+| Library | resources.libraries.python.Trace.Trace
+| 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/honeycomb/honeycomb.robot
+| Resource | resources/libraries/robot/honeycomb/interfaces.robot
+| Resource | resources/libraries/robot/honeycomb/routing.robot
+| Suite Setup | Vpp nodes ra suppress link layer | ${nodes}
+| Test Setup | Clear Packet Trace on All DUTs | ${nodes}
+| Suite Teardown | Run Keyword If Any Tests Failed
+| ... | Restart Honeycomb And VPP And Clear Persisted Configuration | ${node}
+| Test Teardown | Honeycomb routing test teardown
+| ... | ${node} | ${table}
+| Documentation | *Honeycomb routing test suite.*
+| Force Tags | Honeycomb_sanity
+
+*** Test Cases ***
+| TC01: Single hop IPv4 route
+| | [Documentation]
+| | ... | [Top] TG=DUT1=TG.
+| | ... | [Enc] Eth-IPv4-ICMP.
+| | ... | [Cfg] (Using Honeycomb API) On DUT1 add ARP entries to both TG\
+| | ... | interfaces and configure route with TG-if2 as next-hop.
+| | ... | [Ver] Send ICMP packet from first TG interface to configured route
+| | ... | destination. Receive packet on the second TG interface.
+| | ${table}= | Set Variable | table1
+| | Given Setup interfaces and neighbors for IPv4 routing test
+| | When Honeycomb configures routing table
+| | ... | ${node} | table1 | ipv4 | ${table1} | ${1}
+| | Then Routing data from Honeycomb should contain
+| | ... | ${node} | table1 | ipv4 | ${table1_oper}
+| | And Verify Route IPv4 | ${nodes['TG']}
+| | ... | ${src_ip} | ${dst_ip}
+| | ... | ${tg_to_dut_if1} | ${tg_to_dut_if1_mac}
+| | ... | ${tg_to_dut_if2} | ${dut_to_tg_if1_mac}
+
+| TC02: Multi hop IPv4 route
+| | [Documentation]
+| | ... | [Top] TG=DUT1=TG.
+| | ... | [Enc] Eth-IPv4-ICMP.
+| | ... | [Cfg] (Using Honeycomb API) On DUT1 add ARP entries to both TG\
+| | ... | interfaces and configure two routes through the second DUT interface.
+| | ... | [Ver] Send 100 ICMP packets from first TG interface to configured
+| | ... | route destination. Receive all packets on the second TG interface and\
+| | ... | verify that each destination MAC was used by exactly 50 packets.
+| | ... | Receive packet on the second TG interface.
+| | ${table}= | Set Variable | table2
+| | Given Setup interfaces and neighbors for IPv4 routing test
+| | And Honeycomb adds interface ipv4 neighbor | ${dut_node} | ${dut_to_tg_if2}
+| | ... | ${next_hop1} | ${next_hop_mac1}
+| | And Honeycomb adds interface ipv4 neighbor | ${dut_node} | ${dut_to_tg_if2}
+| | ... | ${next_hop2} | ${next_hop_mac2}
+| | When Honeycomb configures routing table
+| | ... | ${node} | table2 | ipv4 | ${table2} | ${1}
+| | Then Routing data from Honeycomb should contain
+| | ... | ${node} | table2 | ipv4 | ${table2_oper}
+| | And Verify multipath Route | ${nodes['TG']}
+| | ... | ${src_ip} | ${dst_ip}
+| | ... | ${tg_to_dut_if1} | ${tg_to_dut_if1_mac}
+| | ... | ${tg_to_dut_if2} | ${dut_to_tg_if1_mac}
+| | ... | ${dut_to_tg_if2_mac} | ${next_hop_mac1} | ${next_hop_mac2}
+
+| TC03: Special hop - blackhole IPv4 route
+| | [Documentation]
+| | ... | [Top] TG=DUT1=TG.
+| | ... | [Enc] Eth-IPv4-ICMP.
+| | ... | [Cfg] (Using Honeycomb API) On DUT1 add ARP entries to both TG\
+| | ... | interfaces and configure route with special rule blackhole.
+| | ... | [Ver] Send ICMP packet from first TG interface to configured route
+| | ... | destination. Make sure no packet is received on the second TG\
+| | ... | interface.
+| | ${table}= | Set Variable | table3
+| | Given Setup interfaces and neighbors for IPv4 routing test
+| | When Honeycomb configures routing table
+| | ... | ${node} | table3 | ipv4 | ${table3} | ${1} | special=${TRUE}
+| | Then Routing data from Honeycomb should contain
+| | ... | ${node} | table3 | ipv4 | ${table3_oper}
+| | And Run keyword and Expect Error | ICMP echo Rx timeout
+| | ... | Verify Route IPv4 | ${nodes['TG']}
+| | ... | ${src_ip} | ${dst_ip}
+| | ... | ${tg_to_dut_if1} | ${tg_to_dut_if1_mac}
+| | ... | ${tg_to_dut_if2} | ${dut_to_tg_if1_mac}
+
+| TC04: Single hop IPv6 route
+| | [Documentation]
+| | ... | [Top] TG=DUT1=TG.
+| | ... | [Enc] Eth-IPv6-ICMPv6.
+| | ... | [Cfg] (Using Honeycomb API) On DUT1 add ARP entries to both TG\
+| | ... | interfaces and configure route with TG-if2 as next-hop.
+| | ... | [Ver] Send ICMP packet from first TG interface to configured route
+| | ... | destination. Receive packet on the second TG interface.
+| | ${table}= | Set Variable | table4
+| | Given Setup interfaces and neighbors for IPv6 routing test
+| | When Honeycomb configures routing table
+| | ... | ${node} | table4 | ipv6 | ${table4} | ${1}
+| | Then Routing data from Honeycomb should contain
+| | ... | ${node} | table4 | ipv6 | ${table4_oper}
+| | And Verify Route IPv6 | ${nodes['TG']}
+| | ... | ${src_ip} | ${next_hop}
+| | ... | ${tg_to_dut_if1} | ${tg_to_dut_if1_mac}
+| | ... | ${tg_to_dut_if2} | ${dut_to_tg_if1_mac}
+
+| TC05: Multi hop IPv6 route
+| | [Documentation]
+| | ... | [Top] TG=DUT1=TG.
+| | ... | [Enc] Eth-IPv6-ICMPv6.
+| | ... | [Cfg] (Using Honeycomb API) On DUT1 add ARP entries to both TG\
+| | ... | interfaces and configure two routes through the second DUT interface.
+| | ... | [Ver] Send 100 ICMP packets from first TG interface to configured
+| | ... | route destination. Receive all packets on the second TG interface and\
+| | ... | verify that each destination MAC was used by exactly 50 packets.
+| | ... | Receive packet on the second TG interface.
+| | ${table}= | Set Variable | table5
+| | Given Setup interfaces and neighbors for IPv6 routing test
+| | And Honeycomb adds interface ipv6 neighbor | ${dut_node} | ${dut_to_tg_if2}
+| | ... | ${next_hop1} | ${next_hop_mac1}
+| | And Honeycomb adds interface ipv6 neighbor | ${dut_node} | ${dut_to_tg_if2}
+| | ... | ${next_hop2} | ${next_hop_mac2}
+| | When Honeycomb configures routing table
+| | ... | ${node} | table5 | ipv6 | ${table5} | ${1}
+| | Then Routing data from Honeycomb should contain
+| | ... | ${node} | table5 | ipv6 | ${table5_oper}
+| | And Verify multipath Route | ${nodes['TG']}
+| | ... | ${src_ip} | ${dst_ip}
+| | ... | ${tg_to_dut_if1} | ${tg_to_dut_if1_mac}
+| | ... | ${tg_to_dut_if2} | ${dut_to_tg_if1_mac}
+| | ... | ${dut_to_tg_if2_mac} | ${next_hop_mac1} | ${next_hop_mac2}
+
+| TC06: Special hop - blackhole IPv6 route
+| | [Documentation]
+| | ... | [Top] TG=DUT1=TG.
+| | ... | [Enc] Eth-IPv6-ICMPv6.
+| | ... | [Cfg] (Using Honeycomb API) On DUT1 add ARP entries to both TG\
+| | ... | interfaces and configure route with special rule blackhole.
+| | ... | [Ver] Send ICMP packet from first TG interface to configured route
+| | ... | destination. Make sure no packet is received on the second TG\
+| | ... | interface.
+| | ${table}= | Set Variable | table6
+| | Given Setup interfaces and neighbors for IPv6 routing test
+| | When Honeycomb configures routing table
+| | ... | ${node} | table6 | ipv6 | ${table6} | ${1} | special=${TRUE}
+| | Then Routing data from Honeycomb should contain
+| | ... | ${node} | table6 | ipv6 | ${table6_oper}
+| | And Run keyword and Expect Error | ICMP echo Rx timeout
+| | ... | Verify Route IPv6 | ${nodes['TG']}
+| | ... | ${src_ip} | ${dst_ip}
+| | ... | ${tg_to_dut_if1} | ${tg_to_dut_if1_mac}
+| | ... | ${tg_to_dut_if2} | ${dut_to_tg_if1_mac}
+
+*** Keywords ***
+| Setup interfaces and neighbors for IPv4 routing test
+| | Path for 2-node testing is set
+| | ... | ${nodes['TG']} | ${nodes['DUT1']} | ${nodes['TG']}
+| | Import Variables | resources/test_data/honeycomb/routing.py
+| | ... | ${nodes['DUT1']} | ipv4 | ${dut_to_tg_if2}
+| | Honeycomb sets interface vrf ID
+| | ... | ${dut_node} | ${dut_to_tg_if1} | ${1} | ipv4
+| | Honeycomb sets interface vrf ID
+| | ... | ${dut_node} | ${dut_to_tg_if2} | ${1} | ipv4
+| | Honeycomb sets interface state | ${dut_node} | ${dut_to_tg_if1} | up
+| | Honeycomb sets interface state | ${dut_node} | ${dut_to_tg_if2} | up
+| | Honeycomb sets interface ipv4 address with prefix | ${dut_node}
+| | ... | ${dut_to_tg_if1} | ${dut_to_tg_if1_ip} | ${prefix_len}
+| | Honeycomb sets interface ipv4 address with prefix | ${dut_node}
+| | ... | ${dut_to_tg_if2} | ${dut_to_tg_if2_ip} | ${prefix_len}
+| | Honeycomb adds interface ipv4 neighbor | ${dut_node} | ${dut_to_tg_if1}
+| | ... | ${src_ip} | ${tg_to_dut_if1_mac}
+| | Honeycomb adds interface ipv4 neighbor | ${dut_node} | ${dut_to_tg_if2}
+| | ... | ${next_hop} | ${tg_to_dut_if2_mac}
+
+| Setup interfaces and neighbors for IPv6 routing test
+| | Path for 2-node testing is set
+| | ... | ${nodes['TG']} | ${nodes['DUT1']} | ${nodes['TG']}
+| | Import Variables | resources/test_data/honeycomb/routing.py
+| | ... | ${nodes['DUT1']} | ipv6 | ${dut_to_tg_if2}
+| | Honeycomb sets interface vrf ID
+| | ... | ${dut_node} | ${dut_to_tg_if1} | ${1} | ipv6
+| | Honeycomb sets interface vrf ID
+| | ... | ${dut_node} | ${dut_to_tg_if2} | ${1} | ipv6
+| | Honeycomb sets interface state | ${dut_node} | ${dut_to_tg_if1} | up
+| | Honeycomb sets interface state | ${dut_node} | ${dut_to_tg_if2} | up
+| | Honeycomb sets interface ipv6 address | ${dut_node}
+| | ... | ${dut_to_tg_if1} | ${dut_to_tg_if1_ip} | ${prefix_len}
+| | Honeycomb sets interface ipv6 address | ${dut_node}
+| | ... | ${dut_to_tg_if2} | ${dut_to_tg_if2_ip} | ${prefix_len}
+| | Honeycomb adds interface ipv6 neighbor | ${dut_node} | ${dut_to_tg_if1}
+| | ... | ${src_ip} | ${tg_to_dut_if1_mac}
+| | Honeycomb adds interface ipv6 neighbor | ${dut_node} | ${dut_to_tg_if2}
+| | ... | ${next_hop} | ${tg_to_dut_if2_mac}
+
+| Honeycomb routing test teardown
+| | [arguments] | ${node} | ${routing_table}
+| | Show Packet Trace on All DUTs | ${nodes}
+| | Log routing configuration from VAT | ${node}
+| | Honeycomb removes routing configuration | ${node} | ${routing_table}