aboutsummaryrefslogtreecommitdiffstats
path: root/resources/libraries/python
diff options
context:
space:
mode:
authorpmikus <pmikus@cisco.com>2016-08-02 11:34:29 +0100
committerPeter Mikus <pmikus@cisco.com>2016-08-17 15:07:54 +0000
commit74afb9bce89ee2ca456c9e9f1e5b016a3befc20e (patch)
tree06bf4247ac535fc028e07b46b5aa71faed69d3d6 /resources/libraries/python
parent2d928a03f626506f5beca37f41de5e00e62e9053 (diff)
CSIT-312 VPP vhost-user - VPP vhost-user driver, virtio in VM
- Add libraries and keywords to control Qemu VM and VMapp Change-Id: Iaaedfe240afe394f507ccaf0cf7a77c8b863acd3 Signed-off-by: pmikus <pmikus@cisco.com>
Diffstat (limited to 'resources/libraries/python')
-rw-r--r--resources/libraries/python/DpdkUtil.py109
-rw-r--r--resources/libraries/python/QemuUtils.py74
2 files changed, 141 insertions, 42 deletions
diff --git a/resources/libraries/python/DpdkUtil.py b/resources/libraries/python/DpdkUtil.py
new file mode 100644
index 0000000000..5eea0d6c26
--- /dev/null
+++ b/resources/libraries/python/DpdkUtil.py
@@ -0,0 +1,109 @@
+# 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.
+
+"""Dpdk Utilities Library."""
+
+from resources.libraries.python.ssh import SSH, exec_cmd_no_error
+
+
+class DpdkUtil(object):
+ """Utilities for DPDK."""
+
+ @staticmethod
+ def dpdk_testpmd_start(node, **args):
+ """Start DPDK testpmd app on VM node.
+
+ :param node: VM Node to start testpmd on.
+ :param args: List of testpmd parameters.
+ :type node: dict
+ :type args: list
+ :return: nothing
+ """
+ # Set the hexadecimal bitmask of the cores to run on.
+ eal_coremask = '-c {} '.format(args['eal_coremask'])\
+ if args.get('eal_coremask', '') else ''
+ # Set the number of memory channels to use.
+ eal_mem_channels = '-n {} '.format(args['eal_mem_channels'])\
+ if args.get('eal_mem_channels', '') else ''
+ # Set the memory to allocate on specific sockets (comma separated).
+ eal_socket_mem = '--socket-mem {} '.format(args['eal_socket_mem'])\
+ if args.get('eal_socket_mem', '') else ''
+ # Load an external driver. Multiple -d options are allowed.
+ eal_driver = '-d /usr/lib/librte_pmd_virtio.so '
+ # Set the forwarding mode: io, mac, mac_retry, mac_swap, flowgen,
+ # rxonly, txonly, csum, icmpecho, ieee1588
+ pmd_fwd_mode = '--forward-mode={} '.format(args['pmd_fwd_mode'])\
+ if args.get('pmd_fwd_mode', '') else ''
+ # Set the number of packets per burst to N.
+ pmd_burst = '--burst=64 '
+ # Set the number of descriptors in the TX rings to N.
+ pmd_txd = '--txd=2048 '
+ # Set the number of descriptors in the RX rings to N.
+ pmd_rxd = '--rxd=2048 '
+ # Set the hexadecimal bitmask of TX queue flags.
+ pmd_txqflags = '--txqflags=0xf00 '
+ # Set the number of mbufs to be allocated in the mbuf pools.
+ pmd_total_num_mbufs = '--total-num-mbufs=65536 '
+ # Set the hexadecimal bitmask of the ports for forwarding.
+ pmd_portmask = '--portmask=0x3 '
+ # Disable hardware VLAN.
+ pmd_disable_hw_vlan = '--disable-hw-vlan '\
+ if args.get('pmd_disable_hw_vlan', '') else ''
+ # Disable RSS (Receive Side Scaling).
+ pmd_disable_rss = '--disable-rss '\
+ if args.get('pmd_disable_rss', '') else ''
+ # Set the hexadecimal bitmask of the cores running forwarding. Master
+ # lcore=0 is reserved, so highest bit is set to 0.
+ pmd_coremask = '--coremask={} '.format(\
+ hex(int(args['eal_coremask'], 0) & 0xFFFE))\
+ if args.get('eal_coremask', '') else ''
+ # Set the number of forwarding cores based on coremask.
+ pmd_nb_cores = '--nb-cores={} '.format(\
+ bin(int(args['eal_coremask'], 0) & 0xFFFE).count('1'))\
+ if args.get('eal_coremask', '') else ''
+ eal_options = '-v '\
+ + eal_coremask\
+ + eal_mem_channels\
+ + eal_socket_mem\
+ + eal_driver
+ pmd_options = '-- '\
+ + pmd_fwd_mode\
+ + pmd_burst\
+ + pmd_txd\
+ + pmd_rxd\
+ + pmd_txqflags\
+ + pmd_total_num_mbufs\
+ + pmd_portmask\
+ + pmd_disable_hw_vlan\
+ + pmd_disable_rss\
+ + pmd_coremask\
+ + pmd_nb_cores
+ ssh = SSH()
+ ssh.connect(node)
+ cmd = "/start-testpmd.sh {0} {1}".format(eal_options, pmd_options)
+ exec_cmd_no_error(node, cmd, sudo=True)
+ ssh.disconnect(node)
+
+ @staticmethod
+ def dpdk_testpmd_stop(node):
+ """Stop DPDK testpmd app on node.
+
+ :param node: Node to stop testpmd on.
+ :type node: dict
+ :return: nothing
+ """
+ ssh = SSH()
+ ssh.connect(node)
+ cmd = "/stop-testpmd.sh"
+ exec_cmd_no_error(node, cmd, sudo=True)
+ ssh.disconnect(node)
diff --git a/resources/libraries/python/QemuUtils.py b/resources/libraries/python/QemuUtils.py
index 16ade29167..bc854350dd 100644
--- a/resources/libraries/python/QemuUtils.py
+++ b/resources/libraries/python/QemuUtils.py
@@ -317,7 +317,7 @@ class QemuUtils(object):
else:
interface['name'] = if_name
- def _huge_page_check(self):
+ def _huge_page_check(self, allocate=False):
"""Huge page check."""
huge_mnt = self._qemu_opt.get('huge_mnt')
mem_size = self._qemu_opt.get('mem_size')
@@ -326,12 +326,35 @@ class QemuUtils(object):
regex = re.compile(r'HugePages_Free:\s+(\d+)')
match = regex.search(output)
huge_free = int(match.group(1))
+ regex = re.compile(r'HugePages_Total:\s+(\d+)')
+ match = regex.search(output)
+ huge_total = int(match.group(1))
regex = re.compile(r'Hugepagesize:\s+(\d+)')
match = regex.search(output)
huge_size = int(match.group(1))
+ # Check if memory reqested by qemu is available on host
if (mem_size * 1024) > (huge_free * huge_size):
- raise RuntimeError('Not enough free huge pages {0} kB, required '
- '{1} MB'.format(huge_free * huge_size, mem_size))
+ # If we want to allocate hugepage dynamically
+ if allocate:
+ mem_needed = abs((huge_free * huge_size) - (mem_size * 1024))
+ huge_to_allocate = ((mem_needed / huge_size) * 2) + huge_total
+ max_map_count = huge_to_allocate*4
+ # Increase maximum number of memory map areas a process may have
+ cmd = 'echo "{0}" | sudo tee /proc/sys/vm/max_map_count'.format(
+ max_map_count)
+ (ret_code, _, stderr) = self._ssh.exec_command_sudo(cmd)
+ # Increase hugepage count
+ cmd = 'echo "{0}" | sudo tee /proc/sys/vm/nr_hugepages'.format(
+ huge_to_allocate)
+ (ret_code, _, stderr) = self._ssh.exec_command_sudo(cmd)
+ if int(ret_code) != 0:
+ logger.debug('Mount huge pages failed {0}'.format(stderr))
+ raise RuntimeError('Mount huge pages failed on {0}'.format(
+ self._node['host']))
+ # If we do not want to allocate dynamicaly end with error
+ else:
+ raise RuntimeError('Not enough free huge pages: {0}, '
+ '{1} MB'.format(huge_free, huge_free * huge_size))
# Check if huge pages mount point exist
has_huge_mnt = False
(_, output, _) = self._ssh.exec_command('cat /proc/mounts')
@@ -344,41 +367,14 @@ class QemuUtils(object):
break
# If huge page mount point not exist create one
if not has_huge_mnt:
- cmd = 'mount -t hugetlbfs -o pagesize=2048k none {0}'.format(
- huge_mnt)
+ cmd = 'mkdir -p {0}'.format(huge_mnt)
(ret_code, _, stderr) = self._ssh.exec_command_sudo(cmd)
if int(ret_code) != 0:
- logger.debug('Mount huge pages failed {0}'.format(stderr))
- raise RuntimeError('Mount huge pages failed on {0}'.format(
+ logger.debug('Create mount dir failed: {0}'.format(stderr))
+ raise RuntimeError('Create mount dir failed on {0}'.format(
self._node['host']))
-
- def _huge_page_allocate(self):
- """Huge page allocate."""
- huge_mnt = self._qemu_opt.get('huge_mnt')
- mem_size = self._qemu_opt.get('mem_size')
- # Check size of free huge pages
- (_, output, _) = self._ssh.exec_command('grep Huge /proc/meminfo')
- regex = re.compile(r'HugePages_Free:\s+(\d+)')
- match = regex.search(output)
- huge_free = int(match.group(1))
- regex = re.compile(r'HugePages_Total:\s+(\d+)')
- match = regex.search(output)
- huge_total = int(match.group(1))
- regex = re.compile(r'Hugepagesize:\s+(\d+)')
- match = regex.search(output)
- huge_size = int(match.group(1))
-
- mem_needed = abs((huge_free * huge_size) - (mem_size * 1024))
-
- if mem_needed:
- huge_to_allocate = (mem_needed / huge_size) + huge_total
- # Increase limit of allowed max hugepage count
- cmd = 'echo "{0}" | sudo tee /proc/sys/vm/max_map_count'.format(
- huge_to_allocate*3)
- (ret_code, _, stderr) = self._ssh.exec_command_sudo(cmd)
- # Increase hugepage count
- cmd = 'echo "{0}" | sudo tee /proc/sys/vm/nr_hugepages'.format(
- huge_to_allocate)
+ cmd = 'mount -t hugetlbfs -o pagesize=2048k none {0}'.format(
+ huge_mnt)
(ret_code, _, stderr) = self._ssh.exec_command_sudo(cmd)
if int(ret_code) != 0:
logger.debug('Mount huge pages failed {0}'.format(stderr))
@@ -403,13 +399,7 @@ class QemuUtils(object):
# By default check only if hugepages are availbale.
# If 'huge_allocate' is set to true try to allocate as well.
- try:
- self._huge_page_check()
- except RuntimeError as runtime_error:
- if self._qemu_opt.get('huge_allocate'):
- self._huge_page_allocate()
- else:
- raise runtime_error
+ self._huge_page_check(allocate=self._qemu_opt.get('huge_allocate'))
# Setup QMP via unix socket
qmp = '-qmp unix:{0},server,nowait'.format(self.__QMP_SOCK)