diff --git a/quantum/plugins/cisco/README b/quantum/plugins/cisco/README index a539ab4e88e..8a417e1340d 100755 --- a/quantum/plugins/cisco/README +++ b/quantum/plugins/cisco/README @@ -377,52 +377,54 @@ How to test the installation ---------------------------- The unit tests are located at quantum/plugins/cisco/tests/unit. They can be executed from the main folder using the run_tests.sh or to get a more detailed -result the quantum/plugins/cisco/run_tests.py script. +result the run_tests.py script. -1. Testing the core API (without UCS/Nexus/RHEL hardware, and can be run on +1. All unit tests (needs environment setup as indicated in the pre-requisites): + + ./run_tests.sh -N quantum.plugins.cisco.tests.unit + + or by modifying the environment variable to point to the plugin directory + + In bash : export PLUGIN_DIR=quantum/plugins/cisco + tcsh/csh : setenv PLUGIN_DIR quantum/plugins/cisco + + ./run_tests.sh -N + + Another option is to execute the python script run_tests.py + + python run_tests.py quantum.plugins.cisco.tests.unit + +2. Testing the core API (without UCS/Nexus/RHEL hardware, and can be run on Ubuntu): - First disable all device-specific plugins by commenting out the entries in: - quantum/plugins/cisco/conf/plugins.ini - Then run the test script: + Device-specific plugins can be disabled by commenting out the entries in: + etc/quantum/plugins/cisco/cisco_plugins.ini + The Core API can be tested by initially disabling all device plugins, then + enabling just the UCS plugins, and finally enabling both the UCS and the + Nexus plugins. + Execute the test script as follows: - Set the environment variable PLUGIN_DIR to the location of the plugin - directory. This is manadatory if the run_tests.sh script is used. - - In bash : export PLUGIN_DIR=quantum/plugins/cisco - tcsh/csh : setenv PLUGIN_DIR quantum/plugins/cisco - ./run_tests.sh quantum.plugins.cisco.tests.unit.test_l2networkApi + ./run_tests.sh -N quantum.plugins.cisco.tests.unit.test_l2networkApi or - python quantum/plugins/cisco/run_tests.py - quantum.plugins.cisco.tests.unit.test_l2networkApi + python run_tests.py quantum.plugins.cisco.tests.unit.test_l2networkApi -2. Specific Plugin unit test (needs environment setup as indicated in the +3. Specific Plugin unit test (needs environment setup as indicated in the pre-requisites): - In bash : export PLUGIN_DIR=quantum/plugins/cisco - tcsh/csh : setenv PLUGIN_DIR quantum/plugins/cisco - ./run_tests.sh quantum.plugins.cisco.tests.unit.<name_of_the file> + ./run_tests.sh -N quantum.plugins.cisco.tests.unit.<name_of_the file> - or + or - python <path to the plugin directory>/run_tests.py - quantum.plugins.cisco.tests.unit.<name_of_the file> + python run_tests.py quantum.plugins.cisco.tests.unit.<name_of_the file> E.g.: - python quantum/plugins/cisco/run_tests.py - quantum.plugins.cisco.tests.unit.test_ucs_plugin + python run_tests.py quantum.plugins.cisco.tests.unit.test_ucs_plugin -3. All unit tests (needs environment setup as indicated in the pre-requisites): - - In bash : export PLUGIN_DIR=quantum/plugins/cisco - tcsh/csh : setenv PLUGIN_DIR quantum/plugins/cisco + To run specific tests, use the following: + python run_tests.py + quantum.plugins.cisco.tests.unit.<name_of_the file>:<ClassName>.<funcName> - ./run_tests.sh quantum.plugins.cisco.tests.unit - - or - - python quantum/plugins/cisco/run_tests.py quantum.plugins.cisco.tests.unit 4. Testing the Extension API The script is placed alongwith the other cisco unit tests. The location may @@ -430,15 +432,12 @@ result the quantum/plugins/cisco/run_tests.py script. Location quantum/plugins/cisco/tests/unit/test_cisco_extension.py The script can be executed by : - ./run_tests.sh quantum.plugins.cisco.tests.unit.test_cisco_extension + ./run_tests.sh -N quantum.plugins.cisco.tests.unit.test_cisco_extension or python run_tests.py quantum.plugins.cisco.tests.unit.test_cisco_extension - To run specific tests - python run_tests.py - quantum.plugins.cisco.tests.unit.test_cisco_extension:<ClassName>.<funcName> Bingo bango bongo! That's it! Thanks for taking the leap into Quantum.