doc - add VIC configuration guide help

Signed-off-by: Hanoh Haim <hhaim@cisco.com>

3 files changed, 61 insertions, 0 deletions

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
--- /dev/null
+++ b/doc/images/UCS-B-adapter_policy_1.jpg
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
--- /dev/null
+++ b/doc/images/UCS-B-adapter_policy_2.jpg
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