aboutsummaryrefslogtreecommitdiffstats
path: root/resources/libraries/python
diff options
context:
space:
mode:
authorselias <samelias@cisco.com>2016-12-16 15:28:39 +0100
committerPeter Mikus <pmikus@cisco.com>2017-01-10 13:05:13 +0000
commit954e51613f8dbd4f2fa4a7c2cf7c066176bee963 (patch)
treed572e42249a63bb5b89ed4d5743d9d9c492d821b /resources/libraries/python
parente3ed9257cd7ef50b44eca72ef7d9ae6c7c792647 (diff)
CSIT-482: HC Test - NAT
- add NAT test suite - add keywords and methods for configuring and reading NAT settings - add test data used in NAT suite Change-Id: Iaa2ac1eb156bc9bcff41ec242318f6a973210d38 Signed-off-by: selias <samelias@cisco.com>
Diffstat (limited to 'resources/libraries/python')
-rw-r--r--resources/libraries/python/NAT.py107
-rw-r--r--resources/libraries/python/honeycomb/NAT.py143
2 files changed, 250 insertions, 0 deletions
diff --git a/resources/libraries/python/NAT.py b/resources/libraries/python/NAT.py
new file mode 100644
index 0000000000..d0e01c7f84
--- /dev/null
+++ b/resources/libraries/python/NAT.py
@@ -0,0 +1,107 @@
+# 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.
+
+"""NAT utilities library."""
+
+from resources.libraries.python.VatExecutor import VatExecutor
+
+
+class NATUtil(object):
+ """NAT utilities."""
+
+ def __init__(self):
+ pass
+
+ @staticmethod
+ def vpp_get_nat_static_mappings(node):
+ """Get NAT static mappings from VPP node.
+
+ :param node: VPP node.
+ :type node: dict
+ :returns: List of static mappings.
+ :rtype: list
+ :raises RuntimeError: If the output is not as expected.
+ """
+
+ vat = VatExecutor()
+ # JSON output not supported for this command
+ vat.execute_script('snat/snat_mapping_dump.vat', node, json_out=False)
+
+ stdout = vat.get_script_stdout()
+ lines = stdout.split("\n")
+
+ data = []
+ # lines[0,1] are table and column headers
+ for line in lines[2::]:
+ items = line.split(" ")
+ while "" in items:
+ items.remove("")
+ if len(items) == 0:
+ continue
+ elif len(items) == 3:
+ # no ports were returned
+ data.append({
+ "local_address": items[0],
+ "remote_address": items[1],
+ "vrf": items[2]
+ })
+ elif len(items) == 5:
+ data.append({
+ "local_address": items[0],
+ "local_port": items[1],
+ "remote_address": items[2],
+ "remote_port": items[3],
+ "vrf": items[4]
+ })
+ else:
+ raise RuntimeError("Unexpected output from span_mapping_dump.")
+
+ return data
+
+ @staticmethod
+ def vpp_get_nat_interfaces(node):
+ """Get list of interfaces configured with NAT from VPP node.
+
+ :param node: VPP node.
+ :type node: dict
+ :returns: List of interfaces on the node that are configured with NAT.
+ :rtype: list
+ :raises RuntimeError: If the output is not as expected.
+ """
+
+ vat = VatExecutor()
+ # JSON output not supported for this command
+ vat.execute_script('snat/snat_interface_dump.vat', node,
+ json_out=False)
+
+ stdout = vat.get_script_stdout()
+ lines = stdout.split("\n")
+
+ data = []
+ for line in lines:
+ items = line.split(" ")
+ while "" in items:
+ items.remove("")
+ if len(items) == 0:
+ continue
+ elif len(items) == 3:
+ data.append({
+ # items[0] is the table header - "sw_if_index"
+ "sw_if_index": items[1],
+ "direction": items[2]
+ })
+ else:
+ raise RuntimeError(
+ "Unexpected output from span_interface_dump.")
+
+ return data
diff --git a/resources/libraries/python/honeycomb/NAT.py b/resources/libraries/python/honeycomb/NAT.py
new file mode 100644
index 0000000000..1fb066d10c
--- /dev/null
+++ b/resources/libraries/python/honeycomb/NAT.py
@@ -0,0 +1,143 @@
+# 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.
+
+"""Keywords to manipulate NAT configuration using Honeycomb REST API."""
+
+from resources.libraries.python.topology import Topology
+from resources.libraries.python.HTTPRequest import HTTPCodes
+from resources.libraries.python.honeycomb.HoneycombSetup import HoneycombError
+from resources.libraries.python.honeycomb.HoneycombUtil \
+ import DataRepresentation
+from resources.libraries.python.honeycomb.HoneycombUtil \
+ import HoneycombUtil as HcUtil
+
+
+class NATKeywords(object):
+ """Keywords for NAT configuration."""
+
+ def __init__(self):
+ pass
+
+ @staticmethod
+ def _set_nat_properties(node, path, data=None):
+ """Set NAT 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
+ :returns: Content of response.
+ :rtype: bytearray
+ :raises HoneycombError: If the status code in response to PUT is not
+ OK or ACCEPTED.
+ """
+
+ if data:
+ status_code, resp = HcUtil. \
+ put_honeycomb_data(node, "config_nat", data, path,
+ data_representation=DataRepresentation.JSON)
+ else:
+ status_code, resp = HcUtil. \
+ delete_honeycomb_data(node, "config_nat", path)
+
+ if status_code not in (HTTPCodes.OK, HTTPCodes.ACCEPTED):
+ raise HoneycombError(
+ "The configuration of NAT was not successful. "
+ "Status code: {0}.".format(status_code))
+ return resp
+
+ @staticmethod
+ def get_nat_oper_data(node):
+ """Read NAT operational data.
+
+ :param node: Honeycomb node.
+ :type node: dict
+ :returns: Content of response.
+ :rtype: bytearray
+ :raises HoneycombError: If the operation fails or the response
+ is not as expected.
+ """
+
+ status_code, resp = HcUtil.get_honeycomb_data(node, "oper_nat")
+
+ if status_code != HTTPCodes.OK:
+ raise HoneycombError("Could not retrieve NAT operational data.")
+
+ if "nat-state" not in resp.keys():
+ raise HoneycombError(
+ "Unexpected format, response does not contain nat-state.")
+ return resp['nat-state']
+
+ @staticmethod
+ def configure_nat_entries(node, data, instance=0, entry=1):
+ """Configure NAT entries on node.
+
+ :param node: Honeycomb node.
+ :param data: Data to be configured on node.
+ :param instance: NAT instance ID.
+ :param entry: NAT entry index.
+ :type node: dict
+ :type data: dict
+ :type instance: int
+ :type entry: int
+ :returns: Content of response.
+ :rtype: bytearray
+ """
+
+ return NATKeywords._set_nat_properties(
+ node,
+ '/nat-instances/nat-instance/{0}/'
+ 'mapping-table/mapping-entry/{1}/'.format(instance, entry),
+ data)
+
+ @staticmethod
+ def configure_nat_on_interface(node, interface, direction, delete=False):
+ """Configure NAT on the specified interface.
+
+ :param node: Honeycomb node.
+ :param interface: Name of an interface on the node.
+ :param direction: NAT direction, outbound or inbound.
+ :param delete: Delete an existing interface NAT configuration.
+ :type node: dict
+ :type interface: str
+ :type direction: str
+ :type delete: bool
+ :returns: Content of response.
+ :rtype: bytearray
+ :raises HoneycombError: If the operation fails.
+ """
+
+ interface = Topology.convert_interface_reference(
+ node, interface, "name")
+
+ interface = interface.replace("/", "%2F")
+ path = "/interface/{0}/interface-nat:nat/{1}".format(
+ interface, direction)
+
+ data = {direction: {}}
+
+ if delete:
+ status_code, resp = HcUtil.delete_honeycomb_data(
+ node, "config_vpp_interfaces", path)
+ else:
+ status_code, resp = HcUtil.put_honeycomb_data(
+ node, "config_vpp_interfaces", data, path)
+
+ if status_code not in (HTTPCodes.OK, HTTPCodes.ACCEPTED):
+ raise HoneycombError(
+ "Could not configure NAT on interface. "
+ "Status code: {0}.".format(status_code))
+
+ return resp