vnfs/qemu/qemu_dpdk_vhost_user.py

   1 # Copyright 2015 Intel Corporation.
   2 #
   3 # Licensed under the Apache License, Version 2.0 (the "License");
   4 # you may not use this file except in compliance with the License.
   5 # You may obtain a copy of the License at
   6 #
   7 #   http://www.apache.org/licenses/LICENSE-2.0
   8 #
   9 # Unless required by applicable law or agreed to in writing, software
  10 # distributed under the License is distributed on an "AS IS" BASIS,
  11 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  12 # See the License for the specific language governing permissions and
  13 # limitations under the License.
  14
  15 """Automation of QEMU hypervisor for launching vhost-user enabled guests.
  16 """
  17
  18 import logging
  19
  20 from conf import settings as S
  21 from vnfs.qemu.qemu import IVnfQemu
  22
  23 class QemuDpdkVhostUser(IVnfQemu):
  24     """
  25     Control an instance of QEMU with vHost user guest communication.
  26     """
  27     def __init__(self):
  28         """
  29         Initialisation function.
  30         """
  31         super(QemuDpdkVhostUser, self).__init__()
  32         self._logger = logging.getLogger(__name__)
  33
  34         # multi-queue values
  35         if int(S.getValue('GUEST_NIC_QUEUES')[self._number]):
  36             queue_str = ',queues={}'.format(S.getValue('GUEST_NIC_QUEUES')[self._number])
  37             mq_vector_str = ',mq=on,vectors={}'.format(
  38                 int(S.getValue('GUEST_NIC_QUEUES')[self._number]) * 2 + 2)
  39         else:
  40             queue_str, mq_vector_str = '', ''
  41
  42         # Guest merge buffer setting
  43         if S.getValue('GUEST_NIC_MERGE_BUFFERS_DISABLE')[self._number]:
  44             if S.getValue('VSWITCH_JUMBO_FRAMES_ENABLED'):
  45                 self._logger.warning(
  46                     'Mergable buffers must be enabled for jumbo frames. Overriding.')
  47                 merge_buff = ''
  48             else:
  49                 merge_buff = 'mrg_rxbuf=off,'
  50         else:
  51             merge_buff = ''
  52
  53         # calculate index of first interface, i.e. check how many
  54         # interfaces has been created for previous VMs, where 1st NIC
  55         # of 1st VM has index 0
  56         start_index = sum(S.getValue('GUEST_NICS_NR')[:self._number])
  57
  58         # setup requested number of interfaces
  59         for nic in range(len(self._nics)):
  60             index = start_index + nic
  61             ifi = str(index)
  62             net = 'net' + str(index + 1)
  63
  64             # In case of testpmd as switch, path to vhost netdev folder will be set
  65             # to tmp location instead of default ovs_var_tmp folder.
  66             if S.getValue('VSWITCH') == 'none':
  67                 vhost_folder = '/tmp/'
  68             else:
  69                 vhost_folder = S.getValue('TOOLS')['ovs_var_tmp']
  70
  71             if S.getValue('VSWITCH_VHOSTUSER_SERVER_MODE'):
  72                 nic_name = 'dpdkvhostuser' + ifi
  73             else:
  74                 nic_name = 'dpdkvhostuserclient' + ifi + ',server'
  75
  76             self._cmd += ['-chardev',
  77                           'socket,id=char' + ifi +
  78                           ',path=' + vhost_folder + nic_name,
  79                           '-netdev',
  80                           'type=vhost-user,id=' + net +
  81                           ',chardev=char' + ifi + ',vhostforce' + queue_str,
  82                           '-device',
  83                           'virtio-net-pci,mac=' +
  84                           self._nics[nic]['mac'] +
  85                           ',netdev=' + net + ',csum=off,' + merge_buff +
  86                           'gso=off,' +
  87                           'guest_tso4=off,guest_tso6=off,guest_ecn=off' +
  88                           mq_vector_str,
  89                          ]