docs/content/methodology/hoststack_testing/vsap_ab_with_nginx.md

   1 ---
   2 title: "VSAP ab with nginx"
   3 weight: 4
   4 ---
   5
   6 # VSAP ab with nginx
   7
   8 [VSAP (VPP Stack Acceleration Project)](https://wiki.fd.io/view/VSAP)
   9 aims to establish an industry user space application ecosystem based on
  10 the VPP hoststack.  As a pre-requisite to adapting open source applications
  11 using VPP Communications Library to accelerate performance, the VSAP team
  12 has introduced baseline tests utilizing the LD_PRELOAD mechanism to capture
  13 baseline performance data.
  14
  15 [AB (Apache HTTP server benchmarking tool)](https://httpd.apache.org/docs/2.4/programs/ab.html)
  16 is used for measuring the maximum connections-per-second and requests-per-second.
  17
  18 [NGINX](https://www.nginx.com) is a popular open source HTTP server
  19 application.  Because NGINX utilizes the POSIX socket interface APIs, the test
  20 configuration uses the LD_PRELOAD mechanism to connect NGINX to the VPP
  21 Hoststack using the VPP Communications Library (VCL) LD_PRELOAD library
  22 (libvcl_ldpreload.so).
  23
  24 In the future, a version of NGINX which has been modified to
  25 directly use the VCL application APIs will be added to determine the
  26 difference in performance of 'VCL Native' applications versus utilizing
  27 LD_PRELOAD which inherently has more overhead and other limitations.
  28
  29 The test configuration is as follows:
  30
  31            TG     Network         DUT
  32          [ AB ]=============[ VPP -> nginx ]
  33
  34 where,
  35
  36 1. nginx attaches to VPP and listens on TCP port 80
  37 2. ab runs CPS and RPS tests with packets flowing from the Test Generator node,
  38    across 100G NICs, through VPP hoststack to NGINX.
  39 3. At the end of the tests, the results are reported by AB.