neutron/quantum/debug
Mark McLoughlin cfda6bc4fb Use oslo-config-2013.1b3
The cfg API is now available via the oslo-config library, so switch to
it and remove the copied-and-pasted version.

Add the 2013.1b3 tarball to tools/pip-requires - this will be changed
to 'oslo-config>=2013.1' when oslo-config is published to pypi. This
will happen in time for grizzly final.

Remove the 'deps = pep8' from tox.ini as it means all the other deps
get installed with easy_install which can't install oslo-config from
the URL.

Retain dummy cfg.py file until keystoneclient middleware has been
updated (I18c450174277c8e2d15ed93879da6cd92074c27a).

Change-Id: I4815aeb8a9341a31a250e920157f15ee15cfc5bc
2013-02-17 17:33:05 +00:00
..
README Add QUANTUM_ prefix for env used by quantum-debug 2012-11-09 13:38:40 -08:00
__init__.py remove not need shebang line in quantum debug 2012-09-13 12:17:49 +08:00
commands.py Fix i18n messages 2013-01-22 11:42:15 +08:00
debug_agent.py Use oslo-config-2013.1b3 2013-02-17 17:33:05 +00:00
shell.py Use oslo-config-2013.1b3 2013-02-17 17:33:05 +00:00

README

Debug Helper Script for Quantum

- Configure
export QUANTUM_TEST_CONFIG_FILE=/etc/quantum/debug.ini
or
export QUANTUM_TEST_CONFIG_FILE=/etc/quantum/l3_agent.ini

you can also specify config file by --config-file option

- Usage
quantum-debug commands

probe-create <net-id>
  Create probe port - create port and interface, then plug it in.
  This commands returns a port id of a probe port. A probe port is a port which is used to test.
  The port id is probe id.
  We can have multiple probe probes in a network, in order to check connectivity between ports.

  quantum-debug probe-exec probe_id_1 'nc -l 192.168.100.3 22'
  quantum-debug probe-exec probe_id_2 'nc -vz 192.168.100.4 22'

  Note: You should use a user and a tenant who has permission to
   modify network and subnet if you want to probe. For example, you need to be admin user if you
   want to probe external network.

probe-delete <port-id>  Delete probe - delete port then uplug
probe-exec <port-id> 'command'    Exec commands on the namespace of the probe
`probe-exec <port-id>` 'interactive command' Exec interactive command (eg, ssh)

probe-list     List probes
probe-clear    Clear All probes

ping-all --id <network_id> --timeout 1 (optional)
         ping-all is all-in-one command to ping all fixed ip's in all network or a specified network.
         In the command probe is automatically created if needed.

quantum-debug extends the shell of quantumclient,  so you can use all the commands of quantum