Product Documentation
ADC
Current Release 13.1 13.0 12.1
View PDF

Provision the Citrix ADC VPX instance with SR-IOV, on OpenStack

September 14, 2021
Contributed by:
S

您可以部署高性能Citrix ADC VPX instances that use single-root I/O virtualization (SR-IOV) technology, on OpenStack.

You can deploy a Citrix ADC VPX instance that uses SR-IOV technology, on OpenStack, in three steps:

  • Enable SR-IOV Virtual Functions (VFs) on the host.
  • Configure and make the VFs available to OpenStack.
  • Provision the Citrix ADC VPX on OpenStack.

Prerequisites

Ensure that you:

  • Add the Intel 82599 NIC (NIC) to the host.
  • Download and Install the latest IXGBE driver from Intel.
  • Block list the IXGBEVF driver on the host. Add the following entry in the /etc/modprobe.d/blacklist.conf file: Block listixgbevf

Note

Theixgbedriver version must be minimum 5.0.4.

Enable SR-IOV VFs on the host

Do one of the following steps to enable SR-IOV VFs:

  • If you are using a kernel version earlier than 3.8, add the following entry to the /etc/modprobe.d/ixgbe file and restart the host: options ixgbe max_vfs=

  • If you are using kernel 3.8 version or later, create VFs by using the following command:

echo  > /sys/class/net//device/sriov_numvfs

Where:

  • number_of_VFs is the number of Virtual Functions that you want to create.
  • device_name is the interface name.

Important

While you are creating the SR-IOV VFs, make sure that you do not assign MAC addresses to the VFs.

Here is an example of four VFs being created.

Enable SR-IOV

Make the VFs persistent, add the commands that you used to created VFs to therc.localfile. Here is an example showing content of rc.local file.

Enable SR-IOV VF

For more information, see thisIntel SR-IOV Configuration Guide.

Configure and make the VFs available to OpenStack

Follow the steps given at the link below to configure SR-IOV on OpenStack:https://wiki.openstack.org/wiki/SR-IOV-Passthrough-For-Networking.

Provision the Citrix ADC VPX instance on OpenStack

You can provision a Citrix ADC VPX instance in an OpenStack environment by using the OpenStack CLI.

Provisioning a VPX instance, optionally involves using data from the config drive. The config drive is a special configuration drive that attaches to the instance when it boots. This configuration drive can be used to pass networking configuration information such as management IP address, network mask, and default gateway and so on to the instance before you configure the network settings for the instance.

OpenStack规定VPX实例时,它首先detects that the instance is booting in an OpenStack environment, by reading a specific BIOS string (OpenStack Foundation) that indicates OpenStack. For Red Hat Linux distributions, the string is stored in /etc/nova/release. This is a standard mechanism that is available in all OpenStack implementations based on KVM hyper-visor platform. The drive must have a specific OpenStack label. If the config drive is detected, the instance attempts to read the following information from the file name specified in thenovaboot command. In the procedures below, the file is called “userdata.txt.”

  • Management IP address
  • Network mask
  • Default gateway

一旦成功读取参数,基于“增大化现实”技术e populated in the NetScaler stack. This helps in managing the instance remotely. If the parameters are not read successfully or the config drive is not available, the instance transitions to the default behavior, which is:

  • The instance attempts to retrieve the IP address information from DHCP.
  • If DHCP fails or times-out, the instance comes up with default network configuration (192.168.100.1/16).

Provision the Citrix ADC VPX instance on OpenStack through CLI

You can provision a VPX instance in an OpenStack environment by using the OpenStack CLI. Here’s the summary of the steps to provision a Citrix ADC VPX instance on OpenStack:

  1. Extracting the.qcow2file from the .tgz file

  2. Building an OpenStack image from the qcow2 image

  3. Provisioning a VPX instance

To provision a VPX instance in an OpenStack environment, do the following steps.

  1. Extract the.qcow2file from the.tqzfile by typing the command:

    tar xvzf  tar xvzf NSVPX-KVM-12.0-26.2_nc.tgz NSVPX-KVM.xml NSVPX-KVM-12.0-26.2_nc.qcow2

  2. Build an OpenStack image using the.qcoz2file extracted in step 1 by typing the following command:

    glance image-create --name="" --property hw_disk_bus=ide --is-public=true --container-format=bare --disk-format=qcow2<  glance image-create --name="NS-VPX-12-0-26-2" --property hw_disk_bus=ide --is-public= true --container-format=bare --disk-format=qcow2< NSVPX-KVM-12.0-26.2_nc.qcow2

    The following illustration provides a sample output for the glance image-create command.

    Glance image create command

  3. After an OpenStack image is created, provision the Citrix ADC VPX instance.

    nova boot --image NSVPX-KVM-12.0-26.2 --config-drive=true --userdata ./userdata.txt --flavor m1. medium --nic net-id=3b258725-eaae- 455e-a5de-371d6d1f349f --nic port-id=218ba819-9f55-4991-adb6- 02086a6bdee2 NSVPX-10

    In the preceding command, userdata.txt is the file which contains the details like, IP address, netmask, and default gateway for the VPX instance. The user data file is a user customizable file. NSVPX-KVM-12.0-26.2 is the name of the virtual appliance that you want to provision. –NIC port-id=218ba819-9f55-4991-adb6-02086a6bdee2 is the OpenStack VF.

    The following illustration gives a sample output of thenovaboot command.

    Output boot command

    The following illustration shows a sample of the userdata.txt file. The values within the tags are the values which are user configurable and holds the information like, IP address, netmask, and default gateway.

    < ?xml version = " 1.0 " encoding = " utf - 8 "独立= " no"?>   NOVA 2013.1 Openstack en     citrix.com 4

Additional supported Configurations: Creating and Deleting VLANs on SR-IOV VFs from the Host

Type the following command to create a VLAN on the SR-IOV VF:

ip link show enp8s0f0 vf 6 vlan 10

In the preceding command “enp8s0f0” is the name of the physical function.

Example: VLAN 10, created on vf 6

Create VLAN 10 on VF6

Type the following command to delete a VLAN on the SR-IOV VF:

ip link show enp8s0f0 vf 6 vlan 0

Example: VLAN 10, removed from vf 6

VLAN 10 removed from VF6

These steps complete the procedure for deploying a Citrix ADC VPX instance that uses SRIOV technology, on OpenStack.

Provision the Citrix ADC VPX instance with SR-IOV, on OpenStack
September 14, 2021
Contributed by:
S
September 14, 2021
Contributed by:
S

In this article

Site feedback | Privacy and legal terms | Cookie preferences | Consent settings | docs.cloud.com
© 1999-Cloud Software Group, Inc. All rights reserved.