Red Hat Training

A Red Hat training course is available for Red Hat OpenStack Platform

Chapter 10. neutron-debug command-line client

The neutron-debug client is an extension to the neutron command-line interface (CLI) for the OpenStack neutron-debug tool. This chapter documents neutron-debug version 2.3.0.
For help on a specific neutron-debug command, enter:
$ neutron-debug help COMMAND

10.1. neutron-debug usage

 [--os-password <auth-password>] [--os-tenant-name <auth-tenant-name>] [--os-tenant-id <auth-tenant-id>] [--os-auth-url <auth-url>] [--os-region-name <region-name>] [--service-type <service-type>] [--service-name <service-name>] [--volume-service-name <volume-service-name>] [--endpoint-type <endpoint-type>] [--os-volume-api-version <volume-api-ver>] [--os-cacert <ca-certificate>] [--retries <retries>] <subcommand> ... 


Create probe port - create port and interface within a network namespace.
List all probes.
Clear all probes.
Delete probe - delete port then delete the namespace.
Execute commands in the namespace of the probe.
ping-all is all-in-one command to ping all fixed IP's in a specified network.

10.2. neutron-debug optional arguments

Show version number and exit.
-v, --verbose, --debug
Increase verbosity of output and show tracebacks on errors. Can be repeated.
-q, --quiet
Suppress output except warnings and errors
-h, --help
Show this help message and exit
--os-auth-strategy <auth-strategy>
Authentication strategy (Env: OS_AUTH_STRATEGY, default keystone). For now, any other value will disable the authentication
--os-auth-url <auth-url>
Authentication URL (Env: OS_AUTH_URL)
--os-tenant-name <auth-tenant-name>
Authentication tenant name (Env: OS_TENANT_NAME)
--os-tenant-id <auth-tenant-id>
Authentication tenant name (Env: OS_TENANT_ID)
--os-username <auth-username>
Authentication username (Env: OS_USERNAME)
--os-password <auth-password>
Authentication password (Env: OS_PASSWORD)
--os-region-name <auth-region-name>
Authentication region name (Env: OS_REGION_NAME)
--os-token <token>
Defaults to env[OS_TOKEN]
--endpoint-type <endpoint-type>
Defaults to env[OS_ENDPOINT_TYPE] or public URL.
--os-url <url>
Defaults to env[OS_URL]
--os-cacert <ca-certificate>
Specify a CA bundle file to use in verifying a TLS (https) server certificate. Defaults to env[OS_CACERT]
Explicitly allow neutron-debug to perform "insecure" SSL (https) requests. The server's certificate will not be verified against any certificate authorities. This option should be used with caution.
--config-file CONFIG_FILE
Config file for interface driver (You may also use l3_agent.ini)

10.3. neutron-debug probe-create command

usage: neutron-debug probe-create NET
Create probe port - create port and interface, then place it into the created network namespace.

Positional arguments

ID of the network in which the probe will be created.

10.4. neutron-debug probe-list command

usage: neutron-debug probe-list
List probes.

10.5. neutron-debug probe-clear command

usage: neutron-debug probe-clear
Clear all probes.

10.6. neutron-debug probe-delete command

usage: neutron-debug probe-delete <port-id>
Remove a probe.

Positional arguments

ID of the probe to delete.

10.7. neutron-debug probe-exec command

usage: neutron-debug probe-exec <port-id> <command>
Execute commands in the namespace of the probe

10.8. neutron-debug ping-all command

usage: neutron-debug ping-all <port-id> --timeout <number
All-in-one command to ping all fixed IP's in a specified network.

Positional arguments

ID of the port to use.

Optional arguments

--timeout <timeout in seconds>
Optional ping timeout.

10.9. neutron-debug example

usage: neutron-debug create-probe < NET_ID>
Create a probe namespace within the network identified by NET_ID. The namespace will have the name of qprobe-<UUID of the probe port>
For the following examples to function, the security group rules may need to be modified to allow the SSH (TCP port 22) or ping (ICMP) traffic into network.
usage: neutron-debug probe-exec <probe ID> "ssh <IP of instance>"
SSH to an instance within the network.
usage: neutron-debug ping-all <network ID>"
Ping all instances on this network to verify they are responding.
usage: neutron-debug probe-exec <probe_ID> dhcping <VM_MAC address> -s <IP of DHCP server>"
Ping the DHCP server for this network using dhcping to verify it is working.