# 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. """This module implements initialization and cleanup of DPDK environment.""" from robot.api import logger from resources.libraries.python.ssh import SSH, exec_cmd_no_error from resources.libraries.python.Constants import Constants from resources.libraries.python.topology import NodeType, Topology class DPDKTools(object): """This class implements: - Initialization of DPDK environment, - Cleanup of DPDK environment. """ @staticmethod def initialize_dpdk_environment(dut_node, dut_if1, dut_if2): """ Initialize the DPDK test environment on the dut_node. Load the module uio and igb_uio, then bind the test NIC to the igb_uio. :param dut_node: Will init the DPDK on this node. :param dut_if1: DUT interface name. :param dut_if2: DUT interface name. :type dut_node: dict :type dut_if1: str :type dut_if2: str :raises RuntimeError: If it fails to bind the interfaces to igb_uio. """ if dut_node['type'] == NodeType.DUT: pci_address1 = Topology.get_interface_pci_addr(dut_node, dut_if1) pci_address2 = Topology.get_interface_pci_addr(dut_node, dut_if2) ssh = SSH() ssh.connect(dut_node) arch = Topology.get_node_arch(dut_node) cmd = '{fwdir}/tests/dpdk/dpdk_scripts/init_dpdk.sh '\ '{pci1} {pci2} {arch}'.format(fwdir=Constants.REMOTE_FW_DIR, pci1=pci_address1, pci2=pci_address2, arch=arch) ret_code, _, _ = ssh.exec_command_sudo(cmd, timeout=600) if ret_code != 0: raise RuntimeError('Failed to bind the interfaces to igb_uio ' 'at node {name}'.\ format(name=dut_node['host'])) @staticmethod def cleanup_dpdk_environment(dut_node, dut_if1, dut_if2): """ Cleanup the DPDK test environment on the DUT node. Unbind the NIC from the igb_uio and bind them to the kernel driver. :param dut_node: Will cleanup the DPDK on this node. :param dut_if1: DUT interface name. :param dut_if2: DUT interface name. :type dut_node: dict :type dut_if1: str :type dut_if2: str :raises RuntimeError: If it fails to cleanup the dpdk. """ if dut_node['type'] == NodeType.DUT: pci_address1 = Topology.get_interface_pci_addr(dut_node, dut_if1) if1_driver = Topology.get_interface_driver(dut_node, dut_if1) pci_address2 = Topology.get_interface_pci_addr(dut_node, dut_if2) if2_driver = Topology.get_interface_driver(dut_node, dut_if2) ssh = SSH() ssh.connect(dut_node) cmd = '{fwdir}/tests/dpdk/dpdk_scripts/cleanup_dpdk.sh ' \ '{drv1} {pci1} {drv2} {pci2}'.\ format(fwdir=Constants.REMOTE_FW_DIR, drv1=if1_driver, pci1=pci_address1, drv2=if2_driver, pci2=pci_address2) ret_code, _, _ = ssh.exec_command_sudo(cmd, timeout=600) if ret_code != 0: raise RuntimeError('Failed to cleanup the dpdk at node {name}'. format(name=dut_node['host'])) @staticmethod def install_dpdk_test(node): """ Prepare the DPDK test environment :param node: Dictionary created from topology :type node: dict :returns: nothing :raises RuntimeError: If command returns nonzero return code. """ arch = Topology.get_node_arch(node) command = ('{fwdir}/tests/dpdk/dpdk_scripts/install_dpdk.sh {arch}'. format(fwdir=Constants.REMOTE_FW_DIR, arch=arch)) message = 'Install the DPDK failed!' exec_cmd_no_error(node, command, timeout=600, message=message) command = ('cat {fwdir}/download_dir/dpdk*/VERSION'. format(fwdir=Constants.REMOTE_FW_DIR)) message = 'Get DPDK version failed!' stdout, _ = exec_cmd_no_error(node, command, message=message) logger.info('DPDK Version: {version}'.format(version=stdout)) @staticmethod def install_dpdk_test_on_all_duts(nodes): """ Prepare the DPDK test environment on all DUTs. :param nodes: Nodes from topology file. :type nodes: dict :returns: nothing """ for node in nodes.values(): if node['type'] == NodeType.DUT: DPDKTools.install_dpdk_test(node)