neutron

History

Akihiro Motoki c4aa41a25a Make neutron-debug command follow cliff command convention In the guideline of cliff command, developers implementing commands should override take_action() rather than run(). The similar effort is being done in neutronclient side and this fix is required to complete the effort. Logger definition in each command class is no longer needed. This commit also drops them. Closes-Bug: #1532258 Change-Id: I613b7e18b3c058568fc3669ad1524e60a93eb9f8		2016-01-09 03:38:19 +09:00
..
README	Rename Quantum to Neutron	2013-07-06 15:02:43 -04:00
__init__.py	Empty files should not contain copyright or license	2014-10-20 00:50:32 +00:00
commands.py	Make neutron-debug command follow cliff command convention	2016-01-09 03:38:19 +09:00
debug_agent.py	Use the constant HOST_ID instead of 'binding:host_id'	2015-12-20 14:00:29 +00:00
shell.py	Use _ from neutron._i18n	2015-12-06 19:39:04 +09:00

README

Debug Helper Script for Neutron

- Configure
export NEUTRON_TEST_CONFIG_FILE=/etc/neutron/debug.ini
or
export NEUTRON_TEST_CONFIG_FILE=/etc/neutron/l3_agent.ini

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

- Usage
neutron-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.

  neutron-debug probe-exec probe_id_1 'nc -l 192.168.100.3 22'
  neutron-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.

neutron-debug extends the shell of neutronclient,  so you can use all the commands of neutron