diff options
author | xu,gang <gangx.xu@intel.com> | 2016-08-23 17:26:22 +0800 |
---|---|---|
committer | Marvin Liu <yong.liu@intel.com> | 2016-08-25 13:37:26 +0800 |
commit | 671e41a6c8f9115b7639ab5f5b5a52a168e5076d (patch) | |
tree | fcdae1c69e78a84a9b829504f26ee900e4cdf34b | |
parent | f5b2c77927f2f59e95ba3e06ae8d96f27a3c1fec (diff) |
test_plans: add keep alive test plan
Signed-off-by: xu,gang <gangx.xu@intel.com>
-rw-r--r-- | test_plans/keep_alive_test_plan.rst | 75 |
1 files changed, 75 insertions, 0 deletions
diff --git a/test_plans/keep_alive_test_plan.rst b/test_plans/keep_alive_test_plan.rst new file mode 100644 index 0000000..7361ccf --- /dev/null +++ b/test_plans/keep_alive_test_plan.rst @@ -0,0 +1,75 @@ +.. BSD LICENSE + Copyright(c) 2010-2016 Intel Corporation. All rights reserved. + All rights reserved. + + Redistribution and use in source and binary forms, with or without + modification, are permitted provided that the following conditions + are met: + + * Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + * Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in + the documentation and/or other materials provided with the + distribution. + * Neither the name of Intel Corporation nor the names of its + contributors may be used to endorse or promote products derived + from this software without specific prior written permission. + + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT + LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR + A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT + OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, + SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT + LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, + DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY + THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE + OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + + + Keep Alive Sample Application +=============================== +The Keep Alive application is a simple example of a heartbeat/watchdog for packet processing cores. It demonstrates how to detect ‘failed’ DPDK cores and notify a fault management entity of this failure. Its purpose is to ensure the failure of the core does not result in a fault that is not detectable by a management entity. + +Overview +======= +The application demonstrates how to protect against ‘silent outages’ on packet processing cores. A Keep Alive Monitor Agent Core (master) monitors the state of packet processing cores (worker cores) by dispatching pings at a regular time interval (default is 5ms) and monitoring the state of the cores. Cores states are: Alive, MIA, Dead or Buried. MIA indicates a missed ping, and Dead indicates two missed pings within the specified time interval. When a core is Dead, a callback function is invoked to restart the packet processing core; A real life application might use this callback function to notify a higher level fault management entity of the core failure in order to take the appropriate corrective action. + +Note: Only the worker cores are monitored. A local (on the host) mechanism or agent to supervise the Keep Alive Monitor Agent Core DPDK core is required to detect its failure. + +Note: This application is based on the L2 Forwarding Sample Application (in Real and Virtualized Environments). As such, the initialization and run-time paths are very similar to those of the L2 forwarding application. + +Compiling the Application +========================= +To compile the application: + +Go to the sample application directory: + +export RTE_SDK=/path/to/rte_sdk cd ${RTE_SDK}/examples/keep_alive +Set the target (a default target is used if not specified). For example: + +export RTE_TARGET=x86_64-native-linuxapp-gcc +See the DPDK Getting Started Guide for possible RTE_TARGET values. +Build the application: + +make + +Running the Application +======================= + +The application has a number of command line options:: + +./build/l2fwd-keepalive [EAL options] -- -p PORTMASK [-q NQ] [-K PERIOD] [-T PERIOD] +where, + +p PORTMASK: A hexadecimal bitmask of the ports to configure +q NQ: A number of queues (=ports) per lcore (default is 1) +K PERIOD: Heartbeat check period in ms(5ms default; 86400 max) +T PERIOD: statistics will be refreshed each PERIOD seconds (0 to disable, 10 default, 86400 maximum). +To run the application in linuxapp environment with 4 lcores, 16 ports 8 RX queues per lcore and a ping interval of 10ms, issue the command:: + + ./build/l2fwd-keepalive -c f -n 4 -- -q 8 -p ffff -K 10 +Refer to the DPDK Getting Started Guide for general information on running applications and the Environment Abstraction Layer (EAL) options. + |