SAI Challenger docs & tutorial test-cases (#300)

* Starting a series of tutorials using SAI CHallenger.

* Spellcheck

* README

* Add vnet tutorial file

* Run all saic tests not just vnet.

* Added to SAIC tutorial.

* Spellcheck

* Organize test saic directory and readmes.

* Spellcheck

* Spellcheck

* Spellcheck

* reorganize docs

* spellcheck

* Tutorial progress.

* tutorial progress, plus SAIC testb ed docs

* Tutorials, saic testbed

* SAIC testbed readme

* spellcheck

* Spellcheck, polish.

* Spellcheck

* Tutorial test cases and docs.

* Tutorials.

* spellcheck

* Polishing tutorials.

* Add assertions and result printing.

* Fix assertions

* Improve printing of results.

* Fix stale info in SAI CHallenger docs per review feedback.

* workflow documentation.

* Simplify dpugen example.

* Update SAI challenger testbed diagram; add diagrams for SAI Challenger tutorials.

* Move SAIChallenger tutorials to functional test directory instead of scale.

* Updated SAI-C related scripts as per changes in SAI-C repo

Signed-off-by: Andriy Kokhan <andriy.kokhan@gmail.com>

* Update branch name in .gitmodules

Signed-off-by: Andriy Kokhan <andriy.kokhan@gmail.com>

* Initialize SAI-C submodules from Makefile

Signed-off-by: Andriy Kokhan <andriy.kokhan@gmail.com>

* Revert "Initialize SAI-C submodules from Makefile"

This reverts commit 5196002.

* Fixed DASH check for SAI-C

* Updated SAI-C submodule to main branch

Signed-off-by: Andriy Kokhan <andriy.kokhan@gmail.com>

* Re-worked SAI-C target build

Signed-off-by: Andriy Kokhan <andriy.kokhan@gmail.com>

* Updated SAI-C TB description files

Signed-off-by: Andriy Kokhan <andriy.kokhan@gmail.com>

Signed-off-by: Andriy Kokhan <andriy.kokhan@gmail.com>
Co-authored-by: Chris Sommers <chrispsommers@gmail.com>
Co-authored-by: Andriy Kokhan <andriy.kokhan@gmail.com>

.wordlist.txt

@@ -81,12 +81,14 @@ CLI
 CloudStorm
 CNIP
 codebase
+collaterals
 compat
 Compat
 conf
 CONFDB
 confgen
 config
+configs
 Containerlab
 CP
 CreatedHalfOpenFlow
@@ -157,6 +159,8 @@ downcasting
 DPDK
 DPU
 dpu
+dpugen
+DPUGEN
 DPUControlMsgs
 DPUs
 drawio
@@ -246,6 +250,7 @@ IDL
 iface
 iflow
 impactful
+incrementing
 inband
 InbfromLB
 INIT
@@ -350,6 +355,8 @@ NVidia
 NVMe
 observability
 OCP
+OID
+OIDs
 ok
 Oleksandr
 onboardsupport
@@ -383,6 +390,7 @@ Pensando
 performant
 pingmesh
 PIR
+pluggable
 PLVision's
 pmon
 PNA
@@ -403,6 +411,7 @@ prereq
 Pritsak
 PrivateAddress
 programmability
+programmatically
 protobuf
 provids
 PRs
@@ -413,6 +422,7 @@ py
 PyPi
 pytest
 PyTest
+PyTests
 pytests
 Pytest's
 Pyunit
@@ -455,6 +465,9 @@ runtime
 rx
 SAI
 sai
+saic
+SAIC
+saichallenger
 saigen
 sairedis
 SAIRPC
@@ -495,12 +508,14 @@ SoC
 SoCs
 Sommers
 SONiC
+SONiC's
 SpoofingPacket
 SRC
 src
 STATEDB
 stateful
 statemachine
+stdout
 struct
 subclassed
 subdirectories
@@ -552,6 +567,7 @@ TGen
 Tgen
 Tgens
 th
+throughs
 ToC
 TODO
 TODOs
@@ -589,6 +605,7 @@ vcpus
 veth
 VFP
 vip
+vips
 VIP
 virsh
 virt

dash-pipeline/Makefile

@@ -659,6 +659,13 @@ run-saichallenger-scale-tests: deploy-ixiac
 	$(DOCKER_SAI_CHALLENGER_CLIENT_IMG) \
 	./run-tests.sh --setup=$(SAI_CHALLENGER_SETUP_FILE) $(SAI_CHALLENGER_TEST)
 
+run-saichallenger-tutorials: deploy-ixiac
+	$(DOCKER_RUN_SAI_CHALLENGER_CLIENT) \
+	-w /sai-challenger/dash_tests/functional \
+	$(DOCKER_FLAGS) \
+	$(DOCKER_SAI_CHALLENGER_CLIENT_IMG) \
+	./run-tests.sh --setup=$(SAI_CHALLENGER_SETUP_FILE) tutorial
+
 ###############################
 # ENVIRONMENT SETUP TARGETS
 ###############################