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 DPDK, verify if the DPDK requires latest Oracle Linux Platform.DPDK is a special architecture supported by specific network card designs, drivers, and server architectures, that improves performance when processing network traffic. For high network traffic monitoring, you can select to enable DPDK option on Session Monitor Probes. DPDK uses NUMA architecture special feature to have faster access to traffic written from a Network Card and to enhance the performance.
DPDK architecture involves two parts for Session Monitor Probes. The daemon is responsible for network traffic analysis (rat) is compiled against a specific DPDK library, and is deployed upon Session Monitor installation. For DPDK to work, the DPDK driver must be downloaded and installed on the Probe, as well.
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.This section describes the hardware requirements for installing and configuring DPDK.
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)
For supported servers, see "Session Monitor System Requirements".
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
Supported DPDK versions for Session Monitor
Table 5-1 lists the supported versions of DPDK.
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.For DPDK installation, for Oracle X7-2 server has the following pre-requisite: Create a file, /opt/oracle/ocsm/etc/iptego/white_list_dpdk.local with the value i140e before triggering DPDK installation.Log into the Platform Setup Application page:
Select Capture Settings.
Check the box in Monitoring column against each sniffing interface that you want to use for capturing the traffic.
Log into the machine that hosts the probe or mediation engine and probe as a root user.
(Optional) For better understanding of the network, CPU, and NUMA nodes of the server, you can run the following command to review the output of the system_layout.py script, that will display system information:
source /opt/oracle/ocsm/ocsm_env.sh /opt/oracle/ocsm/usr/share/pld/rat/system_layout.py
Run the following commands which guides you through the installation:
source /opt/oracle/ocsm/ocsm_env.sh
/opt/oracle/ocsm/usr/share/pld/rat/configure_dpdk.py
The configure_dpdk.py script downloads and installs the required DPDK driver, the corresponding Kernel headers required for compiling DPDK driver, compiles, installs the driver, and creates server and Session Monitor DPDK related configuration.
(Optional) To view all the available advanced options, run the following command:
/opt/oracle/ocsm/usr/share/pld/rat/configure_dpdk.py -h
Reboot the machine that hosts the probe or mediation engine and probe.
This section provides the instructions to install and configure DPDK securely when not connected to the internet.
To install and configure DPDK:
Log into the Platform Setup Application page:
Select Capture Settings.
Check the box in Monitoring column against each sniffing interface that you want to use for capturing the traffic.
Log into the machine that hosts the probe or mediation engine and probe as a root user.
(Optional) For better understanding of the network, CPU, and NUMA nodes of the server, you can run the following command to review the output of the system_layout.py script, that displays the system information:
source /opt/oracle/ocsm/ocsm_env.sh /opt/oracle/ocsm/usr/share/pld/rat/system_layout.py
Run the following command:
yum install kernel-uek-devel-$(uname -r)
Download the dpdk-<version_number> tar.gz file from the following website, http://dpdk.org/browse/dpdk/snapshot/dpdk-<version_number>.tar.gz
into the folder, /var/cache/ocsm/dpdk.
where version_number is the DPDK version.
Run the following commands as a root user:
source /opt/oracle/ocsm/ocsm_env.sh
/opt/oracle/ocsm/usr/share/pld/rat/configure_dpdk.py
(Optional) To view all the available advanced options, run the following command:
/opt/oracle/ocsm/usr/share/pld/rat/configure_dpdk.py -h
Reboot the machine that hosts the probe or mediation engine and probe.
This section provides the instructions to update DPDK after a Kernel update.
Note:
You must perform the instructions in this section if you have installed another Linux Kernel.To update DPDK:
Reboot the system.
Follow the procedure detailed in "Installing and Configuring DPDK with Internet" or "Installing and Configuring DPDK without Internet" depending on your setup.
Reboot the machine that hosts the probe or mediation engine and probe.