puppet/services/openvswitch.yaml

   1 heat_template_version: pike
   2
   3 description: >
   4   Open vSwitch Configuration
   5
   6 parameters:
   7   ServiceData:
   8     default: {}
   9     description: Dictionary packing service data
  10     type: json
  11   ServiceNetMap:
  12     default: {}
  13     description: Mapping of service_name -> network name. Typically set
  14                  via parameter_defaults in the resource registry.  This
  15                  mapping overrides those in ServiceNetMapDefaults.
  16     type: json
  17   DefaultPasswords:
  18     default: {}
  19     type: json
  20   RoleName:
  21     default: ''
  22     description: Role name on which the service is applied
  23     type: string
  24   RoleParameters:
  25     default: {}
  26     description: Parameters specific to the role
  27     type: json
  28   EndpointMap:
  29     default: {}
  30     description: Mapping of service endpoint -> protocol. Typically set
  31                  via parameter_defaults in the resource registry.
  32     type: json
  33   OvsDpdkCoreList:
  34     description: >
  35       List of cores to be used for DPDK lcore threads.  Note, these threads
  36       are used by the OVS control path for validator and handling functions.
  37     type: string
  38     constraints:
  39       - allowed_pattern: "[0-9,-]*"
  40     default: ""
  41   OvsDpdkMemoryChannels:
  42     description: Number of memory channels per socket to be used for DPDK
  43     type: string
  44     constraints:
  45       - allowed_pattern: "[0-9]*"
  46     default: ""
  47   OvsDpdkSocketMemory:
  48     default: ""
  49     description: >
  50       Sets the amount of hugepage memory to assign per NUMA node. It is
  51       recommended to use the socket closest to the PCIe slot used for the
  52       desired DPDK NIC.  The format should be in "<socket 0 mem>, <socket 1
  53       mem>, <socket n mem>", where the value is specified in MB.  For example:
  54       "1024,0".
  55     type: string
  56   OvsDpdkDriverType:
  57     default: "vfio-pci"
  58     description: >
  59       DPDK Driver type. Ensure the Overcloud NIC to be used for DPDK supports
  60       this UIO/PMD driver.
  61     type: string
  62   OvsPmdCoreList:
  63     description: >
  64       A list or range of CPU cores for PMD threads to be pinned to.  Note, NIC
  65       location to cores on socket, number of hyper-threaded logical cores, and
  66       desired number of PMD threads can all play a role in configuring this
  67       setting.  These cores should be on the same socket where
  68       OvsDpdkSocketMemory is assigned.  If using hyperthreading then specify
  69       both logical cores that would equal the physical core. Also, specifying
  70       more than one core will trigger multiple PMD threads to be spawned which
  71       may improve dataplane performance.
  72     constraints:
  73       - allowed_pattern: "[0-9,-]*"
  74     type: string
  75     default: ""
  76   # DEPRECATED: the following options are deprecated and are currently maintained
  77   # for backwards compatibility. They will be removed in the Queens cycle.
  78   HostCpusList:
  79     description: List of cores to be used for host process
  80     type: string
  81     constraints:
  82       - allowed_pattern: "[0-9,-]*"
  83     default: ''
  84   NeutronDpdkCoreList:
  85     description: List of cores to be used for DPDK Poll Mode Driver
  86     type: string
  87     constraints:
  88       - allowed_pattern: "[0-9,-]*"
  89     default: ''
  90   NeutronDpdkMemoryChannels:
  91     description: Number of memory channels to be used for DPDK
  92     type: string
  93     constraints:
  94       - allowed_pattern: "[0-9]*"
  95     default: ''
  96   NeutronDpdkSocketMemory:
  97     default: ''
  98     description: Memory allocated for each socket
  99     type: string
 100   NeutronDpdkDriverType:
 101     default: "vfio-pci"
 102     description: DPDK Driver type
 103     type: string
 104
 105 parameter_groups:
 106 - label: deprecated
 107   description: Do not use deprecated params, they will be removed.
 108   parameters:
 109     - HostCpusList
 110     - NeutronDpdkCoreList
 111     - NeutronDpdkMemoryChannels
 112     - NeutronDpdkSocketMemory
 113     - NeutronDpdkDriverType
 114
 115 conditions:
 116   l_cores_empty: {equals: [{get_param: OvsDpdkCoreList}, '']}
 117   pmd_cores_empty: {equals: [{get_param: OvsPmdCoreList}, '']}
 118   mem_channels_empty: {equals: [{get_param: OvsDpdkMemoryChannels}, '']}
 119   socket_mem_empty: {equals: [{get_param: OvsDpdkSocketMemory}, '']}
 120   driver_not_set: {equals: [{get_param: OvsDpdkDriverType}, 'vfio-pci']}
 121
 122 outputs:
 123   role_data:
 124     description: Role data for the Open vSwitch service.
 125     value:
 126       service_name: openvswitch
 127       config_settings:
 128         map_replace:
 129           - map_replace:
 130             - vswitch::dpdk::driver_type: OvsDpdkDriverType
 131               vswitch::dpdk::host_core_list: OvsDpdkCoreList
 132               vswitch::dpdk::pmd_core_list: OvsPmdCoreList
 133               vswitch::dpdk::memory_channels: OvsDpdkMemoryChannels
 134               vswitch::dpdk::socket_mem: OvsDpdkSocketMemory
 135             - values: {get_param: [RoleParameters]}
 136           - values:
 137               OvsDpdkCoreList: {if: [l_cores_empty, {get_param: HostCpusList}, {get_param: OvsDpdkCoreList}]}
 138               OvsDpdkMemoryChannels: {if: [mem_channels_empty, {get_param: NeutronDpdkMemoryChannels}, {get_param: OvsDpdkMemoryChannels}]}
 139               OvsDpdkSocketMemory: {if: [socket_mem_empty, {get_param: NeutronDpdkSocketMemory}, {get_param: OvsDpdkSocketMemory}]}
 140               OvsDpdkDriverType: {if: [driver_not_set, {get_param: NeutronDpdkDriverType}, {get_param: OvsDpdkDriverType}]}
 141               OvsPmdCoreList: {if: [pmd_cores_empty, {get_param: NeutronDpdkCoreList}, {get_param: OvsPmdCoreList}]}
 142
 143       upgrade_tasks:
 144         - name: Check openvswitch version.
 145           tags: step2
 146           register: ovs_version
 147           ignore_errors: true
 148           shell: rpm -qa | awk -F- '/^openvswitch-2/{print $2 "-" $3}'
 149         - name: Check openvswitch packaging.
 150           tags: step2
 151           shell: rpm -q --scripts openvswitch | awk '/postuninstall/,/*/' | grep -q "systemctl.*try-restart"
 152           register: ovs_packaging_issue
 153           ignore_errors: true
 154         - block:
 155             - name: "Ensure empty directory: emptying."
 156               file:
 157                 state: absent
 158                 path: /root/OVS_UPGRADE
 159             - name: "Ensure empty directory: creating."
 160               file:
 161                 state: directory
 162                 path: /root/OVS_UPGRADE
 163                 owner: root
 164                 group: root
 165                 mode: 0750
 166             - name: Make yum cache.
 167               command: yum makecache
 168             - name: Download OVS packages.
 169               command: yumdownloader --destdir /root/OVS_UPGRADE --resolve openvswitch
 170             - name: Get rpm list for manual upgrade of OVS.
 171               shell: ls -1 /root/OVS_UPGRADE/*.rpm
 172               register: ovs_list_of_rpms
 173             - name: Manual upgrade of OVS
 174               shell: |
 175                 rpm -U --test {{item}} 2>&1 | grep "already installed" || \
 176                 rpm -U --replacepkgs --notriggerun --nopostun {{item}};
 177               args:
 178                 chdir: /root/OVS_UPGRADE
 179               with_items:
 180                 - "{{ovs_list_of_rpms.stdout_lines}}"
 181           tags: step2
 182           when: "'2.5.0-14' in ovs_version.stdout|default('')
 183                 or
 184                 ovs_packaging_issue|default(false)|succeeded"