close

keyboard_arrow_left

Table of Contents Expand all

play_arrow Installing and Upgrading Contrail
- play_arrow Understanding Contrail
- play_arrow Supported Platforms and Server Requirements
  - Server Requirements and Supported Platforms
  - Hardware and Server Requirements
- play_arrow Contrail Command
- play_arrow Upgrading Contrail Software
- play_arrow Backup and Restore Contrail Software
  - How to Backup and Restore Contrail Databases in JSON Format in Openstack Environments Using the Openstack 16.1 Director Deployment
  - How to Backup and Restore Contrail Databases in JSON Format in Openstack Environments Using the Openstack 13 or Ansible Deployers
- play_arrow Using Contrail Networking with VMware vCenter
  - play_arrow VMware vCenter with Containerized Contrail Networking
- play_arrow Using Contrail Networking with OpenStack
  - play_arrow Setting Up Contrail with Red Hat OpenStack 16.1
  - play_arrow Setting Up Contrail with Red Hat OpenStack 13
  - play_arrow Configuring Virtual Networks
  - play_arrow Using Contrail Resources in Heat Templates
    - Using the Contrail Heat Template
  - play_arrow QoS Support in Contrail Networking
    - Quality of Service in Contrail
    - Configuring Network QoS Parameters
  - play_arrow Load Balancers
  - play_arrow Optimizing Contrail Networking
    - Multiqueue Virtio Interfaces in Virtual Machines
  - play_arrow Contrail Networking OpenStack Analytics
    - Ceilometer Support in Contrail
  - play_arrow Contrail OpenStack APIs
    - Working with Neutron
- play_arrow Using Contrail with Juju Charms
- play_arrow Using Contrail and Contrail Insights with Kolla/Ocata OpenStack
- play_arrow Post Installation Tasks

list Table of Contents

English

keyboard_arrow_right

Using Netronome SmartNIC vRouter with Contrail Networking

date_range 18-Jul-23

arrow_backward

arrow_forward

Note:

The Netronome SmartNIC vRouter technology covered in this document is available for evaluation purposes only. It is not intended for deployment in production networks.

Contrail supports Netronome Agilio CX SmartNICs for Contrail Networking deployment with Red Hat OpenStack Platform Director (RHOSPd) 13 environment.

This feature will enable service providers to improve the forwarding performance which includes packets per second (PPS) of vRouter. This will optimize server CPU usage and you can deploy more Virtual network functions (VNFs) per server.

Benefits:

Increased PPS capacity of Contrail vRouter datapath allowing applications to reach their full processing capacity.
Reclaimed CPU cores from Contrail vRouter off-loading allowing more VMs and VNFs to be deployed per server.

The goal of this topic is to provide a procedure for deploying accelerated vRouter compute nodes.

Before you begin:

Equip compute nodes with Netronome Agilio CX SmartNIC.

For details, refer to Agilio CX SmartNICs.
Retrieve Agilio heat-template plugin.

Register on Netronome support site at https://help.netronome.com and provide Docker Hub credentials.

Netronome will provide the TripleO templates for SmartNIC vRouter deployment on compute nodes. Also, Netronome will authorize Docker Hub registry access.

For details, refer to Netronome Agilio vRouter 19xx deployment guide.
Note the following version tags:

AGILIO_TAG="2.38-rhel-queens FORWARDER_TAG="2.38-rhel-queens

Procedure:

Note:

If you have multiple undercloud nodes deployed, you must perform the following procedure on the same node.

Configure Agilio plugin.
For details, refer to Netronome agilio-ovs-openstack-plugin GitHub Repository.
1. Extract the Agilio plugin archive and copy the agilio-plugin folder into the tripleo-heat-templates directory.
  [stack@queensa ~]$ tar -xzvf rhosp-contrail-agilio-heat-plugin-5-34.tgz agilio-plugin/ agilio-plugin/agilio-vrouter.yaml agilio-plugin/agilio_upgrade.sh agilio-plugin/deploy_rhosp.sh agilio-plugin/nfp_udev.sh agilio-plugin/agilio-env.yaml agilio-plugin/version agilio-plugin/README.md [stack@queensa ~]$ cp -r agilio-plugin/ tripleo-heat-templates/
2. Navigate to the agilio-plugin directory on the undercloud node.
  [tripleo-heat-templates]$ cd agilio-plugin/
3. Modify agilio-env.yaml file as per your environment.
  Note:
  Reserve at least 1375*2 MB hugepages for virtio-forwarder.
  Sample agilio-env.yaml file:
  resource_registry: OS::TripleO::NodeExtraConfigPost: agilio-vrouter.yaml parameter_defaults: # Hugepages ContrailVrouterHugepages2MB: "8192" # IOMMU ComputeParameters: KernelArgs: "intel_iommu=on iommu=pt isolcpus=1,2 " ComputeCount: 3 # Aditional config ControlPlaneDefaultRoute: 10.0.x.1 EC2MetadataIp: 10.0.x.1 # Generally the IP of the Undercloud DnsServers: ["8.8.8.8","192.168.3.3"] NtpServer: ntp.is.co.za ContrailRegistryInsecure: true DockerInsecureRegistryAddress: 172.x.x.150:6666,10.0.x.1:8787 ContrailRegistry: 172.x.x.150:6666 ContrailImageTag: <container_tag>-rhel-queens # Fix DB Diskspace too low issue ContrailAnalyticsDBMinDiskGB: 40
4. Add Docker Hub credentials to tripleo-heat-templates/agilio-plugin/agililo_upgrade.sh file to retrieve containers from AGILIO_REPO="docker.io/netronomesystems/" repository.
  #GENERAL DOCKER CONFIG DOCKER_USR=****** #ENTER_DOCKER_USERNAME_HERE DOCKER_PASS=****** #ENTER_DOCKER_PASSWORD_HERE
  
  [root@overcloud-novacompute-2 heat-admin]# docker ps -a | grep virtio_for 7d5af8a2591d docker.io/netronomesystems/virtio-forwarder:2.38-rhel-queens "./entrypoint.sh" 30 seconds ago Up 15 seconds virtio_forwarder
  
  [root@overcloud-novacompute-2 heat-admin]# docker ps -a | grep agilio c7c611b5168b docker.io/netronomesystems/agilio-vrouter:2.38-rhel-queens "./entrypoint.sh" 46 seconds ago Up 38 seconds agilio_vrouter
Prepare the Contrail Networking cluster for deployment.
Refer to the following topics for deployment:
- Understanding Red Hat OpenStack Platform Director
- Setting Up the Infrastructure
- Setting Up the Undercloud
- Setting Up the Overcloud
  
  Note:
  Do not perform steps for Installing Overcloud.
Deploy the cluster by one of the following ways:
- Add agilio-env.yaml to installing overcloud step as mentioned in Installing Overcloud topic.
  
  openstack overcloud deploy --templates ~/tripleo-heat-templates -e ~/overcloud_images.yaml -e ~/tripleo-heat-templates/environments/network-isolation.yaml -e ~/tripleo-heat-templates/environments/contrail/contrail-plugins.yaml -e ~/tripleo-heat-templates/environments/contrail/contrail-services.yaml -e ~/tripleo-heat-templates/environments/contrail/contrail-net.yaml -e ~/tripleo-heat-templates/agilio-plugin/agilio-env.yaml --roles-file ~/tripleo-heat-templates/roles_data_contrail_aio.yaml
  
  Or
- Run the following command:
  
  deploy_rhosp.sh
  
  -e ~/tripleo-heat-templates/agilio-plugin/agilio-env.yaml

On completing above steps successfully, refer to Netronome agilio-ovs-openstack-plugin GitHub Repository on how to spin up the accelerated VMs.

arrow_backward PREVIOUS Setting Up the Overcloud

NEXT arrow_forward Installing OpenStack Octavia LBaaS with RHOSP in Contrail Networking

Contrail Networking Installation and Upgrade Guide

Using Netronome SmartNIC vRouter with Contrail Networking

Stay in touch

Helped me install or use the product
Accelerated my deployment

Discuss the product with a co-worker
Make a purchase inquiry

Contrail Networking Installation and Upgrade Guide

Using Netronome SmartNIC vRouter with Contrail Networking

Related Documentation

Stay in touch