path: root/yardstick/network_services/vnf_generic/vnf/tg_rfc2544_trex.py

# Copyright (c) 2016-2017 Intel Corporation
#
# 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.
""" Trex traffic generation definitions which implements rfc2544 """

from __future__ import absolute_import
from __future__ import print_function
import multiprocessing
import time
import logging
import os
import yaml

from yardstick import ssh
from yardstick.network_services.vnf_generic.vnf.base import GenericTrafficGen
from yardstick.network_services.utils import get_nsb_option
from stl.trex_stl_lib.trex_stl_client import STLClient
from stl.trex_stl_lib.trex_stl_client import LoggerApi
from stl.trex_stl_lib.trex_stl_exceptions import STLError

LOGGING = logging.getLogger(__name__)

DURATION = 30
WAIT_TIME = 3
TREX_SYNC_PORT = 4500
TREX_ASYNC_PORT = 4501


class TrexTrafficGenRFC(GenericTrafficGen):
    """
    This class handles mapping traffic profile and generating
    traffic for rfc2544 testcase.
    """

    def __init__(self, vnfd):
        super(TrexTrafficGenRFC, self).__init__(vnfd)
        self._result = {}
        self._terminated = multiprocessing.Value('i', 0)
        self._queue = multiprocessing.Queue()
        self._terminated = multiprocessing.Value('i', 0)
        self._traffic_process = None
        self._vpci_ascending = None
        self.tc_file_name = None
        self.client = None
        self.my_ports = None

        mgmt_interface = self.vnfd["mgmt-interface"]

        self.connection = ssh.SSH.from_node(mgmt_interface)
        self.connection.wait()

    @classmethod
    def _split_mac_address_into_list(cls, mac):
        octets = mac.split(':')
        for i, elem in enumerate(octets):
            octets[i] = "0x" + str(elem)
        return octets

    def _generate_trex_cfg(self, vnfd):
        """

        :param vnfd: vnfd.yaml
        :return: trex_cfg.yaml file
        """
        trex_cfg = dict(
            port_limit=0,
            version='2',
            interfaces=[],
            port_info=list(dict(
            ))
        )
        trex_cfg["port_limit"] = len(vnfd["vdu"][0]["external-interface"])
        trex_cfg["version"] = '2'

        cfg_file = []
        vpci = []
        port = {}

        ext_intf = vnfd["vdu"][0]["external-interface"]
        for interface in ext_intf:
            virt_intf = interface["virtual-interface"]
            vpci.append(virt_intf["vpci"])

            port["src_mac"] = \
                self._split_mac_address_into_list(virt_intf["local_mac"])

            time.sleep(WAIT_TIME)
            port["dest_mac"] = \
                self._split_mac_address_into_list(virt_intf["dst_mac"])
            if virt_intf["dst_mac"]:
                trex_cfg["port_info"].append(port.copy())

        trex_cfg["interfaces"] = vpci
        cfg_file.append(trex_cfg)

        with open('/tmp/trex_cfg.yaml', 'w') as outfile:
            outfile.write(yaml.safe_dump(cfg_file, default_flow_style=False))
        self.connection.put('/tmp/trex_cfg.yaml', '/etc')

        self._vpci_ascending = sorted(vpci)

    def scale(self, flavor=""):
        ''' scale vnfbased on flavor input '''
        super(TrexTrafficGenRFC, self).scale(flavor)

    def instantiate(self, scenario_cfg, context_cfg):
        self._generate_trex_cfg(self.vnfd)
        self.tc_file_name = '{0}.yaml'.format(scenario_cfg['tc'])
        trex = os.path.join(self.bin_path, "trex")
        err, _, _ = \
            self.connection.execute("ls {} >/dev/null 2>&1".format(trex))
        if err != 0:
            self.connection.put(trex, trex, True)

        LOGGING.debug("Starting TRex server...")
        _tg_server = \
            multiprocessing.Process(target=self._start_server)
        _tg_server.start()
        while True:
            LOGGING.info("Waiting for TG Server to start.. ")
            time.sleep(WAIT_TIME)

            status = \
                self.connection.execute("lsof -i:%s" % TREX_SYNC_PORT)[0]
            if status == 0:
                LOGGING.info("TG server is up and running.")
                return _tg_server.exitcode
            if not _tg_server.is_alive():
                raise RuntimeError("Traffic Generator process died.")

    def listen_traffic(self, traffic_profile):
        pass

    def _get_logical_if_name(self, vpci):
        ext_intf = self.vnfd["vdu"][0]["external-interface"]
        for interface in range(len(self.vnfd["vdu"][0]["external-interface"])):
            virtual_intf = ext_intf[interface]["virtual-interface"]
            if virtual_intf["vpci"] == vpci:
                return ext_intf[interface]["name"]

    def run_traffic(self, traffic_profile,
                    client_started=multiprocessing.Value('i', 0)):

        self._traffic_process = \
            multiprocessing.Process(target=self._traffic_runner,
                                    args=(traffic_profile, self._queue,
                                          client_started, self._terminated))
        self._traffic_process.start()
        # Wait for traffic process to start
        while client_started.value == 0:
            time.sleep(1)

        return self._traffic_process.is_alive()

    def _start_server(self):
        mgmt_interface = self.vnfd["mgmt-interface"]

        _server = ssh.SSH.from_node(mgmt_interface)
        _server.wait()

        _server.execute("fuser -n tcp %s %s -k > /dev/null 2>&1" %
                        (TREX_SYNC_PORT, TREX_ASYNC_PORT))
        _server.execute("pkill -9 rex > /dev/null 2>&1")

        trex_path = os.path.join(self.bin_path, "trex/scripts")
        path = get_nsb_option("trex_path", trex_path)
        trex_cmd = "cd " + path + "; sudo ./t-rex-64 -i > /dev/null 2>&1"

        _server.execute(trex_cmd)

    def _connect_client(self, client=None):
        if client is None:
            client = STLClient(username=self.vnfd["mgmt-interface"]["user"],
                               server=self.vnfd["mgmt-interface"]["ip"],
                               verbose_level=LoggerApi.VERBOSE_QUIET)
        for idx in range(6):
            try:
                client.connect()
                break
            except STLError:
                LOGGING.info("Unable to connect to Trex. Attempt %s", idx)
                time.sleep(WAIT_TIME)
        return client

    @classmethod
    def _get_rfc_tolerance(cls, tc_yaml):
        tolerance = '0.8 - 1.0'
        if 'tc_options' in tc_yaml['scenarios'][0]:
            tc_options = tc_yaml['scenarios'][0]['tc_options']
            if 'rfc2544' in tc_options:
                tolerance = \
                    tc_options['rfc2544'].get('allowed_drop_rate', '0.8 - 1.0')

        tolerance = tolerance.split('-')
        min_tol = float(tolerance[0])
        if len(tolerance) == 2:
            max_tol = float(tolerance[1])
        else:
            max_tol = float(tolerance[0])

        return [min_tol, max_tol]

    def _traffic_runner(self, traffic_profile, queue,
                        client_started, terminated):
        LOGGING.info("Starting TRex client...")
        tc_yaml = {}

        with open(self.tc_file_name) as tc_file:
            tc_yaml = yaml.load(tc_file.read())

        tolerance = self._get_rfc_tolerance(tc_yaml)

        # fixme: fix passing correct trex config file,
        # instead of searching the default path
        self.my_ports = [0, 1]
        self.client = self._connect_client()
        self.client.reset(ports=self.my_ports)
        self.client.remove_all_streams(self.my_ports)  # remove all streams
        while not terminated.value:
            traffic_profile.execute(self)
            client_started.value = 1
            time.sleep(DURATION)
            self.client.stop(self.my_ports)
            time.sleep(WAIT_TIME)
            last_res = self.client.get_stats(self.my_ports)
            samples = {}
            for vpci_idx in range(len(self._vpci_ascending)):
                name = \
                    self._get_logical_if_name(self._vpci_ascending[vpci_idx])
                # fixme: VNFDs KPIs values needs to be mapped to TRex structure
                if not isinstance(last_res, dict):
                    terminated.value = 1
                    last_res = {}

                samples[name] = \
                    {"rx_throughput_fps":
                     float(last_res.get(vpci_idx, {}).get("rx_pps", 0.0)),
                     "tx_throughput_fps":
                     float(last_res.get(vpci_idx, {}).get("tx_pps", 0.0)),
                     "rx_throughput_mbps":
                     float(last_res.get(vpci_idx, {}).get("rx_bps", 0.0)),
                     "tx_throughput_mbps":
                     float(last_res.get(vpci_idx, {}).get("tx_bps", 0.0)),
                     "in_packets":
                     last_res.get(vpci_idx, {}).get("ipackets", 0),
                     "out_packets":
                     last_res.get(vpci_idx, {}).get("opackets", 0)}

            samples = \
                traffic_profile.get_drop_percentage(self, samples,
                                                    tolerance[0], tolerance[1])
            queue.put(samples)
        self.client.stop(self.my_ports)
        self.client.disconnect()
        queue.put(samples)

    def collect_kpi(self):
        if not self._queue.empty():
            result = self._queue.get()
            self._result.update(result)
        LOGGING.debug("trex collect Kpis %s", self._result)
        return self._result

    def terminate(self):
        self._terminated.value = 1  # stop Trex clinet

        self.connection.execute("fuser -n tcp %s %s -k > /dev/null 2>&1" %
                                (TREX_SYNC_PORT, TREX_ASYNC_PORT))

        if self._traffic_process:
            self._traffic_process.terminate()