Chapter 3. Software requirements

Procedure

1. Modify the containers-prepare-parameter.yaml file so that the neutron_driver parameter is set to ovs.

   parameter_defaults:
     ContainerImagePrepare:
     - push_destination: true
       set:
        neutron_driver: ovs
        ...

2. Include the neutron-ovs.yaml environment file in the /usr/share/openstack-tripleo-heat-templates/environments/services directory with your deployment script.

   TEMPLATES=/usr/share/openstack-tripleo-heat-templates
   
   openstack overcloud deploy --templates \
   -e ${TEMPLATES}/environments/network-environment.yaml \
   -e ${TEMPLATES}/environments/network-isolation.yaml \
   -e ${TEMPLATES}/environments/services/neutron-ovs.yaml \
   -e ${TEMPLATES}/environments/services/neutron-ovs-dpdk.yaml \
   -e ${TEMPLATES}/environments/services/neutron-sriov.yaml \
   -e /home/stack/containers-prepare-parameter.yaml

Procedure

1. Generate the ComputeOvsDpdkSriov role:

   openstack overcloud roles generate -o roles_data.yaml Controller ComputeOvsDpdkSriov

2. Add OS::TripleO::Services::OVNMetadataAgent to the Controller role.

3. Add the custom resources for OVS-DPDK with the resource_registry parameter:

   resource_registry:
       # Specify the relative/absolute path to the config files you want to use for override the default.
       OS::TripleO::ComputeOvsDpdkSriov::Net::SoftwareConfig:
         nic-configs/computeovsdpdksriov.yaml
       OS::TripleO::Controller::Net::SoftwareConfig:
         nic-configs/controller.yaml

4. In the parameter_defaults section, edit the value of the tunnel type parameter to geneve:

   NeutronTunnelTypes: 'geneve'
   NeutronNetworkType: ['geneve', 'vlan']

5. Optional: If you use a centralized routing model, disable Distributed Virtual Routing (DVR):

   NeutronEnableDVR: false

6. Under parameters_defaults, set the bridge mapping:

    # The OVS logical-to-physical bridge mappings to use.
     NeutronBridgeMappings: "datacentre:br-ex,data1:br-link0,data2:br-link1"

7. Configure the network interfaces in the computeovsdpdksriov.yaml file:

     - type: ovs_user_bridge
       name: br-link0
       use_dhcp: false
       ovs_extra:
        - str_replace:
          template: set port br-link0 tag=_VLAN_TAG_
          params:
           _VLAN_TAG_:
            get_param: TenantNetworkVlanID
       addresses:
        - ip_netmask:
          get_param: TenantIpSubnet
       members:
       - type: ovs_dpdk_port
         name: br-link0-dpdk-port0
         rx_queue: 1
         members:
         - type: interface
           name: eno3
     - type: sriov_pf
       name: eno4
       use_dhcp: false
       numvfs: 5
       defroute: false
       nm_controlled: true
       hotplug: true
       promisc: false

8. Include the following yaml files in your deployment script:

   • neutron-ovn-dpdk.yaml
   • neutron-ovn-sriov.yaml

Procedure

1. Generate the ComputeOvsDpdkSriov role:

   openstack overcloud roles generate -o roles_data.yaml ControllerSriov ComputeSriov

2. Configure the physical_network parameter settings relevant to your deployment.

   • For VLAN, set the physical_network parameter to the name of the network that you create in neutron after deployment. Use this value for the NeutronBridgeMappings parameter also.

   • Under role-specific parameters, such as ComputeSriovOffloadParameters, ensure the value of the OvsHwOffload parameter is true.

     parameter_defaults:
       NeutronBridgeMappings: 'datacentre:br-ex,tenant:br-offload'
       NeutronNetworkVLANRanges: 'tenant:502:505'
       NeutronFlatNetworks: 'datacentre,tenant'
       NeutronPhysicalDevMappings:
         - tenant:ens1f0
         - tenant:ens1f1
     
       NovaPCIPassthrough:
       - address: "0000:17:00.1"
         physical_network: "tenant"
       - address: "0000:3b:00.1"
         physical_network: "tenant"
       NeutronTunnelTypes: ''
       NeutronNetworkType: 'vlan'
       ComputeSriovOffloadParameters:
         OvsHwOffload: True
         KernelArgs: "default_hugepagesz=1GB hugepagesz=1G hugepages=32 intel_iommu=on iommu=pt isolcpus=1-11,13-23"
         IsolCpusList: "1-11,13-23"
         NovaReservedHostMemory: 4096
         NovaComputeCpuDedicatedSet: ['1-11','13-23']
         NovaComputeCpuSharedSet: ['0','12']

3. Configure the network interfaces in the computeovsdpdksriov.yaml file:

    - type: ovs_bridge
     name: br-offload
     mtu: 9000
     use_dhcp: false
     addresses:
     - ip_netmask:
        get_param: TenantIpSubnet
     members:
     - type: linux_bond
       name: bond-pf
       bonding_options: "mode=active-backup miimon=100"
       members:
       - type: sriov_pf
         name: ens1f0
         numvfs: 3
         primary: true
         promisc: true
         use_dhcp: false
         defroute: false
         link_mode: switchdev
       - type: sriov_pf
         name: ens1f1
         numvfs: 3
         promisc: true
         use_dhcp: false
         defroute: false
         link_mode: switchdev

4. Include the following yaml files in your deployment script:

   • ovs-hw-offload.yaml

   • neutron-ovn-sriov.yaml

      TEMPLATES_HOME=”/usr/share/openstack-tripleo-heat-templates”
         CUSTOM_TEMPLATES=”/home/stack/templates”
     
         openstack overcloud deploy --templates \
           -r ${CUSTOM_TEMPLATES}/roles_data.yaml \
           -e ${TEMPLATES_HOME}/environments/services/neutron-ovn-sriov.yaml \
           -e ${TEMPLATES_HOME}/environments/ovs-hw-offload.yaml \
           -e ${CUSTOM_TEMPLATES}/network-environment.yaml