Decoder: Configure 10G Capability

Document created by RSA Information Design and Development on Jul 26, 2016Last modified by RSA Information Design and Development on Sep 28, 2016
Version 4Show Document
  • View in full screen mode

This guide applies when capturing packets on a 10G interface card. Packet capture at high speeds requires careful configuration and pushes the Decoder hardware to its limits, so please read this entire topic when implementing a 10G capture solution.

Hardware Prerequisites

  • Series 4S Decoder
  • Intel 82599-based ethernet card, such as the Intel x520. All RSA-provided 10G cards meet this requirement.
  • 96 GB of DD3-1600 memory in dual-rank DIMMs. Single rank DIMMs may decrease performance by as much as 10%. To determine the speed and rank of the installed DIMMs, run the command dmidecode -t 17.
  • Sufficiently large and fast storage to meet the capture requirement. Storage considerations are covered later in this topic.

Software Prerequisites

  • Linux kernel package obtained from RSA. Only Linux kernel packages provided by RSA are supported.
  • The pfring package that matches the currently installed kernel. The kernel version must match the pfring version exactly.

10G Decoder Installation and Configuration Changes

The following steps are needed to install the 10G Decoder:

  1. Ensure your host has a sufficiently new BIOS. The Decoder 10G package has been tested with Dell R620 BIOS v1.2.6 from May, 2012. BIOS revisions earlier than this have issues properly identifying the location of the 10G capture card within the system. It is important to update the BIOS before installing packages, as the packages use information provided by the BIOS to initialize the system.
  2. Install or upgrade the Decoder, using the normal upgrade procedure.
  3. If pfring is not installed at this point, install the pfring package that matches the currently installed kernel.
  4. Reboot the Decoder.

Post-install configuration tasks:

  1. The session and packet pools must fit within half of main memory (so 48 GBs on a 96 GB host). For example:
    1. Set pool.packet.pages (under /decoder/config) at 1000000, which is 1m x 32 KB pages = 30.5 GBs of memory.
    2. Then, set pool.session.pages (also under /decoder/config) set to 300000, which is 300k x 8 KB pages = 2.3 GBs
  2. Packet write block size (/database/config/packet.write.block.size) must be set to exactly 4 GB. This enables a special code path to buffer the whole file in Huge Pages and dump to disk using Direct I/O, and this also buffers the entire file in memory and requires two memory buffers. The memory buffers will be sized according to /database/config/packet.file.size, so keep this in mind for memory requirements for the Decoder process. Even if the configured file size is larger than 4 GB, it will be buffered entirely memory. These two buffers are not allowed to be swappable and will have to fit in main memory.
    For example, if packet.file.size is set to 8 GB, then the two memory buffers will consume 16 GBs of main memory.
  3. Select the capture driver p1p1 or p1p2 depending on capture port. To capture from both ports, select PFRINGZC,p1p1 and set capture.device.params to device=zc:p1p2,zc:p1p1
    Some hardware shows up as PFRINGZC,eth4PFRINGZC,eth5, PFRINGZC,p2p1 or PFRINGZC,p2p2. Make sure to select the correct input port.
  4. Ensure that the selected capture hardware is on the correct NUMA node. This is done as part of the install, but if any changes are made to the hardware after the installation, you may have to verify these settings.
    1. From an ssh session to the host, execute:
      cat /sys/class/net/<interface_name>/device/numa_node 
      where <interface_name> is the selected capture interface (e.g. p2p1).
    2. If the result is 0, no additional configuration is necessary.
      If the result is -1, then your server's BIOS did not report which CPU socket the capture card is wired to. Update your BIOS and re-start the installation. If the problem persists, you may need to contact the hardware manufacturer to obtain details about the NUMA node affinity of PCIe slots in your server.
    3. If the result is greater than 0, add the result as the parameter core to the capture parameters: 
      /decoder/config/capture.params: core=1
      This change will take affect upon capture (re)start.
    4. If the write thread is having trouble sustaining the capture speed, you can try the following:
      1. Change /database/config/packet.integrity.flush to normal 
      2. If that doesn't fix it, set all *.integrity.flush values to normal
      3. You can try adjusting the packet.file.size to something higher, but keep it under 10 GB as the whole file is buffered in memory at these speeds.
    5. (Optional) Application parsing is extremely CPU intensive and can cause the Decoder to drop packets. To mitigate application parsing induced drops, the setting /decoder/config/assembler.parse.valve can be set to true. This will have the following effects:
    • When session parsing becomes a bottleneck, application parsers (HTTP, SMTP, FTP, etc…) will be temporarily disabled.
    • Sessions are not dropped when the application parsers are disabled, just the fidelity of the parsing performed on those sessions.
    • Sessions parsed when the application parsers are disabled will still have associated network meta (NETWORK parser)
    • The statistic /decoder/parsers/stats/blowoff.count displays the count of all sessions that bypassed application parsers (network parsing is still performed).
    • When session parsing is no longer a potential bottleneck, the application parsers are automatically re-enabled.
    1. The assembler session pool should be large enough that it is not forcing sessions. You can determine if sessions are being forced by the statistic /decoder/stats/assembler.sessions.forced (it will be increasing) and /decoder/stats/assembler.sessions will be within several hundred of /decoder/config/assembler.session.pool.
      On a typical setup, at just under 10G, configure /decoder/config/assembler.session.pool to 1000000 and /decoder/stats/assembler.sessions will average 630K.

Storage Considerations

When capturing at 10G line rates, the storage system holding the packet and meta databases must be capable of sustained write throughput of 1400 MBytes/s.

There are several ways to achieve such high sustained throughput. Here we describe one such possible solution, though other storage architectures are possible.

Using the Series 4S hardware, with two DAC units

The Series 4S is equipped with a hardware RAID SAS controller capable of an aggregate 48Gbit/s of I/O throughput. It is equipped with 8 external 6 Gbit ports, organized into two 4-lane SAS cables. The recommended configuration for 10G is to balance at least 2 DAC units across these two external connectors. For example, connect 1 DAC to one port on SAS card, and then connect another DAC to the other port on the SAS card. As you add more DACs, chain them off of each port in a balanced manner.

As you add capacity, use the NwMakeArray script to provision the DAC units. This will automatically add them to NwDecoder10G's configuration as separate mount points. The independent mount points are important as it allows the NwDecoder10G to segregate write I/O from capture from the read I/O needed to satisfy packet content requests.

Other storage configurations (SAN, etc.)

The Decoder will allow any storage configuration that can meet the sustained throughput requirement. Note that the standard 8Gbit FC link to a SAN is not sufficient to store packet data at 10G, thus in order to use a SAN it may be required to perform aggregation across multiple targets using a software-RAID Scheme.

Parsing at High Speeds

Obviously, parsing raw packets at high speeds presents unique challenges. Given the high session and packet rates, parsing efficiency is paramount. A single parser that is inefficient (spends too long examining packets) can slow the whole system down to the point where packets are dropped at the card. For initial 10G testing, start with only native parsers (except SMB/WebMail). Use the native parsers to establish baseline performance and with little to no packet drops. Do not download any Live content until this has been done and the system is proven to capture without issue at high speeds.

After the system has been operational and running smoothly, Live content should be added very slowly - especially parsers. Parsers can have a dramatic effect on performance. Here are some rules of thumb:

Tested Live Content

Note: RSA recommends that you use a small number of parsers first and then add the other required parsers.

The following parsers can all (not each) be run at 10G on our test data set:

  • MA content (8 Lua parsers,1 feed, 2 application rules)
  • 4 feeds (alert ids info, warning, suspicious and spectrum whitelist)
  • 41 application rules
  • fingerprint_javascript_lua
  • fingerprint_pdf_lua
  • fingerprint_rar_lua
  • fingerprint_rtf_lua
  • xor_executable_lua
  • HTML_threat
  • spectrum_lua
  • windows_executable

The following illustration shows the parsers that work with the 10G Decoder.

The following illustration shows the feeds that work with the 10G Decoder:


  • SMB_lua, native SMB disabled by default
  • html_threat (oops, somehow forgot this one, will add and update)


HTTP_lua, reduces capture rate from >9G to <7G. At just under 5G this parser can be used in place of the native without dropping (in addition to the list above). xor_executable, will push parse CPU to 100% and system can drop significantly at time due to parse backup.

For more information on creating feeds, refer to the following topics in the RSA Link Content space:

Aggregation on a 10G Decoder

A 10G Decoder can serve aggregation to a single concentrator while running at 10G speeds. 

  1. Concentrator aggregates between 45-70k sessions/sec
  2. The 10G Decoder is capturing between 40-50k sessions/sec.
    With content identified above, this is about 1.5 to 2 million meta/sec.
  3. Turn on nice aggregation on the Concentrator to limit the performance impact on the Decoder
    /concentrator/config/aggregate.nice = true
  4. Due to the high volume of sessions on the concentrator, you may consider activating parallel values mode on the concentrator by setting /sdk/config/parallel.values to true. This will improve investigation performance when the number of sessions per second is above 30k.

If multiple aggregation streams are necessary, it would be less impactful on the Decoder to aggregate from the Concentrator instead.

10G Best Practices

  1. Incorporate baseline parsers (except SMB/Webmail, both of which generally have high CPU utilization and monitor to ensure little to no packet loss.
  2. When adding additional parsers, add only one or two parsers at a time.
  3. Measure performance impact of newly added content, especially during peak traffic periods.
  • If drops start occurring when they did not happen before, disable all newly-added parsers and enable just one at a time and measure the impact. This helps pinpoint individual parsers causing detrimental effects on performance. It may be possible to re-factor it to perform better or reduce its feature set to just what is necessary for the customer use case.
  • Although lesser performance impacts, feeds should also be reviewed and added in a phased approach to help measure performance impacts.
  • Application Rules also tend to have little observable impact, though again, it is best not to add a large number of rules at once without measuring the performance impact.
You are here: Additional Procedures > Configure 10G Capability