5 Installing and Configuring DPDK for Session Monitor

This chapter provides instructions for installing and configuring Data Plane Development Kit (DPDK) for the Oracle Communications Session Monitor to monitor high volume of network traffic.

DPDK provides sniffing performance for some of the Intel network cards and network traffic patterns. If you have a compatible network card, you can enable DPDK.

Note:

See Oracle Communications Session Monitor Release Notes to verify if you need to update DPDK. If you need to update DPKD, verify if the DPDK requires latest Oracle Linux Platform.

System Requirements

The following sections describe the hardware and software requirements for installing and configuring DPDK for Session Monitor.

Note:

The software and hardware details mentioned in this section are minimum requirements to enable DPDK for capturing high volume of network traffic. Contact Oracle Support for more assistance.

Hardware Requirements

This section describes the hardware requirements for installing and configuring DPDK.

Minimal Requirements

Following are the list of minimum hardware requirements:

  • Probe machine (with DPDK) (2 Intel processors, each with 8 cores, 8 GB RAM, Intel based network card)

  • Mediation Engine and Probe in one machine (at least 2 Intel processors and 24 cores in total, 24 GB RAM, Intel based network card)

Supported Servers

For supported servers, see "Session Monitor System Requirements".

Supported Networking Cards

The following networking cards are supported:

  • Sun Dual Port 10 GbE PCle 2.0 Networking Card with Intel 82599 10 GbE Controller

  • Sun Quad Port GbE PCIe 2.0 Low Profile Adapter, UTP

  • Sun Dual Port GbE PCIe 2.0 Low Profile Adapter, MMF

Software Requirements

Supported DPDK versions for Session Monitor

Table 5-1 lists the supported versions of DPDK.

Table 5-1 DPDK Support Versions for Session Monitor

DPDK Version Session Monitor Release

16.07

Supported from 3.3.92.3.0

16.04

Supported from 3.3.92.0.0 to 3.3.92.2.0.

2.2.0

Supported in 3.3.91.3.0

2.0.0

Supported from 3.3.90.2.0 to 3.3.91.2.0

1.7.0

Supported from 3.3.70.0.0 to 3.3.90.1.0


Installing and Configuring DPDK with Internet

This section describes the procedure for installing and configuring DPDK for session monitor.

To install and configure the DPDK:

Note:

You must be connected to the internet before starting the installation. Running the following command installs, downloads the required files, and configures the DPDK automatically.
  1. Log into the computer that hosts the probe or mediation engine and probe.

  2. Run the following command which guides you through the installation:

            configure_dpdk.py  
    
  3. Reboot the computer that hosts the probe or mediation engine and probe.

Installing and Configuring DPDK without Internet

This section provides the instructions to install and configure DPDK securely when not connected to the internet.

To install and configure DPDK:

  1. Log into the computer that hosts the probe or mediation engine and probe.

  2. Run the following command to view the current Kernel version of your system:

    uname -r
      
    
  3. If the Kernel version requires an update, run the following command:

    yum install kernel-uek-devel-(uname -r)
      
    
  4. (Optional) Run the following command to update the Kernel packages:

    yum update
      
    
  5. Download the dpdk-. version_number tar.gz file from the following website:

    http://dpdk.org/browse/dpdk/snapshot/
      
    

    where version_number is the DPDK version.

  6. Build DPDK driver and install by running the following command:

         source /opt/oracle/ocsm/ocsm_env.sh
         /opt/oracle/ocsm/usr/share/pld/rat/configure_dpdk.py 
    
  7. Change grub file to change Kernel options. Reserve 50% of the memory and few CPUs for exclusive use. Contact Oracle support for more information.

  8. Change /etc/fstab file to mount hugetblfs. Contact Oracle support for more information.

  9. Reboot the computer that hosts the probe or mediation engine and probe.

  10. In the Platform Setup Application page, under Capture Settings, select the required sniffing interfaces.

  11. Run the following commands:

         source /opt/oracle/ocsm/ocsm_env.sh
         /opt/oracle/ocsm/usr/share/pld/rat/configure_dpdk.py 
    
  12. Reboot the computer that hosts the probe or mediation engine and probe.

Updating Kernel for DPDK

This section provides the instructions to update the Kernel for DPDK.

Note:

You must perform the instructions in this section if you have installed the latest Kernel for updating DPDK.

To update Kernel:

  1. Reboot the system:

  2. Run the following command to update the Kernel and DPDK version:

         source /opt/oracle/ocsm/ocsm_env.sh
         /opt/oracle/ocsm/usr/share/pld/rat/configure_dpdk.py 
    
  3. Reboot the computer that hosts the probe or mediation engine and probe.

Uninstalling DPDK

This section describes the instructions for uninstalling DPDK.

To uninstall DPDK:

  1. Run the following commands:

         source /opt/oracle/ocsm/ocsm_env.sh
    
         /opt/oracle/ocsm/usr/share/pld/rat/configure_dpdk.py---remove 
    
  2. Reboot the computer that hosts the probe or mediation engine and probe.