Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Using Netronome SmartNIC vRouter with Contrail Networking and Juju Charms

 
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.

You can deploy Contrail Networking by using Juju charms. Juju helps you deploy, configure, and efficiently manage applications on private clouds and public clouds. Juju accesses the cloud with the help of a Juju controller. A charm is a module containing a collection of scripts and metadata and is used with Juju to deploy Contrail.

Starting in Contrail Networking Release 2011, Contrail Networking supports Netronome Agilio CX SmartNICs for Contrail Networking deployment with Juju charms. This feature enables service providers to improve the forwarding performance which includes packets per second (PPS) of vRouter. This optimizes server CPU usage and you can deploy more Virtual Network Functions (VNFs) per server.

Before you begin:

  • Equip compute nodes with Netronome Agilio CX SmartNIC. For details, see Agilio CX SmartNICs documentation.

  • Retrieve Agilio charm.

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

    Netronome will provide the Agilio charm for SmartNIC vRouter deployment on compute nodes. Add the charm version as charm variable in the Bundle yaml file. Also, Netronome will authorize Docker Hub registry access.

  • Note the Container Tags for your Contrail image to customize the image-tag variable in the Bundle yaml file. See README Access to Contrail Registry 20XX  .

  • Note the following version tags:

    agilio-image-tag: 2.48-ubuntu-queens

    maas version: 2.6.2

    Linux kernel: bionic (ga-18.04)

Contrail supports the following charms:

  • contrail-agent

  • contrail-analytics

  • contrail-analyticsdb

  • contrail-controller

  • contrail-keystone-auth

  • contrail-openstack

The following topics describe how to use Netronome SmartNIC vRouter with Contrail Networking and Juju charms.

Prepare to Install Contrail Networking by Using Juju Charms

Follow these steps to prepare for deployment:

  1. Install Juju.
  2. Configure Juju.

    You can add a cloud to Juju, and manage clouds already added to Juju. Juju recognizes a wide range of cloud types for adding a cloud.

    This is an example for adding a cloud by using interactive command.

    Example: Adding an MAAS cloud to Juju

    juju add-cloud
    Note

    Juju 2.x is compatible with MAAS series 1.x and 2.x.

  3. Create a Juju controller.
    Note

    A Juju controller manages and keeps track of applications in the Juju cloud environment.

Deploy Contrail Charms in a Bundle

Follow these steps to deploy Contrail charms in a bundle.

  1. Deploy Contrail charms.

    To deploy Contrail charms in a bundle, use the juju deploy <bundle_yaml_file> command.

    The following example shows you how to use bundle_yaml_file to deploy Contrail Networking with Netronome SmartNIC vRouter on MAAS based deployment.

    Bundle yaml file

    You can create or modify the Contrail charm deployment bundle YAML file to:

    • Point to machines or instances where the Contrail charms must be deployed.

    • Include the options you need.

      Each Contrail charm has a specific set of options. The options you choose depend on the charms you select. For more information on the options that are available, see Options for Juju Charms.

  2. (Optional) Check the status of deployment.

    You can check the status of the deployment by using the juju status command.

  3. Enable configuration statements.

    Based on your deployment requirements, you can enable the following configuration statements:

Release History Table
Release
Description
Starting in Contrail Networking Release 2011, Contrail Networking supports Netronome Agilio CX SmartNICs for Contrail Networking deployment with Juju charms.