neutron

History

LiuNanke 83ef6b5677 Using LOG.warning replace LOG.warn Python 3 deprecated the logger.warn method, see: https://docs.python.org/3/library/logging.html#logging.warning so we prefer to use warning to avoid DeprecationWarning. Closes-Bugs: #1529913 Change-Id: Icc01ce5fbd10880440cf75a2e0833394783464a0 Co-Authored-By: Gary Kotton <gkotton@vmware.com>		2016-03-10 11:02:45 -08: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	Using LOG.warning replace LOG.warn	2016-03-10 11:02:45 -08: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