From c55f150ece248b4439e188cb9c1d9ff3c547b5c2 Mon Sep 17 00:00:00 2001 From: Hanoh Haim Date: Wed, 1 Feb 2017 14:19:56 +0200 Subject: doc - add VIC configuration guide help Signed-off-by: Hanoh Haim --- doc/images/UCS-B-adapter_policy_1.jpg | Bin 0 -> 287747 bytes doc/images/UCS-B-adapter_policy_2.jpg | Bin 0 -> 298100 bytes doc/trex_book.asciidoc | 61 ++++++++++++++++++++++++++++++++++ 3 files changed, 61 insertions(+) create mode 100644 doc/images/UCS-B-adapter_policy_1.jpg create mode 100644 doc/images/UCS-B-adapter_policy_2.jpg (limited to 'doc') diff --git a/doc/images/UCS-B-adapter_policy_1.jpg b/doc/images/UCS-B-adapter_policy_1.jpg new file mode 100644 index 00000000..249812a1 Binary files /dev/null and b/doc/images/UCS-B-adapter_policy_1.jpg differ diff --git a/doc/images/UCS-B-adapter_policy_2.jpg b/doc/images/UCS-B-adapter_policy_2.jpg new file mode 100644 index 00000000..e62d2460 Binary files /dev/null and b/doc/images/UCS-B-adapter_policy_2.jpg differ diff --git a/doc/trex_book.asciidoc b/doc/trex_book.asciidoc index 78af8eb5..e2c2e5a2 100755 --- a/doc/trex_book.asciidoc +++ b/doc/trex_book.asciidoc @@ -2603,6 +2603,67 @@ anchor:ciscovic_support[] RTE_ETH_FLOW_NONFRAG_IPV6_SCTP RTE_ETH_FLOW_NONFRAG_IPV6_OTHER +==== vNIC Configuration Parameters + +*Number of Queues*:: + The maximum number of receive queues (RQs), work queues (WQs) and completion queues (CQs) are configurable on a per vNIC basis through the Cisco UCS Manager (CIMC or UCSM). + These values should be configured as follows: + * The number of WQs should be greater or equal to the number of threads (-c value) plus 1 + * The number of RQs should be greater than 5 + * The number of CQs should set to WQs + RQs + * Unless there is a lack of resources due to creating many vNICs, it is recommended that the WQ and RQ sizes be set to the *maximum*. + +*Advanced filters*:: + advanced filter should be enabled + +*MTU*:: + set the MTU to maximum 9000-9190 (Depends on the FW version) + +more information could be found here link:http://www.dpdk.org/doc/guides/nics/enic.html?highlight=enic[enic DPDK] + +image:images/UCS-B-adapter_policy_1.jpg[title="vic configuration",align="center",width=800] +image:images/UCS-B-adapter_policy_2.jpg[title="vic configuration",align="center",width=800] + +In case it is not configured correctly, this error will be seen + +.VIC error in case of wrong RQ/WQ +[source,bash] +---- +Starting TRex v2.15 please wait ... +no client generator pool configured, using default pool +no server generator pool configured, using default pool +zmq publisher at: tcp://*:4500 +Number of ports found: 2 +set driver name rte_enic_pmd +EAL: Error - exiting with code: 1 + Cause: Cannot configure device: err=-22, port=0 #<1> +---- +<1>There is not enough queues + + +running it with verbose mode with CLI `-v 7` + +[source,bash] +---- +$sudo ./t-rex-64 -f cap2/dns.yaml -c 1 -m 1 -d 10 -l 1000 -v 7 +---- + +will give move info + +[source,bash] +---- +EAL: probe driver: 1137:43 rte_enic_pmd +PMD: rte_enic_pmd: Advanced Filters available +PMD: rte_enic_pmd: vNIC MAC addr 00:25:b5:99:00:4c wq/rq 256/512 mtu 1500, max mtu:9190 +PMD: rte_enic_pmd: vNIC csum tx/rx yes/yes rss yes intr mode any type min +PMD: rte_enic_pmd: vNIC resources avail: wq 2 rq 2 cq 4 intr 6 #<1> +EAL: PCI device 0000:0f:00.0 on NUMA socket 0 +EAL: probe driver: 1137:43 rte_enic_pmd +PMD: rte_enic_pmd: Advanced Filters available +PMD: rte_enic_pmd: vNIC MAC addr 00:25:b5:99:00:5c wq/rq 256/512 mtu 1500, max +---- +<1> rq is 2 which mean 1 input queue which is less than minimum required by trex (rq should be at least 5) + ==== Limitations/Issues -- cgit 1.2.3-korg