| Thread-Pool Sample Plugin Testing |
| ================================= |
| |
| |
| Functional testing |
| ================== |
| |
| SynTest test cases are provided for functional testing as well as |
| boundary testing. |
| |
| List of tests: |
| -------------- |
| Test case are under thread-pool/test/SynTest/Tests/Psi |
| 1.cfg:Description: PSI Plugin - Include tag at the beginning of doc |
| 2.cfg:Description: PSI Plugin - include tag middle of body doc |
| 3.cfg:Description: PSI Plugin - include tag end of body doc |
| 4.cfg:Description: PSI Plugin - 2 include tags in the same body |
| 5.cfg:Description: PSI Plugin - Boundary case: no filename in include |
| 6.cfg:Description: PSI Plugin - Boundary case: include tag doesn't end |
| 7.cfg:Description: PSI Plugin - Boundary case: include file doesn't exist |
| 8.cfg:Description: PSI Plugin - Boundary case: tag similar to include but slightly different |
| 9.cfg:Description: PSI Plugin - Boundary case: include file is empty |
| 10.cfg:Description: PSI Plugin - Boundary case: huge file to include |
| 11.cfg:Description: PSI Plugin - Boundary case: no X-Psi header |
| 12.cfg:Description: PSI Plugin - Boundary case: Server Aborts in middle of header |
| 13.cfg:Description: PSI Plugin - Boundary case: Server Aborts in middle of body |
| |
| SynTest config file: |
| -------------------- |
| SynTest config files are under thread-pool/test/SynTest |
| - system.cfg: master SynTest config file |
| - tests_psi.cfg: test plan for SynTest |
| |
| Tests setup: |
| ------------ |
| - Update plugin.config to add the psi plugin |
| - Generate the include files using the gen_inc.sh tool in thread-pool/include |
| - Copy the include files into $TS_HOME/etc/trafficserver/plugins/include |
| - Start TS |
| - Start SynTest |
| |
| Expected tests result: |
| ---------------------- |
| All tests should pass. |
| |
| |
| Load Testing |
| ============ |
| |
| SDKTest is used for load testing. |
| |
| A SDKTest server plugin is required to exercise the plugin (the server |
| must send back responses with 'X-Psi' header). |
| |
| The SDKTest server plugin is located under thread-pool/test/SDKTest |
| A SDKTest configuration file is also provided (allows to change the ratio |
| of X-Psi responses). |
| |
| Tests setup: |
| ------------ |
| TS setup: |
| - Update plugin.config to add the psi plugin |
| - Generate the include files using the gen_inc.sh tool in thread-pool/include |
| - Copy the include files into $TS_HOME/etc/trafficserver/plugins/include |
| - Start TS |
| |
| SDKTest setup (Refer to SDKTest manual for detailed instructions): |
| - Compile and install the SDKTest server plugin |
| - Configure SDKTest using the provided config file |
| - Start SDKTest |
| |
| Expected tests result: |
| ---------------------- |
| Load testing should run for 24hours with no crash and no mem leak. |
